@webless/agent 0.11.0 → 0.12.0

package/dist/react.cjs

@@ -46,7 +46,7 @@ __export(react_exports, {
 module.exports = __toCommonJS(react_exports);
 
 // src/react/components/AgentWidget/AgentWidget.tsx
-var import_react17 = require("react");
+var import_react18 = require("react");
 
 // src/react/page-shift.ts
 var import_react = require("react");
@@ -128,8 +128,168 @@ function usePageShift(input) {
   }, [active, railSlotRef]);
 }
 
-// src/react/hooks/useAgentChat.ts
+// src/react/hooks/useAgentHandoff.ts
+var import_client = require("eve/client");
 var import_react2 = require("react");
+function useAgentHandoff(options) {
+  const [page, setPage] = (0, import_react2.useState)(null);
+  const [busy, setBusy] = (0, import_react2.useState)(false);
+  const [rejected, setRejected] = (0, import_react2.useState)(false);
+  const [error, setError] = (0, import_react2.useState)(null);
+  const callbacks = (0, import_react2.useRef)(options);
+  callbacks.current = options;
+  const pending = (0, import_react2.useRef)(null);
+  const inFlight = (0, import_react2.useRef)(null);
+  const pageRef = (0, import_react2.useRef)(null);
+  const refreshRef = (0, import_react2.useRef)(null);
+  const generation = (0, import_react2.useRef)(0);
+  (0, import_react2.useEffect)(() => {
+    const token = ++generation.current;
+    const controller = new AbortController();
+    let timer;
+    let reading = null;
+    let cursor = 0;
+    pageRef.current = null;
+    pending.current = null;
+    inFlight.current?.abort();
+    inFlight.current = null;
+    setRejected(false);
+    setPage(null);
+    setError(null);
+    setBusy(false);
+    if (!options.enabled || !options.sessionId) return;
+    const active = () => !controller.signal.aborted && generation.current === token;
+    const refresh = () => {
+      reading ??= (async () => {
+        do {
+          const next = await options.client.handoff.read({
+            after: cursor,
+            signal: AbortSignal.any([
+              controller.signal,
+              AbortSignal.timeout(15e3)
+            ])
+          });
+          if (!active()) return;
+          callbacks.current.onEvents(next.events);
+          if (next.status !== "ai") callbacks.current.onOwnership();
+          cursor = next.cursor;
+          pageRef.current = next;
+          setPage(next);
+          setRejected(false);
+          if (!pending.current) setError(null);
+          if (!next.hasMore) break;
+        } while (active());
+      })().finally(() => {
+        reading = null;
+      });
+      return reading;
+    };
+    refreshRef.current = refresh;
+    const poll = async () => {
+      try {
+        await refresh();
+      } catch (cause) {
+        if (active()) {
+          const denied = cause instanceof import_client.ClientError && cause.status === 403;
+          setRejected(denied);
+          setError(
+            denied ? "This preview has changed. Restart the preview chat to test the current version." : "Reconnecting to your conversation\u2026"
+          );
+        }
+      } finally {
+        if (active()) timer = setTimeout(() => void poll(), 1500);
+      }
+    };
+    void poll();
+    return () => {
+      controller.abort();
+      inFlight.current?.abort();
+      clearTimeout(timer);
+      refreshRef.current = null;
+    };
+  }, [options.client, options.enabled, options.sessionId]);
+  async function execute(operation) {
+    if (inFlight.current) return;
+    const controller = new AbortController();
+    inFlight.current = controller;
+    const signal = AbortSignal.any([
+      controller.signal,
+      AbortSignal.timeout(15e3)
+    ]);
+    const token = generation.current;
+    pending.current = operation;
+    setBusy(true);
+    setError(null);
+    try {
+      if (operation.type === "start")
+        await options.client.handoff.start(operation.operationId, signal);
+      else if (operation.type === "message") {
+        const { type: _, ...command } = operation;
+        await options.client.handoff.send(command, signal);
+      } else {
+        const { type: _, ...command } = operation;
+        await options.client.handoff.returnToAI(command, signal);
+      }
+      if (token !== generation.current) return;
+      pending.current = null;
+      await refreshRef.current?.();
+    } catch {
+      if (token === generation.current)
+        setError(
+          "Could not confirm delivery. Retry to check the same request."
+        );
+    } finally {
+      if (inFlight.current === controller) inFlight.current = null;
+      if (token === generation.current) setBusy(false);
+    }
+  }
+  const binding = () => {
+    const current = pageRef.current;
+    if (!current?.handoffId) throw new Error("No active human conversation.");
+    return { handoffId: current.handoffId, epoch: current.epoch };
+  };
+  return {
+    page,
+    busy,
+    error,
+    hasPending: Boolean(pending.current),
+    canReset: !busy && !pending.current && (rejected || page?.status === "ai" || page?.status === "failed" || !options.sessionId),
+    blocksAI: Boolean(options.enabled && options.sessionId && !page) || busy || Boolean(pending.current) || Boolean(page && page.status !== "ai"),
+    start: () => execute(
+      pending.current ?? { type: "start", operationId: crypto.randomUUID() }
+    ),
+    send: (message) => {
+      if (pending.current)
+        throw new Error(
+          "Retry the pending request before sending another message."
+        );
+      return execute({
+        type: "message",
+        operationId: crypto.randomUUID(),
+        ...binding(),
+        message
+      });
+    },
+    returnToAI: () => execute(
+      pending.current ?? {
+        type: "return",
+        operationId: crypto.randomUUID(),
+        ...binding()
+      }
+    ),
+    retry: async () => {
+      if (pending.current) return execute(pending.current);
+      try {
+        await refreshRef.current?.();
+      } catch {
+        setError("Reconnecting to your conversation\u2026");
+      }
+    }
+  };
+}
+
+// src/react/hooks/useAgentChat.ts
+var import_react3 = require("react");
 
 // src/runtime/tool-ui.ts
 var AGENT_TOOL_UI_SCHEMA_VERSION = "webless.tool-ui.v1";
@@ -271,16 +431,16 @@ function parseStep(value) {
   if (!hasOnlyKeys(value, ["description", "fieldPaths", "id", "label"])) {
     return null;
   }
-  const id = boundedString(value.id, 80);
+  const id2 = boundedString(value.id, 80);
   const label = boundedString(value.label, 160);
   const description = value.description === void 0 ? void 0 : boundedString(value.description, 500);
-  if (!id || !/^[A-Za-z0-9][A-Za-z0-9_-]*$/u.test(id) || !label || value.description !== void 0 && !description || !Array.isArray(value.fieldPaths) || value.fieldPaths.length < 1 || value.fieldPaths.length > 32 || value.fieldPaths.some(
+  if (!id2 || !/^[A-Za-z0-9][A-Za-z0-9_-]*$/u.test(id2) || !label || value.description !== void 0 && !description || !Array.isArray(value.fieldPaths) || value.fieldPaths.length < 1 || value.fieldPaths.length > 32 || value.fieldPaths.some(
     (path) => typeof path !== "string" || !/^[A-Za-z0-9_.[\]-]+$/u.test(path) || path.length > 160
   )) {
     return null;
   }
   return {
-    id,
+    id: id2,
     label,
     fieldPaths: value.fieldPaths,
     ...description ? { description } : {}
@@ -317,14 +477,14 @@ function parseAgentToolUiSurface(value) {
   ])) {
     return null;
   }
-  const id = boundedString(value.id, 200);
+  const id2 = boundedString(value.id, 200);
   const title = boundedString(value.title, 200);
   const toolSlug = boundedString(value.toolSlug, 200);
   const description = value.description === void 0 ? void 0 : boundedString(value.description, 800);
   const operationId = value.operationId === void 0 ? void 0 : boundedString(value.operationId, 200);
   const requestId = value.requestId === void 0 ? void 0 : boundedString(value.requestId, 200);
   const submitLabel = value.submitLabel === void 0 ? void 0 : boundedString(value.submitLabel, 80);
-  if (!id || !title || !toolSlug || !Array.isArray(value.fields) || value.fields.length < 1 || value.fields.length > 32) {
+  if (!id2 || !title || !toolSlug || !Array.isArray(value.fields) || value.fields.length < 1 || value.fields.length > 32) {
     return null;
   }
   const fields = value.fields.map(parseField);
@@ -344,7 +504,7 @@ function parseAgentToolUiSurface(value) {
   }
   return {
     schemaVersion: AGENT_TOOL_UI_SCHEMA_VERSION,
-    id,
+    id: id2,
     title,
     toolSlug,
     fields,
@@ -455,10 +615,205 @@ function completeConnectedToolWork(item, result) {
 }
 
 // src/runtime/client.ts
-var import_client2 = require("eve/client");
+var import_client4 = require("eve/client");
+
+// src/runtime/handoff.ts
+var import_client3 = require("eve/client");
+
+// src/runtime/generated/handoff-contract.ts
+var import_zod = require("zod");
+var id = import_zod.z.string().min(1).max(200);
+var sequence = import_zod.z.number().int().min(0).max(Number.MAX_SAFE_INTEGER);
+var text = import_zod.z.string().trim().min(1).max(16e3);
+var agentRuntimeHandoffVersion = "webless.ai/agent-runtime-handoff/v1";
+var agentRuntimeHandoffStatusSchema = import_zod.z.enum([
+  "ai",
+  "requesting",
+  "queued",
+  "human",
+  "resolved",
+  "failed"
+]);
+var agentRuntimeHandoffActorSchema = import_zod.z.strictObject({
+  id,
+  name: import_zod.z.string().trim().min(1).max(200)
+});
+var eventBase = {
+  id,
+  sequence: sequence.refine((value) => value > 0),
+  handoffId: id,
+  epoch: sequence.refine((value) => value > 0),
+  createdAt: import_zod.z.iso.datetime()
+};
+var agentRuntimeHandoffEventSchema = import_zod.z.discriminatedUnion("type", [
+  import_zod.z.strictObject({
+    ...eventBase,
+    type: import_zod.z.literal("status"),
+    status: agentRuntimeHandoffStatusSchema,
+    actor: agentRuntimeHandoffActorSchema.nullable()
+  }),
+  import_zod.z.strictObject({
+    ...eventBase,
+    type: import_zod.z.literal("visitor.message"),
+    message: text,
+    operationId: id
+  }),
+  import_zod.z.strictObject({
+    ...eventBase,
+    type: import_zod.z.literal("human.message"),
+    message: text,
+    actor: agentRuntimeHandoffActorSchema
+  })
+]);
+var agentRuntimeHandoffReadRequestSchema = import_zod.z.strictObject({
+  after: sequence.default(0)
+});
+var agentRuntimeHandoffPageSchema = import_zod.z.strictObject({
+  apiVersion: import_zod.z.literal(agentRuntimeHandoffVersion),
+  sessionId: id,
+  enabled: import_zod.z.boolean(),
+  status: agentRuntimeHandoffStatusSchema,
+  handoffId: id.nullable(),
+  epoch: sequence,
+  after: sequence,
+  cursor: sequence,
+  hasMore: import_zod.z.boolean(),
+  events: import_zod.z.array(agentRuntimeHandoffEventSchema).max(100)
+}).superRefine((page, ctx) => {
+  let cursor = page.after;
+  let previousEpoch = 0;
+  const statuses = /* @__PURE__ */ new Map();
+  const ids = /* @__PURE__ */ new Set();
+  const handoffs = /* @__PURE__ */ new Map();
+  const terminalEpochs = /* @__PURE__ */ new Set();
+  let currentStatus;
+  for (const event of page.events) {
+    if (event.epoch < previousEpoch)
+      ctx.addIssue({
+        code: "custom",
+        message: "Handoff epochs cannot decrease."
+      });
+    previousEpoch = event.epoch;
+    if (ids.has(event.id))
+      ctx.addIssue({
+        code: "custom",
+        message: "Duplicate handoff event ID."
+      });
+    ids.add(event.id);
+    const handoffId = handoffs.get(event.epoch);
+    if (handoffId !== void 0 && handoffId !== event.handoffId || event.epoch === page.epoch && event.handoffId !== page.handoffId)
+      ctx.addIssue({
+        code: "custom",
+        message: "Inconsistent handoff epoch identity."
+      });
+    handoffs.set(event.epoch, event.handoffId);
+    if (terminalEpochs.has(event.epoch) && (event.type !== "status" || event.status !== "ai"))
+      ctx.addIssue({
+        code: "custom",
+        message: "Handoff event follows resolution."
+      });
+    if (event.type === "status") {
+      if (event.status === "human" && event.actor === null)
+        ctx.addIssue({
+          code: "custom",
+          message: "Human ownership requires a representative."
+        });
+      const previous = statuses.get(event.epoch);
+      const transitions = {
+        ai: [],
+        requesting: ["queued", "resolved", "failed"],
+        queued: ["human", "resolved", "failed"],
+        human: ["resolved", "failed"],
+        resolved: ["ai"],
+        failed: []
+      };
+      if (previous !== void 0 && !transitions[previous].includes(event.status))
+        ctx.addIssue({
+          code: "custom",
+          message: "Invalid handoff ownership transition."
+        });
+      statuses.set(event.epoch, event.status);
+      if (["resolved", "failed", "ai"].includes(event.status))
+        terminalEpochs.add(event.epoch);
+      if (event.epoch === page.epoch) currentStatus = event.status;
+    }
+    if (event.sequence !== cursor + 1) {
+      ctx.addIssue({
+        code: "custom",
+        message: "Handoff event gap or replay."
+      });
+    }
+    cursor = event.sequence;
+    if (event.epoch > page.epoch) {
+      ctx.addIssue({
+        code: "custom",
+        message: "Event exceeds current epoch."
+      });
+    }
+  }
+  if (!page.hasMore && currentStatus !== void 0 && currentStatus !== page.status)
+    ctx.addIssue({
+      code: "custom",
+      message: "Handoff ownership contradicts its final status event."
+    });
+  if (page.cursor !== cursor || page.hasMore && page.events.length === 0) {
+    ctx.addIssue({ code: "custom", message: "Invalid handoff page cursor." });
+  }
+  if (page.epoch === 0 !== (page.handoffId === null)) {
+    ctx.addIssue({ code: "custom", message: "Invalid handoff identity." });
+  }
+  if (page.handoffId === null && page.status !== "ai") {
+    ctx.addIssue({
+      code: "custom",
+      message: "Handoff identity is required."
+    });
+  }
+});
+var agentRuntimeHandoffStartSchema = import_zod.z.strictObject({
+  operationId: id
+});
+var agentRuntimeHandoffCommandSchema = import_zod.z.strictObject({
+  operationId: id,
+  handoffId: id,
+  epoch: sequence.refine((value) => value > 0)
+});
+var agentRuntimeHandoffMessageSchema = agentRuntimeHandoffCommandSchema.extend({ message: text });
+var agentRuntimeHandoffBindingSchema = import_zod.z.strictObject({
+  tenantId: id,
+  indexId: id,
+  visitorSubject: id,
+  sessionId: id,
+  handoffId: id,
+  epoch: sequence.refine((value) => value > 0)
+});
+var providerEventBase = {
+  apiVersion: import_zod.z.literal(agentRuntimeHandoffVersion),
+  binding: agentRuntimeHandoffBindingSchema,
+  eventId: id,
+  sequence: sequence.refine((value) => value > 0)
+};
+var agentRuntimeHandoffProviderEventSchema = import_zod.z.discriminatedUnion(
+  "type",
+  [
+    import_zod.z.strictObject({ ...providerEventBase, type: import_zod.z.literal("queued") }),
+    import_zod.z.strictObject({
+      ...providerEventBase,
+      type: import_zod.z.literal("assigned"),
+      actor: agentRuntimeHandoffActorSchema
+    }),
+    import_zod.z.strictObject({
+      ...providerEventBase,
+      type: import_zod.z.literal("human.message"),
+      actor: agentRuntimeHandoffActorSchema,
+      message: text
+    }),
+    import_zod.z.strictObject({ ...providerEventBase, type: import_zod.z.literal("resolved") }),
+    import_zod.z.strictObject({ ...providerEventBase, type: import_zod.z.literal("failed") })
+  ]
+);
 
 // src/runtime/capability.ts
-var import_client = require("eve/client");
+var import_client2 = require("eve/client");
 var MAX_REFRESH_SKEW_MS = 3e4;
 var LOCAL_LOOPBACK_ORIGINS = [
   "http://127.0.0.1:3010",
@@ -603,7 +958,7 @@ async function withCapabilityRefresh(capability, request) {
   try {
     return await request();
   } catch (error) {
-    if (!(error instanceof import_client.ClientError) || error.status !== 401) {
+    if (!(error instanceof import_client2.ClientError) || error.status !== 401) {
       throw error;
     }
     capability.invalidate();
@@ -611,6 +966,75 @@ async function withCapabilityRefresh(capability, request) {
   }
 }
 
+// src/runtime/handoff.ts
+function createHandoffClient(options) {
+  const target = () => {
+    const sessionId = options.getSessionId();
+    if (!sessionId)
+      throw new Error(
+        "Start a conversation before requesting a representative."
+      );
+    return {
+      sessionId,
+      path: `/webless/v1/session/${encodeURIComponent(sessionId)}/handoff`
+    };
+  };
+  const request = (path, init) => withCapabilityRefresh(options.capability, async () => {
+    const response = await options.getClient().fetch(path, {
+      ...init,
+      cache: "no-store",
+      redirect: "error"
+    });
+    if (!response.ok) {
+      throw new import_client3.ClientError(
+        response.status,
+        await response.text(),
+        response.headers
+      );
+    }
+    return response;
+  });
+  const command = async (suffix, body, signal) => {
+    const { path } = target();
+    await request(path + suffix, {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify(body),
+      signal
+    });
+  };
+  return {
+    async read(input = {}) {
+      const { after } = agentRuntimeHandoffReadRequestSchema.parse({
+        after: input.after
+      });
+      const { sessionId, path } = target();
+      const response = await request(`${path}?after=${after}`, {
+        signal: input.signal
+      });
+      const value = await response.json();
+      const page = agentRuntimeHandoffPageSchema.parse(value);
+      if (page.sessionId !== sessionId || page.after !== after) {
+        throw new Error(
+          "The handoff response does not belong to this conversation or cursor."
+        );
+      }
+      return page;
+    },
+    start: (operationId, signal) => command(
+      "",
+      agentRuntimeHandoffStartSchema.parse({ operationId }),
+      signal
+    ),
+    send: (input, signal) => command(
+      "/messages",
+      agentRuntimeHandoffMessageSchema.parse(input),
+      signal
+    ),
+    returnToAI: (input, signal) => command("/return", agentRuntimeHandoffCommandSchema.parse(input), signal)
+  };
+}
+
 // src/runtime/config.ts
 var DEFAULT_RUNTIME_ORIGIN = "https://runtime.staging.webless.ai";
 var trimTrailingSlash = (value) => value.replace(/\/+$/, "");
@@ -1201,6 +1625,11 @@ var AgentSession = class {
       version,
       visitorSessionId
     });
+    this.handoff = createHandoffClient({
+      getClient: () => this.ensureClient(),
+      getSessionId: () => this.getActiveSessionId(),
+      capability: this.capability
+    });
   }
   indexId;
   version;
@@ -1213,6 +1642,7 @@ var AgentSession = class {
   activeResponse;
   childStreams;
   capability;
+  handoff;
   getActiveSessionId() {
     return this.session?.state.sessionId ?? loadPersistedAgentSession(this.visitorSessionId, this.storeOptions)?.sessionId;
   }
@@ -1287,7 +1717,7 @@ var AgentSession = class {
     }
     this.activeResponse = void 0;
     this.session = void 0;
-    this.client = new import_client2.Client({
+    this.client = new import_client4.Client({
       auth: { bearer: () => this.capability.getAccessToken() },
       host: config.host,
       redirect: "error"
@@ -1323,7 +1753,7 @@ var AgentSession = class {
           () => activeSession.send(message, { signal })
         );
       } catch (error) {
-        if (error instanceof import_client2.ClientError && error.status === 409 && error.code === "session_not_active") {
+        if (error instanceof import_client4.ClientError && error.status === 409 && error.code === "session_not_active") {
           clearPersistedAgentSession(this.visitorSessionId, this.storeOptions);
           this.session = void 0;
           session = void 0;
@@ -1497,10 +1927,10 @@ var AgentSession = class {
     }
     this.session = session;
     const inputResponses = responses.map(
-      ({ requestId, optionId, text: text2 }) => ({
+      ({ requestId, optionId, text: text3 }) => ({
         requestId,
         ...optionId ? { optionId } : {},
-        ...text2 ? { text: text2 } : {}
+        ...text3 ? { text: text3 } : {}
       })
     );
     const response = await withCapabilityRefresh(
@@ -1590,6 +2020,7 @@ function createAgentClient(options) {
   );
   return {
     indexId,
+    handoff: session.handoff,
     version,
     runtimeOrigin,
     visitorSessionId,
@@ -1621,7 +2052,7 @@ function createAgentClient(options) {
 }
 
 // src/runtime/errors.ts
-var import_client3 = require("eve/client");
+var import_client5 = require("eve/client");
 var TRANSIENT_AGENT_ERROR_MESSAGE = "The agent run stopped before the action finished. Please try again.";
 var PREVIEW_AUTHORIZATION_ERROR_MESSAGE = "This preview could not be authorized. Open the latest preview from Webless.";
 function isTransientRuntimeMessage(message) {
@@ -1633,7 +2064,7 @@ function isPreviewAuthorizationMessage(message) {
   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 instanceof import_client5.ClientError) {
     if (error.status === 401 && error.code === "index_required") {
       return "Missing indexId \u2014 pass a published index id to createAgentClient().";
     }
@@ -1667,14 +2098,14 @@ function formatAgentError(error) {
 var COMPOSER_FORM_SKIP_DISMISSAL = "I'd like to keep chatting without sharing the requested details for now. Please don't ask for them again unless I choose to proceed with something that needs them.";
 function visitorMessageDisplayText(message) {
   if (message.role !== "visitor") return message.text;
-  const text2 = message.text.trim();
-  if (!text2) return message.text;
-  if (text2.startsWith(COMPOSER_FORM_SKIP_DISMISSAL)) {
-    const afterDismissal = text2.slice(COMPOSER_FORM_SKIP_DISMISSAL.length).trim().replace(/^\n+/, "").trim();
+  const text3 = message.text.trim();
+  if (!text3) return message.text;
+  if (text3.startsWith(COMPOSER_FORM_SKIP_DISMISSAL)) {
+    const afterDismissal = text3.slice(COMPOSER_FORM_SKIP_DISMISSAL.length).trim().replace(/^\n+/, "").trim();
     if (afterDismissal) return afterDismissal;
   }
   const runtime = message.runtimeText?.trim();
-  if (runtime && text2 === runtime && runtime.includes(COMPOSER_FORM_SKIP_DISMISSAL)) {
+  if (runtime && text3 === runtime && runtime.includes(COMPOSER_FORM_SKIP_DISMISSAL)) {
     const afterDismissal = runtime.slice(
       runtime.indexOf(COMPOSER_FORM_SKIP_DISMISSAL) + COMPOSER_FORM_SKIP_DISMISSAL.length
     ).trim().replace(/^\n+/, "").trim();
@@ -1748,13 +2179,13 @@ function parseVisitorFormFields(value) {
   const seen = /* @__PURE__ */ new Set();
   for (const item of value) {
     const record2 = asRecord(item);
-    const id = asString(record2?.id).toLowerCase().replace(/[^a-z0-9_-]/g, "");
+    const id2 = asString(record2?.id).toLowerCase().replace(/[^a-z0-9_-]/g, "");
     const kind = asString(record2?.kind);
-    if (!record2 || !id || seen.has(id) || !isFieldKind2(kind)) continue;
-    seen.add(id);
-    const label = asString(record2.label) || id;
+    if (!record2 || !id2 || seen.has(id2) || !isFieldKind2(kind)) continue;
+    seen.add(id2);
+    const label = asString(record2.label) || id2;
     fields.push({
-      id,
+      id: id2,
       kind,
       label,
       placeholder: asString(record2.placeholder) || label,
@@ -1790,52 +2221,52 @@ function formatComposerFormMessage(form, values) {
     return value ? `${field.label}: ${value}` : "";
   }).filter(Boolean).join("\n");
 }
-function looksLikeFieldCollection(text2) {
+function looksLikeFieldCollection(text3) {
   return /\b(please|need|send|share|enter|provide|add|collect|what|which|use)\b/i.test(
-    text2
-  ) || /:\s*$/m.test(text2) || /^[-*•]\s+/m.test(text2);
+    text3
+  ) || /:\s*$/m.test(text3) || /^[-*•]\s+/m.test(text3);
 }
-function looksLikeBookingCopy(text2) {
+function looksLikeBookingCopy(text3) {
   return /book(ing)? (card|a demo|this time)|pick a (date|time)|available (times|slots)|calendly/i.test(
-    text2
+    text3
   );
 }
-function echoedLabeledFieldIds(text2) {
+function echoedLabeledFieldIds(text3) {
   const ids = /* @__PURE__ */ new Set();
-  if (/\bname\s*:\s+\S+/i.test(text2)) ids.add("name");
-  if (/\be-?mail\s*:\s+\S+/i.test(text2)) ids.add("email");
-  if (/\bphone\s*:\s+\S+/i.test(text2)) ids.add("phone");
-  if (/\bcompany\s*:\s+\S+/i.test(text2)) ids.add("company");
+  if (/\bname\s*:\s+\S+/i.test(text3)) ids.add("name");
+  if (/\be-?mail\s*:\s+\S+/i.test(text3)) ids.add("email");
+  if (/\bphone\s*:\s+\S+/i.test(text3)) ids.add("phone");
+  if (/\bcompany\s*:\s+\S+/i.test(text3)) ids.add("company");
   return ids;
 }
-function matchLibraryFields(text2) {
+function matchLibraryFields(text3) {
   return FIELD_LIBRARY.flatMap((field) => {
-    if (field.exclude?.test(text2)) {
-      const leftover = text2.replace(field.exclude, " ");
+    if (field.exclude?.test(text3)) {
+      const leftover = text3.replace(field.exclude, " ");
       if (!field.patterns.some((pattern) => pattern.test(leftover))) return [];
-    } else if (!field.patterns.some((pattern) => pattern.test(text2))) {
+    } else if (!field.patterns.some((pattern) => pattern.test(text3))) {
       return [];
     }
     const { patterns: _patterns, exclude: _exclude, ...next } = field;
     return [next];
   }).slice(0, MAX_FORM_FIELDS);
 }
-function looksLikeCompletedActionRecap(text2) {
-  const confirmingCreate = /\bshould i create this\b/i.test(text2);
-  const echoingFilledFields = /\b(?:name|email|phone|company)\s*:\s+\S+/i.test(text2) && /[^\s@]+@[^\s@]+\.[^\s@]+/i.test(text2);
+function looksLikeCompletedActionRecap(text3) {
+  const confirmingCreate = /\bshould i create this\b/i.test(text3);
+  const echoingFilledFields = /\b(?:name|email|phone|company)\s*:\s+\S+/i.test(text3) && /[^\s@]+@[^\s@]+\.[^\s@]+/i.test(text3);
   if (echoingFilledFields) {
-    if (looksLikeFieldCollection(text2)) {
-      const echoed = echoedLabeledFieldIds(text2);
-      if (matchLibraryFields(text2).some((field) => !echoed.has(field.id))) {
+    if (looksLikeFieldCollection(text3)) {
+      const echoed = echoedLabeledFieldIds(text3);
+      if (matchLibraryFields(text3).some((field) => !echoed.has(field.id))) {
         return false;
       }
     }
     return true;
   }
-  return confirmingCreate && !looksLikeFieldCollection(text2);
+  return confirmingCreate && !looksLikeFieldCollection(text3);
 }
-function inferComposerForm(text2) {
-  const cleaned = text2.trim();
+function inferComposerForm(text3) {
+  const cleaned = text3.trim();
   if (!cleaned || looksLikeBookingCopy(cleaned) || looksLikeCompletedActionRecap(cleaned) || !looksLikeFieldCollection(cleaned)) {
     return null;
   }
@@ -1850,8 +2281,8 @@ function resolveComposerForm(input) {
   if (input.enabled === false || input.hasBookingOffer || input.hasPendingConfirmation) {
     return null;
   }
-  const text2 = input.agentText.trim();
-  if (!text2) return null;
+  const text3 = input.agentText.trim();
+  if (!text3) return null;
   const card = input.cards?.find((item) => item.type === "visitor_form");
   if (card?.fields && card.fields.length >= MIN_FORM_FIELDS) {
     return {
@@ -1859,7 +2290,7 @@ function resolveComposerForm(input) {
       fields: card.fields.slice(0, MAX_FORM_FIELDS)
     };
   }
-  return inferComposerForm(text2);
+  return inferComposerForm(text3);
 }
 
 // src/react/lib/tool-card.ts
@@ -1873,9 +2304,9 @@ function preferBookingOffer(current, next) {
   }
   return next;
 }
-function looksLikeBookingReady(text2) {
+function looksLikeBookingReady(text3) {
   return /demo option|options are ready|pick a (date|time)|available (times|slots)|book(ing)? (card|the demo)|\bschedule\b/i.test(
-    text2
+    text3
   );
 }
 function bookingOfferIdentityKey(offer) {
@@ -1985,29 +2416,29 @@ function bookingCardFromActionOutput(output) {
   const data = asRecord2(record2?.output) ?? asRecord2(record2?.data) ?? record2;
   return parseToolCard(data);
 }
-function ensureBookingOfferText(text2, offer) {
-  if (!offer) return text2;
-  if (extractToolCards(text2).some((card) => card.type === "booking_offer")) {
-    return text2;
+function ensureBookingOfferText(text3, offer) {
+  if (!offer) return text3;
+  if (extractToolCards(text3).some((card) => card.type === "booking_offer")) {
+    return text3;
   }
-  const visible = stripToolCards(text2).trim() || text2.trim();
+  const visible = stripToolCards(text3).trim() || text3.trim();
   return `${visible}
 
 ${formatBookingOfferFence(offer)}`;
 }
-function hideToolCardFences(text2) {
-  return text2.replace(/```(?:webless-tool-card|json)\s*[\s\S]*?```/gi, "").replace(/```(?:webless-tool-card|json)[\s\S]*$/i, "").replace(/\n{3,}/g, "\n\n").trim();
+function hideToolCardFences(text3) {
+  return text3.replace(/```(?:webless-tool-card|json)\s*[\s\S]*?```/gi, "").replace(/```(?:webless-tool-card|json)[\s\S]*$/i, "").replace(/\n{3,}/g, "\n\n").trim();
 }
 var BOOKING_CARD_FALLBACK = "Pick a date and time that works for you.";
-function looksLikeBookingAvailabilityDump(text2) {
-  const cleaned = text2.trim();
+function looksLikeBookingAvailabilityDump(text3) {
+  const cleaned = text3.trim();
   if (!cleaned) return false;
   const isoCount = (cleaned.match(/\d{4}-\d{2}-\d{2}[ T]\d{2}:\d{2}/g) ?? []).length;
   const utcCount = (cleaned.match(/\bUTC\b/g) ?? []).length;
   return isoCount >= 2 || utcCount >= 2 || /api\.calendly\.com|calendly\.com\//i.test(cleaned) || /webless-tool-card/i.test(cleaned);
 }
-function sanitizeBookingOfferCopy(text2) {
-  const cleaned = hideToolCardFences(text2);
+function sanitizeBookingOfferCopy(text3) {
+  const cleaned = hideToolCardFences(text3);
   if (!cleaned || looksLikeBookingAvailabilityDump(cleaned)) {
     return BOOKING_CARD_FALLBACK;
   }
@@ -2020,9 +2451,9 @@ function visitorTimeZone() {
     return "UTC";
   }
 }
-function extractToolCards(text2) {
+function extractToolCards(text3) {
   const cards = [];
-  for (const match of text2.matchAll(FENCE_PATTERN)) {
+  for (const match of text3.matchAll(FENCE_PATTERN)) {
     try {
       const card = parseToolCard(JSON.parse(match[1] ?? ""));
       if (card) cards.push(card);
@@ -2031,8 +2462,8 @@ function extractToolCards(text2) {
   }
   return cards;
 }
-function stripToolCards(text2) {
-  return text2.replace(FENCE_PATTERN, "").replace(/\n{3,}/g, "\n\n").trim();
+function stripToolCards(text3) {
+  return text3.replace(FENCE_PATTERN, "").replace(/\n{3,}/g, "\n\n").trim();
 }
 function localDateKey(date) {
   if (Number.isNaN(date.getTime())) return "";
@@ -2145,7 +2576,7 @@ function visitorBookingPrefix(booking) {
 function record(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value) ? value : null;
 }
-function text(value, max = 500) {
+function text2(value, max = 500) {
   return typeof value === "string" && value.trim().length > 0 && value.trim().length <= max;
 }
 function safeSearchUrl(value) {
@@ -2166,7 +2597,7 @@ function parseAgentSearchReferences(value) {
     const source = record(value2);
     if (!source || Object.keys(source).some(
       (key) => !["id", "title", "url"].includes(key)
-    ) || !text(source.id, Infinity) || !text(source.title) || source.url !== void 0 && typeof source.url !== "string")
+    ) || !text2(source.id, Infinity) || !text2(source.title) || source.url !== void 0 && typeof source.url !== "string")
       return null;
     const url = safeSearchUrl(source.url);
     sources.push({
@@ -2178,7 +2609,7 @@ function parseAgentSearchReferences(value) {
   let cta;
   if (data.cta !== void 0) {
     const action = record(data.cta);
-    if (!action || Object.keys(action).some((key) => !["label", "url"].includes(key)) || !text(action.label) || action.url !== void 0 && typeof action.url !== "string")
+    if (!action || Object.keys(action).some((key) => !["label", "url"].includes(key)) || !text2(action.label) || action.url !== void 0 && typeof action.url !== "string")
       return null;
     const url = safeSearchUrl(action.url);
     cta = { label: action.label.trim(), ...url ? { url } : {} };
@@ -2197,7 +2628,7 @@ function parseAgentSearchDiscoveryOutput(value) {
   const data = record(decoded);
   if (!data || Object.keys(data).some(
     (key) => !["answer", "sources", "cta", "suggestions"].includes(key)
-  ) || !text(data.answer, 5e4) || !Array.isArray(data.suggestions) || data.suggestions.length > 8 || !data.suggestions.every((item) => text(item)))
+  ) || !text2(data.answer, 5e4) || !Array.isArray(data.suggestions) || data.suggestions.length > 8 || !data.suggestions.every((item) => text2(item)))
     return null;
   const references = parseAgentSearchReferences(data);
   return references ? {
@@ -2215,9 +2646,21 @@ function conversationKey(storageKeyPrefix, visitorSessionId) {
 function parseMessage(value) {
   if (typeof value !== "object" || value === null) return null;
   const record2 = value;
-  if (typeof record2.id !== "string" || record2.role !== "agent" && record2.role !== "visitor" || typeof record2.text !== "string" || typeof record2.createdAt !== "number" || !Number.isFinite(record2.createdAt)) {
+  if (typeof record2.id !== "string" || record2.role !== "agent" && record2.role !== "visitor" && record2.role !== "human" || typeof record2.text !== "string" || typeof record2.createdAt !== "number" || !Number.isFinite(record2.createdAt)) {
     return null;
   }
+  if (record2.role === "human") {
+    const person = record2.representative;
+    if (typeof person !== "object" || person === null || !("id" in person) || !("name" in person) || typeof person.id !== "string" || typeof person.name !== "string")
+      return null;
+    return {
+      id: record2.id,
+      role: "human",
+      text: record2.text,
+      createdAt: record2.createdAt,
+      representative: { id: person.id, name: person.name }
+    };
+  }
   if (record2.role === "visitor") {
     return {
       id: record2.id,
@@ -2512,10 +2955,10 @@ function safeText(value) {
   return value.trim().slice(0, MAX_TEXT_LENGTH);
 }
 function safeHref(value) {
-  const text2 = safeText(value);
-  if (!text2) return "";
+  const text3 = safeText(value);
+  if (!text3) return "";
   try {
-    const url = new URL(text2);
+    const url = new URL(text3);
     return url.protocol === "https:" ? url.toString() : "";
   } catch {
     return "";
@@ -2878,15 +3321,15 @@ function appendChatCollectiblePrompts(messages, requests) {
   }
   return next;
 }
-function chatInputResponseForText(requests, text2) {
-  const trimmed = text2.trim();
+function chatInputResponseForText(requests, text3) {
+  const trimmed = text3.trim();
   if (!trimmed) return null;
   const pending = requests.find(isChatCollectibleInputRequest);
   if (!pending) return null;
   return { requestId: pending.requestId, text: trimmed };
 }
-function normalizeAssistantDedupeKey(text2) {
-  return text2.trim().replace(/\s+/g, " ").toLowerCase();
+function normalizeAssistantDedupeKey(text3) {
+  return text3.trim().replace(/\s+/g, " ").toLowerCase();
 }
 function isNearDuplicateAssistantText(left, right) {
   const a = normalizeAssistantDedupeKey(left);
@@ -2999,6 +3442,7 @@ function isJsonRecord(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value);
 }
 function useAgentChat({
+  handoffEnabled = false,
   customerId,
   getUnpublishedPreviewGrant,
   indexId,
@@ -3010,13 +3454,13 @@ function useAgentChat({
   greeting,
   toolResultRegistry
 }) {
-  const initialState = (0, import_react2.useMemo)(
+  const initialState = (0, import_react3.useMemo)(
     () => createInitialState(greeting?.trim() || DEFAULT_GREETING),
     [greeting]
   );
-  const previewGrantProviderRef = (0, import_react2.useRef)(getUnpublishedPreviewGrant);
+  const previewGrantProviderRef = (0, import_react3.useRef)(getUnpublishedPreviewGrant);
   previewGrantProviderRef.current = getUnpublishedPreviewGrant;
-  const toolResultRegistryRef = (0, import_react2.useRef)(toolResultRegistry);
+  const toolResultRegistryRef = (0, import_react3.useRef)(toolResultRegistry);
   toolResultRegistryRef.current = toolResultRegistry;
   const resolveUnpublishedPreviewGrant = () => {
     const provider = previewGrantProviderRef.current;
@@ -3029,7 +3473,7 @@ function useAgentChat({
     }
     return provider();
   };
-  const resolvedStorageKeyPrefix = (0, import_react2.useMemo)(
+  const resolvedStorageKeyPrefix = (0, import_react3.useMemo)(
     () => storageKeyPrefix?.trim() || buildAgentStorageKeyPrefix({
       customerId,
       indexId,
@@ -3038,23 +3482,23 @@ function useAgentChat({
     }),
     [customerId, indexId, runtimeOrigin, storageKeyPrefix, version]
   );
-  const visitorId = (0, import_react2.useMemo)(
+  const visitorId = (0, import_react3.useMemo)(
     () => visitorSessionId?.trim() || getOrCreateVisitorSessionId({
       storageKeyPrefix: resolvedStorageKeyPrefix
     }),
     [resolvedStorageKeyPrefix, visitorSessionId]
   );
-  const [state, setState] = (0, import_react2.useState)(
+  const [state, setState] = (0, import_react3.useState)(
     () => stateFromConversation(
       loadPersistedAgentConversation(resolvedStorageKeyPrefix, visitorId),
       initialState
     )
   );
-  const pendingBookingRef = (0, import_react2.useRef)(
+  const pendingBookingRef = (0, import_react3.useRef)(
     loadPendingWidgetBooking(resolvedStorageKeyPrefix, visitorId)
   );
-  const runRef = (0, import_react2.useRef)(null);
-  const clientRef = (0, import_react2.useRef)(
+  const runRef = (0, import_react3.useRef)(null);
+  const clientRef = (0, import_react3.useRef)(
     createAgentClient({
       locationConsent: true,
       customerId,
@@ -3068,8 +3512,8 @@ function useAgentChat({
     })
   );
   const identityKey = `${customerId ?? ""}|${indexId}|${version ?? "published"}|${runtimeOrigin ?? ""}|${previewBuildId ?? ""}|${resolvedStorageKeyPrefix}|${visitorId}|${greeting ?? ""}`;
-  const identityRef = (0, import_react2.useRef)(identityKey);
-  (0, import_react2.useEffect)(() => {
+  const identityRef = (0, import_react3.useRef)(identityKey);
+  (0, import_react3.useEffect)(() => {
     if (identityRef.current === identityKey) {
       return;
     }
@@ -3108,7 +3552,7 @@ function useAgentChat({
     version,
     visitorId
   ]);
-  (0, import_react2.useEffect)(() => {
+  (0, import_react3.useEffect)(() => {
     if (!hasVisitorMessages(state.messages)) return;
     savePersistedAgentConversation(resolvedStorageKeyPrefix, visitorId, {
       messages: state.messages,
@@ -3128,16 +3572,77 @@ function useAgentChat({
     state.toolResults,
     visitorId
   ]);
-  const reset = (0, import_react2.useCallback)(() => {
+  const handoff = useAgentHandoff({
+    enabled: handoffEnabled,
+    client: clientRef.current,
+    sessionId: clientRef.current.getActiveSessionId(),
+    onOwnership: () => {
+      runRef.current?.abort();
+      runRef.current = null;
+      setState(
+        (prev) => prev.phase === "complete" && !prev.streamingText && !prev.pendingInputs?.length && !prev.toolSteps.length ? prev : {
+          ...prev,
+          phase: "complete",
+          streamingText: "",
+          pendingInputs: [],
+          toolSteps: [],
+          toolResults: [],
+          pendingOffer: null,
+          error: null
+        }
+      );
+    },
+    onEvents: (events) => {
+      setState((prev) => {
+        const seen = new Set(prev.messages.map((message) => message.id));
+        const messages = [];
+        for (const event of events) {
+          if (event.type === "status" || seen.has(`handoff-${event.id}`))
+            continue;
+          messages.push(
+            event.type === "human.message" ? {
+              id: `handoff-${event.id}`,
+              role: "human",
+              text: event.message,
+              createdAt: Date.parse(event.createdAt),
+              representative: event.actor
+            } : {
+              id: `handoff-${event.id}`,
+              role: "visitor",
+              text: event.message,
+              createdAt: Date.parse(event.createdAt)
+            }
+          );
+        }
+        return messages.length ? {
+          ...prev,
+          messages: [...prev.messages, ...messages].sort(
+            (a, b) => a.createdAt - b.createdAt
+          )
+        } : prev;
+      });
+    }
+  });
+  const handoffBlocksAI = (0, import_react3.useRef)(handoff.blocksAI);
+  handoffBlocksAI.current = handoff.blocksAI;
+  const reset = (0, import_react3.useCallback)(() => {
+    if (handoff.blocksAI && !handoff.canReset) return;
     runRef.current?.abort();
     runRef.current = null;
     clientRef.current.reset();
     pendingBookingRef.current = null;
     clearPersistedAgentConversation(resolvedStorageKeyPrefix, visitorId);
     setState(initialState);
-  }, [initialState, resolvedStorageKeyPrefix, visitorId]);
-  const runTurn = (0, import_react2.useCallback)(
+  }, [
+    handoff.blocksAI,
+    handoff.canReset,
+    initialState,
+    resolvedStorageKeyPrefix,
+    visitorId
+  ]);
+  const runTurn = (0, import_react3.useCallback)(
     async (input) => {
+      if (handoffBlocksAI.current) return null;
       const {
         controller,
         initialText = "",
@@ -3261,6 +3766,7 @@ function useAgentChat({
           signal
         });
         if (resume && finalText === null) {
+          if (!isActiveRun() || handoffBlocksAI.current) return null;
           finalText = await clientRef.current.sendTurn(visitorText, {
             handlers,
             signal
@@ -3293,8 +3799,12 @@ function useAgentChat({
           messages: appendAgentTurnMessage(
             prev.messages,
             displayText,
-            (prev.toolResults ?? []).filter((result) => result.kind === "search"),
-            (prev.toolResults ?? []).filter((result) => result.kind !== "search" && result.kind !== "input")
+            (prev.toolResults ?? []).filter(
+              (result) => result.kind === "search"
+            ),
+            (prev.toolResults ?? []).filter(
+              (result) => result.kind !== "search" && result.kind !== "input"
+            )
           ),
           toolResults: (prev.toolResults ?? []).filter(
             (result) => result.kind === "input"
@@ -3335,7 +3845,7 @@ function useAgentChat({
     },
     [resolvedStorageKeyPrefix, visitorId]
   );
-  const rememberBooking = (0, import_react2.useCallback)(
+  const rememberBooking = (0, import_react3.useCallback)(
     (booking) => {
       const current = pendingBookingRef.current;
       if (current?.eventUri === booking.eventUri && current.inviteeEmail === booking.inviteeEmail && current.inviteeUri === booking.inviteeUri) {
@@ -3346,7 +3856,7 @@ function useAgentChat({
     },
     [resolvedStorageKeyPrefix, visitorId]
   );
-  const forgetBooking = (0, import_react2.useCallback)(
+  const forgetBooking = (0, import_react3.useCallback)(
     (eventUri) => {
       const current = pendingBookingRef.current;
       if (!current) return;
@@ -3356,12 +3866,21 @@ function useAgentChat({
     },
     [resolvedStorageKeyPrefix, visitorId]
   );
-  const submit = (0, import_react2.useCallback)(
+  const submit = (0, import_react3.useCallback)(
     async (visitorText, options) => {
       const trimmed = visitorText.trim();
       const outgoing = options?.runtimeText ?? visitorText;
       if (!outgoing.trim()) return null;
       const declinedComposerFormId = options?.declinedComposerFormId?.trim();
+      if (handoff.blocksAI) {
+        if (!["requesting", "queued", "human"].includes(
+          handoff.page?.status ?? ""
+        ) || handoff.busy)
+          return null;
+        if (!trimmed) return null;
+        await handoff.send(trimmed);
+        return null;
+      }
       const chatResponse = chatInputResponseForText(
         state.pendingInputs ?? [],
         outgoing.trim()
@@ -3463,9 +3982,10 @@ ${outgoing}` : outgoing;
         visitorText: runtimeText
       });
     },
-    [runTurn, state.pendingInputs]
+    [handoff, runTurn, state.pendingInputs]
   );
-  const retry = (0, import_react2.useCallback)(async () => {
+  const retry = (0, import_react3.useCallback)(async () => {
+    if (handoffBlocksAI.current) return;
     const visitorMessage = [...state.messages].reverse().find((message) => message.role === "visitor");
     if (!visitorMessage) return;
     if (runRef.current) {
@@ -3498,7 +4018,8 @@ ${outgoing}` : outgoing;
       visitorText: visitorTurnText(visitorMessage)
     });
   }, [runTurn, state.messages]);
-  const regenerate = (0, import_react2.useCallback)(async () => {
+  const regenerate = (0, import_react3.useCallback)(async () => {
+    if (handoffBlocksAI.current) return null;
     let lastVisitorIndex = -1;
     for (let index = state.messages.length - 1; index >= 0; index -= 1) {
       if (state.messages[index]?.role === "visitor") {
@@ -3541,7 +4062,7 @@ ${outgoing}` : outgoing;
       visitorText: visitorTurnText(visitorMessage)
     });
   }, [runTurn, state.messages]);
-  const respondToToolInput = (0, import_react2.useCallback)(
+  const respondToToolInput = (0, import_react3.useCallback)(
     async (surface, values) => {
       await submit(`${surface.title} submitted`, {
         runtimeText: [
@@ -3554,9 +4075,9 @@ ${outgoing}` : outgoing;
     },
     [submit]
   );
-  const respondToInput = (0, import_react2.useCallback)(
+  const respondToInput = (0, import_react3.useCallback)(
     async (response) => {
-      if (runRef.current) return;
+      if (handoffBlocksAI.current || runRef.current) return;
       const pending = state.pendingInputs?.find(
         (request) => request.requestId === response.requestId
       );
@@ -3584,7 +4105,8 @@ ${outgoing}` : outgoing;
     },
     [respondToToolInput, runTurn, state.pendingInputs]
   );
-  (0, import_react2.useEffect)(() => {
+  (0, import_react3.useEffect)(() => {
+    if (handoff.blocksAI) return;
     const conversation = loadPersistedAgentConversation(
       resolvedStorageKeyPrefix,
       visitorId
@@ -3606,14 +4128,21 @@ ${outgoing}` : outgoing;
       }
       controller.abort();
     };
-  }, [identityKey, resolvedStorageKeyPrefix, runTurn, visitorId]);
-  (0, import_react2.useEffect)(() => {
+  }, [
+    handoff.blocksAI,
+    identityKey,
+    resolvedStorageKeyPrefix,
+    runTurn,
+    visitorId
+  ]);
+  (0, import_react3.useEffect)(() => {
     return () => {
       runRef.current?.abort();
       runRef.current = null;
     };
   }, []);
   return {
+    handoff,
     state,
     reset,
     retry,
@@ -3642,12 +4171,12 @@ function isAgentBusy(phase) {
 }
 
 // src/react/hooks/useIsMobile.ts
-var import_react3 = require("react");
+var import_react4 = require("react");
 function useIsMobile(breakpoint = 767) {
-  const [isMobile, setIsMobile] = (0, import_react3.useState)(
+  const [isMobile, setIsMobile] = (0, import_react4.useState)(
     () => typeof window !== "undefined" && window.matchMedia(`(max-width: ${breakpoint}px)`).matches
   );
-  (0, import_react3.useEffect)(() => {
+  (0, import_react4.useEffect)(() => {
     const media = window.matchMedia(`(max-width: ${breakpoint}px)`);
     const onChange = () => setIsMobile(media.matches);
     onChange();
@@ -3684,7 +4213,7 @@ function unregisterAgentPanelController(customerId) {
 }
 
 // src/react/components/AgentRail/AgentRail.tsx
-var import_react15 = require("react");
+var import_react16 = require("react");
 
 // src/react/types/conversation.ts
 var defaultAgentRailTheme = {
@@ -3767,7 +4296,7 @@ function agentThemeStyle(theme, resolvedColorScheme) {
 }
 
 // src/react/hooks/useAgentColorScheme.ts
-var import_react4 = require("react");
+var import_react5 = require("react");
 var DARK_MODE_QUERY = "(prefers-color-scheme: dark)";
 function subscribeToDarkMode(onChange) {
   if (typeof window === "undefined" || !window.matchMedia) {
@@ -3785,7 +4314,7 @@ function getPrefersDarkMode() {
   return typeof window !== "undefined" && Boolean(window.matchMedia?.(DARK_MODE_QUERY).matches);
 }
 function useAgentColorScheme(colorScheme = "auto") {
-  const prefersDarkMode = (0, import_react4.useSyncExternalStore)(
+  const prefersDarkMode = (0, import_react5.useSyncExternalStore)(
     subscribeToDarkMode,
     getPrefersDarkMode,
     () => false
@@ -3797,7 +4326,7 @@ function resolveAgentColorScheme(colorScheme = "auto", prefersDarkMode) {
 }
 
 // src/react/components/AgentActivityBubble/AgentActivityBubble.tsx
-var import_react5 = require("react");
+var import_react6 = require("react");
 var import_jsx_runtime = require("react/jsx-runtime");
 function joinLabels(labels) {
   if (labels.length <= 1) return labels[0] ?? "";
@@ -3916,7 +4445,7 @@ function AgentActivityBubble({
   const statusText = workSummary(steps, failed, brandLabel);
   const softReview = statusText === AGENT_SOFT_REVIEW_STATUS;
   const receiptId = steps.map((step) => step.id).join(":");
-  const [expandedReceiptId, setExpandedReceiptId] = (0, import_react5.useState)(
+  const [expandedReceiptId, setExpandedReceiptId] = (0, import_react6.useState)(
     null
   );
   const detailsOpen = !active && expandedReceiptId === receiptId;
@@ -3967,17 +4496,17 @@ function AgentActivityBubble({
 }
 
 // src/react/components/AnswerReceiptDialog/AnswerReceiptDialog.tsx
-var import_react7 = require("react");
+var import_react8 = require("react");
 var import_react_dom = require("react-dom");
 
 // src/react/components/AgentRail/AgentRailOverlayContext.tsx
-var import_react6 = require("react");
-var AgentRailOverlayContext = (0, import_react6.createContext)(null);
+var import_react7 = require("react");
+var AgentRailOverlayContext = (0, import_react7.createContext)(null);
 function useAgentRailPortalRoots() {
-  return (0, import_react6.useContext)(AgentRailOverlayContext);
+  return (0, import_react7.useContext)(AgentRailOverlayContext);
 }
 function useAgentRailMenuPortalRoot() {
-  return (0, import_react6.useContext)(AgentRailOverlayContext)?.railRef ?? null;
+  return (0, import_react7.useContext)(AgentRailOverlayContext)?.railRef ?? null;
 }
 
 // src/react/components/AnswerReceiptDialog/AnswerReceiptDialog.tsx
@@ -4001,10 +4530,10 @@ function AnswerReceiptDialog({
 }) {
   const portalRoots = useAgentRailPortalRoots();
   const overlayRoot = portalRoots?.overlayRef ?? null;
-  const cardRef = (0, import_react7.useRef)(null);
-  const closeButtonRef = (0, import_react7.useRef)(null);
-  const previouslyFocusedRef = (0, import_react7.useRef)(null);
-  (0, import_react7.useEffect)(() => {
+  const cardRef = (0, import_react8.useRef)(null);
+  const closeButtonRef = (0, import_react8.useRef)(null);
+  const previouslyFocusedRef = (0, import_react8.useRef)(null);
+  (0, import_react8.useEffect)(() => {
     previouslyFocusedRef.current = document.activeElement instanceof HTMLElement ? document.activeElement : null;
     closeButtonRef.current?.focus({ preventScroll: true });
     const handleKeyDown = (event) => {
@@ -4089,7 +4618,7 @@ function AnswerReceiptDialog({
 }
 
 // src/react/components/Composer/Composer.tsx
-var import_react8 = require("react");
+var import_react9 = require("react");
 var import_jsx_runtime3 = require("react/jsx-runtime");
 var FORM_SUBMITTED_MESSAGE = "Shared my details";
 function SendIcon() {
@@ -4151,17 +4680,17 @@ function Composer({
   allowFormResume = true,
   onSubmit
 }) {
-  const [value, setValue] = (0, import_react8.useState)("");
-  const [draft, setDraft] = (0, import_react8.useState)(() => createDraft(form));
-  const inputRef = (0, import_react8.useRef)(null);
-  const firstFieldRef = (0, import_react8.useRef)(null);
-  const formRef = (0, import_react8.useRef)(null);
-  const formId = (0, import_react8.useId)();
+  const [value, setValue] = (0, import_react9.useState)("");
+  const [draft, setDraft] = (0, import_react9.useState)(() => createDraft(form));
+  const inputRef = (0, import_react9.useRef)(null);
+  const firstFieldRef = (0, import_react9.useRef)(null);
+  const formRef = (0, import_react9.useRef)(null);
+  const formId = (0, import_react9.useId)();
   if (form && form.id !== draft.form?.id) setDraft(createDraft(form));
   const savedForm = allowFormResume && !draft.submitted ? draft.form : null;
   const activeForm = !disabled && draft.expanded ? savedForm : null;
   const canSend = !disabled && Boolean(value.trim() || activeForm);
-  (0, import_react8.useEffect)(() => {
+  (0, import_react9.useEffect)(() => {
     if (activeForm) firstFieldRef.current?.focus();
     else if ((savedForm || draft.submitted) && !disabled)
       inputRef.current?.focus();
@@ -4422,7 +4951,7 @@ function FollowUpChips({
 }
 
 // src/react/components/MessageBubble/MessageBubble.tsx
-var import_react10 = require("react");
+var import_react11 = require("react");
 
 // src/react/components/SearchReferences/SearchReferences.tsx
 var import_jsx_runtime5 = require("react/jsx-runtime");
@@ -4513,7 +5042,7 @@ function SearchReferences({
 }
 
 // src/react/components/BookingCard/BookingCard.tsx
-var import_react9 = require("react");
+var import_react10 = require("react");
 var import_jsx_runtime6 = require("react/jsx-runtime");
 var BOOKING_STEPS = [
   { id: "date", label: "Date" },
@@ -4568,27 +5097,27 @@ function InteractiveBookingCard({
   offer,
   onBook
 }) {
-  const fieldId = (0, import_react9.useId)();
+  const fieldId = (0, import_react10.useId)();
   const defaultType = offer.eventTypes[0]?.uri ?? offer.slots[0]?.eventTypeUri ?? "";
-  const [step, setStep] = (0, import_react9.useState)("date");
-  const [eventTypeUri, setEventTypeUri] = (0, import_react9.useState)(defaultType);
-  const [selectedDate, setSelectedDate] = (0, import_react9.useState)("");
-  const [startTime, setStartTime] = (0, import_react9.useState)("");
-  const [name, setName] = (0, import_react9.useState)("");
-  const [email, setEmail] = (0, import_react9.useState)("");
-  const activeStepRef = (0, import_react9.useRef)(null);
-  const previousStepRef = (0, import_react9.useRef)(step);
+  const [step, setStep] = (0, import_react10.useState)("date");
+  const [eventTypeUri, setEventTypeUri] = (0, import_react10.useState)(defaultType);
+  const [selectedDate, setSelectedDate] = (0, import_react10.useState)("");
+  const [startTime, setStartTime] = (0, import_react10.useState)("");
+  const [name, setName] = (0, import_react10.useState)("");
+  const [email, setEmail] = (0, import_react10.useState)("");
+  const activeStepRef = (0, import_react10.useRef)(null);
+  const previousStepRef = (0, import_react10.useRef)(step);
   const stepIndex = BOOKING_STEPS.findIndex((item) => item.id === step);
-  (0, import_react9.useEffect)(() => {
+  (0, import_react10.useEffect)(() => {
     if (previousStepRef.current === step) return;
     previousStepRef.current = step;
     activeStepRef.current?.scrollIntoView({ block: "nearest" });
   }, [step]);
-  const slots = (0, import_react9.useMemo)(
+  const slots = (0, import_react10.useMemo)(
     () => bookingSlotsForEventType(offer.slots, eventTypeUri),
     [eventTypeUri, offer.slots]
   );
-  const availableByDate = (0, import_react9.useMemo)(() => {
+  const availableByDate = (0, import_react10.useMemo)(() => {
     const next = /* @__PURE__ */ new Map();
     for (const slot of slots) {
       const key = slotDateKey(slot.startTime);
@@ -4596,7 +5125,7 @@ function InteractiveBookingCard({
     }
     return next;
   }, [slots]);
-  const [visibleMonth, setVisibleMonth] = (0, import_react9.useState)(
+  const [visibleMonth, setVisibleMonth] = (0, import_react10.useState)(
     () => firstAvailableBookingMonth(slots)
   );
   function selectEventType(nextType) {
@@ -4609,7 +5138,7 @@ function InteractiveBookingCard({
       )
     );
   }
-  const daySlots = (0, import_react9.useMemo)(
+  const daySlots = (0, import_react10.useMemo)(
     () => slots.filter((slot) => slotDateKey(slot.startTime) === selectedDate),
     [selectedDate, slots]
   );
@@ -4618,7 +5147,7 @@ function InteractiveBookingCard({
   );
   const selectedSample = availableByDate.get(selectedDate) ?? startTime;
   const timeZone = formatSlotTimeZone(slots[0]?.startTime ?? selectedSample);
-  const weekdays = (0, import_react9.useMemo)(() => weekdayLabels(), []);
+  const weekdays = (0, import_react10.useMemo)(() => weekdayLabels(), []);
   const cells = calendarCells(visibleMonth.year, visibleMonth.month);
   const canPrevMonth = [...availableByDate.keys()].some((key) => {
     const month = monthFromKey(key);
@@ -4904,8 +5433,8 @@ function resolveMessageUrl(safeUrl, baseUrl) {
 // src/react/components/MessageBubble/MessageBubble.tsx
 var import_styles = require("streamdown/styles.css");
 var import_jsx_runtime7 = require("react/jsx-runtime");
-function normalizeDedupeText(text2) {
-  return text2.trim().replace(/\s+/g, " ").toLowerCase();
+function normalizeDedupeText(text3) {
+  return text3.trim().replace(/\s+/g, " ").toLowerCase();
 }
 function paragraphsAreNearDuplicates(first, second) {
   const left = normalizeDedupeText(first);
@@ -4921,8 +5450,8 @@ function paragraphsShareOpening(first, second) {
   if (!opening || opening.length < 20) return false;
   return second.trim().startsWith(opening);
 }
-function collapseRepeatedText(text2) {
-  const trimmed = text2.trim();
+function collapseRepeatedText(text3) {
+  const trimmed = text3.trim();
   if (trimmed.length < 40) return trimmed;
   const paragraphs = trimmed.split(/\n{2,}/u).map((part) => part.trim()).filter(Boolean);
   if (paragraphs.length === 2 && (paragraphsAreNearDuplicates(paragraphs[0], paragraphs[1]) || paragraphsShareOpening(paragraphs[0], paragraphs[1]))) {
@@ -4943,13 +5472,14 @@ function MessageBubble({
   message,
   brandLogoUrl,
   bookingDisabled = false,
+  showProvenance = false,
   bookingReadOnly = false,
   linkBaseUrl,
   offer,
   onBook
 }) {
   const resolvedLogoUrl = brandLogoUrl?.trim();
-  const [failedLogoUrl, setFailedLogoUrl] = (0, import_react10.useState)(null);
+  const [failedLogoUrl, setFailedLogoUrl] = (0, import_react11.useState)(null);
   const showBrandLogo = Boolean(resolvedLogoUrl) && failedLogoUrl !== resolvedLogoUrl;
   const cards = message.role === "agent" ? extractToolCards(message.text) : [];
   const extractedOffers = cards.filter(
@@ -4964,7 +5494,34 @@ function MessageBubble({
   if (message.role === "visitor") {
     const visitorText = visitorMessageDisplayText(message).trim();
     if (!visitorText) return null;
-    return /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("article", { className: "message-bubble message-bubble--visitor", children: /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("p", { className: "message-bubble__text", children: visitorText }) });
+    return /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)(
+      "article",
+      {
+        className: "message-bubble message-bubble--visitor",
+        "aria-label": "Message from visitor",
+        children: [
+          showProvenance ? /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("span", { className: "message-bubble__speaker", children: "You \xB7 Visitor" }) : null,
+          /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("p", { className: "message-bubble__text", children: visitorText })
+        ]
+      }
+    );
+  }
+  if (message.role === "human") {
+    return /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)(
+      "article",
+      {
+        className: "message-bubble message-bubble--human",
+        "aria-label": `Message from ${message.representative.name}`,
+        children: [
+          /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("strong", { className: "message-bubble__representative", children: [
+            message.representative.name,
+            " ",
+            /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("span", { children: "Human representative" })
+          ] }),
+          /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("p", { className: "message-bubble__text", children: message.text })
+        ]
+      }
+    );
   }
   const citations = message.citations ?? [];
   const agentText = /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("div", { className: "message-bubble__text", children: [
@@ -5001,40 +5558,48 @@ function MessageBubble({
   ] });
   if (!displayText && !message.searchResults?.length && offers.length === 0)
     return null;
-  return /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("article", { className: "message-bubble message-bubble--agent", children: [
-    displayText || message.searchResults?.length ? showBrandLogo ? /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("div", { className: "message-bubble__agent-row", children: [
-      /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("span", { className: "message-bubble__agent-avatar", "aria-hidden": "true", children: /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(
-        "img",
-        {
-          src: resolvedLogoUrl,
-          alt: "",
-          onError: () => {
-            setFailedLogoUrl(resolvedLogoUrl ?? null);
-          }
-        }
-      ) }),
-      agentText
-    ] }) : agentText : null,
-    offers.map((nextOffer, index) => /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(
-      BookingCard,
-      {
-        disabled: bookingDisabled,
-        readOnly: bookingReadOnly,
-        offer: nextOffer,
-        onBook
-      },
-      `${bookingOfferIdentityKey(nextOffer)}-${index}`
-    ))
-  ] });
+  return /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)(
+    "article",
+    {
+      className: "message-bubble message-bubble--agent",
+      "aria-label": "Message from AI assistant",
+      children: [
+        showProvenance ? /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("span", { className: "message-bubble__speaker", children: "AI assistant" }) : null,
+        displayText || message.searchResults?.length ? showBrandLogo ? /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)("div", { className: "message-bubble__agent-row", children: [
+          /* @__PURE__ */ (0, import_jsx_runtime7.jsx)("span", { className: "message-bubble__agent-avatar", "aria-hidden": "true", children: /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(
+            "img",
+            {
+              src: resolvedLogoUrl,
+              alt: "",
+              onError: () => {
+                setFailedLogoUrl(resolvedLogoUrl ?? null);
+              }
+            }
+          ) }),
+          agentText
+        ] }) : agentText : null,
+        offers.map((nextOffer, index) => /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(
+          BookingCard,
+          {
+            disabled: bookingDisabled,
+            readOnly: bookingReadOnly,
+            offer: nextOffer,
+            onBook
+          },
+          `${bookingOfferIdentityKey(nextOffer)}-${index}`
+        ))
+      ]
+    }
+  );
 }
 
 // src/react/components/MessageActions/MessageActions.tsx
-var import_react11 = require("react");
+var import_react12 = require("react");
 var import_react_dom2 = require("react-dom");
 
 // src/react/lib/speech.ts
-function toSpeechText(text2) {
-  let out = hideToolCardFences(text2);
+function toSpeechText(text3) {
+  let out = hideToolCardFences(text3);
   out = out.replace(/```[\s\S]*?```/g, " ");
   out = out.replace(/!\[([^\]]*)\]\([^)]*\)/g, "$1");
   out = out.replace(/\[([^\]]+)\]\([^)]*\)/g, "$1");
@@ -5369,12 +5934,12 @@ function StopIcon() {
     }
   ) });
 }
-async function writeToClipboard(text2) {
+async function writeToClipboard(text3) {
   try {
-    await navigator.clipboard.writeText(text2);
+    await navigator.clipboard.writeText(text3);
   } catch {
     const textarea = document.createElement("textarea");
-    textarea.value = text2;
+    textarea.value = text3;
     textarea.style.position = "fixed";
     textarea.style.opacity = "0";
     document.body.appendChild(textarea);
@@ -5425,26 +5990,26 @@ function MessageActions({
   speechText
 }) {
   const menuPortalRoot = useAgentRailMenuPortalRoot();
-  const [copied, setCopied] = (0, import_react11.useState)(false);
-  const [rating, setRating] = (0, import_react11.useState)(null);
-  const [menuOpen, setMenuOpen] = (0, import_react11.useState)(false);
-  const [menuPosition, setMenuPosition] = (0, import_react11.useState)(null);
-  const [speaking, setSpeaking] = (0, import_react11.useState)(false);
-  const [speechSupported, setSpeechSupported] = (0, import_react11.useState)(null);
-  const copyTimerRef = (0, import_react11.useRef)(null);
-  const menuRef = (0, import_react11.useRef)(null);
-  const portaledMenuRef = (0, import_react11.useRef)(null);
-  const moreButtonRef = (0, import_react11.useRef)(null);
+  const [copied, setCopied] = (0, import_react12.useState)(false);
+  const [rating, setRating] = (0, import_react12.useState)(null);
+  const [menuOpen, setMenuOpen] = (0, import_react12.useState)(false);
+  const [menuPosition, setMenuPosition] = (0, import_react12.useState)(null);
+  const [speaking, setSpeaking] = (0, import_react12.useState)(false);
+  const [speechSupported, setSpeechSupported] = (0, import_react12.useState)(null);
+  const copyTimerRef = (0, import_react12.useRef)(null);
+  const menuRef = (0, import_react12.useRef)(null);
+  const portaledMenuRef = (0, import_react12.useRef)(null);
+  const moreButtonRef = (0, import_react12.useRef)(null);
   const answeredLabel = formatAnsweredAt(answeredAt ?? 0);
   const resolvedSpeechText = speechText ?? toSpeechText(copyText);
   const canOpenReceipt = Boolean(receiptSteps) && Boolean(onOpenReceipt);
   const readAloudEligible = Boolean(readAloud && resolvedSpeechText);
   const canReadAloud = readAloudEligible && speechSupported === true;
   const showMenu = canOpenReceipt || (speechSupported === null ? readAloudEligible : canReadAloud);
-  (0, import_react11.useLayoutEffect)(() => {
+  (0, import_react12.useLayoutEffect)(() => {
     setSpeechSupported(isSpeechSupported());
   }, []);
-  (0, import_react11.useLayoutEffect)(() => {
+  (0, import_react12.useLayoutEffect)(() => {
     if (!menuOpen || !moreButtonRef.current || !portaledMenuRef.current) {
       setMenuPosition(null);
       return;
@@ -5461,7 +6026,7 @@ function MessageActions({
       })
     );
   }, [menuOpen, menuPortalRoot]);
-  (0, import_react11.useEffect)(() => {
+  (0, import_react12.useEffect)(() => {
     const unsubscribe = subscribeSpeechInterrupts(() => setSpeaking(false));
     return () => {
       unsubscribe();
@@ -5471,7 +6036,7 @@ function MessageActions({
       stopSpeech();
     };
   }, []);
-  (0, import_react11.useEffect)(() => {
+  (0, import_react12.useEffect)(() => {
     if (!menuOpen) return;
     const handlePointerDown = (event) => {
       const target = event.target;
@@ -5640,7 +6205,7 @@ function MessageActions({
 }
 
 // src/react/components/HumanInputCard/HumanInputCard.tsx
-var import_react13 = require("react");
+var import_react14 = require("react");
 
 // src/react/components/ConfirmationCard/ConfirmationCard.tsx
 var import_jsx_runtime9 = require("react/jsx-runtime");
@@ -5682,7 +6247,7 @@ function ConfirmationCard({
 }
 
 // src/react/components/ToolInputCard/ToolInputCard.tsx
-var import_react12 = require("react");
+var import_react13 = require("react");
 var import_jsx_runtime10 = require("react/jsx-runtime");
 function isRecord5(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value);
@@ -5805,13 +6370,13 @@ function valuesMatch(left, right) {
 }
 function FieldDescription({
   field,
-  id
+  id: id2
 }) {
-  return field.description ? /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("span", { id, className: "tool-input-card__description", children: field.description }) : null;
+  return field.description ? /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("span", { id: id2, className: "tool-input-card__description", children: field.description }) : null;
 }
 function ChoiceField({
   field,
-  id,
+  id: id2,
   value,
   disabled,
   describedBy,
@@ -5829,7 +6394,7 @@ function ChoiceField({
     return /* @__PURE__ */ (0, import_jsx_runtime10.jsxs)(
       "select",
       {
-        id,
+        id: id2,
         value: selectedIndex >= 0 ? String(selectedIndex) : "",
         disabled,
         required: field.required,
@@ -5852,7 +6417,7 @@ function ChoiceField({
     {
       className: "tool-input-card__choices",
       role: multiple ? "group" : "radiogroup",
-      "aria-labelledby": `${id}-label`,
+      "aria-labelledby": `${id2}-label`,
       "aria-describedby": describedBy,
       "aria-invalid": Boolean(error),
       "aria-required": field.required,
@@ -5863,7 +6428,7 @@ function ChoiceField({
             "input",
             {
               type: multiple ? "checkbox" : "radio",
-              name: id,
+              name: id2,
               value: String(index),
               checked,
               disabled,
@@ -5891,22 +6456,22 @@ function ToolField({
   disabled,
   error,
   field,
-  id,
+  id: id2,
   value,
   onBlur,
   onChange
 }) {
   const describedBy = [
-    field.description ? `${id}-description` : "",
-    error ? `${id}-error` : ""
+    field.description ? `${id2}-description` : "",
+    error ? `${id2}-error` : ""
   ].filter(Boolean).join(" ");
   if (field.kind === "checkbox" || field.kind === "confirmation") {
     return /* @__PURE__ */ (0, import_jsx_runtime10.jsxs)("div", { className: "tool-input-card__field", children: [
-      /* @__PURE__ */ (0, import_jsx_runtime10.jsxs)("label", { className: "tool-input-card__check", htmlFor: id, children: [
+      /* @__PURE__ */ (0, import_jsx_runtime10.jsxs)("label", { className: "tool-input-card__check", htmlFor: id2, children: [
         /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(
           "input",
           {
-            id,
+            id: id2,
             type: "checkbox",
             checked: value === true,
             disabled,
@@ -5918,18 +6483,18 @@ function ToolField({
         ),
         /* @__PURE__ */ (0, import_jsx_runtime10.jsxs)("span", { children: [
           /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("strong", { children: field.label }),
-          field.description ? /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("span", { id: `${id}-description`, children: field.description }) : null
+          field.description ? /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("span", { id: `${id2}-description`, children: field.description }) : null
         ] })
       ] }),
-      error ? /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("span", { id: `${id}-error`, className: "tool-input-card__error", children: error }) : null
+      error ? /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("span", { id: `${id2}-error`, className: "tool-input-card__error", children: error }) : null
     ] });
   }
-  const label = /* @__PURE__ */ (0, import_jsx_runtime10.jsxs)("label", { id: `${id}-label`, htmlFor: id, children: [
+  const label = /* @__PURE__ */ (0, import_jsx_runtime10.jsxs)("label", { id: `${id2}-label`, htmlFor: id2, children: [
     field.label,
     field.required ? /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("span", { "aria-hidden": "true", children: " *" }) : null
   ] });
   const common = {
-    id,
+    id: id2,
     disabled,
     required: field.required,
     "aria-describedby": describedBy || void 0,
@@ -5942,7 +6507,7 @@ function ToolField({
       ChoiceField,
       {
         field,
-        id,
+        id: id2,
         value,
         disabled,
         describedBy: describedBy || void 0,
@@ -5979,7 +6544,7 @@ function ToolField({
           onChange: (event) => onChange(Number(event.target.value))
         }
       ),
-      /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("output", { htmlFor: id, children: numericValue })
+      /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("output", { htmlFor: id2, children: numericValue })
     ] });
   } else {
     const type = field.kind === "date-time" ? "datetime-local" : field.kind === "calendar" ? "date" : field.kind;
@@ -6003,9 +6568,9 @@ function ToolField({
   }
   return /* @__PURE__ */ (0, import_jsx_runtime10.jsxs)("div", { className: "tool-input-card__field", children: [
     label,
-    /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(FieldDescription, { field, id: `${id}-description` }),
+    /* @__PURE__ */ (0, import_jsx_runtime10.jsx)(FieldDescription, { field, id: `${id2}-description` }),
     control,
-    error ? /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("span", { id: `${id}-error`, className: "tool-input-card__error", children: error }) : null
+    error ? /* @__PURE__ */ (0, import_jsx_runtime10.jsx)("span", { id: `${id2}-error`, className: "tool-input-card__error", children: error }) : null
   ] });
 }
 function ToolInputCard({
@@ -6013,11 +6578,11 @@ function ToolInputCard({
   surface,
   onSubmit
 }) {
-  const [values, setValues] = (0, import_react12.useState)(
+  const [values, setValues] = (0, import_react13.useState)(
     () => initialValues(surface)
   );
-  const [touched, setTouched] = (0, import_react12.useState)(() => /* @__PURE__ */ new Set());
-  const [submitted, setSubmitted] = (0, import_react12.useState)(false);
+  const [touched, setTouched] = (0, import_react13.useState)(() => /* @__PURE__ */ new Set());
+  const [submitted, setSubmitted] = (0, import_react13.useState)(false);
   const errors = Object.fromEntries(
     surface.fields.map((field) => [
       field.path,
@@ -6110,7 +6675,7 @@ function HumanInputCard({
   request,
   onRespond
 }) {
-  const [text2, setText] = (0, import_react13.useState)("");
+  const [text3, setText] = (0, import_react14.useState)("");
   const options = request.options ?? [];
   const showText = request.display === "text" || request.allowFreeform && options.length === 0;
   if (request.ui) {
@@ -6135,7 +6700,7 @@ function HumanInputCard({
   }
   function submitText(event) {
     event.preventDefault();
-    const value = text2.trim();
+    const value = text3.trim();
     if (!value || disabled) return;
     onRespond?.({ requestId: request.requestId, text: value });
   }
@@ -6153,12 +6718,12 @@ function HumanInputCard({
               "input",
               {
                 id: `human-input-text-${request.requestId}`,
-                value: text2,
+                value: text3,
                 disabled,
                 onChange: (event) => setText(event.target.value)
               }
             ),
-            /* @__PURE__ */ (0, import_jsx_runtime11.jsx)("button", { type: "submit", disabled: disabled || !text2.trim(), children: "Send" })
+            /* @__PURE__ */ (0, import_jsx_runtime11.jsx)("button", { type: "submit", disabled: disabled || !text3.trim(), children: "Send" })
           ] })
         ] }) : null,
         !showText && options.length === 0 ? /* @__PURE__ */ (0, import_jsx_runtime11.jsx)("p", { className: "human-input-card__unavailable", role: "status", children: "This request can\u2019t be answered here." }) : null
@@ -6168,7 +6733,7 @@ function HumanInputCard({
 }
 
 // src/react/components/LocationConsent/LocationConsent.tsx
-var import_react14 = require("react");
+var import_react15 = require("react");
 
 // src/runtime/location-consent.ts
 function isLocationConsentRequest(request) {
@@ -6216,16 +6781,16 @@ function LocationConsent({
   request,
   onRespond
 }) {
-  const [preference, setPreference] = (0, import_react14.useState)("unset");
-  const [locating, setLocating] = (0, import_react14.useState)(false);
-  const [error, setError] = (0, import_react14.useState)(null);
-  const respond = (0, import_react14.useRef)(onRespond);
-  const answered = (0, import_react14.useRef)(null);
+  const [preference, setPreference] = (0, import_react15.useState)("unset");
+  const [locating, setLocating] = (0, import_react15.useState)(false);
+  const [error, setError] = (0, import_react15.useState)(null);
+  const respond = (0, import_react15.useRef)(onRespond);
+  const answered = (0, import_react15.useRef)(null);
   const requestId = request?.requestId;
-  (0, import_react14.useEffect)(() => {
+  (0, import_react15.useEffect)(() => {
     respond.current = onRespond;
   }, [onRespond]);
-  (0, import_react14.useEffect)(() => {
+  (0, import_react15.useEffect)(() => {
     if (!requestId || preference === "unset" || answered.current === requestId || !respond.current)
       return;
     if (preference === "off") {
@@ -6567,6 +7132,7 @@ function ChevronDownIcon() {
 var DEFAULT_DISCLAIMER_LABEL = "Agent can make mistakes. Check important info.";
 function AgentRail({
   state,
+  handoff,
   theme,
   colorScheme = "auto",
   brandLabel = "",
@@ -6592,44 +7158,51 @@ function AgentRail({
   onInputResponse,
   onToolInput
 }) {
-  const railRef = (0, import_react15.useRef)(null);
-  const overlayRef = (0, import_react15.useRef)(null);
-  const transcriptRef = (0, import_react15.useRef)(null);
-  const responseRef = (0, import_react15.useRef)(null);
-  const threadRef = (0, import_react15.useRef)(null);
-  const lastScrolledVisitorIdRef = (0, import_react15.useRef)(void 0);
-  const pinnedToBottomRef = (0, import_react15.useRef)(true);
-  const smoothScrollToLatestRef = (0, import_react15.useRef)(false);
-  const lockedTranscriptScrollTopRef = (0, import_react15.useRef)(null);
-  const [showJumpToLatest, setShowJumpToLatest] = (0, import_react15.useState)(false);
-  const [receiptOpen, setReceiptOpen] = (0, import_react15.useState)(false);
+  const railRef = (0, import_react16.useRef)(null);
+  const overlayRef = (0, import_react16.useRef)(null);
+  const transcriptRef = (0, import_react16.useRef)(null);
+  const responseRef = (0, import_react16.useRef)(null);
+  const threadRef = (0, import_react16.useRef)(null);
+  const lastScrolledVisitorIdRef = (0, import_react16.useRef)(void 0);
+  const pinnedToBottomRef = (0, import_react16.useRef)(true);
+  const smoothScrollToLatestRef = (0, import_react16.useRef)(false);
+  const lockedTranscriptScrollTopRef = (0, import_react16.useRef)(null);
+  const [showJumpToLatest, setShowJumpToLatest] = (0, import_react16.useState)(false);
+  const [receiptOpen, setReceiptOpen] = (0, import_react16.useState)(false);
   const resolvedBrandLabel = brandLabel.trim();
   const resolvedBrandLogoUrl = brandLogoUrl?.trim();
   const resolvedDisclaimerLabel = disclaimerLabel === void 0 ? DEFAULT_DISCLAIMER_LABEL : disclaimerLabel;
-  const [failedLogoUrl, setFailedLogoUrl] = (0, import_react15.useState)(null);
+  const [failedLogoUrl, setFailedLogoUrl] = (0, import_react16.useState)(null);
   const showBrandLogo = Boolean(resolvedBrandLogoUrl) && failedLogoUrl !== resolvedBrandLogoUrl;
   const resolvedColorScheme = useAgentColorScheme(colorScheme);
   const railStyle = agentThemeStyle(theme, resolvedColorScheme);
-  const locationRequest = state.pendingInputs?.find(isLocationConsentRequest);
+  const handoffActive = Boolean(handoff?.blocksAI);
+  const handoffStatus = handoff?.page?.status;
+  const locationRequest = handoffActive ? void 0 : state.pendingInputs?.find(isLocationConsentRequest);
   const pendingInputRequests = (state.pendingInputs ?? []).filter(
-    (request) => !isLocationConsentRequest(request) && shouldRenderVisitorInputCard(request) && (!state.pendingOffer || request.kind === "tool-approval")
+    (request) => !handoffActive && !isLocationConsentRequest(request) && shouldRenderVisitorInputCard(request) && (!state.pendingOffer || request.kind === "tool-approval")
   );
   const isBusy = state.phase === "thinking" || state.phase === "running-tools" || state.phase === "streaming" || state.phase === "waiting-input" && (pendingInputRequests.length > 0 || Boolean(locationRequest));
-  const semanticSurfaceDisabled = isBusy && state.phase !== "waiting-input";
+  const semanticSurfaceDisabled = handoffActive || isBusy && state.phase !== "waiting-input";
   const visitorToolResults = (state.toolResults ?? []).filter(
     isRenderableVisitorToolResult
   );
   const activeVisitorToolInput = [...visitorToolResults].reverse().find((result) => result.kind === "input");
   const visibleVisitorToolResults = activeVisitorToolInput ? [activeVisitorToolInput] : visitorToolResults;
-  const activityActive = state.toolSteps.some((step) => step.state === "active");
+  const activityActive = state.toolSteps.some(
+    (step) => step.state === "active"
+  );
   const showActivity = state.toolSteps.length > 0 && pendingInputRequests.length === 0 && !state.pendingOffer && (activityActive || isBusy && !state.streamingText);
-  const activitySteps = activityActive || !isBusy || state.streamingText ? state.toolSteps : [...state.toolSteps, {
-    id: "preparing-answer",
-    kind: "tool",
-    label: "Preparing your answer",
-    detail: "Preparing your answer",
-    state: "active"
-  }];
+  const activitySteps = activityActive || !isBusy || state.streamingText ? state.toolSteps : [
+    ...state.toolSteps,
+    {
+      id: "preparing-answer",
+      kind: "tool",
+      label: "Preparing your answer",
+      detail: "Preparing your answer",
+      state: "active"
+    }
+  ];
   const hasVisitorMessages2 = state.messages.some(
     (message) => message.role === "visitor"
   );
@@ -6658,7 +7231,7 @@ function AgentRail({
     }
   }
   const lastIsAgent = lastMessage?.role === "agent";
-  const showMessageActions = state.phase === "complete" && lastIsAgent && hasVisitorMessages2 && Boolean(hideToolCardFences(lastMessage.text).trim());
+  const showMessageActions = !handoffActive && state.phase === "complete" && lastIsAgent && hasVisitorMessages2 && Boolean(hideToolCardFences(lastMessage.text).trim());
   const streamingMessage = state.streamingText && !lastIsAgent ? {
     createdAt: 0,
     id: "streaming-response",
@@ -6700,7 +7273,7 @@ function AgentRail({
     ...visibleVisitorToolResults
   ].reverse().find((result) => result.kind !== "input")?.id;
   const receiptSteps = answerReceipt && state.toolSteps.length > 0 ? state.toolSteps : void 0;
-  (0, import_react15.useEffect)(() => {
+  (0, import_react16.useEffect)(() => {
     if (state.phase !== "complete") {
       setReceiptOpen(false);
     }
@@ -6722,7 +7295,7 @@ function AgentRail({
     onFollowUpSelect?.(label);
   }
   const latestVisitorId = visibleMessages[lastVisitorIndex]?.id;
-  (0, import_react15.useEffect)(() => {
+  (0, import_react16.useEffect)(() => {
     const node = transcriptRef.current;
     if (!node) return;
     if (latestVisitorId !== lastScrolledVisitorIdRef.current) {
@@ -6752,7 +7325,7 @@ function AgentRail({
     state.followUps,
     state.journey
   ]);
-  (0, import_react15.useEffect)(() => {
+  (0, import_react16.useEffect)(() => {
     const node = transcriptRef.current;
     if (!node) return;
     const handleScroll = () => {
@@ -6766,7 +7339,7 @@ function AgentRail({
     handleScroll();
     return () => node.removeEventListener("scroll", handleScroll);
   }, []);
-  (0, import_react15.useEffect)(() => {
+  (0, import_react16.useEffect)(() => {
     if (!receiptOpen) {
       lockedTranscriptScrollTopRef.current = null;
       return;
@@ -6818,249 +7391,302 @@ function AgentRail({
       autoFocus: mobileFullscreen || expanded,
       role: mobileFullscreen || expanded ? "dialog" : void 0,
       tabIndex: mobileFullscreen || expanded ? -1 : void 0,
-      children: /* @__PURE__ */ (0, import_jsx_runtime18.jsxs)(
-        AgentRailOverlayContext.Provider,
-        {
-          value: { railRef, overlayRef },
-          children: [
-            /* @__PURE__ */ (0, import_jsx_runtime18.jsxs)("div", { className: "agent-rail__surface", inert: receiptOpen || void 0, children: [
-              /* @__PURE__ */ (0, import_jsx_runtime18.jsx)("header", { className: "agent-rail__header", children: /* @__PURE__ */ (0, import_jsx_runtime18.jsxs)("div", { className: "agent-rail__brand-row", children: [
-                onCollapse ? /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(
-                  "button",
-                  {
-                    type: "button",
-                    className: "agent-rail__collapse",
-                    "aria-label": "Collapse assist",
-                    onClick: onCollapse,
-                    children: /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(MinimizeIcon, {})
-                  }
-                ) : onClose ? /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(
-                  "button",
-                  {
-                    type: "button",
-                    className: "agent-rail__close",
-                    "aria-label": "Close agent",
-                    onClick: onClose,
-                    children: /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(CloseIcon2, {})
+      children: /* @__PURE__ */ (0, import_jsx_runtime18.jsxs)(AgentRailOverlayContext.Provider, { value: { railRef, overlayRef }, children: [
+        /* @__PURE__ */ (0, import_jsx_runtime18.jsxs)("div", { className: "agent-rail__surface", inert: receiptOpen || void 0, children: [
+          /* @__PURE__ */ (0, import_jsx_runtime18.jsx)("header", { className: "agent-rail__header", children: /* @__PURE__ */ (0, import_jsx_runtime18.jsxs)("div", { className: "agent-rail__brand-row", children: [
+            onCollapse ? /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(
+              "button",
+              {
+                type: "button",
+                className: "agent-rail__collapse",
+                "aria-label": "Collapse assist",
+                onClick: onCollapse,
+                children: /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(MinimizeIcon, {})
+              }
+            ) : onClose ? /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(
+              "button",
+              {
+                type: "button",
+                className: "agent-rail__close",
+                "aria-label": "Close agent",
+                onClick: onClose,
+                children: /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(CloseIcon2, {})
+              }
+            ) : /* @__PURE__ */ (0, import_jsx_runtime18.jsx)("span", { className: "agent-rail__brand-spacer", "aria-hidden": "true" }),
+            resolvedBrandLabel || showBrandLogo ? /* @__PURE__ */ (0, import_jsx_runtime18.jsxs)("span", { className: "agent-rail__identity", children: [
+              showBrandLogo ? /* @__PURE__ */ (0, import_jsx_runtime18.jsx)("span", { className: "agent-rail__brand-mark", "aria-hidden": "true", children: /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(
+                "img",
+                {
+                  className: "agent-rail__brand-logo",
+                  src: resolvedBrandLogoUrl,
+                  alt: "",
+                  onError: () => {
+                    setFailedLogoUrl(resolvedBrandLogoUrl ?? null);
                   }
-                ) : /* @__PURE__ */ (0, import_jsx_runtime18.jsx)("span", { className: "agent-rail__brand-spacer", "aria-hidden": "true" }),
-                resolvedBrandLabel || showBrandLogo ? /* @__PURE__ */ (0, import_jsx_runtime18.jsxs)("span", { className: "agent-rail__identity", children: [
-                  showBrandLogo ? /* @__PURE__ */ (0, import_jsx_runtime18.jsx)("span", { className: "agent-rail__brand-mark", "aria-hidden": "true", children: /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(
-                    "img",
-                    {
-                      className: "agent-rail__brand-logo",
-                      src: resolvedBrandLogoUrl,
-                      alt: "",
-                      onError: () => {
-                        setFailedLogoUrl(resolvedBrandLogoUrl ?? null);
-                      }
-                    }
-                  ) }) : null,
-                  resolvedBrandLabel ? /* @__PURE__ */ (0, import_jsx_runtime18.jsx)("span", { className: "agent-rail__brand-label", children: resolvedBrandLabel }) : null
-                ] }) : null,
-                /* @__PURE__ */ (0, import_jsx_runtime18.jsxs)("span", { className: "agent-rail__actions", children: [
-                  onReset ? /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(
-                    "button",
-                    {
-                      type: "button",
-                      className: "agent-rail__new-chat",
-                      "aria-label": "Start a new conversation",
-                      disabled: !hasVisitorMessages2,
-                      onClick: handleReset,
-                      children: /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(NewChatIcon, {})
-                    }
-                  ) : null,
-                  onExpandToggle ? /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(
-                    "button",
+                }
+              ) }) : null,
+              resolvedBrandLabel ? /* @__PURE__ */ (0, import_jsx_runtime18.jsx)("span", { className: "agent-rail__brand-label", children: resolvedBrandLabel }) : null
+            ] }) : null,
+            /* @__PURE__ */ (0, import_jsx_runtime18.jsxs)("span", { className: "agent-rail__actions", children: [
+              onReset ? /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(
+                "button",
+                {
+                  type: "button",
+                  className: "agent-rail__new-chat",
+                  "aria-label": "Start a new conversation",
+                  disabled: !hasVisitorMessages2 || handoffActive && !handoff?.canReset,
+                  onClick: handleReset,
+                  children: /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(NewChatIcon, {})
+                }
+              ) : null,
+              onExpandToggle ? /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(
+                "button",
+                {
+                  type: "button",
+                  className: "agent-rail__expand",
+                  "aria-label": expanded ? "Exit full screen" : "Open full screen",
+                  onClick: onExpandToggle,
+                  children: expanded ? /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(RestoreIcon, {}) : /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(ExpandIcon, {})
+                }
+              ) : null
+            ] })
+          ] }) }),
+          /* @__PURE__ */ (0, import_jsx_runtime18.jsx)("div", { ref: transcriptRef, className: "agent-rail__transcript", children: /* @__PURE__ */ (0, import_jsx_runtime18.jsxs)("div", { ref: threadRef, className: "agent-rail__thread", children: [
+            !hasVisitorMessages2 ? /* @__PURE__ */ (0, import_jsx_runtime18.jsxs)("section", { className: "agent-rail__welcome", "aria-label": "Welcome", children: [
+              greeting?.role === "agent" ? /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(
+                MessageBubble,
+                {
+                  showProvenance: Boolean(
+                    handoff?.page?.enabled || handoffActive
+                  ),
+                  message: greeting,
+                  bookingDisabled: isBusy || handoffActive,
+                  brandLogoUrl: showBrandLogo ? resolvedBrandLogoUrl : void 0,
+                  onBook
+                }
+              ) : null,
+              showIdleFollowUps ? /* @__PURE__ */ (0, import_jsx_runtime18.jsx)("div", { className: "agent-rail__followups-slot", children: /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(
+                FollowUpChips,
+                {
+                  suggestions: state.followUps,
+                  disabled: isBusy || handoffActive,
+                  label: "Start here",
+                  onSelect: (suggestion) => handleFollowUpSelect(suggestion.label)
+                }
+              ) }) : null,
+              showActivity ? /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(
+                AgentActivityBubble,
+                {
+                  brandLabel: resolvedBrandLabel,
+                  brandLogoUrl: showBrandLogo ? resolvedBrandLogoUrl : void 0,
+                  failed: state.phase === "error",
+                  steps: activitySteps
+                }
+              ) : null,
+              visibleVisitorToolResults.map((result) => /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(
+                VisitorToolResultView,
+                {
+                  result,
+                  disabled: semanticSurfaceDisabled,
+                  onToolInput
+                },
+                result.id
+              )),
+              pendingInputRequests.slice(0, 1).map((request) => /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(
+                HumanInputCard,
+                {
+                  request,
+                  onRespond: onInputResponse
+                },
+                request.requestId
+              ))
+            ] }) : null,
+            transcriptMessages.map((message, index) => /* @__PURE__ */ (0, import_jsx_runtime18.jsxs)(
+              "div",
+              {
+                ref: index === lastVisitorIndex + 1 ? responseRef : void 0,
+                className: "agent-rail__turn-block",
+                children: [
+                  message.role === "agent" ? message.toolResults?.map((result) => /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(
+                    VisitorToolResultView,
                     {
-                      type: "button",
-                      className: "agent-rail__expand",
-                      "aria-label": expanded ? "Exit full screen" : "Open full screen",
-                      onClick: onExpandToggle,
-                      children: expanded ? /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(RestoreIcon, {}) : /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(ExpandIcon, {})
-                    }
-                  ) : null
-                ] })
-              ] }) }),
-              /* @__PURE__ */ (0, import_jsx_runtime18.jsx)("div", { ref: transcriptRef, className: "agent-rail__transcript", children: /* @__PURE__ */ (0, import_jsx_runtime18.jsxs)("div", { ref: threadRef, className: "agent-rail__thread", children: [
-                !hasVisitorMessages2 ? /* @__PURE__ */ (0, import_jsx_runtime18.jsxs)("section", { className: "agent-rail__welcome", "aria-label": "Welcome", children: [
-                  greeting?.role === "agent" ? /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(
+                      result
+                    },
+                    result.id
+                  )) : null,
+                  /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(
                     MessageBubble,
                     {
-                      message: greeting,
-                      bookingDisabled: isBusy,
+                      showProvenance: Boolean(
+                        handoff?.page?.enabled || handoffActive
+                      ),
+                      message,
+                      bookingDisabled: isBusy || handoffActive,
                       brandLogoUrl: showBrandLogo ? resolvedBrandLogoUrl : void 0,
+                      offer: index === transcriptMessages.length - 1 ? state.pendingOffer : void 0,
                       onBook
                     }
-                  ) : null,
-                  showIdleFollowUps ? /* @__PURE__ */ (0, import_jsx_runtime18.jsx)("div", { className: "agent-rail__followups-slot", children: /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(
-                    FollowUpChips,
+                  ),
+                  index === lastAgentIndex && showMessageActions && message.role === "agent" ? /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(
+                    MessageActions,
                     {
-                      suggestions: state.followUps,
-                      disabled: isBusy,
-                      label: "Start here",
-                      onSelect: (suggestion) => handleFollowUpSelect(suggestion.label)
-                    }
-                  ) }) : null,
-                  showActivity ? /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(
-                    AgentActivityBubble,
-                    {
-                      brandLabel: resolvedBrandLabel,
-                      brandLogoUrl: showBrandLogo ? resolvedBrandLogoUrl : void 0,
-                      failed: state.phase === "error",
-                      steps: activitySteps
+                      answeredAt: message.createdAt,
+                      copyText: hideToolCardFences(message.text).trim() || message.text,
+                      readAloud,
+                      receiptSteps,
+                      onOpenReceipt: receiptSteps ? openReceipt : void 0,
+                      onRegenerate: onRegenerate ? handleRegenerate : void 0,
+                      onFeedback: onFeedback ? (rating) => onFeedback(rating, message) : void 0
                     }
                   ) : null,
-                  visibleVisitorToolResults.map((result) => /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(
-                    VisitorToolResultView,
-                    {
-                      result,
-                      disabled: semanticSurfaceDisabled,
-                      onToolInput
-                    },
-                    result.id
-                  )),
-                  pendingInputRequests.slice(0, 1).map((request) => /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(
-                    HumanInputCard,
-                    {
-                      request,
-                      onRespond: onInputResponse
-                    },
-                    request.requestId
-                  ))
-                ] }) : null,
-                transcriptMessages.map((message, index) => /* @__PURE__ */ (0, import_jsx_runtime18.jsxs)(
-                  "div",
-                  {
-                    ref: index === lastVisitorIndex + 1 ? responseRef : void 0,
-                    className: "agent-rail__turn-block",
-                    children: [
-                      message.role === "agent" ? message.toolResults?.map((result) => /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(VisitorToolResultView, { result }, result.id)) : null,
-                      /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(
-                        MessageBubble,
-                        {
-                          message,
-                          bookingDisabled: isBusy,
-                          brandLogoUrl: showBrandLogo ? resolvedBrandLogoUrl : void 0,
-                          offer: index === transcriptMessages.length - 1 ? state.pendingOffer : void 0,
-                          onBook
-                        }
-                      ),
-                      index === lastAgentIndex && showMessageActions && message.role === "agent" ? /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(
-                        MessageActions,
-                        {
-                          answeredAt: message.createdAt,
-                          copyText: hideToolCardFences(message.text).trim() || message.text,
-                          readAloud,
-                          receiptSteps,
-                          onOpenReceipt: receiptSteps ? openReceipt : void 0,
-                          onRegenerate: onRegenerate ? handleRegenerate : void 0,
-                          onFeedback: onFeedback ? (rating) => onFeedback(rating, message) : void 0
-                        }
-                      ) : null,
-                      index === lastVisitorIndex ? /* @__PURE__ */ (0, import_jsx_runtime18.jsxs)(import_jsx_runtime18.Fragment, { children: [
-                        showActivity ? /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(
-                          AgentActivityBubble,
-                          {
-                            brandLabel: resolvedBrandLabel,
-                            brandLogoUrl: showBrandLogo ? resolvedBrandLogoUrl : void 0,
-                            failed: state.phase === "error",
-                            steps: activitySteps
-                          }
-                        ) : null,
-                        visibleVisitorToolResults.map((result) => /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(
-                          VisitorToolResultView,
-                          {
-                            result,
-                            disabled: semanticSurfaceDisabled,
-                            onToolInput
-                          },
-                          result.id
-                        )),
-                        pendingInputRequests.slice(0, 1).map((request) => /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(
-                          HumanInputCard,
-                          {
-                            request,
-                            onRespond: onInputResponse
-                          },
-                          request.requestId
-                        ))
-                      ] }) : null
-                    ]
-                  },
-                  message.role === "agent" && transcriptMessages[index - 1]?.role === "visitor" ? `answer-${transcriptMessages[index - 1]?.id}` : message.id
-                )),
-                waitingForBooking ? /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(BookingCardLoader, {}) : null,
-                state.error ? /* @__PURE__ */ (0, import_jsx_runtime18.jsxs)("section", { className: "agent-rail__error", role: "alert", children: [
-                  /* @__PURE__ */ (0, import_jsx_runtime18.jsxs)("div", { children: [
-                    /* @__PURE__ */ (0, import_jsx_runtime18.jsx)("strong", { children: "Something went wrong" }),
-                    /* @__PURE__ */ (0, import_jsx_runtime18.jsx)("p", { children: state.error })
-                  ] }),
-                  onRetry ? /* @__PURE__ */ (0, import_jsx_runtime18.jsx)("button", { type: "button", onClick: onRetry, children: "Try again" }) : null
-                ] }) : null
-              ] }) }),
-              showDisclaimerLabel ? /* @__PURE__ */ (0, import_jsx_runtime18.jsx)("div", { className: "agent-rail__disclaimer", children: /* @__PURE__ */ (0, import_jsx_runtime18.jsx)("p", { children: disclaimerLink ? /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(
-                "a",
+                  index === lastVisitorIndex ? /* @__PURE__ */ (0, import_jsx_runtime18.jsxs)(import_jsx_runtime18.Fragment, { children: [
+                    showActivity ? /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(
+                      AgentActivityBubble,
+                      {
+                        brandLabel: resolvedBrandLabel,
+                        brandLogoUrl: showBrandLogo ? resolvedBrandLogoUrl : void 0,
+                        failed: state.phase === "error",
+                        steps: activitySteps
+                      }
+                    ) : null,
+                    visibleVisitorToolResults.map((result) => /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(
+                      VisitorToolResultView,
+                      {
+                        result,
+                        disabled: semanticSurfaceDisabled,
+                        onToolInput
+                      },
+                      result.id
+                    )),
+                    pendingInputRequests.slice(0, 1).map((request) => /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(
+                      HumanInputCard,
+                      {
+                        request,
+                        onRespond: onInputResponse
+                      },
+                      request.requestId
+                    ))
+                  ] }) : null
+                ]
+              },
+              message.role === "agent" && transcriptMessages[index - 1]?.role === "visitor" ? `answer-${transcriptMessages[index - 1]?.id}` : message.id
+            )),
+            waitingForBooking ? /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(BookingCardLoader, {}) : null,
+            state.error ? /* @__PURE__ */ (0, import_jsx_runtime18.jsxs)("section", { className: "agent-rail__error", role: "alert", children: [
+              /* @__PURE__ */ (0, import_jsx_runtime18.jsxs)("div", { children: [
+                /* @__PURE__ */ (0, import_jsx_runtime18.jsx)("strong", { children: "Something went wrong" }),
+                /* @__PURE__ */ (0, import_jsx_runtime18.jsx)("p", { children: state.error })
+              ] }),
+              onRetry ? /* @__PURE__ */ (0, import_jsx_runtime18.jsx)("button", { type: "button", onClick: onRetry, children: "Try again" }) : null
+            ] }) : null
+          ] }) }),
+          showDisclaimerLabel ? /* @__PURE__ */ (0, import_jsx_runtime18.jsx)("div", { className: "agent-rail__disclaimer", children: /* @__PURE__ */ (0, import_jsx_runtime18.jsx)("p", { children: disclaimerLink ? /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(
+            "a",
+            {
+              href: disclaimerLink,
+              rel: "noopener noreferrer",
+              target: "_blank",
+              children: resolvedDisclaimerLabel
+            }
+          ) : resolvedDisclaimerLabel }) }) : null,
+          handoff && (handoff.page?.enabled || handoffActive) ? /* @__PURE__ */ (0, import_jsx_runtime18.jsxs)("div", { className: "agent-rail__handoff", children: [
+            /* @__PURE__ */ (0, import_jsx_runtime18.jsx)("p", { role: "status", "aria-live": "polite", children: !handoff.page ? "Checking conversation\u2026" : handoffStatus === "human" ? "Connected with support" : handoffStatus === "queued" ? "Waiting for a representative" : handoffStatus === "requesting" ? "Connecting you to support\u2026" : handoffStatus === "resolved" ? "Your conversation with support has ended" : handoffStatus === "failed" ? "We couldn\u2019t connect you to support" : "Need a person?" }),
+            handoffStatus === "ai" ? /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(
+              "button",
+              {
+                type: "button",
+                disabled: handoff.busy || handoff.hasPending || isBusy,
+                onClick: () => void handoff.start(),
+                children: "Talk to a person"
+              }
+            ) : null,
+            handoffStatus === "resolved" ? /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(
+              "button",
+              {
+                type: "button",
+                disabled: handoff.busy || handoff.hasPending,
+                onClick: () => void handoff.returnToAI(),
+                children: "Return to AI"
+              }
+            ) : null,
+            handoffStatus === "failed" && onReset ? /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(
+              "button",
+              {
+                type: "button",
+                disabled: !handoff.canReset,
+                onClick: handleReset,
+                children: "Start a new conversation"
+              }
+            ) : null,
+            handoff.error ? /* @__PURE__ */ (0, import_jsx_runtime18.jsxs)("div", { role: "alert", children: [
+              /* @__PURE__ */ (0, import_jsx_runtime18.jsx)("span", { children: handoff.error }),
+              /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(
+                "button",
                 {
-                  href: disclaimerLink,
-                  rel: "noopener noreferrer",
-                  target: "_blank",
-                  children: resolvedDisclaimerLabel
+                  type: "button",
+                  disabled: handoff.busy,
+                  onClick: () => void handoff.retry(),
+                  children: "Retry"
                 }
-              ) : resolvedDisclaimerLabel }) }) : null,
-              /* @__PURE__ */ (0, import_jsx_runtime18.jsxs)("div", { className: "agent-rail__composer-wrap", children: [
-                /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(
-                  LocationConsent,
-                  {
-                    request: locationRequest,
-                    onRespond: onInputResponse
-                  },
-                  state.messages.find((message) => message.role === "visitor")?.id ?? "empty"
-                ),
-                showJumpToLatest ? /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(
-                  "button",
-                  {
-                    type: "button",
-                    className: "agent-rail__jump-to-latest",
-                    "aria-label": "Jump to the latest message",
-                    title: "Jump to the latest message",
-                    onClick: scrollToLatest,
-                    children: /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(ChevronDownIcon, {})
-                  }
-                ) : null,
-                /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(
-                  Composer,
-                  {
-                    variant: expanded || mobileFullscreen ? "dock" : "default",
-                    disabled: isBusy,
-                    form: composerForm && lastMessage ? { ...composerForm, id: `${lastMessage.id}:${composerForm.id}` } : null,
-                    allowFormResume: !state.pendingOffer && !waitingForBooking && !hasPendingConfirmation,
-                    placeholder: composerPlaceholder,
-                    onSubmit: handleSubmit
-                  },
-                  `${state.messages.find((message) => message.role === "visitor")?.id ?? "empty"}:${latestResultId ?? ""}`
-                ),
-                poweredByLabel ? /* @__PURE__ */ (0, import_jsx_runtime18.jsx)("div", { className: "agent-rail__footer", children: /* @__PURE__ */ (0, import_jsx_runtime18.jsx)("p", { children: /* @__PURE__ */ (0, import_jsx_runtime18.jsx)("span", { children: poweredByLabel }) }) }) : null
-              ] })
-            ] }),
-            /* @__PURE__ */ (0, import_jsx_runtime18.jsx)("div", { ref: overlayRef, className: "agent-rail__overlay" }),
-            receiptOpen && receiptSteps ? /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(
-              AnswerReceiptDialog,
+              )
+            ] }) : null
+          ] }) : null,
+          /* @__PURE__ */ (0, import_jsx_runtime18.jsxs)("div", { className: "agent-rail__composer-wrap", children: [
+            /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(
+              LocationConsent,
+              {
+                request: locationRequest,
+                onRespond: onInputResponse
+              },
+              state.messages.find((message) => message.role === "visitor")?.id ?? "empty"
+            ),
+            showJumpToLatest ? /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(
+              "button",
               {
-                brandLabel: resolvedBrandLabel,
-                onClose: () => setReceiptOpen(false),
-                steps: receiptSteps
+                type: "button",
+                className: "agent-rail__jump-to-latest",
+                "aria-label": "Jump to the latest message",
+                title: "Jump to the latest message",
+                onClick: scrollToLatest,
+                children: /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(ChevronDownIcon, {})
               }
-            ) : null
-          ]
-        }
-      )
+            ) : null,
+            /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(
+              Composer,
+              {
+                variant: expanded || mobileFullscreen ? "dock" : "default",
+                disabled: isBusy || Boolean(handoff?.busy || handoff?.hasPending) || handoffActive && !["requesting", "queued", "human"].includes(
+                  handoffStatus ?? ""
+                ),
+                form: !handoffActive && composerForm && lastMessage ? {
+                  ...composerForm,
+                  id: `${lastMessage.id}:${composerForm.id}`
+                } : null,
+                allowFormResume: !handoffActive && !state.pendingOffer && !waitingForBooking && !hasPendingConfirmation,
+                placeholder: handoffActive ? "Message support\u2026" : composerPlaceholder,
+                onSubmit: handleSubmit
+              },
+              `${state.messages.find((message) => message.role === "visitor")?.id ?? "empty"}:${latestResultId ?? ""}`
+            ),
+            poweredByLabel ? /* @__PURE__ */ (0, import_jsx_runtime18.jsx)("div", { className: "agent-rail__footer", children: /* @__PURE__ */ (0, import_jsx_runtime18.jsx)("p", { children: /* @__PURE__ */ (0, import_jsx_runtime18.jsx)("span", { children: poweredByLabel }) }) }) : null
+          ] })
+        ] }),
+        /* @__PURE__ */ (0, import_jsx_runtime18.jsx)("div", { ref: overlayRef, className: "agent-rail__overlay" }),
+        receiptOpen && receiptSteps ? /* @__PURE__ */ (0, import_jsx_runtime18.jsx)(
+          AnswerReceiptDialog,
+          {
+            brandLabel: resolvedBrandLabel,
+            onClose: () => setReceiptOpen(false),
+            steps: receiptSteps
+          }
+        ) : null
+      ] })
     }
   );
 }
 
 // src/react/components/AssistEdgeTab/AssistEdgeTab.tsx
-var import_react16 = require("react");
+var import_react17 = require("react");
 var import_jsx_runtime19 = require("react/jsx-runtime");
 function ChatSparkIcon() {
   return /* @__PURE__ */ (0, import_jsx_runtime19.jsxs)(
@@ -7141,8 +7767,8 @@ function TabMarkIcon({
 }) {
   const custom = customIconUrl?.trim();
   const logo = logoUrl?.trim();
-  const [customFailed, setCustomFailed] = (0, import_react16.useState)(false);
-  const [logoFailed, setLogoFailed] = (0, import_react16.useState)(false);
+  const [customFailed, setCustomFailed] = (0, import_react17.useState)(false);
+  const [logoFailed, setLogoFailed] = (0, import_react17.useState)(false);
   if (custom && !customFailed) {
     return /* @__PURE__ */ (0, import_jsx_runtime19.jsx)(
       "img",
@@ -7330,8 +7956,8 @@ function findPrecedingVisitorText(messages, agentMessageId) {
   }
   return void 0;
 }
-function normalizeAgentFeedbackAnswerText(text2) {
-  const normalized = text2.replace(/\s+/g, " ").trim();
+function normalizeAgentFeedbackAnswerText(text3) {
+  const normalized = text3.replace(/\s+/g, " ").trim();
   if (!normalized) return void 0;
   return normalized.length > 4e3 ? `${normalized.slice(0, 3997)}...` : normalized;
 }
@@ -7391,9 +8017,9 @@ function AgentWidget({
 }) {
   const isMobile = useIsMobile();
   const placement = normalizeAgentPlacement(placementInput);
-  const railSlotRef = (0, import_react17.useRef)(null);
-  const [railCollapsed, setRailCollapsed] = (0, import_react17.useState)(defaultCollapsed);
-  const [railExpanded, setRailExpanded] = (0, import_react17.useState)(false);
+  const railSlotRef = (0, import_react18.useRef)(null);
+  const [railCollapsed, setRailCollapsed] = (0, import_react18.useState)(defaultCollapsed);
+  const [railExpanded, setRailExpanded] = (0, import_react18.useState)(false);
   const pageShiftActive = shouldApplyPageShift({
     pageShift,
     isMobile,
@@ -7446,7 +8072,7 @@ function AgentWidget({
     } : {},
     ...branding?.colors?.border ? { border: branding.colors.border } : {}
   };
-  (0, import_react17.useEffect)(() => {
+  (0, import_react18.useEffect)(() => {
     if (!registerPanelController) return;
     registerAgentPanelController(customerId, {
       open: () => setRailCollapsed(false),
@@ -7481,7 +8107,7 @@ function AgentWidget({
       })
     );
   }
-  (0, import_react17.useEffect)(() => {
+  (0, import_react18.useEffect)(() => {
     if (railCollapsed) return;
     const handleKeyDown = (event) => {
       if (event.key === "Tab" && (isMobile || railExpanded)) {
@@ -7591,7 +8217,7 @@ function AgentWidget({
 }
 
 // src/react/components/AgentTranscript/AgentTranscript.tsx
-var import_react18 = require("react");
+var import_react19 = require("react");
 
 // src/react/components/AgentTranscript/TranscriptActivity.tsx
 var import_jsx_runtime21 = require("react/jsx-runtime");
@@ -7659,9 +8285,9 @@ function groupTranscriptActivities(activities) {
       label: activity.createdAt < previous.startedAt ? activity.label : previous.label
     });
   }
-  return [...calls.values()].map(({ latest, id, startedAt, label }) => ({
+  return [...calls.values()].map(({ latest, id: id2, startedAt, label }) => ({
     ...latest,
-    id,
+    id: id2,
     label,
     createdAt: startedAt
   }));
@@ -7712,7 +8338,7 @@ function AgentTranscript({
         const previous = entries[index - 1];
         const validTimestamp = Number.isFinite(date.getTime());
         const showTimestamp = validTimestamp && (previous ? entry.createdAt - previous.createdAt >= 5 * 60 * 1e3 || date.toISOString().slice(0, 10) !== new Date(previous.createdAt).toJSON()?.slice(0, 10) : showInitialTimestamp);
-        return /* @__PURE__ */ (0, import_jsx_runtime22.jsxs)(import_react18.Fragment, { children: [
+        return /* @__PURE__ */ (0, import_jsx_runtime22.jsxs)(import_react19.Fragment, { children: [
           showTimestamp ? /* @__PURE__ */ (0, import_jsx_runtime22.jsx)("li", { className: "agent-transcript__time-marker", children: /* @__PURE__ */ (0, import_jsx_runtime22.jsx)("time", { dateTime: date.toISOString(), children: formatTimestamp(entry.createdAt) }) }) : null,
           entry.kind === "activity" ? /* @__PURE__ */ (0, import_jsx_runtime22.jsx)(TranscriptActivity, { activity: entry }) : /* @__PURE__ */ (0, import_jsx_runtime22.jsxs)(
             "li",