@wix/himalaya-cli 0.1030.0 → 0.1032.0

package/guides/mobile-ux.md

@@ -199,8 +199,9 @@ tried in this order:
   `--width`/`--device` records nothing on purpose: without one the PNG viewport is the headless
   browser's desktop default, and writing that down would manufacture the very expanded render the
   marker exists to prove. Recording never fails or slows a render — if the file cannot be written
-  the render still succeeds, and the paths below still apply. `.himi/` is gitignored, so this is
-  evidence about your checkout rather than something a pull request carries.
+  the render still succeeds, and the paths below still apply. `.himi/` is gitignored (`himi init`
+  writes that rule into the package's `.gitignore`; add it yourself to a package made another way),
+  so this is evidence about your checkout rather than something a pull request carries.
 
 - Or name two pixel widths in the document, spanning compact → wider,
   **each spelled as a width on itself**, within about 400 characters of each other so they read as

package/guides/qa-builds.md

@@ -958,10 +958,12 @@ Two details that are easy to get wrong, both verified against a real baked seed
 
 Known edges, stated rather than implied: `seed-data.json` (entity snapshots) is **not** release
 content — it comes from the app's source module, so the pool copies it when the checkout has the
-app and otherwise ships `{}`, and those screens show empty states until the first sync. The icon
-and widget snapshots are single-slot per app with no release id, so a pinned release gets whatever
-is live; the envelope hashes the live bytes against the manifest's `iconHash`/per-widget
-`contentEtag` and **warns** on drift while still baking the live asset.
+app and otherwise ships `{}`, and those screens show empty states until the first sync. The widget
+snapshots are single-slot per app with no release id, so a pinned release gets whatever is live;
+the icon is too, but only for an older release published before releases kept their own icon —
+every later one, draft included, bakes its own content-addressed copy. On that live-slot path the envelope hashes the live bytes
+against the manifest's `iconHash`/per-widget `contentEtag` and **warns** on drift while still
+baking the live asset.
 
 ## The install link
 
@@ -999,11 +1001,16 @@ is live; the envelope hashes the live bytes against the manifest's `iconHash`/pe
   `identity.appName`, `native.androidApplicationId`, `native.urlScheme` and `native.appLinkHost`
   with unchecked `as String`, so a missing one fails during configure with no mention of branding —
   a test pins that the projection always emits all four.
-- **No icon in the release?** `/v1/dist/contract` projects a published release and `putIcon` is
-  live-only single-slot, so a **draft** release (what `--release` usually points at) has no icon and
-  the served contract's `appIconPath` is empty — which `prepare:customer` rejects on purpose. The
-  pool fills it from the shell's own committed `provisioning.json`, so the build degrades to the
-  shell's artwork instead of failing over branding.
+- **Which icon does the build get?** The pinned release's **own**, draft or live. Publish keeps a
+  content-addressed copy of the launcher icon under the release's `iconHash`, and both
+  `/v1/dist/contract` and `/v1/dist/seed` read that copy first — so a QA build of an approved
+  **draft** carries the customer's icon without promoting anything live. Only an older release,
+  published before that copy existed, falls back to the app's single live icon slot (`putIcon`), and
+  the seed then warns if the live icon is not the one the release recorded.
+- **No icon at all?** When neither the release nor the live slot has one, the served contract's
+  `appIconPath` is empty — which `prepare:customer` rejects on purpose. The pool fills it from the
+  shell's own committed `provisioning.json`, so the build degrades to the shell's artwork instead
+  of failing over branding.
 
 ## Where the baked seed comes from
 
@@ -1034,10 +1041,12 @@ Two honest edges:
   never served over OTA — it is a build-time input from the app's own source module. The pool copies
   it when this checkout happens to have the app, else ships `{}` and those screens show empty states
   until the first sync.
-- **The icon and widget snapshots are single-slot per app** (`put/getIcon`, `put/getWidget`) with no
-  release id, so a pinned release cannot read "its own" copy — it gets whatever is live. The
-  endpoint hashes the live bytes against the manifest's `iconHash` / per-widget `contentEtag` and
-  **warns** when they differ; the build still bakes the live asset, but the drift is in the log.
+- **The widget snapshots are single-slot per app** (`put/getWidget`) with no release id, so a
+  pinned release cannot read "its own" copy — it gets whatever is live. The icon reads the
+  release's own content-addressed copy (under `iconHash`) first and falls back to the single live
+  slot (`put/getIcon`) only for an older release published before that copy existed. On a live-slot read the endpoint
+  hashes the bytes against the manifest's `iconHash` / per-widget `contentEtag` and **warns** when
+  they differ; the build still bakes the live asset, but the drift is in the log.
 
 Source-built seeding remains the fallback for the Falcon `[dist]` path, which has no job token and
 therefore no seed endpoint to call.

package/guides/sdk-reference.json

@@ -16748,7 +16748,25 @@
         "name": "ConversationMessage",
         "kind": "interface",
         "jsdoc": "",
-        "decl": "export interface ConversationMessage {\n  id?: string;\n  content?: string;\n  role?: MessageRole;\n  createdDate?: string;\n  status?: MessageStatus;\n  /** Client tools this assistant turn asks the CALLER to run — see `FunctionCall`. */\n  functionCalls?: FunctionCall[];\n}"
+        "decl": "export interface ConversationMessage {\n  id?: string;\n  content?: string;\n  role?: MessageRole;\n  createdDate?: string;\n  status?: MessageStatus;\n  /** Files the owner attached to this turn, as the service stored them. */\n  attachments?: Attachment[];\n  /** Client tools this assistant turn asks the CALLER to run — see `FunctionCall`. */\n  functionCalls?: FunctionCall[];\n}"
+      },
+      {
+        "name": "Attachment",
+        "kind": "interface",
+        "jsdoc": "/** A file on a message — the service's `Attachment` entity.\n *\n *  `url` is the service's own REFERENCE to an uploaded file\n *  (`genie-upload://<id>`, see `genieUploadRef`), not a fetchable address: no\n *  route that resolves it to a download url is published, so a client can name a\n *  sent attachment but not show it again from the server's copy. `viewUrl` is\n *  whatever preview the SENDING client chose to store, and is not trusted to\n *  resolve anywhere else. */",
+        "decl": "export interface Attachment {\n  /** Original file name including extension. The service caps it at 255. */\n  fileName: string;\n  /** e.g. `\"image/jpeg\"`. The service caps it at 100. */\n  mimeType: string;\n  url?: string;\n  viewUrl?: string;\n}"
+      },
+      {
+        "name": "CreateFileUploadResponse",
+        "kind": "interface",
+        "jsdoc": "/** The mint of an upload: where to send the bytes, and the record's id. */",
+        "decl": "export interface CreateFileUploadResponse { upload?: { uploadUrl?: string; id?: string } }"
+      },
+      {
+        "name": "CreateFileUploadOptions",
+        "kind": "interface",
+        "jsdoc": "",
+        "decl": "export interface CreateFileUploadOptions {\n  /** The same client-declared scoping flag every other chat-service request\n   *  takes. Omitted unless given — the dashboard sends it only when its own\n   *  account-scoping gate is on. */\n  enforceAccountScopedConversations?: boolean;\n}"
       },
       {
         "name": "FunctionCall",
@@ -16820,7 +16838,7 @@
         "name": "SendMessageOptions",
         "kind": "interface",
         "jsdoc": "/** Optional wire flags on `sendMessage`. `communicationMode` /\n *  `enableRealtimeEvents` were in the original captured payload; only POLLING is\n *  verified end-to-end. The rest were added from the 2026-09-19 re-capture. */",
-        "decl": "export interface SendMessageOptions {\n  communicationMode?: CommunicationMode;\n  enableRealtimeEvents?: boolean;\n  metadata?: UserMessageMetadata;\n  /** The dashboard sends `true`. Optional: verified to answer either way. */\n  enforceAccountScopedConversations?: boolean;\n  /** Tag the turn with the same origin the conversation was created under. */\n  origin?: string;\n}"
+        "decl": "export interface SendMessageOptions {\n  communicationMode?: CommunicationMode;\n  enableRealtimeEvents?: boolean;\n  metadata?: UserMessageMetadata;\n  /** The dashboard sends `true`. Optional: verified to answer either way. */\n  enforceAccountScopedConversations?: boolean;\n  /** Tag the turn with the same origin the conversation was created under. */\n  origin?: string;\n  /** Files already UPLOADED (see `createFileUpload`) to store with the turn.\n   *  Rides step 1 only — the trigger names the stored turn, which carries them. */\n  attachments?: Attachment[];\n}"
       },
       {
         "name": "ConversationUserMessageResponse",
@@ -16870,6 +16888,30 @@
         "jsdoc": "/** Ask the service to abandon the assistant reply it is generating for\n *  `userMessageId` — the \"stop\" a chat surface puts beside a reply in progress.\n *\n *  Addressed by USER message, not by conversation: the thing being abandoned is\n *  one turn, and the id comes from that turn's own send response\n *  (`userMessageIdOf`). There is no route that looks it up afterwards, so a\n *  caller that did not keep it cannot abort.\n *\n *  Resolving means the service ACCEPTED the abort, not that generation had not\n *  already finished — a reply that was already written still lands in the\n *  transcript. Rejecting means the turn is still running: treat it as \"could\n *  not stop\", never as \"stopped\". */",
         "decl": "export function abortAssistantMessageGeneration(userMessageId: string): Promise<AbortAssistantMessageGenerationResponse>;"
       },
+      {
+        "name": "createFileUpload",
+        "kind": "function",
+        "jsdoc": "/** Mint an upload for one file: a pre-signed url to send its bytes to, and the\n *  id the message will reference it by (`genieUploadRef`).\n *\n *  Only the MINT goes through the chat-service; the bytes go straight to\n *  `upload.uploadUrl` (see the file header). Resolving is not proof the file\n *  exists — nothing is stored until those bytes land, so a caller must not\n *  attach the reference before its upload has succeeded. */",
+        "decl": "export function createFileUpload(\n  fileName: string,\n  mimeType: string,\n  opts: CreateFileUploadOptions = {},\n): Promise<CreateFileUploadResponse>;"
+      },
+      {
+        "name": "GENIE_UPLOAD_SCHEME",
+        "kind": "const",
+        "jsdoc": "/** The scheme every first-party creator uses to reference an uploaded file from\n *  a message attachment. */",
+        "decl": "export const GENIE_UPLOAD_SCHEME = \"genie-upload://\";"
+      },
+      {
+        "name": "genieUploadRef",
+        "kind": "function",
+        "jsdoc": "/** `genie-upload://<id>`, or \"\" for no id — never a reference to nothing. */",
+        "decl": "export function genieUploadRef(id: string | undefined): string;"
+      },
+      {
+        "name": "uploadTargetUrl",
+        "kind": "function",
+        "jsdoc": "/** Where the bytes actually go: `uploadUrl` with `path` and `acl=private` set.\n *\n *  Mirrors the Media Platform browser uploader every first-party client relies\n *  on. The service rewrites the storage key itself, so `path` is advisory; it is\n *  sent anyway, for parity with the clients whose uploads are known to work.\n *\n *  String surgery rather than `new URL`, because the worker runtimes (JSContext,\n *  Hermes, QuickJS) do not all ship the URL constructor — and MERGED rather than\n *  appended, because the signed url may already carry a query, and a second `?`\n *  would corrupt the signature it carries. An existing `path` / `acl` is\n *  replaced rather than duplicated; everything else, the fragment included, is\n *  kept byte for byte. */",
+        "decl": "export function uploadTargetUrl(uploadUrl: string, fileName: string): string;"
+      },
       {
         "name": "getConversationMessages",
         "kind": "function",
@@ -16906,6 +16948,12 @@
         "jsdoc": "/** A message's text. `content` is normally a string, but can arrive as an object\n *  carrying `text`; anything else is stringified rather than dropped. */",
         "decl": "export function messageText(m: ConversationMessage | null | undefined): string;"
       },
+      {
+        "name": "attachmentsOf",
+        "kind": "function",
+        "jsdoc": "/** A message's attachments that name a file, in order. Anything that is not an\n *  object with a non-empty `fileName` is dropped rather than rendered as a blank\n *  entry — the list is display-only, so a malformed row has nothing to show. */",
+        "decl": "export function attachmentsOf(m: ConversationMessage | null | undefined): Attachment[];"
+      },
       {
         "name": "lastAssistantMessage",
         "kind": "function",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/himalaya-cli",
-  "version": "0.1030.0",
+  "version": "0.1032.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": [
@@ -65,5 +65,5 @@
       "artifactId": "himalaya-cli"
     }
   },
-  "falconPackageHash": "490de5e74662e1485d41c6fbcf35c5211cea45af726de33892022b39"
+  "falconPackageHash": "5af127baf2b3845fd3e463154eecf88bb68a58849427ab3778d5627a"
 }

package/templates/beauty-salon/tier5-src/_shared/owner-load-error.ts

@@ -1,6 +1,12 @@
 import { copyParam } from "./himi-copy.js";
 
-/** Host-owned preview input. Absent on native and older hosts. */
+/** Host-owned preview input. Absent on native and older hosts.
+ *
+ *  `"sample"` — the built-in demo records; `"live"` — the viewer's own business over the
+ *  owner rung; `"fixtures"` — a DEV web host over a sealed hermetic gateway, where
+ *  the dev fixtures are the sample data. `"fixtures"` is neither live nor demo, so a
+ *  worker READS through the bridge as it does on a device; it is still a preview host
+ *  (`isOwnerPreviewHost`), so failure copy may name the web preview. */
 function ownerPreviewMode(): unknown {
   return (globalThis as unknown as { himalaya?: { input?: Record<string, unknown> } }).himalaya?.input?.__himiOwnerPreview;
 }

package/templates/beauty-salon-owner/config.ts

@@ -37,7 +37,7 @@ export default defineApp({
     actions: "http://localhost:8190/v1/actions",
     sync: "http://localhost:8190/v1/sync",
   },
-  capabilities: ["live_activity","push","share","secure_storage","open_url","local_database","clipboard","ui"],
+  capabilities: ["live_activity","push","share","secure_storage","open_url","local_database","clipboard","ui","camera","presigned_upload"],
   designTokensPath: "./tokens.json",
   navigation: {
     "navKind": "responsive",

package/templates/beauty-salon-owner/dev/index.ts

@@ -50387,7 +50387,7 @@ const SCREENS = runtimeSetting({
                           "itemsPath": "$service:himiOwnerLiteManage.recents",
                           "items": [
                             {
-                              "id": "",
+                              "id": "himi_owner_lite.manage.recent.$item.id",
                               "body": {
                                 "package": "himalaya",
                                 "type": "VStack",
@@ -50532,7 +50532,7 @@ const SCREENS = runtimeSetting({
                                           "spacing": 14,
                                           "children": [
                                             {
-                                              "id": "",
+                                              "id": "himi_owner_lite.manage.recent.create.$item.id",
                                               "body": {
                                                 "package": "himalaya",
                                                 "type": "Text",
@@ -50557,7 +50557,7 @@ const SCREENS = runtimeSetting({
                                               }
                                             },
                                             {
-                                              "id": "",
+                                              "id": "himi_owner_lite.manage.recent.handoff.$item.id",
                                               "body": {
                                                 "package": "himalaya",
                                                 "type": "Text",
@@ -50693,7 +50693,7 @@ const SCREENS = runtimeSetting({
                                   "itemsPath": "$item.areas",
                                   "items": [
                                     {
-                                      "id": "",
+                                      "id": "himi_owner_lite.manage.area.$item.id",
                                       "body": {
                                         "package": "himalaya",
                                         "type": "VStack",
@@ -50838,7 +50838,7 @@ const SCREENS = runtimeSetting({
                                                   "spacing": 14,
                                                   "children": [
                                                     {
-                                                      "id": "",
+                                                      "id": "himi_owner_lite.manage.area.create.$item.id",
                                                       "body": {
                                                         "package": "himalaya",
                                                         "type": "Text",
@@ -50863,7 +50863,7 @@ const SCREENS = runtimeSetting({
                                                       }
                                                     },
                                                     {
-                                                      "id": "",
+                                                      "id": "himi_owner_lite.manage.area.handoff.$item.id",
                                                       "body": {
                                                         "package": "himalaya",
                                                         "type": "Text",
@@ -51643,7 +51643,7 @@ const SCREENS = runtimeSetting({
                 "props": {
                   "items": [
                     {
-                      "id": "",
+                      "id": "ol_drawer_nav.$item.id",
                       "body": {
                         "package": "himalaya",
                         "type": "ListItem",
@@ -51695,7 +51695,7 @@ const SCREENS = runtimeSetting({
                         "props": {
                           "items": [
                             {
-                              "id": "",
+                              "id": "ol_drawer_attention.$item.id",
                               "body": {
                                 "package": "himalaya",
                                 "type": "ListItem",
@@ -55256,6 +55256,45 @@ const SCREENS = runtimeSetting({
                                 }
                               }
                             },
+                            {
+                              "id": "himi_owner_lite_aria.msg_attach_$item.id",
+                              "body": {
+                                "package": "himalaya",
+                                "type": "HStack",
+                                "props": {
+                                  "spacing": 0,
+                                  "children": [
+                                    {
+                                      "id": "",
+                                      "body": {
+                                        "package": "himalaya",
+                                        "type": "Spacer",
+                                        "props": {}
+                                      },
+                                      "modifiers": {
+                                        "hiddenPath": "$item.notUser"
+                                      }
+                                    },
+                                    {
+                                      "id": "",
+                                      "body": {
+                                        "package": "himalaya",
+                                        "type": "Text",
+                                        "props": {
+                                          "text": "$item.attachText",
+                                          "style": "footnote",
+                                          "color": "textSecondary",
+                                          "maxLines": 3
+                                        }
+                                      }
+                                    }
+                                  ]
+                                }
+                              },
+                              "modifiers": {
+                                "hiddenPath": "$item.attachHidden"
+                              }
+                            },
                             {
                               "id": "himi_owner_lite_aria.msg_$item.id.link1",
                               "body": {
@@ -58836,6 +58875,203 @@ const SCREENS = runtimeSetting({
                 }
               }
             },
+            {
+              "id": "himi_owner_lite_aria.attachments.bound",
+              "body": {
+                "package": "himalaya",
+                "type": "LazyList",
+                "props": {
+                  "itemsPath": "$service:himiOwnerLiteAria.attachments",
+                  "horizontal": true,
+                  "spacing": 8,
+                  "items": [
+                    {
+                      "id": "himi_owner_lite_aria.attachment_$item.id",
+                      "body": {
+                        "package": "himalaya",
+                        "type": "VStack",
+                        "props": {
+                          "spacing": 4,
+                          "children": [
+                            {
+                              "id": "himi_owner_lite_aria.attachment_thumb_$item.id",
+                              "body": {
+                                "package": "himalaya",
+                                "type": "Image",
+                                "props": {
+                                  "url": "$item.thumbUrl",
+                                  "width": 72,
+                                  "height": 72,
+                                  "contentMode": "fill",
+                                  "shape": "rounded",
+                                  "contentDescription": "$item.name"
+                                }
+                              },
+                              "modifiers": {
+                                "hiddenPath": "$item.thumbHidden"
+                              }
+                            },
+                            {
+                              "id": "",
+                              "body": {
+                                "package": "himalaya",
+                                "type": "Text",
+                                "props": {
+                                  "text": "$item.statusText",
+                                  "style": "caption",
+                                  "color": "textSecondary",
+                                  "maxLines": 2
+                                }
+                              },
+                              "modifiers": {
+                                "hiddenPath": "$item.statusHidden"
+                              }
+                            },
+                            {
+                              "id": "",
+                              "body": {
+                                "package": "himalaya",
+                                "type": "HStack",
+                                "props": {
+                                  "spacing": 8,
+                                  "children": [
+                                    {
+                                      "id": "himi_owner_lite_aria.attachment_retry_$item.id",
+                                      "body": {
+                                        "package": "himalaya",
+                                        "type": "Text",
+                                        "props": {
+                                          "text": "Retry",
+                                          "style": "caption",
+                                          "color": "accentPrimary",
+                                          "maxLines": 1
+                                        }
+                                      },
+                                      "modifiers": {
+                                        "onTap": {
+                                          "actionId": "tier5.himiOwnerLiteAria.retryAttachment",
+                                          "params": {
+                                            "id": "$item.id"
+                                          }
+                                        },
+                                        "hiddenPath": "$item.retryHidden"
+                                      }
+                                    },
+                                    {
+                                      "id": "himi_owner_lite_aria.attachment_remove_$item.id",
+                                      "body": {
+                                        "package": "himalaya",
+                                        "type": "Icon",
+                                        "props": {
+                                          "name": "close",
+                                          "size": 14,
+                                          "tint": "textSecondary"
+                                        }
+                                      },
+                                      "modifiers": {
+                                        "onTap": {
+                                          "actionId": "tier5.himiOwnerLiteAria.removeAttachment",
+                                          "params": {
+                                            "id": "$item.id"
+                                          }
+                                        },
+                                        "accessibilityLabel": "Remove photo"
+                                      }
+                                    }
+                                  ]
+                                }
+                              }
+                            }
+                          ]
+                        }
+                      },
+                      "modifiers": {
+                        "width": 72
+                      }
+                    }
+                  ]
+                }
+              },
+              "modifiers": {
+                "hiddenPath": "$service:himiOwnerLiteAria.attachmentsHidden",
+                "padding": {
+                  "leading": 0,
+                  "trailing": 0,
+                  "top": 8,
+                  "bottom": 0
+                }
+              }
+            },
+            {
+              "id": "",
+              "body": {
+                "package": "himalaya",
+                "type": "HStack",
+                "props": {
+                  "spacing": 16,
+                  "children": [
+                    {
+                      "id": "himi_owner_lite_aria.attach.library",
+                      "body": {
+                        "package": "himalaya",
+                        "type": "Icon",
+                        "props": {
+                          "name": "image",
+                          "size": 22,
+                          "tint": "accentPrimary"
+                        }
+                      },
+                      "modifiers": {
+                        "onTap": {
+                          "actionId": "tier5.himiOwnerLiteAria.attach",
+                          "params": {
+                            "source": "library"
+                          }
+                        },
+                        "accessibilityLabel": "Add a photo"
+                      }
+                    },
+                    {
+                      "id": "himi_owner_lite_aria.attach.camera",
+                      "body": {
+                        "package": "himalaya",
+                        "type": "Icon",
+                        "props": {
+                          "name": "camera",
+                          "size": 22,
+                          "tint": "accentPrimary"
+                        }
+                      },
+                      "modifiers": {
+                        "onTap": {
+                          "actionId": "tier5.himiOwnerLiteAria.attach",
+                          "params": {
+                            "source": "camera"
+                          }
+                        },
+                        "accessibilityLabel": "Take a photo"
+                      }
+                    },
+                    {
+                      "id": "",
+                      "body": {
+                        "package": "himalaya",
+                        "type": "Spacer",
+                        "props": {}
+                      }
+                    }
+                  ]
+                }
+              },
+              "modifiers": {
+                "padding": {
+                  "leading": 0,
+                  "trailing": 0,
+                  "top": 8,
+                  "bottom": 0
+                }
+              }
+            },
             {
               "id": "form_aria",
               "body": {
@@ -58921,7 +59157,9 @@ const SCREENS = runtimeSetting({
         "wix_api",
         "open_url",
         "clipboard",
-        "ui"
+        "ui",
+        "camera",
+        "presigned_upload"
       ],
       "minBinaryVersion": "0.1.0",
       "bundleVersion": "0.0.1"