@noodleseed/assistant 1.28.0 → 1.29.0

package/dist/{chunk-QH7PL3GU.js → chunk-DOWFW3KA.js}

@@ -11,7 +11,7 @@ import {
   parseAssistantConfiguration,
   publicConfigurationUrl,
   sessionSourceKey
-} from "./chunk-WJV4MJUR.js";
+} from "./chunk-3VZ3M5BE.js";
 
 // src/appearance.ts
 var common = {
@@ -154,11 +154,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"
 };
@@ -191,11 +188,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,
@@ -438,6 +432,22 @@ function appendConversationRecovery(input) {
   input.revealLatest();
 }
 
+// src/element-error-recovery.ts
+function renderConversationError(options) {
+  const { appearance, error } = options;
+  const detail = error instanceof AssistantClientError ? error.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");
@@ -4588,6 +4598,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",
@@ -4896,6 +4959,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 = isRecord3(listed) && Array.isArray(listed.tools) ? listed.tools : [];
+  const projectable = [];
+  for (const tool of tools) {
+    if (!isRecord3(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: isRecord3(tool.inputSchema) ? tool.inputSchema : void 0,
+      annotations: isRecord3(tool.annotations) ? tool.annotations : void 0
+    });
+  }
+  return projectable;
+}
+function readVisibility(tool) {
+  const meta = isRecord3(tool._meta) ? tool._meta : void 0;
+  const ui = meta && isRecord3(meta.ui) ? meta.ui : void 0;
+  const visibility = ui?.visibility;
+  return Array.isArray(visibility) ? visibility.filter((entry) => typeof entry === "string") : void 0;
+}
+async function executeThroughAssistant(client, name, args) {
+  let suspend;
+  const suspended = new Promise((resolve) => {
+    suspend = resolve;
+  });
+  try {
+    const call = client.requestApp(
+      "tools/call",
+      { name, 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 (error) {
+    return textResult(error instanceof Error ? error.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 (isRecord3(value) && Array.isArray(value.content)) return value;
+  return textResult(JSON.stringify(value ?? null), false);
+}
+function textResult(text2, isError) {
+  return { content: [{ type: "text", text: text2 }], isError };
+}
+function isRecord3(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"]) {
@@ -5139,9 +5343,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 = "";
@@ -5253,6 +5466,7 @@ var NoodleAssistantElement = class extends HTMLElementBase {
     this.#launcher.disconnect();
     this.#setBusy(false);
     this.#environment.disconnect();
+    this.#webmcp.stop();
   }
   attributeChangedCallback(name) {
     if (name === "theme") this.#applyTheme();
@@ -5286,6 +5500,7 @@ var NoodleAssistantElement = class extends HTMLElementBase {
   }
   resetSession() {
     this.#conversationGeneration += 1;
+    this.#webmcp.stop();
     this.#client?.abort();
     this.#unsubscribeClient?.();
     this.#client = void 0;
@@ -5295,12 +5510,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;
@@ -5358,6 +5575,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 {
@@ -5377,12 +5595,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(text2) {
     void this.sendMessage(text2).catch(() => {
     });
@@ -5434,13 +5647,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((error) => {
+    const bootstrap = client.connect().then(() => {
+      if (generation === this.#conversationGeneration && this.#client === client) {
+        this.#suggestions.maybeLoadInitial();
+      }
+    }).catch((error) => {
       if (generation !== this.#conversationGeneration || this.#client !== client) return;
       this.#dispatchClientError(error, "session_failed");
       this.#presentationGate.reveal();
@@ -5452,15 +5673,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();
@@ -5564,23 +5788,17 @@ var NoodleAssistantElement = class extends HTMLElementBase {
     if (error instanceof AssistantClientError && error.detail.code === "session_failed") {
       this.#setSessionState("error");
     }
-    const detail = error instanceof AssistantClientError ? error.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,
+        fallbackCode,
+        startNewConversation: () => this.#startNewConversation(),
+        reconnect: () => this.reconnect(),
+        revealLatest: () => this.#revealLatest()
+      })
+    );
   }
   #startNewConversation() {
     this.resetSession();
@@ -5613,7 +5831,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();
   }
@@ -5658,15 +5878,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();
@@ -5704,14 +5916,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)
@@ -5770,4 +5975,4 @@ export {
 dompurify/dist/purify.es.mjs:
   (*! @license DOMPurify 3.4.11 | (c) Cure53 and other contributors | Released under the Apache license 2.0 and Mozilla Public License 2.0 | github.com/cure53/DOMPurify/blob/3.4.11/LICENSE *)
 */
-//# sourceMappingURL=chunk-QH7PL3GU.js.map
+//# sourceMappingURL=chunk-DOWFW3KA.js.map