@noodleseed/assistant 1.28.0 → 1.30.0

package/dist/{client-CPFw8tfo.d.ts → client-contract-Bw9dtrhw.d.cts}

@@ -1,5 +1,5 @@
-import { A as AssistantConfiguration } from './appearance-BpVu3lpk.js';
 import { ChatStatus, UIMessage } from 'ai';
+import { a as AssistantConfiguration, b as AssistantSession } from './server-CMqlAnxs.cjs';
 
 interface AssistantSurfaceAppearance {
     readonly surface?: string;
@@ -60,6 +60,16 @@ interface AssistantEvent {
     readonly event: string;
     readonly data: Readonly<Record<string, unknown>>;
 }
+/**
+ * Per-request options for an MCP App request. `bridge` marks the call's originating surface for
+ * attribution (ADR 0220) — a body field: a header would have to join the route's CORS allowlist.
+ * `onSuspended` fires when that request parks on an interaction, before its promise can settle: the
+ * only way to answer a caller that must not block on a human.
+ */
+interface AppRequestOptions {
+    readonly bridge?: string;
+    onSuspended?(): void;
+}
 interface AssistantErrorDetail {
     readonly code: string;
     readonly status?: number;
@@ -149,6 +159,10 @@ interface AssistantErrorEventDetail extends TurnDetail {
     readonly status?: number;
     readonly retryable?: boolean;
 }
+interface AssistantSuggestedPromptsDetail extends TurnDetail {
+    readonly phase: 'initial' | 'follow_up';
+    readonly prompts: readonly string[];
+}
 type AssistantContentEvent = NamedEvent<'content', AssistantContentDetail>;
 type AssistantToolStartedEvent = NamedEvent<'tool_started', AssistantToolStartedDetail>;
 type AssistantToolProposedEvent = NamedEvent<'tool_proposed', AssistantToolProposedDetail>;
@@ -158,6 +172,7 @@ type AssistantInteractionResolvedEvent = NamedEvent<'interaction_resolved', Assi
 type AssistantToolCompletedEvent = NamedEvent<'tool_completed', AssistantToolCompletedDetail>;
 type AssistantViewAvailableEvent = NamedEvent<'view_available', AssistantViewAvailableDetail>;
 type AssistantErrorEvent = NamedEvent<'error', AssistantErrorEventDetail>;
+type AssistantSuggestedPromptsEvent = NamedEvent<'suggested_prompts', AssistantSuggestedPromptsDetail>;
 type AssistantDoneEvent = NamedEvent<'done', TurnDetail>;
 interface AssistantLegacyInteractionProposedDetail {
     readonly id: string;
@@ -192,7 +207,7 @@ interface AssistantUnrecognizedEvent {
     };
 }
 /** Closed event union for the DOM-free client; unknown future SSE names remain observable safely. */
-type AssistantClientEvent = AssistantContentEvent | AssistantToolStartedEvent | AssistantToolProposedEvent | AssistantInputRequestedEvent | AssistantAuthRequestedEvent | AssistantInteractionResolvedEvent | AssistantToolCompletedEvent | AssistantViewAvailableEvent | AssistantErrorEvent | AssistantDoneEvent | NamedEvent<'interaction_proposed', AssistantLegacyInteractionProposedDetail> | AssistantClientLifecycleEvent | AssistantUnrecognizedEvent;
+type AssistantClientEvent = AssistantContentEvent | AssistantToolStartedEvent | AssistantToolProposedEvent | AssistantInputRequestedEvent | AssistantAuthRequestedEvent | AssistantInteractionResolvedEvent | AssistantToolCompletedEvent | AssistantViewAvailableEvent | AssistantErrorEvent | AssistantSuggestedPromptsEvent | AssistantDoneEvent | NamedEvent<'interaction_proposed', AssistantLegacyInteractionProposedDetail> | AssistantClientLifecycleEvent | AssistantUnrecognizedEvent;
 declare global {
     interface HTMLElementEventMap {
         'assistant-view-available': CustomEvent<AssistantViewAvailableDetail>;
@@ -243,6 +258,9 @@ interface AssistantChatError {
 interface AssistantChatState {
     readonly status: ChatStatus;
     readonly messages: readonly AssistantUIMessage[];
+    readonly suggestions?: Extract<AssistantClientEvent, {
+        event: 'suggested_prompts';
+    }>['data'];
     readonly error?: AssistantChatError;
 }
 
@@ -260,44 +278,19 @@ type AssistantSessionSourceOptions = {
     readonly sessionEndpoint?: undefined;
 };
 
-declare class AssistantClientError extends Error {
-    readonly detail: AssistantErrorDetail;
-    constructor(detail: AssistantErrorDetail, message: string, options?: ErrorOptions);
-}
-
 type AssistantContextValue = string | number | boolean | null;
 type AssistantContext = Readonly<Record<string, AssistantContextValue>>;
 interface AssistantClientContext {
     readonly locale?: string;
     readonly timeZone?: string;
 }
-
 type AssistantInteractionResponse = {
     readonly action: 'accept';
     readonly content?: AssistantJsonValue;
 } | {
     readonly action: 'decline' | 'cancel';
 };
-interface AssistantSessionResponse {
-    readonly token: string;
-    readonly expiresAt: string;
-    readonly endpoints: {
-        readonly turns: string;
-        readonly toolConfirmations: string;
-        readonly interactions?: string;
-        readonly apps?: string;
-        /** Additive hosted sandbox document for widget frames; absent on older services. */
-        readonly sandbox?: string;
-        /** Additive bounded visible-transcript endpoint; absent on older services. */
-        readonly transcript?: string;
-    };
-    readonly configuration?: AssistantConfiguration;
-    /** Armed post-sign-in resume hint: present only on an elevation exchange (issue #1177). */
-    readonly resume?: {
-        readonly tool: string;
-    };
-}
-
+type AssistantSessionResponse = AssistantSession;
 interface AssistantClientBehaviorOptions<TPageContext extends AssistantPageContext = AssistantContext> {
     readonly fetch?: typeof fetch;
     /** Untrusted page context sent only when exchanging a session. */
@@ -326,19 +319,17 @@ interface AssistantClient<TPageContext extends AssistantPageContext = AssistantC
     /** A request holds the single-flight slot. Optional so external implementations stay valid. */
     isBusy?(): boolean;
     sendMessage(message: string): Promise<void>;
+    /** Request the session's idempotent initial prompts when effective config omitted them. */
+    loadInitialSuggestions?(): Promise<void>;
     respond(id: string, response: AssistantInteractionResponse): Promise<void>;
     updateContext(context: AssistantContext): void;
     updatePageContext(context: TPageContext): void;
     updateModelContext(update: AssistantModelContextUpdate): void;
-    requestApp(method: string, params: Readonly<Record<string, unknown>>): Promise<unknown>;
-    /**
-     * Hosted sandbox document URL for widget frames, when the active session advertises one.
-     * Optional so existing external implementations of this interface stay valid.
-     */
+    requestApp(method: string, params: Readonly<Record<string, unknown>>, options?: AppRequestOptions): Promise<unknown>;
+    /** Hosted sandbox document URL for widget frames, when the active session advertises one. */
     appSandboxUrl?(): string | undefined;
     resetSession(): void;
     abort(): void;
 }
-declare function createAssistantClient<TPageContext extends AssistantPageContext = AssistantContext>(options: CreateAssistantClientOptions<TPageContext>): AssistantClient<TPageContext>;
 
-export { type AssistantClient as A, type AssistantInputRequestedDetail as B, type CreateAssistantClientOptions as C, type AssistantInputRequestedEvent as D, type AssistantInteractionResolvedDetail as E, type AssistantInteractionResolvedEvent as F, type AssistantInteractionStatus as G, type AssistantJsonValue as H, type AssistantSessionResponse as I, type AssistantToolCompletedDetail as J, type AssistantToolCompletedEvent as K, type AssistantToolProposedDetail as L, type AssistantToolProposedEvent as M, type AssistantToolResultData as N, type AssistantToolStartedDetail as O, type AssistantToolStartedEvent as P, type AssistantUIDataTypes as Q, type AssistantUIMessage as R, type AssistantUnrecognizedEvent as S, type AssistantViewData as T, createAssistantClient as U, type AssistantViewAvailableDetail as a, type AssistantPageContext as b, type AssistantContext as c, type AssistantChatState as d, type AssistantErrorDetail as e, type AssistantAppearance as f, type AssistantModelContextUpdate as g, type AssistantClientEvent as h, type AssistantAppearanceWarning as i, type AssistantInteractionResponse as j, type AssistantAppearanceTheme as k, type AssistantEvent as l, type AssistantSurfaceAppearance as m, type AssistantViewAvailableEvent as n, type AssistantChatError as o, type AssistantClientContext as p, AssistantClientError as q, type AssistantClientLifecycleEvent as r, type AssistantConfirmationData as s, type AssistantContentDetail as t, type AssistantContentEvent as u, type AssistantContextValue as v, type AssistantDoneEvent as w, type AssistantErrorEvent as x, type AssistantErrorEventDetail as y, type AssistantInputRequestData as z };
+export type { AssistantClient as A, AssistantSuggestedPromptsDetail as B, CreateAssistantClientOptions as C, AssistantSuggestedPromptsEvent as D, AssistantToolCompletedDetail as E, AssistantToolCompletedEvent as F, AssistantToolProposedDetail as G, AssistantToolProposedEvent as H, AssistantToolResultData as I, AssistantToolStartedDetail as J, AssistantToolStartedEvent as K, AssistantUIDataTypes as L, AssistantUIMessage as M, AssistantUnrecognizedEvent as N, AssistantViewAvailableEvent as O, AssistantViewData as P, AssistantAppearance as Q, AssistantAppearanceWarning as R, AssistantAppearanceTheme as S, AssistantEvent as T, AssistantSurfaceAppearance as U, AssistantViewAvailableDetail as a, AssistantPageContext as b, AssistantContext as c, AssistantChatState as d, AssistantErrorDetail as e, AssistantChatError as f, AssistantClientContext as g, AssistantClientEvent as h, AssistantClientLifecycleEvent as i, AssistantConfirmationData as j, AssistantContentDetail as k, AssistantContentEvent as l, AssistantContextValue as m, AssistantDoneEvent as n, AssistantErrorEvent as o, AssistantErrorEventDetail as p, AssistantInputRequestData as q, AssistantInputRequestedDetail as r, AssistantInputRequestedEvent as s, AssistantInteractionResolvedDetail as t, AssistantInteractionResolvedEvent as u, AssistantInteractionResponse as v, AssistantInteractionStatus as w, AssistantJsonValue as x, AssistantModelContextUpdate as y, AssistantSessionResponse as z };

package/dist/{client-_xivfs4q.d.cts → client-contract-DjU9qsoP.d.ts}

@@ -1,5 +1,5 @@
-import { A as AssistantConfiguration } from './appearance-BpVu3lpk.cjs';
 import { ChatStatus, UIMessage } from 'ai';
+import { a as AssistantConfiguration, b as AssistantSession } from './server-CMqlAnxs.js';
 
 interface AssistantSurfaceAppearance {
     readonly surface?: string;
@@ -60,6 +60,16 @@ interface AssistantEvent {
     readonly event: string;
     readonly data: Readonly<Record<string, unknown>>;
 }
+/**
+ * Per-request options for an MCP App request. `bridge` marks the call's originating surface for
+ * attribution (ADR 0220) — a body field: a header would have to join the route's CORS allowlist.
+ * `onSuspended` fires when that request parks on an interaction, before its promise can settle: the
+ * only way to answer a caller that must not block on a human.
+ */
+interface AppRequestOptions {
+    readonly bridge?: string;
+    onSuspended?(): void;
+}
 interface AssistantErrorDetail {
     readonly code: string;
     readonly status?: number;
@@ -149,6 +159,10 @@ interface AssistantErrorEventDetail extends TurnDetail {
     readonly status?: number;
     readonly retryable?: boolean;
 }
+interface AssistantSuggestedPromptsDetail extends TurnDetail {
+    readonly phase: 'initial' | 'follow_up';
+    readonly prompts: readonly string[];
+}
 type AssistantContentEvent = NamedEvent<'content', AssistantContentDetail>;
 type AssistantToolStartedEvent = NamedEvent<'tool_started', AssistantToolStartedDetail>;
 type AssistantToolProposedEvent = NamedEvent<'tool_proposed', AssistantToolProposedDetail>;
@@ -158,6 +172,7 @@ type AssistantInteractionResolvedEvent = NamedEvent<'interaction_resolved', Assi
 type AssistantToolCompletedEvent = NamedEvent<'tool_completed', AssistantToolCompletedDetail>;
 type AssistantViewAvailableEvent = NamedEvent<'view_available', AssistantViewAvailableDetail>;
 type AssistantErrorEvent = NamedEvent<'error', AssistantErrorEventDetail>;
+type AssistantSuggestedPromptsEvent = NamedEvent<'suggested_prompts', AssistantSuggestedPromptsDetail>;
 type AssistantDoneEvent = NamedEvent<'done', TurnDetail>;
 interface AssistantLegacyInteractionProposedDetail {
     readonly id: string;
@@ -192,7 +207,7 @@ interface AssistantUnrecognizedEvent {
     };
 }
 /** Closed event union for the DOM-free client; unknown future SSE names remain observable safely. */
-type AssistantClientEvent = AssistantContentEvent | AssistantToolStartedEvent | AssistantToolProposedEvent | AssistantInputRequestedEvent | AssistantAuthRequestedEvent | AssistantInteractionResolvedEvent | AssistantToolCompletedEvent | AssistantViewAvailableEvent | AssistantErrorEvent | AssistantDoneEvent | NamedEvent<'interaction_proposed', AssistantLegacyInteractionProposedDetail> | AssistantClientLifecycleEvent | AssistantUnrecognizedEvent;
+type AssistantClientEvent = AssistantContentEvent | AssistantToolStartedEvent | AssistantToolProposedEvent | AssistantInputRequestedEvent | AssistantAuthRequestedEvent | AssistantInteractionResolvedEvent | AssistantToolCompletedEvent | AssistantViewAvailableEvent | AssistantErrorEvent | AssistantSuggestedPromptsEvent | AssistantDoneEvent | NamedEvent<'interaction_proposed', AssistantLegacyInteractionProposedDetail> | AssistantClientLifecycleEvent | AssistantUnrecognizedEvent;
 declare global {
     interface HTMLElementEventMap {
         'assistant-view-available': CustomEvent<AssistantViewAvailableDetail>;
@@ -243,6 +258,9 @@ interface AssistantChatError {
 interface AssistantChatState {
     readonly status: ChatStatus;
     readonly messages: readonly AssistantUIMessage[];
+    readonly suggestions?: Extract<AssistantClientEvent, {
+        event: 'suggested_prompts';
+    }>['data'];
     readonly error?: AssistantChatError;
 }
 
@@ -260,44 +278,19 @@ type AssistantSessionSourceOptions = {
     readonly sessionEndpoint?: undefined;
 };
 
-declare class AssistantClientError extends Error {
-    readonly detail: AssistantErrorDetail;
-    constructor(detail: AssistantErrorDetail, message: string, options?: ErrorOptions);
-}
-
 type AssistantContextValue = string | number | boolean | null;
 type AssistantContext = Readonly<Record<string, AssistantContextValue>>;
 interface AssistantClientContext {
     readonly locale?: string;
     readonly timeZone?: string;
 }
-
 type AssistantInteractionResponse = {
     readonly action: 'accept';
     readonly content?: AssistantJsonValue;
 } | {
     readonly action: 'decline' | 'cancel';
 };
-interface AssistantSessionResponse {
-    readonly token: string;
-    readonly expiresAt: string;
-    readonly endpoints: {
-        readonly turns: string;
-        readonly toolConfirmations: string;
-        readonly interactions?: string;
-        readonly apps?: string;
-        /** Additive hosted sandbox document for widget frames; absent on older services. */
-        readonly sandbox?: string;
-        /** Additive bounded visible-transcript endpoint; absent on older services. */
-        readonly transcript?: string;
-    };
-    readonly configuration?: AssistantConfiguration;
-    /** Armed post-sign-in resume hint: present only on an elevation exchange (issue #1177). */
-    readonly resume?: {
-        readonly tool: string;
-    };
-}
-
+type AssistantSessionResponse = AssistantSession;
 interface AssistantClientBehaviorOptions<TPageContext extends AssistantPageContext = AssistantContext> {
     readonly fetch?: typeof fetch;
     /** Untrusted page context sent only when exchanging a session. */
@@ -326,19 +319,17 @@ interface AssistantClient<TPageContext extends AssistantPageContext = AssistantC
     /** A request holds the single-flight slot. Optional so external implementations stay valid. */
     isBusy?(): boolean;
     sendMessage(message: string): Promise<void>;
+    /** Request the session's idempotent initial prompts when effective config omitted them. */
+    loadInitialSuggestions?(): Promise<void>;
     respond(id: string, response: AssistantInteractionResponse): Promise<void>;
     updateContext(context: AssistantContext): void;
     updatePageContext(context: TPageContext): void;
     updateModelContext(update: AssistantModelContextUpdate): void;
-    requestApp(method: string, params: Readonly<Record<string, unknown>>): Promise<unknown>;
-    /**
-     * Hosted sandbox document URL for widget frames, when the active session advertises one.
-     * Optional so existing external implementations of this interface stay valid.
-     */
+    requestApp(method: string, params: Readonly<Record<string, unknown>>, options?: AppRequestOptions): Promise<unknown>;
+    /** Hosted sandbox document URL for widget frames, when the active session advertises one. */
     appSandboxUrl?(): string | undefined;
     resetSession(): void;
     abort(): void;
 }
-declare function createAssistantClient<TPageContext extends AssistantPageContext = AssistantContext>(options: CreateAssistantClientOptions<TPageContext>): AssistantClient<TPageContext>;
 
-export { type AssistantClient as A, type AssistantInputRequestedDetail as B, type CreateAssistantClientOptions as C, type AssistantInputRequestedEvent as D, type AssistantInteractionResolvedDetail as E, type AssistantInteractionResolvedEvent as F, type AssistantInteractionStatus as G, type AssistantJsonValue as H, type AssistantSessionResponse as I, type AssistantToolCompletedDetail as J, type AssistantToolCompletedEvent as K, type AssistantToolProposedDetail as L, type AssistantToolProposedEvent as M, type AssistantToolResultData as N, type AssistantToolStartedDetail as O, type AssistantToolStartedEvent as P, type AssistantUIDataTypes as Q, type AssistantUIMessage as R, type AssistantUnrecognizedEvent as S, type AssistantViewData as T, createAssistantClient as U, type AssistantViewAvailableDetail as a, type AssistantPageContext as b, type AssistantContext as c, type AssistantChatState as d, type AssistantErrorDetail as e, type AssistantAppearance as f, type AssistantModelContextUpdate as g, type AssistantClientEvent as h, type AssistantAppearanceWarning as i, type AssistantInteractionResponse as j, type AssistantAppearanceTheme as k, type AssistantEvent as l, type AssistantSurfaceAppearance as m, type AssistantViewAvailableEvent as n, type AssistantChatError as o, type AssistantClientContext as p, AssistantClientError as q, type AssistantClientLifecycleEvent as r, type AssistantConfirmationData as s, type AssistantContentDetail as t, type AssistantContentEvent as u, type AssistantContextValue as v, type AssistantDoneEvent as w, type AssistantErrorEvent as x, type AssistantErrorEventDetail as y, type AssistantInputRequestData as z };
+export type { AssistantClient as A, AssistantSuggestedPromptsDetail as B, CreateAssistantClientOptions as C, AssistantSuggestedPromptsEvent as D, AssistantToolCompletedDetail as E, AssistantToolCompletedEvent as F, AssistantToolProposedDetail as G, AssistantToolProposedEvent as H, AssistantToolResultData as I, AssistantToolStartedDetail as J, AssistantToolStartedEvent as K, AssistantUIDataTypes as L, AssistantUIMessage as M, AssistantUnrecognizedEvent as N, AssistantViewAvailableEvent as O, AssistantViewData as P, AssistantAppearance as Q, AssistantAppearanceWarning as R, AssistantAppearanceTheme as S, AssistantEvent as T, AssistantSurfaceAppearance as U, AssistantViewAvailableDetail as a, AssistantPageContext as b, AssistantContext as c, AssistantChatState as d, AssistantErrorDetail as e, AssistantChatError as f, AssistantClientContext as g, AssistantClientEvent as h, AssistantClientLifecycleEvent as i, AssistantConfirmationData as j, AssistantContentDetail as k, AssistantContentEvent as l, AssistantContextValue as m, AssistantDoneEvent as n, AssistantErrorEvent as o, AssistantErrorEventDetail as p, AssistantInputRequestData as q, AssistantInputRequestedDetail as r, AssistantInputRequestedEvent as s, AssistantInteractionResolvedDetail as t, AssistantInteractionResolvedEvent as u, AssistantInteractionResponse as v, AssistantInteractionStatus as w, AssistantJsonValue as x, AssistantModelContextUpdate as y, AssistantSessionResponse as z };

package/dist/client.cjs

@@ -22617,6 +22617,7 @@ var AssistantChatStateStore = class {
   #messages = [];
   #status = "ready";
   #error;
+  #suggestions;
   #operation;
   #nextId = 0;
   subscribe(listener) {
@@ -22628,20 +22629,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;
@@ -22674,6 +22679,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;
@@ -22714,6 +22726,7 @@ var AssistantChatStateStore = class {
     this.#messages = [...this.#messages, userMessage];
     this.#status = "submitted";
     this.#error = void 0;
+    this.#suggestions = void 0;
     this.#startOperation();
     this.#notify();
   }
@@ -23043,7 +23056,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) {
@@ -23105,7 +23119,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);
@@ -23118,7 +23133,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 } } : {}
@@ -23202,6 +23218,10 @@ function toAssistantClientEvent(event) {
         return event;
       }
       break;
+    case "suggested_prompts":
+      if (isSuggestedPromptsDetail(value))
+        return event;
+      break;
     case "done":
       if (hasOptionalTurnId(value)) return event;
       break;
@@ -23213,6 +23233,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);
 }
@@ -23382,6 +23408,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) {
@@ -23396,6 +23425,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;
@@ -23546,6 +23580,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;
@@ -23558,6 +23618,7 @@ var DefaultAssistantClient = class {
   #context;
   #modelContext;
   #active;
+  #initialSuggestions;
   #pendingAppInteractions = /* @__PURE__ */ new Map();
   constructor(options) {
     this.#source = resolveSessionSource(options);
@@ -23619,10 +23680,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) {
@@ -23631,7 +23695,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"
@@ -23654,6 +23721,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,
@@ -23661,10 +23729,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);
@@ -23684,6 +23784,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 } });
@@ -23762,7 +23863,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(
@@ -23776,7 +23877,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"
     );
@@ -23791,6 +23896,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);
@@ -23808,6 +23914,7 @@ var DefaultAssistantClient = class {
     return this.#session?.endpoints.sandbox;
   }
   resetSession() {
+    this.#cancelInitialSuggestions();
     this.#rejectPendingAppInteractions(
       clientError("confirmation_expired", "assistant session is not active", false)
     );
@@ -23816,6 +23923,7 @@ var DefaultAssistantClient = class {
   }
   abort() {
     this.#active?.abort();
+    this.#cancelInitialSuggestions();
   }
   async #sendTurn(message, mayRetry, signal, modelContext) {
     const session = this.#session ?? await this.#createSession(signal);
@@ -23831,7 +23939,8 @@ var DefaultAssistantClient = class {
           message,
           ...clientContext ? { clientContext } : {},
           ...pageContext === void 0 ? {} : { pageContext },
-          ...modelContext ? { modelContext } : {}
+          ...modelContext ? { modelContext } : {},
+          ...session.endpoints.suggestions ? { suggestions: true } : {}
         }),
         signal
       },
@@ -23891,11 +24000,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
@@ -24020,6 +24130,9 @@ var DefaultAssistantClient = class {
       this.#active = void 0;
     }
   }
+  #cancelInitialSuggestions() {
+    this.#initialSuggestions?.controller.abort();
+  }
   async #runChatOperation(signal, operation) {
     try {
       await operation();