@webless/agent 0.3.0 → 0.3.2

package/dist/react.cjs

@@ -162,11 +162,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."
         );
       }
     }
@@ -176,6 +177,7 @@ function createAgentRuntimeCapability(options) {
         body: JSON.stringify({
           clientSessionId: options.visitorSessionId,
           indexId: options.indexId,
+          ...previewBuildId ? { previewBuildId } : {},
           ...previewGrant ? { previewGrant } : {},
           version: options.version
         }),
@@ -495,7 +497,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;
@@ -504,6 +506,7 @@ var AgentSession = class {
     this.capability = createAgentRuntimeCapability({
       getUnpublishedPreviewGrant,
       indexId,
+      previewBuildId,
       runtimeOrigin,
       version,
       visitorSessionId
@@ -748,6 +751,7 @@ function createAgentClient(options) {
     runtimeOrigin,
     visitorSessionId,
     storeOptions,
+    options.previewBuildId,
     options.getUnpublishedPreviewGrant
   );
   return {
@@ -774,6 +778,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") {
@@ -785,13 +799,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
@@ -900,6 +925,7 @@ function useAgentChat({
   customerId,
   getUnpublishedPreviewGrant,
   indexId,
+  previewBuildId,
   version,
   runtimeOrigin,
   visitorSessionId,
@@ -950,13 +976,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) {
@@ -969,6 +996,7 @@ function useAgentChat({
       customerId,
       getUnpublishedPreviewGrant: resolveUnpublishedPreviewGrant,
       indexId,
+      previewBuildId,
       version,
       runtimeOrigin,
       visitorSessionId: visitorId,
@@ -985,6 +1013,7 @@ function useAgentChat({
     identityKey,
     indexId,
     initialState,
+    previewBuildId,
     runtimeOrigin,
     resolvedStorageKeyPrefix,
     version,
@@ -1088,8 +1117,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",
@@ -1257,11 +1286,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"
@@ -1276,18 +1306,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" }),
@@ -1595,7 +1628,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,
             {
@@ -1807,6 +1846,7 @@ function AgentWidget({
   indexId,
   customerId,
   getUnpublishedPreviewGrant,
+  previewBuildId,
   version,
   runtimeOrigin,
   placement: placementInput,
@@ -1834,6 +1874,7 @@ function AgentWidget({
     customerId,
     getUnpublishedPreviewGrant,
     indexId,
+    previewBuildId,
     version,
     runtimeOrigin,
     greeting: branding?.greeting