@joai/sdk 2.0.0 → 2.1.0

package/dist/index.d.mts

@@ -271,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;
@@ -280,6 +295,7 @@ type Team = {
   description: TranslatableValue | null;
   locale: WarpLocale;
   timezone: string;
+  place?: TeamPlace | null;
   meta?: TeamMeta;
   features?: TeamFeature[];
   cover?: string | null;
@@ -315,6 +331,7 @@ type TeamPrivate = {
   balance: number;
   locale: WarpLocale;
   timezone: string;
+  place?: TeamPlace | null;
   logo: string | null;
   cover: string | null;
   subscription: {
@@ -409,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;
@@ -429,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 = {
@@ -463,6 +502,8 @@ type ContactFormData = {
   settings?: {
     marketingOptOut?: boolean;
   };
+  nextFollowUpAt?: string | null;
+  followUpNote?: string | null;
 };
 type ContactCreatePayload = ContactFormData & {
   name: string;
@@ -481,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;
@@ -1029,6 +1068,12 @@ type WarpExtras = {
     enabled?: boolean;
     contact?: string | null;
   };
+  optIn?: {
+    enabled?: boolean;
+  };
+  results?: {
+    public?: boolean;
+  };
 };
 type WarpBackend = {
   hash: string;
@@ -1447,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;
@@ -1463,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;
@@ -2021,11 +2074,8 @@ type NotificationAction = {
 };
 type NotificationSetting = {
   identifier: string;
-  name: string;
-  description: string;
   channels: {
     identifier: NotificationChannel;
-    name: string;
     isEnabled: boolean;
   }[];
 }; //#endregion
@@ -2471,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;
@@ -2579,7 +2629,7 @@ type UpdateCreatePayload = {
   type: UpdateType;
   body?: string;
   imageUrl?: string;
-  media?: MediaLibraryItems;
+  media?: string[];
   linkUrl?: string;
   startsAt?: string;
   endsAt?: string;
@@ -2762,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>>;
@@ -2849,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?: {
@@ -2935,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;
@@ -3061,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;
@@ -3145,7 +3195,7 @@ type CouponPayload = {
   restrictedItems?: CouponRestrictedItem[] | null;
   usesLeft?: number | null;
   expiresAt?: string | null;
-  media?: MediaLibraryAttributes[];
+  media?: string[];
 };
 declare class CouponsResource {
   private readonly http;
@@ -3177,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>>;
@@ -3253,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
@@ -3538,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);
@@ -3553,24 +3609,24 @@ declare class MediaResource {
     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
@@ -3736,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: {
@@ -3752,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>>;
@@ -3918,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>>;
@@ -3986,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>>;
@@ -4065,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>>;
@@ -4214,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);
@@ -4238,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;
@@ -4249,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;
@@ -4283,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>>;
@@ -4357,6 +4428,7 @@ interface JoAiClientConfig {
   env?: AppEnv;
   agentAuthKey?: string;
   cache?: CacheConfig;
+  buildSecret?: string;
 }
 declare class JoAiClient {
   readonly http: IHttpService;
@@ -4467,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}`);
@@ -741,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 : ""}`);
 	}
@@ -1325,11 +1327,12 @@ var MediaResource = class {
 		return this.http.get(`media/public${qs ? "?" + qs : ""}`);
 	}
 	upload(data) {
-		const { team, file, fileUrl, fileName, mimeType, type, label, tags, copyright } = data;
+		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);
@@ -1340,33 +1343,39 @@ var MediaResource = class {
 			fileName,
 			mimeType,
 			type,
+			aspect,
 			label,
 			tags,
 			copyright
 		}, { headers: { "X-Team": team } });
 	}
-	listTeam(team, params) {
+	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
@@ -2049,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");
 	}
@@ -2355,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`, {});
 	}
@@ -2596,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": "2.0.0",
+  "version": "2.1.0",
   "description": "JoAi public API SDK — build with your AI agents",
   "license": "MIT",
   "type": "module",