@moltium/core 0.1.28 → 0.1.30

package/dist/index.mjs

@@ -1,20 +1,7 @@
-// src/logger.ts
-import winston from "winston";
-var logLevel = process.env.LOG_LEVEL || "info";
-function createLogger(label) {
-  return winston.createLogger({
-    level: logLevel,
-    format: winston.format.combine(
-      winston.format.timestamp(),
-      winston.format.label({ label }),
-      winston.format.printf(({ timestamp, level, label: label2, message, ...meta }) => {
-        const metaStr = Object.keys(meta).length > 0 ? ` ${JSON.stringify(meta)}` : "";
-        return `${timestamp} [${label2}] ${level}: ${message}${metaStr}`;
-      })
-    ),
-    transports: [new winston.transports.Console()]
-  });
-}
+import {
+  AgentWallet,
+  createLogger
+} from "./chunk-K2UFQ7YF.mjs";
 
 // src/agent/scheduler.ts
 var logger = createLogger("Scheduler");
@@ -425,10 +412,11 @@ var moltbookActions = [
 ];
 
 // src/actions/built-in/world.ts
+var logger3 = createLogger("WorldActions");
 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.`,
+    description: `Join a world by URL. The world will fetch this agent's A2A Agent Card and evaluate admission. If the world requires an entry fee, the agent will pay automatically using its wallet. 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;
@@ -438,11 +426,45 @@ function createJoinWorldAction(config) {
       const agentPort = process.env.PORT || "3000";
       const agentHost = process.env.HOST || "localhost";
       const agentUrl = `http://${agentHost}:${agentPort}`;
+      const walletAddress = parameters.walletAddress || agent?.config?.world?.walletAddress;
       try {
         const { default: axios2 } = await import("axios");
+        let paymentTxHash;
+        try {
+          const infoRes = await axios2.get(`${worldUrl}/world/join-info`, { timeout: 5e3 });
+          const joinInfo = infoRes.data;
+          if (joinInfo.requiresPayment && joinInfo.entryFee && joinInfo.entryFee !== "0") {
+            const privateKey = agent?.config?.world?.privateKey;
+            if (!privateKey) {
+              return {
+                success: false,
+                error: "World requires entry fee but agent has no wallet private key configured. Set AGENT_WALLET_PRIVATE_KEY in your .env file."
+              };
+            }
+            logger3.info(`World requires entry fee: ${joinInfo.entryFee} wei`);
+            const { AgentWallet: AgentWallet2 } = await import("./AgentWallet-WSXDC5NX.mjs");
+            const wallet = new AgentWallet2(privateKey, joinInfo.rpcUrl);
+            const balance = await wallet.getBalance();
+            if (BigInt(balance) < BigInt(joinInfo.entryFee)) {
+              const { formatEther } = await import("ethers");
+              return {
+                success: false,
+                error: `Insufficient balance to pay entry fee. Need ${formatEther(joinInfo.entryFee)} MON, have ${formatEther(balance)} MON`
+              };
+            }
+            logger3.info(`Paying entry fee to ${joinInfo.paymentAddress}...`);
+            paymentTxHash = await wallet.sendPayment(joinInfo.paymentAddress, joinInfo.entryFee);
+            logger3.info(`Entry fee paid. TX: ${paymentTxHash}`);
+          }
+        } catch (infoError) {
+          if (infoError?.response?.status !== 404) {
+            logger3.debug(`Could not query join-info: ${infoError.message}`);
+          }
+        }
         const response = await axios2.post(`${worldUrl}/world/join`, {
           agentUrl,
-          walletAddress: parameters.walletAddress || agent?.config?.world?.walletAddress
+          walletAddress,
+          paymentTxHash
         }, { timeout: 1e4 });
         return {
           success: true,
@@ -591,17 +613,39 @@ ${config.llm.systemPrompt}`);
 }
 function buildDecisionPrompt(context, availableActions) {
   const actionList = availableActions.map((a) => `- ${a.name}: ${a.description}`).join("\n");
+  const actionNames = availableActions.map((a) => a.name);
+  const hasWorldActions = actionNames.some(
+    (n) => ["send_world_message", "query_world", "join_world", "leave_world"].includes(n)
+  );
+  const hasSocialActions = actionNames.some(
+    (n) => ["post_social_update", "respond_to_mention"].includes(n)
+  );
   const recent = context.recentActions || [];
   const recentNames = recent.map((r) => r.action);
   const lastAction = recentNames.length > 0 ? recentNames[recentNames.length - 1] : "none";
   let varietyHint = "";
   if (recentNames.length > 0) {
+    const suggestions = [];
+    if (hasWorldActions) {
+      suggestions.push("querying the world for agents", "sending messages to other agents", "responding to conversations");
+    }
+    if (hasSocialActions) {
+      suggestions.push("posting content", "responding to mentions");
+    }
+    const suggestStr = suggestions.length > 0 ? `
+Vary between: ${suggestions.join(", ")}.` : "";
     varietyHint = `
 Your recent actions (most recent last): ${recentNames.join(" \u2192 ")}
-IMPORTANT: Do NOT repeat "${lastAction}" again. Choose a DIFFERENT action to keep your behavior varied and interesting.
-Vary between: posting content, checking your feed, replying to others, checking DMs, browsing communities, searching for topics, and following interesting agents.`;
+IMPORTANT: Do NOT repeat "${lastAction}" again. Choose a DIFFERENT action to keep your behavior varied and interesting.` + suggestStr;
   }
-  return `You are an autonomous AI agent on moltbook (a social network for AI agents).
+  let preamble = "You are an autonomous AI agent.";
+  if (hasWorldActions) {
+    preamble += " You are connected to a world with other agents.";
+    preamble += " Use send_world_message to communicate with other agents (provide toAgentUrl and message parameters).";
+    preamble += " Use query_world to discover agents and world state.";
+    preamble += ' IMPORTANT: Only use actions from the "Available actions" list below. Do NOT invent action names.';
+  }
+  return `${preamble}
 Decide what action to take next based on the current context and your personality.
 
 Available actions:
@@ -612,7 +656,7 @@ ${JSON.stringify(context, null, 2)}
 ${varietyHint}
 
 Think about what would be most natural and valuable right now.
-If the action generates content (post, comment, DM), include the actual content in parameters.
+Choose ONLY from the available actions listed above.
 
 Respond with a JSON object:
 {
@@ -639,7 +683,7 @@ Execute these instructions step by step and return the result as a JSON object:
 }
 
 // src/actions/interpreter.ts
-var logger3 = createLogger("MarkdownInterpreter");
+var logger4 = createLogger("MarkdownInterpreter");
 var LLMInterpretationError = class extends Error {
   constructor(message) {
     super(message);
@@ -651,7 +695,7 @@ function createMarkdownAction(name, description, llmProvider) {
     name,
     description,
     execute: async (context) => {
-      logger3.info(`Interpreting markdown skill: ${name}`);
+      logger4.info(`Interpreting markdown skill: ${name}`);
       const prompt = buildSkillPrompt(name, description, context.parameters);
       try {
         const response = await llmProvider.generateText(prompt, {
@@ -672,7 +716,7 @@ function createMarkdownAction(name, description, llmProvider) {
       } catch (error) {
         if (error instanceof LLMInterpretationError) throw error;
         const message = error instanceof Error ? error.message : String(error);
-        logger3.error(`Markdown skill interpretation failed: ${name}`, { error: message });
+        logger4.error(`Markdown skill interpretation failed: ${name}`, { error: message });
         throw new LLMInterpretationError(
           `Failed to interpret skill "${name}": ${message}`
         );
@@ -1625,7 +1669,7 @@ function createMultipleA2AActions(configs) {
 }
 
 // src/agent/Agent.ts
-var logger4 = createLogger("Agent");
+var logger5 = createLogger("Agent");
 function parsePostFrequency(freq) {
   const lower = freq.toLowerCase().trim();
   if (lower === "realtime") return 5 * 60 * 1e3;
@@ -1721,7 +1765,17 @@ var Agent = class {
   // ── Lifecycle ──
   async init() {
     this.state = "initializing";
-    logger4.info(`Initializing agent: ${this.config.name}`);
+    logger5.info(`Initializing agent: ${this.config.name}`);
+    if (this.config.world?.privateKey && !this.config.world.walletAddress) {
+      try {
+        const { AgentWallet: AgentWallet2 } = await import("./AgentWallet-WSXDC5NX.mjs");
+        const wallet = new AgentWallet2(this.config.world.privateKey);
+        this.config.world.walletAddress = await wallet.getAddressAsync();
+        logger5.info(`Wallet address derived: ${this.config.world.walletAddress}`);
+      } catch (error) {
+        logger5.warn(`Failed to derive wallet address: ${error.message}`);
+      }
+    }
     this.initLLM();
     this.registerActions();
     await this.initSocialAdapters();
@@ -1730,7 +1784,7 @@ var Agent = class {
       await this.hooks.onInit(this);
     }
     await this.postStartupMessages();
-    logger4.info(`Agent initialized: ${this.config.name}`);
+    logger5.info(`Agent initialized: ${this.config.name}`);
   }
   async start() {
     if (this.state !== "initializing" && this.state !== "idle") {
@@ -1740,7 +1794,7 @@ var Agent = class {
       await this.init();
     }
     this.state = "running";
-    logger4.info(`Agent started: ${this.config.name}`);
+    logger5.info(`Agent started: ${this.config.name}`);
     if (this.hooks.onStart) {
       await this.hooks.onStart(this);
     }
@@ -1754,7 +1808,7 @@ var Agent = class {
   }
   async stop() {
     this.state = "stopping";
-    logger4.info(`Stopping agent: ${this.config.name}`);
+    logger5.info(`Stopping agent: ${this.config.name}`);
     if (this.tickTimer) {
       clearInterval(this.tickTimer);
       this.tickTimer = void 0;
@@ -1767,7 +1821,7 @@ var Agent = class {
       await this.hooks.onShutdown(this);
     }
     this.state = "stopped";
-    logger4.info(`Agent stopped: ${this.config.name}`);
+    logger5.info(`Agent stopped: ${this.config.name}`);
   }
   // ── Decision Loop ──
   async think() {
@@ -1787,7 +1841,7 @@ var Agent = class {
       },
       { systemPrompt: this.systemPrompt, temperature: this.config.llm.temperature }
     );
-    logger4.debug(`Decision: ${decision.action} \u2014 ${decision.reasoning}`);
+    logger5.debug(`Decision: ${decision.action} \u2014 ${decision.reasoning}`);
     return decision;
   }
   async act(actionName, parameters = {}) {
@@ -1810,17 +1864,17 @@ var Agent = class {
         await this.hooks.onTick(this);
       }
       if (this.isSleeping()) {
-        logger4.info(`Tick #${this.tickCount}: Sleeping \u2014 skipped`);
+        logger5.info(`Tick #${this.tickCount}: Sleeping \u2014 skipped`);
         return;
       }
-      logger4.info(`Tick #${this.tickCount}: Thinking...`);
+      logger5.info(`Tick #${this.tickCount}: Thinking...`);
       const decision = await this.think();
-      logger4.info(`Tick #${this.tickCount}: Decision \u2192 ${decision.action} | Reasoning: ${decision.reasoning}`);
+      logger5.info(`Tick #${this.tickCount}: Decision \u2192 ${decision.action} | Reasoning: ${decision.reasoning}`);
       if (decision.parameters && Object.keys(decision.parameters).length > 0) {
-        logger4.info(`Tick #${this.tickCount}: Parameters \u2192 ${JSON.stringify(decision.parameters)}`);
+        logger5.info(`Tick #${this.tickCount}: Parameters \u2192 ${JSON.stringify(decision.parameters)}`);
       }
       const result = await this.act(decision.action, decision.parameters);
-      logger4.info(`Tick #${this.tickCount}: Result \u2192 success=${result.success}${result.data ? ` data=${JSON.stringify(result.data).slice(0, 200)}` : ""}`);
+      logger5.info(`Tick #${this.tickCount}: Result \u2192 success=${result.success}${result.data ? ` data=${JSON.stringify(result.data).slice(0, 200)}` : ""}`);
       this.recentActions.push({
         action: decision.action,
         reasoning: decision.reasoning,
@@ -1838,7 +1892,7 @@ var Agent = class {
         await this.fireWebhook("onAction", decision, result);
       }
     } catch (error) {
-      logger4.error(`Tick #${this.tickCount} error: ${error instanceof Error ? error.message : error}`);
+      logger5.error(`Tick #${this.tickCount} error: ${error instanceof Error ? error.message : error}`);
       if (this.hooks.onError && error instanceof Error) {
         await this.hooks.onError(error, this);
       }
@@ -1878,7 +1932,7 @@ var Agent = class {
           this.actionRegistry.register(action);
         }
       }
-      logger4.info(`Registered ${moltbookActions.length} Moltbook actions`);
+      logger5.info(`Registered ${moltbookActions.length} Moltbook actions`);
     }
     const a2a = this.config.a2a;
     if (a2a && a2a.enabled !== false) {
@@ -1898,7 +1952,7 @@ var Agent = class {
             this.actionRegistry.register(action);
           }
         }
-        logger4.info(`Registered ${peerActions.length} A2A peer actions`);
+        logger5.info(`Registered ${peerActions.length} A2A peer actions`);
       } else {
         const genericAction = createA2ACommunicationAction({
           defaultAgentUrl: a2a.defaultPeerUrl,
@@ -1908,7 +1962,7 @@ var Agent = class {
         if (!this.actionRegistry.has(genericAction.name)) {
           this.actionRegistry.register(genericAction);
         }
-        logger4.info(`Registered generic A2A action: ${genericAction.name}`);
+        logger5.info(`Registered generic A2A action: ${genericAction.name}`);
       }
     }
     const world = this.config.world;
@@ -1925,7 +1979,7 @@ var Agent = class {
           this.actionRegistry.register(action);
         }
       }
-      logger4.info(`Registered 4 world actions (world: ${worldUrl})`);
+      logger5.info(`Registered 4 world actions (world: ${worldUrl})`);
     }
     if (this.config.customActions) {
       for (const action of this.config.customActions) {
@@ -1938,7 +1992,7 @@ var Agent = class {
     await this.initMoltbook(social);
     await this.initTwitter(social);
     if (Object.keys(this.socialAdapters).length === 0) {
-      logger4.warn("Social: No adapters connected. Set MOLTBOOK_API_KEY or Twitter env vars in your .env to enable.");
+      logger5.warn("Social: No adapters connected. Set MOLTBOOK_API_KEY or Twitter env vars in your .env to enable.");
     }
   }
   async initMoltbook(social) {
@@ -1949,13 +2003,13 @@ var Agent = class {
     const explicitlyDisabled = configMoltbook && configMoltbook.enabled === false && !envKey;
     const shouldConnect = !isPlaceholder && !explicitlyDisabled;
     if (explicitlyDisabled) {
-      logger4.info("Moltbook: Disabled in config and no MOLTBOOK_API_KEY in env \u2014 skipping");
+      logger5.info("Moltbook: Disabled in config and no MOLTBOOK_API_KEY in env \u2014 skipping");
       return;
     }
     if (isPlaceholder) {
       if (configMoltbook?.enabled || envKey) {
-        logger4.warn("Moltbook: MOLTBOOK_API_KEY is missing or still a placeholder.");
-        logger4.warn("  Fix: Set a valid MOLTBOOK_API_KEY in your .env file.");
+        logger5.warn("Moltbook: MOLTBOOK_API_KEY is missing or still a placeholder.");
+        logger5.warn("  Fix: Set a valid MOLTBOOK_API_KEY in your .env file.");
       }
       return;
     }
@@ -1973,16 +2027,16 @@ var Agent = class {
       ...configMoltbook?.apiKey ? {} : { apiKey },
       ...configMoltbook?.baseUrl ? {} : { baseUrl }
     };
-    logger4.info(`Moltbook: API key detected from ${source}`);
-    logger4.info(`Moltbook: Connecting to ${baseUrl} ...`);
+    logger5.info(`Moltbook: API key detected from ${source}`);
+    logger5.info(`Moltbook: Connecting to ${baseUrl} ...`);
     const adapter = new MoltbookAdapter(effectiveConfig);
     try {
       await adapter.connect();
       this.socialAdapters["moltbook"] = adapter;
       social.moltbook = effectiveConfig;
-      logger4.info(`Moltbook: Connected successfully (submolt: ${defaultSubmolt})`);
+      logger5.info(`Moltbook: Connected successfully (submolt: ${defaultSubmolt})`);
     } catch (error) {
-      logger4.error(`Moltbook: Connection FAILED \u2014 ${error.message || error}`);
+      logger5.error(`Moltbook: Connection FAILED \u2014 ${error.message || error}`);
       this.logPlatformError("Moltbook", error);
     }
   }
@@ -2001,23 +2055,23 @@ var Agent = class {
     const hasAllCreds = hasKey && apiSecret && accessToken && accessSecret;
     const explicitlyDisabled = configTwitter && configTwitter.enabled === false && !envApiKey;
     if (explicitlyDisabled) {
-      logger4.info("Twitter: Disabled in config and no TWITTER_API_KEY in env \u2014 skipping");
+      logger5.info("Twitter: Disabled in config and no TWITTER_API_KEY in env \u2014 skipping");
       return;
     }
     if (!hasKey) {
       if (configTwitter?.enabled || envApiKey) {
-        logger4.warn("Twitter: Credentials are missing or still placeholders.");
-        logger4.warn("  Fix: Set valid Twitter keys in your .env file.");
+        logger5.warn("Twitter: Credentials are missing or still placeholders.");
+        logger5.warn("  Fix: Set valid Twitter keys in your .env file.");
       }
       return;
     }
     if (!hasAllCreds) {
-      logger4.warn("Twitter: Some credentials are missing. Need: TWITTER_API_KEY, TWITTER_API_SECRET, TWITTER_ACCESS_TOKEN, TWITTER_ACCESS_SECRET");
+      logger5.warn("Twitter: Some credentials are missing. Need: TWITTER_API_KEY, TWITTER_API_SECRET, TWITTER_ACCESS_TOKEN, TWITTER_ACCESS_SECRET");
       return;
     }
     const source = creds?.apiKey ? "config" : "environment";
-    logger4.info(`Twitter: Credentials detected from ${source}`);
-    logger4.info("Twitter: Connecting...");
+    logger5.info(`Twitter: Credentials detected from ${source}`);
+    logger5.info("Twitter: Connecting...");
     const effectiveConfig = {
       enabled: true,
       ...configTwitter,
@@ -2028,16 +2082,16 @@ var Agent = class {
       await adapter.connect();
       this.socialAdapters["twitter"] = adapter;
       social.twitter = effectiveConfig;
-      logger4.info("Twitter: Connected successfully");
+      logger5.info("Twitter: Connected successfully");
     } catch (error) {
-      logger4.error(`Twitter: Connection FAILED \u2014 ${error.message || error}`);
+      logger5.error(`Twitter: Connection FAILED \u2014 ${error.message || error}`);
       this.logPlatformError("Twitter", error);
     }
   }
   async postStartupMessages() {
     const adapters = Object.entries(this.socialAdapters);
     if (adapters.length === 0) {
-      logger4.info("Startup post: No connected social adapters \u2014 skipping");
+      logger5.info("Startup post: No connected social adapters \u2014 skipping");
       return;
     }
     let content;
@@ -2052,18 +2106,18 @@ Write only the post content, nothing else. Keep it concise and natural.`;
         temperature: this.config.llm.temperature ?? 0.8,
         maxTokens: 280
       })).trim();
-      logger4.info(`Startup post: LLM generated content (${content.length} chars)`);
+      logger5.info(`Startup post: LLM generated content (${content.length} chars)`);
     } catch (error) {
-      logger4.warn(`Startup post: LLM generation failed (${error.message}), using fallback`);
+      logger5.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}...`);
+      logger5.info(`Startup post: Posting to ${platform}...`);
       try {
         const result = await adapter.post(content);
-        logger4.info(`Startup post: ${platform} SUCCESS \u2014 id=${result.id}${result.url ? ` url=${result.url}` : ""}`);
+        logger5.info(`Startup post: ${platform} SUCCESS \u2014 id=${result.id}${result.url ? ` url=${result.url}` : ""}`);
       } catch (error) {
-        logger4.error(`Startup post: ${platform} FAILED \u2014 ${error.message || error}`);
+        logger5.error(`Startup post: ${platform} FAILED \u2014 ${error.message || error}`);
         this.logPlatformError(platform, error);
       }
     }
@@ -2086,7 +2140,7 @@ Write only the post content, nothing else. Keep it concise and natural.`;
               await this.scheduledPost("moltbook");
             }
           });
-          logger4.info(`Scheduler: Moltbook posting every ${formatInterval(intervalMs)}`);
+          logger5.info(`Scheduler: Moltbook posting every ${formatInterval(intervalMs)}`);
         }
       }
     }
@@ -2102,7 +2156,7 @@ Write only the post content, nothing else. Keep it concise and natural.`;
               await this.scheduledPost("twitter");
             }
           });
-          logger4.info(`Scheduler: Twitter posting every ${formatInterval(intervalMs)}`);
+          logger5.info(`Scheduler: Twitter posting every ${formatInterval(intervalMs)}`);
         }
       }
     }
@@ -2118,7 +2172,7 @@ Write only the post content, nothing else. Keep it concise and natural.`;
           await this.executeScheduledTask(task);
         }
       });
-      logger4.info(`Scheduler: "${task.name}" every ${formatInterval(task.intervalMs)}`);
+      logger5.info(`Scheduler: "${task.name}" every ${formatInterval(task.intervalMs)}`);
     }
   }
   async scheduledPost(platform) {
@@ -2134,15 +2188,15 @@ Write only the post content, nothing else. Keep it concise and natural.`;
         maxTokens: 280
       });
       const result = await adapter.post(content.trim());
-      logger4.info(`Scheduled post: ${platform} SUCCESS \u2014 id=${result.id}`);
+      logger5.info(`Scheduled post: ${platform} SUCCESS \u2014 id=${result.id}`);
     } catch (error) {
-      logger4.error(`Scheduled post: ${platform} FAILED \u2014 ${error.message || error}`);
+      logger5.error(`Scheduled post: ${platform} FAILED \u2014 ${error.message || error}`);
       this.logPlatformError(platform, error);
     }
   }
   async executeScheduledTask(task) {
     try {
-      logger4.info(`Scheduled task: Running "${task.name}"`);
+      logger5.info(`Scheduled task: Running "${task.name}"`);
       const prompt = `You are ${this.config.name}, an autonomous agent. Execute the following scheduled task.
 
 Task: ${task.name}
@@ -2167,74 +2221,74 @@ Decide what action to take. Respond with JSON:
         { 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}`);
+      logger5.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}`);
+      logger5.error(`Scheduled task: "${task.name}" FAILED \u2014 ${error.message || error}`);
     }
   }
   logPlatformError(platform, error) {
     if (!error.response) {
       if (error.code === "ENOTFOUND") {
-        logger4.error(`  ${platform}: DNS lookup failed \u2014 check the base URL.`);
+        logger5.error(`  ${platform}: DNS lookup failed \u2014 check the base URL.`);
       } else if (error.code === "ECONNREFUSED") {
-        logger4.error(`  ${platform}: Connection refused \u2014 is the server running?`);
+        logger5.error(`  ${platform}: Connection refused \u2014 is the server running?`);
       } else if (error.code === "ETIMEDOUT" || error.code === "ECONNABORTED") {
-        logger4.error(`  ${platform}: Request timed out.`);
+        logger5.error(`  ${platform}: Request timed out.`);
       } else {
-        logger4.error(`  ${platform}: Network error (${error.code || "unknown"})`);
+        logger5.error(`  ${platform}: Network error (${error.code || "unknown"})`);
       }
       return;
     }
     const status = error.response.status;
     const data = error.response.data;
-    logger4.error(`  ${platform}: HTTP ${status}`);
+    logger5.error(`  ${platform}: HTTP ${status}`);
     if (data) {
-      if (data.error) logger4.error(`  ${platform}: API error: ${data.error}`);
-      if (data.hint) logger4.error(`  ${platform}: API hint: ${data.hint}`);
-      if (!data.error && !data.hint) logger4.error(`  ${platform}: Response: ${JSON.stringify(data)}`);
+      if (data.error) logger5.error(`  ${platform}: API error: ${data.error}`);
+      if (data.hint) logger5.error(`  ${platform}: API hint: ${data.hint}`);
+      if (!data.error && !data.hint) logger5.error(`  ${platform}: Response: ${JSON.stringify(data)}`);
     }
     if (status === 401) {
-      logger4.error(`  ${platform}: Your API key was rejected. Verify it is correct and the agent is claimed.`);
+      logger5.error(`  ${platform}: Your API key was rejected. Verify it is correct and the agent is claimed.`);
     } else if (status === 403) {
-      logger4.error(`  ${platform}: Forbidden \u2014 your agent may not be claimed yet or lacks permissions.`);
+      logger5.error(`  ${platform}: Forbidden \u2014 your agent may not be claimed yet or lacks permissions.`);
     } else if (status === 429) {
       const retryMin = data?.retry_after_minutes;
       const retrySec = data?.retry_after_seconds;
       if (retryMin) {
-        logger4.error(`  ${platform}: Rate limited \u2014 try again in ${retryMin} minute(s).`);
+        logger5.error(`  ${platform}: Rate limited \u2014 try again in ${retryMin} minute(s).`);
       } else if (retrySec) {
-        logger4.error(`  ${platform}: Rate limited \u2014 try again in ${retrySec} second(s).`);
+        logger5.error(`  ${platform}: Rate limited \u2014 try again in ${retrySec} second(s).`);
       } else {
-        logger4.error(`  ${platform}: Rate limited \u2014 wait before retrying.`);
+        logger5.error(`  ${platform}: Rate limited \u2014 wait before retrying.`);
       }
     } else if (status === 404) {
-      logger4.error(`  ${platform}: Endpoint not found \u2014 check the base URL.`);
+      logger5.error(`  ${platform}: Endpoint not found \u2014 check the base URL.`);
     } else if (status >= 500) {
-      logger4.error(`  ${platform}: Server error \u2014 the platform may be temporarily down.`);
+      logger5.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}`);
+    logger5.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}`);
+        logger5.info(`Successfully joined world: ${worldUrl}`);
       } else {
-        logger4.warn(`Failed to join world: ${result.error}`);
+        logger5.warn(`Failed to join world: ${result.error}`);
       }
     } catch (error) {
-      logger4.warn(`Auto-join world failed: ${error?.message || error}`);
+      logger5.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);
     this.tickTimer = setInterval(() => this.tick(), intervalMs);
-    logger4.info(`Autonomous loop started: ~${actionsPerHour} actions/hour (every ${intervalMs}ms)`);
+    logger5.info(`Autonomous loop started: ~${actionsPerHour} actions/hour (every ${intervalMs}ms)`);
   }
   isSleeping() {
     const schedule = this.config.behaviors.sleepSchedule;
@@ -2269,7 +2323,7 @@ Decide what action to take. Respond with JSON:
         await axios2.post(hook, { event, data: args });
       }
     } catch (error) {
-      logger4.error(`Webhook ${event} failed: ${error}`);
+      logger5.error(`Webhook ${event} failed: ${error}`);
     }
   }
 };
@@ -2409,10 +2463,18 @@ var MarkdownParser = class {
     const fields = this.parseKeyValueLines(section.content);
     const url = fields["url"];
     if (!url) return void 0;
+    let privateKey;
+    const pkField = fields["wallet_private_key"];
+    if (pkField === "env") {
+      privateKey = process.env.AGENT_WALLET_PRIVATE_KEY;
+    } else if (pkField && pkField.startsWith("0x")) {
+      privateKey = pkField;
+    }
     return {
       url,
       autoJoin: fields["auto_join"] !== "false",
-      ...fields["wallet_address"] ? { walletAddress: fields["wallet_address"] } : {}
+      ...fields["wallet_address"] ? { walletAddress: fields["wallet_address"] } : {},
+      ...privateKey ? { privateKey } : {}
     };
   }
   parseSleepSchedule(value) {
@@ -2587,7 +2649,7 @@ var ConfigLoader = class {
 };
 
 // src/memory/longterm.ts
-var logger5 = createLogger("LongTermMemory");
+var logger6 = createLogger("LongTermMemory");
 var LongTermMemory = class extends Memory {
   redisConfig;
   postgresConfig;
@@ -2763,9 +2825,9 @@ var LongTermMemory = class extends Memory {
     try {
       const { default: Redis } = await import("ioredis");
       this.redis = new Redis(this.redisConfig.url);
-      logger5.info("Redis connection established");
+      logger6.info("Redis connection established");
     } catch (error) {
-      logger5.error(`Failed to connect to Redis: ${error}`);
+      logger6.error(`Failed to connect to Redis: ${error}`);
       throw error;
     }
   }
@@ -2778,9 +2840,9 @@ var LongTermMemory = class extends Memory {
         connectionString: this.postgresConfig.url
       });
       await this.pg.query("SELECT 1");
-      logger5.info("Postgres connection established");
+      logger6.info("Postgres connection established");
     } catch (error) {
-      logger5.error(`Failed to connect to Postgres: ${error}`);
+      logger6.error(`Failed to connect to Postgres: ${error}`);
       throw error;
     }
   }
@@ -2922,13 +2984,13 @@ function createRoutes(agent) {
 }
 
 // src/server/middleware.ts
-var logger6 = createLogger("Server");
+var logger7 = createLogger("Server");
 function requestLogger(req, _res, next) {
-  logger6.debug(`${req.method} ${req.path}`);
+  logger7.debug(`${req.method} ${req.path}`);
   next();
 }
 function errorHandler(err, _req, res, _next) {
-  logger6.error(`Server error: ${err.message}`);
+  logger7.error(`Server error: ${err.message}`);
   res.status(500).json({ error: err.message });
 }
 function authMiddleware(req, res, next) {
@@ -2946,7 +3008,7 @@ function authMiddleware(req, res, next) {
 }
 
 // src/a2a/AgentCardBuilder.ts
-var logger7 = createLogger("AgentCardBuilder");
+var logger8 = createLogger("AgentCardBuilder");
 var AgentCardBuilder = class {
   /**
    * Creates an A2A AgentCard from Moltium configuration.
@@ -2968,7 +3030,7 @@ var AgentCardBuilder = class {
       name: config.name,
       description: config.personality.bio || `${config.name} - An autonomous AI agent`,
       protocolVersion: "0.3.0",
-      version: "0.1.28",
+      version: "0.1.30",
       url: `${baseUrl}/a2a/jsonrpc`,
       skills,
       capabilities,
@@ -2979,7 +3041,7 @@ var AgentCardBuilder = class {
         { url: `${baseUrl}/a2a/rest`, transport: "HTTP+JSON" }
       ]
     };
-    logger7.debug("Built A2A AgentCard", {
+    logger8.debug("Built A2A AgentCard", {
       name: agentCard.name,
       skillCount: skills.length,
       baseUrl
@@ -3062,7 +3124,7 @@ var AgentCardBuilder = class {
 
 // src/a2a/MoltiumExecutor.ts
 import { v4 as uuidv42 } from "uuid";
-var logger8 = createLogger("MoltiumExecutor");
+var logger9 = createLogger("MoltiumExecutor");
 var MoltiumExecutor = class {
   agent;
   cancelledTasks = /* @__PURE__ */ new Set();
@@ -3076,7 +3138,7 @@ var MoltiumExecutor = class {
   async execute(requestContext, eventBus) {
     const { taskId, contextId, userMessage, task } = requestContext;
     try {
-      logger8.info(`[A2A] Executing request for task ${taskId}`);
+      logger9.info(`[A2A] Executing request for task ${taskId}`);
       if (!task) {
         const initialTask = {
           kind: "task",
@@ -3114,9 +3176,9 @@ var MoltiumExecutor = class {
       }
       this.publishStatusUpdate(taskId, contextId, "completed", eventBus, true);
       eventBus.finished();
-      logger8.info(`[A2A] Task ${taskId} completed successfully`);
+      logger9.info(`[A2A] Task ${taskId} completed successfully`);
     } catch (error) {
-      logger8.error(`[A2A] Task ${taskId} failed`, {
+      logger9.error(`[A2A] Task ${taskId} failed`, {
         error: error instanceof Error ? error.message : String(error)
       });
       const errorMessage = error instanceof Error ? error.message : String(error);
@@ -3131,7 +3193,7 @@ var MoltiumExecutor = class {
    * Handles task cancellation requests.
    */
   async cancelTask(taskId, eventBus) {
-    logger8.info(`[A2A] Cancellation requested for task ${taskId}`);
+    logger9.info(`[A2A] Cancellation requested for task ${taskId}`);
     this.cancelledTasks.add(taskId);
   }
   /**
@@ -3293,7 +3355,7 @@ var MoltiumExecutor = class {
    * Publishes a cancellation status.
    */
   publishCancellation(taskId, contextId, eventBus) {
-    logger8.info(`[A2A] Publishing cancellation for task ${taskId}`);
+    logger9.info(`[A2A] Publishing cancellation for task ${taskId}`);
     this.publishStatusUpdate(taskId, contextId, "canceled", eventBus, true);
     eventBus.finished();
     this.cancelledTasks.delete(taskId);
@@ -3302,7 +3364,7 @@ var MoltiumExecutor = class {
 
 // src/a2a/integration.ts
 import { DefaultRequestHandler, InMemoryTaskStore, JsonRpcTransportHandler } from "@a2a-js/sdk/server";
-var logger9 = createLogger("A2AIntegration");
+var logger10 = createLogger("A2AIntegration");
 var A2AIntegration = class {
   agent;
   agentCard;
@@ -3317,7 +3379,7 @@ var A2AIntegration = class {
       new InMemoryTaskStore(),
       this.moltiumExecutor
     );
-    logger9.info("A2A integration initialized", {
+    logger10.info("A2A integration initialized", {
       agentName: agent.name,
       baseUrl: options.a2aConfig.baseUrl
     });
@@ -3339,7 +3401,7 @@ var A2AIntegration = class {
           const response = await jsonRpcHandler.handle(req.body);
           res.json(response);
         } catch (error) {
-          logger9.error("JSON-RPC error:", error);
+          logger10.error("JSON-RPC error:", error);
           res.status(500).json({
             jsonrpc: "2.0",
             error: {
@@ -3370,7 +3432,7 @@ var A2AIntegration = class {
       new InMemoryTaskStore(),
       this.moltiumExecutor
     );
-    logger9.info("A2A agent card updated with runtime info", {
+    logger10.info("A2A agent card updated with runtime info", {
       host: actualHost,
       port: actualPort,
       url: this.agentCard.url
@@ -3388,10 +3450,10 @@ var A2AIntegration = class {
   logEndpoints(host, port) {
     const protocol = host === "localhost" || host === "127.0.0.1" ? "http" : "https";
     const baseUrl = `${protocol}://${host}:${port}`;
-    logger9.info("A2A endpoints available:");
-    logger9.info(`  Agent Card:  ${baseUrl}/.well-known/agent.json`);
-    logger9.info(`  JSON-RPC:    ${baseUrl}/a2a/jsonrpc`);
-    logger9.info(`  HTTP+JSON:   ${baseUrl}/a2a/rest`);
+    logger10.info("A2A endpoints available:");
+    logger10.info(`  Agent Card:  ${baseUrl}/.well-known/agent.json`);
+    logger10.info(`  JSON-RPC:    ${baseUrl}/a2a/jsonrpc`);
+    logger10.info(`  HTTP+JSON:   ${baseUrl}/a2a/rest`);
   }
 };
 function createA2AIntegration(agent, options = {}) {
@@ -3406,7 +3468,7 @@ function createA2AIntegration(agent, options = {}) {
 }
 
 // src/server/app.ts
-var logger10 = createLogger("Server");
+var logger11 = createLogger("Server");
 var AGENT_CARD_PATH = ".well-known/agent.json";
 function createApp(agent, options = {}) {
   const app = express();
@@ -3432,9 +3494,10 @@ function createApp(agent, options = {}) {
     });
     const handlers = a2aIntegration.getHandlers();
     app.use(`/${AGENT_CARD_PATH}`, handlers.agentCard);
+    app.use("/.well-known/agent-card.json", handlers.agentCard);
     app.use("/a2a/jsonrpc", handlers.jsonRpc);
     app.use("/a2a/rest", handlers.rest);
-    logger10.info("A2A protocol endpoints enabled");
+    logger11.info("A2A protocol endpoints enabled");
   }
   app.use(errorHandler);
   return app;
@@ -3445,22 +3508,22 @@ async function startServer(agent, options = {}) {
   const app = createApp(agent, options);
   await new Promise((resolve2) => {
     app.listen(port, host, () => {
-      logger10.info(`Agent "${agent.name}" running at http://${host}:${port}`);
+      logger11.info(`Agent "${agent.name}" running at http://${host}:${port}`);
       if (options.enableA2A !== false) {
         const logHost = host === "0.0.0.0" ? "localhost" : host;
         const protocol = logHost === "localhost" || logHost === "127.0.0.1" ? "http" : "https";
         const baseUrl = `${protocol}://${logHost}:${port}`;
-        logger10.info("A2A Protocol Endpoints:");
-        logger10.info(`  Agent Card:  ${baseUrl}/.well-known/agent.json`);
-        logger10.info(`  JSON-RPC:    ${baseUrl}/a2a/jsonrpc`);
-        logger10.info(`  HTTP+JSON:   ${baseUrl}/a2a/rest`);
+        logger11.info("A2A Protocol Endpoints:");
+        logger11.info(`  Agent Card:  ${baseUrl}/.well-known/agent.json`);
+        logger11.info(`  JSON-RPC:    ${baseUrl}/a2a/jsonrpc`);
+        logger11.info(`  HTTP+JSON:   ${baseUrl}/a2a/rest`);
       }
       resolve2();
     });
   });
   await agent.start();
   const shutdown = async () => {
-    logger10.info("Received shutdown signal");
+    logger11.info("Received shutdown signal");
     await agent.stop();
     process.exit(0);
   };
@@ -3474,6 +3537,7 @@ export {
   ActionRegistry,
   Agent,
   AgentCardBuilder,
+  AgentWallet,
   AnthropicProvider,
   ConfigLoader,
   LLMProvider,