@elizaos/plugin-farcaster 1.0.2 → 1.0.5

package/README.md

@@ -1,26 +1,41 @@
 # ElizaOS Farcaster Plugin
 
-A plugin for ElizaOS that enables agent integration with the Farcaster social network.
+A comprehensive plugin for ElizaOS that enables AI agents to fully participate in the Farcaster social network with posting, replying, and engagement capabilities.
 
 ## Overview
 
-The ElizaOS Farcaster Plugin allows AI agents to interact with the Farcaster social network by:
+The ElizaOS Farcaster Plugin provides a complete integration with Farcaster, allowing AI agents to:
 
-- Publishing original casts (posts)
-- Responding to mentions and replies
-- Interacting with other users' content
-- Processing user engagement automatically
+- **Post & Reply**: Create original casts and reply to conversations
+- **Monitor Mentions**: Track and respond to mentions automatically
+- **Engage with Content**: Like, recast, and interact with other users' posts
+- **Context-Aware Responses**: Maintain conversation threads and context
+- **Real-time Interaction**: Process interactions in real-time with configurable intervals
 
-This plugin leverages the [Neynar API](https://neynar.com) to interact with Farcaster, providing a robust integration between ElizaOS agents and the Farcaster social graph.
+This plugin leverages the [Neynar API](https://neynar.com) and implements full ElizaOS service interfaces for seamless integration.
 
 ## Features
 
-- **Automated Posting**: Schedule and publish regular casts with configurable intervals
-- **Engagement Monitoring**: Track mentions, replies, and interactions
-- **Conversation Threading**: Build and maintain conversation context for natural interactions
-- **Dry Run Mode**: Test functionality without actually posting to Farcaster
-- **Configurable Settings**: Customize behavior via environment variables
-- **Caching**: Efficient caching of profiles and casts for improved performance
+### Core Services
+- **FarcasterService**: Main service managing agent connections and lifecycle
+- **MessageService**: Implements `IMessageService` for sending/receiving messages
+- **CastService**: Implements `IPostService` for creating and managing casts
+
+### Actions
+- **SEND_CAST**: Post casts based on user requests
+- **REPLY_TO_CAST**: Reply to existing casts with context
+
+### Providers
+- **farcasterProfile**: Provides agent's Farcaster profile information
+- **farcasterTimeline**: Supplies recent timeline casts for context
+
+### Additional Features
+- **Automated Posting**: Schedule and publish regular casts
+- **Engagement Monitoring**: Track mentions and interactions
+- **Conversation Threading**: Maintain conversation context
+- **Metadata Tracking**: Store cast metadata for reference
+- **Health Monitoring**: Built-in health check functionality
+- **Caching**: Efficient caching for improved performance
 
 ## Installation
 
@@ -28,6 +43,36 @@ This plugin leverages the [Neynar API](https://neynar.com) to interact with Farc
 npm install @elizaos/plugin-farcaster
 ```
 
+## Setup
+
+### 1. Get Farcaster Credentials
+
+1. **Create a Farcaster Account**: If you don't have one, sign up at [Warpcast](https://warpcast.com)
+2. **Note your FID**: Find your Farcaster ID in your profile settings
+3. **Get Neynar API Access**:
+   - Sign up at [Neynar Developer Portal](https://dev.neynar.com/)
+   - Create a new application
+   - Copy your API key
+4. **Create a Signer**:
+   - In the Neynar dashboard, go to "Signers"
+   - Create a new signer for your FID
+   - Copy the Signer UUID
+
+### 2. Configure Environment
+
+Copy the example environment file and fill in your credentials:
+
+```bash
+cp env.example .env
+```
+
+Edit `.env` with your credentials:
+```env
+FARCASTER_FID=your-fid-here
+FARCASTER_NEYNAR_API_KEY=your-api-key-here
+FARCASTER_SIGNER_UUID=your-signer-uuid-here
+```
+
 ## Configuration
 
 The plugin requires the following configurations, which can be set via environment variables or ElizaOS runtime settings:
@@ -37,7 +82,7 @@ The plugin requires the following configurations, which can be set via environme
 | Parameter                      | Description                            |
 | ------------------------------ | -------------------------------------- |
 | `FARCASTER_NEYNAR_API_KEY`     | Neynar API key for accessing Farcaster |
-| `FARCASTER_NEYNAR_SIGNER_UUID` | Signer UUID for your Farcaster account |
+| `FARCASTER_SIGNER_UUID` | Signer UUID for your Farcaster account |
 | `FARCASTER_FID`                | Your Farcaster FID (identifier)        |
 
 ### Optional Settings
@@ -47,33 +92,66 @@ The plugin requires the following configurations, which can be set via environme
 | `FARCASTER_DRY_RUN`        | Run in simulation mode without posting (true/false) | false   |
 | `MAX_CAST_LENGTH`          | Maximum length of casts                             | 320     |
 | `FARCASTER_POLL_INTERVAL`  | Interval for checking mentions (minutes)            | 2       |
-| `ENABLE_POST`              | Enable automatic posting (true/false)               | true    |
-| `POST_INTERVAL_MIN`        | Minimum time between posts (minutes)                | 90      |
-| `POST_INTERVAL_MAX`        | Maximum time between posts (minutes)                | 180     |
+| `ENABLE_CAST`              | Enable automatic casting (true/false)               | true    |
+| `CAST_INTERVAL_MIN`        | Minimum time between casts (minutes)                | 90      |
+| `CAST_INTERVAL_MAX`        | Maximum time between casts (minutes)                | 180     |
 | `ENABLE_ACTION_PROCESSING` | Enable processing interactions (true/false)         | false   |
 | `ACTION_INTERVAL`          | Interval for processing actions (minutes)           | 5       |
-| `POST_IMMEDIATELY`         | Post immediately on startup (true/false)            | false   |
+| `CAST_IMMEDIATELY`         | Cast immediately on startup (true/false)            | false   |
 | `MAX_ACTIONS_PROCESSING`   | Maximum actions to process in one cycle             | 1       |
 | `ACTION_TIMELINE_TYPE`     | Type of timeline to use for actions                 | ForYou  |
 
 ## Usage
 
-### Basic Integration with ElizaOS
+### Basic Integration
+
+1. **In your agent's character file**:
+
+```json
+{
+  "name": "MyFarcasterAgent",
+  "bio": "An AI agent on Farcaster",
+  "plugins": ["@elizaos/plugin-farcaster"],
+  "settings": {
+    "FARCASTER_FID": "123456",
+    "FARCASTER_NEYNAR_API_KEY": "your-api-key",
+    "FARCASTER_SIGNER_UUID": "your-signer-uuid"
+  }
+}
+```
 
-```typescript
-import { ElizaOS } from '@elizaos/core';
-import farcasterPlugin from '@elizaos-plugins/client-farcaster';
+2. **Start your agent**:
 
-// Initialize ElizaOS
-const elizaOs = new ElizaOS({
-  // ElizaOS configuration
-});
+```bash
+elizaos start --character path/to/character.json
+```
 
-// Register the Farcaster plugin
-elizaOs.registerPlugin(farcasterPlugin);
+### Using Actions
 
-// Start ElizaOS
-elizaOs.start();
+The plugin provides actions that can be triggered through natural language:
+
+```
+User: "Can you post about the new ElizaOS features on Farcaster?"
+Agent: "I'll post about the new ElizaOS features on Farcaster now."
+[Agent posts to Farcaster]
+
+User: "Reply to that cast and thank them for the feedback"
+Agent: "I'll reply with a thank you message."
+[Agent replies to the cast]
+```
+
+### Programmatic Usage
+
+```typescript
+import farcasterPlugin from '@elizaos/plugin-farcaster';
+
+// The plugin exports its components
+const { actions, providers, services } = farcasterPlugin;
+
+// Access specific services programmatically
+const farcasterService = runtime.getService('farcaster');
+const messageService = farcasterService.getMessageService(agentId);
+const castService = farcasterService.getCastService(agentId);
 ```
 
 ### Customizing Cast Templates
@@ -123,28 +201,69 @@ npm run dev
 
 ## Architecture
 
-The client is organized into several core components:
+The plugin is organized into several core components:
 
-- **FarcasterClient**: Base client for interacting with the Farcaster network via Neynar
-- **FarcasterPostManager**: Manages autonomous posting schedule and generation
-- **FarcasterInteractionManager**: Handles mentions, replies, and other interactions
-- **Memory Management**: Stores conversation context and history
+### Services
+- **FarcasterService**: Main service managing agent lifecycle and health monitoring
+- **MessageService**: Handles sending/receiving messages, implements `IMessageService`
+- **CastService**: Manages casts and interactions, implements `IPostService`
 
-## Dependencies
+### Managers
+- **FarcasterClient**: Base client for Neynar API interactions
+- **FarcasterAgentManager**: Manages agent-specific connections
+- **FarcasterInteractionManager**: Handles mentions and replies
+- **FarcasterCastManager**: Manages autonomous casting
 
-- [@neynar/nodejs-sdk](https://www.npmjs.com/package/@neynar/nodejs-sdk): Official SDK for Neynar API
-- [@elizaos/core](https://www.npmjs.com/package/@elizaos/core): ElizaOS core framework
+### Components
+- **Actions**: User-triggered capabilities (SEND_CAST, REPLY_TO_CAST)
+- **Providers**: Context providers for agent awareness
+- **Event Handlers**: Metadata tracking and event processing
 
 ## Testing
 
-The client includes comprehensive tests for:
+The plugin includes comprehensive test coverage:
+
+### Unit Tests
+Located in `__tests__/unit/`:
+- Service functionality tests
+- Action validation tests
+- Provider output tests
 
-- Cast creation and management
-- Interaction handling
-- Timeline processing
+### E2E Tests
+Located in `__tests__/e2e/`:
+- Real account interactions
+- Full conversation flows
+- Error handling scenarios
 
-Run the tests with:
+### Running Tests
 
 ```bash
+# Run all tests
 npm test
+
+# Run unit tests only
+npm run test:unit
+
+# Run E2E tests (requires API keys)
+npm run test:e2e
+
+# Run with coverage
+npm run test:coverage
 ```
+
+For E2E tests, ensure your `.env` file contains valid API credentials.
+
+## Dependencies
+
+- [@neynar/nodejs-sdk](https://www.npmjs.com/package/@neynar/nodejs-sdk): Official SDK for Neynar API
+- [@elizaos/core](https://www.npmjs.com/package/@elizaos/core): ElizaOS core framework
+- [lru-cache](https://www.npmjs.com/package/lru-cache): Efficient caching
+- [zod](https://www.npmjs.com/package/zod): Schema validation
+
+## Contributing
+
+Contributions are welcome! Please ensure all tests pass and add new tests for any new functionality.
+
+## License
+
+This plugin is part of the ElizaOS ecosystem and follows the same licensing terms.

package/dist/chunk-FNDASAYG.js

@@ -0,0 +1,83 @@
+import {
+  FARCASTER_SERVICE_NAME
+} from "./chunk-Y2URJ4EZ.js";
+
+// src/providers/timelineProvider.ts
+import {
+  logger
+} from "@elizaos/core";
+var farcasterTimelineProvider = {
+  name: "farcasterTimeline",
+  description: "Provides recent casts from the agent's Farcaster timeline",
+  get: async (runtime, message, state) => {
+    var _a, _b, _c;
+    try {
+      const service = runtime.getService(FARCASTER_SERVICE_NAME);
+      const castService = service == null ? void 0 : service.getCastService(runtime.agentId);
+      if (!castService) {
+        return {
+          text: "Farcaster timeline not available.",
+          data: { available: false }
+        };
+      }
+      const casts = await castService.getCasts({
+        agentId: runtime.agentId,
+        limit: 5
+      });
+      if (!casts || casts.length === 0) {
+        return {
+          text: "No recent casts in your timeline.",
+          data: {
+            available: true,
+            casts: [],
+            count: 0
+          }
+        };
+      }
+      const formattedCasts = casts.map((cast, index) => {
+        const timeAgo = getTimeAgo(new Date(cast.timestamp));
+        return `${index + 1}. @${cast.username} (${timeAgo}): ${cast.text}`;
+      }).join("\n");
+      return {
+        text: `Recent casts from your timeline:
+${formattedCasts}`,
+        data: {
+          available: true,
+          casts: casts.map((c) => {
+            var _a2;
+            return {
+              id: c.id,
+              username: c.username,
+              text: c.text,
+              timestamp: c.timestamp,
+              castHash: (_a2 = c.metadata) == null ? void 0 : _a2.castHash
+            };
+          }),
+          count: casts.length
+        },
+        values: {
+          latestCastHash: (_b = (_a = casts[0]) == null ? void 0 : _a.metadata) == null ? void 0 : _b.castHash,
+          latestCastText: (_c = casts[0]) == null ? void 0 : _c.text
+        }
+      };
+    } catch (error) {
+      logger.error("[FarcasterTimelineProvider] Error:", error);
+      return {
+        text: "Unable to fetch Farcaster timeline.",
+        data: { available: false, error: error instanceof Error ? error.message : "Unknown error" }
+      };
+    }
+  }
+};
+function getTimeAgo(date) {
+  const seconds = Math.floor(((/* @__PURE__ */ new Date()).getTime() - date.getTime()) / 1e3);
+  if (seconds < 60) return "just now";
+  if (seconds < 3600) return `${Math.floor(seconds / 60)}m ago`;
+  if (seconds < 86400) return `${Math.floor(seconds / 3600)}h ago`;
+  return `${Math.floor(seconds / 86400)}d ago`;
+}
+
+export {
+  farcasterTimelineProvider
+};
+//# sourceMappingURL=chunk-FNDASAYG.js.map

package/dist/chunk-FNDASAYG.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/providers/timelineProvider.ts"],"sourcesContent":["import {\n  type Provider,\n  type IAgentRuntime,\n  type Memory,\n  type State,\n  type ProviderResult,\n  logger,\n} from '@elizaos/core';\nimport { FARCASTER_SERVICE_NAME } from '../common/constants';\nimport type { FarcasterService } from '../service';\n\nexport const farcasterTimelineProvider: Provider = {\n  name: 'farcasterTimeline',\n  description: \"Provides recent casts from the agent's Farcaster timeline\",\n\n  get: async (runtime: IAgentRuntime, message: Memory, state: State): Promise<ProviderResult> => {\n    try {\n      const service = runtime.getService(FARCASTER_SERVICE_NAME) as FarcasterService;\n      const castService = service?.getCastService(runtime.agentId);\n\n      if (!castService) {\n        return {\n          text: 'Farcaster timeline not available.',\n          data: { available: false },\n        };\n      }\n\n      // Get recent casts from timeline\n      const casts = await castService.getCasts({\n        agentId: runtime.agentId,\n        limit: 5,\n      });\n\n      if (!casts || casts.length === 0) {\n        return {\n          text: 'No recent casts in your timeline.',\n          data: {\n            available: true,\n            casts: [],\n            count: 0,\n          },\n        };\n      }\n\n      // Format casts for context\n      const formattedCasts = casts\n        .map((cast, index) => {\n          const timeAgo = getTimeAgo(new Date(cast.timestamp));\n          return `${index + 1}. @${cast.username} (${timeAgo}): ${cast.text}`;\n        })\n        .join('\\n');\n\n      return {\n        text: `Recent casts from your timeline:\\n${formattedCasts}`,\n        data: {\n          available: true,\n          casts: casts.map((c) => ({\n            id: c.id,\n            username: c.username,\n            text: c.text,\n            timestamp: c.timestamp,\n            castHash: c.metadata?.castHash,\n          })),\n          count: casts.length,\n        },\n        values: {\n          latestCastHash: casts[0]?.metadata?.castHash,\n          latestCastText: casts[0]?.text,\n        },\n      };\n    } catch (error) {\n      logger.error('[FarcasterTimelineProvider] Error:', error);\n      return {\n        text: 'Unable to fetch Farcaster timeline.',\n        data: { available: false, error: error instanceof Error ? error.message : 'Unknown error' },\n      };\n    }\n  },\n};\n\n// Helper function to format time ago\nfunction getTimeAgo(date: Date): string {\n  const seconds = Math.floor((new Date().getTime() - date.getTime()) / 1000);\n\n  if (seconds < 60) return 'just now';\n  if (seconds < 3600) return `${Math.floor(seconds / 60)}m ago`;\n  if (seconds < 86400) return `${Math.floor(seconds / 3600)}h ago`;\n  return `${Math.floor(seconds / 86400)}d ago`;\n}\n"],"mappings":";;;;;AAAA;AAAA,EAME;AAAA,OACK;AAIA,IAAM,4BAAsC;AAAA,EACjD,MAAM;AAAA,EACN,aAAa;AAAA,EAEb,KAAK,OAAO,SAAwB,SAAiB,UAA0C;AAfjG;AAgBI,QAAI;AACF,YAAM,UAAU,QAAQ,WAAW,sBAAsB;AACzD,YAAM,cAAc,mCAAS,eAAe,QAAQ;AAEpD,UAAI,CAAC,aAAa;AAChB,eAAO;AAAA,UACL,MAAM;AAAA,UACN,MAAM,EAAE,WAAW,MAAM;AAAA,QAC3B;AAAA,MACF;AAGA,YAAM,QAAQ,MAAM,YAAY,SAAS;AAAA,QACvC,SAAS,QAAQ;AAAA,QACjB,OAAO;AAAA,MACT,CAAC;AAED,UAAI,CAAC,SAAS,MAAM,WAAW,GAAG;AAChC,eAAO;AAAA,UACL,MAAM;AAAA,UACN,MAAM;AAAA,YACJ,WAAW;AAAA,YACX,OAAO,CAAC;AAAA,YACR,OAAO;AAAA,UACT;AAAA,QACF;AAAA,MACF;AAGA,YAAM,iBAAiB,MACpB,IAAI,CAAC,MAAM,UAAU;AACpB,cAAM,UAAU,WAAW,IAAI,KAAK,KAAK,SAAS,CAAC;AACnD,eAAO,GAAG,QAAQ,CAAC,MAAM,KAAK,QAAQ,KAAK,OAAO,MAAM,KAAK,IAAI;AAAA,MACnE,CAAC,EACA,KAAK,IAAI;AAEZ,aAAO;AAAA,QACL,MAAM;AAAA,EAAqC,cAAc;AAAA,QACzD,MAAM;AAAA,UACJ,WAAW;AAAA,UACX,OAAO,MAAM,IAAI,CAAC,MAAG;AAxD/B,gBAAAA;AAwDmC;AAAA,cACvB,IAAI,EAAE;AAAA,cACN,UAAU,EAAE;AAAA,cACZ,MAAM,EAAE;AAAA,cACR,WAAW,EAAE;AAAA,cACb,WAAUA,MAAA,EAAE,aAAF,gBAAAA,IAAY;AAAA,YACxB;AAAA,WAAE;AAAA,UACF,OAAO,MAAM;AAAA,QACf;AAAA,QACA,QAAQ;AAAA,UACN,iBAAgB,iBAAM,CAAC,MAAP,mBAAU,aAAV,mBAAoB;AAAA,UACpC,iBAAgB,WAAM,CAAC,MAAP,mBAAU;AAAA,QAC5B;AAAA,MACF;AAAA,IACF,SAAS,OAAO;AACd,aAAO,MAAM,sCAAsC,KAAK;AACxD,aAAO;AAAA,QACL,MAAM;AAAA,QACN,MAAM,EAAE,WAAW,OAAO,OAAO,iBAAiB,QAAQ,MAAM,UAAU,gBAAgB;AAAA,MAC5F;AAAA,IACF;AAAA,EACF;AACF;AAGA,SAAS,WAAW,MAAoB;AACtC,QAAM,UAAU,KAAK,QAAO,oBAAI,KAAK,GAAE,QAAQ,IAAI,KAAK,QAAQ,KAAK,GAAI;AAEzE,MAAI,UAAU,GAAI,QAAO;AACzB,MAAI,UAAU,KAAM,QAAO,GAAG,KAAK,MAAM,UAAU,EAAE,CAAC;AACtD,MAAI,UAAU,MAAO,QAAO,GAAG,KAAK,MAAM,UAAU,IAAI,CAAC;AACzD,SAAO,GAAG,KAAK,MAAM,UAAU,KAAK,CAAC;AACvC;","names":["_a"]}

package/dist/chunk-IOTLJXKN.js

@@ -0,0 +1,72 @@
+import {
+  FARCASTER_SERVICE_NAME
+} from "./chunk-Y2URJ4EZ.js";
+
+// src/providers/profileProvider.ts
+import {
+  logger
+} from "@elizaos/core";
+var farcasterProfileProvider = {
+  name: "farcasterProfile",
+  description: "Provides information about the agent's Farcaster profile",
+  get: async (runtime, message, state) => {
+    try {
+      const service = runtime.getService(FARCASTER_SERVICE_NAME);
+      const managers = service == null ? void 0 : service.getActiveManagers();
+      if (!managers || managers.size === 0) {
+        return {
+          text: "Farcaster profile not available.",
+          data: { available: false }
+        };
+      }
+      const manager = managers.get(runtime.agentId);
+      if (!manager) {
+        return {
+          text: "Farcaster profile not available for this agent.",
+          data: { available: false }
+        };
+      }
+      const fid = parseInt(runtime.getSetting("FARCASTER_FID"), 10);
+      if (!fid || isNaN(fid)) {
+        return {
+          text: "Invalid Farcaster FID configured.",
+          data: { available: false, error: "Invalid FID" }
+        };
+      }
+      try {
+        const profile = await manager.client.getProfile(fid);
+        return {
+          text: `Your Farcaster profile: @${profile.username} (FID: ${profile.fid}). ${profile.name ? `Display name: ${profile.name}` : ""}`,
+          data: {
+            available: true,
+            fid: profile.fid,
+            username: profile.username,
+            name: profile.name,
+            pfp: profile.pfp
+          },
+          values: {
+            fid: profile.fid,
+            username: profile.username
+          }
+        };
+      } catch (error) {
+        logger.error("[FarcasterProfileProvider] Error fetching profile:", error);
+        return {
+          text: "Unable to fetch Farcaster profile at this time.",
+          data: { available: false, error: "Fetch failed" }
+        };
+      }
+    } catch (error) {
+      logger.error("[FarcasterProfileProvider] Error:", error);
+      return {
+        text: "Farcaster service is not available.",
+        data: { available: false }
+      };
+    }
+  }
+};
+
+export {
+  farcasterProfileProvider
+};
+//# sourceMappingURL=chunk-IOTLJXKN.js.map

package/dist/chunk-IOTLJXKN.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/providers/profileProvider.ts"],"sourcesContent":["import {\n  type Provider,\n  type IAgentRuntime,\n  type Memory,\n  type State,\n  type ProviderResult,\n  logger,\n} from '@elizaos/core';\nimport { FARCASTER_SERVICE_NAME } from '../common/constants';\nimport type { FarcasterService } from '../service';\n\nexport const farcasterProfileProvider: Provider = {\n  name: 'farcasterProfile',\n  description: \"Provides information about the agent's Farcaster profile\",\n\n  get: async (runtime: IAgentRuntime, message: Memory, state: State): Promise<ProviderResult> => {\n    try {\n      const service = runtime.getService(FARCASTER_SERVICE_NAME) as FarcasterService;\n      const managers = service?.getActiveManagers();\n\n      if (!managers || managers.size === 0) {\n        return {\n          text: 'Farcaster profile not available.',\n          data: { available: false },\n        };\n      }\n\n      const manager = managers.get(runtime.agentId);\n      if (!manager) {\n        return {\n          text: 'Farcaster profile not available for this agent.',\n          data: { available: false },\n        };\n      }\n\n      const fid = parseInt(runtime.getSetting('FARCASTER_FID') as string, 10);\n      if (!fid || isNaN(fid)) {\n        return {\n          text: 'Invalid Farcaster FID configured.',\n          data: { available: false, error: 'Invalid FID' },\n        };\n      }\n\n      try {\n        const profile = await manager.client.getProfile(fid);\n\n        return {\n          text: `Your Farcaster profile: @${profile.username} (FID: ${profile.fid}). ${profile.name ? `Display name: ${profile.name}` : ''}`,\n          data: {\n            available: true,\n            fid: profile.fid,\n            username: profile.username,\n            name: profile.name,\n            pfp: profile.pfp,\n          },\n          values: {\n            fid: profile.fid,\n            username: profile.username,\n          },\n        };\n      } catch (error) {\n        logger.error('[FarcasterProfileProvider] Error fetching profile:', error);\n        return {\n          text: 'Unable to fetch Farcaster profile at this time.',\n          data: { available: false, error: 'Fetch failed' },\n        };\n      }\n    } catch (error) {\n      logger.error('[FarcasterProfileProvider] Error:', error);\n      return {\n        text: 'Farcaster service is not available.',\n        data: { available: false },\n      };\n    }\n  },\n};\n"],"mappings":";;;;;AAAA;AAAA,EAME;AAAA,OACK;AAIA,IAAM,2BAAqC;AAAA,EAChD,MAAM;AAAA,EACN,aAAa;AAAA,EAEb,KAAK,OAAO,SAAwB,SAAiB,UAA0C;AAC7F,QAAI;AACF,YAAM,UAAU,QAAQ,WAAW,sBAAsB;AACzD,YAAM,WAAW,mCAAS;AAE1B,UAAI,CAAC,YAAY,SAAS,SAAS,GAAG;AACpC,eAAO;AAAA,UACL,MAAM;AAAA,UACN,MAAM,EAAE,WAAW,MAAM;AAAA,QAC3B;AAAA,MACF;AAEA,YAAM,UAAU,SAAS,IAAI,QAAQ,OAAO;AAC5C,UAAI,CAAC,SAAS;AACZ,eAAO;AAAA,UACL,MAAM;AAAA,UACN,MAAM,EAAE,WAAW,MAAM;AAAA,QAC3B;AAAA,MACF;AAEA,YAAM,MAAM,SAAS,QAAQ,WAAW,eAAe,GAAa,EAAE;AACtE,UAAI,CAAC,OAAO,MAAM,GAAG,GAAG;AACtB,eAAO;AAAA,UACL,MAAM;AAAA,UACN,MAAM,EAAE,WAAW,OAAO,OAAO,cAAc;AAAA,QACjD;AAAA,MACF;AAEA,UAAI;AACF,cAAM,UAAU,MAAM,QAAQ,OAAO,WAAW,GAAG;AAEnD,eAAO;AAAA,UACL,MAAM,4BAA4B,QAAQ,QAAQ,UAAU,QAAQ,GAAG,MAAM,QAAQ,OAAO,iBAAiB,QAAQ,IAAI,KAAK,EAAE;AAAA,UAChI,MAAM;AAAA,YACJ,WAAW;AAAA,YACX,KAAK,QAAQ;AAAA,YACb,UAAU,QAAQ;AAAA,YAClB,MAAM,QAAQ;AAAA,YACd,KAAK,QAAQ;AAAA,UACf;AAAA,UACA,QAAQ;AAAA,YACN,KAAK,QAAQ;AAAA,YACb,UAAU,QAAQ;AAAA,UACpB;AAAA,QACF;AAAA,MACF,SAAS,OAAO;AACd,eAAO,MAAM,sDAAsD,KAAK;AACxE,eAAO;AAAA,UACL,MAAM;AAAA,UACN,MAAM,EAAE,WAAW,OAAO,OAAO,eAAe;AAAA,QAClD;AAAA,MACF;AAAA,IACF,SAAS,OAAO;AACd,aAAO,MAAM,qCAAqC,KAAK;AACvD,aAAO;AAAA,QACL,MAAM;AAAA,QACN,MAAM,EAAE,WAAW,MAAM;AAAA,MAC3B;AAAA,IACF;AAAA,EACF;AACF;","names":[]}

package/dist/chunk-OAXQ6Z2Q.js

@@ -0,0 +1,105 @@
+import {
+  FARCASTER_SERVICE_NAME
+} from "./chunk-Y2URJ4EZ.js";
+
+// src/actions/sendCast.ts
+import {
+  logger,
+  createUniqueUuid
+} from "@elizaos/core";
+var sendCastAction = {
+  name: "SEND_CAST",
+  description: "Posts a cast (message) on Farcaster",
+  examples: [
+    [
+      {
+        name: "user",
+        content: { text: "Can you post about the new ElizaOS features on Farcaster?" }
+      },
+      {
+        name: "assistant",
+        content: {
+          text: "I'll post about the new ElizaOS features on Farcaster now.",
+          actions: ["SEND_CAST"]
+        }
+      }
+    ],
+    [
+      {
+        name: "user",
+        content: { text: "Share on Farcaster that we just launched version 2.0!" }
+      },
+      {
+        name: "assistant",
+        content: {
+          text: "I'll share the version 2.0 launch announcement on Farcaster.",
+          actions: ["SEND_CAST"]
+        }
+      }
+    ]
+  ],
+  validate: async (runtime, message) => {
+    var _a;
+    const text = ((_a = message.content.text) == null ? void 0 : _a.toLowerCase()) || "";
+    const keywords = ["post", "cast", "share", "announce", "farcaster", "tweet"];
+    const hasKeyword = keywords.some((keyword) => text.includes(keyword));
+    const service = runtime.getService(FARCASTER_SERVICE_NAME);
+    const isServiceAvailable = !!(service == null ? void 0 : service.getCastService(runtime.agentId));
+    return hasKeyword && isServiceAvailable;
+  },
+  handler: async (runtime, message, state) => {
+    var _a;
+    try {
+      const service = runtime.getService(FARCASTER_SERVICE_NAME);
+      const postService = service == null ? void 0 : service.getCastService(runtime.agentId);
+      if (!postService) {
+        logger.error("[SEND_CAST] PostService not available");
+        return false;
+      }
+      let castContent = "";
+      if (state == null ? void 0 : state.castContent) {
+        castContent = state.castContent;
+      } else {
+        const prompt = `Based on this request: "${message.content.text}", generate a concise Farcaster cast (max 320 characters). Be engaging and use appropriate hashtags if relevant.`;
+        const response = await runtime.useModel("text_large", { prompt });
+        castContent = typeof response === "string" ? response : response.text || "";
+      }
+      if (castContent.length > 320) {
+        castContent = castContent.substring(0, 317) + "...";
+      }
+      const cast = await postService.createCast({
+        agentId: runtime.agentId,
+        roomId: createUniqueUuid(runtime, "farcaster-timeline"),
+        text: castContent
+      });
+      logger.info(`[SEND_CAST] Successfully posted cast: ${cast.id}`);
+      await runtime.createMemory(
+        {
+          agentId: runtime.agentId,
+          roomId: cast.roomId,
+          // userId removed - not part of Memory type
+          entityId: runtime.agentId,
+          content: {
+            text: castContent,
+            source: "farcaster",
+            metadata: {
+              castHash: (_a = cast.metadata) == null ? void 0 : _a.castHash,
+              action: "SEND_CAST"
+            }
+          },
+          createdAt: cast.timestamp
+        },
+        "messages"
+      );
+      return true;
+    } catch (error) {
+      logger.error("[SEND_CAST] Error posting cast:", error);
+      throw error;
+    }
+  }
+};
+
+export {
+  sendCastAction
+};
+//# sourceMappingURL=chunk-OAXQ6Z2Q.js.map

package/dist/chunk-OAXQ6Z2Q.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/actions/sendCast.ts"],"sourcesContent":["import {\n  type Action,\n  type IAgentRuntime,\n  type Memory,\n  type State,\n  logger,\n  createUniqueUuid,\n} from '@elizaos/core';\nimport { FARCASTER_SERVICE_NAME } from '../common/constants';\nimport type { FarcasterService } from '../service';\n\nexport const sendCastAction: Action = {\n  name: 'SEND_CAST',\n  description: 'Posts a cast (message) on Farcaster',\n  examples: [\n    [\n      {\n        name: 'user',\n        content: { text: 'Can you post about the new ElizaOS features on Farcaster?' },\n      },\n      {\n        name: 'assistant',\n        content: {\n          text: \"I'll post about the new ElizaOS features on Farcaster now.\",\n          actions: ['SEND_CAST'],\n        },\n      },\n    ],\n    [\n      {\n        name: 'user',\n        content: { text: 'Share on Farcaster that we just launched version 2.0!' },\n      },\n      {\n        name: 'assistant',\n        content: {\n          text: \"I'll share the version 2.0 launch announcement on Farcaster.\",\n          actions: ['SEND_CAST'],\n        },\n      },\n    ],\n  ],\n\n  validate: async (runtime: IAgentRuntime, message: Memory): Promise<boolean> => {\n    const text = message.content.text?.toLowerCase() || '';\n    const keywords = ['post', 'cast', 'share', 'announce', 'farcaster', 'tweet'];\n\n    // Check if the message contains relevant keywords\n    const hasKeyword = keywords.some((keyword) => text.includes(keyword));\n\n    // Check if Farcaster service is available\n    const service = runtime.getService(FARCASTER_SERVICE_NAME) as FarcasterService;\n          const isServiceAvailable = !!service?.getCastService(runtime.agentId);\n\n    return hasKeyword && isServiceAvailable;\n  },\n\n  handler: async (runtime: IAgentRuntime, message: Memory, state?: State): Promise<boolean> => {\n    try {\n      const service = runtime.getService(FARCASTER_SERVICE_NAME) as FarcasterService;\n      const postService = service?.getCastService(runtime.agentId);\n\n      if (!postService) {\n        logger.error('[SEND_CAST] PostService not available');\n        return false;\n      }\n\n      // Extract the content to post from the message or generate it\n      let castContent = '';\n\n      if (state?.castContent) {\n        // Use provided cast content from state\n        castContent = state.castContent as string;\n      } else {\n        // Generate content based on the conversation context\n        const prompt = `Based on this request: \"${message.content.text}\", generate a concise Farcaster cast (max 320 characters). Be engaging and use appropriate hashtags if relevant.`;\n\n        const response = await runtime.useModel('text_large', { prompt });\n        castContent = typeof response === 'string' ? response : response.text || '';\n      }\n\n      // Ensure content fits Farcaster's character limit\n      if (castContent.length > 320) {\n        castContent = castContent.substring(0, 317) + '...';\n      }\n\n      // Create the cast\n      const cast = await postService.createCast({\n        agentId: runtime.agentId,\n        roomId: createUniqueUuid(runtime, 'farcaster-timeline'),\n        text: castContent,\n      });\n\n      logger.info(`[SEND_CAST] Successfully posted cast: ${cast.id}`);\n\n      // Store the cast in memory\n      await runtime.createMemory(\n        {\n          agentId: runtime.agentId,\n          roomId: cast.roomId,\n          // userId removed - not part of Memory type\n          entityId: runtime.agentId,\n          content: {\n            text: castContent,\n            source: 'farcaster',\n            metadata: {\n              castHash: cast.metadata?.castHash,\n              action: 'SEND_CAST',\n            },\n          },\n          createdAt: cast.timestamp,\n        },\n        'messages'\n      );\n\n      return true;\n    } catch (error) {\n      logger.error('[SEND_CAST] Error posting cast:', error);\n      // Re-throw the error so it's visible in the agent's logs\n      throw error;\n    }\n  },\n};\n"],"mappings":";;;;;AAAA;AAAA,EAKE;AAAA,EACA;AAAA,OACK;AAIA,IAAM,iBAAyB;AAAA,EACpC,MAAM;AAAA,EACN,aAAa;AAAA,EACb,UAAU;AAAA,IACR;AAAA,MACE;AAAA,QACE,MAAM;AAAA,QACN,SAAS,EAAE,MAAM,4DAA4D;AAAA,MAC/E;AAAA,MACA;AAAA,QACE,MAAM;AAAA,QACN,SAAS;AAAA,UACP,MAAM;AAAA,UACN,SAAS,CAAC,WAAW;AAAA,QACvB;AAAA,MACF;AAAA,IACF;AAAA,IACA;AAAA,MACE;AAAA,QACE,MAAM;AAAA,QACN,SAAS,EAAE,MAAM,wDAAwD;AAAA,MAC3E;AAAA,MACA;AAAA,QACE,MAAM;AAAA,QACN,SAAS;AAAA,UACP,MAAM;AAAA,UACN,SAAS,CAAC,WAAW;AAAA,QACvB;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAAA,EAEA,UAAU,OAAO,SAAwB,YAAsC;AA3CjF;AA4CI,UAAM,SAAO,aAAQ,QAAQ,SAAhB,mBAAsB,kBAAiB;AACpD,UAAM,WAAW,CAAC,QAAQ,QAAQ,SAAS,YAAY,aAAa,OAAO;AAG3E,UAAM,aAAa,SAAS,KAAK,CAAC,YAAY,KAAK,SAAS,OAAO,CAAC;AAGpE,UAAM,UAAU,QAAQ,WAAW,sBAAsB;AACnD,UAAM,qBAAqB,CAAC,EAAC,mCAAS,eAAe,QAAQ;AAEnE,WAAO,cAAc;AAAA,EACvB;AAAA,EAEA,SAAS,OAAO,SAAwB,SAAiB,UAAoC;AAzD/F;AA0DI,QAAI;AACF,YAAM,UAAU,QAAQ,WAAW,sBAAsB;AACzD,YAAM,cAAc,mCAAS,eAAe,QAAQ;AAEpD,UAAI,CAAC,aAAa;AAChB,eAAO,MAAM,uCAAuC;AACpD,eAAO;AAAA,MACT;AAGA,UAAI,cAAc;AAElB,UAAI,+BAAO,aAAa;AAEtB,sBAAc,MAAM;AAAA,MACtB,OAAO;AAEL,cAAM,SAAS,2BAA2B,QAAQ,QAAQ,IAAI;AAE9D,cAAM,WAAW,MAAM,QAAQ,SAAS,cAAc,EAAE,OAAO,CAAC;AAChE,sBAAc,OAAO,aAAa,WAAW,WAAW,SAAS,QAAQ;AAAA,MAC3E;AAGA,UAAI,YAAY,SAAS,KAAK;AAC5B,sBAAc,YAAY,UAAU,GAAG,GAAG,IAAI;AAAA,MAChD;AAGA,YAAM,OAAO,MAAM,YAAY,WAAW;AAAA,QACxC,SAAS,QAAQ;AAAA,QACjB,QAAQ,iBAAiB,SAAS,oBAAoB;AAAA,QACtD,MAAM;AAAA,MACR,CAAC;AAED,aAAO,KAAK,yCAAyC,KAAK,EAAE,EAAE;AAG9D,YAAM,QAAQ;AAAA,QACZ;AAAA,UACE,SAAS,QAAQ;AAAA,UACjB,QAAQ,KAAK;AAAA;AAAA,UAEb,UAAU,QAAQ;AAAA,UAClB,SAAS;AAAA,YACP,MAAM;AAAA,YACN,QAAQ;AAAA,YACR,UAAU;AAAA,cACR,WAAU,UAAK,aAAL,mBAAe;AAAA,cACzB,QAAQ;AAAA,YACV;AAAA,UACF;AAAA,UACA,WAAW,KAAK;AAAA,QAClB;AAAA,QACA;AAAA,MACF;AAEA,aAAO;AAAA,IACT,SAAS,OAAO;AACd,aAAO,MAAM,mCAAmC,KAAK;AAErD,YAAM;AAAA,IACR;AAAA,EACF;AACF;","names":[]}

package/dist/chunk-Y2URJ4EZ.js

@@ -0,0 +1,21 @@
+// src/common/constants.ts
+var FARCASTER_SERVICE_NAME = "farcaster";
+var FARCASTER_SOURCE = "farcaster";
+var DEFAULT_MAX_CAST_LENGTH = 320;
+var DEFAULT_POLL_INTERVAL = 120;
+var DEFAULT_CAST_INTERVAL_MIN = 90;
+var DEFAULT_CAST_INTERVAL_MAX = 180;
+var DEFAULT_CAST_CACHE_TTL = 1e3 * 30 * 60;
+var DEFAULT_CAST_CACHE_SIZE = 9e3;
+
+export {
+  FARCASTER_SERVICE_NAME,
+  FARCASTER_SOURCE,
+  DEFAULT_MAX_CAST_LENGTH,
+  DEFAULT_POLL_INTERVAL,
+  DEFAULT_CAST_INTERVAL_MIN,
+  DEFAULT_CAST_INTERVAL_MAX,
+  DEFAULT_CAST_CACHE_TTL,
+  DEFAULT_CAST_CACHE_SIZE
+};
+//# sourceMappingURL=chunk-Y2URJ4EZ.js.map

package/dist/chunk-Y2URJ4EZ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/common/constants.ts"],"sourcesContent":["export const FARCASTER_SERVICE_NAME = 'farcaster';\nexport const FARCASTER_SOURCE = 'farcaster';\nexport const DEFAULT_MAX_CAST_LENGTH = 320;\nexport const DEFAULT_POLL_INTERVAL = 120; // 2 minutes\nexport const DEFAULT_CAST_INTERVAL_MIN = 90; // 1.5 hours\nexport const DEFAULT_CAST_INTERVAL_MAX = 180; // 3 hours\nexport const DEFAULT_CAST_CACHE_TTL = 1000 * 30 * 60; // 30 minutes\nexport const DEFAULT_CAST_CACHE_SIZE = 9000;\n"],"mappings":";AAAO,IAAM,yBAAyB;AAC/B,IAAM,mBAAmB;AACzB,IAAM,0BAA0B;AAChC,IAAM,wBAAwB;AAC9B,IAAM,4BAA4B;AAClC,IAAM,4BAA4B;AAClC,IAAM,yBAAyB,MAAO,KAAK;AAC3C,IAAM,0BAA0B;","names":[]}