@wix/himalaya-cli 0.890.0 → 0.891.0

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/_types/stdlib/wix-sdk/genie-chat/src/index.d.ts

@@ -22,6 +22,12 @@ export declare const ARIA_ORIGIN = "owners-app";
 export interface GenieChatError extends Error {
     kind: "no-bridge" | "request";
     cause?: unknown;
+    /** Set ONLY when a send failed at step 2, after step 1 had already stored the
+     *  owner's turn. Its presence is the signal that retrying the whole send would
+     *  duplicate that turn, and that `triggerAssistantMessage` with this id is the
+     *  correct retry instead. Absent on every other failure, including a step-1
+     *  failure, where nothing was stored and a plain retry is right. */
+    storedUserMessageId?: string;
 }
 export declare function genieChatError(kind: "no-bridge" | "request", message: string, cause?: unknown): GenieChatError;
 export declare function isGenieChatError(e: unknown): e is GenieChatError;
@@ -77,23 +83,72 @@ export interface GetConversationMessagesResponse {
     messages?: ConversationMessage[];
     conversationMessages?: ConversationMessage[];
 }
-/** Optional wire flags on `sendMessage`. Both were present in the captured
- *  payload; only POLLING is verified end-to-end. */
+/** Context the dashboard attaches to the TRIGGER call. Every field is optional —
+ *  Aria answers without any of it (measured) — but `clientMetaSiteId` tells the
+ *  agent which business it is acting for, and the captured dashboard payload
+ *  also carries the current page so answers can reference what the user sees. */
+export interface UserMessageMetadata {
+    userAgent?: string;
+    pageUrl?: string;
+    /** A short natural-language SUMMARY of the current page, despite the name —
+     *  the dashboard sends prose here, not markup. */
+    pageHtml?: string;
+    additionalMetadata?: Array<{
+        key: string;
+        value: string;
+        excludeFromPrompt?: boolean;
+    }>;
+    channel?: string;
+}
+/** Optional wire flags on `sendMessage`. `communicationMode` /
+ *  `enableRealtimeEvents` were in the original captured payload; only POLLING is
+ *  verified end-to-end. The rest were added from the 2026-09-19 re-capture. */
 export interface SendMessageOptions {
     communicationMode?: CommunicationMode;
     enableRealtimeEvents?: boolean;
+    metadata?: UserMessageMetadata;
+    /** The dashboard sends `true`. Optional: verified to answer either way. */
+    enforceAccountScopedConversations?: boolean;
+    /** Tag the turn with the same origin the conversation was created under. */
+    origin?: string;
+}
+export interface ConversationUserMessageResponse {
+    userMessage?: ConversationMessage;
 }
 /** Create a conversation bound to the Aria assistant. Returns `{conversationId}`. */
 export declare function createConversation(assistantConfig?: AssistantConfig, origin?: string): Promise<CreateConversationResponse>;
 /** List the tenant's conversations (optionally filtered by origin). */
 export declare function getConversations(origin?: string): Promise<GetConversationsResponse>;
-/** Post a user message (POLLING mode by default). The agent may take a few
- *  seconds — poll getConversationMessages for the ASSISTANT reply. The immediate
+/** Step 1 of sending a turn: PERSIST the user's message on the conversation.
+ *  Returns the stored message, whose `id` is what actually triggers the agent in
+ *  step 2. Exported because a caller that wants to render the user's bubble from
+ *  the server's own copy can await this before triggering. */
+export declare function conversationUserMessage(conversationId: string, content: string, opts?: SendMessageOptions): Promise<ConversationUserMessageResponse>;
+/** Post a user turn (POLLING mode by default). The agent may take a few seconds
+ *  — poll getConversationMessages for the ASSISTANT reply. The immediate
  *  response may carry placeholder `assistantMessages` (often empty content).
  *
+ *  TWO calls, not one. `/user-message` carries NO message content: it names a
+ *  `userMessageId` that `/conversation-user-message` has already stored. This
+ *  replaced the old single-call shape (`{message:{content,role}}`) some time
+ *  after the 2026-06-04 capture, and the failure mode gave nothing away — every
+ *  call still returned 200, the agent still ran, and every reply was the
+ *  service's own "I didn't manage to create a proper answer" fallback with an
+ *  empty `functionCalls`, because the turn it was asked to answer did not exist.
+ *  Re-verified live 2026-09-19 against www.wixapis.com with a User
+ *  signed-instance; `origin`, `metadata` and `enforceAccountScopedConversations`
+ *  were each measured to be optional, so only the two-step shape is required.
+ *
  *  The third argument accepts the bare CommunicationMode for backwards
  *  compatibility, or an options object. */
 export declare function sendMessage(conversationId: string, content: string, modeOrOptions?: CommunicationMode | SendMessageOptions): Promise<SendMessageResponse>;
+/** Step 2 of sending a turn on its own: ask the agent to answer a user message
+ *  that `conversationUserMessage` has ALREADY stored.
+ *
+ *  Exported because it is the only safe retry when step 2 is the half that
+ *  failed — see `sendMessage`, which attaches the id to its error for exactly
+ *  this call. Carries no content: the turn it names is the content. */
+export declare function triggerAssistantMessage(conversationId: string, userMessageId: string, opts?: SendMessageOptions): Promise<SendMessageResponse>;
 /** Fetch the messages of a conversation (poll after sendMessage). */
 export declare function getConversationMessages(conversationId: string): Promise<GetConversationMessagesResponse>;
 /** The transcript from a getConversationMessages response, under either key. */

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/wix-comments.mjs

@@ -61,18 +61,31 @@ async function listBlogComments(postId) {
   if (!postId) {
     throw new Error("postId is required");
   }
-  const response = await wixCall("GET", "/comments/v1/comments/list-by-resource", {
-    appId: BLOG_COMMENTS_APP_ID,
-    contextId: postId,
-    resourceId: postId,
-    commentSort: { fieldName: "createdDate", order: "ASC" }
-  });
-  return (response.comments ?? []).map((comment) => ({
+  const query = [
+    `appId=${encodeURIComponent(BLOG_COMMENTS_APP_ID)}`,
+    `contextId=${encodeURIComponent(postId)}`,
+    `resourceId=${encodeURIComponent(postId)}`
+  ].join("&");
+  const response = await wixCall(
+    "GET",
+    `/comments/v1/comments/list-by-resource?${query}`
+  );
+  const rows = (response.comments ?? []).map((comment) => ({
     id: comment.id ?? "comment",
     authorName: commentAuthor(comment),
     text: commentText(comment),
     createdDate: comment.createdDate ?? ""
   }));
+  const instantOf = (row) => {
+    if (!row.createdDate) return Number.POSITIVE_INFINITY;
+    const ms = Date.parse(row.createdDate);
+    return Number.isNaN(ms) ? Number.POSITIVE_INFINITY : ms;
+  };
+  return rows.sort((a, b) => {
+    const x = instantOf(a);
+    const y = instantOf(b);
+    return x === y ? 0 : x < y ? -1 : 1;
+  });
 }
 
 // ../../stdlib/wix-sdk/comments-v1/src/index.ts

package/dist/authoring-runtime/node_modules/@wix/himalaya/dist/wix-genie-chat.mjs

@@ -33,14 +33,52 @@ function getConversations(origin) {
   const qs = origin ? `?origin=${encodeURIComponent(origin)}` : "";
   return wixCall("GET", `${BASE}/conversations${qs}`);
 }
+function conversationUserMessage(conversationId, content, opts = {}) {
+  if (!conversationId) throw new Error("conversationUserMessage: conversationId is required");
+  return wixCall("POST", `${BASE}/conversation-user-message`, {
+    attachments: [],
+    messageReferences: [],
+    userMessageContent: content,
+    origin: opts.origin ?? ARIA_ORIGIN,
+    conversationId,
+    userMessageInputSource: "TEXT",
+    ...opts.enforceAccountScopedConversations === void 0 ? {} : { enforceAccountScopedConversations: opts.enforceAccountScopedConversations }
+  });
+}
 function sendMessage(conversationId, content, modeOrOptions = "POLLING") {
   if (!conversationId) throw new Error("sendMessage: conversationId is required");
   const opts = typeof modeOrOptions === "string" ? { communicationMode: modeOrOptions } : modeOrOptions;
+  return conversationUserMessage(conversationId, content, opts).then((stored) => {
+    const userMessageId = stored?.userMessage?.id;
+    if (!userMessageId) {
+      throw genieChatError(
+        "request",
+        "@himalaya/wix-genie-chat: conversation-user-message returned no userMessage.id, so the agent would have no turn to answer"
+      );
+    }
+    return triggerAssistantMessage(conversationId, userMessageId, opts).catch((cause) => {
+      const e = genieChatError(
+        "request",
+        `@himalaya/wix-genie-chat: the turn was stored but the agent could not be triggered: ${String(cause?.message ?? cause)}`,
+        cause
+      );
+      e.storedUserMessageId = userMessageId;
+      throw e;
+    });
+  });
+}
+function triggerAssistantMessage(conversationId, userMessageId, opts = {}) {
+  if (!conversationId) throw new Error("triggerAssistantMessage: conversationId is required");
+  if (!userMessageId) throw new Error("triggerAssistantMessage: userMessageId is required");
   return wixCall("POST", `${BASE}/user-message`, {
     conversationId,
-    message: { content, role: "USER" },
+    userMessageId,
+    userMessageInputSource: "TEXT",
     communicationMode: opts.communicationMode ?? "POLLING",
-    enableRealtimeEvents: opts.enableRealtimeEvents ?? true
+    enableRealtimeEvents: opts.enableRealtimeEvents ?? true,
+    origin: opts.origin ?? ARIA_ORIGIN,
+    ...opts.metadata === void 0 ? {} : { metadata: opts.metadata },
+    ...opts.enforceAccountScopedConversations === void 0 ? {} : { enforceAccountScopedConversations: opts.enforceAccountScopedConversations }
   });
 }
 function getConversationMessages(conversationId) {
@@ -78,6 +116,7 @@ export {
   ARIA_UNIFIED_ASSISTANT_ID,
   ariaAssistantConfig,
   conversationIdOf,
+  conversationUserMessage,
   createConversation,
   genieChatError,
   getConversationMessages,
@@ -87,6 +126,7 @@ export {
   messageText,
   messagesOf,
   sendMessage,
+  triggerAssistantMessage,
   wixCall
 };
 //# sourceMappingURL=wix-genie-chat.mjs.map