@beeperbot/sdk 0.2.0 → 0.2.2

package/dist/index.d.ts

@@ -113,7 +113,7 @@ declare function generateFilterDocumentation(): string;
  *
  * @example
  * ```typescript
- * import { AgentClient } from '@beeper/sdk';
+ * import { AgentClient } from '@beeperbot/sdk';
  *
  * const agent = new AgentClient({
  *   apiKey: process.env.BEEPER_API_KEY,
@@ -253,6 +253,12 @@ interface SimpleFilters {
         tokenAddress: string;
         chainId: number;
         minBalance?: string;
+    } | {
+        contractAddress: string;
+        chain: string | number;
+        minBalance?: string;
+        tokenStandard?: string;
+        tokenId?: string;
     }>;
     hasBaseWallet?: boolean;
     hasVerifiedWallet?: boolean;
@@ -260,7 +266,9 @@ interface SimpleFilters {
     minBatteryPercentage?: number;
     hasRechargedInLastDays?: number;
     excludePingedToday?: boolean;
-    countries?: string[];
+    countries?: Array<string | {
+        code: string;
+    }>;
     timezones?: Array<{
         offset: number;
         range?: number;
@@ -375,7 +383,12 @@ interface BulkIntentResult {
  */
 declare class AgentClient {
     private readonly http;
+    private static readonly CHAIN_ID_MAP;
     constructor(config: AgentClientConfig);
+    /**
+     * Normalize filters for agent endpoints (accepts flexible shapes from other builders)
+     */
+    private normalizeFilters;
     /**
      * Look up a user by username, FID, or wallet address
      *
@@ -857,7 +870,7 @@ declare const DraftInputSchema: z.ZodObject<{
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, "strip", z.ZodTypeAny, {
     name: string;
-    network: "base" | "ethereum" | "polygon" | "arbitrum" | "optimism";
+    network: "base" | "ethereum" | "arbitrum" | "polygon" | "optimism";
     amount: string;
     token: "USDC" | "USDT" | "ETH" | "MATIC";
     strategy: "equal" | "weighted" | "proportional";
@@ -866,7 +879,7 @@ declare const DraftInputSchema: z.ZodObject<{
     metadata?: Record<string, unknown> | undefined;
 }, {
     name: string;
-    network: "base" | "ethereum" | "polygon" | "arbitrum" | "optimism";
+    network: "base" | "ethereum" | "arbitrum" | "polygon" | "optimism";
     amount: string;
     token: "USDC" | "USDT" | "ETH" | "MATIC";
     strategy: "equal" | "weighted" | "proportional";
@@ -892,7 +905,7 @@ declare const DraftSchema: z.ZodObject<{
     status: z.ZodEnum<["draft", "quoted", "executed"]>;
 }, "strip", z.ZodTypeAny, {
     name: string;
-    network: "base" | "ethereum" | "polygon" | "arbitrum" | "optimism";
+    network: "base" | "ethereum" | "arbitrum" | "polygon" | "optimism";
     status: "draft" | "quoted" | "executed";
     id: string;
     createdAt: string;
@@ -905,7 +918,7 @@ declare const DraftSchema: z.ZodObject<{
     metadata?: Record<string, unknown> | undefined;
 }, {
     name: string;
-    network: "base" | "ethereum" | "polygon" | "arbitrum" | "optimism";
+    network: "base" | "ethereum" | "arbitrum" | "polygon" | "optimism";
     status: "draft" | "quoted" | "executed";
     id: string;
     createdAt: string;
@@ -932,7 +945,7 @@ declare const DraftUpdateSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     name?: string | undefined;
     filter?: unknown;
-    network?: "base" | "ethereum" | "polygon" | "arbitrum" | "optimism" | undefined;
+    network?: "base" | "ethereum" | "arbitrum" | "polygon" | "optimism" | undefined;
     amount?: string | undefined;
     token?: "USDC" | "USDT" | "ETH" | "MATIC" | undefined;
     strategy?: "equal" | "weighted" | "proportional" | undefined;
@@ -941,7 +954,7 @@ declare const DraftUpdateSchema: z.ZodObject<{
 }, {
     name?: string | undefined;
     filter?: unknown;
-    network?: "base" | "ethereum" | "polygon" | "arbitrum" | "optimism" | undefined;
+    network?: "base" | "ethereum" | "arbitrum" | "polygon" | "optimism" | undefined;
     amount?: string | undefined;
     token?: "USDC" | "USDT" | "ETH" | "MATIC" | undefined;
     strategy?: "equal" | "weighted" | "proportional" | undefined;
@@ -953,7 +966,7 @@ declare const DraftUpdateSchema: z.ZodObject<{
  */
 declare function validateDraftInput$1(input: unknown): z.SafeParseReturnType<{
     name: string;
-    network: "base" | "ethereum" | "polygon" | "arbitrum" | "optimism";
+    network: "base" | "ethereum" | "arbitrum" | "polygon" | "optimism";
     amount: string;
     token: "USDC" | "USDT" | "ETH" | "MATIC";
     strategy: "equal" | "weighted" | "proportional";
@@ -962,7 +975,7 @@ declare function validateDraftInput$1(input: unknown): z.SafeParseReturnType<{
     metadata?: Record<string, unknown> | undefined;
 }, {
     name: string;
-    network: "base" | "ethereum" | "polygon" | "arbitrum" | "optimism";
+    network: "base" | "ethereum" | "arbitrum" | "polygon" | "optimism";
     amount: string;
     token: "USDC" | "USDT" | "ETH" | "MATIC";
     strategy: "equal" | "weighted" | "proportional";
@@ -975,7 +988,7 @@ declare function validateDraftInput$1(input: unknown): z.SafeParseReturnType<{
  */
 declare function parseDraftInput(input: unknown): {
     name: string;
-    network: "base" | "ethereum" | "polygon" | "arbitrum" | "optimism";
+    network: "base" | "ethereum" | "arbitrum" | "polygon" | "optimism";
     amount: string;
     token: "USDC" | "USDT" | "ETH" | "MATIC";
     strategy: "equal" | "weighted" | "proportional";
@@ -988,7 +1001,7 @@ declare function parseDraftInput(input: unknown): {
  */
 declare function validateDraft(draft: unknown): z.SafeParseReturnType<{
     name: string;
-    network: "base" | "ethereum" | "polygon" | "arbitrum" | "optimism";
+    network: "base" | "ethereum" | "arbitrum" | "polygon" | "optimism";
     status: "draft" | "quoted" | "executed";
     id: string;
     createdAt: string;
@@ -1001,7 +1014,7 @@ declare function validateDraft(draft: unknown): z.SafeParseReturnType<{
     metadata?: Record<string, unknown> | undefined;
 }, {
     name: string;
-    network: "base" | "ethereum" | "polygon" | "arbitrum" | "optimism";
+    network: "base" | "ethereum" | "arbitrum" | "polygon" | "optimism";
     status: "draft" | "quoted" | "executed";
     id: string;
     createdAt: string;
@@ -1018,7 +1031,7 @@ declare function validateDraft(draft: unknown): z.SafeParseReturnType<{
  */
 declare function parseDraft(draft: unknown): {
     name: string;
-    network: "base" | "ethereum" | "polygon" | "arbitrum" | "optimism";
+    network: "base" | "ethereum" | "arbitrum" | "polygon" | "optimism";
     status: "draft" | "quoted" | "executed";
     id: string;
     createdAt: string;
@@ -1545,6 +1558,154 @@ declare function getApiKeyEnvironment(apiKey: string): 'production' | 'test' | n
  */
 declare function maskApiKey(apiKey: string): string;
 
+/**
+ * Mission & Bonus Reward Types for beeper-sdk
+ *
+ * Types for configuring bonus missions (CTAs + reward distribution)
+ * on beeps and campaigns.
+ */
+/** Farcaster: Follow a profile */
+interface FollowProfileCTA {
+    type: 'follow_profile';
+    profileFid: number;
+    profileUsername?: string;
+    profileDisplayName?: string;
+}
+/** Farcaster: Like a specific cast */
+interface LikeCastCTA {
+    type: 'like_cast';
+    castHash: string;
+    castUrl?: string;
+    castAuthorFid?: number;
+    castAuthorUsername?: string;
+}
+/** Farcaster: Recast a specific cast */
+interface RecastCTA {
+    type: 'recast';
+    castHash: string;
+    castUrl?: string;
+    castAuthorFid?: number;
+    castAuthorUsername?: string;
+}
+/** Farcaster: Post a quote cast with requirements */
+interface ShareCastCTA {
+    type: 'share_cast';
+    requirements?: {
+        textIncludes?: string[];
+        mentions?: string[];
+        embeds?: string[];
+    };
+}
+/** Universal: Visit a link */
+interface VisitLinkCTA {
+    type: 'visit_link';
+    url: string;
+    label?: string;
+}
+/** Universal: Answer quiz questions */
+interface QuizCTA {
+    type: 'quiz';
+    questions: QuizQuestion[];
+}
+interface QuizQuestion {
+    question: string;
+    answers: string[];
+    correctAnswerIndex: number;
+}
+/** Universal: Custom verification via external endpoint */
+interface ExternalVerifyCTA {
+    type: 'external_verify';
+    endpointUrl: string;
+    appUrl: string;
+    appIsMiniApp?: boolean;
+    guideUrl?: string;
+    guideLabel?: string;
+    description?: string;
+}
+/** X (Twitter): Follow a profile */
+interface XFollowCTA {
+    type: 'x_follow';
+    handle: string;
+    profileUrl: string;
+    displayName?: string;
+}
+/** X (Twitter): Like a tweet */
+interface XLikeCTA {
+    type: 'x_like';
+    tweetId: string;
+    tweetUrl: string;
+    authorHandle?: string;
+    tweetText?: string;
+}
+/** X (Twitter): Repost a tweet */
+interface XRecastCTA {
+    type: 'x_recast';
+    tweetId: string;
+    tweetUrl: string;
+    authorHandle?: string;
+    tweetText?: string;
+}
+/** All CTA types */
+type MissionCTA = FollowProfileCTA | LikeCastCTA | RecastCTA | ShareCastCTA | VisitLinkCTA | QuizCTA | ExternalVerifyCTA | XFollowCTA | XLikeCTA | XRecastCTA;
+/** CTA type strings */
+type CTAType = MissionCTA['type'];
+/** Lottery prize tier */
+interface PrizeTier {
+    prizeAmount: number;
+    winnerCount: number;
+}
+/** Lottery distribution config */
+interface LotteryConfig {
+    prizeTiers: PrizeTier[];
+    durationSeconds?: number;
+}
+/** FCFS distribution config */
+interface FCFSConfig {
+    amountPerClaim: number;
+    maxClaims: number;
+    startDelaySeconds?: number;
+}
+/** Bonus reward configuration */
+interface BonusConfig {
+    type: 'lottery' | 'fcfs';
+    ctas?: MissionCTA[];
+    lotteryConfig?: LotteryConfig;
+    fcfsConfig?: FCFSConfig;
+}
+/** How budget is split between payout and bonus pool */
+type GoalType = 'max_reach' | 'lil_mission' | 'hard_mission';
+/** Fine-tune the budget split */
+type SplitPreset = 'balanced' | 'more_reach' | 'more_action';
+/** Computed budget split */
+interface BudgetSplit {
+    totalUsd: number;
+    payoutUsd: number;
+    bonusUsd: number;
+    platformFeeUsd: number;
+    userPaysUsd: number;
+    goalType: GoalType;
+    splitPreset: SplitPreset;
+    payoutPercent: number;
+    bonusPercent: number;
+}
+/** Campaign input extending estimate with mission support */
+interface CampaignInput {
+    filters: Record<string, unknown>;
+    budget: string;
+    message?: string;
+    goalType?: GoalType;
+    splitPreset?: SplitPreset;
+    bonusConfig?: BonusConfig;
+}
+
+/**
+ * Core types for the Beeper SDK
+ *
+ * These types are the canonical API contract types matching the BeeperClient
+ * and the backend HTTP contract. Legacy types from the old schema-based API
+ * have been removed or replaced.
+ */
+
 /**
  * Draft input - what the user provides to create a draft
  */
@@ -1767,7 +1928,7 @@ interface PaginatedResponse<T> {
  *
  * @example
  * ```typescript
- * import { FilterBuilder } from '@beeper/sdk';
+ * import { FilterBuilder } from '@beeperbot/sdk';
  *
  * const filter = FilterBuilder.and([
  *   FilterBuilder.platform('farcaster'),
@@ -2438,7 +2599,7 @@ declare const QuoteSchema: z.ZodObject<{
     createdAt: z.ZodString;
     isValid: z.ZodBoolean;
 }, "strip", z.ZodTypeAny, {
-    network: "base" | "ethereum" | "polygon" | "arbitrum" | "optimism";
+    network: "base" | "ethereum" | "arbitrum" | "polygon" | "optimism";
     id: string;
     recipientCount: number;
     totalAmount: string;
@@ -2458,7 +2619,7 @@ declare const QuoteSchema: z.ZodObject<{
     }[];
     isValid: boolean;
 }, {
-    network: "base" | "ethereum" | "polygon" | "arbitrum" | "optimism";
+    network: "base" | "ethereum" | "arbitrum" | "polygon" | "optimism";
     id: string;
     recipientCount: number;
     totalAmount: string;
@@ -2565,7 +2726,7 @@ declare function parseQuoteOptions(options: unknown): {
  * Validate quote response
  */
 declare function validateQuote(quote: unknown): z.SafeParseReturnType<{
-    network: "base" | "ethereum" | "polygon" | "arbitrum" | "optimism";
+    network: "base" | "ethereum" | "arbitrum" | "polygon" | "optimism";
     id: string;
     recipientCount: number;
     totalAmount: string;
@@ -2585,7 +2746,7 @@ declare function validateQuote(quote: unknown): z.SafeParseReturnType<{
     }[];
     isValid: boolean;
 }, {
-    network: "base" | "ethereum" | "polygon" | "arbitrum" | "optimism";
+    network: "base" | "ethereum" | "arbitrum" | "polygon" | "optimism";
     id: string;
     recipientCount: number;
     totalAmount: string;
@@ -2609,7 +2770,7 @@ declare function validateQuote(quote: unknown): z.SafeParseReturnType<{
  * Parse quote response
  */
 declare function parseQuote(quote: unknown): {
-    network: "base" | "ethereum" | "polygon" | "arbitrum" | "optimism";
+    network: "base" | "ethereum" | "arbitrum" | "polygon" | "optimism";
     id: string;
     recipientCount: number;
     totalAmount: string;
@@ -2729,7 +2890,7 @@ declare const ReceiptSchema: z.ZodObject<{
     createdAt: z.ZodString;
 }, "strip", z.ZodTypeAny, {
     quoteId: string;
-    network: "base" | "ethereum" | "polygon" | "arbitrum" | "optimism";
+    network: "base" | "ethereum" | "arbitrum" | "polygon" | "optimism";
     id: string;
     totalAmount: string;
     createdAt: string;
@@ -2752,7 +2913,7 @@ declare const ReceiptSchema: z.ZodObject<{
     failedTransfers: number;
 }, {
     quoteId: string;
-    network: "base" | "ethereum" | "polygon" | "arbitrum" | "optimism";
+    network: "base" | "ethereum" | "arbitrum" | "polygon" | "optimism";
     id: string;
     totalAmount: string;
     createdAt: string;
@@ -2779,7 +2940,7 @@ declare const ReceiptSchema: z.ZodObject<{
  */
 declare function validateReceipt(receipt: unknown): z.SafeParseReturnType<{
     quoteId: string;
-    network: "base" | "ethereum" | "polygon" | "arbitrum" | "optimism";
+    network: "base" | "ethereum" | "arbitrum" | "polygon" | "optimism";
     id: string;
     totalAmount: string;
     createdAt: string;
@@ -2802,7 +2963,7 @@ declare function validateReceipt(receipt: unknown): z.SafeParseReturnType<{
     failedTransfers: number;
 }, {
     quoteId: string;
-    network: "base" | "ethereum" | "polygon" | "arbitrum" | "optimism";
+    network: "base" | "ethereum" | "arbitrum" | "polygon" | "optimism";
     id: string;
     totalAmount: string;
     createdAt: string;
@@ -2829,7 +2990,7 @@ declare function validateReceipt(receipt: unknown): z.SafeParseReturnType<{
  */
 declare function parseReceipt(receipt: unknown): {
     quoteId: string;
-    network: "base" | "ethereum" | "polygon" | "arbitrum" | "optimism";
+    network: "base" | "ethereum" | "arbitrum" | "polygon" | "optimism";
     id: string;
     totalAmount: string;
     createdAt: string;
@@ -4344,4 +4505,4 @@ declare function validateFilterHasTargeting(filter: RecipientFilter): boolean;
  */
 declare function describeFilters(filter: RecipientFilter): string[];
 
-export { API_BASE_URLS, API_KEY_PREFIXES, ActiveInLastDaysFilterSchema, AgentClient, type AgentClientConfig, type User as AgentUser, type ApiQuoteResponse, ApiQuoteResponseSchema, type ApiReceiptResponse, ApiReceiptResponseSchema, type AttentionPrice, type AttentionQuoteInput, BeeperClient, type BeeperClientConfig, type BeeperConfig, BeeperEconomicsFilterSchema, type BeeperEconomicsFilter as BeeperEconomicsFilterSchemaType, BeeperError, type BeeperErrorOptions, type BulkIntentInput, type BulkIntentResult, CachedTokenHolderFilterSchema, CachedTokenHolderSchema, type CachedTokenHolder as CachedTokenHolderSchemaType, type ConfirmDeploymentInput, type ConfirmDeploymentResult, type ConfirmDepositParams, type ConfirmDepositResponse, ConfirmDepositResponseSchema, type ConfirmResult, ConfirmResultSchema, CountryFilterSchema, type CreateIntentInput, DistributionStrategySchema, type Draft, type DraftInput, DraftInputSchema, DraftSchema, DraftStatusSchema, DraftUpdateSchema, type Environment, type ErrorCode, ErrorCodes, type ErrorContext, type EstimateInput, type EstimateResult, ExcludePingedTodayFilterSchema, ExcludeUsersFilterSchema, type ExecuteResult, ExecuteResultSchema, type ExecuteSendParams, type ExecuteSendResponse, ExecuteSendResponseSchema, ExecuteStatusSchema, FILTER_SCHEMA, FieldComparisonSchema, FilterBuilder, type FilterCategory, FilterExpression$1 as FilterExpression, type FilterExpressionJSON, FilterExpressionSchema, type FilterExpression as FilterExpressionSchemaType, type FilterFieldSchema, FilterOperatorSchema, FilterValueSchema, FollowersOfFilterSchema, FollowingOfFilterSchema, GasTierSchema, HEADERS, HTTP_STATUS_TO_ERROR_CODE, HasBaseWalletFilterSchema, HasRechargedInLastDaysFilterSchema, HasTierFilterSchema, HasVerifiedWalletFilterSchema, type Health, HttpClient, type HttpClientConfig, type HttpRequestOptions, type HttpResponse, IsWaitlistedFilterSchema, type LegacyFieldComparison, LegacyFieldComparisonSchema, type LegacyFilterOperator, LegacyFilterOperatorSchema, type LegacyFilterValue, LegacyFilterValueSchema, LegacyRecipientFilterDSLSchema, MaxAttentionPriceFilterSchema, MaxFidFilterSchema, MaxFollowersFilterSchema, MaxFollowingFilterSchema, MinAttentionPriceFilterSchema, MinBatteryPercentageFilterSchema, MinCastCountFilterSchema, MinClickThroughRateFilterSchema, MinFidFilterSchema, MinFollowersFilterSchema, MinFollowingFilterSchema, MinProTenureDaysFilterSchema, MinTenureDaysFilterSchema, MutualsWithFilterSchema, NetworkSchema, NeynarScoreMaxFilterSchema, NeynarScoreMinFilterSchema, OnchainFilterSchema, type OnchainFilter as OnchainFilterSchemaType, type OrderByOption, OrderBySchema, type OrderBy as OrderBySchemaType, type PaginatedResponse, type PaginationOptions, type PaymentIntent, type Platform, PlatformFilterSchema, type PlatformFilter as PlatformFilterSchemaType, type PollOptions$1 as PollOptions, type PreviewInput, type PreviewResult, type PreviewUser, ProSubscriptionFilterSchema, QUOTE_EXPIRATION_SECONDS, type Quote, type QuoteOptions, QuoteOptionsSchema, QuoteRecipientSchema, QuoteSchema, type QuoteStatus$2 as QuoteStatus, QuotientScoreMaxFilterSchema, QuotientScoreMinFilterSchema, RETRYABLE_ERROR_CODES, RETRY_CONFIG, type Receipt, ReceiptSchema, type ReceiptStatus, type ReceiptTransaction, ReceiptTransactionSchema, ReceiptTransferSchema, RecipientFilterDSLSchema, RecipientFilterSchema, type RecipientFilter as RecipientFilterSchemaType, ReputationFilterSchema, type ReputationFilter as ReputationFilterSchemaType, RequireLotteryOptInFilterSchema, RequireQuizOptInFilterSchema, type RetryOptions, RolesFilterSchema, SDK_VERSION, type PollOptions as SendPollOptions, type QuoteStatus$1 as SendQuoteStatus, type ReceiptTransaction$1 as SendReceiptTransaction, SignalTokenFilterSchema, type SimpleFilters, SocialFilterSchema, type SocialFilter as SocialFilterSchemaType, type SpamLabel, SpamLabelFilterSchema, type SpamLabelOption, SpecificUsersFilterSchema, TIMEOUTS, TimezoneFilterSchema, type TimezoneOptions, TokenHolderDiscoverySchema, type TokenHolderDiscovery as TokenHolderDiscoverySchemaType, TokenHolderFilterSchema, type TokenHolderOptions, TokenTypeSchema, TransferStatusSchema, type QuoteStatus as TypesQuoteStatus, VerifiedOnlyFilterSchema, type WalletChain, createHttpConfig, BeeperClient as default, describeFilters, generateDepositIdempotencyKey, generateExecuteIdempotencyKey, generateFilterDocumentation, generateIdempotencyKey, getAllFilterNames, getApiKeyEnvironment, getFilterSchema, isRetryableCode, isValidApiKeyFormat, maskApiKey, parseDraft, parseDraftInput, parseExecuteResult, parseFilter, parseQuote, parseQuoteOptions, parseReceipt, parseRecipientFilter, safeParseFilter, safeParseRecipientFilter, confirmDeposit as sendConfirmDeposit, createDraft as sendCreateDraft, createQuote as sendCreateQuote, executeSend as sendExecuteSend, getEstimatedTimeRemaining as sendGetEstimatedTimeRemaining, getFailedTransactions as sendGetFailedTransactions, getQuote as sendGetQuote, getReceipt as sendGetReceipt, getSuccessRate as sendGetSuccessRate, isComplete as sendIsComplete, isDepositSufficient as sendIsDepositSufficient, isExecuting as sendIsExecuting, isQuoteExpired as sendIsQuoteExpired, isReadyForDeposit as sendIsReadyForDeposit, isReadyForQuote as sendIsReadyForQuote, isSuccess as sendIsSuccess, pollUntilComplete as sendPollUntilComplete, updateDraft as sendUpdateDraft, validateDraftInput as sendValidateDraftInput, validateDraft, validateDraftInput$1 as validateDraftInput, validateExecuteResult, validateFilter, validateFilterHasTargeting, validateQuote, validateQuoteOptions, validateReceipt, validateRecipientFilter };
+export { API_BASE_URLS, API_KEY_PREFIXES, ActiveInLastDaysFilterSchema, AgentClient, type AgentClientConfig, type User as AgentUser, type ApiQuoteResponse, ApiQuoteResponseSchema, type ApiReceiptResponse, ApiReceiptResponseSchema, type AttentionPrice, type AttentionQuoteInput, BeeperClient, type BeeperClientConfig, type BeeperConfig, BeeperEconomicsFilterSchema, type BeeperEconomicsFilter as BeeperEconomicsFilterSchemaType, BeeperError, type BeeperErrorOptions, type BonusConfig, type BudgetSplit, type BulkIntentInput, type BulkIntentResult, type CTAType, CachedTokenHolderFilterSchema, CachedTokenHolderSchema, type CachedTokenHolder as CachedTokenHolderSchemaType, type CampaignInput, type ConfirmDeploymentInput, type ConfirmDeploymentResult, type ConfirmDepositParams, type ConfirmDepositResponse, ConfirmDepositResponseSchema, type ConfirmResult, ConfirmResultSchema, CountryFilterSchema, type CreateIntentInput, DistributionStrategySchema, type Draft, type DraftInput, DraftInputSchema, DraftSchema, DraftStatusSchema, DraftUpdateSchema, type Environment, type ErrorCode, ErrorCodes, type ErrorContext, type EstimateInput, type EstimateResult, ExcludePingedTodayFilterSchema, ExcludeUsersFilterSchema, type ExecuteResult, ExecuteResultSchema, type ExecuteSendParams, type ExecuteSendResponse, ExecuteSendResponseSchema, ExecuteStatusSchema, type ExternalVerifyCTA, type FCFSConfig, FILTER_SCHEMA, FieldComparisonSchema, FilterBuilder, type FilterCategory, FilterExpression$1 as FilterExpression, type FilterExpressionJSON, FilterExpressionSchema, type FilterExpression as FilterExpressionSchemaType, type FilterFieldSchema, FilterOperatorSchema, FilterValueSchema, type FollowProfileCTA, FollowersOfFilterSchema, FollowingOfFilterSchema, GasTierSchema, type GoalType, HEADERS, HTTP_STATUS_TO_ERROR_CODE, HasBaseWalletFilterSchema, HasRechargedInLastDaysFilterSchema, HasTierFilterSchema, HasVerifiedWalletFilterSchema, type Health, HttpClient, type HttpClientConfig, type HttpRequestOptions, type HttpResponse, IsWaitlistedFilterSchema, type LegacyFieldComparison, LegacyFieldComparisonSchema, type LegacyFilterOperator, LegacyFilterOperatorSchema, type LegacyFilterValue, LegacyFilterValueSchema, LegacyRecipientFilterDSLSchema, type LikeCastCTA, type LotteryConfig, MaxAttentionPriceFilterSchema, MaxFidFilterSchema, MaxFollowersFilterSchema, MaxFollowingFilterSchema, MinAttentionPriceFilterSchema, MinBatteryPercentageFilterSchema, MinCastCountFilterSchema, MinClickThroughRateFilterSchema, MinFidFilterSchema, MinFollowersFilterSchema, MinFollowingFilterSchema, MinProTenureDaysFilterSchema, MinTenureDaysFilterSchema, type MissionCTA, MutualsWithFilterSchema, NetworkSchema, NeynarScoreMaxFilterSchema, NeynarScoreMinFilterSchema, OnchainFilterSchema, type OnchainFilter as OnchainFilterSchemaType, type OrderByOption, OrderBySchema, type OrderBy as OrderBySchemaType, type PaginatedResponse, type PaginationOptions, type PaymentIntent, type Platform, PlatformFilterSchema, type PlatformFilter as PlatformFilterSchemaType, type PollOptions$1 as PollOptions, type PreviewInput, type PreviewResult, type PreviewUser, type PrizeTier, ProSubscriptionFilterSchema, QUOTE_EXPIRATION_SECONDS, type QuizCTA, type QuizQuestion, type Quote, type QuoteOptions, QuoteOptionsSchema, QuoteRecipientSchema, QuoteSchema, type QuoteStatus$2 as QuoteStatus, QuotientScoreMaxFilterSchema, QuotientScoreMinFilterSchema, RETRYABLE_ERROR_CODES, RETRY_CONFIG, type RecastCTA, type Receipt, ReceiptSchema, type ReceiptStatus, type ReceiptTransaction, ReceiptTransactionSchema, ReceiptTransferSchema, RecipientFilterDSLSchema, RecipientFilterSchema, type RecipientFilter as RecipientFilterSchemaType, ReputationFilterSchema, type ReputationFilter as ReputationFilterSchemaType, RequireLotteryOptInFilterSchema, RequireQuizOptInFilterSchema, type RetryOptions, RolesFilterSchema, SDK_VERSION, type PollOptions as SendPollOptions, type QuoteStatus$1 as SendQuoteStatus, type ReceiptTransaction$1 as SendReceiptTransaction, type ShareCastCTA, SignalTokenFilterSchema, type SimpleFilters, SocialFilterSchema, type SocialFilter as SocialFilterSchemaType, type SpamLabel, SpamLabelFilterSchema, type SpamLabelOption, SpecificUsersFilterSchema, type SplitPreset, TIMEOUTS, TimezoneFilterSchema, type TimezoneOptions, TokenHolderDiscoverySchema, type TokenHolderDiscovery as TokenHolderDiscoverySchemaType, TokenHolderFilterSchema, type TokenHolderOptions, TokenTypeSchema, TransferStatusSchema, type QuoteStatus as TypesQuoteStatus, VerifiedOnlyFilterSchema, type VisitLinkCTA, type WalletChain, type XFollowCTA, type XLikeCTA, type XRecastCTA, createHttpConfig, BeeperClient as default, describeFilters, generateDepositIdempotencyKey, generateExecuteIdempotencyKey, generateFilterDocumentation, generateIdempotencyKey, getAllFilterNames, getApiKeyEnvironment, getFilterSchema, isRetryableCode, isValidApiKeyFormat, maskApiKey, parseDraft, parseDraftInput, parseExecuteResult, parseFilter, parseQuote, parseQuoteOptions, parseReceipt, parseRecipientFilter, safeParseFilter, safeParseRecipientFilter, confirmDeposit as sendConfirmDeposit, createDraft as sendCreateDraft, createQuote as sendCreateQuote, executeSend as sendExecuteSend, getEstimatedTimeRemaining as sendGetEstimatedTimeRemaining, getFailedTransactions as sendGetFailedTransactions, getQuote as sendGetQuote, getReceipt as sendGetReceipt, getSuccessRate as sendGetSuccessRate, isComplete as sendIsComplete, isDepositSufficient as sendIsDepositSufficient, isExecuting as sendIsExecuting, isQuoteExpired as sendIsQuoteExpired, isReadyForDeposit as sendIsReadyForDeposit, isReadyForQuote as sendIsReadyForQuote, isSuccess as sendIsSuccess, pollUntilComplete as sendPollUntilComplete, updateDraft as sendUpdateDraft, validateDraftInput as sendValidateDraftInput, validateDraft, validateDraftInput$1 as validateDraftInput, validateExecuteResult, validateFilter, validateFilterHasTargeting, validateQuote, validateQuoteOptions, validateReceipt, validateRecipientFilter };

package/dist/index.js

@@ -904,8 +904,16 @@ var ENDPOINTS = {
   PREVIEW: "/agent/preview",
   BULK_INTENT: "/agent/bulk-intent"
 };
-var AgentClient = class {
+var AgentClient = class _AgentClient {
   http;
+  static CHAIN_ID_MAP = {
+    base: 8453,
+    ethereum: 1,
+    mainnet: 1,
+    arbitrum: 42161,
+    polygon: 137,
+    optimism: 10
+  };
   constructor(config) {
     if (!config.apiKey) {
       throw BeeperError.validation("API key is required");
@@ -920,6 +928,62 @@ var AgentClient = class {
     });
     this.http = new HttpClient(httpConfig);
   }
+  /**
+   * Normalize filters for agent endpoints (accepts flexible shapes from other builders)
+   */
+  normalizeFilters(filters) {
+    const normalized = { ...filters };
+    const stripEmptyArray = (key) => {
+      const val = normalized[key];
+      if (Array.isArray(val) && val.length === 0) {
+        delete normalized[key];
+      }
+    };
+    const stripZero = (key) => {
+      const val = normalized[key];
+      if (typeof val === "number" && val === 0) {
+        delete normalized[key];
+      }
+    };
+    if (normalized.platform === "all") delete normalized.platform;
+    if (normalized.spamLabel === "all") delete normalized.spamLabel;
+    stripZero("minFollowers");
+    stripZero("maxFollowers");
+    stripZero("activeInLastDays");
+    stripZero("minBatteryPercentage");
+    stripZero("hasRechargedInLastDays");
+    stripZero("maxAttentionPriceUsd");
+    if (normalized.neynarScoreMin === 0) delete normalized.neynarScoreMin;
+    if (normalized.neynarScoreMax === 1) delete normalized.neynarScoreMax;
+    if (normalized.quotientScoreMin === 0) delete normalized.quotientScoreMin;
+    if (normalized.quotientScoreMax === 1) delete normalized.quotientScoreMax;
+    if (Array.isArray(normalized.countries)) {
+      normalized.countries = normalized.countries.map((c) => typeof c === "string" ? c : c?.code).filter((c) => typeof c === "string" && c.trim().length > 0).map((c) => c.trim().toUpperCase());
+    }
+    stripEmptyArray("countries");
+    if (Array.isArray(normalized.tokenHolders)) {
+      normalized.tokenHolders = normalized.tokenHolders.map((holder) => {
+        if (!holder) return null;
+        if ("tokenAddress" in holder && "chainId" in holder) return holder;
+        const contractAddress = holder.contractAddress;
+        const chain = holder.chain;
+        const minBalance = holder.minBalance;
+        if (!contractAddress || chain == null) return null;
+        const chainId = typeof chain === "number" ? chain : _AgentClient.CHAIN_ID_MAP[String(chain).toLowerCase()] ?? Number(chain);
+        if (!Number.isFinite(chainId)) return null;
+        return {
+          tokenAddress: contractAddress,
+          chainId,
+          ...minBalance ? { minBalance } : {}
+        };
+      }).filter((holder) => !!holder);
+    }
+    stripEmptyArray("tokenHolders");
+    stripEmptyArray("signalTokens");
+    stripEmptyArray("fids");
+    stripEmptyArray("userIds");
+    return normalized;
+  }
   /**
    * Look up a user by username, FID, or wallet address
    *
@@ -1050,7 +1114,7 @@ var AgentClient = class {
     const response = await this.http.post(
       ENDPOINTS.ESTIMATE,
       {
-        filters: input.filters,
+        filters: this.normalizeFilters(input.filters),
         budgetUsd: budgetStr,
         message: input.message
       }
@@ -1080,7 +1144,7 @@ var AgentClient = class {
     const response = await this.http.post(
       ENDPOINTS.PREVIEW,
       {
-        filters: input.filters,
+        filters: this.normalizeFilters(input.filters),
         limit
       }
     );
@@ -1112,7 +1176,7 @@ var AgentClient = class {
     const response = await this.http.post(
       ENDPOINTS.BULK_INTENT,
       {
-        filters: input.filters,
+        filters: this.normalizeFilters(input.filters),
         budgetUsd: budgetStr,
         message: input.message,
         chainId: input.chainId ?? 8453
@@ -1194,6 +1258,7 @@ function maskApiKey(apiKey) {
 }
 
 // src/client/BeeperClient.ts
+var ALLOWED_REWARD_TYPES = ["guaranteed", "lottery", "fcfs"];
 var QuoteSchema = z.object({
   id: z.string(),
   status: z.enum([
@@ -1400,6 +1465,16 @@ var BeeperClient = class {
     if (input.message.length > 1e3) {
       throw BeeperError.validation("Message must be 1000 characters or less");
     }
+    if (input.rewardType !== void 0) {
+      if (input.rewardType.trim().length === 0) {
+        throw BeeperError.validation("rewardType must be a non-empty string");
+      }
+      if (!ALLOWED_REWARD_TYPES.includes(input.rewardType)) {
+        throw BeeperError.validation(
+          `rewardType must be one of: ${ALLOWED_REWARD_TYPES.join(", ")}`
+        );
+      }
+    }
     if (!input.recipientFids?.length && !input.filter) {
       throw BeeperError.validation("Must provide either recipientFids or filter");
     }
@@ -1418,6 +1493,7 @@ var BeeperClient = class {
       filter: input.filter,
       budgetUSD: input.budgetUSD,
       rewardType: input.rewardType ?? "guaranteed",
+      mode: "attention_marketplace",
       memo: input.memo,
       metadata: input.metadata,
       ttlSeconds: opts?.ttlSeconds ?? 300
@@ -2781,11 +2857,10 @@ var FilterBuilder = class _FilterBuilder {
         throw new Error("minBalance must be a numeric string (wei)");
       }
     }
-    const chainNames = { 1: "ethereum", 8453: "base", 42161: "arbitrum", 10: "optimism", 137: "polygon" };
     return new FilterExpression({
       cachedTokenHolders: opts.map((o) => ({
         contractAddress: o.tokenAddress,
-        chain: chainNames[o.chainId] ?? String(o.chainId),
+        chain: o.chainId === 8453 ? "base" : "ethereum",
         tokenStandard: o.tokenStandard ?? "ERC20",
         ...o.minBalance !== void 0 ? { minBalance: o.minBalance } : {},
         ...o.tokenId !== void 0 ? { tokenId: o.tokenId } : {}