@joai/sdk 1.4.1 → 2.1.0

package/dist/index.d.mts

@@ -195,22 +195,6 @@ type UserPrivate = {
   kyc?: Kyc | null;
   settings: UserSettings;
 };
-type Earning = {
-  id: number;
-  amount: number;
-  type: string;
-  description: string | null;
-  createdAt: string;
-};
-type PayoutEntry = {
-  id: number;
-  amount: number;
-  status: string;
-  tx: string | null;
-  failureReason: string | null;
-  processedAt: string | null;
-  createdAt: string;
-};
 type UserSocialAccount = {
   platform: string;
   id: string;
@@ -287,6 +271,21 @@ type TeamMeta = {
   branding?: TeamBrand | null;
   settings: Record<string, unknown>;
 };
+type TeamPlace = {
+  provider: 'google';
+  sourceId: string;
+  name: string | null;
+  address: string | null;
+  location: {
+    lat: number | null;
+    lng: number | null;
+  };
+  rating?: number | null;
+  reviewCount?: number | null;
+  websiteUrl?: string | null;
+  mapsUrl?: string | null;
+  businessStatus?: string | null;
+};
 type Team = {
   slug: string;
   name: string;
@@ -296,6 +295,7 @@ type Team = {
   description: TranslatableValue | null;
   locale: WarpLocale;
   timezone: string;
+  place?: TeamPlace | null;
   meta?: TeamMeta;
   features?: TeamFeature[];
   cover?: string | null;
@@ -331,6 +331,7 @@ type TeamPrivate = {
   balance: number;
   locale: WarpLocale;
   timezone: string;
+  place?: TeamPlace | null;
   logo: string | null;
   cover: string | null;
   subscription: {
@@ -425,6 +426,25 @@ type JsonValue = string | number | boolean | null | JsonValue[] | {
 }; //#endregion
 //#region src/contact/types.d.ts
 type ContactHealth = 'active' | 'lukewarm' | 'cold' | 'stale' | 'unknown';
+type ContactConsentStatus = 'pending' | 'confirmed' | 'superseded' | 'unsubscribed';
+type ContactConsent = {
+  id: string;
+  purpose: string;
+  status: ContactConsentStatus;
+  email: string;
+  consentText: {
+    label?: string | Record<string, string>;
+    description?: string | Record<string, string> | null;
+  };
+  privacyUrl: string | null;
+  source: {
+    formIdentifier?: string | null;
+    formTitle?: string | Record<string, string> | null;
+  };
+  requestedAt: string;
+  confirmedAt: string | null;
+  unsubscribedAt: string | null;
+};
 type Contact = {
   id: string;
   name: string;
@@ -445,8 +465,11 @@ type Contact = {
   settings?: {
     marketingOptOut?: boolean;
   } | null;
+  consents?: ContactConsent[];
   lastActivityAt?: string | null;
   health?: ContactHealth;
+  nextFollowUpAt?: string | null;
+  followUpNote?: string | null;
 };
 type ContactActivityType = 'note' | 'call' | 'meeting' | 'task' | 'update' | 'custom' | 'form' | 'loyalty';
 type ContactActivityAuthor = {
@@ -479,6 +502,8 @@ type ContactFormData = {
   settings?: {
     marketingOptOut?: boolean;
   };
+  nextFollowUpAt?: string | null;
+  followUpNote?: string | null;
 };
 type ContactCreatePayload = ContactFormData & {
   name: string;
@@ -497,10 +522,8 @@ type MediaLibraryAttributes = {
   extension?: string;
   size?: number;
 };
-type MediaLibraryItems = {
-  [uuid: string]: MediaLibraryAttributes;
-};
 type MediaMime = 'image/png' | 'image/jpeg' | 'image/gif' | 'image/webp' | 'video/mp4' | 'video/webm' | 'video/quicktime' | 'video/x-msvideo' | 'audio/mpeg' | 'audio/mp3' | 'audio/ogg' | 'audio/wav' | 'audio/webm' | 'audio/aac' | 'audio/m4a' | 'audio/m4b' | 'audio/m4p' | 'audio/m4v' | 'application/pdf' | 'application/json';
+type MediaAspectRatio = 'free' | '1:1' | '16:9' | '9:16' | '4:3' | '3:4';
 type Media = {
   id: string;
   name: string;
@@ -532,7 +555,7 @@ type AppSubscription = {
   createdAt: string;
   updatedAt: string;
 };
-type PaymentProvider = 'xmoney' | 'lemonsqueezy' | 'stripe' | 'stripe-connect' | 'apple' | 'google' | 'blockchain' | 'offline';
+type PaymentProvider = 'xmoney' | 'lemonsqueezy' | 'stripe' | 'stripe-connect' | 'mollie' | 'mollie-connect' | 'apple' | 'google' | 'blockchain' | 'offline';
 type PaymentAccount = {
   provider: string;
   connected: boolean;
@@ -546,13 +569,17 @@ type PaymentAccountOnboarding = {
 };
 type TerminalConnectionToken = {
   secret: string;
-  locationId: string;
+  locationId: string | null;
   connectedAccountId: string;
+  appId?: string | null;
+  webhookUrl?: string | null;
 };
 type TerminalPaymentIntent = {
-  clientSecret: string;
+  clientSecret: string | null;
   paymentIntentId: string;
   connectedAccountId: string;
+  payload?: string | null;
+  signature?: string | null;
 };
 type PlanFeature = 'general' | 'messages' | 'team-members' | 'teams' | 'support' | 'agent' | 'auto-mode' | 'cloud-sync' | 'wallet-cloud' | 'wallet-cloud-premium' | 'wallet-multi' | 'cards' | 'alerts' | 'advanced-commands' | 'tasks' | 'integrations' | 'message-history' | 'memory' | 'documents' | 'voice-input' | 'voice-live' | 'image-gen' | 'video-gen' | 'openclaw' | 'skills' | 'items' | 'context-length' | 'workspace-storage' | 'ingestions' | 'agent-email' | 'streak-freezes' | 'byok' | 'mcp' | 'phone-call' | 'phone-number' | 'custom-domain' | 'contacts' | 'links' | 'store-fee-rate' | 'store-fee-rate-physical' | 'tap-to-pay';
 type PlanBenefit = {
@@ -578,6 +605,7 @@ type BillingAddress = {
 type PlanInterval = 'weekly' | 'monthly' | 'yearly' | 'lifetime';
 type Plan = {
   resource: 'plan';
+  id: string;
   sku: string;
   name: TranslatableValue;
   description: Partial<Record<WarpLocale, string>>;
@@ -759,6 +787,11 @@ type Cart = {
   couponDiscount: number;
 };
 type CouponCondition = 'none' | 'onetime-use' | 'previous-purchase';
+type CouponRestrictedItemType = 'product' | 'service';
+type CouponRestrictedItem = {
+  type: CouponRestrictedItemType;
+  ref: string;
+};
 type Coupon = {
   id: string;
   code: string;
@@ -767,6 +800,7 @@ type Coupon = {
   percent: number | null;
   price: number | null;
   condition: CouponCondition;
+  restrictedItems: CouponRestrictedItem[];
   usesLeft: number | null;
   expiresAt: string | null;
   active: boolean;
@@ -1034,6 +1068,12 @@ type WarpExtras = {
     enabled?: boolean;
     contact?: string | null;
   };
+  optIn?: {
+    enabled?: boolean;
+  };
+  results?: {
+    public?: boolean;
+  };
 };
 type WarpBackend = {
   hash: string;
@@ -1041,8 +1081,8 @@ type WarpBackend = {
   chain: WarpChainName | null;
   alias: string;
   name: string;
-  title: string;
-  description: string;
+  title: WarpText;
+  description: WarpText;
   preview: string | null;
   creator: string;
   status: WarpBackendStatus;
@@ -1232,6 +1272,7 @@ type StoreData = {
   items: StoreItem[];
 };
 type StorePriceTier = {
+  id: string;
   sku: string;
   priceCents: number;
   label: string;
@@ -1259,6 +1300,20 @@ type TeamEarningsBalance = {
   pendingCents: number;
   paidCents: number;
   totalCents: number;
+  availableCents: number;
+};
+type TeamPayout = {
+  id: number;
+  amount: number;
+  status: string;
+  tx: string | null;
+  failureReason: string | null;
+  processedAt: string | null;
+  createdAt: string;
+};
+type TeamPayoutAddress = {
+  payoutAddress: string | null;
+  payoutChain: string | null;
 };
 type CommissionAgreement = {
   id: number;
@@ -1437,7 +1492,13 @@ type AppointmentAvailability = {
   service: AppointmentAvailabilityService | null;
   slots: AppointmentAvailabilitySlot[];
 };
+type AppointmentPolicySync = {
+  enabled: boolean;
+  lastSyncedAt?: string | null;
+  lastSyncError?: string | null;
+};
 type AppointmentPolicy = {
+  active: boolean;
   timezone: string | null;
   availability: Record<string, {
     start: string;
@@ -1453,7 +1514,9 @@ type AppointmentPolicy = {
   serviceSelectionEnabled?: boolean | null;
   paymentEnabled?: boolean | null;
   requireApproval?: boolean | null;
+  sync?: AppointmentPolicySync | null;
   agent?: Agent | null;
+  agentUuid?: string | null;
 };
 type AppointmentBooking = {
   id: string;
@@ -2011,11 +2074,8 @@ type NotificationAction = {
 };
 type NotificationSetting = {
   identifier: string;
-  name: string;
-  description: string;
   channels: {
     identifier: NotificationChannel;
-    name: string;
     isEnabled: boolean;
   }[];
 }; //#endregion
@@ -2461,7 +2521,7 @@ type LoyaltyMember = {
   updatedAt: string;
 }; //#endregion
 //#region src/segment/types.d.ts
-type SegmentConditionType = 'tag' | 'has_email' | 'has_phone' | 'has_user' | 'last_purchase_after' | 'last_purchase_before' | 'total_order_amount' | 'order_count_at_least' | 'never_purchased' | 'avg_order_value_at_least' | 'last_contact_after' | 'last_contact_before' | 'created_after' | 'created_before' | 'email_contains';
+type SegmentConditionType = 'tag' | 'has_email' | 'has_phone' | 'has_user' | 'last_purchase_after' | 'last_purchase_before' | 'total_order_amount' | 'order_count_at_least' | 'never_purchased' | 'avg_order_value_at_least' | 'last_contact_after' | 'last_contact_before' | 'waiting_on' | 'created_after' | 'created_before' | 'email_contains';
 type SegmentCondition = {
   type: SegmentConditionType;
   value: string | boolean;
@@ -2493,13 +2553,23 @@ type SegmentCountResult = {
 }; //#endregion
 //#region src/campaign/types.d.ts
 type CampaignChannel = 'email' | 'whatsapp' | 'sms' | 'push';
-type CampaignStatus = 'draft' | 'sending' | 'completed' | 'failed';
+type CampaignStatus = 'draft' | 'pending' | 'approved' | 'rejected' | 'sending' | 'completed' | 'failed';
+type CampaignCategory = 'MARKETING' | 'UTILITY' | 'AUTHENTICATION';
+type CampaignApproval = {
+  language: string | null;
+  category: CampaignCategory | null;
+  placeholders: string[];
+  templateParams: Record<string, string>;
+  externalStatus: string | null;
+  rejectionReason: string | null;
+};
 type Campaign = {
   id: string;
   name: string;
   channel: CampaignChannel;
   subject: string | null;
   content: string;
+  approval: CampaignApproval;
   tags: string[];
   status: CampaignStatus;
   totalCount: number;
@@ -2515,8 +2585,20 @@ type CampaignCreatePayload = {
   channel: CampaignChannel;
   subject?: string;
   content: string;
+  language?: string;
+  category?: CampaignCategory;
+  templateParams?: Record<string, string>;
   tags?: string[];
   contactIds?: string[];
+  segmentId?: string;
+};
+type CampaignUpdatePayload = {
+  name: string;
+  subject?: string;
+  content: string;
+  language?: string;
+  category?: CampaignCategory;
+  templateParams?: Record<string, string>;
 };
 type CampaignStats = {
   totalCampaigns: number;
@@ -2547,7 +2629,7 @@ type UpdateCreatePayload = {
   type: UpdateType;
   body?: string;
   imageUrl?: string;
-  media?: MediaLibraryItems;
+  media?: string[];
   linkUrl?: string;
   startsAt?: string;
   endsAt?: string;
@@ -2730,7 +2812,7 @@ declare class AgentsResource {
       trainingUrl?: string | null;
     };
   }): Promise<IAppResponse<AgentPrivate>>;
-  update(uuid: string, name: string, description: string | null, avatar?: MediaLibraryItems): Promise<IAppResponse<AgentPrivate>>;
+  update(uuid: string, name: string, description: string | null, avatar?: string[]): Promise<IAppResponse<AgentPrivate>>;
   delete(uuid: string): Promise<IAppResponse<void>>;
   updatePassword(uuid: string, password: string): Promise<IAppResponse<void>>;
   storePassword(uuid: string, password: string): Promise<IAppResponse<AgentPrivate>>;
@@ -2817,14 +2899,14 @@ declare class ElementsResource {
     type: string;
     description?: string | null;
     spec?: ElementSpec | null;
-    media?: any[];
+    media?: string[];
   }): Promise<IAppResponse<Element>>;
   update(team: string, elementId: string, payload: {
     name?: string;
     type?: string;
     description?: string | null;
     spec?: ElementSpec | null;
-    media?: any[];
+    media?: string[];
   }): Promise<IAppResponse<Element>>;
   delete(team: string, elementId: string): Promise<IAppResponse<void>>;
   generateVariation(team: string, elementId: string, payload?: {
@@ -2903,7 +2985,7 @@ declare class AppointmentsResource {
   private readonly http;
   private readonly config;
   constructor(http: IHttpService, config: JoAiClientConfig);
-  getPolicy(): Promise<IAppResponse<AppointmentPolicy>>;
+  getPolicy(): Promise<IAppResponse<AppointmentPolicy | null>>;
   upsertPolicy(data: Partial<AppointmentPolicy>): Promise<IAppResponse<AppointmentPolicy>>;
   checkAvailability(agentUuid: string, params: {
     windowStart: string;
@@ -3029,12 +3111,12 @@ declare class BillingResource {
   plans(type?: 'current' | 'all'): Promise<IAppResponse<Plan[]>>;
   checkoutProduct(id: string): Promise<IAppResponse<Product>>;
   orders(team: TeamPrivate | null, page?: number, contactId?: string): Promise<IAppResponse<Order[]>>;
-  payOrder(id: string, provider: string): Promise<IAppResponse<{
+  payOrder(id: string, provider?: PaymentProvider): Promise<IAppResponse<{
     url: string;
   }>>;
   deleteOrder(id: string): Promise<IAppResponse<void>>;
-  paymentAccount(team: string, provider: string): Promise<IAppResponse<PaymentAccount>>;
-  createPaymentAccountOnboarding(team: string, provider: string): Promise<IAppResponse<PaymentAccountOnboarding>>;
+  paymentAccount(team: string, provider: PaymentProvider): Promise<IAppResponse<PaymentAccount>>;
+  createPaymentAccountOnboarding(team: string, provider: PaymentProvider): Promise<IAppResponse<PaymentAccountOnboarding>>;
   updatePaymentAccount(team: string, provider: string, input: {
     providerAccountId: string;
     chargesEnabled?: boolean;
@@ -3088,12 +3170,16 @@ declare class CardsResource {
 declare class CartsResource {
   private readonly http;
   constructor(http: IHttpService);
-  get(): Promise<IAppResponse<Cart>>;
-  add(type: 'product' | 'service' | 'coupon', id: string, quantity?: number, configuration?: Configuration): Promise<IAppResponse<Cart>>;
+  get(provider?: string): Promise<IAppResponse<Cart>>;
+  add(type: 'product' | 'service' | 'coupon', id: string, quantity?: number, options?: {
+    fresh?: boolean;
+    configuration?: Configuration;
+  }): Promise<IAppResponse<Cart>>;
   remove(type: 'product' | 'service' | 'coupon', id: string): Promise<IAppResponse<Cart>>;
   updateQuantity(type: 'product' | 'service' | 'coupon', id: string, quantity: number): Promise<IAppResponse<Cart>>;
   clear(): Promise<IAppResponse<Cart>>;
   applyCoupon(code: string): Promise<IAppResponse<void>>;
+  removeCoupon(): Promise<IAppResponse<void>>;
 }
 //#endregion
 //#region src/resources/coupons.d.ts
@@ -3106,9 +3192,10 @@ type CouponPayload = {
   active?: boolean;
   public?: boolean;
   condition?: CouponCondition;
+  restrictedItems?: CouponRestrictedItem[] | null;
   usesLeft?: number | null;
   expiresAt?: string | null;
-  media?: MediaLibraryAttributes[];
+  media?: string[];
 };
 declare class CouponsResource {
   private readonly http;
@@ -3116,6 +3203,7 @@ declare class CouponsResource {
   list(team: string, options?: {
     public?: boolean;
   }): Promise<IAppResponse<Coupon[]>>;
+  get(id: string): Promise<IAppResponse<Coupon>>;
   create(team: string, data: CouponPayload): Promise<IAppResponse<Coupon>>;
   update(id: string, data: Partial<CouponPayload> & {
     clearExpiry?: boolean;
@@ -3139,6 +3227,8 @@ declare class ContactsResource {
     search?: string;
     page?: number;
     staleDays?: number;
+    waitingOn?: boolean;
+    overdue?: boolean;
   }): Promise<IAppResponse<Contact[]>>;
   get(id: string): Promise<IAppResponse<Contact>>;
   create(payload: ContactCreatePayload): Promise<IAppResponse<Contact>>;
@@ -3215,7 +3305,7 @@ declare class DocumentsResource {
   }): Promise<IAppResponse<Document>>;
   delete(id: string): Promise<IAppResponse<void>>;
   trainFromUrl(agent: string, url: string): Promise<IAppResponse<Document>>;
-  uploadFile(agentUuid: string, name: string, document: MediaLibraryItems): Promise<IAppResponse<Document>>;
+  uploadFile(agentUuid: string, name: string, document: string[]): Promise<IAppResponse<Document>>;
 }
 //#endregion
 //#region src/resources/flows.d.ts
@@ -3489,6 +3579,10 @@ declare class StoreResource {
   get(locale?: string): Promise<StoreData>;
   earnings(teamSlug: string, page?: number): Promise<IAppResponse<TeamEarning[]>>;
   earningsBalance(teamSlug: string): Promise<IAppResponse<TeamEarningsBalance>>;
+  payouts(teamSlug: string, page?: number): Promise<IAppResponse<TeamPayout[]>>;
+  requestPayout(teamSlug: string): Promise<IAppResponse<TeamPayout>>;
+  payoutAddress(teamSlug: string): Promise<IAppResponse<TeamPayoutAddress>>;
+  updatePayoutAddress(teamSlug: string, address: string, chain?: string): Promise<IAppResponse<void>>;
   commissions(teamSlug: string): Promise<IAppResponse<CommissionAgreement[]>>;
   priceTiers(): Promise<IAppResponse<StorePriceTier[]>>;
   purchase(entityType: string, entityId: string, paymentMethod?: string): Promise<IAppResponse<StorePurchaseResult>>;
@@ -3496,6 +3590,10 @@ declare class StoreResource {
 //#endregion
 //#region src/resources/media.d.ts
 type MediaUploadType = 'brand' | 'reference' | 'template' | 'output';
+type AttachedMedia = {
+  id: string;
+  custom_properties?: Record<string, unknown> | null;
+};
 declare class MediaResource {
   private readonly http;
   constructor(http: IHttpService);
@@ -3506,26 +3604,29 @@ declare class MediaResource {
   }): Promise<IAppResponse<Media[]>>;
   upload(data: {
     team: string;
-    file: File;
+    file?: File;
+    fileUrl?: string;
+    fileName?: string;
+    mimeType?: string;
     type: MediaUploadType;
+    aspect?: MediaAspectRatio;
     label?: string;
     tags?: string[];
     copyright?: string;
   }): Promise<IAppResponse<Media>>;
-  listTeam(team: string, params?: {
+  list(team: string, params?: {
     page?: number;
     mime?: string;
   }): Promise<IAppResponse<Media[]>>;
-  uploadTeam(team: string, media: MediaLibraryItems, tags?: string[], options?: {
-    preserveOriginal?: boolean;
-    copyright?: string;
-  }): Promise<IAppResponse<Media[]>>;
-  deleteTeam(team: string, mediaId: string): Promise<IAppResponse<void>>;
-  updateTeamMedia(team: string, mediaId: string, data: {
+  get(team: string, mediaId: string): Promise<IAppResponse<Media>>;
+  delete(team: string, mediaId: string): Promise<IAppResponse<void>>;
+  update(team: string, mediaId: string, data: {
     name: string;
     copyright?: string | null;
   }): Promise<IAppResponse<Media>>;
-  updateTeamMediaTags(team: string, mediaId: string, tags: string[]): Promise<IAppResponse<Media>>;
+  updateTags(team: string, mediaId: string, tags: string[]): Promise<IAppResponse<Media>>;
+  /** Download the stored bytes of a media item as a File (used to re-edit existing images). */
+  download(team: string, mediaId: string, name: string, mime: string): Promise<File>;
 }
 //#endregion
 //#region src/resources/meetings.d.ts
@@ -3691,7 +3792,7 @@ declare class ProductsResource {
     active?: boolean;
     public?: boolean;
     virtual?: boolean;
-    media?: MediaLibraryAttributes[];
+    media?: string[];
   }): Promise<IAppResponse<Product>>;
   delete(id: string): Promise<IAppResponse<void>>;
   createVariation(productSlug: string, data: {
@@ -3707,8 +3808,8 @@ declare class ProductsResource {
     hidden?: boolean;
     type?: string;
     settings?: Record<string, unknown> | null;
-    media?: MediaLibraryAttributes[];
-    preview?: MediaLibraryAttributes[];
+    media?: string[];
+    preview?: string[];
     stock?: number | null;
     weight?: number | null;
   }): Promise<IAppResponse<ProductVariation>>;
@@ -3873,13 +3974,13 @@ declare class SkillsResource {
     license?: string;
     compatibility?: string;
     allowedTools?: string;
-    media?: MediaLibraryItems;
+    media?: AttachedMedia[];
     active?: boolean;
     isPublic?: boolean;
     price?: number;
   }): Promise<IAppResponse<Skill>>;
   update(id: string, data: Partial<Omit<Skill, 'media' | 'store'>> & {
-    media?: MediaLibraryItems;
+    media?: AttachedMedia[];
     public?: boolean;
     price?: number;
   }): Promise<IAppResponse<Skill>>;
@@ -3941,7 +4042,7 @@ declare class SwarmsResource {
   constructor(http: IHttpService);
   listSwarms(team: string): Promise<IAppResponse<Swarm[]>>;
   listAgents(swarm: string): Promise<IAppResponse<Agent[]>>;
-  storeProposal(agent: string, swarm: string, title: string, description: string, actions: ProposalAction[], attachments: MediaLibraryItems, poll: ProposalPollOption[]): Promise<IAppResponse<Proposal>>;
+  storeProposal(agent: string, swarm: string, title: string, description: string, actions: ProposalAction[], attachments: string[], poll: ProposalPollOption[]): Promise<IAppResponse<Proposal>>;
   finalizeProposal(swarm: string, txHash: string, proposal: string): Promise<IAppResponse<void>>;
   finalizeSignature(swarm: string, txHash: string, proposal: string): Promise<IAppResponse<void>>;
   finalizeExecution(chain: WarpChainName, txHash: string, actions?: ProposalAction[]): Promise<IAppResponse<void>>;
@@ -4020,9 +4121,15 @@ declare class TeamsResource {
   inviteMember(teamSlug: string, email: string, role: UserRole): Promise<IAppResponse<void>>;
   removeMember(teamSlug: string, memberId: string): Promise<IAppResponse<void>>;
   listMembers(teamSlug: string): Promise<IAppResponse<TeamMember[]>>;
-  updateLogo(teamSlug: string, logo: MediaLibraryItems): Promise<IAppResponse<TeamPrivate>>;
-  updateCover(teamSlug: string, cover: MediaLibraryItems): Promise<IAppResponse<TeamPrivate>>;
+  updateLogo(teamSlug: string, logo: string[]): Promise<IAppResponse<TeamPrivate>>;
+  updateCover(teamSlug: string, cover: string[]): Promise<IAppResponse<TeamPrivate>>;
   updateSetting(teamSlug: string, key: string, value: boolean | string | number | object | null): Promise<IAppResponse<TeamPrivate>>;
+  searchPlaces(teamSlug: string, query: string, options?: {
+    language?: string;
+    region?: string;
+    limit?: number;
+  }): Promise<IAppResponse<TeamPlace[]>>;
+  selectPlace(teamSlug: string, sourceId: string | null): Promise<IAppResponse<TeamPrivate>>;
   listPrivate(): Promise<IAppResponse<TeamPrivate[]>>;
   getInviteByToken(token: string): Promise<IAppResponse<TeamInviteInfo>>;
   acceptInvite(slug: string): Promise<IAppResponse<void>>;
@@ -4040,6 +4147,9 @@ declare class CampaignsResource {
   list(): Promise<IAppResponse<Campaign[]>>;
   get(id: string): Promise<IAppResponse<Campaign>>;
   create(payload: CampaignCreatePayload): Promise<IAppResponse<Campaign>>;
+  update(id: string, payload: CampaignUpdatePayload): Promise<IAppResponse<Campaign>>;
+  submitForApproval(id: string): Promise<IAppResponse<Campaign>>;
+  refreshApproval(id: string): Promise<IAppResponse<Campaign>>;
   send(id: string): Promise<IAppResponse<Campaign>>;
   delete(id: string): Promise<IAppResponse<void>>;
 }
@@ -4099,13 +4209,9 @@ declare class UsersResource {
   updateEmail(email: string): Promise<IAppResponse<UserPrivate>>;
   resendEmailVerification(): Promise<IAppResponse<UserPrivate>>;
   deleteMe(): Promise<IAppResponse<void>>;
-  updatePayoutAddress(address: string, chain?: string): Promise<IAppResponse<void>>;
   getAffiliate(code: string): Promise<IAppResponse<Affiliate>>;
   getAffiliateTiers(): Promise<IAppResponse<AffiliateTier[]>>;
   storeAffiliate(name: string, email: string, application: string): Promise<IAppResponse<void>>;
-  getEarnings(page: number): Promise<IAppResponse<Earning[]>>;
-  getPayouts(page: number): Promise<IAppResponse<PayoutEntry[]>>;
-  requestPayout(): Promise<IAppResponse<PayoutEntry>>;
 }
 //#endregion
 //#region src/resources/voice.d.ts
@@ -4170,6 +4276,12 @@ type BackendWarp = {
   agent?: AgentPrivate | null;
   link?: Link | null;
 };
+type WarpExecutionContext<C extends Record<string, unknown> = Record<string, never>> = {
+  locale?: string;
+  sourceUrl?: string;
+  ipAddress?: string;
+  userAgent?: string;
+} & C;
 declare class WarpsResource {
   private readonly http;
   constructor(http: IHttpService);
@@ -4194,6 +4306,7 @@ declare class WarpsResource {
     form?: boolean;
     store?: boolean;
     agent?: string | null;
+    optIn?: boolean | null;
   }): Promise<IAppResponse<BackendWarpCreateResponse>>;
   update(identifier: string, data: {
     name?: string;
@@ -4205,10 +4318,12 @@ declare class WarpsResource {
     store?: boolean;
     agent?: string | null;
     public?: boolean;
+    optIn?: boolean | null;
   }): Promise<IAppResponse<BackendWarpUpdateResponse>>;
   destroy(identifier: string): Promise<IAppResponse<void>>;
-  execute(identifier: string, inputs: string[], room?: string): Promise<IAppResponse<JsonValue>>;
+  execute<C extends Record<string, unknown> = Record<string, never>>(identifier: string, inputs: string[], room?: string, context?: WarpExecutionContext<C>): Promise<IAppResponse<JsonValue>>;
   executions(identifier: string, page?: number, perPage?: number): Promise<IAppResponse<WarpExecutionBackend[]>>;
+  results(identifier: string, page?: number, perPage?: number): Promise<IAppResponse<WarpExecutionBackend[]>>;
   ensureLink(identifier: string): Promise<IAppResponse<Link>>;
   install(identifier: string): Promise<IAppResponse<{
     identifier: string;
@@ -4239,7 +4354,7 @@ declare class WarpsResource {
     name?: string;
     description?: string;
     public?: boolean;
-    logo?: MediaLibraryItems | null;
+    logo?: string[] | null;
     source?: BrandSourceConfig | null;
   }): Promise<IAppResponse<BrandBackend>>;
   deleteTeamBrand(teamSlug: string, brandSlug: string): Promise<IAppResponse<void>>;
@@ -4313,6 +4428,7 @@ interface JoAiClientConfig {
   env?: AppEnv;
   agentAuthKey?: string;
   cache?: CacheConfig;
+  buildSecret?: string;
 }
 declare class JoAiClient {
   readonly http: IHttpService;
@@ -4423,4 +4539,4 @@ declare class DistributionResource {
   private fetchDistribution;
 }
 //#endregion
-export { AgentsResource, AlertsResource, ApiTokensResource, AppointmentsResource, AuthResource, type AuthSendCodeRequest, type AuthVerifyResponse, type BackendWarp, type BackendWarpBrand, BillingAddressesResource, BillingResource, BlueprintsResource, type CacheConfig, CachedHttpService, CampaignsResource, CardsResource, CartsResource, ChangelogResource, CharactersResource, ContactsResource, ContractsResource, DeskResource, DistributionResource, DocumentsResource, ElementsResource, EntitiesResource, FlowsResource, GoalsResource, IngestionsResource, InquiriesResource, IntegrationsResource, IntentsResource, ItemsResource, JoAiClient, type JoAiClientConfig, KvResource, LinksResource, LoyaltyResource, McpResource, MeetingsResource, MemoriesResource, MessagesResource, MissionsResource, NotificationsResource, OfficeResource, type OpeningHoursEntry, type OpeningHoursFormatOptions, OrdersResource, PersonaResource, type Product, type ProductVariation, ProductsResource, ProjectsResource, RemindersResource, SegmentsResource, ServicesResource, ShortcutsResource, SitesResource, SkillsResource, StatsResource, StoreResource, SubscriptionsResource, SwarmsResource, TagsResource, TasksResource, type TeamInviteInfo, TeamsResource, UpdatesResource, UpgradesResource, UsersResource, VoiceResource, WalletsResource, WarpsResource, WebhooksResource, WorkspaceResource, createClient, formatOpeningHours };
+export { AgentsResource, AlertsResource, ApiTokensResource, AppointmentsResource, type AttachedMedia, AuthResource, type AuthSendCodeRequest, type AuthVerifyResponse, type BackendWarp, type BackendWarpBrand, BillingAddressesResource, BillingResource, BlueprintsResource, type CacheConfig, CachedHttpService, CampaignsResource, CardsResource, CartsResource, ChangelogResource, CharactersResource, ContactsResource, ContractsResource, DeskResource, DistributionResource, DocumentsResource, ElementsResource, EntitiesResource, FlowsResource, GoalsResource, IngestionsResource, InquiriesResource, IntegrationsResource, IntentsResource, ItemsResource, JoAiClient, type JoAiClientConfig, KvResource, LinksResource, LoyaltyResource, McpResource, type MediaUploadType, MeetingsResource, MemoriesResource, MessagesResource, MissionsResource, NotificationsResource, OfficeResource, type OpeningHoursEntry, type OpeningHoursFormatOptions, OrdersResource, PersonaResource, type Product, type ProductVariation, ProductsResource, ProjectsResource, RemindersResource, SegmentsResource, ServicesResource, ShortcutsResource, SitesResource, SkillsResource, StatsResource, StoreResource, SubscriptionsResource, SwarmsResource, TagsResource, TasksResource, type TeamInviteInfo, TeamsResource, UpdatesResource, UpgradesResource, UsersResource, VoiceResource, WalletsResource, WarpsResource, WebhooksResource, WorkspaceResource, createClient, formatOpeningHours };

package/dist/index.mjs

@@ -548,7 +548,7 @@ var BillingResource = class {
 		return this.http.get(params);
 	}
 	payOrder(id, provider) {
-		return this.http.post(`orders/${id}/pay`, { provider });
+		return this.http.post(`orders/${id}/pay`, provider ? { provider } : {});
 	}
 	deleteOrder(id) {
 		return this.http.delete(`orders/${id}`);
@@ -660,15 +660,15 @@ var CartsResource = class {
 	constructor(http) {
 		this.http = http;
 	}
-	get() {
-		return this.http.get("cart");
+	get(provider) {
+		return this.http.get(provider ? `cart?provider=${provider}` : "cart");
 	}
-	add(type, id, quantity = 1, configuration) {
+	add(type, id, quantity = 1, options) {
 		return this.http.post("cart/add", {
 			id,
 			type,
 			quantity,
-			configuration
+			...options
 		});
 	}
 	remove(type, id) {
@@ -690,6 +690,9 @@ var CartsResource = class {
 	applyCoupon(code) {
 		return this.http.post("cart/coupon", { code });
 	}
+	removeCoupon() {
+		return this.http.post("cart/coupon/remove");
+	}
 };
 //#endregion
 //#region src/resources/coupons.ts
@@ -701,6 +704,9 @@ var CouponsResource = class {
 		const qs = options?.public ? `?team=${encodeURIComponent(team)}` : "";
 		return this.http.get(`coupons${qs}`, options?.public ? {} : { headers: { "X-Team": team } });
 	}
+	get(id) {
+		return this.http.get(`coupons/${id}`);
+	}
 	create(team, data) {
 		return this.http.post("coupons", data, { headers: { "X-Team": team } });
 	}
@@ -735,6 +741,8 @@ var ContactsResource = class {
 		if (params?.search) query.set("filter[search]", params.search);
 		if (params?.page) query.set("page", String(params.page));
 		if (params?.staleDays) query.set("filter[stale_days]", String(params.staleDays));
+		if (params?.waitingOn) query.set("filter[waiting_on]", "1");
+		if (params?.overdue) query.set("filter[followup_overdue]", "1");
 		const qs = query.toString();
 		return this.http.get(`contacts${qs ? "?" + qs : ""}`);
 	}
@@ -1274,6 +1282,22 @@ var StoreResource = class {
 	earningsBalance(teamSlug) {
 		return this.http.get(`earnings/balance?team=${teamSlug}`);
 	}
+	payouts(teamSlug, page = 1) {
+		return this.http.get(`payouts?team=${teamSlug}&page=${page}`);
+	}
+	requestPayout(teamSlug) {
+		return this.http.post("payouts", { team: teamSlug });
+	}
+	payoutAddress(teamSlug) {
+		return this.http.get(`payouts/payout-address?team=${teamSlug}`);
+	}
+	updatePayoutAddress(teamSlug, address, chain) {
+		return this.http.put("payouts/payout-address", {
+			team: teamSlug,
+			payoutAddress: address,
+			payoutChain: chain
+		});
+	}
 	commissions(teamSlug) {
 		return this.http.get(`billing/commissions?team=${encodeURIComponent(teamSlug)}`);
 	}
@@ -1303,36 +1327,55 @@ var MediaResource = class {
 		return this.http.get(`media/public${qs ? "?" + qs : ""}`);
 	}
 	upload(data) {
-		const formData = new FormData();
-		formData.append("file", data.file, data.file.name);
-		formData.append("type", data.type);
-		if (data.label) formData.append("label", data.label);
-		if (data.tags) data.tags.forEach((t) => formData.append("tags[]", t));
-		if (data.copyright) formData.append("copyright", data.copyright);
-		return this.http.post("media", formData, { headers: { "X-Team": data.team } });
-	}
-	listTeam(team, params) {
+		const { team, file, fileUrl, fileName, mimeType, type, aspect, label, tags, copyright } = data;
+		if (file) {
+			const formData = new FormData();
+			formData.append("file", file, file.name);
+			formData.append("type", type);
+			if (aspect) formData.append("aspect", aspect);
+			if (label) formData.append("label", label);
+			if (tags) tags.forEach((t) => formData.append("tags[]", t));
+			if (copyright) formData.append("copyright", copyright);
+			return this.http.post("media", formData, { headers: { "X-Team": team } });
+		}
+		return this.http.post("media", {
+			fileUrl,
+			fileName,
+			mimeType,
+			type,
+			aspect,
+			label,
+			tags,
+			copyright
+		}, { headers: { "X-Team": team } });
+	}
+	list(team, params) {
 		const query = new URLSearchParams();
 		query.set("page", String(params?.page ?? 1));
 		if (params?.mime) query.set("mime", params.mime);
-		return this.http.get(`teams/${team}/media?${query.toString()}`);
+		return this.http.get(`media?${query.toString()}`, { headers: { "X-Team": team } });
 	}
-	uploadTeam(team, media, tags, options) {
-		return this.http.post(`teams/${team}/media/upload`, {
-			media,
-			tags,
-			preserveOriginal: options?.preserveOriginal,
-			copyright: options?.copyright
-		});
+	get(team, mediaId) {
+		return this.http.get(`media/${mediaId}`, { headers: { "X-Team": team } });
+	}
+	delete(team, mediaId) {
+		return this.http.delete(`media/${mediaId}`, { headers: { "X-Team": team } });
 	}
-	deleteTeam(team, mediaId) {
-		return this.http.delete(`teams/${team}/media/${mediaId}`);
+	update(team, mediaId, data) {
+		return this.http.put(`media/${mediaId}`, data, { headers: { "X-Team": team } });
 	}
-	updateTeamMedia(team, mediaId, data) {
-		return this.http.put(`teams/${team}/media/${mediaId}`, data);
+	updateTags(team, mediaId, tags) {
+		return this.http.put(`media/${mediaId}/tags`, { tags }, { headers: { "X-Team": team } });
 	}
-	updateTeamMediaTags(team, mediaId, tags) {
-		return this.http.put(`teams/${team}/media/${mediaId}/tags`, { tags });
+	/** Download the stored bytes of a media item as a File (used to re-edit existing images). */
+	async download(team, mediaId, name, mime) {
+		const url = `${this.http.baseUrl}/media/${mediaId}/download`;
+		const headers = { "X-Team": team };
+		if (this.http.authToken) headers["Authorization"] = `Bearer ${this.http.authToken}`;
+		const res = await fetch(url, { headers });
+		if (!res.ok) throw new Error(`Failed to download media (${res.status})`);
+		const blob = await res.blob();
+		return new File([blob], name, { type: mime });
 	}
 };
 //#endregion
@@ -2015,6 +2058,16 @@ var TeamsResource = class {
 	updateSetting(teamSlug, key, value) {
 		return this.http.put(`teams/${teamSlug}/settings/${key}`, { value });
 	}
+	searchPlaces(teamSlug, query, options) {
+		const params = new URLSearchParams({ query });
+		if (options?.language) params.set("language", options.language);
+		if (options?.region) params.set("region", options.region);
+		if (options?.limit) params.set("limit", String(options.limit));
+		return this.http.get(`teams/${teamSlug}/places?${params}`);
+	}
+	selectPlace(teamSlug, sourceId) {
+		return this.http.put(`teams/${teamSlug}/place`, { sourceId });
+	}
 	listPrivate() {
 		return this.http.get("teams?me=true");
 	}
@@ -2055,6 +2108,15 @@ var CampaignsResource = class {
 	create(payload) {
 		return this.http.post("campaigns", payload);
 	}
+	update(id, payload) {
+		return this.http.put(`campaigns/${id}`, payload);
+	}
+	submitForApproval(id) {
+		return this.http.post(`campaigns/${id}/submit`);
+	}
+	refreshApproval(id) {
+		return this.http.post(`campaigns/${id}/refresh`);
+	}
 	send(id) {
 		return this.http.post(`campaigns/${id}/send`);
 	}
@@ -2178,12 +2240,6 @@ var UsersResource = class {
 	deleteMe() {
 		return this.http.post("me/request-delete");
 	}
-	updatePayoutAddress(address, chain) {
-		return this.http.put("me/payout-address", {
-			payoutAddress: address,
-			payoutChain: chain
-		});
-	}
 	getAffiliate(code) {
 		return this.http.get(`affiliates/${code}`);
 	}
@@ -2197,15 +2253,6 @@ var UsersResource = class {
 			application
 		});
 	}
-	getEarnings(page) {
-		return this.http.get(`earnings?page=${page}`);
-	}
-	getPayouts(page) {
-		return this.http.get(`payouts?page=${page}`);
-	}
-	requestPayout() {
-		return this.http.post("payouts");
-	}
 };
 //#endregion
 //#region src/resources/voice.ts
@@ -2327,15 +2374,19 @@ var WarpsResource = class {
 	destroy(identifier) {
 		return this.http.delete(`warps/${identifier}`);
 	}
-	execute(identifier, inputs, room) {
+	execute(identifier, inputs, room, context) {
 		return this.http.post(`warps/${identifier}/execute`, {
 			inputs,
-			...room ? { room } : {}
+			...room ? { room } : {},
+			...context ? { context } : {}
 		});
 	}
 	executions(identifier, page = 1, perPage = 20) {
 		return this.http.get(`warps/${identifier}/executions?page=${page}&perPage=${perPage}`);
 	}
+	results(identifier, page = 1, perPage = 50) {
+		return this.http.get(`warps/${identifier}/results?page=${page}&perPage=${perPage}`);
+	}
 	ensureLink(identifier) {
 		return this.http.post(`warps/${identifier}/link`, {});
 	}
@@ -2568,6 +2619,7 @@ var JoAiClient = class {
 		const headers = {};
 		if (config.team) headers["X-Team"] = config.team;
 		if (config.agentAuthKey) headers["X-Agent-Auth-Key"] = config.agentAuthKey;
+		if (config.buildSecret) headers["X-Build-Secret"] = config.buildSecret;
 		const http = new HttpService(`${apiBaseUrl}/v1`, void 0, config.apiToken, {
 			headers,
 			csrfBaseUrl: apiBaseUrl

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@joai/sdk",
-  "version": "1.4.1",
+  "version": "2.1.0",
   "description": "JoAi public API SDK — build with your AI agents",
   "license": "MIT",
   "type": "module",