@moltium/core 0.1.20 → 0.1.22

package/dist/index.d.cts

@@ -133,6 +133,15 @@ interface AgentConfig {
     actions: string[];
     customActions?: Action[];
     scheduling?: ScheduledTask[];
+    /** World SDK integration — connect this agent to a world */
+    world?: {
+        /** URL of the world to join */
+        url: string;
+        /** Wallet address for blockchain-enabled worlds */
+        walletAddress?: string;
+        /** Auto-join the world when agent starts (default: true) */
+        autoJoin?: boolean;
+    };
     webhooks?: {
         onAction?: string | ((action: any, result: any) => Promise<void>);
         onError?: string;
@@ -538,6 +547,7 @@ declare class Agent {
     private scheduledPost;
     private executeScheduledTask;
     private logPlatformError;
+    private autoJoinWorld;
     private startAutonomousLoop;
     private isSleeping;
     private gatherContext;
@@ -585,6 +595,7 @@ declare class MarkdownParser {
     private parseSocial;
     private parseBehaviors;
     private parseMemory;
+    private parseWorld;
     private parseSleepSchedule;
     private parseKeyValueLines;
     private parseScheduling;
@@ -768,6 +779,48 @@ declare function createMarkdownAction(name: string, description: string, llmProv
 /** All Moltbook-specific actions */
 declare const moltbookActions: Action[];
 
+/**
+ * ============================================================================
+ * WORLD SDK BUILT-IN ACTIONS
+ * ============================================================================
+ *
+ * Built-in actions for agents to interact with worlds created using
+ * @moltium/world-core. These use plain HTTP to call the world's REST endpoints.
+ */
+/**
+ * Creates a join_world action that POSTs to a world's /world/join endpoint
+ */
+declare function createJoinWorldAction(config?: {
+    defaultWorldUrl?: string;
+}): Action;
+/**
+ * Creates a leave_world action that DELETEs from a world's /world/agents endpoint
+ */
+declare function createLeaveWorldAction(config?: {
+    defaultWorldUrl?: string;
+}): Action;
+/**
+ * Creates a query_world action that GETs world state and info
+ */
+declare function createQueryWorldAction(config?: {
+    defaultWorldUrl?: string;
+}): Action;
+/**
+ * Creates a send_world_message action for agent-to-agent messaging through a world
+ */
+declare function createSendWorldMessageAction(config?: {
+    defaultWorldUrl?: string;
+}): Action;
+/**
+ * All world actions as a convenience array
+ */
+declare const worldActions: {
+    createJoinWorldAction: typeof createJoinWorldAction;
+    createLeaveWorldAction: typeof createLeaveWorldAction;
+    createQueryWorldAction: typeof createQueryWorldAction;
+    createSendWorldMessageAction: typeof createSendWorldMessageAction;
+};
+
 declare const builtInActions: Action[];
 
 interface A2AConfig {
@@ -891,6 +944,126 @@ declare class A2AIntegration {
  */
 declare function createA2AIntegration(agent: Agent, options?: Partial<A2AServerOptions>): A2AIntegration;
 
+/**
+ * Configuration for A2A client operations
+ */
+interface A2AClientConfig {
+    /**
+     * The base URL of the target agent
+     * @example 'http://localhost:3001'
+     */
+    agentUrl: string;
+    /**
+     * Path to the agent card (defaults to '.well-known/agent-card.json')
+     */
+    agentCardPath?: string;
+    /**
+     * Timeout for requests in milliseconds (optional)
+     */
+    timeout?: number;
+}
+/**
+ * Options for sending messages via A2A
+ */
+interface A2AMessageOptions {
+    /**
+     * The text message to send
+     */
+    text: string;
+    /**
+     * Optional context ID to group related messages
+     */
+    contextId?: string;
+    /**
+     * Optional metadata for extensions
+     */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Response from an A2A message
+ */
+interface A2AMessageResponse {
+    /**
+     * Whether the message was successfully sent and received
+     */
+    success: boolean;
+    /**
+     * The reply text from the agent (if successful)
+     */
+    reply?: string;
+    /**
+     * The agent URL that responded
+     */
+    agentUrl?: string;
+    /**
+     * Error message (if failed)
+     */
+    error?: string;
+    /**
+     * Raw response from the A2A protocol (for advanced use)
+     */
+    raw?: any;
+}
+/**
+ * Wrapper around A2A Client SDK with improved developer experience
+ *
+ * @example
+ * ```typescript
+ * const client = new A2AClient({ agentUrl: 'http://localhost:3001' });
+ * const response = await client.sendMessage({ text: 'Hello!' });
+ * console.log(response.reply);
+ * ```
+ */
+declare class A2AClient {
+    private sdkClient;
+    private config;
+    constructor(config: A2AClientConfig);
+    /**
+     * Send a text message to the agent and get a response
+     *
+     * @param options Message options including text content
+     * @returns Promise resolving to the agent's response
+     *
+     * @example
+     * ```typescript
+     * const response = await client.sendMessage({
+     *   text: 'What are your thoughts on AI?',
+     *   contextId: 'conversation-123'
+     * });
+     *
+     * if (response.success) {
+     *   console.log('Agent replied:', response.reply);
+     * }
+     * ```
+     */
+    sendMessage(options: A2AMessageOptions): Promise<A2AMessageResponse>;
+    /**
+     * Extract text reply from A2A protocol response
+     * Handles both Message and Task response types
+     */
+    private extractReply;
+    /**
+     * Get the agent card information
+     *
+     * @returns Promise resolving to the agent card
+     */
+    getAgentCard(): Promise<any>;
+    /**
+     * Get the base URL of the agent
+     */
+    getAgentUrl(): string;
+}
+/**
+ * Factory function to create A2A clients easily
+ *
+ * @example
+ * ```typescript
+ * const client = createA2AClient('http://localhost:3001');
+ * const response = await client.sendMessage({ text: 'Hello!' });
+ * ```
+ */
+declare function createA2AClient(agentUrlOrConfig: string | A2AClientConfig): A2AClient;
+
 interface ServerOptions {
     port?: number;
     host?: string;
@@ -904,4 +1077,4 @@ declare function createRoutes(agent: Agent): Router;
 
 declare function createLogger(label: string): winston.Logger;
 
-export { type A2AConfig, A2AIntegration, type A2AServerOptions, type Action, type ActionContext, ActionHandler, ActionRegistry, type ActionResult, Agent, AgentCardBuilder, type AgentConfig, type AgentState, AnthropicProvider, type BehaviorTrigger, type Comment, ConfigLoader, type ConfigType, type Conversation, type ConversationDetail, type CustomAPIConfig, type CustomCLIConfig, type CustomDeploymentConfig, type CustomDockerConfig, type CustomSSHConfig, type DMCheckResult, type DMRequest, type Decision, type DeploymentConfig, type DeploymentResult, type DeploymentStatus, type DirectMessage, type Experience, type FeedOptions, type GenerateOptions, LLMProvider, type LifecycleEvent, type LifecycleHooks, LongTermMemory, MarkdownParser, Memory, type Mention, type Message, MoltbookAdapter, type MoltbookConfig, type MoltbookRegistration, type MoltbookStatus, MoltiumExecutor, OpenAIProvider, type Plugin, type Post, type PostResult, type PostgresConfig, type Profile, type RedisConfig, type ReplyResult, type ScheduledJob, type ScheduledTask, Scheduler, type SearchOptions, type SearchResult, type ServerOptions, ShortTermMemory, SocialAdapter, type SocialConfig, type SocialPlatformConfig, type StructuredSchema, type Submolt, type SubmoltSettings, type TimelineOptions, TwitterAdapter, type TwitterConfig, buildDecisionPrompt, buildSkillPrompt, buildSystemPrompt, builtInActions, createA2AIntegration, createApp, createLogger, createMarkdownAction, createRoutes, moltbookActions, startServer, validateConfig };
+export { A2AClient, type A2AClientConfig, type A2AConfig, A2AIntegration, type A2AMessageOptions, type A2AMessageResponse, type A2AServerOptions, type Action, type ActionContext, ActionHandler, ActionRegistry, type ActionResult, Agent, AgentCardBuilder, type AgentConfig, type AgentState, AnthropicProvider, type BehaviorTrigger, type Comment, ConfigLoader, type ConfigType, type Conversation, type ConversationDetail, type CustomAPIConfig, type CustomCLIConfig, type CustomDeploymentConfig, type CustomDockerConfig, type CustomSSHConfig, type DMCheckResult, type DMRequest, type Decision, type DeploymentConfig, type DeploymentResult, type DeploymentStatus, type DirectMessage, type Experience, type FeedOptions, type GenerateOptions, LLMProvider, type LifecycleEvent, type LifecycleHooks, LongTermMemory, MarkdownParser, Memory, type Mention, type Message, MoltbookAdapter, type MoltbookConfig, type MoltbookRegistration, type MoltbookStatus, MoltiumExecutor, OpenAIProvider, type Plugin, type Post, type PostResult, type PostgresConfig, type Profile, type RedisConfig, type ReplyResult, type ScheduledJob, type ScheduledTask, Scheduler, type SearchOptions, type SearchResult, type ServerOptions, ShortTermMemory, SocialAdapter, type SocialConfig, type SocialPlatformConfig, type StructuredSchema, type Submolt, type SubmoltSettings, type TimelineOptions, TwitterAdapter, type TwitterConfig, buildDecisionPrompt, buildSkillPrompt, buildSystemPrompt, builtInActions, createA2AClient, createA2AIntegration, createApp, createJoinWorldAction, createLeaveWorldAction, createLogger, createMarkdownAction, createQueryWorldAction, createRoutes, createSendWorldMessageAction, moltbookActions, startServer, validateConfig, worldActions };

package/dist/index.d.ts

@@ -133,6 +133,15 @@ interface AgentConfig {
     actions: string[];
     customActions?: Action[];
     scheduling?: ScheduledTask[];
+    /** World SDK integration — connect this agent to a world */
+    world?: {
+        /** URL of the world to join */
+        url: string;
+        /** Wallet address for blockchain-enabled worlds */
+        walletAddress?: string;
+        /** Auto-join the world when agent starts (default: true) */
+        autoJoin?: boolean;
+    };
     webhooks?: {
         onAction?: string | ((action: any, result: any) => Promise<void>);
         onError?: string;
@@ -538,6 +547,7 @@ declare class Agent {
     private scheduledPost;
     private executeScheduledTask;
     private logPlatformError;
+    private autoJoinWorld;
     private startAutonomousLoop;
     private isSleeping;
     private gatherContext;
@@ -585,6 +595,7 @@ declare class MarkdownParser {
     private parseSocial;
     private parseBehaviors;
     private parseMemory;
+    private parseWorld;
     private parseSleepSchedule;
     private parseKeyValueLines;
     private parseScheduling;
@@ -768,6 +779,48 @@ declare function createMarkdownAction(name: string, description: string, llmProv
 /** All Moltbook-specific actions */
 declare const moltbookActions: Action[];
 
+/**
+ * ============================================================================
+ * WORLD SDK BUILT-IN ACTIONS
+ * ============================================================================
+ *
+ * Built-in actions for agents to interact with worlds created using
+ * @moltium/world-core. These use plain HTTP to call the world's REST endpoints.
+ */
+/**
+ * Creates a join_world action that POSTs to a world's /world/join endpoint
+ */
+declare function createJoinWorldAction(config?: {
+    defaultWorldUrl?: string;
+}): Action;
+/**
+ * Creates a leave_world action that DELETEs from a world's /world/agents endpoint
+ */
+declare function createLeaveWorldAction(config?: {
+    defaultWorldUrl?: string;
+}): Action;
+/**
+ * Creates a query_world action that GETs world state and info
+ */
+declare function createQueryWorldAction(config?: {
+    defaultWorldUrl?: string;
+}): Action;
+/**
+ * Creates a send_world_message action for agent-to-agent messaging through a world
+ */
+declare function createSendWorldMessageAction(config?: {
+    defaultWorldUrl?: string;
+}): Action;
+/**
+ * All world actions as a convenience array
+ */
+declare const worldActions: {
+    createJoinWorldAction: typeof createJoinWorldAction;
+    createLeaveWorldAction: typeof createLeaveWorldAction;
+    createQueryWorldAction: typeof createQueryWorldAction;
+    createSendWorldMessageAction: typeof createSendWorldMessageAction;
+};
+
 declare const builtInActions: Action[];
 
 interface A2AConfig {
@@ -891,6 +944,126 @@ declare class A2AIntegration {
  */
 declare function createA2AIntegration(agent: Agent, options?: Partial<A2AServerOptions>): A2AIntegration;
 
+/**
+ * Configuration for A2A client operations
+ */
+interface A2AClientConfig {
+    /**
+     * The base URL of the target agent
+     * @example 'http://localhost:3001'
+     */
+    agentUrl: string;
+    /**
+     * Path to the agent card (defaults to '.well-known/agent-card.json')
+     */
+    agentCardPath?: string;
+    /**
+     * Timeout for requests in milliseconds (optional)
+     */
+    timeout?: number;
+}
+/**
+ * Options for sending messages via A2A
+ */
+interface A2AMessageOptions {
+    /**
+     * The text message to send
+     */
+    text: string;
+    /**
+     * Optional context ID to group related messages
+     */
+    contextId?: string;
+    /**
+     * Optional metadata for extensions
+     */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Response from an A2A message
+ */
+interface A2AMessageResponse {
+    /**
+     * Whether the message was successfully sent and received
+     */
+    success: boolean;
+    /**
+     * The reply text from the agent (if successful)
+     */
+    reply?: string;
+    /**
+     * The agent URL that responded
+     */
+    agentUrl?: string;
+    /**
+     * Error message (if failed)
+     */
+    error?: string;
+    /**
+     * Raw response from the A2A protocol (for advanced use)
+     */
+    raw?: any;
+}
+/**
+ * Wrapper around A2A Client SDK with improved developer experience
+ *
+ * @example
+ * ```typescript
+ * const client = new A2AClient({ agentUrl: 'http://localhost:3001' });
+ * const response = await client.sendMessage({ text: 'Hello!' });
+ * console.log(response.reply);
+ * ```
+ */
+declare class A2AClient {
+    private sdkClient;
+    private config;
+    constructor(config: A2AClientConfig);
+    /**
+     * Send a text message to the agent and get a response
+     *
+     * @param options Message options including text content
+     * @returns Promise resolving to the agent's response
+     *
+     * @example
+     * ```typescript
+     * const response = await client.sendMessage({
+     *   text: 'What are your thoughts on AI?',
+     *   contextId: 'conversation-123'
+     * });
+     *
+     * if (response.success) {
+     *   console.log('Agent replied:', response.reply);
+     * }
+     * ```
+     */
+    sendMessage(options: A2AMessageOptions): Promise<A2AMessageResponse>;
+    /**
+     * Extract text reply from A2A protocol response
+     * Handles both Message and Task response types
+     */
+    private extractReply;
+    /**
+     * Get the agent card information
+     *
+     * @returns Promise resolving to the agent card
+     */
+    getAgentCard(): Promise<any>;
+    /**
+     * Get the base URL of the agent
+     */
+    getAgentUrl(): string;
+}
+/**
+ * Factory function to create A2A clients easily
+ *
+ * @example
+ * ```typescript
+ * const client = createA2AClient('http://localhost:3001');
+ * const response = await client.sendMessage({ text: 'Hello!' });
+ * ```
+ */
+declare function createA2AClient(agentUrlOrConfig: string | A2AClientConfig): A2AClient;
+
 interface ServerOptions {
     port?: number;
     host?: string;
@@ -904,4 +1077,4 @@ declare function createRoutes(agent: Agent): Router;
 
 declare function createLogger(label: string): winston.Logger;
 
-export { type A2AConfig, A2AIntegration, type A2AServerOptions, type Action, type ActionContext, ActionHandler, ActionRegistry, type ActionResult, Agent, AgentCardBuilder, type AgentConfig, type AgentState, AnthropicProvider, type BehaviorTrigger, type Comment, ConfigLoader, type ConfigType, type Conversation, type ConversationDetail, type CustomAPIConfig, type CustomCLIConfig, type CustomDeploymentConfig, type CustomDockerConfig, type CustomSSHConfig, type DMCheckResult, type DMRequest, type Decision, type DeploymentConfig, type DeploymentResult, type DeploymentStatus, type DirectMessage, type Experience, type FeedOptions, type GenerateOptions, LLMProvider, type LifecycleEvent, type LifecycleHooks, LongTermMemory, MarkdownParser, Memory, type Mention, type Message, MoltbookAdapter, type MoltbookConfig, type MoltbookRegistration, type MoltbookStatus, MoltiumExecutor, OpenAIProvider, type Plugin, type Post, type PostResult, type PostgresConfig, type Profile, type RedisConfig, type ReplyResult, type ScheduledJob, type ScheduledTask, Scheduler, type SearchOptions, type SearchResult, type ServerOptions, ShortTermMemory, SocialAdapter, type SocialConfig, type SocialPlatformConfig, type StructuredSchema, type Submolt, type SubmoltSettings, type TimelineOptions, TwitterAdapter, type TwitterConfig, buildDecisionPrompt, buildSkillPrompt, buildSystemPrompt, builtInActions, createA2AIntegration, createApp, createLogger, createMarkdownAction, createRoutes, moltbookActions, startServer, validateConfig };
+export { A2AClient, type A2AClientConfig, type A2AConfig, A2AIntegration, type A2AMessageOptions, type A2AMessageResponse, type A2AServerOptions, type Action, type ActionContext, ActionHandler, ActionRegistry, type ActionResult, Agent, AgentCardBuilder, type AgentConfig, type AgentState, AnthropicProvider, type BehaviorTrigger, type Comment, ConfigLoader, type ConfigType, type Conversation, type ConversationDetail, type CustomAPIConfig, type CustomCLIConfig, type CustomDeploymentConfig, type CustomDockerConfig, type CustomSSHConfig, type DMCheckResult, type DMRequest, type Decision, type DeploymentConfig, type DeploymentResult, type DeploymentStatus, type DirectMessage, type Experience, type FeedOptions, type GenerateOptions, LLMProvider, type LifecycleEvent, type LifecycleHooks, LongTermMemory, MarkdownParser, Memory, type Mention, type Message, MoltbookAdapter, type MoltbookConfig, type MoltbookRegistration, type MoltbookStatus, MoltiumExecutor, OpenAIProvider, type Plugin, type Post, type PostResult, type PostgresConfig, type Profile, type RedisConfig, type ReplyResult, type ScheduledJob, type ScheduledTask, Scheduler, type SearchOptions, type SearchResult, type ServerOptions, ShortTermMemory, SocialAdapter, type SocialConfig, type SocialPlatformConfig, type StructuredSchema, type Submolt, type SubmoltSettings, type TimelineOptions, TwitterAdapter, type TwitterConfig, buildDecisionPrompt, buildSkillPrompt, buildSystemPrompt, builtInActions, createA2AClient, createA2AIntegration, createApp, createJoinWorldAction, createLeaveWorldAction, createLogger, createMarkdownAction, createQueryWorldAction, createRoutes, createSendWorldMessageAction, moltbookActions, startServer, validateConfig, worldActions };