@elizaos/plugin-farcaster 1.0.5 → 1.7.2

package/README.md

@@ -71,8 +71,47 @@ Edit `.env` with your credentials:
 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:
@@ -84,6 +123,7 @@ The plugin requires the following configurations, which can be set via environme
 | `FARCASTER_NEYNAR_API_KEY`     | Neynar API key for accessing Farcaster |
 | `FARCASTER_SIGNER_UUID` | Signer UUID for your Farcaster account |
 | `FARCASTER_FID`                | Your Farcaster FID (identifier)        |
+| `FARCASTER_MODE`               | Interaction mode: `polling` or `webhook` |
 
 ### Optional Settings
 
@@ -115,7 +155,8 @@ The plugin requires the following configurations, which can be set via environme
   "settings": {
     "FARCASTER_FID": "123456",
     "FARCASTER_NEYNAR_API_KEY": "your-api-key",
-    "FARCASTER_SIGNER_UUID": "your-signer-uuid"
+    "FARCASTER_SIGNER_UUID": "your-signer-uuid",
+    "FARCASTER_MODE": "webhook"
   }
 }
 ```

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,EAAwC,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AAOpF,eAAO,MAAM,qBAAqB,EAAE,QAAQ,EAsV3C,CAAC;AAGF,eAAe,qBAAqB,CAAC"}

package/dist/__tests__/suite.d.ts

@@ -0,0 +1,130 @@
+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();
+    /**
+     * A wrapper for test cases that dynamically runs either a real or mock test
+     * based on the presence of Farcaster credentials in the agent's runtime settings.
+     *
+     * @param realTest - The test case to run if credentials are provided.
+     * @param mockTest - An optional mock test case to run as a fallback.
+     * @returns A TestCase that handles the conditional logic.
+     */
+    private credentialedOrMockTest;
+    /**
+     * Test that checks and logs the Farcaster configuration for the current agent.
+     */
+    testConfiguration(runtime: IAgentRuntime): Promise<void>;
+    /**
+     * 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,EAEd,KAAK,QAAQ,EACd,MAAM,eAAe,CAAC;AAQvB;;;;;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;;IA6BH;;;;;;;OAOG;IACH,OAAO,CAAC,sBAAsB;IAyB9B;;OAEG;IACG,iBAAiB,CAAC,OAAO,EAAE,aAAa;IAsB9C;;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,EAKZ,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

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

@@ -0,0 +1 @@
+{"version":3,"file":"callbacks.d.ts","sourceRoot":"","sources":["../../src/common/callbacks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,eAAe,EAAE,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACtF,OAAO,EAAE,IAAI,IAAI,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAGlD,wBAAgB,2BAA2B,CAAC,EAC1C,MAAM,EACN,OAAO,EACP,MAAM,EACN,MAAM,EACN,YAAY,EACZ,OAAO,EACP,SAAS,GACV,EAAE;IACD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,eAAe,CAAC;IACxB,OAAO,EAAE,aAAa,CAAC;IACvB,MAAM,EAAE,eAAe,CAAC;IACxB,MAAM,EAAE,IAAI,CAAC;IACb,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1E,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7C,GAAG,eAAe,CAqDlB"}

package/dist/common/config.d.ts

@@ -0,0 +1,24 @@
+import { type IAgentRuntime } from '@elizaos/core';
+import { FarcasterConfig } from './types';
+/**
+ * Gets the Farcaster FID from runtime settings.
+ * Uses getSetting which already prioritizes: character.secrets -> character.settings -> env vars
+ */
+export declare function getFarcasterFid(runtime: IAgentRuntime): number | null;
+/**
+ * Checks if Farcaster is properly configured for this runtime.
+ * getSetting already handles priority: character.secrets -> character.settings -> env vars
+ */
+export declare function hasFarcasterEnabled(runtime: IAgentRuntime): boolean;
+/**
+ * Constructs and validates a Farcaster configuration object using runtime settings and environment variables.
+ *
+ * Retrieves configuration values for the Farcaster client, applying defaults where necessary, and validates them against the {@link FarcasterConfigSchema}. Throws a detailed error if validation fails.
+ *
+ * @param runtime - The runtime environment providing configuration settings.
+ * @returns The validated {@link FarcasterConfig} object.
+ *
+ * @throws {Error} If configuration validation fails, with details about each invalid field.
+ */
+export declare function validateFarcasterConfig(runtime: IAgentRuntime): FarcasterConfig;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/common/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC;AAQzE,OAAO,EAAE,eAAe,EAAyB,MAAM,SAAS,CAAC;AAQjE;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,GAAG,IAAI,CAKrE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAUnE;AAED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,aAAa,GAAG,eAAe,CAsG/E"}

package/dist/common/constants.d.ts

@@ -0,0 +1,9 @@
+export declare const FARCASTER_SERVICE_NAME = "farcaster";
+export declare const FARCASTER_SOURCE = "farcaster";
+export declare const DEFAULT_MAX_CAST_LENGTH = 320;
+export declare const DEFAULT_POLL_INTERVAL = 120;
+export declare const DEFAULT_CAST_INTERVAL_MIN = 90;
+export declare const DEFAULT_CAST_INTERVAL_MAX = 180;
+export declare const DEFAULT_CAST_CACHE_TTL: number;
+export declare const DEFAULT_CAST_CACHE_SIZE = 9000;
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/common/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,sBAAsB,cAAc,CAAC;AAClD,eAAO,MAAM,gBAAgB,cAAc,CAAC;AAC5C,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAC3C,eAAO,MAAM,qBAAqB,MAAM,CAAC;AACzC,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAC5C,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAC7C,eAAO,MAAM,sBAAsB,QAAiB,CAAC;AACrD,eAAO,MAAM,uBAAuB,OAAO,CAAC"}

package/dist/common/prompts.d.ts

@@ -0,0 +1,5 @@
+import { type Character } from '@elizaos/core';
+import type { Cast } from './types';
+export declare const formatCast: (cast: Cast) => string;
+export declare const formatTimeline: (character: Character, timeline: Cast[]) => string;
+//# sourceMappingURL=prompts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/common/prompts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAEpC,eAAO,MAAM,UAAU,GAAI,MAAM,IAAI,WAIpC,CAAC;AAEF,eAAO,MAAM,cAAc,GACzB,WAAW,SAAS,EACpB,UAAU,IAAI,EAAE,WAGjB,CAAC"}

package/dist/common/types.d.ts

@@ -0,0 +1,106 @@
+import { type Media, Memory, MessagePayload } from '@elizaos/core';
+import { Cast as NeynarCast, Embed as NeynarEmbed } from '@neynar/nodejs-sdk/build/api';
+import { z } from 'zod';
+export type Profile = {
+    fid: number;
+    name: string;
+    username: string;
+    pfp?: string;
+    bio?: string;
+    url?: string;
+};
+/**
+ * Embed types that can be attached to a cast
+ */
+export type CastEmbed = {
+    /** Type of embed: image, video, url, cast (quote), frame */
+    type: 'image' | 'video' | 'audio' | 'url' | 'cast' | 'frame' | 'unknown';
+    /** URL of the embedded content */
+    url: string;
+    /** For embedded casts, the cast hash */
+    castHash?: string;
+    /** Metadata about the embed from Neynar */
+    metadata?: {
+        contentType?: string;
+        width?: number;
+        height?: number;
+        duration?: number;
+        title?: string;
+        description?: string;
+        authorFid?: number;
+        authorUsername?: string;
+    };
+};
+export type Cast = {
+    hash: string;
+    authorFid: number;
+    text: string;
+    profile: Profile;
+    threadId?: string;
+    inReplyTo?: {
+        hash: string;
+        fid: number;
+    };
+    timestamp: Date;
+    stats?: {
+        recasts: number;
+        replies: number;
+        likes: number;
+    };
+    /** Raw embeds from Neynar API */
+    embeds?: NeynarEmbed[];
+    /** Processed media attachments ready for elizaos Memory */
+    media?: Media[];
+};
+export type CastId = {
+    hash: string;
+    fid: number;
+};
+export type FidRequest = {
+    fid: number;
+    pageSize: number;
+};
+export interface LastCast {
+    hash: string;
+    timestamp: number;
+}
+/**
+ * This schema defines all required/optional environment settings for Farcaster client
+ */
+export declare const FarcasterConfigSchema: any;
+export type FarcasterConfig = z.infer<typeof FarcasterConfigSchema>;
+export declare enum FarcasterEventTypes {
+    CAST_GENERATED = "FARCASTER_CAST_GENERATED",
+    MENTION_RECEIVED = "FARCASTER_MENTION_RECEIVED",
+    THREAD_CAST_CREATED = "FARCASTER_THREAD_CAST_CREATED"
+}
+export declare enum FarcasterMessageType {
+    CAST = "CAST",
+    REPLY = "REPLY"
+}
+export interface FarcasterGenericCastPayload extends Omit<MessagePayload, 'message'> {
+    memory: Memory;
+    cast: NeynarCast;
+}
+/**
+ * Neynar webhook data structure for cast events
+ */
+export interface NeynarWebhookData {
+    type: string;
+    data?: {
+        hash: string;
+        text?: string;
+        author: {
+            fid: number;
+            username?: string;
+        };
+        mentioned_profiles?: Array<{
+            fid: number;
+        }>;
+        parent_hash?: string;
+        parent_author?: {
+            fid: number;
+        };
+    };
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/common/utils.d.ts

@@ -0,0 +1,28 @@
+import { IAgentRuntime, Memory, UUID } from '@elizaos/core';
+import { Cast as NeynarCast } from '@neynar/nodejs-sdk/build/api';
+import { Cast } from './types';
+export declare const MAX_CAST_LENGTH = 1024;
+export declare function castId({ hash, agentId }: {
+    hash: string;
+    agentId: string;
+}): string;
+export declare function castUuid(props: {
+    hash: string;
+    agentId: string;
+}): any;
+export declare function splitPostContent(content: string, maxLength?: number): string[];
+export declare function splitParagraph(paragraph: string, maxLength: number): string[];
+export declare function lastCastCacheKey(fid: number): string;
+/**
+ * Convert a Neynar Cast to our internal Cast type
+ * Now includes embeds from the original cast for media processing
+ */
+export declare function neynarCastToCast(neynarCast: NeynarCast): Cast;
+export declare function createCastMemory({ roomId, senderId, runtime, cast, }: {
+    roomId: UUID;
+    senderId: UUID;
+    runtime: IAgentRuntime;
+    cast: Cast;
+}): Memory;
+export declare function formatCastTimestamp(timestamp: Date): string;
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/common/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,EAAgB,IAAI,EAAE,MAAM,eAAe,CAAC;AAC1E,OAAO,EAAE,IAAI,IAAI,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAElE,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE/B,eAAO,MAAM,eAAe,OAAO,CAAC;AAEpC,wBAAgB,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,UAE1E;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,OAEhE;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,GAAE,MAAwB,GAAG,MAAM,EAAE,CAkC/F;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CA6C7E;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,UAE3C;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,CAyB7D;AAED,wBAAgB,gBAAgB,CAAC,EAC/B,MAAM,EACN,QAAQ,EACR,OAAO,EACP,IAAI,GACL,EAAE;IACD,MAAM,EAAE,IAAI,CAAC;IACb,QAAQ,EAAE,IAAI,CAAC;IACf,OAAO,EAAE,aAAa,CAAC;IACvB,IAAI,EAAE,IAAI,CAAC;CACZ,GAAG,MAAM,CA2BT;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,IAAI,GAAG,MAAM,CAO3D"}