@elizaos/plugin-farcaster 1.0.2 → 1.7.0

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,75 @@ 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
+FARCASTER_MODE=polling  # or 'webhook' for real-time processing
+```
+
+### 3. Webhook Setup (Recommended for Production)
+
+For real-time interaction processing instead of polling, you can configure webhooks:
+
+#### Step 1: Set Environment Variable
+```env
+FARCASTER_MODE=webhook
+```
+
+#### Step 2: Expose Your Server
+If running locally, use ngrok to expose your server:
+```bash
+# Install ngrok if you haven't already
+npm install -g ngrok
+
+# Expose your local server (default port 3000)
+ngrok http 3000
+```
+
+This will give you a URL like: `https://c7120f641530.ngrok-free.app`
+
+#### Step 3: Configure Neynar Webhook
+1. Go to [Neynar Webhook Dashboard](https://dev.neynar.com/webhook)
+2. Click "New webhook"
+3. Set the **Target URL** to: `https://your-ngrok-url.ngrok-free.app/farcaster/webhook`
+   - Example: `https://c7120f641530.ngrok-free.app/farcaster/webhook`
+4. Configure **Event Types**:
+   - Select `cast.created`
+5. Set **Filters**:
+   - **Mentioned users**: Add your Farcaster username
+   - **Parent cast authors**: Add your Farcaster username
+
+
+#### Step 4: Test Webhook
+Once configured, your agent will receive real-time notifications when:
+- Someone mentions your agent
+- Someone replies to your agent's casts
+
 ## Configuration
 
 The plugin requires the following configurations, which can be set via environment variables or ElizaOS runtime settings:
@@ -37,8 +121,9 @@ 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)        |
+| `FARCASTER_MODE`               | Interaction mode: `polling` or `webhook` |
 
 ### Optional Settings
 
@@ -47,33 +132,67 @@ 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",
+    "FARCASTER_MODE": "webhook"
+  }
+}
+```
 
-```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
+```
+
+### Using Actions
+
+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]
+```
 
-// Register the Farcaster plugin
-elizaOs.registerPlugin(farcasterPlugin);
+### Programmatic Usage
 
-// Start ElizaOS
-elizaOs.start();
+```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 +242,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/__tests__/e2e/scenarios.d.ts

@@ -0,0 +1,4 @@
+import { type TestCase } from '@elizaos/core';
+export declare const farcasterE2EScenarios: TestCase[];
+export default farcasterE2EScenarios;
+//# sourceMappingURL=scenarios.d.ts.map

package/dist/__tests__/e2e/scenarios.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenarios.d.ts","sourceRoot":"","sources":["../../../src/__tests__/e2e/scenarios.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgD,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AAM5F,eAAO,MAAM,qBAAqB,EAAE,QAAQ,EAmV3C,CAAC;AAGF,eAAe,qBAAqB,CAAC"}

package/dist/__tests__/suite.d.ts

@@ -0,0 +1,117 @@
+import { type IAgentRuntime, type TestSuite, type TestCase } from '@elizaos/core';
+/**
+ * Represents a Test Suite for Farcaster functionality.
+ * This class implements the TestSuite interface.
+ * It contains various test cases related to Farcaster operations such as initializing the client,
+ * fetching profile, fetching casts, posting casts, and handling cast interactions.
+ */
+export declare class FarcasterTestSuite implements TestSuite {
+    name: string;
+    description: string;
+    private manager;
+    tests: TestCase[];
+    /**
+     * Constructor for TestSuite class.
+     * Initializes an array of test functions to be executed.
+     */
+    constructor();
+    /**
+     * Test that checks if Farcaster is properly configured
+     */
+    testMockConfiguration(runtime: IAgentRuntime): Promise<void>;
+    /**
+     * Test service initialization without real credentials
+     */
+    testMockServiceInit(runtime: IAgentRuntime): Promise<void>;
+    /**
+     * Asynchronously initializes the Farcaster client for the provided agent runtime.
+     *
+     * @param {IAgentRuntime} runtime - The agent runtime to use for initializing the Farcaster client.
+     * @throws {Error} If the Farcaster client manager is not found or if the Farcaster client fails to initialize.
+     */
+    testInitializingClient(runtime: IAgentRuntime): Promise<void>;
+    /**
+     * Asynchronously fetches the profile of a user from Farcaster using the given runtime.
+     *
+     * @param {IAgentRuntime} runtime The runtime to use for fetching the profile.
+     * @returns {Promise<void>} A Promise that resolves when the profile is successfully fetched, or rejects with an error.
+     */
+    testFetchProfile(runtime: IAgentRuntime): Promise<void>;
+    /**
+     * Asynchronously fetches the timeline from the Farcaster client.
+     *
+     * @param {IAgentRuntime} runtime - The agent runtime object.
+     * @throws {Error} If there are no casts in the timeline.
+     * @throws {Error} If an error occurs while fetching the timeline.
+     */
+    testFetchTimeline(runtime: IAgentRuntime): Promise<void>;
+    /**
+     * Asynchronously posts a test cast using the Farcaster API.
+     *
+     * @param {IAgentRuntime} runtime - The agent runtime object.
+     * @returns {Promise<void>} A Promise that resolves when the cast is successfully posted.
+     * @throws {Error} If there is an error posting the cast.
+     */
+    testPostCast(runtime: IAgentRuntime): Promise<void>;
+    /**
+     * Asynchronously posts an image cast on Farcaster using the provided runtime and cast content.
+     * Note: This might need updating based on how images are actually handled in sendCast
+     *
+     * @param {IAgentRuntime} runtime - The runtime environment for the action.
+     * @returns {Promise<void>} A Promise that resolves when the cast is successfully posted.
+     * @throws {Error} If there is an error posting the cast.
+     */
+    testPostImageCast(runtime: IAgentRuntime): Promise<void>;
+    /**
+     * Asynchronously handles a fake cast response using the given runtime.
+     *
+     * @param {IAgentRuntime} runtime - The runtime object for the agent
+     * @returns {Promise<void>} - A promise that resolves when the cast response is handled
+     * @throws {Error} - If there is an error handling the cast response
+     */
+    testHandleCastResponse(runtime: IAgentRuntime): Promise<void>;
+    /**
+     * Generates random content for a cast based on the given context.
+     *
+     * @param {IAgentRuntime} runtime - The runtime environment.
+     * @param {string} context - Optional context for the content generation.
+     * @returns {Promise<string>} A promise that resolves to the generated cast content.
+     */
+    private generateRandomCastContent;
+    /**
+     * Tests the MessageService functionality
+     *
+     * @param {IAgentRuntime} runtime - The runtime environment.
+     * @returns {Promise<void>} A promise that resolves when the test is complete.
+     */
+    testMessageService(runtime: IAgentRuntime): Promise<void>;
+    /**
+     * Tests the PostService functionality
+     *
+     * @param {IAgentRuntime} runtime - The runtime environment.
+     * @returns {Promise<void>} A promise that resolves when the test is complete.
+     */
+    testPostService(runtime: IAgentRuntime): Promise<void>;
+    /**
+     * Tests real account posting functionality
+     *
+     * @param {IAgentRuntime} runtime - The runtime environment.
+     * @returns {Promise<void>} A promise that resolves when the test is complete.
+     */
+    testRealAccountPosting(runtime: IAgentRuntime): Promise<void>;
+    /**
+     * Tests real account interactions (mentions, replies, etc)
+     *
+     * @param {IAgentRuntime} runtime - The runtime environment.
+     * @returns {Promise<void>} A promise that resolves when the test is complete.
+     */
+    testRealAccountInteractions(runtime: IAgentRuntime): Promise<void>;
+    /**
+     * Tests message metadata tracking functionality
+     *
+     * @param {IAgentRuntime} runtime - The runtime environment.
+     * @returns {Promise<void>} A promise that resolves when the test is complete.
+     */
+    testMessageMetadataTracking(runtime: IAgentRuntime): Promise<void>;
+}
+//# sourceMappingURL=suite.d.ts.map

package/dist/__tests__/suite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suite.d.ts","sourceRoot":"","sources":["../../src/__tests__/suite.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,aAAa,EAElB,KAAK,SAAS,EAGd,KAAK,QAAQ,EACd,MAAM,eAAe,CAAC;AAOvB;;;;;GAKG;AACH,qBAAa,kBAAmB,YAAW,SAAS;IAClD,IAAI,SAA4B;IAChC,WAAW,SAAmD;IAC9D,OAAO,CAAC,OAAO,CAAsC;IACrD,KAAK,EAAE,QAAQ,EAAE,CAAC;IAElB;;;OAGG;;IAwCH;;OAEG;IACG,qBAAqB,CAAC,OAAO,EAAE,aAAa;IAqBlD;;OAEG;IACG,mBAAmB,CAAC,OAAO,EAAE,aAAa;IA+BhD;;;;;OAKG;IACG,sBAAsB,CAAC,OAAO,EAAE,aAAa;IAmBnD;;;;;OAKG;IACG,gBAAgB,CAAC,OAAO,EAAE,aAAa;IAqB7C;;;;;;OAMG;IACG,iBAAiB,CAAC,OAAO,EAAE,aAAa;IAuB9C;;;;;;OAMG;IACG,YAAY,CAAC,OAAO,EAAE,aAAa;IAoBzC;;;;;;;OAOG;IACG,iBAAiB,CAAC,OAAO,EAAE,aAAa;IAwB9C;;;;;;OAMG;IACG,sBAAsB,CAAC,OAAO,EAAE,aAAa;IA+CnD;;;;;;OAMG;YACW,yBAAyB;IAcvC;;;;;OAKG;IACG,kBAAkB,CAAC,OAAO,EAAE,aAAa;IAuC/C;;;;;OAKG;IACG,eAAe,CAAC,OAAO,EAAE,aAAa;IAsC5C;;;;;OAKG;IACG,sBAAsB,CAAC,OAAO,EAAE,aAAa;IA0CnD;;;;;OAKG;IACG,2BAA2B,CAAC,OAAO,EAAE,aAAa;IAoDxD;;;;;OAKG;IACG,2BAA2B,CAAC,OAAO,EAAE,aAAa;CA4CzD"}

package/dist/__tests__/test-utils.d.ts

@@ -0,0 +1,29 @@
+import type { FarcasterClient } from '../client';
+import type { Cast, Profile } from '../common/types';
+import type { TestInteraction } from './types';
+export declare function createTestInteraction(cast: Cast, profile: Profile): TestInteraction | null;
+export declare function handleTestInteraction(client: FarcasterClient, interaction: TestInteraction): Promise<{
+    success: boolean;
+    cast: {
+        hash: string;
+        text: string;
+        parent_hash: string;
+        timestamp: string;
+    };
+}>;
+export declare function createTestCast(client: FarcasterClient, content: string): Promise<{
+    success: boolean;
+    cast: NeynarCast;
+}>;
+export declare const TEST_IMAGE_URL = "https://github.com/elizaOS/awesome-eliza/blob/main/assets/eliza-logo.jpg?raw=true";
+export declare const TEST_IMAGE: {
+    id: string;
+    text: string;
+    description: string;
+    source: string;
+    url: string;
+    title: string;
+    contentType: string;
+    alt_text: string;
+};
+//# sourceMappingURL=test-utils.d.ts.map

package/dist/__tests__/test-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-utils.d.ts","sourceRoot":"","sources":["../../src/__tests__/test-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,GAAG,eAAe,GAAG,IAAI,CA+B1F;AAED,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,eAAe,EAAE,WAAW,EAAE,eAAe;;;;;;;;GAuBhG;AAED,wBAAsB,cAAc,CAAC,MAAM,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM;;;GAc5E;AAED,eAAO,MAAM,cAAc,sFAC0D,CAAC;AAEtF,eAAO,MAAM,UAAU;;;;;;;;;CAStB,CAAC"}

package/dist/__tests__/types.d.ts

@@ -0,0 +1,88 @@
+export interface TestInteraction {
+    type: 'RECAST' | 'REPLY' | 'LIKE';
+    castId?: string;
+    content?: string;
+}
+export interface TestCast {
+    hash: string;
+    text: string;
+    username: string;
+    fid: string;
+    timestamp: number;
+    threadHash: string;
+    permanentUrl: string;
+    photos: any[];
+    hashtags: string[];
+    mentions: string[];
+    thread: any[];
+    urls: string[];
+    videos: any[];
+}
+export interface TestImage {
+    id: string;
+    text: string;
+    description: string;
+    source: string;
+    url: string;
+    title: string;
+    contentType: string;
+    alt_text: string;
+}
+export declare enum ServiceType {
+    FARCASTER = "farcaster"
+}
+export interface CastId {
+    hash: string;
+    fid: string;
+}
+export interface CastStats {
+    recasts: number;
+    replies: number;
+    likes: number;
+}
+export interface Profile {
+    fid: string;
+    username: string;
+    name: string;
+    pfp: string;
+}
+export interface Cast {
+    hash: string;
+    authorFid: string;
+    text: string;
+    timestamp: Date;
+    profile: Profile;
+    stats: CastStats;
+}
+export interface FarcasterClient {
+    client: {
+        fetchProfile: (username: string) => Promise<Profile>;
+        fetchUserCasts: (fid: string, limit: number) => Promise<Cast[]>;
+        fetchFeed: (limit: number) => Promise<Cast[]>;
+        fetchOwnCasts: (limit: number) => Promise<Cast[]>;
+    };
+    post: {
+        postCast: (runtime: any, client: any, text: string, roomId: string, content: string, username: string, media?: any[]) => Promise<void>;
+        generateNewCast: () => Promise<void>;
+    };
+    interaction: {
+        handleCast: (params: {
+            cast: Cast;
+            message: any;
+            thread: any[];
+        }) => Promise<void>;
+    };
+    publishCast: (text: string, parent?: CastId) => Promise<{
+        success: boolean;
+        cast: {
+            hash: string;
+            author: {
+                fid: string;
+            };
+            text: string;
+            timestamp: string;
+            parent_hash?: string;
+        };
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/__tests__/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/__tests__/types.ts"],"names":[],"mappings":"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"}

package/dist/actions/index.d.ts

@@ -0,0 +1,4 @@
+export { sendCastAction } from './sendCast';
+export { replyCastAction } from './replyCast';
+export declare const farcasterActions: any[];
+//# sourceMappingURL=index.d.ts.map

package/dist/actions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/actions/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAM9C,eAAO,MAAM,gBAAgB,OAAoC,CAAC"}

package/dist/actions/replyCast.d.ts

@@ -0,0 +1,3 @@
+import { type Action } from '@elizaos/core';
+export declare const replyCastAction: Action;
+//# sourceMappingURL=replyCast.d.ts.map

package/dist/actions/replyCast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replyCast.d.ts","sourceRoot":"","sources":["../../src/actions/replyCast.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,MAAM,EAKZ,MAAM,eAAe,CAAC;AAKvB,eAAO,MAAM,eAAe,EAAE,MA0G7B,CAAC"}

package/dist/actions/sendCast.d.ts

@@ -0,0 +1,3 @@
+import { type Action } from '@elizaos/core';
+export declare const sendCastAction: Action;
+//# sourceMappingURL=sendCast.d.ts.map

package/dist/actions/sendCast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sendCast.d.ts","sourceRoot":"","sources":["../../src/actions/sendCast.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,MAAM,EAMZ,MAAM,eAAe,CAAC;AAIvB,eAAO,MAAM,cAAc,EAAE,MA4G5B,CAAC"}

package/dist/client.d.ts

@@ -0,0 +1,26 @@
+import { Content } from '@elizaos/core';
+import { type NeynarAPIClient } from '@neynar/nodejs-sdk';
+import { Cast as NeynarCast } from '@neynar/nodejs-sdk/build/api';
+import type { Cast, CastId, FidRequest, Profile } from './common/types';
+export declare class FarcasterClient {
+    private neynar;
+    private signerUuid;
+    constructor(opts: {
+        neynar: NeynarAPIClient;
+        signerUuid: string;
+    });
+    sendCast({ content, inReplyTo, }: {
+        content: Content;
+        inReplyTo?: CastId;
+    }): Promise<NeynarCast[]>;
+    private publishCast;
+    getCast(castHash: string): Promise<NeynarCast>;
+    getMentions(request: FidRequest): Promise<NeynarCast[]>;
+    getProfile(fid: number): Promise<Profile>;
+    getTimeline(request: FidRequest): Promise<{
+        timeline: Cast[];
+        cursor?: string;
+    }>;
+    clearCache(): void;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAe,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,KAAK,eAAe,EAAsB,MAAM,oBAAoB,CAAC;AAC9E,OAAO,EAAE,IAAI,IAAI,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAIlE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAexE,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,UAAU,CAAS;gBACf,IAAI,EAAE;QAAE,MAAM,EAAE,eAAe,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE;IAK3D,QAAQ,CAAC,EACb,OAAO,EACP,SAAS,GACV,EAAE;QACD,OAAO,EAAE,OAAO,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;YAgBX,WAAW;IAsBnB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAY9C,WAAW,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAkBvD,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAkCzC,WAAW,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC;QAC9C,QAAQ,EAAE,IAAI,EAAE,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IAqBF,UAAU,IAAI,IAAI;CAInB"}

package/dist/common/asyncqueue.d.ts

@@ -0,0 +1,13 @@
+export declare class AsyncQueue {
+    private queue;
+    private running;
+    private emptyListeners;
+    private maxConcurrent;
+    constructor(maxConcurrent?: number);
+    submit<T>(work: () => Promise<T>): Promise<T>;
+    private doNextWork;
+    size(): Promise<number>;
+    waitUntilFinished(): Promise<void>;
+    private checkIfEmptyAndNotify;
+}
+//# sourceMappingURL=asyncqueue.d.ts.map

package/dist/common/asyncqueue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asyncqueue.d.ts","sourceRoot":"","sources":["../../src/common/asyncqueue.ts"],"names":[],"mappings":"AAAA,qBAAa,UAAU;IACrB,OAAO,CAAC,KAAK,CAA+B;IAC5C,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,cAAc,CAAsB;IAC5C,OAAO,CAAC,aAAa,CAAS;gBAElB,aAAa,GAAE,MAAU;IAI/B,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;YAarC,UAAU;IAsBlB,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAIvB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAUxC,OAAO,CAAC,qBAAqB;CAQ9B"}

package/dist/common/callbacks.d.ts

@@ -0,0 +1,14 @@
+import { HandlerCallback, IAgentRuntime, Memory, UUID } from '@elizaos/core';
+import { Cast as NeynarCast } from '@neynar/nodejs-sdk/build/api';
+import { FarcasterClient } from '../client';
+import { CastId, FarcasterConfig } from './types';
+export declare function standardCastHandlerCallback({ client, runtime, config, roomId, onCompletion, onError, inReplyTo, }: {
+    inReplyTo?: CastId;
+    client: FarcasterClient;
+    runtime: IAgentRuntime;
+    config: FarcasterConfig;
+    roomId: UUID;
+    onCompletion?: (casts: NeynarCast[], memories: Memory[]) => Promise<void>;
+    onError?: (error: unknown) => Promise<void>;
+}): HandlerCallback;
+//# sourceMappingURL=callbacks.d.ts.map