@noodleseed/assistant 1.28.0 → 1.30.0

package/dist/index.cjs

@@ -22482,11 +22482,8 @@ var DEFAULT_APPEARANCE = {
     composer: { leadingIcon: "none", sendIcon: "arrow-up", shape: "pill" },
     messages: { userStyle: "bubble", assistantStyle: "plain" }
   },
-  suggestedPrompts: [
-    "What products do you have?",
-    "Tell me about your business",
-    "How can I get in touch?"
-  ],
+  suggestedPrompts: [],
+  suggestedPromptsSource: "model",
   locale: "en",
   direction: "auto"
 };
@@ -22519,11 +22516,8 @@ function resolveAppearance(input = {}) {
       ...assistant?.labels
     },
     presentation: resolvePresentation(assistant?.presentation),
-    suggestedPrompts: assistant?.suggestedPrompts ?? (branding?.name ? [
-      "What products do you have?",
-      `Tell me about ${branding.name}`,
-      "How can I get in touch?"
-    ] : DEFAULT_APPEARANCE.suggestedPrompts),
+    suggestedPrompts: assistant?.suggestedPrompts ?? [],
+    suggestedPromptsSource: assistant?.suggestedPrompts === void 0 ? "model" : "configured",
     ...assistant?.privacyUrl ? { privacyUrl: assistant.privacyUrl } : {},
     ...assistant?.termsUrl ? { termsUrl: assistant.termsUrl } : {},
     locale: assistant?.locale ?? DEFAULT_APPEARANCE.locale,
@@ -27072,6 +27066,7 @@ var AssistantChatStateStore = class {
   #messages = [];
   #status = "ready";
   #error;
+  #suggestions;
   #operation;
   #nextId = 0;
   subscribe(listener) {
@@ -27083,20 +27078,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;
@@ -27129,6 +27128,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;
@@ -27169,6 +27175,7 @@ var AssistantChatStateStore = class {
     this.#messages = [...this.#messages, userMessage];
     this.#status = "submitted";
     this.#error = void 0;
+    this.#suggestions = void 0;
     this.#startOperation();
     this.#notify();
   }
@@ -27498,7 +27505,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) {
@@ -27560,7 +27568,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);
@@ -27573,7 +27582,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 } } : {}
@@ -27657,6 +27667,10 @@ function toAssistantClientEvent(event) {
         return event;
       }
       break;
+    case "suggested_prompts":
+      if (isSuggestedPromptsDetail(value))
+        return event;
+      break;
     case "done":
       if (hasOptionalTurnId(value)) return event;
       break;
@@ -27668,6 +27682,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);
 }
@@ -27746,6 +27766,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(entries2) {
   const events = [];
   let open = false;
@@ -27896,6 +27921,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;
@@ -27908,6 +27959,7 @@ var DefaultAssistantClient = class {
   #context;
   #modelContext;
   #active;
+  #initialSuggestions;
   #pendingAppInteractions = /* @__PURE__ */ new Map();
   constructor(options) {
     this.#source = resolveSessionSource(options);
@@ -27969,10 +28021,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) {
@@ -27981,7 +28036,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"
@@ -28004,6 +28062,7 @@ var DefaultAssistantClient = class {
   async sendMessage(text3) {
     const message = text3.trim();
     if (!message) return;
+    this.#cancelInitialSuggestions();
     await this.#singleFlight(async (signal) => {
       await this.#runChatOperation(
         signal,
@@ -28011,10 +28070,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);
@@ -28034,6 +28125,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 } });
@@ -28112,7 +28204,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(
@@ -28126,7 +28218,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"
     );
@@ -28141,6 +28237,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);
@@ -28158,6 +28255,7 @@ var DefaultAssistantClient = class {
     return this.#session?.endpoints.sandbox;
   }
   resetSession() {
+    this.#cancelInitialSuggestions();
     this.#rejectPendingAppInteractions(
       clientError("confirmation_expired", "assistant session is not active", false)
     );
@@ -28166,6 +28264,7 @@ var DefaultAssistantClient = class {
   }
   abort() {
     this.#active?.abort();
+    this.#cancelInitialSuggestions();
   }
   async #sendTurn(message, mayRetry, signal, modelContext) {
     const session = this.#session ?? await this.#createSession(signal);
@@ -28181,7 +28280,8 @@ var DefaultAssistantClient = class {
           message,
           ...clientContext ? { clientContext } : {},
           ...pageContext === void 0 ? {} : { pageContext },
-          ...modelContext ? { modelContext } : {}
+          ...modelContext ? { modelContext } : {},
+          ...session.endpoints.suggestions ? { suggestions: true } : {}
         }),
         signal
       },
@@ -28241,11 +28341,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
@@ -28370,6 +28471,9 @@ var DefaultAssistantClient = class {
       this.#active = void 0;
     }
   }
+  #cancelInitialSuggestions() {
+    this.#initialSuggestions?.controller.abort();
+  }
   async #runChatOperation(signal, operation) {
     try {
       await operation();
@@ -28450,6 +28554,22 @@ function appendConversationRecovery(input) {
   input.revealLatest();
 }
 
+// src/element-error-recovery.ts
+function renderConversationError(options) {
+  const { appearance, error: error51 } = options;
+  const detail = error51 instanceof AssistantClientError ? error51.detail : { code: options.fallbackCode, retryable: false };
+  const startNewConversation = detail.serviceCode === "session_turn_budget_exhausted";
+  const reconnect = detail.retryable !== false || detail.serviceCode === void 0;
+  const recoveryAction = startNewConversation ? { label: appearance.labels.newConversation, run: () => options.startNewConversation() } : reconnect ? { label: appearance.labels.reconnect, run: () => options.reconnect() } : void 0;
+  appendConversationRecovery({
+    messages: options.messages,
+    message: detail.code === "session_expired" ? appearance.labels.sessionExpired : appearance.labels.unavailable,
+    ...recoveryAction === void 0 ? {} : { action: recoveryAction },
+    revealLatest: () => options.revealLatest()
+  });
+  return detail;
+}
+
 // src/input-request-card.ts
 function createInputRequestCard(options) {
   const card = document.createElement("section");
@@ -32623,6 +32743,59 @@ var ASSISTANT_ELEMENT_STYLES = `<style>
   @media (max-width: 560px) { :host([data-mode="floating"]:not([open])) { bottom: 20px; } :host([open]:not([mobile-fullscreen])) .panel { width: calc(100vw - 40px); max-height: calc(100dvh - 40px); } }
 </style>`;
 
+// src/element-suggestions-controller.ts
+var AssistantElementSuggestionsController = class {
+  #host;
+  #initialRequested = false;
+  #dynamic;
+  constructor(host) {
+    this.#host = host;
+  }
+  reset() {
+    this.#initialRequested = false;
+    this.clear();
+  }
+  clear() {
+    this.#dynamic = void 0;
+    this.render();
+  }
+  handle(event) {
+    if (event.event === "message_started" || event.event === "interaction_started") {
+      this.clear();
+      return;
+    }
+    if (event.event !== "suggested_prompts") return;
+    this.#dynamic = event.data;
+    this.render();
+  }
+  maybeLoadInitial() {
+    const appearance = this.#host.appearance();
+    if (this.#initialRequested || appearance.suggestedPromptsSource !== "model" || this.#host.hasMessages() || !this.#host.isOpen()) {
+      return;
+    }
+    const client = this.#host.client();
+    if (!client?.loadInitialSuggestions) return;
+    this.#initialRequested = true;
+    void client.loadInitialSuggestions().catch(() => {
+    });
+  }
+  render() {
+    const container = this.#host.root()?.querySelector(".suggested-prompts");
+    if (!container) return;
+    const appearance = this.#host.appearance();
+    const hasMessages = this.#host.hasMessages();
+    const prompts = (this.#dynamic?.phase === "follow_up" || !hasMessages ? this.#dynamic?.prompts : void 0) ?? (!hasMessages && appearance.suggestedPromptsSource === "configured" ? appearance.suggestedPrompts : []);
+    container.replaceChildren();
+    for (const prompt of prompts) {
+      const button2 = document.createElement("button");
+      button2.type = "button";
+      button2.textContent = prompt;
+      button2.addEventListener("click", () => this.#host.send(prompt));
+      container.append(button2);
+    }
+  }
+};
+
 // src/host-appearance.ts
 var ROLE_VARIABLES = {
   canvas: "--ns-assistant-canvas",
@@ -32931,6 +33104,147 @@ function applyAssistantElementTheme(input) {
   return warnings;
 }
 
+// src/webmcp-bridge.ts
+var INERT = { registeredToolNames: [], stop: () => {
+} };
+async function startWebMcpBridge(ports) {
+  const { client, modelContext, enabled } = ports;
+  if (!enabled || !modelContext) return INERT;
+  let listed;
+  try {
+    listed = await client.requestApp("tools/list", {});
+  } catch {
+    return INERT;
+  }
+  const registrations = [];
+  for (const tool of projectableTools(listed)) {
+    registrations.push({
+      name: tool.name,
+      handle: modelContext.registerTool({
+        name: tool.name,
+        ...tool.description === void 0 ? {} : { description: tool.description },
+        ...tool.inputSchema === void 0 ? {} : { inputSchema: tool.inputSchema },
+        // Passed through, never inferred: an agent may use `readOnlyHint` to decide it can call
+        // without asking, so a hint this bridge invented would be a hint nobody authored.
+        ...tool.annotations === void 0 ? {} : { annotations: tool.annotations },
+        execute: (args) => executeThroughAssistant(client, tool.name, args)
+      })
+    });
+  }
+  let stopped = false;
+  return {
+    get registeredToolNames() {
+      return stopped ? [] : registrations.map((entry) => entry.name);
+    },
+    stop() {
+      if (stopped) return;
+      stopped = true;
+      for (const entry of registrations) entry.handle?.unregister?.();
+    }
+  };
+}
+function projectableTools(listed) {
+  const tools = isRecord7(listed) && Array.isArray(listed.tools) ? listed.tools : [];
+  const projectable = [];
+  for (const tool of tools) {
+    if (!isRecord7(tool) || typeof tool.name !== "string" || tool.name.length === 0) continue;
+    const visibility = readVisibility(tool);
+    if (visibility !== void 0 && !(visibility.includes("app") && visibility.includes("model"))) {
+      continue;
+    }
+    projectable.push({
+      name: tool.name,
+      description: typeof tool.description === "string" ? tool.description : void 0,
+      inputSchema: isRecord7(tool.inputSchema) ? tool.inputSchema : void 0,
+      annotations: isRecord7(tool.annotations) ? tool.annotations : void 0
+    });
+  }
+  return projectable;
+}
+function readVisibility(tool) {
+  const meta3 = isRecord7(tool._meta) ? tool._meta : void 0;
+  const ui = meta3 && isRecord7(meta3.ui) ? meta3.ui : void 0;
+  const visibility = ui?.visibility;
+  return Array.isArray(visibility) ? visibility.filter((entry) => typeof entry === "string") : void 0;
+}
+async function executeThroughAssistant(client, name21, args) {
+  let suspend;
+  const suspended = new Promise((resolve2) => {
+    suspend = resolve2;
+  });
+  try {
+    const call = client.requestApp(
+      "tools/call",
+      { name: name21, arguments: args },
+      // Attribution only: anyone holding the session token could send this, and it selects a
+      // *narrower* budget than the unmarked path, so declaring it can only cost the declarer.
+      { bridge: "webmcp", onSuspended: suspend }
+    );
+    void call.catch(() => {
+    });
+    const outcome = await Promise.race([
+      call.then((value) => ({ kind: "result", value })),
+      suspended.then(() => ({ kind: "confirmation" }))
+    ]);
+    return outcome.kind === "confirmation" ? CONFIRMATION_REQUIRED : toToolResult(outcome.value);
+  } catch (error51) {
+    return textResult(error51 instanceof Error ? error51.message : "tool call failed", true);
+  }
+}
+var CONFIRMATION_REQUIRED = {
+  content: [
+    {
+      type: "text",
+      text: "confirmation required: open the assistant panel on this page to approve this action"
+    }
+  ],
+  isError: true
+};
+function toToolResult(value) {
+  if (isRecord7(value) && Array.isArray(value.content)) return value;
+  return textResult(JSON.stringify(value ?? null), false);
+}
+function textResult(text3, isError) {
+  return { content: [{ type: "text", text: text3 }], isError };
+}
+function isRecord7(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
+// src/element-webmcp-controller.ts
+var AssistantElementWebMcpController = class {
+  #enabled = false;
+  #bridge;
+  /** Guards against a late `startWebMcpBridge` resolving after the session it belonged to is gone. */
+  #generation = 0;
+  /** Called when resolved configuration arrives; the deployment's opt-in is the only source. */
+  configure(enabled) {
+    this.#enabled = enabled;
+    if (!enabled) this.stop();
+  }
+  start(client) {
+    if (!this.#enabled || !client) return;
+    const modelContext = browserModelContext();
+    if (!modelContext) return;
+    this.stop();
+    const generation = ++this.#generation;
+    void startWebMcpBridge({ client, modelContext, enabled: true }).then((bridge) => {
+      if (generation === this.#generation) this.#bridge = bridge;
+      else bridge.stop();
+    });
+  }
+  stop() {
+    this.#generation += 1;
+    this.#bridge?.stop();
+    this.#bridge = void 0;
+  }
+};
+function browserModelContext() {
+  if (typeof document === "undefined") return void 0;
+  const host = document;
+  return typeof host.modelContext?.registerTool === "function" ? host.modelContext : void 0;
+}
+
 // src/presentation-styles.ts
 var presentationStyles = `<style>
   :host([data-mode="floating"]) {
@@ -33174,9 +33488,18 @@ var NoodleAssistantElement = class extends HTMLElementBase {
   #turnInFlight = false;
   #fetch;
   #hostAppearance;
+  #webmcp = new AssistantElementWebMcpController();
   #appearanceWarningKeys = /* @__PURE__ */ new Set();
   #appearanceStyleSnapshot = /* @__PURE__ */ new Map();
   #scroll = new AssistantElementScrollController();
+  #suggestions = new AssistantElementSuggestionsController({
+    root: () => this.shadowRoot,
+    appearance: () => this.#appearance,
+    client: () => this.#client,
+    hasMessages: () => this.hasAttribute("has-messages"),
+    isOpen: () => this.hasAttribute("open"),
+    send: (prompt) => this.#sendGuarded(prompt)
+  });
   sessionEndpoint = "";
   /** Public mount: the non-secret embed id `noodle deploy` printed. Mutually exclusive with the above. */
   embedId = "";
@@ -33288,6 +33611,7 @@ var NoodleAssistantElement = class extends HTMLElementBase {
     this.#launcher.disconnect();
     this.#setBusy(false);
     this.#environment.disconnect();
+    this.#webmcp.stop();
   }
   attributeChangedCallback(name21) {
     if (name21 === "theme") this.#applyTheme();
@@ -33321,6 +33645,7 @@ var NoodleAssistantElement = class extends HTMLElementBase {
   }
   resetSession() {
     this.#conversationGeneration += 1;
+    this.#webmcp.stop();
     this.#client?.abort();
     this.#unsubscribeClient?.();
     this.#client = void 0;
@@ -33330,12 +33655,14 @@ var NoodleAssistantElement = class extends HTMLElementBase {
     this.#events.resetConversation();
     this.#pendingUserEcho = void 0;
     this.removeAttribute("has-messages");
+    this.#suggestions.reset();
     this.#setBusy(false);
     this.#setSessionState("idle");
   }
   /** Re-establish the session without replaying a message or interaction decision. */
   reconnect() {
     this.#conversationGeneration += 1;
+    this.#webmcp.stop();
     this.#client?.abort();
     this.#unsubscribeClient?.();
     this.#client = void 0;
@@ -33393,6 +33720,7 @@ var NoodleAssistantElement = class extends HTMLElementBase {
     this.#turnInFlight = true;
     this.#pendingUserEcho = message;
     this.#appendMessage("user", message);
+    this.#suggestions.clear();
     this.#setBusy(true);
     if (this.#sessionState !== "ready") this.#setSessionState("loading");
     try {
@@ -33412,12 +33740,7 @@ var NoodleAssistantElement = class extends HTMLElementBase {
       if (generation === this.#conversationGeneration) this.#setBusy(false);
     }
   }
-  /**
-   * Every listener the element attaches to its own DOM must go through this guard: internal UI
-   * failures surface as `assistant-error` events (already dispatched by the failing path) and must
-   * never escape as unhandled rejections into the embedding page. Programmatic callers use
-   * `sendMessage`/`confirmTool` directly and keep the rejection.
-   */
+  /** DOM listeners swallow after the failing path dispatches its typed assistant-error event. */
   #sendGuarded(text3) {
     void this.sendMessage(text3).catch(() => {
     });
@@ -33469,13 +33792,21 @@ var NoodleAssistantElement = class extends HTMLElementBase {
   }
   #primeSession() {
     if (!this.sessionEndpoint && !this.embedId) return;
-    if (this.#sessionBootstrap || this.#client?.hasSession()) return;
+    if (this.#sessionBootstrap) return;
+    if (this.#client?.hasSession()) {
+      this.#suggestions.maybeLoadInitial();
+      return;
+    }
     if (this.#client?.isBusy?.() === true) return;
     if (this.embedId && !this.#pageContext) void this.#automaticPageContext.refresh();
     const client = this.#ensureClient();
     const generation = this.#conversationGeneration;
     this.#setSessionState("loading");
-    const bootstrap = client.connect().catch((error51) => {
+    const bootstrap = client.connect().then(() => {
+      if (generation === this.#conversationGeneration && this.#client === client) {
+        this.#suggestions.maybeLoadInitial();
+      }
+    }).catch((error51) => {
       if (generation !== this.#conversationGeneration || this.#client !== client) return;
       this.#dispatchClientError(error51, "session_failed");
       this.#presentationGate.reveal();
@@ -33487,15 +33818,18 @@ var NoodleAssistantElement = class extends HTMLElementBase {
   #handleClientEvent(event) {
     this.dispatchEvent(new CustomEvent("assistant-event", { detail: event }));
     this.#events.handle(event);
+    this.#suggestions.handle(event);
     if (event.event === "session_started") {
       this.#publicConfiguration.disconnect();
       this.removeAttribute("data-public-configuration-loading");
       this.#presentationGate.reveal();
       this.#setSessionState("ready");
       this.#messages?.querySelector(".conversation-error")?.remove();
+      this.#webmcp.start(this.#client);
     }
     if (event.event === "session_expired" || event.event === "session_reset") {
       this.#setSessionState("idle");
+      this.#webmcp.stop();
     }
     if (event.event === "tool_proposed" || event.event === "interaction_proposed" || event.event === "input_requested") {
       this.#removeThinking();
@@ -33599,23 +33933,17 @@ var NoodleAssistantElement = class extends HTMLElementBase {
     if (error51 instanceof AssistantClientError && error51.detail.code === "session_failed") {
       this.#setSessionState("error");
     }
-    const detail = error51 instanceof AssistantClientError ? error51.detail : { code: fallbackCode, retryable: false };
-    const startNewConversation = detail.serviceCode === "session_turn_budget_exhausted";
-    const reconnect = detail.retryable !== false || detail.serviceCode === void 0;
-    const recoveryAction = startNewConversation ? {
-      label: this.#appearance.labels.newConversation,
-      run: () => this.#startNewConversation()
-    } : reconnect ? { label: this.#appearance.labels.reconnect, run: () => this.reconnect() } : void 0;
-    appendConversationRecovery({
-      messages: this.#messages,
-      message: detail.code === "session_expired" ? this.#appearance.labels.sessionExpired : this.#appearance.labels.unavailable,
-      // A spent or switched-off daily budget offers no retry. Reconnecting cannot succeed, and every
-      // open tab trying is exactly the load the cap was set to refuse — so the button goes, not just
-      // the alarming words. A spent *session* keeps it: reconnect mints a fresh one, which is the fix.
-      ...recoveryAction === void 0 ? {} : { action: recoveryAction },
-      revealLatest: () => this.#revealLatest()
-    });
-    this.#dispatchError(detail);
+    this.#dispatchError(
+      renderConversationError({
+        messages: this.#messages,
+        appearance: this.#appearance,
+        error: error51,
+        fallbackCode,
+        startNewConversation: () => this.#startNewConversation(),
+        reconnect: () => this.reconnect(),
+        revealLatest: () => this.#revealLatest()
+      })
+    );
   }
   #startNewConversation() {
     this.resetSession();
@@ -33648,7 +33976,9 @@ var NoodleAssistantElement = class extends HTMLElementBase {
     }
   }
   #applyConfiguration(configuration) {
+    this.#webmcp.configure(configuration.assistant?.webmcp?.enabled === true);
     this.#appearance = resolveAppearance(configuration);
+    this.#suggestions.render();
     this.#syncAppearance();
     this.#applyStartOpenPolicy();
   }
@@ -33693,15 +34023,7 @@ var NoodleAssistantElement = class extends HTMLElementBase {
       "aria-label",
       appearance.labels.close
     );
-    const prompts = queryRequired(this.shadowRoot, ".suggested-prompts");
-    prompts.replaceChildren();
-    for (const prompt of appearance.suggestedPrompts) {
-      const button2 = document.createElement("button");
-      button2.type = "button";
-      button2.textContent = prompt;
-      button2.addEventListener("click", () => this.#sendGuarded(prompt));
-      prompts.append(button2);
-    }
+    this.#suggestions.render();
     queryRequired(this.shadowRoot, "header").hidden = !appearance.behavior.showHeader;
     const legal = queryRequired(this.shadowRoot, ".legal");
     legal.replaceChildren();
@@ -33739,14 +34061,7 @@ var NoodleAssistantElement = class extends HTMLElementBase {
     textarea.placeholder = appearance.labels.composerPlaceholder;
     textarea.setAttribute("aria-label", appearance.labels.composerPlaceholder);
     queryRequired(this.shadowRoot, ".send").textContent = appearance.labels.send;
-    const prompts = queryRequired(this.shadowRoot, ".suggested-prompts");
-    for (const prompt of appearance.suggestedPrompts) {
-      const button2 = document.createElement("button");
-      button2.type = "button";
-      button2.textContent = prompt;
-      button2.addEventListener("click", () => this.#sendGuarded(prompt));
-      prompts.append(button2);
-    }
+    this.#suggestions.render();
     if (!appearance.behavior.showLauncher)
       queryRequired(this.shadowRoot, ".launcher").hidden = true;
     if (!appearance.behavior.showHeader)