@noodleseed/assistant 1.19.0 → 1.21.0

package/dist/index.cjs

@@ -27030,6 +27030,12 @@ var AssistantChatStateStore = class {
       case "interaction_started":
         this.#beginInteraction(event.data.id);
         return;
+      case "resume_started":
+        this.#status = "submitted";
+        this.#error = void 0;
+        this.#startOperation();
+        this.#notify();
+        return;
       case "content":
         this.#writeText(event.data.delta);
         return;
@@ -27285,6 +27291,78 @@ function isRecord(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 
+// src/client-errors.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) {
+    super(message, options);
+    this.name = "AssistantClientError";
+    this.detail = detail;
+  }
+};
+function parseSession(value) {
+  if (!isRecord2(value) || !isRecord2(value.endpoints)) {
+    throw clientError("session_failed", "Assistant session response is invalid", true);
+  }
+  const interactions = value.endpoints.interactions;
+  const apps = value.endpoints.apps;
+  const sandbox = value.endpoints.sandbox;
+  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") {
+    throw clientError("session_failed", "Assistant session response is invalid", true);
+  }
+  return {
+    token: value.token,
+    expiresAt: value.expiresAt,
+    endpoints: {
+      turns: value.endpoints.turns,
+      toolConfirmations: value.endpoints.toolConfirmations,
+      ...typeof interactions === "string" ? { interactions } : {},
+      ...typeof apps === "string" ? { apps } : {},
+      ...typeof sandbox === "string" ? { sandbox } : {}
+    },
+    ...isRecord2(value.configuration) ? { configuration: value.configuration } : {},
+    ...isRecord2(value.resume) && typeof value.resume.tool === "string" ? { resume: { tool: value.resume.tool } } : {}
+  };
+}
+function isRecord2(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+async function readStableErrorCode(response) {
+  let value;
+  try {
+    value = await response.json();
+  } catch {
+    return void 0;
+  }
+  if (!isRecord2(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, serviceCode) {
+  return new AssistantClientError(
+    {
+      code,
+      ...status === void 0 ? {} : { status },
+      retryable,
+      ...serviceCode === void 0 ? {} : { serviceCode }
+    },
+    message,
+    options
+  );
+}
+
 // src/events.ts
 function toAssistantClientEvent(event) {
   const value = event.data;
@@ -27300,20 +27378,25 @@ function toAssistantClientEvent(event) {
       }
       break;
     case "tool_proposed":
-      if (hasString(value, "id") && hasString(value, "tool") && hasOptionalString(value.title) && hasOptionalString(value.description) && hasOptionalJson(value.arguments) && (value.reviewSchema === void 0 || isRecord2(value.reviewSchema)) && hasOptionalString(value.expiresAt) && (value.requiresConfirmation === void 0 || value.requiresConfirmation === true) && hasOptionalTurnId(value)) {
+      if (hasString(value, "id") && hasString(value, "tool") && hasOptionalString(value.title) && hasOptionalString(value.description) && hasOptionalJson(value.arguments) && (value.reviewSchema === void 0 || isRecord3(value.reviewSchema)) && hasOptionalString(value.expiresAt) && (value.requiresConfirmation === void 0 || value.requiresConfirmation === true) && hasOptionalTurnId(value)) {
         return event;
       }
       break;
     case "input_requested":
-      if (hasString(value, "id") && hasString(value, "message") && isRecord2(value.requestedSchema) && hasString(value, "expiresAt") && hasOptionalTurnId(value)) {
+      if (hasString(value, "id") && hasString(value, "message") && isRecord3(value.requestedSchema) && hasString(value, "expiresAt") && hasOptionalTurnId(value)) {
         return event;
       }
       break;
-    case "auth_requested":
-      if (hasString(value, "id") && hasString(value, "tool") && hasString(value, "continuation") && hasString(value, "expiresAt") && hasOptionalTurnId(value)) {
-        return event;
+    case "auth_requested": {
+      const signInTicket = typeof value.signInTicket === "string" ? value.signInTicket : typeof value.continuation === "string" ? value.continuation : void 0;
+      if (hasString(value, "id") && hasString(value, "tool") && signInTicket !== void 0 && hasString(value, "expiresAt") && hasOptionalTurnId(value)) {
+        return {
+          event: "auth_requested",
+          data: { ...value, signInTicket }
+        };
       }
       break;
+    }
     case "interaction_resolved":
       if (hasString(value, "id") && (value.action === void 0 || isInteractionAction(value.action)) && hasOptionalTurnId(value)) {
         return event;
@@ -27344,7 +27427,7 @@ function toAssistantClientEvent(event) {
   return { event: "unrecognized", data: { name: event.event, payload: 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 || isRecord2(value.resourceMeta)) && (value.allowedOpenDomains === void 0 || Array.isArray(value.allowedOpenDomains) && value.allowedOpenDomains.every(isHttpsUrl)) && hasOptionalTurnId(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(isHttpsUrl)) && hasOptionalTurnId(value);
 }
 function isHttpsUrl(value) {
   if (typeof value !== "string") return false;
@@ -27377,11 +27460,11 @@ function isJsonValue(value, depth) {
   if (Array.isArray(value)) {
     return value.length <= 256 && value.every((entry) => isJsonValue(entry, depth + 1));
   }
-  if (!isRecord2(value)) return false;
+  if (!isRecord3(value)) return false;
   const entries2 = Object.entries(value);
   return entries2.length <= 256 && entries2.every(([, entry]) => isJsonValue(entry, depth + 1));
 }
-function isRecord2(value) {
+function isRecord3(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 
@@ -27511,15 +27594,15 @@ function parseFrame(frame) {
   if (event === "done" && !isValidDonePayload(parsed)) {
     throw invalidStream("assistant event stream contained an invalid done event");
   }
-  return { event, data: isRecord3(parsed) ? parsed : { value: parsed } };
+  return { event, data: isRecord4(parsed) ? parsed : { value: parsed } };
 }
 function normalizeLineEndings(input) {
   return input.replaceAll("\r\n", "\n").replaceAll("\r", "\n");
 }
 function isValidDonePayload(value) {
-  return isRecord3(value) && (value.turnId === void 0 || typeof value.turnId === "string" && value.turnId.length > 0);
+  return isRecord4(value) && (value.turnId === void 0 || typeof value.turnId === "string" && value.turnId.length > 0);
 }
-function isRecord3(value) {
+function isRecord4(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function invalidStream(message, cause) {
@@ -27530,27 +27613,6 @@ function isAbortError2(error51) {
 }
 
 // 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) {
-    super(message, options);
-    this.name = "AssistantClientError";
-    this.detail = detail;
-  }
-};
 var DefaultAssistantClient = class {
   #source;
   #fetch;
@@ -27585,12 +27647,50 @@ var DefaultAssistantClient = class {
   hasSession() {
     return this.#session !== void 0;
   }
+  /** Whether a request holds the single-flight slot, so callers can refuse before mutating UI. */
+  isBusy() {
+    return this.#active !== void 0;
+  }
   async connect() {
     if (this.#session) return;
     await this.#singleFlight(async (signal) => {
-      if (!this.#session) await this.#createSession(signal);
+      if (this.#session) return;
+      const session = await this.#createSession(signal);
+      if (session.resume) {
+        try {
+          await this.#runChatOperation(signal, () => this.#resumeTurn(session, signal));
+        } catch {
+        }
+      }
     });
   }
+  /** POST the one-shot resume trigger; a 409 means nothing was pending, which renders as silence. */
+  async #resumeTurn(session, signal) {
+    const response = await this.#request(
+      session.endpoints.turns,
+      {
+        method: "POST",
+        headers: authorizedHeaders(session.token, "text/event-stream"),
+        body: JSON.stringify({ resume: true }),
+        signal
+      },
+      "turn_failed"
+    );
+    if (response.status === 409) return;
+    if (!response.ok) {
+      throw clientError(
+        "turn_failed",
+        `Assistant turn failed (${response.status})`,
+        false,
+        response.status,
+        void 0,
+        await refusalCode(response)
+      );
+    }
+    this.#emit({ event: "resume_started", data: { tool: session.resume?.tool ?? "" } });
+    await this.#consume(response);
+    this.#emit({ event: "message_completed", data: {} });
+  }
   async sendMessage(text3) {
     const message = text3.trim();
     if (!message) return;
@@ -27995,10 +28095,10 @@ function authorizedHeaders(token, accept) {
   };
 }
 function parseAppInteraction(value) {
-  if (!isRecord4(value) || !isRecord4(value.interaction)) return void 0;
+  if (!isRecord2(value) || !isRecord2(value.interaction)) return void 0;
   const event = value.interaction.event;
   const data = value.interaction.data;
-  if (event !== "tool_proposed" && event !== "input_requested" || !isRecord4(data)) {
+  if (event !== "tool_proposed" && event !== "input_requested" || !isRecord2(data)) {
     return void 0;
   }
   const parsed = toAssistantClientEvent({ event, data });
@@ -28018,54 +28118,6 @@ function appInteractionStopped(action) {
     isError: true
   };
 }
-function parseSession(value) {
-  if (!isRecord4(value) || !isRecord4(value.endpoints)) {
-    throw clientError("session_failed", "Assistant session response is invalid", true);
-  }
-  const interactions = value.endpoints.interactions;
-  const apps = value.endpoints.apps;
-  const sandbox = value.endpoints.sandbox;
-  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") {
-    throw clientError("session_failed", "Assistant session response is invalid", true);
-  }
-  return {
-    token: value.token,
-    expiresAt: value.expiresAt,
-    endpoints: {
-      turns: value.endpoints.turns,
-      toolConfirmations: value.endpoints.toolConfirmations,
-      ...typeof interactions === "string" ? { interactions } : {},
-      ...typeof apps === "string" ? { apps } : {},
-      ...typeof sandbox === "string" ? { sandbox } : {}
-    },
-    ...isRecord4(value.configuration) ? { configuration: value.configuration } : {}
-  };
-}
-function isRecord4(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-async function readStableErrorCode(response) {
-  let value;
-  try {
-    value = await response.json();
-  } catch {
-    return void 0;
-  }
-  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, serviceCode) {
-  return new AssistantClientError(
-    {
-      code,
-      ...status === void 0 ? {} : { status },
-      retryable,
-      ...serviceCode === void 0 ? {} : { serviceCode }
-    },
-    message,
-    options
-  );
-}
 
 // src/input-request-card.ts
 function createInputRequestCard(options) {
@@ -31250,6 +31302,11 @@ var AssistantElementEventController = class {
       this.#completedTool = void 0;
       return;
     }
+    if (name21 === "resume_started") {
+      this.#startStream("message");
+      this.#host.element.dispatchEvent(new CustomEvent("assistant-message-started"));
+      return;
+    }
     if (name21 === "interaction_completed") {
       if (this.#streamKind !== "interaction") return;
       this.#finishInteraction(String(data.id ?? ""), String(data.action ?? "accept"));
@@ -31270,11 +31327,11 @@ var AssistantElementEventController = class {
       );
       return;
     }
-    if (name21 === "auth_requested" && typeof data.continuation === "string") {
+    if (name21 === "auth_requested" && typeof data.signInTicket === "string") {
       this.#appendSignInRequest(
         String(data.id ?? ""),
         String(data.tool ?? "this"),
-        data.continuation,
+        data.signInTicket,
         String(data.expiresAt ?? "")
       );
       return;
@@ -31367,15 +31424,15 @@ var AssistantElementEventController = class {
   /**
    * The host application owns the login. This renders the prompt and raises
    * `assistant-sign-in-requested`; the page signs the visitor in however it already does, then its
-   * backend spends the continuation. Nothing here talks to an identity provider.
+   * backend spends the sign-in ticket. Nothing here talks to an identity provider.
    */
-  #appendSignInRequest(id, tool, continuation, expiresAt) {
+  #appendSignInRequest(id, tool, signInTicket, expiresAt) {
     const messages = this.#host.messages();
     if (!messages) return;
     this.#proposalCards.get(id)?.remove();
     const card = createSignInCard({
       tool,
-      continuation,
+      signInTicket,
       expiresAt,
       labels: {
         heading: "Sign in to continue",
@@ -31383,7 +31440,7 @@ var AssistantElementEventController = class {
       },
       onSignIn: () => this.#host.element.dispatchEvent(
         new CustomEvent("assistant-sign-in-requested", {
-          detail: { id, tool, continuation, expiresAt },
+          detail: { id, tool, signInTicket, expiresAt },
           bubbles: true,
           composed: true
         })
@@ -31394,7 +31451,7 @@ var AssistantElementEventController = class {
     this.#host.revealLatest();
     this.#host.element.dispatchEvent(
       new CustomEvent("assistant-sign-in-required", {
-        detail: { id, tool, continuation, expiresAt }
+        detail: { id, tool, signInTicket, expiresAt }
       })
     );
   }
@@ -31468,6 +31525,36 @@ function queryRequired(root, selector) {
   if (!element) throw new Error(`assistant renderer is missing ${selector}`);
   return element;
 }
+function assistantElementMarkup(appearance, open, styles) {
+  return `${styles}
+      <button class="launcher" type="button" aria-label="${escapeAttribute(appearance.labels.open)}" aria-controls="assistant-panel" aria-expanded="${String(open)}"><slot name="launcher-icon"></slot><span class="visually-hidden" data-session-status aria-live="polite" hidden></span></button>
+      <section class="panel" id="assistant-panel" role="dialog" aria-label="${escapeAttribute(appearance.brand.name)}">
+        <header><slot name="header-leading"></slot><img class="brand-logo" alt=""><strong></strong><slot name="header-actions"></slot><button class="close" type="button" aria-label="${escapeAttribute(appearance.labels.close)}"></button></header>
+        <div class="welcome"><slot name="empty-state"></slot></div>
+        <div class="suggested-prompts"></div>
+        <div class="messages-region">
+          <div class="messages" aria-live="polite"></div>
+          <button class="new-messages" type="button" aria-label="${escapeAttribute(appearance.labels.newMessages)}" hidden></button>
+        </div>
+        <form><slot name="composer-leading"></slot><textarea rows="1"></textarea><button class="send" type="submit"></button><slot name="composer-trailing"></slot></form>
+        <nav class="legal" aria-label="Legal"></nav>
+        <slot name="conversation-footer"></slot>
+      </section>`;
+}
+function appendLegalLinks(legal, appearance) {
+  for (const [label, href] of [
+    ["Privacy", appearance.privacyUrl],
+    ["Terms", appearance.termsUrl]
+  ]) {
+    if (!href) continue;
+    const link = document.createElement("a");
+    link.href = href;
+    link.target = "_blank";
+    link.rel = "noopener noreferrer";
+    link.textContent = label;
+    legal.append(link);
+  }
+}
 
 // src/element-page-context-controller.ts
 var AssistantElementPageContextController = class {
@@ -32255,6 +32342,8 @@ var NoodleAssistantElement = class extends HTMLElementBase {
   #pendingUserEcho;
   #sessionState = "idle";
   #startOpenApplied = false;
+  #readyDispatched = false;
+  #turnInFlight = false;
   #hostAppearance;
   #appearanceWarningKeys = /* @__PURE__ */ new Set();
   #appearanceStyleSnapshot = /* @__PURE__ */ new Map();
@@ -32326,7 +32415,10 @@ var NoodleAssistantElement = class extends HTMLElementBase {
     document.addEventListener("pointerdown", this.#handleDocumentPointerDown);
     if (this.#appearance.behavior.startOpen) this.#applyStartOpenPolicy();
     this.#render();
-    this.dispatchEvent(new CustomEvent("assistant-ready"));
+    if (!this.#readyDispatched) {
+      this.#readyDispatched = true;
+      this.dispatchEvent(new CustomEvent("assistant-ready"));
+    }
     if (this.hasAttribute("start-open")) {
       this.setAttribute("open", "");
       this.#startOpenApplied = true;
@@ -32440,7 +32532,14 @@ var NoodleAssistantElement = class extends HTMLElementBase {
   async sendMessage(text3) {
     const message = text3.trim();
     if (!message) return;
+    if (this.#turnInFlight) {
+      throw new AssistantClientError(
+        { code: "request_in_progress", retryable: true },
+        "an assistant request is already in progress"
+      );
+    }
     const generation = this.#conversationGeneration;
+    this.#turnInFlight = true;
     this.#pendingUserEcho = message;
     this.#appendMessage("user", message);
     this.#setBusy(true);
@@ -32457,6 +32556,7 @@ var NoodleAssistantElement = class extends HTMLElementBase {
       this.#dispatchClientError(error51, "turn_failed");
       throw error51;
     } finally {
+      this.#turnInFlight = false;
       if (this.#pendingUserEcho === message) this.#pendingUserEcho = void 0;
       if (generation === this.#conversationGeneration) this.#setBusy(false);
     }
@@ -32525,6 +32625,7 @@ var NoodleAssistantElement = class extends HTMLElementBase {
   #primeSession() {
     if (!this.sessionEndpoint && !this.embedId) return;
     if (this.#sessionBootstrap || this.#client?.hasSession()) return;
+    if (this.#client?.isBusy?.() === true) return;
     if (this.embedId && !this.#pageContext) void this.#automaticPageContext.refresh();
     const client = this.#ensureClient();
     const generation = this.#conversationGeneration;
@@ -32554,6 +32655,8 @@ var NoodleAssistantElement = class extends HTMLElementBase {
     if (event.event === "content" || event.event === "message_completed" || event.event === "interaction_completed" || event.event === "error") {
       this.#removeThinking();
     }
+    if (event.event === "resume_started") this.#setBusy(true);
+    if (event.event === "message_completed" || event.event === "error") this.#setBusy(false);
   }
   #setBusy(busy) {
     this.toggleAttribute("busy", busy);
@@ -32762,7 +32865,7 @@ var NoodleAssistantElement = class extends HTMLElementBase {
     queryRequired(this.shadowRoot, "header").hidden = !appearance.behavior.showHeader;
     const legal = queryRequired(this.shadowRoot, ".legal");
     legal.replaceChildren();
-    this.#appendLegalLinks(legal);
+    appendLegalLinks(legal, this.#appearance);
     this.#applyTheme();
   }
   #render() {
@@ -32778,20 +32881,11 @@ var NoodleAssistantElement = class extends HTMLElementBase {
     this.dataset.position = appearance.layout.position;
     this.dataset.density = appearance.layout.density;
     this.toggleAttribute("mobile-fullscreen", appearance.layout.mobileFullscreen);
-    this.shadowRoot.innerHTML = `${ASSISTANT_ELEMENT_STYLES}${presentationStyles}
-      <button class="launcher" type="button" aria-label="${escapeAttribute(appearance.labels.open)}" aria-controls="assistant-panel" aria-expanded="${String(this.hasAttribute("open"))}"><slot name="launcher-icon"></slot><span class="visually-hidden" data-session-status aria-live="polite" hidden></span></button>
-      <section class="panel" id="assistant-panel" role="dialog" aria-label="${escapeAttribute(appearance.brand.name)}">
-        <header><slot name="header-leading"></slot><img class="brand-logo" alt=""><strong></strong><slot name="header-actions"></slot><button class="close" type="button" aria-label="${escapeAttribute(appearance.labels.close)}"></button></header>
-        <div class="welcome"><slot name="empty-state"></slot></div>
-        <div class="suggested-prompts"></div>
-        <div class="messages-region">
-          <div class="messages" aria-live="polite"></div>
-          <button class="new-messages" type="button" aria-label="${escapeAttribute(appearance.labels.newMessages)}" hidden></button>
-        </div>
-        <form><slot name="composer-leading"></slot><textarea rows="1"></textarea><button class="send" type="submit"></button><slot name="composer-trailing"></slot></form>
-        <nav class="legal" aria-label="Legal"></nav>
-        <slot name="conversation-footer"></slot>
-      </section>`;
+    this.shadowRoot.innerHTML = assistantElementMarkup(
+      appearance,
+      this.hasAttribute("open"),
+      `${ASSISTANT_ELEMENT_STYLES}${presentationStyles}`
+    );
     queryRequired(this.shadowRoot, "strong").textContent = appearance.brand.name;
     const logo = queryRequired(this.shadowRoot, ".brand-logo");
     const logoUrl = appearance.brand.logo[this.#resolvedMode()];
@@ -32818,7 +32912,7 @@ var NoodleAssistantElement = class extends HTMLElementBase {
     if (!appearance.behavior.showHeader)
       queryRequired(this.shadowRoot, "header").hidden = true;
     const legal = queryRequired(this.shadowRoot, ".legal");
-    this.#appendLegalLinks(legal);
+    appendLegalLinks(legal, this.#appearance);
     this.#messages = this.shadowRoot.querySelector(".messages") ?? void 0;
     this.#messages?.append(...conversation);
     this.#thinking = this.#messages?.querySelector(".thinking") ?? void 0;
@@ -32857,20 +32951,6 @@ var NoodleAssistantElement = class extends HTMLElementBase {
     });
     this.#applyTheme();
   }
-  #appendLegalLinks(legal) {
-    for (const [label, href] of [
-      ["Privacy", this.#appearance.privacyUrl],
-      ["Terms", this.#appearance.termsUrl]
-    ]) {
-      if (!href) continue;
-      const link = document.createElement("a");
-      link.href = href;
-      link.target = "_blank";
-      link.rel = "noopener noreferrer";
-      link.textContent = label;
-      legal.append(link);
-    }
-  }
 };
 function registerNoodleAssistant() {
   if (globalThis.customElements && !customElements.get(ASSISTANT_TAG_NAME)) {