@joai/core 4.15.3 → 4.15.5

package/dist/index.d.mts

@@ -23,6 +23,7 @@ declare const getFormsBaseUrl: (env: AppEnv) => "http://forms.joai--api.test:300
 declare const getDigestBaseUrl: (env: AppEnv) => "http://localhost:3005" | "https://devnet-digests.joai.ai" | "https://testnet-digests.joai.ai" | "https://digests.joai.ai";
 declare const getStoreBaseUrl: (env: AppEnv) => "http://localhost:3005" | "https://devnet-store.joai.ai" | "https://testnet-store.joai.ai" | "https://store.joai.ai";
 declare const getAgentsBaseUrl: (env: AppEnv) => "http://localhost:3007" | "https://devnet-agents.joai.ai" | "https://testnet-agents.joai.ai" | "https://agents.joai.ai";
+declare const getGenBaseUrl: (env: AppEnv) => "http://localhost:3011" | "https://devnet-gen.joai.ai" | "https://testnet-gen.joai.ai" | "https://gen.joai.ai";
 declare const getMcpServerUrl: (env: AppEnv) => string;
 declare const getMcpServerAgentUrl: (env: AppEnv, agent: string) => string;
 declare const getSitesBaseUrl: (env: AppEnv) => "http://sites.joai--api.test:3007" | "https://devnet-sites.joai.ai" | "https://testnet-sites.joai.ai" | "https://sites.joai.ai";
@@ -316,12 +317,12 @@ type CheckoutSnapshotRequest = {
     type: 'product' | 'service' | 'coupon';
     quantity: number;
   }[];
-  billingAddressId?: number | null;
-  shippingAddressId?: number | null;
+  billingAddressId?: string | null;
+  shippingAddressId?: string | null;
   billingAddress?: AddressInput;
   shippingAddress?: AddressInput;
   shippingRateId?: number | null;
-  fulfillmentLocationId?: number | null;
+  fulfillmentLocationId?: string | null;
   couponCode?: string | null;
 };
 type ShippingZone = {
@@ -334,9 +335,9 @@ type ShippingZone = {
   rates: ShippingRate[];
 };
 type FulfillmentLocation = {
-  id: number;
+  id: string;
   name: string;
-  addressId: number | null;
+  addressId: string | null;
   address: Address | null;
   instructions: string | null;
   active: boolean;
@@ -489,8 +490,8 @@ type ContactCreatePayload = ContactFormData & {
   name: string;
   wallets?: WalletList;
 };
-type ContactRelationType = 'parent_of' | 'child_of' | 'spouse_of' | 'sibling_of' | 'aunt_of' | 'nibling_of' | 'manages' | 'reports_to' | 'colleague_of' | 'partner_of' | 'client_of' | 'supplier_of' | 'referred_by' | 'referred';
-type ContactRelationCategory = 'family' | 'organization' | 'business' | 'referral';
+type ContactRelationType = 'parent_of' | 'child_of' | 'spouse_of' | 'sibling_of' | 'aunt_of' | 'nibling_of' | 'friend_of' | 'manages' | 'reports_to' | 'colleague_of' | 'partner_of' | 'client_of' | 'supplier_of' | 'referred_by' | 'referred';
+type ContactRelationCategory = 'family' | 'social' | 'organization' | 'business' | 'referral';
 type ContactRelationDirection = 'outgoing' | 'incoming';
 type ContactRelationContact = {
   id: string;
@@ -552,6 +553,290 @@ type Media = {
   aiGenerated?: boolean;
 };
 //#endregion
+//#region src/integration/types.d.ts
+type IntegrationType = 'none' | 'webhook' | 'api-token' | 'telegram' | 'slack' | 'whatsapp' | 'whatsapp-personal' | 'twilio' | 'sms' | 'n8n' | 'apple-health' | 'mcp' | 'x' | 'xchat' | 'instagram' | 'facebook' | 'linkedin' | 'grok' | 'cloudflare' | 'email' | 'calendar' | 'embed' | 'discord' | 'github' | 'push' | 'sentry' | 'readwise';
+type IntegrationDetails = {
+  type: IntegrationType;
+  name: string;
+  description?: string;
+  logoUrl?: string;
+  logoUrlDark?: string;
+  slug?: string;
+  category?: string;
+  [key: string]: unknown;
+};
+type IntegrationMeta = {
+  handle?: string;
+  provider?: EmailProvider | null;
+  hookSource?: string;
+  [key: string]: unknown;
+};
+type IntegrationConnectionDetails = IntegrationDetails & {
+  phoneNumberId?: string;
+  phoneNumber?: string;
+  webhookUrl?: string;
+  webhookSecret?: string;
+  webhookSecretKey?: string;
+};
+type Integration = {
+  id: string;
+  type: IntegrationType;
+  name: string;
+  active: boolean;
+  configured: boolean;
+  createdAt: string;
+  meta?: IntegrationMeta;
+  details?: IntegrationConnectionDetails;
+};
+type SocialPlatform = 'telegram' | 'slack' | 'whatsapp' | 'sms' | 'discord' | 'github' | 'xchat' | 'instagram';
+type SocialBot = {
+  name: string;
+  createdAt: string;
+  phoneNumberId?: string;
+  phoneNumber?: string;
+  applicationId?: string;
+  appId?: string;
+  installationId?: string;
+  username?: string;
+};
+type XIntegrationStatus = {
+  enabled: boolean;
+  integrationId: string | null;
+  xAccountLinked: boolean;
+  currentAgentName: string | null;
+};
+type EmbedStatus = {
+  integrationId: string;
+  agentName: string;
+  agentAvatar: string | null;
+  active: boolean;
+  allowedDomains: string[];
+};
+type EmailProvider = 'resend' | 'mailgun' | 'sendgrid';
+type CalendarProvider = 'google' | 'apple' | 'microsoft';
+type CalendarStatus = {
+  connected: boolean;
+  provider?: CalendarProvider;
+  providerDisplayName?: string;
+  accountEmail?: string;
+  lastSynced?: string;
+  tokenHealthy?: boolean;
+  upcomingEvents?: {
+    title: string;
+    startAt: string;
+    endAt: string;
+    allDay: boolean;
+  }[];
+};
+//#endregion
+//#region src/agent/types.d.ts
+type AgentCharacter = {
+  name: string | null;
+  system: string | null;
+  bio: string | null;
+};
+type Agent = {
+  uuid: string;
+  name: string;
+  description: string;
+  avatar: string;
+  wallets: Wallet[];
+  settings: AgentSettings;
+  store: StoreInfo;
+  character?: AgentCharacter | null;
+  room: Room;
+  role: string | null;
+  blueprint: Blueprint | null;
+  team: string;
+};
+type AgentPrivate = {
+  uuid: string;
+  name: string;
+  description: string;
+  avatar: string;
+  wallets: Wallet[];
+  settings: AgentSettings;
+  store: StoreInfo;
+  password: string | null;
+  authKey: string | null;
+  secKey: string;
+  phoneNumber: string | null;
+  room: Room;
+  role: string | null;
+  blueprint: Blueprint | null;
+  justCreated?: boolean;
+  team: string;
+};
+type AgentActionHistoryEntry = {
+  id: string;
+  action: string | null;
+  outcome: 'succeeded' | 'failed';
+  outcomeDetail: string | null;
+  warpIdentifier: string | null;
+  meta: Record<string, unknown> | null;
+  createdAt: string | null;
+};
+type AgentSimple = {
+  uuid: string;
+  name: string;
+  avatar?: string | null;
+  authKey?: string | null;
+  team?: {
+    slug: string;
+  } | null;
+  settings?: Pick<AgentSettings, 'auto'>;
+};
+type AgentWalletMode = 'local' | 'cloud' | 'external';
+type AgentEngine = 'cortex' | 'openclaw';
+type AgentGender = 'male' | 'female' | 'neutral';
+type AgentTrustedActionRule = {
+  id: string;
+  hash: string;
+  match?: Record<string, string>;
+  identifier?: string;
+  title?: string;
+};
+type AgentSettings = {
+  auto: boolean;
+  'model.url': string;
+  'voice.output': boolean;
+  'voice.id': string | null;
+  'agent.gender'?: AgentGender;
+  'proactivity.enabled': boolean;
+  'proactivity.quietHoursStart'?: number;
+  'proactivity.quietHoursEnd'?: number;
+  'proactivity.maxMessagesPerDay'?: number;
+  'proactivity.timezone'?: string;
+  'proactivity.blockedBehaviors'?: string[];
+  engine: AgentEngine;
+  'training.url'?: string | null;
+  'training.status'?: 'idle' | 'training' | 'completed' | 'failed' | null;
+  'training.recrawlInterval'?: number | null;
+  'email_provider'?: EmailProvider | null;
+};
+type LocalAgentWallet = {
+  provider: WarpWalletProvider;
+  address: string;
+  mnemonic?: string | null;
+  privateKey?: string | null;
+};
+type AgentExecuteHandler = (prompt: string, options?: AgentExecuteOptions) => void;
+type AgentExecuteOptions = {
+  audio?: File;
+  sender?: string;
+  media?: Media[];
+  ghost?: boolean;
+  context?: Record<string, unknown>;
+};
+//#endregion
+//#region src/room/types.d.ts
+type RoomId = string;
+type RoomKind = 'default' | 'phone' | 'meeting';
+type Room = {
+  id: string;
+  name: string;
+  description: string | null;
+  public: boolean;
+  default: boolean;
+  active: boolean;
+  kind?: RoomKind | null;
+  archivedAt?: string | null;
+  secKey: string | null;
+  createdAt: string | null;
+  contactId?: string | null;
+  agent: AgentSimple;
+  integration: Integration | null;
+};
+//#endregion
+//#region src/meeting/types.d.ts
+type MeetingSessionState = 'idle' | 'listening' | 'ended';
+type TranscriptEntry = {
+  id: string;
+  text: string;
+  isFinal: boolean;
+  timestamp: number;
+  speakerId?: number;
+  speakerName?: string;
+};
+type BookmarkEntry = {
+  id: string;
+  timestamp: number;
+  transcriptEntryId: string;
+};
+type MeetingParticipant = {
+  name: string | null;
+  profileImageUrl: string | null;
+};
+type MeetingSpeakerAssignment = {
+  speakerId: number;
+  name: string;
+  contactId: string | null;
+};
+type Meeting = {
+  id: string;
+  code: string;
+  name: string | null;
+  room: Room | null;
+  inviteUrl: string;
+  status: MeetingStatus;
+  conferenceProvider: MeetingConferenceProvider | null;
+  conferenceUrl: string | null;
+  conferenceExternalId: string | null;
+  configuration?: Configuration;
+  captureMode: 'desktop_local' | null;
+  transcriptUrl: string | null;
+  summaryUrl: string | null;
+  participants?: MeetingParticipant[]; /** CRM contacts linked to an appointment booking, when available. */
+  contacts?: Contact[];
+  speakerAssignments?: MeetingSpeakerAssignment[] | null;
+  scheduledAt: string | null;
+  scheduledEndAt?: string | null;
+  timezone?: string | null;
+  calendarEventId: number | null;
+  startedAt: string | null;
+  endedAt: string | null;
+  createdAt: string;
+};
+type MeetingStatus = 'active' | 'completed' | 'analyzed' | 'scheduled' | 'cancelled';
+type MeetingConferenceProvider = 'google_meet' | 'teams' | 'zoom';
+type MeetingFeature = 'transcription' | 'summary' | 'insights' | 'actions';
+type MeetingJoinTeam = {
+  name: string;
+  logo: string | null;
+};
+type MeetingJoinInfo = {
+  id: string;
+  code: string;
+  name: string | null;
+  inviteUrl: string;
+  agentName: string;
+  team: MeetingJoinTeam;
+  status: MeetingStatus;
+  isPhysical: boolean;
+  scheduledAt: string | null;
+  scheduledEndAt: string | null;
+  timezone: string;
+  conferenceUrl: string | null;
+  conferenceProvider: MeetingConferenceProvider | null;
+  endedAt: string | null;
+  canCancel: boolean;
+  features: Record<MeetingFeature, boolean>;
+};
+type MeetingTranscriptEntry = {
+  speaker: 'user' | 'agent';
+  text: string;
+  timestamp: string;
+};
+type MeetingUsage = {
+  current: number;
+  limit: number;
+  reached: boolean;
+  remainingWords: number | null;
+};
+type MeetingSummary = {
+  content: string;
+};
+//#endregion
 //#region src/site/types.d.ts
 type SiteType = 'undefined' | 'shop';
 type SiteTeam = {
@@ -811,6 +1096,7 @@ declare const NativeApps: {
   readonly Artifacts: "artifacts";
   readonly Social: "social";
   readonly Studio: "studio";
+  readonly Loyalty: "loyalty";
 };
 type NativeApp = (typeof NativeApps)[keyof typeof NativeApps];
 declare const nativeAppSlugs: NativeApp[];
@@ -871,6 +1157,7 @@ type TeamMeta = {
   'payments.coupons'?: boolean;
   'kiosk.enabled'?: boolean;
   'stock.enabled'?: boolean;
+  'orders.notify_emails'?: string[];
   contactPropertyMaskWarp?: string;
   branding?: TeamBrand | null;
   settings: Record<string, unknown> & {
@@ -992,6 +1279,7 @@ type TeamSettings = {
   'payments.coupons'?: boolean;
   'kiosk.enabled'?: boolean;
   'stock.enabled'?: boolean;
+  'orders.notify_emails'?: string[];
   branding?: TeamBrand | null;
 };
 type TeamUsage = Partial<Record<PlanFeature, TeamFeatureUsage>> & {
@@ -1256,7 +1544,8 @@ type Product = {
   media?: Media[];
 };
 type OrderItem = {
-  id: string | null;
+  id: string | null; /** Database id of the order_items row — required for fulfillments/returns. */
+  orderItemId: number;
   name: string;
   quantity: number;
   unitPrice: number;
@@ -1282,6 +1571,7 @@ type Order = {
   status: OrderStatus;
   paymentUrl?: string | null;
   invoiceUrl: string | null;
+  deliveryNoteUrl: string | null;
   justCreated?: boolean;
   createdAt: string;
   invoiceDate: string;
@@ -1296,7 +1586,8 @@ type Order = {
   paymentMode: string | null;
   priceMode?: OrderPriceMode | null;
   linkVariationId: string | null;
-  notes: string | null;
+  notes: string | null; /** Linked pickup appointment when booked (canonical Meeting resource). */
+  meeting?: Meeting | null;
   site?: Site | null;
   fulfillmentMethod?: FulfillmentMethod | null;
   billingAddress?: AddressSnapshot | null;
@@ -1331,289 +1622,94 @@ type CartItem = {
   media: Media[];
   product?: Product | null;
 };
-type Cart = {
-  subtotal: number;
-  taxes: {
-    amount: number;
-    percent: number;
-  };
-  total: number;
-  items: CartItem[];
-  coupon: Coupon | null;
-  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;
-  name: TranslatableValue;
-  amount: number | null;
-  percent: number | null;
-  price: number | null;
-  discount?: number;
-  condition: CouponCondition;
-  restrictedItems: CouponRestrictedItem[];
-  usesLeft: number | null;
-  expiresAt: string | null;
-  active: boolean;
-  public: boolean;
-  sellable: boolean;
-  redemptionCount?: number;
-  media: Media[];
-};
-type PurchaseResult = {
-  order_id?: string;
-  message?: string;
-  subscription_active?: boolean;
-};
-type PurchaseOptions = {
-  forceProvider?: PaymentProvider;
-  billingAddress?: AddressSnapshot | null;
-  meta?: Record<string, string>;
-};
-//#endregion
-//#region src/skill/types.d.ts
-declare const SkillType: {
-  readonly Knowledge: "knowledge";
-  readonly ContentTemplate: "content-template";
-  readonly PersonalityClone: "personality-clone";
-  readonly BrandKit: "brand-kit";
-  readonly VideoTemplate: "video-template";
-  readonly VisualKit: "visual-kit";
-};
-type SkillTypeValue = (typeof SkillType)[keyof typeof SkillType];
-declare const SkillMediaBindingRole: {
-  readonly Subject: "subject";
-  readonly Style: "style";
-  readonly Logo: "logo";
-  readonly Product: "product";
-  readonly Motion: "motion";
-  readonly FirstFrame: "first_frame";
-  readonly LastFrame: "last_frame";
-};
-type SkillMediaBindingRoleValue = (typeof SkillMediaBindingRole)[keyof typeof SkillMediaBindingRole];
-declare const SkillScope: {
-  readonly Agent: "agent";
-  readonly Team: "team";
-};
-type SkillScopeValue = (typeof SkillScope)[keyof typeof SkillScope];
-type Skill = {
-  id: string;
-  name: string;
-  description: string;
-  content: string;
-  meta: Record<string, unknown> | null;
-  license: string | null;
-  compatibility: string | null;
-  allowedTools: string | null;
-  source: string;
-  sourcePath: string | null;
-  scope?: SkillScopeValue;
-  active: boolean;
-  store: StoreInfo;
-  createdAt: string;
-  media?: Media[];
-  screenshots: string[];
-};
-//#endregion
-//#region src/integration/types.d.ts
-type IntegrationType = 'none' | 'webhook' | 'api-token' | 'telegram' | 'slack' | 'whatsapp' | 'whatsapp-personal' | 'twilio' | 'sms' | 'n8n' | 'apple-health' | 'mcp' | 'x' | 'xchat' | 'instagram' | 'facebook' | 'linkedin' | 'grok' | 'cloudflare' | 'email' | 'calendar' | 'embed' | 'discord' | 'github' | 'push' | 'sentry' | 'readwise';
-type IntegrationDetails = {
-  type: IntegrationType;
-  name: string;
-  description?: string;
-  logoUrl?: string;
-  logoUrlDark?: string;
-  slug?: string;
-  category?: string;
-  [key: string]: unknown;
-};
-type IntegrationMeta = {
-  handle?: string;
-  provider?: EmailProvider | null;
-  hookSource?: string;
-  [key: string]: unknown;
-};
-type IntegrationConnectionDetails = IntegrationDetails & {
-  phoneNumberId?: string;
-  phoneNumber?: string;
-  webhookUrl?: string;
-  webhookSecret?: string;
-  webhookSecretKey?: string;
-};
-type Integration = {
-  id: string;
-  type: IntegrationType;
-  name: string;
-  active: boolean;
-  configured: boolean;
-  createdAt: string;
-  meta?: IntegrationMeta;
-  details?: IntegrationConnectionDetails;
-};
-type SocialPlatform = 'telegram' | 'slack' | 'whatsapp' | 'sms' | 'discord' | 'github' | 'xchat' | 'instagram';
-type SocialBot = {
-  name: string;
-  createdAt: string;
-  phoneNumberId?: string;
-  phoneNumber?: string;
-  applicationId?: string;
-  appId?: string;
-  installationId?: string;
-  username?: string;
-};
-type XIntegrationStatus = {
-  enabled: boolean;
-  integrationId: string | null;
-  xAccountLinked: boolean;
-  currentAgentName: string | null;
-};
-type EmbedStatus = {
-  integrationId: string;
-  agentName: string;
-  agentAvatar: string | null;
-  active: boolean;
-  allowedDomains: string[];
-};
-type EmailProvider = 'resend' | 'mailgun' | 'sendgrid';
-type CalendarProvider = 'google' | 'apple' | 'microsoft';
-type CalendarStatus = {
-  connected: boolean;
-  provider?: CalendarProvider;
-  providerDisplayName?: string;
-  accountEmail?: string;
-  lastSynced?: string;
-  tokenHealthy?: boolean;
-  upcomingEvents?: {
-    title: string;
-    startAt: string;
-    endAt: string;
-    allDay: boolean;
-  }[];
-};
-//#endregion
-//#region src/room/types.d.ts
-type RoomId = string;
-type RoomKind = 'default' | 'phone' | 'meeting';
-type Room = {
-  id: string;
-  name: string;
-  description: string | null;
-  public: boolean;
-  default: boolean;
-  active: boolean;
-  kind?: RoomKind | null;
-  archivedAt?: string | null;
-  secKey: string | null;
-  createdAt: string | null;
-  contactId?: string | null;
-  agent: AgentSimple;
-  integration: Integration | null;
-};
-//#endregion
-//#region src/agent/types.d.ts
-type AgentCharacter = {
-  name: string | null;
-  system: string | null;
-  bio: string | null;
-};
-type Agent = {
-  uuid: string;
-  name: string;
-  description: string;
-  avatar: string;
-  wallets: Wallet[];
-  settings: AgentSettings;
-  store: StoreInfo;
-  character?: AgentCharacter | null;
-  room: Room;
-  role: string | null;
-  blueprint: Blueprint | null;
-  team: string;
-};
-type AgentPrivate = {
-  uuid: string;
-  name: string;
-  description: string;
-  avatar: string;
-  wallets: Wallet[];
-  settings: AgentSettings;
-  store: StoreInfo;
-  password: string | null;
-  authKey: string | null;
-  secKey: string;
-  phoneNumber: string | null;
-  room: Room;
-  role: string | null;
-  blueprint: Blueprint | null;
-  justCreated?: boolean;
-  team: string;
-};
-type AgentActionHistoryEntry = {
-  id: string;
-  action: string | null;
-  outcome: 'succeeded' | 'failed';
-  outcomeDetail: string | null;
-  warpIdentifier: string | null;
-  meta: Record<string, unknown> | null;
-  createdAt: string | null;
+type Cart = {
+  subtotal: number;
+  taxes: {
+    amount: number;
+    percent: number;
+  };
+  total: number;
+  items: CartItem[];
+  coupon: Coupon | null;
+  couponDiscount: number;
 };
-type AgentSimple = {
-  uuid: string;
-  name: string;
-  avatar?: string | null;
-  authKey?: string | null;
-  team?: {
-    slug: string;
-  } | null;
-  settings?: Pick<AgentSettings, 'auto'>;
+type CouponCondition = 'none' | 'onetime-use' | 'previous-purchase';
+type CouponRestrictedItemType = 'product' | 'service';
+type CouponRestrictedItem = {
+  type: CouponRestrictedItemType;
+  ref: string;
 };
-type AgentWalletMode = 'local' | 'cloud' | 'external';
-type AgentEngine = 'cortex' | 'openclaw';
-type AgentGender = 'male' | 'female' | 'neutral';
-type AgentTrustedActionRule = {
+type Coupon = {
   id: string;
-  hash: string;
-  match?: Record<string, string>;
-  identifier?: string;
-  title?: string;
+  code: string;
+  name: TranslatableValue;
+  amount: number | null;
+  percent: number | null;
+  price: number | null;
+  discount?: number;
+  condition: CouponCondition;
+  restrictedItems: CouponRestrictedItem[];
+  usesLeft: number | null;
+  expiresAt: string | null;
+  active: boolean;
+  public: boolean;
+  sellable: boolean;
+  redemptionCount?: number;
+  media: Media[];
 };
-type AgentSettings = {
-  auto: boolean;
-  'model.url': string;
-  'voice.output': boolean;
-  'voice.id': string | null;
-  'agent.gender'?: AgentGender;
-  'proactivity.enabled': boolean;
-  'proactivity.quietHoursStart'?: number;
-  'proactivity.quietHoursEnd'?: number;
-  'proactivity.maxMessagesPerDay'?: number;
-  'proactivity.timezone'?: string;
-  'proactivity.blockedBehaviors'?: string[];
-  engine: AgentEngine;
-  'training.url'?: string | null;
-  'training.status'?: 'idle' | 'training' | 'completed' | 'failed' | null;
-  'training.recrawlInterval'?: number | null;
-  'email_provider'?: EmailProvider | null;
+type PurchaseResult = {
+  order_id?: string;
+  message?: string;
+  subscription_active?: boolean;
 };
-type LocalAgentWallet = {
-  provider: WarpWalletProvider;
-  address: string;
-  mnemonic?: string | null;
-  privateKey?: string | null;
+type PurchaseOptions = {
+  forceProvider?: PaymentProvider;
+  billingAddress?: AddressSnapshot | null;
+  meta?: Record<string, string>;
 };
-type AgentExecuteHandler = (prompt: string, options?: AgentExecuteOptions) => void;
-type AgentExecuteOptions = {
-  audio?: File;
-  sender?: string;
+//#endregion
+//#region src/skill/types.d.ts
+declare const SkillType: {
+  readonly Knowledge: "knowledge";
+  readonly ContentTemplate: "content-template";
+  readonly PersonalityClone: "personality-clone";
+  readonly BrandKit: "brand-kit";
+  readonly VideoTemplate: "video-template";
+  readonly VisualKit: "visual-kit";
+};
+type SkillTypeValue = (typeof SkillType)[keyof typeof SkillType];
+declare const SkillMediaBindingRole: {
+  readonly Subject: "subject";
+  readonly Style: "style";
+  readonly Logo: "logo";
+  readonly Product: "product";
+  readonly Motion: "motion";
+  readonly FirstFrame: "first_frame";
+  readonly LastFrame: "last_frame";
+};
+type SkillMediaBindingRoleValue = (typeof SkillMediaBindingRole)[keyof typeof SkillMediaBindingRole];
+declare const SkillScope: {
+  readonly Agent: "agent";
+  readonly Team: "team";
+};
+type SkillScopeValue = (typeof SkillScope)[keyof typeof SkillScope];
+type Skill = {
+  id: string;
+  name: string;
+  description: string;
+  content: string;
+  meta: Record<string, unknown> | null;
+  license: string | null;
+  compatibility: string | null;
+  allowedTools: string | null;
+  source: string;
+  sourcePath: string | null;
+  scope?: SkillScopeValue;
+  active: boolean;
+  store: StoreInfo;
+  createdAt: string;
   media?: Media[];
-  ghost?: boolean;
-  context?: Record<string, unknown>;
+  screenshots: string[];
 };
 //#endregion
 //#region src/link/types.d.ts
@@ -2180,95 +2276,6 @@ type Service = {
   updatedAt: string;
 };
 //#endregion
-//#region src/meeting/types.d.ts
-type MeetingSessionState = 'idle' | 'listening' | 'ended';
-type TranscriptEntry = {
-  id: string;
-  text: string;
-  isFinal: boolean;
-  timestamp: number;
-  speakerId?: number;
-  speakerName?: string;
-};
-type BookmarkEntry = {
-  id: string;
-  timestamp: number;
-  transcriptEntryId: string;
-};
-type MeetingParticipant = {
-  name: string | null;
-  profileImageUrl: string | null;
-};
-type MeetingSpeakerAssignment = {
-  speakerId: number;
-  name: string;
-  contactId: string | null;
-};
-type Meeting = {
-  id: string;
-  code: string;
-  name: string | null;
-  room: Room | null;
-  inviteUrl: string;
-  status: MeetingStatus;
-  conferenceProvider: MeetingConferenceProvider | null;
-  conferenceUrl: string | null;
-  conferenceExternalId: string | null;
-  configuration?: Configuration;
-  captureMode: 'desktop_local' | null;
-  transcriptUrl: string | null;
-  summaryUrl: string | null;
-  participants?: MeetingParticipant[]; /** CRM contacts linked to an appointment booking, when available. */
-  contacts?: Contact[];
-  speakerAssignments?: MeetingSpeakerAssignment[] | null;
-  scheduledAt: string | null;
-  scheduledEndAt?: string | null;
-  timezone?: string | null;
-  calendarEventId: number | null;
-  startedAt: string | null;
-  endedAt: string | null;
-  createdAt: string;
-};
-type MeetingStatus = 'active' | 'completed' | 'analyzed' | 'scheduled' | 'cancelled';
-type MeetingConferenceProvider = 'google_meet' | 'teams' | 'zoom';
-type MeetingFeature = 'transcription' | 'summary' | 'insights' | 'actions';
-type MeetingJoinTeam = {
-  name: string;
-  logo: string | null;
-};
-type MeetingJoinInfo = {
-  id: string;
-  code: string;
-  name: string | null;
-  inviteUrl: string;
-  agentName: string;
-  team: MeetingJoinTeam;
-  status: MeetingStatus;
-  isPhysical: boolean;
-  scheduledAt: string | null;
-  scheduledEndAt: string | null;
-  timezone: string;
-  conferenceUrl: string | null;
-  conferenceProvider: MeetingConferenceProvider | null;
-  endedAt: string | null;
-  canCancel: boolean;
-  features: Record<MeetingFeature, boolean>;
-};
-type MeetingTranscriptEntry = {
-  speaker: 'user' | 'agent';
-  text: string;
-  timestamp: string;
-};
-type MeetingUsage = {
-  current: number;
-  limit: number;
-  reached: boolean;
-  remainingWords: number | null;
-};
-type MeetingSummary = {
-  content: string;
-};
-//#endregion
 //#region src/appointment/types.d.ts
 type AppointmentSlot = {
   start: string;
@@ -2299,11 +2306,8 @@ type AppointmentPolicySync = {
 };
 type AppointmentPolicy = {
   active: boolean;
-  timezone: string | null;
-  availability: Record<string, {
-    start: string;
-    end: string;
-  }[]> | null;
+  timezone: string | null; /** Weekday → `"HH:mm-HH:mm"` ranges, e.g. `monday: ['09:00-17:00']`. */
+  availability: Record<string, string[]> | null;
   minNoticeMinutes: number | null;
   bufferMinutes: number | null;
   maxDaysAhead: number | null;
@@ -2582,6 +2586,7 @@ type PatchContentInput = {
 };
 //#endregion
 //#region src/address/formatAddressSnapshot.d.ts
+/** Accepts camelCase API snapshots and legacy snake_case stored snapshots. */
 declare const formatAddressSnapshotLines: (address: AddressSnapshot | null | undefined) => string[];
 //#endregion
 //#region src/billing/orderStatus.d.ts
@@ -2589,8 +2594,8 @@ declare const formatAddressSnapshotLines: (address: AddressSnapshot | null | und
 declare const ORDER_FULFILLMENT_STATUSES: readonly OrderStatus[];
 /** Statuses where checkout is finished and the guest may leave the JoAi thank-you page. */
 declare const ORDER_POST_CHECKOUT_STATUSES: readonly OrderStatus[];
-/** Storefront/admin label kind — pickup remaps confirmed/processing/shipped/delivered. */
-type OrderStatusDisplay = OrderStatus | 'preparing' | 'ready_for_pickup' | 'picked_up';
+/** Storefront/admin label kind — pickup remaps fulfillment steps; invoice remaps delivered → paid. */
+type OrderStatusDisplay = OrderStatus | 'new' | 'preparing' | 'ready_for_pickup' | 'picked_up' | 'paid';
 declare const isOrderPending: (status: OrderStatus) => boolean;
 declare const isOrderCanceled: (status: OrderStatus) => boolean;
 declare const isOrderInFulfillment: (status: OrderStatus) => boolean;
@@ -2603,6 +2608,36 @@ declare const isPickupReady: (order: Pick<Order, "fulfillmentMethod"> & {
 declare const isPickupOrderReady: (order: Pick<Order, "fulfillmentMethod" | "status"> & {
   fulfillments?: Order["fulfillments"] | null;
 }) => boolean;
+/** Next owner action for a local-pickup packing workstation. */
+type PickupNextAction = 'mark_ready' | 'mark_picked_up' | null;
+declare const getPickupNextAction: (order: Pick<Order, "fulfillmentMethod" | "status"> & {
+  fulfillments?: Order["fulfillments"] | null;
+  items?: Order["items"];
+}) => PickupNextAction;
+/** Allowed manual status targets for pickup (illegal jumps stay out). Ready/picked-up go via fulfillment. */
+declare const getPickupEditableStatuses: (status: OrderStatus) => OrderStatus[];
+/** Allowed manual status targets for shipping. Carrier ship stays on fulfillment; delivered closes the order. */
+declare const getShippingEditableStatuses: (status: OrderStatus) => OrderStatus[];
+/** Allowed manual status targets for invoice/service orders (no fulfillment method). */
+declare const getInvoiceEditableStatuses: (status: OrderStatus) => OrderStatus[];
+/** Manual owner-editable statuses for the order's fulfillment context. */
+declare const getEditableOrderStatuses: (status: OrderStatus, fulfillmentMethod?: string | null) => OrderStatus[];
+declare const canTransitionOrderStatus: (from: OrderStatus, to: OrderStatus, fulfillmentMethod?: string | null) => boolean;
+/** Owner fulfill dialog: payment → prepare → dispatch → complete. */
+type FulfillmentFlowStep = 'payment' | 'prepare' | 'dispatch' | 'complete';
+type FulfillmentFlowAction = 'notify_ready' | 'mark_collected' | 'mark_shipped' | 'mark_delivered' | null;
+declare const resolveFulfillmentFlowStep: (order: Pick<Order, "fulfillmentMethod" | "status"> & {
+  fulfillments?: Order["fulfillments"] | null;
+}) => FulfillmentFlowStep | null;
+declare const getFulfillmentFlowAction: (order: Pick<Order, "fulfillmentMethod" | "status"> & {
+  fulfillments?: Order["fulfillments"] | null;
+  items?: Order["items"];
+}) => FulfillmentFlowAction;
+/** Stepper index 0–3: payment → prepare → dispatch → complete. */
+declare const getFulfillmentFlowStepperIndex: (step: FulfillmentFlowStep | null) => number;
+declare const canOpenFulfillmentFlow: (order: Pick<Order, "fulfillmentMethod" | "status" | "type"> & {
+  items?: Order["items"];
+}) => boolean;
 //#endregion
 //#region src/commerce/helpers.d.ts
 type CartLine = {
@@ -2610,6 +2645,8 @@ type CartLine = {
   quantity: number;
 };
 declare const cartLineTotal: <T extends CartLine>(items: T[]) => number;
+/** Merchandise total after a discount (cents), never below zero. */
+declare const cartPayableTotal: <T extends CartLine>(items: T[], discountCents?: number) => number;
 declare const isCompleteAddressInput: (address: Pick<AddressInput, "name" | "addressOne" | "city" | "zipCode" | "country">) => boolean;
 //#endregion
 //#region src/budget/types.d.ts
@@ -2830,6 +2867,13 @@ type Document = {
   name: string;
   content: string | null;
   documentUrl: string | null;
+  sourceUrl?: string | null;
+  type?: string;
+  meta?: Record<string, unknown> | null;
+  slug?: string | null;
+  isPublic?: boolean;
+  url?: string | null;
+  archivedAt?: string | null;
   createdAt: string;
 };
 //#endregion
@@ -3689,15 +3733,6 @@ type OfficeEntity = {
 };
 //#endregion
 //#region src/ogimage/types.d.ts
-type OgImageType = 'default' | 'article' | 'category' | 'listing' | 'brand';
-type OgImageParams = {
-  type?: OgImageType;
-  title: string;
-  subtitle?: string;
-  category?: string;
-  categoryColor?: string;
-  brandLogo?: string;
-};
 declare const OG_IMAGE_WIDTH = 1200;
 declare const OG_IMAGE_HEIGHT = 630;
 declare const OG_IMAGE_CONFIG: {
@@ -3720,13 +3755,51 @@ declare const OgImageColors: {
 };
 //#endregion
 //#region src/ogimage/helpers.d.ts
-type OgResourceType = 'meeting';
+type OgResourceType = 'meeting' | 'action' | 'app' | 'actions' | 'apps' | 'changelog' | 'agent' | 'agents' | 'skill' | 'flow' | 'blueprint' | 'digest' | 'digests' | 'store' | 'product' | 'service';
 type OgResourceParams = {
   meeting: {
     code: string;
   };
+  action: {
+    slug: string;
+    locale?: string;
+  };
+  app: {
+    slug: string;
+    locale?: string;
+  };
+  actions: Record<string, never>;
+  apps: Record<string, never>;
+  changelog: Record<string, never>;
+  agent: {
+    id: string;
+    locale?: string;
+  };
+  agents: Record<string, never>;
+  skill: {
+    id: string;
+  };
+  flow: {
+    slug: string;
+  };
+  blueprint: {
+    slug: string;
+  };
+  digest: {
+    id: string;
+  };
+  digests: Record<string, never>;
+  store: Record<string, never>;
+  product: {
+    teamname: string;
+    slug: string;
+  };
+  service: {
+    teamname: string;
+    slug: string;
+  };
 };
-declare function ogImageUrl<T extends OgResourceType>(type: T, params: OgResourceParams[T]): string;
+declare function ogImageUrl<T extends OgResourceType>(type: T, params: OgResourceParams[T], env?: AppEnv): string;
 //#endregion
 //#region src/project/types.d.ts
 type ProjectStatus = 'draft' | 'planned' | 'render-ready' | 'rendered' | 'composed' | 'exported';
@@ -4720,4 +4793,4 @@ type CliSessionStatus = {
   meta: CliSessionMeta | null;
 };
 //#endregion
-export { AUTOMATION_SEND_CHANNELS, Achievement, Address, AddressCreatePayload, AddressInput, AddressSnapshot, type AddressType, AddressTypes, AddressUpdatePayload, Affiliate, AffiliateStatus, AffiliateTier, AffiliateTierName, Agent, AgentActionHistoryEntry, AgentCharacter, AgentDelegatable, AgentEngine, AgentExecuteHandler, AgentExecuteOptions, AgentGender, AgentMessageMeta, AgentMessageOptions, AgentPrivate, AgentSettings, AgentSetupTarget, AgentSimple, AgentToolingAccess, AgentTrustedActionRule, AgentWalletMode, AggregatedRoute, AiCostEntry, AiCostsResponse, AiCostsSummary, Alert, ApiToken, AppAccessRule, AppEnv, AppFile, AppFileType, AppIngestion, AppSetupTarget, AppendKvEntryResult, AppointmentAvailability, AppointmentAvailabilityService, AppointmentAvailabilitySlot, AppointmentBooking, AppointmentBookingContext, AppointmentPolicy, AppointmentPolicySync, AppointmentRequest, AppointmentSlot, Artifact, ArtifactBlock, ArtifactBlockType, ArtifactContactSummary, ArtifactCreatePayload, ArtifactDeliverIntegration, ArtifactDeliverPayload, ArtifactDelivery, ArtifactLink, ArtifactStatus, ArtifactType, ArtifactUpdatePayload, AuthUser, Automation, AutomationAction, AutomationActionConfig, AutomationActionInput, AutomationActionType, AutomationAudiencePreview, AutomationCreatePayload, AutomationEnrollment, AutomationEnrollmentChange, AutomationEnrollmentStatus, AutomationEnrollmentUpdatedPayload, AutomationSendChannel, AutomationSendChannelId, AutomationSkipReason, AutomationStats, AutomationTriggerConfig, AutomationTriggerType, AutomationUpdatePayload, BillingManageAccess, Blueprint, BlueprintOnboardingStep, BlueprintRedirect, BlueprintSettings, BlueprintShortcut, BlueprintTask, BlueprintTeam, BoardSummaryViewable, BookmarkEntry, BrandBackend, BrandIntegration, BrandIntegrationAction, BrandIntegrationProvider, BrandSearchHit, BrandSiteConfig, BrandSourceConfig, Budget, ByokProviderConfig, ByokProviderName, ByokProviders, CAMPAIGN_CHANNELS, CONTACT_MESSAGE_SEND_WARP, CalendarProvider, CalendarStatus, Campaign, CampaignApproval, CampaignAudiencePreview, CampaignAudiencePreviewPayload, CampaignCategory, CampaignChannel, CampaignChannelId, CampaignCreatePayload, CampaignRecipient, CampaignRecipientStatus, CampaignSkipReason, CampaignSkipReasons, CampaignStats, CampaignStatus, CampaignUpdatePayload, Card, Cart, CartItem, CartLine, Challenge, Challenges, ChangelogEntry, Character, ChatClientAction, ChatClientThought, ChatStreamData, ChatStreamEventType, CheckoutSnapshot, CheckoutSnapshotRequest, CliSessionMeta, CliSessionStatus, CommissionAgreement, Configuration, Contact, ContactActivity, ContactActivityAuthor, ContactActivityType, ContactConsent, ContactConsentStatus, ContactCreatePayload, ContactFormData, ContactHealth, ContactRelation, ContactRelationCategory, ContactRelationContact, ContactRelationDirection, ContactRelationPayload, ContactRelationType, ContactRelationUpdatePayload, ContactViewable, Content, ContentDefinition, ContentEntry, ContentField, ContentFieldType, ContentPatch, ContentStatus, ContentValue, ContentVersion, Contract, ContractCategoryDisplayNames, ContractCategoryName, ContractCodeMetadata, ContractEntity, ContractOnNetwork, ContractVersion, ContractsAddressConfig, CortexExecuteOptions, Coupon, CouponCondition, CouponRestrictedItem, CouponRestrictedItemType, CreateContentInput, CreateHookPayload, CreateInboundHookPayload, CreateInternalHookPayload, CreateKvFieldPayload, CreateWarpLinkedHookPayload, CreateWebHookPayload, DefaultCodeMetadata, DefaultInviteTeamRole, DemoFlow, DemoMessage, Desk, DeskItem, DeskItemRole, Document, EarnResponse, Earning, Element, ElementSpec, ElementType, ElementVariation, EmailProvider, EmbedStatus, EncryptionStatus, Entity, EntityDirectExecuteRequest, EntityProposable, EntitySignable, EntityTemplate, Experience, FeatureSetupTarget, FileInfo, FileMetadata, Flow, FlowCategory, FlowInputMapping, FlowStatus, FlowStep, Fulfillment, FulfillmentLocation, type FulfillmentMethod, FulfillmentMethods, type FulfillmentStatus, FulfillmentStatuses, GamificationData, GamificationEventType, Goal, GoalCreatePayload, GoalPriority, GoalProgressViewable, GoalStatus, GuestBuyer, HintOptions, HintPosition, Hook, HookSample, HookTrigger, HookTriggerCondition, HookTriggerInput, HttpService, IAppResponse, IHttpService, IRequestOptions, IngestionSourceType, IngestionStatus, Inquiry, InquiryStatus, InquiryType, Integration, IntegrationConnectionDetails, IntegrationDetails, IntegrationMeta, IntegrationType, Intent, InviteableTeamRoles, Item, ItemCreatePayload, ItemExecutionStatus, ItemPriority, ItemStatus, ItemUpdatePayload, ItemViewable, JoaiUrls, JsonValue, KvEntry, KvEntryPayload, KvField, KvFieldWithEntries, KvValue, Kyc, KycStatus, Link, LinkCreatePayload, LinkScanHistory, LinkStats, LinkUpdatePayload, LinkVariation, LinkVariationBatchCreatePayload, LinkVariationCreatePayload, LocalAgentWallet, LoyaltyAccount, LoyaltyMember, LoyaltyNextTier, LoyaltyProgram, LoyaltyPromotion, LoyaltyReward, LoyaltyStatus, LoyaltyTier, LoyaltyTierInfo, LoyaltyTransaction, McpToolCall, McpToolCallBroadcast, McpToolCallStatus, Media, MediaAspectRatio, MediaAttributes, MediaItems, MediaLibraryAttributes, MediaMime, Meeting, MeetingConferenceProvider, MeetingFeature, MeetingJoinInfo, MeetingJoinTeam, MeetingParticipant, MeetingSessionState, MeetingSpeakerAssignment, MeetingStatus, MeetingSummary, MeetingTranscriptEntry, MeetingUsage, Memory, Message, MessageId, MessageRole, Metric, MetricSource, MetricsResult, Milestone, MilestoneType, Mission, MissionBudget, MissionCreatePayload, MissionPlan, MissionPriority, MissionSchedule, MissionStatus, MissionViewable, MollieTerminalPaymentResult, MultimodalContent, MultimodalFile, NATIVE_AUTH_TOKEN_PARAM, NativeApp, NativeApps, Notification, NotificationAction, NotificationAgent, NotificationChannel, NotificationSetting, OG_IMAGE_CONFIG, OG_IMAGE_HEIGHT, OG_IMAGE_WIDTH, ORDER_FULFILLMENT_STATUSES, ORDER_POST_CHECKOUT_STATUSES, OUTBOUND_CHANNELS, OfficeAgent, OfficeEntity, OfficeEntityKind, OfficeLiveOverrides, OfficeMember, OfficeSnapshot, OfficeStatus, OfficeStatusFilter, OfficeTypeFilter, OgImageColors, OgImageParams, OgImageType, Order, OrderConfigurationItem, OrderContext, OrderItem, OrderPriceMode, OrderSource, OrderStatus, OrderStatusDisplay, OrderType, OutboundChannel, OutboundChannelId, PLATFORM_CURRENCY, PaginatedResponse, Pass, PatchContentInput, PaymentAccount, PaymentAccountOnboarding, PaymentProvider, PayoutEntry, PeriodTypeLabels, PeriodTypeOptions, PermissionConfigType, PermissionPresetName, PermissionPresetNames, PersonaQuestionable, Plan, PlanBenefit, PlanExtra, PlanFeature, PlanInterval, PolicyMethod, PolicySetting, PricingModel, Product, ProductDiscount, ProductMeta, ProductPieces, ProductRating, ProductRelation, ProductRelationType, ProductVariation, ProductVariationMeta, ProductVariationType, ProgramSettings, Project, ProjectAspectRatio, ProjectAssembly, ProjectCaptionStyle, ProjectClipCandidate, ProjectClips, ProjectExport, ProjectExportAsset, ProjectExportResponse, ProjectImages, ProjectInputAssistIntent, ProjectInputAssistResponse, ProjectMutation, ProjectOutputPreset, ProjectOutputType, ProjectPlan, ProjectRender, ProjectRenderMode, ProjectSelectedClip, ProjectShot, ProjectSoundtrack, ProjectSourceMedia, ProjectStatus, ProjectStudioHistoryEntry, ProjectStudioQuestion, ProjectStudioResponse, ProjectStudioStage, ProjectStudioState, ProjectStudioSummary, ProjectStyleDirection, ProjectTranscript, ProjectTranscriptSegment, Proposal, ProposalAction, ProposalActionPayment, ProposalActionPaymentSerializable, ProposalActionSerializable, ProposalPollOption, ProposalStatus, PublicFormResults, PurchaseOptions, PurchaseResult, RampProvider, RampProviderInfo, Reactions, RecentExperience, RedeemResponse, Reminder, Return, type ReturnStatus, ReturnStatuses, ReturnUpdateStatus, ReturnUpdateStatuses, Room, RoomId, RoomKind, ScInfo, SchedulePreset, SecretAuthorizable, SecretSettable, Segment, SegmentCondition, SegmentConditionType, SegmentCountPayload, SegmentCountResult, SegmentCreatePayload, SegmentGroup, SendableActivityUpdate, SendableAgentAction, SendableAgentMessage, SendableAgentThought, SendableMedia, SendableUserMessage, Service, SetKvEntryResult, SharedSocialPost, ShippingRate, ShippingZone, Shortcut, Site, SiteAgent, SiteBrand, SiteRoute, SiteTeam, SiteType, Skill, SkillMediaBindingRole, SkillMediaBindingRoleValue, SkillScope, SkillScopeValue, SkillType, SkillTypeValue, SocialAuthProvider, SocialBot, SocialPlatform, SocialPost, SocialPostConnection, SocialPostCreatePayload, SocialPostGenerateCaptionPayload, SocialPostGeneratedCaption, SocialPostPlatform, SocialPostStatus, SocialPostUpdatePayload, StampResponse, StoreAgent, StoreCheckoutItem, StoreData, StoreEntityType, StoreInfo, StoreItem, StoreListing, StorePriceTier, StorePricing, StorePurchasable, StorePurchaseResult, Streak, Subscription, SubscriptionDelivery, SubscriptionInterval, SubscriptionPlan, SubscriptionStatus, Swarm, Tag, TagType, Task, Team, TeamAccessCatalog, TeamAccessConfig, TeamBrand, TeamCategory, TeamCurrencySource, TeamEarning, TeamEarningsBalance, TeamFeature, TeamFeatureAccess, TeamFeatureArea, TeamFeatureUsage, TeamManageAccess, TeamMember, TeamMeta, TeamOrderStats, TeamPayout, TeamPayoutAddress, TeamPlace, TeamPrivate, TeamSettings, TeamUsage, TeamViewAccess, TerminalConnectionToken, TerminalPaymentIntent, Tier, TierFeature, TierName, ToggleKvFieldResult, TranscriptEntry, TranscriptionCorrection, TranscriptionResponse, TranslatableValue, UNIFIED_MCP_SERVER_NAME, Update, UpdateCreatePayload, UpdateRelation, UpdateStats, UpdateStatus, UpdateType, UpdateUpdatePayload, Upgrade, UpgradeSourceType, UpgradeStatus, User, UserInterest, UserMode, type UserPermission, UserPermissions, UserPrivate, type UserRole, UserRoles, UserSettings, UserSocialAccount, UserStats, VolumePrice, Wallet, WalletList, WarpApprovable, WarpBackend, WarpBackendStatus, WarpBatchItem, WarpBatchable, WarpCloudExecutable, WarpCreateable, WarpExecutable, WarpExecutionBackend, WarpExtras, WarpExtrasFaq, WarpInputable, WarpScreenshotVariant, WarpSearchHit, WarpSelectable, WarpSelectableDetails, WarpSuggestion, WarpTestable, WarpViewable, WebHookTriggerEvent, WorkspaceCloudFile, WorkspaceContext, WorkspaceInfo, WorkspaceSettings, XIntegrationStatus, abbreviateNumber, addressTypeValues, automationSendChannel, buildAgentMcpServerName, buildAgentSetupClipboardText, buildAppSetupClipboardText, buildFeatureSetupClipboardText, buildMcpServerName, cartLineTotal, createCursorMcpInstallLink, defaultInviteTeamRole, formatAddressSnapshotLines, fulfillmentMethodValues, fulfillmentStatusValues, getAgentSetupPromptUrl, getAgentsBaseUrl, getApiBaseUrl, getAppBaseUrl, getAssetAppLogoUrl, getAssetChainLogoUrl, getAssetPartnerLogoUrl, getAssetTokenLogoUrl, getAssetWalletLogoUrl, getCortexBaseUrl, getDigestBaseUrl, getFormsBaseUrl, getLoginUrl, getMcpServerAgentUrl, getMcpServerUrl, getSiteUrl, getSitesBaseUrl, getSitesRootDomain, getStoreBaseUrl, getWarpScreenshotUrl, hasAllPermissions, hasAllTeamPermissions, hasAnyPermissions, hasPermission, hasTeamPermission, integrationSlugForChannel, inviteableTeamRoles, isAutomationSendChannelId, isCampaignChannelId, isCompleteAddressInput, isContactMessageAction, isContactMessageWarpId, isFileFormatAudio, isFileFormatImage, isFileFormatVideo, isNativeApp, isNativeAppAccessible, isNativeAppGated, isNativeAppLocked, isOrderCanceled, isOrderInFulfillment, isOrderPending, isOrderPostCheckout, isPickupOrderReady, isPickupReady, isTeamFeatureAccessible, isTeamFeatureGated, isTeamFeatureLocked, isUnifiedMcpUrl, isUserRole, localize, nativeAppSlugs, normalizeAutomationActionType, ogImageUrl, outboundChannel, permissionPresetRules, resolveAccessCatalog, resolveAgentMcpUrl, resolveConnectMcpUrl, resolveOrderStatusDisplay, resolveTeamCurrency, resolveWarpText, returnStatusValues, returnUpdateStatusValues, sanitizeAlphanumeric, sanitizeNumeric, slugifyMcpSegment, teamCategories, toCurrencyDisplay, toHexEncodedNonce, toNameInitials, toNftId, toPreviewText, userPermissionValues, userRoleValues, withRetry };
+export { AUTOMATION_SEND_CHANNELS, Achievement, Address, AddressCreatePayload, AddressInput, AddressSnapshot, type AddressType, AddressTypes, AddressUpdatePayload, Affiliate, AffiliateStatus, AffiliateTier, AffiliateTierName, Agent, AgentActionHistoryEntry, AgentCharacter, AgentDelegatable, AgentEngine, AgentExecuteHandler, AgentExecuteOptions, AgentGender, AgentMessageMeta, AgentMessageOptions, AgentPrivate, AgentSettings, AgentSetupTarget, AgentSimple, AgentToolingAccess, AgentTrustedActionRule, AgentWalletMode, AggregatedRoute, AiCostEntry, AiCostsResponse, AiCostsSummary, Alert, ApiToken, AppAccessRule, AppEnv, AppFile, AppFileType, AppIngestion, AppSetupTarget, AppendKvEntryResult, AppointmentAvailability, AppointmentAvailabilityService, AppointmentAvailabilitySlot, AppointmentBooking, AppointmentBookingContext, AppointmentPolicy, AppointmentPolicySync, AppointmentRequest, AppointmentSlot, Artifact, ArtifactBlock, ArtifactBlockType, ArtifactContactSummary, ArtifactCreatePayload, ArtifactDeliverIntegration, ArtifactDeliverPayload, ArtifactDelivery, ArtifactLink, ArtifactStatus, ArtifactType, ArtifactUpdatePayload, AuthUser, Automation, AutomationAction, AutomationActionConfig, AutomationActionInput, AutomationActionType, AutomationAudiencePreview, AutomationCreatePayload, AutomationEnrollment, AutomationEnrollmentChange, AutomationEnrollmentStatus, AutomationEnrollmentUpdatedPayload, AutomationSendChannel, AutomationSendChannelId, AutomationSkipReason, AutomationStats, AutomationTriggerConfig, AutomationTriggerType, AutomationUpdatePayload, BillingManageAccess, Blueprint, BlueprintOnboardingStep, BlueprintRedirect, BlueprintSettings, BlueprintShortcut, BlueprintTask, BlueprintTeam, BoardSummaryViewable, BookmarkEntry, BrandBackend, BrandIntegration, BrandIntegrationAction, BrandIntegrationProvider, BrandSearchHit, BrandSiteConfig, BrandSourceConfig, Budget, ByokProviderConfig, ByokProviderName, ByokProviders, CAMPAIGN_CHANNELS, CONTACT_MESSAGE_SEND_WARP, CalendarProvider, CalendarStatus, Campaign, CampaignApproval, CampaignAudiencePreview, CampaignAudiencePreviewPayload, CampaignCategory, CampaignChannel, CampaignChannelId, CampaignCreatePayload, CampaignRecipient, CampaignRecipientStatus, CampaignSkipReason, CampaignSkipReasons, CampaignStats, CampaignStatus, CampaignUpdatePayload, Card, Cart, CartItem, CartLine, Challenge, Challenges, ChangelogEntry, Character, ChatClientAction, ChatClientThought, ChatStreamData, ChatStreamEventType, CheckoutSnapshot, CheckoutSnapshotRequest, CliSessionMeta, CliSessionStatus, CommissionAgreement, Configuration, Contact, ContactActivity, ContactActivityAuthor, ContactActivityType, ContactConsent, ContactConsentStatus, ContactCreatePayload, ContactFormData, ContactHealth, ContactRelation, ContactRelationCategory, ContactRelationContact, ContactRelationDirection, ContactRelationPayload, ContactRelationType, ContactRelationUpdatePayload, ContactViewable, Content, ContentDefinition, ContentEntry, ContentField, ContentFieldType, ContentPatch, ContentStatus, ContentValue, ContentVersion, Contract, ContractCategoryDisplayNames, ContractCategoryName, ContractCodeMetadata, ContractEntity, ContractOnNetwork, ContractVersion, ContractsAddressConfig, CortexExecuteOptions, Coupon, CouponCondition, CouponRestrictedItem, CouponRestrictedItemType, CreateContentInput, CreateHookPayload, CreateInboundHookPayload, CreateInternalHookPayload, CreateKvFieldPayload, CreateWarpLinkedHookPayload, CreateWebHookPayload, DefaultCodeMetadata, DefaultInviteTeamRole, DemoFlow, DemoMessage, Desk, DeskItem, DeskItemRole, Document, EarnResponse, Earning, Element, ElementSpec, ElementType, ElementVariation, EmailProvider, EmbedStatus, EncryptionStatus, Entity, EntityDirectExecuteRequest, EntityProposable, EntitySignable, EntityTemplate, Experience, FeatureSetupTarget, FileInfo, FileMetadata, Flow, FlowCategory, FlowInputMapping, FlowStatus, FlowStep, Fulfillment, FulfillmentFlowAction, FulfillmentFlowStep, FulfillmentLocation, type FulfillmentMethod, FulfillmentMethods, type FulfillmentStatus, FulfillmentStatuses, GamificationData, GamificationEventType, Goal, GoalCreatePayload, GoalPriority, GoalProgressViewable, GoalStatus, GuestBuyer, HintOptions, HintPosition, Hook, HookSample, HookTrigger, HookTriggerCondition, HookTriggerInput, HttpService, IAppResponse, IHttpService, IRequestOptions, IngestionSourceType, IngestionStatus, Inquiry, InquiryStatus, InquiryType, Integration, IntegrationConnectionDetails, IntegrationDetails, IntegrationMeta, IntegrationType, Intent, InviteableTeamRoles, Item, ItemCreatePayload, ItemExecutionStatus, ItemPriority, ItemStatus, ItemUpdatePayload, ItemViewable, JoaiUrls, JsonValue, KvEntry, KvEntryPayload, KvField, KvFieldWithEntries, KvValue, Kyc, KycStatus, Link, LinkCreatePayload, LinkScanHistory, LinkStats, LinkUpdatePayload, LinkVariation, LinkVariationBatchCreatePayload, LinkVariationCreatePayload, LocalAgentWallet, LoyaltyAccount, LoyaltyMember, LoyaltyNextTier, LoyaltyProgram, LoyaltyPromotion, LoyaltyReward, LoyaltyStatus, LoyaltyTier, LoyaltyTierInfo, LoyaltyTransaction, McpToolCall, McpToolCallBroadcast, McpToolCallStatus, Media, MediaAspectRatio, MediaAttributes, MediaItems, MediaLibraryAttributes, MediaMime, Meeting, MeetingConferenceProvider, MeetingFeature, MeetingJoinInfo, MeetingJoinTeam, MeetingParticipant, MeetingSessionState, MeetingSpeakerAssignment, MeetingStatus, MeetingSummary, MeetingTranscriptEntry, MeetingUsage, Memory, Message, MessageId, MessageRole, Metric, MetricSource, MetricsResult, Milestone, MilestoneType, Mission, MissionBudget, MissionCreatePayload, MissionPlan, MissionPriority, MissionSchedule, MissionStatus, MissionViewable, MollieTerminalPaymentResult, MultimodalContent, MultimodalFile, NATIVE_AUTH_TOKEN_PARAM, NativeApp, NativeApps, Notification, NotificationAction, NotificationAgent, NotificationChannel, NotificationSetting, OG_IMAGE_CONFIG, OG_IMAGE_HEIGHT, OG_IMAGE_WIDTH, ORDER_FULFILLMENT_STATUSES, ORDER_POST_CHECKOUT_STATUSES, OUTBOUND_CHANNELS, OfficeAgent, OfficeEntity, OfficeEntityKind, OfficeLiveOverrides, OfficeMember, OfficeSnapshot, OfficeStatus, OfficeStatusFilter, OfficeTypeFilter, OgImageColors, Order, OrderConfigurationItem, OrderContext, OrderItem, OrderPriceMode, OrderSource, OrderStatus, OrderStatusDisplay, OrderType, OutboundChannel, OutboundChannelId, PLATFORM_CURRENCY, PaginatedResponse, Pass, PatchContentInput, PaymentAccount, PaymentAccountOnboarding, PaymentProvider, PayoutEntry, PeriodTypeLabels, PeriodTypeOptions, PermissionConfigType, PermissionPresetName, PermissionPresetNames, PersonaQuestionable, PickupNextAction, Plan, PlanBenefit, PlanExtra, PlanFeature, PlanInterval, PolicyMethod, PolicySetting, PricingModel, Product, ProductDiscount, ProductMeta, ProductPieces, ProductRating, ProductRelation, ProductRelationType, ProductVariation, ProductVariationMeta, ProductVariationType, ProgramSettings, Project, ProjectAspectRatio, ProjectAssembly, ProjectCaptionStyle, ProjectClipCandidate, ProjectClips, ProjectExport, ProjectExportAsset, ProjectExportResponse, ProjectImages, ProjectInputAssistIntent, ProjectInputAssistResponse, ProjectMutation, ProjectOutputPreset, ProjectOutputType, ProjectPlan, ProjectRender, ProjectRenderMode, ProjectSelectedClip, ProjectShot, ProjectSoundtrack, ProjectSourceMedia, ProjectStatus, ProjectStudioHistoryEntry, ProjectStudioQuestion, ProjectStudioResponse, ProjectStudioStage, ProjectStudioState, ProjectStudioSummary, ProjectStyleDirection, ProjectTranscript, ProjectTranscriptSegment, Proposal, ProposalAction, ProposalActionPayment, ProposalActionPaymentSerializable, ProposalActionSerializable, ProposalPollOption, ProposalStatus, PublicFormResults, PurchaseOptions, PurchaseResult, RampProvider, RampProviderInfo, Reactions, RecentExperience, RedeemResponse, Reminder, Return, type ReturnStatus, ReturnStatuses, ReturnUpdateStatus, ReturnUpdateStatuses, Room, RoomId, RoomKind, ScInfo, SchedulePreset, SecretAuthorizable, SecretSettable, Segment, SegmentCondition, SegmentConditionType, SegmentCountPayload, SegmentCountResult, SegmentCreatePayload, SegmentGroup, SendableActivityUpdate, SendableAgentAction, SendableAgentMessage, SendableAgentThought, SendableMedia, SendableUserMessage, Service, SetKvEntryResult, SharedSocialPost, ShippingRate, ShippingZone, Shortcut, Site, SiteAgent, SiteBrand, SiteRoute, SiteTeam, SiteType, Skill, SkillMediaBindingRole, SkillMediaBindingRoleValue, SkillScope, SkillScopeValue, SkillType, SkillTypeValue, SocialAuthProvider, SocialBot, SocialPlatform, SocialPost, SocialPostConnection, SocialPostCreatePayload, SocialPostGenerateCaptionPayload, SocialPostGeneratedCaption, SocialPostPlatform, SocialPostStatus, SocialPostUpdatePayload, StampResponse, StoreAgent, StoreCheckoutItem, StoreData, StoreEntityType, StoreInfo, StoreItem, StoreListing, StorePriceTier, StorePricing, StorePurchasable, StorePurchaseResult, Streak, Subscription, SubscriptionDelivery, SubscriptionInterval, SubscriptionPlan, SubscriptionStatus, Swarm, Tag, TagType, Task, Team, TeamAccessCatalog, TeamAccessConfig, TeamBrand, TeamCategory, TeamCurrencySource, TeamEarning, TeamEarningsBalance, TeamFeature, TeamFeatureAccess, TeamFeatureArea, TeamFeatureUsage, TeamManageAccess, TeamMember, TeamMeta, TeamOrderStats, TeamPayout, TeamPayoutAddress, TeamPlace, TeamPrivate, TeamSettings, TeamUsage, TeamViewAccess, TerminalConnectionToken, TerminalPaymentIntent, Tier, TierFeature, TierName, ToggleKvFieldResult, TranscriptEntry, TranscriptionCorrection, TranscriptionResponse, TranslatableValue, UNIFIED_MCP_SERVER_NAME, Update, UpdateCreatePayload, UpdateRelation, UpdateStats, UpdateStatus, UpdateType, UpdateUpdatePayload, Upgrade, UpgradeSourceType, UpgradeStatus, User, UserInterest, UserMode, type UserPermission, UserPermissions, UserPrivate, type UserRole, UserRoles, UserSettings, UserSocialAccount, UserStats, VolumePrice, Wallet, WalletList, WarpApprovable, WarpBackend, WarpBackendStatus, WarpBatchItem, WarpBatchable, WarpCloudExecutable, WarpCreateable, WarpExecutable, WarpExecutionBackend, WarpExtras, WarpExtrasFaq, WarpInputable, WarpScreenshotVariant, WarpSearchHit, WarpSelectable, WarpSelectableDetails, WarpSuggestion, WarpTestable, WarpViewable, WebHookTriggerEvent, WorkspaceCloudFile, WorkspaceContext, WorkspaceInfo, WorkspaceSettings, XIntegrationStatus, abbreviateNumber, addressTypeValues, automationSendChannel, buildAgentMcpServerName, buildAgentSetupClipboardText, buildAppSetupClipboardText, buildFeatureSetupClipboardText, buildMcpServerName, canOpenFulfillmentFlow, canTransitionOrderStatus, cartLineTotal, cartPayableTotal, createCursorMcpInstallLink, defaultInviteTeamRole, formatAddressSnapshotLines, fulfillmentMethodValues, fulfillmentStatusValues, getAgentSetupPromptUrl, getAgentsBaseUrl, getApiBaseUrl, getAppBaseUrl, getAssetAppLogoUrl, getAssetChainLogoUrl, getAssetPartnerLogoUrl, getAssetTokenLogoUrl, getAssetWalletLogoUrl, getCortexBaseUrl, getDigestBaseUrl, getEditableOrderStatuses, getFormsBaseUrl, getFulfillmentFlowAction, getFulfillmentFlowStepperIndex, getGenBaseUrl, getInvoiceEditableStatuses, getLoginUrl, getMcpServerAgentUrl, getMcpServerUrl, getPickupEditableStatuses, getPickupNextAction, getShippingEditableStatuses, getSiteUrl, getSitesBaseUrl, getSitesRootDomain, getStoreBaseUrl, getWarpScreenshotUrl, hasAllPermissions, hasAllTeamPermissions, hasAnyPermissions, hasPermission, hasTeamPermission, integrationSlugForChannel, inviteableTeamRoles, isAutomationSendChannelId, isCampaignChannelId, isCompleteAddressInput, isContactMessageAction, isContactMessageWarpId, isFileFormatAudio, isFileFormatImage, isFileFormatVideo, isNativeApp, isNativeAppAccessible, isNativeAppGated, isNativeAppLocked, isOrderCanceled, isOrderInFulfillment, isOrderPending, isOrderPostCheckout, isPickupOrderReady, isPickupReady, isTeamFeatureAccessible, isTeamFeatureGated, isTeamFeatureLocked, isUnifiedMcpUrl, isUserRole, localize, nativeAppSlugs, normalizeAutomationActionType, ogImageUrl, outboundChannel, permissionPresetRules, resolveAccessCatalog, resolveAgentMcpUrl, resolveConnectMcpUrl, resolveFulfillmentFlowStep, resolveOrderStatusDisplay, resolveTeamCurrency, resolveWarpText, returnStatusValues, returnUpdateStatusValues, sanitizeAlphanumeric, sanitizeNumeric, slugifyMcpSegment, teamCategories, toCurrencyDisplay, toHexEncodedNonce, toNameInitials, toNftId, toPreviewText, userPermissionValues, userRoleValues, withRetry };

package/dist/index.mjs

@@ -42,6 +42,12 @@ const getAgentsBaseUrl = (env) => {
 	if (env === "testnet") return "https://testnet-agents.joai.ai";
 	return "https://agents.joai.ai";
 };
+const getGenBaseUrl = (env) => {
+	if (env === "local") return "http://localhost:3011";
+	if (env === "devnet") return "https://devnet-gen.joai.ai";
+	if (env === "testnet") return "https://testnet-gen.joai.ai";
+	return "https://gen.joai.ai";
+};
 const getMcpServerUrl = (env) => `${getCortexBaseUrl(env)}/mcp`;
 const getMcpServerAgentUrl = (env, agent) => `${getCortexBaseUrl(env)}/mcp/agents/${agent}`;
 const getSitesBaseUrl = (env) => {
@@ -366,16 +372,22 @@ const AddressTypes = {
 const addressTypeValues = Object.values(AddressTypes);
 //#endregion
 //#region src/address/formatAddressSnapshot.ts
+const pickLine = (...values) => values.find((value) => typeof value === "string" && value.trim().length > 0);
+/** Accepts camelCase API snapshots and legacy snake_case stored snapshots. */
 const formatAddressSnapshotLines = (address) => {
 	if (!address) return [];
+	const loose = address;
+	const addressOne = pickLine(address.addressOne, loose.address_one);
+	const addressTwo = pickLine(address.addressTwo, loose.address_two);
+	const postalCity = [pickLine(address.zipCode, loose.zip_code), pickLine(address.city)].filter(Boolean).join(" ");
 	return [
-		address.company,
-		address.addressOne,
-		address.addressTwo,
-		[address.zipCode, address.city].filter(Boolean).join(" "),
-		address.state,
-		address.country
-	].filter((line) => !!line && line.trim().length > 0);
+		pickLine(address.company),
+		addressOne,
+		addressTwo,
+		postalCity || void 0,
+		pickLine(address.state),
+		pickLine(address.country)
+	].filter((line) => !!line);
 };
 //#endregion
 //#region src/billing/orderStatus.ts
@@ -399,10 +411,12 @@ const isOrderInFulfillment = (status) => ORDER_FULFILLMENT_STATUSES.includes(sta
 const isOrderPostCheckout = (status) => ORDER_POST_CHECKOUT_STATUSES.includes(status);
 const resolveOrderStatusDisplay = (status, fulfillmentMethod) => {
 	if (fulfillmentMethod === "pickup") {
+		if (status === "pending") return "new";
 		if (status === "confirmed" || status === "processing") return "preparing";
 		if (status === "shipped") return "ready_for_pickup";
 		if (status === "delivered") return "picked_up";
 	}
+	if (!fulfillmentMethod && status === "delivered") return "paid";
 	return status;
 };
 const isPickupReady = (order) => order.fulfillmentMethod === "pickup" && (order.fulfillments ?? []).some((fulfillment) => fulfillment.status === "ready_for_pickup");
@@ -416,6 +430,122 @@ const isPickupOrderReady = (order) => {
 	if (fulfillments.length === 0) return true;
 	return !fulfillments.some((fulfillment) => fulfillment.status === "delivered");
 };
+const getPickupNextAction = (order) => {
+	if (order.fulfillmentMethod !== "pickup") return null;
+	if (order.status === "delivered" || order.status === "canceled" || order.status === "returned") return null;
+	if (isPickupOrderReady(order) || order.status === "shipped") return "mark_picked_up";
+	if (isOrderInFulfillment(order.status) && (order.items ?? []).some((item) => !item.digital)) return "mark_ready";
+	return null;
+};
+/** Allowed manual status targets for pickup (illegal jumps stay out). Ready/picked-up go via fulfillment. */
+const getPickupEditableStatuses = (status) => {
+	if (status === "pending") return ["pending", "canceled"];
+	if (status === "confirmed") return [
+		"confirmed",
+		"processing",
+		"canceled"
+	];
+	if (status === "processing") return ["processing", "canceled"];
+	if (status === "shipped") return ["shipped", "canceled"];
+	if (status === "delivered") return ["delivered"];
+	if (status === "canceled") return ["canceled"];
+	if (status === "returned") return ["returned"];
+	return [status];
+};
+/** Allowed manual status targets for shipping. Carrier ship stays on fulfillment; delivered closes the order. */
+const getShippingEditableStatuses = (status) => {
+	if (status === "pending") return ["pending", "canceled"];
+	if (status === "confirmed") return [
+		"confirmed",
+		"processing",
+		"delivered",
+		"canceled"
+	];
+	if (status === "processing") return [
+		"processing",
+		"delivered",
+		"canceled"
+	];
+	if (status === "shipped") return [
+		"shipped",
+		"delivered",
+		"canceled"
+	];
+	if (status === "delivered") return ["delivered"];
+	if (status === "canceled") return ["canceled"];
+	if (status === "returned") return ["returned"];
+	return [status];
+};
+/** Allowed manual status targets for invoice/service orders (no fulfillment method). */
+const getInvoiceEditableStatuses = (status) => {
+	if (status === "pending") return [
+		"pending",
+		"delivered",
+		"canceled"
+	];
+	if (status === "confirmed") return [
+		"confirmed",
+		"delivered",
+		"canceled"
+	];
+	if (status === "processing") return [
+		"processing",
+		"delivered",
+		"canceled"
+	];
+	if (status === "shipped") return [
+		"shipped",
+		"delivered",
+		"canceled"
+	];
+	if (status === "delivered" || status === "completed") return [status];
+	if (status === "canceled") return ["canceled"];
+	if (status === "returned") return ["returned"];
+	return [status];
+};
+/** Manual owner-editable statuses for the order's fulfillment context. */
+const getEditableOrderStatuses = (status, fulfillmentMethod) => {
+	if (fulfillmentMethod === "pickup") return getPickupEditableStatuses(status);
+	if (fulfillmentMethod === "shipping") return getShippingEditableStatuses(status);
+	return getInvoiceEditableStatuses(status);
+};
+const canTransitionOrderStatus = (from, to, fulfillmentMethod) => {
+	if (from === to) return true;
+	return getEditableOrderStatuses(from, fulfillmentMethod).includes(to);
+};
+const resolveFulfillmentFlowStep = (order) => {
+	if (!order.fulfillmentMethod) return null;
+	if (order.status === "canceled" || order.status === "returned") return "complete";
+	if (order.status === "pending") return "payment";
+	if (order.status === "delivered" || order.status === "completed") return "complete";
+	if (order.fulfillmentMethod === "pickup") {
+		if (isPickupOrderReady(order) || order.status === "shipped") return "dispatch";
+		return "prepare";
+	}
+	if (order.status === "shipped") return "dispatch";
+	return "prepare";
+};
+const getFulfillmentFlowAction = (order) => {
+	const step = resolveFulfillmentFlowStep(order);
+	if (step === "prepare" && isOrderInFulfillment(order.status)) {
+		if (!(order.items ?? []).some((item) => !item.digital)) return null;
+		return order.fulfillmentMethod === "pickup" ? "notify_ready" : "mark_shipped";
+	}
+	if (step === "dispatch") return order.fulfillmentMethod === "pickup" ? "mark_collected" : "mark_delivered";
+	return null;
+};
+/** Stepper index 0–3: payment → prepare → dispatch → complete. */
+const getFulfillmentFlowStepperIndex = (step) => {
+	if (step === "prepare") return 1;
+	if (step === "dispatch") return 2;
+	if (step === "complete") return 3;
+	return 0;
+};
+const canOpenFulfillmentFlow = (order) => {
+	if (!order.fulfillmentMethod || order.type !== "order") return false;
+	if (order.status === "canceled" || order.status === "returned") return false;
+	return (order.items ?? []).some((item) => !item.digital);
+};
 //#endregion
 //#region src/commerce/enums.ts
 const FulfillmentStatuses = {
@@ -449,6 +579,8 @@ const returnUpdateStatusValues = Object.values(ReturnUpdateStatuses);
 //#endregion
 //#region src/commerce/helpers.ts
 const cartLineTotal = (items) => items.reduce((total, item) => total + item.price * item.quantity, 0);
+/** Merchandise total after a discount (cents), never below zero. */
+const cartPayableTotal = (items, discountCents = 0) => Math.max(0, cartLineTotal(items) - Math.max(0, discountCents));
 const isCompleteAddressInput = (address) => Boolean(address.name.trim() && address.addressOne.trim() && address.city.trim() && address.zipCode.trim() && address.country.trim());
 //#endregion
 //#region src/budget/types.ts
@@ -600,10 +732,44 @@ const OgImageColors = {
 };
 //#endregion
 //#region src/ogimage/helpers.ts
-const OG_BASE = "https://gen.joai.ai/image/og";
-function ogImageUrl(type, params) {
+const withLocale = (path, locale) => {
+	if (!locale || locale === "en") return path;
+	return `${path}?locale=${encodeURIComponent(locale)}`;
+};
+function ogImageUrl(type, params, env = "mainnet") {
+	const base = `${getGenBaseUrl(env)}/image/og`;
 	switch (type) {
-		case "meeting": return `${OG_BASE}/meeting/${params.code}`;
+		case "meeting": return `${base}/meeting/${params.code}`;
+		case "action": {
+			const { slug, locale } = params;
+			return withLocale(`${base}/action/${encodeURIComponent(slug)}`, locale);
+		}
+		case "app": {
+			const { slug, locale } = params;
+			return withLocale(`${base}/app/${encodeURIComponent(slug)}`, locale);
+		}
+		case "actions": return `${base}/actions`;
+		case "apps": return `${base}/apps`;
+		case "changelog": return `${base}/changelog`;
+		case "agent": {
+			const { id, locale } = params;
+			return withLocale(`${base}/agent/${encodeURIComponent(id)}`, locale);
+		}
+		case "agents": return `${base}/agents`;
+		case "skill": return `${base}/skill/${encodeURIComponent(params.id)}`;
+		case "flow": return `${base}/flow/${encodeURIComponent(params.slug)}`;
+		case "blueprint": return `${base}/blueprint/${encodeURIComponent(params.slug)}`;
+		case "digest": return `${base}/digest/${encodeURIComponent(params.id)}`;
+		case "digests": return `${base}/digests`;
+		case "store": return `${base}/store`;
+		case "product": {
+			const { teamname, slug } = params;
+			return `${base}/store/${encodeURIComponent(teamname)}/${encodeURIComponent(slug)}`;
+		}
+		case "service": {
+			const { teamname, slug } = params;
+			return `${base}/store/service/${encodeURIComponent(teamname)}/${encodeURIComponent(slug)}`;
+		}
 	}
 }
 //#endregion
@@ -665,7 +831,8 @@ const NativeApps = {
 	Contracts: "contracts",
 	Artifacts: "artifacts",
 	Social: "social",
-	Studio: "studio"
+	Studio: "studio",
+	Loyalty: "loyalty"
 };
 const nativeAppSlugs = Object.values(NativeApps);
 const isNativeApp = (value) => typeof value === "string" && nativeAppSlugs.includes(value);
@@ -763,4 +930,4 @@ const DefaultInviteTeamRole = UserRoles.Member;
 const inviteableTeamRoles = () => [...InviteableTeamRoles];
 const defaultInviteTeamRole = () => DefaultInviteTeamRole;
 //#endregion
-export { AUTOMATION_SEND_CHANNELS, AddressTypes, AgentToolingAccess, BillingManageAccess, CAMPAIGN_CHANNELS, CONTACT_MESSAGE_SEND_WARP, ContractCategoryDisplayNames, DefaultCodeMetadata, DefaultInviteTeamRole, FulfillmentMethods, FulfillmentStatuses, HttpService, InviteableTeamRoles, JoaiUrls, NATIVE_AUTH_TOKEN_PARAM, NativeApps, OG_IMAGE_CONFIG, OG_IMAGE_HEIGHT, OG_IMAGE_WIDTH, ORDER_FULFILLMENT_STATUSES, ORDER_POST_CHECKOUT_STATUSES, OUTBOUND_CHANNELS, OgImageColors, PLATFORM_CURRENCY, PeriodTypeLabels, PeriodTypeOptions, PermissionPresetNames, ReturnStatuses, ReturnUpdateStatuses, SkillMediaBindingRole, SkillScope, SkillType, TeamManageAccess, TeamViewAccess, UNIFIED_MCP_SERVER_NAME, UserPermissions, UserRoles, abbreviateNumber, addressTypeValues, automationSendChannel, buildAgentMcpServerName, buildAgentSetupClipboardText, buildAppSetupClipboardText, buildFeatureSetupClipboardText, buildMcpServerName, cartLineTotal, createCursorMcpInstallLink, defaultInviteTeamRole, formatAddressSnapshotLines, fulfillmentMethodValues, fulfillmentStatusValues, getAgentSetupPromptUrl, getAgentsBaseUrl, getApiBaseUrl, getAppBaseUrl, getAssetAppLogoUrl, getAssetChainLogoUrl, getAssetPartnerLogoUrl, getAssetTokenLogoUrl, getAssetWalletLogoUrl, getCortexBaseUrl, getDigestBaseUrl, getFormsBaseUrl, getLoginUrl, getMcpServerAgentUrl, getMcpServerUrl, getSiteUrl, getSitesBaseUrl, getSitesRootDomain, getStoreBaseUrl, getWarpScreenshotUrl, hasAllPermissions, hasAllTeamPermissions, hasAnyPermissions, hasPermission, hasTeamPermission, integrationSlugForChannel, inviteableTeamRoles, isAutomationSendChannelId, isCampaignChannelId, isCompleteAddressInput, isContactMessageAction, isContactMessageWarpId, isFileFormatAudio, isFileFormatImage, isFileFormatVideo, isNativeApp, isNativeAppAccessible, isNativeAppGated, isNativeAppLocked, isOrderCanceled, isOrderInFulfillment, isOrderPending, isOrderPostCheckout, isPickupOrderReady, isPickupReady, isTeamFeatureAccessible, isTeamFeatureGated, isTeamFeatureLocked, isUnifiedMcpUrl, isUserRole, localize, nativeAppSlugs, normalizeAutomationActionType, ogImageUrl, outboundChannel, permissionPresetRules, resolveAccessCatalog, resolveAgentMcpUrl, resolveConnectMcpUrl, resolveOrderStatusDisplay, resolveTeamCurrency, resolveWarpText, returnStatusValues, returnUpdateStatusValues, sanitizeAlphanumeric, sanitizeNumeric, slugifyMcpSegment, teamCategories, toCurrencyDisplay, toHexEncodedNonce, toNameInitials, toNftId, toPreviewText, userPermissionValues, userRoleValues, withRetry };
+export { AUTOMATION_SEND_CHANNELS, AddressTypes, AgentToolingAccess, BillingManageAccess, CAMPAIGN_CHANNELS, CONTACT_MESSAGE_SEND_WARP, ContractCategoryDisplayNames, DefaultCodeMetadata, DefaultInviteTeamRole, FulfillmentMethods, FulfillmentStatuses, HttpService, InviteableTeamRoles, JoaiUrls, NATIVE_AUTH_TOKEN_PARAM, NativeApps, OG_IMAGE_CONFIG, OG_IMAGE_HEIGHT, OG_IMAGE_WIDTH, ORDER_FULFILLMENT_STATUSES, ORDER_POST_CHECKOUT_STATUSES, OUTBOUND_CHANNELS, OgImageColors, PLATFORM_CURRENCY, PeriodTypeLabels, PeriodTypeOptions, PermissionPresetNames, ReturnStatuses, ReturnUpdateStatuses, SkillMediaBindingRole, SkillScope, SkillType, TeamManageAccess, TeamViewAccess, UNIFIED_MCP_SERVER_NAME, UserPermissions, UserRoles, abbreviateNumber, addressTypeValues, automationSendChannel, buildAgentMcpServerName, buildAgentSetupClipboardText, buildAppSetupClipboardText, buildFeatureSetupClipboardText, buildMcpServerName, canOpenFulfillmentFlow, canTransitionOrderStatus, cartLineTotal, cartPayableTotal, createCursorMcpInstallLink, defaultInviteTeamRole, formatAddressSnapshotLines, fulfillmentMethodValues, fulfillmentStatusValues, getAgentSetupPromptUrl, getAgentsBaseUrl, getApiBaseUrl, getAppBaseUrl, getAssetAppLogoUrl, getAssetChainLogoUrl, getAssetPartnerLogoUrl, getAssetTokenLogoUrl, getAssetWalletLogoUrl, getCortexBaseUrl, getDigestBaseUrl, getEditableOrderStatuses, getFormsBaseUrl, getFulfillmentFlowAction, getFulfillmentFlowStepperIndex, getGenBaseUrl, getInvoiceEditableStatuses, getLoginUrl, getMcpServerAgentUrl, getMcpServerUrl, getPickupEditableStatuses, getPickupNextAction, getShippingEditableStatuses, getSiteUrl, getSitesBaseUrl, getSitesRootDomain, getStoreBaseUrl, getWarpScreenshotUrl, hasAllPermissions, hasAllTeamPermissions, hasAnyPermissions, hasPermission, hasTeamPermission, integrationSlugForChannel, inviteableTeamRoles, isAutomationSendChannelId, isCampaignChannelId, isCompleteAddressInput, isContactMessageAction, isContactMessageWarpId, isFileFormatAudio, isFileFormatImage, isFileFormatVideo, isNativeApp, isNativeAppAccessible, isNativeAppGated, isNativeAppLocked, isOrderCanceled, isOrderInFulfillment, isOrderPending, isOrderPostCheckout, isPickupOrderReady, isPickupReady, isTeamFeatureAccessible, isTeamFeatureGated, isTeamFeatureLocked, isUnifiedMcpUrl, isUserRole, localize, nativeAppSlugs, normalizeAutomationActionType, ogImageUrl, outboundChannel, permissionPresetRules, resolveAccessCatalog, resolveAgentMcpUrl, resolveConnectMcpUrl, resolveFulfillmentFlowStep, resolveOrderStatusDisplay, resolveTeamCurrency, resolveWarpText, returnStatusValues, returnUpdateStatusValues, sanitizeAlphanumeric, sanitizeNumeric, slugifyMcpSegment, teamCategories, toCurrencyDisplay, toHexEncodedNonce, toNameInitials, toNftId, toPreviewText, userPermissionValues, userRoleValues, withRetry };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@joai/core",
-  "version": "4.15.3",
+  "version": "4.15.5",
   "description": "JoAi shared types, HTTP service, and config",
   "license": "MIT",
   "type": "module",