@moltium/cli 0.1.19 → 0.1.21

package/dist/index.js

@@ -18,6 +18,8 @@ function codeTemplate(ctx) {
   const envKey = ctx.llmProvider === "anthropic" ? "ANTHROPIC_API_KEY" : "OPENAI_API_KEY";
   const model = ctx.llmProvider === "anthropic" ? "claude-sonnet-4-20250514" : "gpt-4o";
   const socialConfig = buildSocialConfig(ctx.socialPlatforms);
+  const a2aConfig = ctx.enableA2A !== false ? buildA2AConfig() : "";
+  const worldConfig = buildWorldConfig(ctx.connectToWorld, ctx.worldUrl);
   return `import type { AgentConfig } from '@moltium/core';
 import { exampleAction } from './actions/example.js';
 
@@ -40,7 +42,7 @@ export default {
 
   social: {${socialConfig}
   },
-
+${a2aConfig}${worldConfig}
   behaviors: {
     autonomous: true,
     decisionMaking: 'llm-driven',
@@ -100,9 +102,58 @@ function buildSocialConfig(platforms) {
       maxTweetsPerDay: 5,
     },`;
 }
+function buildA2AConfig() {
+  return `  // A2A Protocol \u2014 Agent-to-Agent communication
+  // Uncomment and configure to enable communication with other agents
+  // When enabled, automatically registers 'talk_to_agent' action
+  // a2a: {
+  //   enabled: true,
+  //   // Define peer agents this agent can talk to
+  //   peers: {
+  //     // talk_to_analyst: 'http://localhost:3001',
+  //     // talk_to_researcher: 'http://localhost:3002',
+  //   },
+  //   // Or use a default peer URL
+  //   // defaultPeerUrl: 'http://localhost:3001',
+  //   verbose: false,
+  // },
+
+`;
+}
+function buildWorldConfig(connectToWorld, worldUrl) {
+  if (connectToWorld && worldUrl) {
+    return `  // World SDK Integration \u2014 connect this agent to a Moltium World
+  // The agent will auto-join the world on startup and register world actions:
+  // join_world, leave_world, query_world, send_world_message
+  world: {
+    url: process.env.WORLD_URL || '${worldUrl}',
+    autoJoin: true,
+  },
+
+`;
+  }
+  return `  // World SDK Integration \u2014 connect this agent to a Moltium World
+  // Uncomment to join a world on startup. Automatically registers world actions:
+  // join_world, leave_world, query_world, send_world_message
+  // world: {
+  //   url: process.env.WORLD_URL || 'http://localhost:4000',
+  //   autoJoin: true,
+  // },
+
+`;
+}
 
 // src/templates/code-based/start.ts
 function codeStartTemplate(ctx) {
+  const a2aComment = ctx.enableA2A !== false ? `// A2A Protocol endpoints are enabled by default:
+// - /.well-known/agent-card.json (Agent discovery)
+// - /a2a/jsonrpc (JSON-RPC transport)
+// - /a2a/rest (HTTP+JSON/REST transport)
+// To disable, pass { enableA2A: false } to startServer()` : `// A2A Protocol is disabled
+// To enable, pass { enableA2A: true } to startServer()`;
+  const a2aConfig = ctx.enableA2A !== false ? `,
+  enableA2A: true, // Enable A2A Protocol endpoints` : `,
+  enableA2A: false`;
   return `import 'dotenv/config';
 import { Agent, startServer } from '@moltium/core';
 import config from './agent.config.js';
@@ -118,6 +169,8 @@ import { onShutdown } from './hooks/onShutdown.js';
  * 2. Wires up lifecycle hooks (onInit, onTick, onShutdown)
  * 3. Starts the HTTP server with REST endpoints
  *
+ * ${a2aComment}
+ *
  * Run with:  npx tsx start.ts
  * Or:        npm start
  */
@@ -133,7 +186,13 @@ const agent = new Agent(config, {
 
 const port = parseInt(process.env.PORT || '3000', 10);
 
-startServer(agent, { port }).catch((err) => {
+startServer(agent, { 
+  port${a2aConfig},
+  a2aConfig: {
+    enabled: true,
+    baseUrl: \`http://0.0.0.0:\${port}\`,
+  },
+}).catch((err) => {
   console.error('Failed to start agent:', err);
   process.exit(1);
 });
@@ -285,6 +344,8 @@ export async function onShutdown(agent: Agent): Promise<void> {
 // src/templates/markdown-based/index.ts
 function markdownTemplate(ctx) {
   const socialSections = buildSocialSections(ctx.socialPlatforms);
+  const a2aSection = ctx.enableA2A !== false ? buildA2ASection() : "";
+  const worldSection = buildWorldSection(ctx.connectToWorld, ctx.worldUrl);
   return `# Agent Configuration
 
 ## Identity
@@ -299,7 +360,7 @@ detailed trait definitions.
 
 ## Social Platforms
 ${socialSections}
-
+${a2aSection}${worldSection}
 ## Behaviors
 autonomous: true
 decision_making: llm-driven
@@ -372,11 +433,53 @@ Content strategy:
 - Minimal hashtag use (0-2 per tweet)`);
   return sections.join("\n\n");
 }
+function buildA2ASection() {
+  return `
+## A2A Protocol (Agent-to-Agent Communication)
+<!--
+Uncomment to enable communication with other agents.
+When enabled, automatically registers 'talk_to_agent' action.
+
+a2a:
+  enabled: true
+  peers:
+    talk_to_analyst: http://localhost:3001
+    talk_to_researcher: http://localhost:3002
+  verbose: false
+-->
+
+`;
+}
+function buildWorldSection(connectToWorld, worldUrl) {
+  if (connectToWorld && worldUrl) {
+    return `## World
+url: ${worldUrl}
+auto_join: true
+
+`;
+  }
+  return `## World
+<!-- Uncomment to connect this agent to a Moltium World on startup -->
+<!-- Automatically registers: join_world, leave_world, query_world, send_world_message -->
+<!-- url: http://localhost:4000 -->
+<!-- auto_join: true -->
+
+`;
+}
 
 // src/templates/markdown-based/start.ts
 function markdownStartTemplate(ctx) {
   const envKey = ctx.llmProvider === "anthropic" ? "ANTHROPIC_API_KEY" : "OPENAI_API_KEY";
   const model = ctx.llmProvider === "anthropic" ? "claude-sonnet-4-20250514" : "gpt-4o";
+  const a2aComment = ctx.enableA2A !== false ? `// A2A Protocol endpoints are enabled by default:
+// - /.well-known/agent-card.json (Agent discovery)
+// - /a2a/jsonrpc (JSON-RPC transport)
+// - /a2a/rest (HTTP+JSON/REST transport)
+// To disable, pass { enableA2A: false } to startServer()` : `// A2A Protocol is disabled
+// To enable, pass { enableA2A: true } to startServer()`;
+  const a2aConfig = ctx.enableA2A !== false ? `,
+  enableA2A: true, // Enable A2A Protocol endpoints` : `,
+  enableA2A: false`;
   return `import 'dotenv/config';
 import { readFileSync, readdirSync, existsSync } from 'node:fs';
 import { join, basename } from 'node:path';
@@ -392,6 +495,8 @@ import type { AgentConfig } from '@moltium/core';
  * 3. Registers skills as LLM-interpreted actions
  * 4. Starts the HTTP server with REST endpoints
  *
+ * ${a2aComment}
+ *
  * Run with:  npx tsx start.ts
  * Or:        npm start
  */
@@ -437,6 +542,16 @@ if (config.social.twitter?.enabled) {
   };
 }
 
+// \u2500\u2500 Wire world config from environment \u2500\u2500
+// WORLD_URL env var overrides the value in agent.md
+if (process.env.WORLD_URL) {
+  config.world = {
+    url: process.env.WORLD_URL,
+    autoJoin: config.world?.autoJoin !== false,
+    walletAddress: config.world?.walletAddress,
+  };
+}
+
 // \u2500\u2500 Create agent \u2500\u2500
 const agent = new Agent(config);
 
@@ -516,7 +631,13 @@ agent.setHooks({
 // \u2500\u2500 Start \u2500\u2500
 const port = parseInt(process.env.PORT || '3000', 10);
 
-startServer(agent, { port }).catch((err) => {
+startServer(agent, {
+  port${a2aConfig},
+  a2aConfig: {
+    enabled: true,
+    baseUrl: \`http://0.0.0.0:\${port}\`,
+  },
+}).catch((err) => {
   console.error('Failed to start agent:', err);
   process.exit(1);
 });
@@ -1012,7 +1133,7 @@ function getCoreDepVersion() {
     const corePkg = require2("@moltium/core/package.json");
     return `^${corePkg.version}`;
   } catch {
-    return "^0.1.19";
+    return "^0.1.21";
   }
 }
 var initCommand = new Command("init").description("Initialize a new Moltium agent").argument("[name]", "Agent name").action(async (name) => {
@@ -1058,6 +1179,25 @@ var initCommand = new Command("init").description("Initialize a new Moltium agen
         { name: "Twitter", value: "twitter" }
       ]
     },
+    {
+      type: "confirm",
+      name: "enableA2A",
+      message: "Enable A2A Protocol support? (Agent-to-Agent communication)",
+      default: true
+    },
+    {
+      type: "confirm",
+      name: "connectToWorld",
+      message: "Connect to a Moltium World? (World SDK integration)",
+      default: false
+    },
+    {
+      type: "input",
+      name: "worldUrl",
+      message: "World server URL:",
+      default: "http://localhost:4000",
+      when: (answers2) => answers2.connectToWorld
+    },
     {
       type: "list",
       name: "deployTarget",
@@ -1222,6 +1362,13 @@ function generateEnvFile(ctx) {
   lines.push(`${tw}TWITTER_ACCESS_TOKEN=your-twitter-access-token`);
   lines.push(`${tw}TWITTER_ACCESS_SECRET=your-twitter-access-secret`);
   lines.push("");
+  lines.push("# World SDK Integration (set URL to auto-connect on startup)");
+  if (ctx.connectToWorld && ctx.worldUrl) {
+    lines.push(`WORLD_URL=${ctx.worldUrl}`);
+  } else {
+    lines.push("# WORLD_URL=http://localhost:4000");
+  }
+  lines.push("");
   lines.push("PORT=3000");
   lines.push("LOG_LEVEL=info");
   lines.push("");
@@ -1238,7 +1385,7 @@ import ora2 from "ora";
 import { config as loadEnv } from "dotenv";
 import { createInterface } from "readline";
 import { ConfigLoader, Agent, MarkdownParser, startServer, AnthropicProvider, OpenAIProvider, buildSystemPrompt } from "@moltium/core";
-var startCommand = new Command2("start").description("Start agent locally").option("-p, --port <number>", "Port to run on", "3000").option("-e, --env <file>", "Environment file", ".env").option("--debug", "Enable debug logging").option("--dry-run", "Test agent in terminal without posting to social platforms").option("--watch", "Watch for file changes (not yet implemented)").action(async (options) => {
+var startCommand = new Command2("start").description("Start agent locally").option("-p, --port <number>", "Port to run on", "3000").option("-e, --env <file>", "Environment file", ".env").option("--debug", "Enable debug logging").option("--dry-run", "Test agent in terminal without posting to social platforms").option("--no-a2a", "Disable A2A Protocol endpoints").option("--watch", "Watch for file changes (not yet implemented)").action(async (options) => {
   const agentDir = resolve2(process.cwd());
   loadEnv({ path: resolve2(agentDir, options.env) });
   if (options.debug) {
@@ -1275,7 +1422,11 @@ var startCommand = new Command2("start").description("Start agent locally").opti
       await wireMarkdownBasedAgent(agent, agentDir, spinner);
     }
     spinner.succeed(chalk2.green(`Agent "${config.name}" loaded (${type} config)`));
-    await startServer(agent, { port: parseInt(options.port, 10) });
+    await startServer(agent, {
+      port: parseInt(options.port, 10),
+      enableA2A: options.a2a !== false
+      // A2A enabled by default, disabled only if --no-a2a is passed
+    });
   } catch (error) {
     spinner.fail(chalk2.red("Failed to start agent"));
     console.error(error instanceof Error ? error.message : error);
@@ -3262,7 +3413,7 @@ Failed to reach agent at ${url}`));
 
 // src/index.ts
 var program = new Command7();
-program.name("moltium").description("Moltium Agent SDK \u2014 create and manage autonomous AI agents").version("0.1.19");
+program.name("moltium").description("Moltium Agent SDK \u2014 create and manage autonomous AI agents").version("0.1.20");
 program.addCommand(initCommand);
 program.addCommand(startCommand);
 program.addCommand(deployCommand);