@webless/agent 0.3.0 → 0.3.2

package/dist/embed.cjs

@@ -178,11 +178,12 @@ function createAgentRuntimeCapability(options) {
   let pendingBootstrap;
   const bootstrap = async () => {
     let previewGrant;
+    const previewBuildId = options.previewBuildId?.trim();
     if (options.version === "unpublished") {
-      previewGrant = (await options.getUnpublishedPreviewGrant?.())?.trim();
-      if (!previewGrant) {
+      previewGrant = previewBuildId ? void 0 : (await options.getUnpublishedPreviewGrant?.())?.trim();
+      if (!previewGrant && !previewBuildId) {
         throw new Error(
-          "An unpublished preview grant is required to use the Agent Runtime preview."
+          "Unpublished preview authorization is required to use the Agent Runtime preview."
         );
       }
     }
@@ -192,6 +193,7 @@ function createAgentRuntimeCapability(options) {
         body: JSON.stringify({
           clientSessionId: options.visitorSessionId,
           indexId: options.indexId,
+          ...previewBuildId ? { previewBuildId } : {},
           ...previewGrant ? { previewGrant } : {},
           version: options.version
         }),
@@ -511,7 +513,7 @@ function applyWorkEvent(event, handlers, workItems) {
   );
 }
 var AgentSession = class {
-  constructor(indexId, version, runtimeOrigin, visitorSessionId, storeOptions, getUnpublishedPreviewGrant) {
+  constructor(indexId, version, runtimeOrigin, visitorSessionId, storeOptions, previewBuildId, getUnpublishedPreviewGrant) {
     this.indexId = indexId;
     this.version = version;
     this.runtimeOrigin = runtimeOrigin;
@@ -520,6 +522,7 @@ var AgentSession = class {
     this.capability = createAgentRuntimeCapability({
       getUnpublishedPreviewGrant,
       indexId,
+      previewBuildId,
       runtimeOrigin,
       version,
       visitorSessionId
@@ -764,6 +767,7 @@ function createAgentClient(options) {
     runtimeOrigin,
     visitorSessionId,
     storeOptions,
+    options.previewBuildId,
     options.getUnpublishedPreviewGrant
   );
   return {
@@ -790,6 +794,16 @@ function createAgentClient(options) {
 
 // src/runtime/errors.ts
 var import_client3 = require("eve/client");
+var TRANSIENT_AGENT_ERROR_MESSAGE = "I couldn\u2019t finish that answer. Please try again.";
+var PREVIEW_AUTHORIZATION_ERROR_MESSAGE = "This preview could not be authorized. Open the latest preview from Webless.";
+function isTransientRuntimeMessage(message) {
+  const normalized = message.trim().toLowerCase();
+  return normalized.includes("empty response from runtime") || normalized.includes("failed to fetch") || normalized.includes("networkerror") || normalized.includes("load failed");
+}
+function isPreviewAuthorizationMessage(message) {
+  const normalized = message.trim().toLowerCase();
+  return normalized.includes("unpublished preview authorization") || normalized.includes("unpublished preview grant") || normalized.includes("agent studio preview grant") || normalized.includes("preview authorization");
+}
 function formatAgentError(error) {
   if (error instanceof import_client3.ClientError) {
     if (error.status === 401 && error.code === "index_required") {
@@ -801,13 +815,24 @@ function formatAgentError(error) {
     if (error.status === 409 && error.code === "session_not_active") {
       return "Session expired \u2014 send a new message to start again.";
     }
-    return error.message || `Runtime error (${error.status})`;
+    if (error.message && isPreviewAuthorizationMessage(error.message)) {
+      return PREVIEW_AUTHORIZATION_ERROR_MESSAGE;
+    }
+    if (error.status >= 500 || error.message && isTransientRuntimeMessage(error.message)) {
+      return TRANSIENT_AGENT_ERROR_MESSAGE;
+    }
+    return error.message || "This assistant is unavailable right now.";
   }
   if (error instanceof DOMException && error.name === "AbortError") {
     return "";
   }
-  if (error instanceof Error) return error.message;
-  return "Runtime request failed";
+  if (error instanceof Error) {
+    if (isPreviewAuthorizationMessage(error.message)) {
+      return PREVIEW_AUTHORIZATION_ERROR_MESSAGE;
+    }
+    return isTransientRuntimeMessage(error.message) ? TRANSIENT_AGENT_ERROR_MESSAGE : error.message;
+  }
+  return TRANSIENT_AGENT_ERROR_MESSAGE;
 }
 
 // src/react/persisted-conversation.ts
@@ -916,6 +941,7 @@ function useAgentChat({
   customerId,
   getUnpublishedPreviewGrant,
   indexId,
+  previewBuildId,
   version,
   runtimeOrigin,
   visitorSessionId,
@@ -966,13 +992,14 @@ function useAgentChat({
       customerId,
       getUnpublishedPreviewGrant: resolveUnpublishedPreviewGrant,
       indexId,
+      previewBuildId,
       version,
       runtimeOrigin,
       visitorSessionId: visitorId,
       storageKeyPrefix: resolvedStorageKeyPrefix
     })
   );
-  const identityKey = `${customerId ?? ""}|${indexId}|${version ?? "published"}|${runtimeOrigin ?? ""}|${resolvedStorageKeyPrefix}|${visitorId}|${greeting ?? ""}`;
+  const identityKey = `${customerId ?? ""}|${indexId}|${version ?? "published"}|${runtimeOrigin ?? ""}|${previewBuildId ?? ""}|${resolvedStorageKeyPrefix}|${visitorId}|${greeting ?? ""}`;
   const identityRef = (0, import_react2.useRef)(identityKey);
   (0, import_react2.useEffect)(() => {
     if (identityRef.current === identityKey) {
@@ -985,6 +1012,7 @@ function useAgentChat({
       customerId,
       getUnpublishedPreviewGrant: resolveUnpublishedPreviewGrant,
       indexId,
+      previewBuildId,
       version,
       runtimeOrigin,
       visitorSessionId: visitorId,
@@ -1001,6 +1029,7 @@ function useAgentChat({
     identityKey,
     indexId,
     initialState,
+    previewBuildId,
     runtimeOrigin,
     resolvedStorageKeyPrefix,
     version,
@@ -1104,8 +1133,8 @@ function useAgentChat({
         if (!message) return;
         setState((prev) => ({
           ...prev,
-          phase: "complete",
-          toolSteps: prev.toolSteps.map(
+          phase: "error",
+          toolSteps: prev.toolSteps.length === 1 && prev.toolSteps[0]?.kind === "planning" ? [] : prev.toolSteps.map(
             (step) => step.state === "active" ? {
               ...step,
               detail: "Couldn\u2019t complete this step",
@@ -1264,11 +1293,12 @@ var defaultAgentRailTheme = {
 
 // src/react/components/AgentActivityBubble/AgentActivityBubble.tsx
 var import_jsx_runtime = require("react/jsx-runtime");
-function workSummary(steps) {
+function workSummary(steps, failed) {
   const active = [...steps].reverse().find((step) => step.state === "active");
   if (active?.kind === "specialist") return `Working with ${active.label}`;
   if (active?.kind === "search") return "Searching this site";
   if (active) return active.label;
+  if (failed) return "Couldn\u2019t complete this request";
   const hasError = steps.some((step) => step.state === "error");
   const specialists = steps.filter(
     (step) => step.kind === "specialist" && step.state === "completed"
@@ -1283,18 +1313,21 @@ function workSummary(steps) {
   if (searched) return "Searched this site";
   return "Prepared a response";
 }
-function AgentActivityBubble({ steps }) {
+function AgentActivityBubble({
+  failed = false,
+  steps
+}) {
   const active = steps.some((step) => step.state === "active");
   return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("article", { className: "agent-activity-bubble", children: [
     /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("p", { className: "agent-activity-bubble__status", "aria-live": "polite", children: [
       /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
         "span",
         {
-          className: `agent-activity-bubble__pulse${active ? " is-active" : ""}`,
+          className: `agent-activity-bubble__pulse${active ? " is-active" : failed ? " is-error" : ""}`,
           "aria-hidden": "true"
         }
       ),
-      workSummary(steps)
+      workSummary(steps, failed)
     ] }),
     /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("details", { className: "agent-activity-bubble__details", open: active, children: [
       /* @__PURE__ */ (0, import_jsx_runtime.jsx)("summary", { children: "Work details" }),
@@ -1602,7 +1635,13 @@ function AgentRail({
         /* @__PURE__ */ (0, import_jsx_runtime5.jsxs)("div", { ref: transcriptRef, className: "agent-rail__transcript", children: [
           state.messages.map((message) => /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(MessageBubble, { message }, message.id)),
           streamingMessage ? /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(MessageBubble, { message: streamingMessage }) : null,
-          showActivity ? /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(AgentActivityBubble, { steps: state.toolSteps }) : null,
+          showActivity ? /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(
+            AgentActivityBubble,
+            {
+              failed: state.phase === "error",
+              steps: state.toolSteps
+            }
+          ) : null,
           !expanded && showIdleFollowUps ? /* @__PURE__ */ (0, import_jsx_runtime5.jsx)("div", { className: "agent-rail__followups-slot", children: /* @__PURE__ */ (0, import_jsx_runtime5.jsx)(
             FollowUpChips,
             {
@@ -1814,6 +1853,7 @@ function AgentWidget({
   indexId,
   customerId,
   getUnpublishedPreviewGrant,
+  previewBuildId,
   version,
   runtimeOrigin,
   placement: placementInput,
@@ -1841,6 +1881,7 @@ function AgentWidget({
     customerId,
     getUnpublishedPreviewGrant,
     indexId,
+    previewBuildId,
     version,
     runtimeOrigin,
     greeting: branding?.greeting
@@ -1946,6 +1987,19 @@ function AgentWidget({
   ] });
 }
 
+// src/embed/preview-build.ts
+var PREVIEW_BUILD_ID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/iu;
+function readUnpublishedPreviewBuildId(href) {
+  const source = href ?? (typeof window === "undefined" ? void 0 : window.location.href);
+  if (!source) return void 0;
+  try {
+    const buildId = new URL(source).searchParams.get("v")?.trim();
+    return buildId && PREVIEW_BUILD_ID_PATTERN.test(buildId) ? buildId : void 0;
+  } catch {
+    return void 0;
+  }
+}
+
 // src/embed/AgentWidget.tsx
 var import_jsx_runtime8 = require("react/jsx-runtime");
 function AgentWidget2({
@@ -1958,6 +2012,7 @@ function AgentWidget2({
       customerId: manifest.customerId,
       version: manifest.version,
       runtimeOrigin: manifest.runtimeOrigin,
+      previewBuildId: manifest.version === "unpublished" ? readUnpublishedPreviewBuildId() : void 0,
       placement: manifest.placement,
       pageShift: manifest.pageShift,
       branding: manifest.branding,