@noodleseed/assistant 1.28.0 → 1.30.0

package/dist/index.d.cts

@@ -1,7 +1,7 @@
-import { f as AssistantAppearance, c as AssistantContext, g as AssistantModelContextUpdate, b as AssistantPageContext, j as AssistantInteractionResponse } from './client-_xivfs4q.cjs';
-export { k as AssistantAppearanceTheme, i as AssistantAppearanceWarning, e as AssistantErrorDetail, l as AssistantEvent, m as AssistantSurfaceAppearance, a as AssistantViewAvailableDetail, n as AssistantViewAvailableEvent } from './client-_xivfs4q.cjs';
-import './appearance-BpVu3lpk.cjs';
+import { Q as AssistantAppearance, c as AssistantContext, y as AssistantModelContextUpdate, b as AssistantPageContext, v as AssistantInteractionResponse } from './client-contract-Bw9dtrhw.cjs';
+export { S as AssistantAppearanceTheme, R as AssistantAppearanceWarning, e as AssistantErrorDetail, T as AssistantEvent, U as AssistantSurfaceAppearance, a as AssistantViewAvailableDetail, O as AssistantViewAvailableEvent } from './client-contract-Bw9dtrhw.cjs';
 import 'ai';
+import './server-CMqlAnxs.cjs';
 
 declare const ASSISTANT_TAG_NAME = "noodle-assistant";
 declare const HTMLElementBase: typeof HTMLElement;

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-import { f as AssistantAppearance, c as AssistantContext, g as AssistantModelContextUpdate, b as AssistantPageContext, j as AssistantInteractionResponse } from './client-CPFw8tfo.js';
-export { k as AssistantAppearanceTheme, i as AssistantAppearanceWarning, e as AssistantErrorDetail, l as AssistantEvent, m as AssistantSurfaceAppearance, a as AssistantViewAvailableDetail, n as AssistantViewAvailableEvent } from './client-CPFw8tfo.js';
-import './appearance-BpVu3lpk.js';
+import { Q as AssistantAppearance, c as AssistantContext, y as AssistantModelContextUpdate, b as AssistantPageContext, v as AssistantInteractionResponse } from './client-contract-DjU9qsoP.js';
+export { S as AssistantAppearanceTheme, R as AssistantAppearanceWarning, e as AssistantErrorDetail, T as AssistantEvent, U as AssistantSurfaceAppearance, a as AssistantViewAvailableDetail, O as AssistantViewAvailableEvent } from './client-contract-DjU9qsoP.js';
 import 'ai';
+import './server-CMqlAnxs.js';
 
 declare const ASSISTANT_TAG_NAME = "noodle-assistant";
 declare const HTMLElementBase: typeof HTMLElement;

package/dist/index.js

@@ -2,9 +2,9 @@ import {
   ASSISTANT_TAG_NAME,
   NoodleAssistantElement,
   registerNoodleAssistant
-} from "./chunk-QH7PL3GU.js";
+} from "./chunk-T4PS6P2W.js";
 import "./chunk-XKTUXFGX.js";
-import "./chunk-WJV4MJUR.js";
+import "./chunk-5EVZFPTD.js";
 import "./chunk-P223CYPO.js";
 import "./chunk-3YYTUJPJ.js";
 import "./chunk-5FUTL2UF.js";

package/dist/react/client.cjs

@@ -22618,6 +22618,7 @@ var AssistantChatStateStore = class {
   #messages = [];
   #status = "ready";
   #error;
+  #suggestions;
   #operation;
   #nextId = 0;
   subscribe(listener) {
@@ -22629,20 +22630,24 @@ var AssistantChatStateStore = class {
     return structuredClone({
       status: this.#status,
       messages: this.#messages,
+      ...this.#suggestions ? { suggestions: this.#suggestions } : {},
       ...this.#error ? { error: this.#error } : {}
     });
   }
   handle(event) {
     switch (event.event) {
       case "message_started":
+        this.#suggestions = void 0;
         this.#beginMessage(event.data.message);
         return;
       case "interaction_started":
+        this.#suggestions = void 0;
         this.#beginInteraction(event.data.id);
         return;
       case "resume_started":
         this.#status = "submitted";
         this.#error = void 0;
+        this.#suggestions = void 0;
         this.#startOperation();
         this.#notify();
         return;
@@ -22675,6 +22680,13 @@ var AssistantChatStateStore = class {
       case "view_available":
         this.#writeData("view", event.data.id, event.data);
         return;
+      case "suggested_prompts":
+        this.#suggestions = {
+          phase: event.data.phase,
+          prompts: [...event.data.prompts]
+        };
+        this.#notify();
+        return;
       case "message_completed":
         this.#closeOperation("ready");
         return;
@@ -22715,6 +22727,7 @@ var AssistantChatStateStore = class {
     this.#messages = [...this.#messages, userMessage];
     this.#status = "submitted";
     this.#error = void 0;
+    this.#suggestions = void 0;
     this.#startOperation();
     this.#notify();
   }
@@ -23044,7 +23057,8 @@ var assistantUiSchema = external_exports.object({
   privacyUrl: httpsUrlSchema.optional(),
   termsUrl: httpsUrlSchema.optional(),
   locale: external_exports.string().trim().min(2).max(35).optional(),
-  direction: external_exports.enum(["ltr", "rtl", "auto"]).optional()
+  direction: external_exports.enum(["ltr", "rtl", "auto"]).optional(),
+  webmcp: external_exports.object({ enabled: external_exports.boolean().optional() }).strict().optional()
 }).strict();
 var assistantConfigurationSchema = external_exports.object({ branding: brandingSchema.optional(), assistant: assistantUiSchema.optional() }).strict();
 function parseAssistantConfiguration(value) {
@@ -23106,7 +23120,8 @@ function parseSession(value) {
   const apps = value.endpoints.apps;
   const sandbox = value.endpoints.sandbox;
   const transcript = value.endpoints.transcript;
-  if (typeof value.token !== "string" || typeof value.expiresAt !== "string" || typeof value.endpoints.turns !== "string" || typeof value.endpoints.toolConfirmations !== "string" || interactions !== void 0 && typeof interactions !== "string" || apps !== void 0 && typeof apps !== "string" || sandbox !== void 0 && typeof sandbox !== "string" || transcript !== void 0 && typeof transcript !== "string") {
+  const suggestions = value.endpoints.suggestions;
+  if (typeof value.token !== "string" || typeof value.expiresAt !== "string" || typeof value.endpoints.turns !== "string" || typeof value.endpoints.toolConfirmations !== "string" || interactions !== void 0 && typeof interactions !== "string" || apps !== void 0 && typeof apps !== "string" || sandbox !== void 0 && typeof sandbox !== "string" || transcript !== void 0 && typeof transcript !== "string" || suggestions !== void 0 && typeof suggestions !== "string") {
     throw clientError("session_failed", "Assistant session response is invalid", true);
   }
   const configuration = parseAssistantConfiguration(value.configuration);
@@ -23119,7 +23134,8 @@ function parseSession(value) {
       ...typeof interactions === "string" ? { interactions } : {},
       ...typeof apps === "string" ? { apps } : {},
       ...typeof sandbox === "string" ? { sandbox } : {},
-      ...typeof transcript === "string" ? { transcript } : {}
+      ...typeof transcript === "string" ? { transcript } : {},
+      ...typeof suggestions === "string" ? { suggestions } : {}
     },
     ...configuration === void 0 ? {} : { configuration },
     ...isRecord2(value.resume) && typeof value.resume.tool === "string" ? { resume: { tool: value.resume.tool } } : {}
@@ -23203,6 +23219,10 @@ function toAssistantClientEvent(event) {
         return event;
       }
       break;
+    case "suggested_prompts":
+      if (isSuggestedPromptsDetail(value))
+        return event;
+      break;
     case "done":
       if (hasOptionalTurnId(value)) return event;
       break;
@@ -23214,6 +23234,12 @@ function toAssistantClientEvent(event) {
   }
   return { event: "unrecognized", data: { name: event.event, payload: value } };
 }
+function isSuggestedPromptsDetail(value) {
+  if (!isRecord3(value)) return false;
+  return (value.phase === "initial" || value.phase === "follow_up") && Array.isArray(value.prompts) && value.prompts.length <= 3 && value.prompts.every(
+    (prompt) => typeof prompt === "string" && prompt.trim().length > 0 && prompt.length <= 240
+  ) && hasOptionalTurnId(value);
+}
 function isViewAvailableDetail(value) {
   return hasString(value, "id") && hasString(value, "tool") && typeof value.resourceUri === "string" && value.resourceUri.startsWith("ui://") && hasOptionalString(value.title) && (value.replayed === void 0 || value.replayed === true) && isJsonValue(value.result, 0) && hasOptionalJson(value.arguments) && hasOptionalString(value.html) && (value.resourceMeta === void 0 || isRecord3(value.resourceMeta)) && (value.allowedOpenDomains === void 0 || Array.isArray(value.allowedOpenDomains) && value.allowedOpenDomains.every(isHttpsUrl2)) && hasOptionalTurnId(value);
 }
@@ -23383,6 +23409,9 @@ function resolveSessionSource(options) {
   }
   return { kind: "exchange", url: sessionEndpoint };
 }
+function sessionSourceKey(options) {
+  return `${options.embedId ?? ""}|${options.serviceUrl ?? ""}|${options.sessionEndpoint ?? ""}`;
+}
 
 // src/transcript-replay.ts
 function parseTranscriptEntries(value) {
@@ -23397,6 +23426,11 @@ function parseTranscriptEntries(value) {
   }
   return parsed;
 }
+function parseTranscriptSuggestions(value) {
+  if (typeof value !== "object" || value === null) return void 0;
+  const suggestions = value.suggestions;
+  return isSuggestedPromptsDetail(suggestions) && suggestions.phase === "follow_up" ? { phase: suggestions.phase, prompts: suggestions.prompts } : void 0;
+}
 function transcriptReplayEvents(entries) {
   const events = [];
   let open = false;
@@ -23547,6 +23581,32 @@ function isAbortError2(error51) {
   return error51 instanceof DOMException && error51.name === "AbortError";
 }
 
+// src/visitor-id.ts
+var STORAGE_PREFIX = "noodleseed.assistant.visitor.";
+function randomVisitorId() {
+  try {
+    return globalThis.crypto.randomUUID();
+  } catch {
+    return void 0;
+  }
+}
+function visitorIdForSource(sourceKey) {
+  const key = `${STORAGE_PREFIX}${sourceKey}`;
+  try {
+    const stored = globalThis.localStorage?.getItem(key);
+    if (typeof stored === "string" && stored.length > 0) return stored;
+  } catch {
+    return void 0;
+  }
+  const created = randomVisitorId();
+  if (created === void 0) return void 0;
+  try {
+    globalThis.localStorage?.setItem(key, created);
+  } catch {
+  }
+  return created;
+}
+
 // src/client.ts
 var DefaultAssistantClient = class {
   #source;
@@ -23559,6 +23619,7 @@ var DefaultAssistantClient = class {
   #context;
   #modelContext;
   #active;
+  #initialSuggestions;
   #pendingAppInteractions = /* @__PURE__ */ new Map();
   constructor(options) {
     this.#source = resolveSessionSource(options);
@@ -23620,10 +23681,13 @@ var DefaultAssistantClient = class {
       "turn_failed"
     );
     if (!response.ok) return;
-    for (const event of transcriptReplayEvents(parseTranscriptEntries(await response.json()))) {
+    const value = await response.json();
+    for (const event of transcriptReplayEvents(parseTranscriptEntries(value))) {
       this.#emit(event);
       if (event.event === "message_completed") await this.#chat.flush();
     }
+    const suggestions = parseTranscriptSuggestions(value);
+    if (suggestions) this.#emit({ event: "suggested_prompts", data: suggestions });
   }
   /** POST the one-shot resume trigger; a 409 means nothing was pending, which renders as silence. */
   async #resumeTurn(session, signal) {
@@ -23632,7 +23696,10 @@ var DefaultAssistantClient = class {
       {
         method: "POST",
         headers: authorizedHeaders(session.token, "text/event-stream"),
-        body: JSON.stringify({ resume: true }),
+        body: JSON.stringify({
+          resume: true,
+          ...session.endpoints.suggestions ? { suggestions: true } : {}
+        }),
         signal
       },
       "turn_failed"
@@ -23655,6 +23722,7 @@ var DefaultAssistantClient = class {
   async sendMessage(text2) {
     const message = text2.trim();
     if (!message) return;
+    this.#cancelInitialSuggestions();
     await this.#singleFlight(async (signal) => {
       await this.#runChatOperation(
         signal,
@@ -23662,10 +23730,42 @@ var DefaultAssistantClient = class {
       );
     });
   }
+  async loadInitialSuggestions() {
+    if (!this.#session) await this.connect();
+    const session = this.#session;
+    if (!session?.endpoints.suggestions) return;
+    if (this.#initialSuggestions) return this.#initialSuggestions.promise;
+    const controller = new AbortController();
+    const clientContext = this.#resolveClientContext();
+    const pageContext = this.#resolvePageContext();
+    const promise2 = this.#request(
+      session.endpoints.suggestions,
+      {
+        method: "POST",
+        headers: authorizedHeaders(session.token, "text/event-stream"),
+        body: JSON.stringify({
+          ...clientContext ? { clientContext } : {},
+          ...pageContext === void 0 ? {} : { pageContext },
+          ...this.#modelContext ? { modelContext: this.#modelContext } : {}
+        }),
+        signal: controller.signal
+      },
+      "turn_failed"
+    ).then(async (response) => {
+      if (response.ok) await this.#consume(response);
+    }).finally(() => {
+      if (this.#initialSuggestions?.controller === controller) {
+        this.#initialSuggestions = void 0;
+      }
+    });
+    this.#initialSuggestions = { controller, promise: promise2 };
+    return promise2;
+  }
   async respond(id, resolution) {
     if (!id) {
       throw clientError("invalid_request", "interaction id is required", false);
     }
+    this.#cancelInitialSuggestions();
     await this.#singleFlight(async (signal) => {
       await this.#runChatOperation(signal, async () => {
         const pendingApp = this.#pendingAppInteractions.get(id);
@@ -23685,6 +23785,7 @@ var DefaultAssistantClient = class {
         const body = modernEndpoint ? {
           id,
           action: resolution.action,
+          ...session.endpoints.suggestions ? { suggestions: true } : {},
           ...resolution.action === "accept" && resolution.content !== void 0 ? { content: resolution.content } : {}
         } : { id };
         this.#emit({ event: "interaction_started", data: { id, action: resolution.action } });
@@ -23763,7 +23864,7 @@ var DefaultAssistantClient = class {
     this.#modelContext = copyAssistantModelContext(update);
     this.#emit({ event: "model_context_changed", data: { modelContext: this.#modelContext } });
   }
-  async requestApp(method, params) {
+  async requestApp(method, params, options) {
     const session = this.#session;
     if (!session?.endpoints.apps) {
       throw clientError(
@@ -23777,7 +23878,11 @@ var DefaultAssistantClient = class {
       {
         method: "POST",
         headers: authorizedHeaders(session.token, "application/json"),
-        body: JSON.stringify({ method, params })
+        body: JSON.stringify({
+          ...options?.bridge ? { bridge: options.bridge } : {},
+          method,
+          params
+        })
       },
       "app_request_failed"
     );
@@ -23792,6 +23897,7 @@ var DefaultAssistantClient = class {
     const value = await response.json();
     const interaction = parseAppInteraction(value);
     if (!interaction) return value;
+    options?.onSuspended?.();
     return new Promise((resolve2, reject) => {
       const id = interaction.data.id;
       const replaced = this.#pendingAppInteractions.get(id);
@@ -23809,6 +23915,7 @@ var DefaultAssistantClient = class {
     return this.#session?.endpoints.sandbox;
   }
   resetSession() {
+    this.#cancelInitialSuggestions();
     this.#rejectPendingAppInteractions(
       clientError("confirmation_expired", "assistant session is not active", false)
     );
@@ -23817,6 +23924,7 @@ var DefaultAssistantClient = class {
   }
   abort() {
     this.#active?.abort();
+    this.#cancelInitialSuggestions();
   }
   async #sendTurn(message, mayRetry, signal, modelContext) {
     const session = this.#session ?? await this.#createSession(signal);
@@ -23832,7 +23940,8 @@ var DefaultAssistantClient = class {
           message,
           ...clientContext ? { clientContext } : {},
           ...pageContext === void 0 ? {} : { pageContext },
-          ...modelContext ? { modelContext } : {}
+          ...modelContext ? { modelContext } : {},
+          ...session.endpoints.suggestions ? { suggestions: true } : {}
         }),
         signal
       },
@@ -23892,11 +24001,12 @@ var DefaultAssistantClient = class {
   }
   async #createSession(signal) {
     const source = this.#source;
+    const visitorId = source.kind === "public" ? visitorIdForSource(sessionSourceKey({ embedId: source.embedId, serviceUrl: source.url })) : void 0;
     const response = await this.#requestSession(source, {
       method: "POST",
       headers: { Accept: "application/json", "Content-Type": "application/json" },
       body: JSON.stringify(
-        source.kind === "public" ? { embedId: source.embedId } : this.#context ? { context: this.#context } : {}
+        source.kind === "public" ? { embedId: source.embedId, ...visitorId ? { visitorId } : {} } : this.#context ? { context: this.#context } : {}
       ),
       credentials: source.kind === "public" ? "omit" : "same-origin",
       signal
@@ -24021,6 +24131,9 @@ var DefaultAssistantClient = class {
       this.#active = void 0;
     }
   }
+  #cancelInitialSuggestions() {
+    this.#initialSuggestions?.controller.abort();
+  }
   async #runChatOperation(signal, operation) {
     try {
       await operation();