@wix/himalaya-cli 0.1500.0 → 0.1502.0

package/dist/cli.mjs

@@ -2576,10 +2576,11 @@ __export(splash_exports, {
 import { existsSync as existsSync3, readFileSync as readFileSync4, readdirSync as readdirSync3 } from "node:fs";
 import { dirname as dirname4, join as join5 } from "node:path";
 function parseSplashConfig(configTs) {
-  const block = /splash\s*[:=]\s*\{([^}]*)\}/.exec(configTs);
+  const block = /["']?splash["']?\s*[:=]\s*\{([^}]*)\}/.exec(configTs);
   if (!block) return {};
-  const backgroundColor = /backgroundColor\s*:\s*["']([^"']+)["']/.exec(block[1])?.[1];
-  return backgroundColor ? { backgroundColor } : {};
+  const backgroundColor = /["']?backgroundColor["']?\s*:\s*["']([^"']+)["']/.exec(block[1])?.[1];
+  const logoAsset = /["']?logoAsset["']?\s*:\s*["']([^"']*)["']/.exec(block[1])?.[1];
+  return { ...backgroundColor ? { backgroundColor } : {}, ...logoAsset !== void 0 ? { logoAsset } : {} };
 }
 function nativeConfigInputTokens(configTs) {
   const declared = configTs ? parseSplashConfig(configTs).backgroundColor : void 0;
@@ -147009,7 +147010,7 @@ var init_template_trim = __esm({
       return Array.isArray(items) ? items : void 0;
     };
     NAV_SCREEN_KEYS = /* @__PURE__ */ new Set(["screenId", "parentScreenId", "contentScreenId", "badgeScreenId"]);
-    WORKER_SCREEN_PARAMS = /* @__PURE__ */ new Set(["signInScreen"]);
+    WORKER_SCREEN_PARAMS = /* @__PURE__ */ new Set(["signInScreen", "productScreen", "serviceScreen"]);
     sorted = (xs2) => [...new Set(xs2)].sort();
     refuse3 = (e2) => ({ code: 2, result: { ok: false, error: e2.message, ...e2.detail } });
     plural = (n2, word) => `${n2} ${word}${n2 === 1 ? "" : "s"}`;

package/guides/splash-screens.md

@@ -199,8 +199,8 @@ holding the readiness wait there would defeat the point of making this layer OTA
 Two seams, and only one of them needs work:
 
 - **OS splash → in-app surface.** The background is **already continuous** — both layers
-  resolve the same colour token — so there is nothing to cross-fade there. What would
-  otherwise pop is the *content*, so `HimalayaSplashView` / `HimalayaSplash` ease the
+  resolve the same colour token — Android fades a declared gradient over this opaque base in 400 ms.
+  The *content* also eases in, so `HimalayaSplashView` / `HimalayaSplash` ease the
   logo and caption in over `contentFadeInMs`.
 - **In-app surface → real content.** Fades out over a fixed `exitFadeMs` (350 ms), via
   `.splashExitAnimation(ready:)` on iOS and `HimalayaSplashHost` on Android.
@@ -340,3 +340,57 @@ Note that the `splash` accessibility id / `testTag` on some apps today belongs t
 - [designing-himi-screens.md](designing-himi-screens.md) — composing the launch moment as design.
 - [RFC 0012](../core/schema/RFC/0012-screen-rollout-and-authoring.md) — the binary/OTA seam.
 - [RFC 0021](../core/schema/RFC/0021-design-kits.md) — why the background is a token.
+
+### Branded-lite logo and handoff
+
+Use the baked branded-lite app icon as the in-app logo:
+
+```ts
+splash: { enabled: true, logoAsset: "branded_lite_app_icon", logoWidth: 160 }
+```
+
+Hide the logo on both Android splash layers with an **explicit empty string**:
+
+```ts
+splash: { enabled: true, logoAsset: "" }
+```
+
+`logoWidth` is the square in-app logo size in logical points/dp (default 96 for absent or non-positive values). It does not resize Android's OS-controlled icon slot.
+Omitting `logoAsset` retains existing behavior: no in-app logo; the OS uses the
+launcher icon. An empty value also produces no in-app logo on iOS, macOS and web.
+Android 12+ always reserves an icon slot: the build emits a transparent splash
+icon when hidden, while preserving the actual launcher icon. This native change
+requires a new binary; changing the served block alone only changes the in-app layer.
+
+A declared `splash.backgroundColor` now overrides branded-lite's provisioning
+primary color for the native launch background, in both light and dark appearance.
+Without it the provisioning color remains the default. For a gradient, set this
+token to its first/top color. Android and iOS/macOS paint that solid color first and fade the
+gradient over it in 400 ms (immediate with reduce motion or Determinism).
+The Android branded-lite shell mounts its first screen beneath the splash after
+seeding and dismisses after that screen draws a descriptor (including a worker's
+initial loading state) or an error. Explicit `readySignal: "first_content"`
+retains the WebView page-loaded signal. `maxHoldMs` remains the hard deadline;
+auth gates also count as first content. The iOS branded-lite shell likewise mounts its
+content beneath the overlay and waits for loaded content or an error to appear,
+within the same deadline. Once dismissed, the iOS splash stays dismissed even if
+OTA timing settings change. Branded-lite Android image splashes use translucent dark system-bar
+scrims with light icons for legibility; color and gradient splashes remain full-bleed.
+Web retains its current transitions and readiness.
+The standalone branded-lite macOS shell currently does not mount a boot splash
+overlay; `splash.enabled` does not enable one there. The shared SwiftUI background
+renderer is available on macOS, but this host handoff integration covers Android
+and iOS. macOS shell integration requires a separate change.
+
+Branded-lite builds expose the launcher artwork as the regular iOS image asset
+`branded_lite_app_icon`, so the same logo configuration works on Android and iOS.
+
+Native iOS hosts that use `HimalayaScreenHost` can opt into
+`.onHimalayaScreenContent { ... }` to observe the appearance of loaded content or
+an error. The callback ignores the host loader and does not replace a WebView's
+page-loaded readiness signal. Existing hosts behave as before unless they opt in.
+
+If cached splash configuration references missing or invalid colors after a binary
+update, native splash stops fall back to the flat background, then `accentPrimary`,
+then opaque white. Branded-lite also shows a shell loader if `maxHoldMs` expires
+before seed prefill completes; the deadline remains unchanged.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/himalaya-cli",
-  "version": "0.1500.0",
+  "version": "0.1502.0",
   "type": "module",
   "description": "himi — the Himalaya authoring CLI. Build a Tier-5 content package on your own machine, push it to the production serve as a draft, preview it on web + Himi Player, and read worker logs back — the remote dev loop. Wraps @himalaya/serve-cli for transport.",
   "keywords": [
@@ -71,5 +71,5 @@
       "artifactId": "himalaya-cli"
     }
   },
-  "falconPackageHash": "e222405d52f4c02637f42bee8bea3261dd918b3661be44c4db36b236"
+  "falconPackageHash": "82f6fd0420b1bcd4738afd24ff1b18fa4a0df4fdf4813e7596851c23"
 }

package/templates/branded-lite/dev/index.ts

@@ -89216,24 +89216,65 @@ const SCREENS = runtimeSetting({
                                                           "itemsPath": "$item.articleActions",
                                                           "items": [
                                                             {
-                                                              "id": "himi_business_chat.article_action_$item.id",
+                                                              "id": "himi_business_chat.article_action.slot.$item.id",
                                                               "body": {
                                                                 "package": "himalaya",
-                                                                "type": "Button",
+                                                                "type": "VStack",
                                                                 "props": {
-                                                                  "title": "$item.label",
-                                                                  "style": "secondary",
-                                                                  "size": "sm",
-                                                                  "fullWidth": false,
-                                                                  "action": {
-                                                                    "actionId": "capability.open_url.open",
-                                                                    "params": {
-                                                                      "url": "$item.url"
+                                                                  "children": [
+                                                                    {
+                                                                      "id": "himi_business_chat.article_action.web.$item.id",
+                                                                      "body": {
+                                                                        "package": "himalaya",
+                                                                        "type": "Button",
+                                                                        "props": {
+                                                                          "title": "$item.label",
+                                                                          "style": "secondary",
+                                                                          "size": "sm",
+                                                                          "fullWidth": false,
+                                                                          "action": {
+                                                                            "actionId": "capability.open_url.open",
+                                                                            "params": {
+                                                                              "url": "$item.url"
+                                                                            }
+                                                                          }
+                                                                        }
+                                                                      },
+                                                                      "modifiers": {
+                                                                        "hiddenPath": "$item.inApp"
+                                                                      }
+                                                                    },
+                                                                    {
+                                                                      "id": "himi_business_chat.article_action.app.$item.id",
+                                                                      "body": {
+                                                                        "package": "himalaya",
+                                                                        "type": "Button",
+                                                                        "props": {
+                                                                          "title": "$item.label",
+                                                                          "style": "secondary",
+                                                                          "size": "sm",
+                                                                          "fullWidth": false,
+                                                                          "action": {
+                                                                            "actionId": "himi.open",
+                                                                            "params": {
+                                                                              "screenId": "$item.screenId",
+                                                                              "id": "$item.targetId"
+                                                                            }
+                                                                          }
+                                                                        }
+                                                                      },
+                                                                      "modifiers": {
+                                                                        "hiddenPath": "$item.web"
+                                                                      }
                                                                     }
-                                                                  }
+                                                                  ],
+                                                                  "spacing": 0,
+                                                                  "alignment": "leading"
                                                                 }
                                                               },
-                                                              "modifiers": {}
+                                                              "modifiers": {
+                                                                "fillMaxWidth": true
+                                                              }
                                                             }
                                                           ],
                                                           "spacing": 6
@@ -89607,24 +89648,65 @@ const SCREENS = runtimeSetting({
                                                                   "itemsPath": "$item.articleActions",
                                                                   "items": [
                                                                     {
-                                                                      "id": "himi_business_chat.card_action_$item.id",
+                                                                      "id": "himi_business_chat.card_action.slot.$item.id",
                                                                       "body": {
                                                                         "package": "himalaya",
-                                                                        "type": "Button",
+                                                                        "type": "VStack",
                                                                         "props": {
-                                                                          "title": "$item.label",
-                                                                          "style": "secondary",
-                                                                          "size": "md",
-                                                                          "fullWidth": true,
-                                                                          "action": {
-                                                                            "actionId": "capability.open_url.open",
-                                                                            "params": {
-                                                                              "url": "$item.url"
+                                                                          "children": [
+                                                                            {
+                                                                              "id": "himi_business_chat.card_action.web.$item.id",
+                                                                              "body": {
+                                                                                "package": "himalaya",
+                                                                                "type": "Button",
+                                                                                "props": {
+                                                                                  "title": "$item.label",
+                                                                                  "style": "secondary",
+                                                                                  "size": "md",
+                                                                                  "fullWidth": true,
+                                                                                  "action": {
+                                                                                    "actionId": "capability.open_url.open",
+                                                                                    "params": {
+                                                                                      "url": "$item.url"
+                                                                                    }
+                                                                                  }
+                                                                                }
+                                                                              },
+                                                                              "modifiers": {
+                                                                                "hiddenPath": "$item.inApp"
+                                                                              }
+                                                                            },
+                                                                            {
+                                                                              "id": "himi_business_chat.card_action.app.$item.id",
+                                                                              "body": {
+                                                                                "package": "himalaya",
+                                                                                "type": "Button",
+                                                                                "props": {
+                                                                                  "title": "$item.label",
+                                                                                  "style": "secondary",
+                                                                                  "size": "md",
+                                                                                  "fullWidth": true,
+                                                                                  "action": {
+                                                                                    "actionId": "himi.open",
+                                                                                    "params": {
+                                                                                      "screenId": "$item.screenId",
+                                                                                      "id": "$item.targetId"
+                                                                                    }
+                                                                                  }
+                                                                                }
+                                                                              },
+                                                                              "modifiers": {
+                                                                                "hiddenPath": "$item.web"
+                                                                              }
                                                                             }
-                                                                          }
+                                                                          ],
+                                                                          "spacing": 0,
+                                                                          "alignment": "leading"
                                                                         }
                                                                       },
-                                                                      "modifiers": {}
+                                                                      "modifiers": {
+                                                                        "fillMaxWidth": true
+                                                                      }
                                                                     }
                                                                   ],
                                                                   "spacing": 6
@@ -89990,7 +90072,12 @@ const SCREENS = runtimeSetting({
           "token": "surfaceSecondary"
         },
         "onAppear": {
-          "actionId": "tier5.businessChat.init"
+          "actionId": "tier5.businessChat.init",
+          "params": {
+            "siteUrl": "__HIMI_MEMBER_SITE_URL__",
+            "productScreen": "himi_product",
+            "serviceScreen": "himi_service"
+          }
         }
       }
     },

package/templates/branded-lite/tier5-src/_shared/business-chat-presenter.ts

@@ -14,7 +14,26 @@ export type BusinessMessagePart = {
 
 export type BusinessTextRun = { text: string; marks?: string[] };
 export type BusinessSuggestion = { id: string; messageId: string; label: string; kind: "postback" | "visitor_option"; appId?: string; interactionId?: string; enabled: boolean; disabled: boolean };
-export type BusinessArticleAction = { id: string; label: string; url: string; style: "primary" | "secondary" };
+/** `inApp` buttons open `screenId` with `targetId` inside the app; the rest open `url` in the browser. Only a
+ *  `routable` one (a link in the text or a template button, never a file) may be opened in the app. */
+export type BusinessArticleAction = { id: string; label: string; url: string; style: "primary" | "secondary"; screenId: string; targetId: string; inApp: boolean; web: boolean; routable: boolean };
+/** The app's own screen for a site link, named by the slug in the link's path. */
+export type BusinessInAppRoute = { kind: "product" | "service"; slug: string };
+
+/** A store product page or a bookings service (its page or its booking calendar) on this app's own site has a screen
+ *  in the app; another site's page (even one on the same host, as Wix sites share one), a pay link or a file has
+ *  none, and with no site configured nothing is routed. The slug only names the item: the worker still has to find it. */
+export function businessInAppRoute(url: string, siteUrl: string): BusinessInAppRoute | undefined {
+  const site = /^https:\/\/[^/?#\s]+(?:\/[^?#\s]*)?/i.exec(siteUrl.trim())?.[0].replace(/\/+$/, "") ?? "";
+  if (!site || !url.toLowerCase().startsWith(`${site.toLowerCase()}/`)) return undefined;
+  const match = /^\/(product-page|service-page|booking-calendar)\/([^/?#]+)\/?(?:[?#].*)?$/i.exec(url.slice(site.length));
+  if (!match) return undefined;
+  let slug: string;
+  // A malformed escape ("50%-off") names nothing the app can look up: the link stays a web link.
+  try { slug = decodeURIComponent(match[2]!); } catch { return undefined; }
+  return slug ? { kind: match[1]!.toLowerCase() === "product-page" ? "product" : "service", slug } : undefined;
+}
+const webAction = { screenId: "", targetId: "", inApp: false, web: true, routable: true };
 export type BusinessVisitorOptions = { answerTo: string; labels: string[] };
 
 export type BusinessMessage = {
@@ -274,7 +293,7 @@ function articleActions(message: RecordValue, messageId: string): BusinessArticl
     if (!label || !rawUrl || button.payload != null) return [];
     // No `URL` global in a worker: accept only a plain https URL whose authority carries no credentials.
     if (!isSafeLink(rawUrl)) return [];
-    return [{ id: `${messageId}:article-${index}`, label, url: rawUrl, style: "secondary" as const }];
+    return [{ id: `${messageId}:article-${index}`, label, url: rawUrl, style: "secondary" as const, ...webAction }];
   });
 }
 
@@ -471,7 +490,8 @@ export function presentBusinessMessages<T extends Pick<BusinessMessage, "id" | "
     const productPage = cardLike && !isAiGenerated ? [...extras.links, ...articleActions(message, row.id)].map((link) => /^https:\/\/[^/?#]+(?:\/[^/?#]+)*?\/product-page\/([^/?#]+)/i.exec(link.url)?.[1]).find(Boolean) : undefined;
     // A file, recording or video has no inline player here: it gets a button that opens it.
     const attachmentLinks = row.parts.filter((part) => (part.kind === "file" || part.kind === "audio" || part.kind === "video") && !!part.url)
-      .map((part, at) => ({ id: `${row.id}:attachment-${at}`, label: (part.fileName || part.caption || `Open ${part.kind}`).slice(0, 40), url: part.url as string, style: "secondary" as const }));
+      // A file, recording or video always opens as itself in the browser, wherever its URL lives.
+      .map((part, at) => ({ id: `${row.id}:attachment-${at}`, label: (part.fileName || part.caption || `Open ${part.kind}`).slice(0, 40), url: part.url as string, style: "secondary" as const, ...webAction, routable: false }));
     // The card look (a framed box with a centred title) is for what an owner tool sends: a product, coupon, scheduling
     // or pay link, an event, or a file. A coupon's title is its code, which the coupon block already shows.
     // An AI answer is text with link pills, as on the site's Smart Chat, even when it is shaped like a card.
@@ -481,7 +501,7 @@ export function presentBusinessMessages<T extends Pick<BusinessMessage, "id" | "
     // Inbox adds to the text is left out of it.
     const cardLines = cardTitle ? lines.slice(1) : titled.split("\n");
     const cardDetail = (productPage ? cardLines.filter((line) => !/^\s*\d+\s+variants?\b|\|\s*(?:in|out of)\s+stock\s*$/i.test(line)) : cardLines).join("\n");
-    const articles = [...articleActions(message, row.id), ...attachmentLinks, ...extras.links.map((link, at) => ({ id: `${row.id}:link-${at}`, label: link.label, url: link.url, style: /\b(view|buy|shop|book|pay|order|checkout|reserve|schedule)\b/i.test(link.label) ? "primary" as const : "secondary" as const }))]
+    const articles = [...articleActions(message, row.id), ...attachmentLinks, ...extras.links.map((link, at) => ({ id: `${row.id}:link-${at}`, label: link.label, url: link.url, style: /\b(view|buy|shop|book|pay|order|checkout|reserve|schedule)\b/i.test(link.label) ? "primary" as const : "secondary" as const, ...webAction }))]
       .filter((action, at, all) => all.findIndex((other) => other.url === action.url) === at);
 
     return {

package/templates/branded-lite/tier5-src/business-chat/index.ts

@@ -4,16 +4,17 @@ import type { ChatIdentity } from '../_shared/business-chat-transport.js';
 import { type MessageRow } from '../_shared/business-chat-message-model.js';
 import { businessChatSendRejected, messageTimeLabel, sendAnchor, pendingIntentWasObserved, chronologicalMessages, newBusinessChatIntent, type BusinessChatIntent } from '../_shared/business-chat-model.js';
 import { subscribeRealtime, unsubscribeRealtime, getRealtimeStatus, type RealtimeStatus, type RealtimeEventEnvelope } from '@himalaya/wix-chat';
-import { dispatchBusinessSuggestion, businessRealtimeStatusLabel, businessVisitorOptionSuggestions, presentBusinessMessages, selectExistingBusinessRoom, shouldRefreshBusinessHistory, type BusinessSuggestion, type BusinessVisitorOptions, businessVisitorOptionRequest, businessVisitorOptionsFromAiMessages, newBusinessSelectionId} from '../_shared/business-chat-presenter.js';
+import { businessInAppRoute, type BusinessArticleAction, dispatchBusinessSuggestion, businessRealtimeStatusLabel, businessVisitorOptionSuggestions, presentBusinessMessages, selectExistingBusinessRoom, shouldRefreshBusinessHistory, type BusinessSuggestion, type BusinessVisitorOptions, businessVisitorOptionRequest, businessVisitorOptionsFromAiMessages, newBusinessSelectionId} from '../_shared/business-chat-presenter.js';
 import { listMessages, streamMessages } from '@himalaya/wix-ai-site-chat';
 import { hostSiteFromInput } from '../_shared/branded-lite-hosted.js';
 import { productImage, searchStoreProducts } from '../_shared/himi-store.js';
+import { queryServices } from '@himalaya/wix-bookings';
 
 type PendingIntent = BusinessChatIntent;
 // Only what the screen reads. This state crosses into the worker on every keystroke, so a row carries no raw
 // parts, plain text or text runs: they would be re-sent each time for nothing.
 type BusinessMessageRow = Pick<MessageRow,'id'|'sender'|'when'|'createdDate'|'mine'> & {
- senderAvatar:string; senderName:string; senderInitials:string; senderBadge:string; imageUrl:string; imageDescription:string; noImage:boolean; bodyText:string; bodyMarkdown:string; suggestions:BusinessSuggestion[]; articleActions:{id:string;label:string;url:string;style:'primary'|'secondary'}[]; couponCode:string; noCoupon:boolean; notMine:boolean;
+ senderAvatar:string; senderName:string; senderInitials:string; senderBadge:string; imageUrl:string; imageDescription:string; noImage:boolean; bodyText:string; bodyMarkdown:string; suggestions:BusinessSuggestion[]; articleActions:BusinessArticleAction[]; couponCode:string; noCoupon:boolean; notMine:boolean;
  isCard:boolean; notCard:boolean; noSuggestions:boolean; noActions:boolean; cardTitle:string; cardDetail:string; noCardText:boolean;
  dayLabel:string; dayHidden:boolean; startsDay:boolean; scrollAnchor:string;
  /** Only the member's own row that the server has not returned yet. */
@@ -82,6 +83,7 @@ function safeLoadFailure(error:unknown):string{
  return `${loadStage}:${/^(TypeError|SyntaxError|ProtocolError|Unsupported|Error)$/.test(name)?name:'OtherError'}${safeCode}`;
 }
 function value(arg:unknown):string{if(typeof arg==='string')return arg;const a=arg as Record<string,unknown>|null;return typeof a?.value==='string'?a.value:'';}
+function hasParam(arg:unknown,key:string):boolean{const a=arg as Record<string,unknown>|null;const p=a?.params as Record<string,unknown>|undefined;return typeof a?.[key]==='string'||typeof p?.[key]==='string';}
 function param(arg:unknown,key:string):string{const a=arg as Record<string,unknown>|null;const p=a?.params as Record<string,unknown>|undefined;return typeof a?.[key]==='string'?a[key] as string:typeof p?.[key]==='string'?p[key] as string:'';}
 // A private attachment's download URL costs a round trip and stays valid for minutes, so a refresh reuses it.
 const attachmentUrls=new Map<string,{url:string;at:number}>();
@@ -94,21 +96,26 @@ async function privateAttachmentUrl(part:{mediaId?:string;mediaProvider?:string;
  if(url)attachmentUrls.set(key,{url,at:Date.now()});
  return url;
 }
-// A product card's picture comes from the store: the message carries only the product page link. A found picture is
-// reused for ten minutes and a miss for two, so a refresh never repeats the lookup.
-const productImages=new Map<string,{url:string;at:number}>();
-const productImageLookups=new Map<string,Promise<string>>();
+// A product card's picture comes from the store: the message carries only the product page link. A found product is
+// reused for ten minutes and a miss for two, so a refresh never repeats the lookup. Its id opens it in the app.
+/** `id` is the product the link names (same slug) and opens it in the app; the picture may also come from a product of
+ *  the same name, which never stands in for the link's own product. */
+type FoundProduct={url:string;id:string};
+const productImages=new Map<string,FoundProduct&{at:number}>();
+const productImageLookups=new Map<string,Promise<FoundProduct>>();
 const PRODUCT_IMAGE_TTL_MS=10*60*1000;
 const PRODUCT_IMAGE_MISS_TTL_MS=2*60*1000;
-function productImageFor(slug:string,name:string):Promise<string>{
+function productImageFor(slug:string,name:string):Promise<FoundProduct>{
  // Keyed by both: the search runs on the name, so a miss for one name must not hide a hit for another.
  const key=JSON.stringify([slug,name]);
  const hit=productImages.get(key);
- if(hit&&Date.now()-hit.at<(hit.url?PRODUCT_IMAGE_TTL_MS:PRODUCT_IMAGE_MISS_TTL_MS))return Promise.resolve(hit.url);
+ if(hit&&Date.now()-hit.at<(hit.id?PRODUCT_IMAGE_TTL_MS:PRODUCT_IMAGE_MISS_TTL_MS))return Promise.resolve({url:hit.url,id:hit.id});
  const running=productImageLookups.get(key);
  if(running)return running;
- const lookup=(async()=>{
-  let url='';
+ // A reset (sign-out, another member or business) bumps `epoch`: a lookup it overtook must not fill the new cache.
+ const startEpoch=epoch;
+ const lookup:Promise<FoundProduct>=(async()=>{
+  let url='';let id='';
   try{
    // The name first; then the link's own words, for a product renamed since the message was written. The slug is the
    // identity, so a same-named product with another slug is used only if neither search finds the slug.
@@ -123,13 +130,48 @@ function productImageFor(slug:string,name:string):Promise<string>{
    }
    const match=bySlug??sameName;
    if(match)url=productImage(match);
-  }catch{url='';}
-  productImages.set(key,{url,at:Date.now()});
-  return url;
- })().finally(()=>{productImageLookups.delete(key);});
+   if(bySlug)id=typeof bySlug.id==='string'?bySlug.id:'';
+  }catch{url='';id='';}
+  if(startEpoch===epoch)productImages.set(key,{url,id,at:Date.now()});
+  return {url,id};
+ })().finally(()=>{if(productImageLookups.get(key)===lookup)productImageLookups.delete(key);});
  productImageLookups.set(key,lookup);
  return lookup;
 }
+// A bookings service named by a link's slug, cached like a product (a miss for less time). The first history load
+// routes every row at once, so links to the same service share one lookup while it is running.
+const serviceIds=new Map<string,{id:string;at:number}>();
+const serviceIdLookups=new Map<string,Promise<string>>();
+function serviceIdFor(slug:string):Promise<string>{
+ const hit=serviceIds.get(slug);
+ if(hit&&Date.now()-hit.at<(hit.id?PRODUCT_IMAGE_TTL_MS:PRODUCT_IMAGE_MISS_TTL_MS))return Promise.resolve(hit.id);
+ const running=serviceIdLookups.get(slug);
+ if(running)return running;
+ const startEpoch=epoch;
+ const lookup:Promise<string>=(async()=>{
+  let id='';
+  try{
+   const found=(await queryServices({query:{filter:{'mainSlug.name':{$eq:slug}},paging:{limit:1}}})).services??[];
+   id=typeof found[0]?.id==='string'?found[0].id:'';
+  }catch{id='';}
+  if(startEpoch===epoch)serviceIds.set(slug,{id,at:Date.now()});
+  return id;
+ })().finally(()=>{if(serviceIdLookups.get(slug)===lookup)serviceIdLookups.delete(slug);});
+ serviceIdLookups.set(slug,lookup);
+ return lookup;
+}
+/** A button whose link the app has a screen for opens that screen; a link it cannot place stays a web link. */
+// This app's own site and the screens it has for products and services, as the screen passes them to `init`: only
+// its own site's pages, and only to a screen the app registers, are opened in the app.
+let ownSiteUrl='';
+const ownScreens={product:'',service:''};
+async function routeAction(action:BusinessArticleAction,productName:string):Promise<BusinessArticleAction>{
+ const route=action.routable?businessInAppRoute(action.url,ownSiteUrl):undefined;
+ const screenId=route?ownScreens[route.kind]:'';
+ if(!route||!screenId)return action;
+ const id=route.kind==='product'?(await productImageFor(route.slug,productName)).id:await serviceIdFor(route.slug);
+ return id?{...action,screenId,targetId:id,inApp:true,web:false}:action;
+}
 function slimRow(row:Record<string,unknown>):BusinessMessageRow{
  const pick=(...keys:string[])=>Object.fromEntries(keys.map(key=>[key,row[key]]));
  return pick('id','sender','when','createdDate','mine','senderAvatar','senderName','senderInitials','senderBadge','imageUrl','imageDescription','noImage','bodyText','bodyMarkdown','suggestions','articleActions','couponCode','noCoupon','notMine','isCard','notCard','noSuggestions','noActions','cardTitle','cardDetail','noCardText','dayLabel','dayHidden','startsDay','scrollAnchor') as unknown as BusinessMessageRow;
@@ -149,9 +191,12 @@ async function presentMessages(existing:MessageRow[],raw:unknown[],memberId?:str
  const presented=presentBusinessMessages(prepared as unknown as Parameters<typeof presentBusinessMessages>[0],raw,businessParticipantId) as unknown as Record<string,unknown>[];
  await Promise.all(presented.map(async row=>{
   const slug=typeof row.productSlug==='string'?row.productSlug:'';
-  if(!slug||row.imageUrl)return;
-  const url=await productImageFor(slug,String(row.productName||''));
-  if(url)Object.assign(row,{imageUrl:url,noImage:false,imageDescription:String(row.productName||'Product image')});
+  const name=String(row.productName||'');
+  if(slug&&!row.imageUrl){
+   const {url}=await productImageFor(slug,name);
+   if(url)Object.assign(row,{imageUrl:url,noImage:false,imageDescription:name||'Product image'});
+  }
+  row.articleActions=await Promise.all((row.articleActions as BusinessArticleAction[]).map(action=>routeAction(action,name)));
  }));
  return presented.map(slimRow);
 }
@@ -178,7 +223,7 @@ function safeError(error:unknown,operation:'load'|'send'|'init'):string{
 }
 async function endSubscription():Promise<void>{const id=subscriptionId;subscriptionId='';if(id)try{await unsubscribeRealtime({subscriptionId:id});}catch{}}
 function clearPrivate(s:State,phase:'guest'|'error'='guest'):State{
- attachmentUrls.clear();productImages.clear();currentIdentity=null;businessParticipantId='';epoch++;void endSubscription();
+ attachmentUrls.clear();productImages.clear();productImageLookups.clear();serviceIds.clear();serviceIdLookups.clear();currentIdentity=null;businessParticipantId='';epoch++;void endSubscription();
  return shape({...initial,phase,error:phase==='guest'?'Sign in to send a message.':s.error});
 }
 let refreshTail:Promise<unknown>=Promise.resolve();
@@ -259,8 +304,11 @@ async function deliver(pending:BusinessChatIntent,draft:string):Promise<void>{
 const svc=defineService<State,Record<string,(s:State,a?:unknown)=>State|undefined|Promise<State|undefined>>>('businessChat',{
  state:shape(initial),notHydrated:Object.keys(initial) as (keyof State)[],
  actions:{
-  init:async s=>{
+  init:async(s,a)=>{
    if(initFlight)return s;initFlight=true;eventDuringInit=false;statusDuringInit=null;
+   // A retry passes no site: the one the screen gave first stays. A site the screen passes, even an empty one (a
+   // business with no site), replaces it, so an earlier business's links are not routed to this one's screens.
+   if(hasParam(a,'siteUrl')){ownSiteUrl=param(a,'siteUrl');ownScreens.product=param(a,'productScreen');ownScreens.service=param(a,'serviceScreen');}
    const oldPrincipal=s.principal;
    const initRevision=draftRevision;
    // Text typed at any point of the load, subscribe step included, outlives the snapshot this started from. So does the
@@ -418,7 +466,7 @@ const svc=defineService<State,Record<string,(s:State,a?:unknown)=>State|undefine
    }
    catch(error){if(startEpoch!==epoch)return undefined;const lost=/member_sign_in_required|MemberAccessChanged|\b401\b|\b403\b/i.test(String(error));return lost?clearPrivate(next,'guest'):shape({...withLiveDraft(next),error:safeError(error,'load'),loadFailure:typeof (error as {businessLoadFailure?:unknown})?.businessLoadFailure==='string'?(error as {businessLoadFailure:string}).businessLoadFailure:safeLoadFailure(error)});}
   },
-  dispose:async s=>{epoch++;attachmentUrls.clear();productImages.clear();currentIdentity=null;businessParticipantId='';await endSubscription();return shape({...initial,phase:'guest'});},
+  dispose:async s=>{epoch++;attachmentUrls.clear();productImages.clear();productImageLookups.clear();serviceIds.clear();serviceIdLookups.clear();currentIdentity=null;businessParticipantId='';await endSubscription();return shape({...initial,phase:'guest'});},
  }
 });
 readServiceState=()=>svc.getState();