@noodleseed/assistant 1.13.0 → 1.15.0

package/README.md

@@ -305,6 +305,11 @@ Do not also key an ancestor by the whole view object or a callback. Pass the emb
 resolved `"light"` or `"dark"` theme; later changes are published through MCP Apps host context without
 replacing the iframe.
 
+The App document owns its action intent: it calls standard `tools/call` after connecting and never relies on
+native form navigation. If that call needs input or confirmation, the same `client` publishes the normal
+pending interaction part for either managed or customer-owned rendering. The original App call stays pending
+and receives its MCP result after `client.respond(...)`; applications must not retry or translate the click.
+
 Outside React, subscribe to the DOM-free AI SDK `UIMessage` state without registering a custom element or
 touching browser storage:
 

package/dist/{chunk-KRB2SXFD.js → chunk-RRJIK473.js}

@@ -8108,7 +8108,7 @@ var AssistantChatStateStore = class {
         this.#writeText(event.data.delta);
         return;
       case "tool_proposed":
-        this.#writeConfirmation(event.data);
+        this.#writeStandaloneData(() => this.#writeConfirmation(event.data));
         return;
       case "interaction_proposed":
         this.#writeData("confirmation", event.data.id, {
@@ -8117,10 +8117,12 @@ var AssistantChatStateStore = class {
         });
         return;
       case "input_requested":
-        this.#writeData("input-request", event.data.id, {
-          ...event.data,
-          status: "pending"
-        });
+        this.#writeStandaloneData(
+          () => this.#writeData("input-request", event.data.id, {
+            ...event.data,
+            status: "pending"
+          })
+        );
         return;
       case "tool_completed":
         this.#writeData("tool-result", event.data.id, event.data);
@@ -8227,6 +8229,12 @@ var AssistantChatStateStore = class {
   #writeConfirmation(data) {
     this.#writeData("confirmation", data.id, { ...data, status: "pending" });
   }
+  #writeStandaloneData(write) {
+    const standalone = this.#operation === void 0;
+    if (standalone) this.#startOperation();
+    write();
+    if (standalone) this.#closeOperation("ready");
+  }
   #writeData(name21, id, data) {
     const operation = this.#operation;
     if (!operation || operation.closed) return;
@@ -8559,6 +8567,24 @@ function hasToJsonProperty(value) {
   return false;
 }
 
+// src/session-source.ts
+var NOODLE_CLOUD_URL = "https://cloud.noodleseed.dev";
+var PUBLIC_SESSION_PATH = "/v1/assistant/public-sessions";
+function resolveSessionSource(options) {
+  const { sessionEndpoint, embedId, serviceUrl } = options;
+  if (Boolean(embedId) === Boolean(sessionEndpoint)) {
+    throw new Error("pass either embedId or sessionEndpoint, not both and not neither");
+  }
+  if (embedId) {
+    const base = (serviceUrl ?? NOODLE_CLOUD_URL).replace(/\/+$/, "");
+    return { kind: "public", url: `${base}${PUBLIC_SESSION_PATH}`, embedId };
+  }
+  return { kind: "exchange", url: sessionEndpoint };
+}
+function sessionSourceKey(options) {
+  return `${options.embedId ?? ""}|${options.serviceUrl ?? ""}|${options.sessionEndpoint ?? ""}`;
+}
+
 // src/transport.ts
 var AssistantTransportError = class extends Error {
   code = "invalid_response";
@@ -8686,6 +8712,19 @@ function isAbortError2(error) {
 }
 
 // src/client.ts
+async function refusalCode(response) {
+  try {
+    const body = await response.clone().json();
+    const code = body.code;
+    return typeof code === "string" ? code : void 0;
+  } catch {
+    return void 0;
+  }
+}
+var UNRETRYABLE_SERVICE_CODES = /* @__PURE__ */ new Set([
+  "daily_turn_budget_exhausted",
+  "daily_session_budget_exhausted"
+]);
 var AssistantClientError = class extends Error {
   detail;
   constructor(detail, message, options) {
@@ -8695,7 +8734,7 @@ var AssistantClientError = class extends Error {
   }
 };
 var DefaultAssistantClient = class {
-  #sessionEndpoint;
+  #source;
   #fetch;
   #listeners = /* @__PURE__ */ new Set();
   #chat = new AssistantChatStateStore();
@@ -8705,9 +8744,9 @@ var DefaultAssistantClient = class {
   #context;
   #modelContext;
   #active;
+  #pendingAppInteractions = /* @__PURE__ */ new Map();
   constructor(options) {
-    if (!options.sessionEndpoint) throw new Error("sessionEndpoint is required");
-    this.#sessionEndpoint = options.sessionEndpoint;
+    this.#source = resolveSessionSource(options);
     this.#fetch = options.fetch ?? ((input, init) => globalThis.fetch(input, init));
     this.#context = options.context ? { ...options.context } : void 0;
     this.#modelContext = options.modelContext ? copyAssistantModelContext(options.modelContext) : void 0;
@@ -8746,6 +8785,7 @@ var DefaultAssistantClient = class {
     }
     await this.#singleFlight(async (signal) => {
       await this.#runChatOperation(signal, async () => {
+        const pendingApp = this.#pendingAppInteractions.get(id);
         const session = this.#session;
         if (!session) {
           throw clientError("confirmation_expired", "assistant session is not active", false);
@@ -8765,32 +8805,67 @@ var DefaultAssistantClient = class {
           ...resolution.action === "accept" && resolution.content !== void 0 ? { content: resolution.content } : {}
         } : { id };
         this.#emit({ event: "interaction_started", data: { id, action: resolution.action } });
-        const response = await this.#request(
-          endpoint,
-          {
-            method: "POST",
-            headers: authorizedHeaders(session.token, "text/event-stream"),
-            body: JSON.stringify(body),
-            signal
-          },
-          "confirmation_failed"
-        );
-        if (response.status === 401) {
-          this.#session = void 0;
-          this.#emit({ event: "session_expired", data: {} });
-        }
-        if (!response.ok) {
-          const serverCode = await readStableErrorCode(response);
-          const expired = response.status === 401 || response.status === 409;
-          throw clientError(
-            serverCode ?? (expired ? "confirmation_expired" : "confirmation_failed"),
-            `Assistant interaction failed (${response.status})`,
-            false,
-            response.status
+        try {
+          const response = await this.#request(
+            endpoint,
+            {
+              method: "POST",
+              headers: authorizedHeaders(session.token, "text/event-stream"),
+              body: JSON.stringify(body),
+              signal
+            },
+            "confirmation_failed"
           );
+          if (response.status === 401) {
+            this.#session = void 0;
+            this.#emit({ event: "session_expired", data: {} });
+          }
+          if (!response.ok) {
+            const serverCode = await readStableErrorCode(response);
+            const expired = response.status === 401 || response.status === 409;
+            throw clientError(
+              serverCode ?? (expired ? "confirmation_expired" : "confirmation_failed"),
+              `Assistant interaction failed (${response.status})`,
+              false,
+              response.status
+            );
+          }
+          let completedResult;
+          let nextInteractionId;
+          await this.#consume(response, (event) => {
+            if (event.event === "tool_completed" && event.data.id === id) {
+              completedResult = event.data.result;
+            }
+            if ((event.event === "tool_proposed" || event.event === "input_requested") && event.data.id !== id) {
+              nextInteractionId = event.data.id;
+            }
+          });
+          this.#emit({ event: "interaction_completed", data: { id, action: resolution.action } });
+          if (pendingApp) {
+            this.#pendingAppInteractions.delete(id);
+            if (nextInteractionId) {
+              this.#pendingAppInteractions.set(nextInteractionId, pendingApp);
+            } else if (resolution.action !== "accept") {
+              pendingApp.resolve(appInteractionStopped(resolution.action));
+            } else if (completedResult !== void 0) {
+              pendingApp.resolve(appToolResult(completedResult));
+            } else {
+              pendingApp.reject(
+                clientError(
+                  "invalid_response",
+                  "Assistant app interaction completed without a tool result",
+                  false
+                )
+              );
+            }
+          }
+        } catch (error) {
+          if (pendingApp && this.#pendingAppInteractions.get(id) === pendingApp) {
+            this.#pendingAppInteractions.delete(id);
+            pendingApp.reject(error);
+          }
+          throw error;
         }
-        await this.#consume(response);
-        this.#emit({ event: "interaction_completed", data: { id, action: resolution.action } });
       });
     });
   }
@@ -8831,12 +8906,29 @@ var DefaultAssistantClient = class {
         response.status
       );
     }
-    return response.json();
+    const value = await response.json();
+    const interaction = parseAppInteraction(value);
+    if (!interaction) return value;
+    return new Promise((resolve2, reject) => {
+      const id = interaction.data.id;
+      const replaced = this.#pendingAppInteractions.get(id);
+      if (replaced) {
+        replaced.reject(
+          clientError("invalid_response", "Assistant returned a duplicate app interaction", false)
+        );
+      }
+      this.#pendingAppInteractions.set(id, { resolve: resolve2, reject });
+      this.#emit(interaction);
+      void this.#chat.flush();
+    });
   }
   appSandboxUrl() {
     return this.#session?.endpoints.sandbox;
   }
   resetSession() {
+    this.#rejectPendingAppInteractions(
+      clientError("confirmation_expired", "assistant session is not active", false)
+    );
     this.#session = void 0;
     this.#emit({ event: "session_reset", data: {} });
   }
@@ -8870,11 +8962,14 @@ var DefaultAssistantClient = class {
       return;
     }
     if (!response.ok) {
+      const serviceCode = await refusalCode(response);
       throw clientError(
         "turn_failed",
         `Assistant turn failed (${response.status})`,
         false,
-        response.status
+        response.status,
+        void 0,
+        serviceCode
       );
     }
     await this.#consume(response);
@@ -8913,23 +9008,25 @@ var DefaultAssistantClient = class {
     }
   }
   async #createSession(signal) {
-    const response = await this.#request(
-      this.#sessionEndpoint,
-      {
-        method: "POST",
-        headers: { Accept: "application/json", "Content-Type": "application/json" },
-        body: JSON.stringify(this.#context ? { context: this.#context } : {}),
-        credentials: "same-origin",
-        signal
-      },
-      "session_failed"
-    );
+    const source = this.#source;
+    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 } : {}
+      ),
+      credentials: source.kind === "public" ? "omit" : "same-origin",
+      signal
+    });
     if (!response.ok) {
+      const serviceCode = await refusalCode(response);
       throw clientError(
         "session_failed",
         `Assistant session failed (${response.status})`,
-        true,
-        response.status
+        serviceCode === void 0 || !UNRETRYABLE_SERVICE_CODES.has(serviceCode),
+        response.status,
+        void 0,
+        serviceCode
       );
     }
     let value;
@@ -8957,12 +9054,13 @@ var DefaultAssistantClient = class {
     });
     return session;
   }
-  async #consume(response) {
+  async #consume(response, observe) {
     let streamError;
     try {
       await consumeAssistantEvents(response, (event) => {
         const clientEvent = toAssistantClientEvent(event);
         this.#emit(clientEvent);
+        observe?.(clientEvent);
         if (clientEvent.event !== "error" || typeof clientEvent.data.code !== "string") return;
         streamError = {
           code: clientEvent.data.code,
@@ -8985,6 +9083,34 @@ var DefaultAssistantClient = class {
       );
     }
   }
+  /**
+   * The mint, with the one failure a public page hits that an in-app embed cannot.
+   *
+   * A page that loads the embed script and then blocks `connect-src` fails here as a bare network
+   * rejection — no status, no body, nothing to read. "Assistant request failed" sends a developer
+   * hunting through their own code; naming the directive and the origin ends the search. The message
+   * covers a plain outage too, because from inside the browser the two are indistinguishable.
+   */
+  async #requestSession(source, init) {
+    try {
+      return await this.#fetch(source.url, init);
+    } catch (error) {
+      if (init.signal?.aborted) throw error;
+      if (source.kind !== "public") {
+        throw clientError("session_failed", "Assistant request failed", true, void 0, {
+          cause: error
+        });
+      }
+      throw clientError(
+        "session_failed",
+        `Assistant could not reach ${new URL(source.url).origin}. If the page sets a Content-Security-Policy, allow that origin in connect-src (and in script-src and frame-src).`,
+        true,
+        void 0,
+        { cause: error },
+        "blocked_by_page"
+      );
+    }
+  }
   async #request(input, init, failureCode) {
     try {
       return await this.#fetch(input, init);
@@ -9031,6 +9157,10 @@ var DefaultAssistantClient = class {
       }
     }
   }
+  #rejectPendingAppInteractions(error) {
+    for (const pending of this.#pendingAppInteractions.values()) pending.reject(error);
+    this.#pendingAppInteractions.clear();
+  }
 };
 function createAssistantClient(options) {
   return new DefaultAssistantClient(options);
@@ -9042,6 +9172,30 @@ function authorizedHeaders(token, accept) {
     Accept: accept
   };
 }
+function parseAppInteraction(value) {
+  if (!isRecord4(value) || !isRecord4(value.interaction)) return void 0;
+  const event = value.interaction.event;
+  const data = value.interaction.data;
+  if (event !== "tool_proposed" && event !== "input_requested" || !isRecord4(data)) {
+    return void 0;
+  }
+  const parsed = toAssistantClientEvent({ event, data });
+  return parsed.event === "tool_proposed" || parsed.event === "input_requested" ? parsed : void 0;
+}
+function appToolResult(result) {
+  const text2 = typeof result === "string" ? result : JSON.stringify(result);
+  return result !== null && typeof result === "object" && !Array.isArray(result) ? {
+    content: [{ type: "text", text: text2 }],
+    structuredContent: result,
+    isError: false
+  } : { content: [{ type: "text", text: text2 }], isError: false };
+}
+function appInteractionStopped(action) {
+  return {
+    content: [{ type: "text", text: `interaction_${action}` }],
+    isError: true
+  };
+}
 function parseSession(value) {
   if (!isRecord4(value) || !isRecord4(value.endpoints)) {
     throw clientError("session_failed", "Assistant session response is invalid", true);
@@ -9078,9 +9232,14 @@ async function readStableErrorCode(response) {
   if (!isRecord4(value) || typeof value.code !== "string") return void 0;
   return /^[A-Za-z0-9_.-]{1,64}$/.test(value.code) ? value.code : void 0;
 }
-function clientError(code, message, retryable, status, options) {
+function clientError(code, message, retryable, status, options, serviceCode) {
   return new AssistantClientError(
-    { code, ...status === void 0 ? {} : { status }, retryable },
+    {
+      code,
+      ...status === void 0 ? {} : { status },
+      retryable,
+      ...serviceCode === void 0 ? {} : { serviceCode }
+    },
     message,
     options
   );
@@ -9088,7 +9247,8 @@ function clientError(code, message, retryable, status, options) {
 
 export {
   copyAssistantModelContext,
+  sessionSourceKey,
   AssistantClientError,
   createAssistantClient
 };
-//# sourceMappingURL=chunk-KRB2SXFD.js.map
+//# sourceMappingURL=chunk-RRJIK473.js.map