@webless/agent 0.10.4 → 0.12.0

package/dist/{chunk-74CSWSC5.js → chunk-EVWZF34F.js}

@@ -138,16 +138,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 } : {}
@@ -184,14 +184,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);
@@ -211,7 +211,7 @@ function parseAgentToolUiSurface(value) {
   }
   return {
     schemaVersion: AGENT_TOOL_UI_SCHEMA_VERSION,
-    id,
+    id: id2,
     title,
     toolSlug,
     fields,
@@ -391,14 +391,14 @@ function parseAgentSearchDiscoveryOutput(value) {
 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();
@@ -472,13 +472,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,
@@ -514,52 +514,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;
   }
@@ -574,8 +574,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 {
@@ -583,7 +583,7 @@ function resolveComposerForm(input) {
       fields: card.fields.slice(0, MAX_FORM_FIELDS)
     };
   }
-  return inferComposerForm(text2);
+  return inferComposerForm(text3);
 }
 
 // src/react/lib/tool-card.ts
@@ -597,9 +597,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) {
@@ -709,29 +709,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;
   }
@@ -744,9 +744,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);
@@ -755,8 +755,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 "";
@@ -876,10 +876,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 "";
@@ -1099,6 +1099,9 @@ function finalizeSummaryPresentation(result, proposed) {
   };
 }
 function presentVisitorToolResult(result, registry = []) {
+  if (result.toolName === "request_location") {
+    return { id: result.callId, toolName: result.toolName, status: result.status, kind: "hidden" };
+  }
   if (result.status === "completed" && toolResultFailed(result)) {
     result = { ...result, status: "failed" };
   }
@@ -1209,17 +1212,372 @@ function legacyBookingEnvelope(output) {
   } : null;
 }
 
+// src/react/hooks/useAgentHandoff.ts
+import { ClientError } from "eve/client";
+import { useEffect, useRef, useState } from "react";
+function useAgentHandoff(options) {
+  const [page, setPage] = useState(null);
+  const [busy, setBusy] = useState(false);
+  const [rejected, setRejected] = useState(false);
+  const [error, setError] = useState(null);
+  const callbacks = useRef(options);
+  callbacks.current = options;
+  const pending = useRef(null);
+  const inFlight = useRef(null);
+  const pageRef = useRef(null);
+  const refreshRef = useRef(null);
+  const generation = useRef(0);
+  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 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
-import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { useCallback, useEffect as useEffect2, useMemo, useRef as useRef2, useState as useState2 } from "react";
 
 // src/runtime/client.ts
 import {
   Client,
-  ClientError as ClientError2
+  ClientError as ClientError4
 } from "eve/client";
 
+// src/runtime/handoff.ts
+import { ClientError as ClientError3 } from "eve/client";
+
+// src/runtime/generated/handoff-contract.ts
+import { z } from "zod";
+var id = z.string().min(1).max(200);
+var sequence = z.number().int().min(0).max(Number.MAX_SAFE_INTEGER);
+var text2 = z.string().trim().min(1).max(16e3);
+var agentRuntimeHandoffVersion = "webless.ai/agent-runtime-handoff/v1";
+var agentRuntimeHandoffStatusSchema = z.enum([
+  "ai",
+  "requesting",
+  "queued",
+  "human",
+  "resolved",
+  "failed"
+]);
+var agentRuntimeHandoffActorSchema = z.strictObject({
+  id,
+  name: 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: z.iso.datetime()
+};
+var agentRuntimeHandoffEventSchema = z.discriminatedUnion("type", [
+  z.strictObject({
+    ...eventBase,
+    type: z.literal("status"),
+    status: agentRuntimeHandoffStatusSchema,
+    actor: agentRuntimeHandoffActorSchema.nullable()
+  }),
+  z.strictObject({
+    ...eventBase,
+    type: z.literal("visitor.message"),
+    message: text2,
+    operationId: id
+  }),
+  z.strictObject({
+    ...eventBase,
+    type: z.literal("human.message"),
+    message: text2,
+    actor: agentRuntimeHandoffActorSchema
+  })
+]);
+var agentRuntimeHandoffReadRequestSchema = z.strictObject({
+  after: sequence.default(0)
+});
+var agentRuntimeHandoffPageSchema = z.strictObject({
+  apiVersion: z.literal(agentRuntimeHandoffVersion),
+  sessionId: id,
+  enabled: z.boolean(),
+  status: agentRuntimeHandoffStatusSchema,
+  handoffId: id.nullable(),
+  epoch: sequence,
+  after: sequence,
+  cursor: sequence,
+  hasMore: z.boolean(),
+  events: 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 = z.strictObject({
+  operationId: id
+});
+var agentRuntimeHandoffCommandSchema = z.strictObject({
+  operationId: id,
+  handoffId: id,
+  epoch: sequence.refine((value) => value > 0)
+});
+var agentRuntimeHandoffMessageSchema = agentRuntimeHandoffCommandSchema.extend({ message: text2 });
+var agentRuntimeHandoffBindingSchema = z.strictObject({
+  tenantId: id,
+  indexId: id,
+  visitorSubject: id,
+  sessionId: id,
+  handoffId: id,
+  epoch: sequence.refine((value) => value > 0)
+});
+var providerEventBase = {
+  apiVersion: z.literal(agentRuntimeHandoffVersion),
+  binding: agentRuntimeHandoffBindingSchema,
+  eventId: id,
+  sequence: sequence.refine((value) => value > 0)
+};
+var agentRuntimeHandoffProviderEventSchema = z.discriminatedUnion(
+  "type",
+  [
+    z.strictObject({ ...providerEventBase, type: z.literal("queued") }),
+    z.strictObject({
+      ...providerEventBase,
+      type: z.literal("assigned"),
+      actor: agentRuntimeHandoffActorSchema
+    }),
+    z.strictObject({
+      ...providerEventBase,
+      type: z.literal("human.message"),
+      actor: agentRuntimeHandoffActorSchema,
+      message: text2
+    }),
+    z.strictObject({ ...providerEventBase, type: z.literal("resolved") }),
+    z.strictObject({ ...providerEventBase, type: z.literal("failed") })
+  ]
+);
+
 // src/runtime/capability.ts
-import { ClientError } from "eve/client";
+import { ClientError as ClientError2 } from "eve/client";
 var MAX_REFRESH_SKEW_MS = 3e4;
 var LOCAL_LOOPBACK_ORIGINS = [
   "http://127.0.0.1:3010",
@@ -1287,18 +1645,26 @@ function createAgentRuntimeCapability(options) {
         );
       }
     }
-    const bootstrapBody = JSON.stringify({
+    const bootstrapBody = {
       clientSessionId: options.visitorSessionId,
       indexId: options.indexId,
       ...previewBuildId ? { previewBuildId } : {},
       ...previewGrant ? { previewGrant } : {},
       version: options.version
-    });
-    const postBootstrap = (origin) => fetchImplementation(`${origin}/webless/v1/bootstrap`, {
-      body: bootstrapBody,
-      headers: { "content-type": "application/json" },
-      method: "POST"
-    });
+    };
+    const postBootstrap = async (origin) => {
+      const send = (advertiseLocation) => fetchImplementation(`${origin}/webless/v1/bootstrap`, {
+        body: JSON.stringify({ ...bootstrapBody, ...advertiseLocation ? { locationConsent: "v1" } : {} }),
+        headers: { "content-type": "application/json" },
+        method: "POST"
+      });
+      const response2 = await send(Boolean(options.locationConsent));
+      if (options.locationConsent && response2.status === 400) {
+        const error = await response2.clone().json().catch(() => null);
+        if (isRecord3(error) && error.code === "invalid_request") return send(false);
+      }
+      return response2;
+    };
     let response;
     let lastError;
     for (const origin of localBootstrapOrigins(options.runtimeOrigin)) {
@@ -1356,7 +1722,7 @@ async function withCapabilityRefresh(capability, request) {
   try {
     return await request();
   } catch (error) {
-    if (!(error instanceof ClientError) || error.status !== 401) {
+    if (!(error instanceof ClientError2) || error.status !== 401) {
       throw error;
     }
     capability.invalidate();
@@ -1364,6 +1730,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 ClientError3(
+        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(/\/+$/, "");
@@ -1833,6 +2268,7 @@ function specialistNameFromInput(input) {
   return match?.[1]?.trim() || void 0;
 }
 function requestedWorkItem(action) {
+  if (action.kind === "tool-call" && action.toolName === "request_location") return null;
   if (action.kind === "tool-call" && action.toolName === "search_discovery") {
     return {
       id: action.callId,
@@ -1938,13 +2374,14 @@ function applyWorkEvent(event, handlers, workItems) {
   );
 }
 var AgentSession = class {
-  constructor(indexId, version, runtimeOrigin, visitorSessionId, storeOptions, previewBuildId, getUnpublishedPreviewGrant) {
+  constructor(indexId, version, runtimeOrigin, visitorSessionId, storeOptions, previewBuildId, getUnpublishedPreviewGrant, locationConsent) {
     this.indexId = indexId;
     this.version = version;
     this.runtimeOrigin = runtimeOrigin;
     this.visitorSessionId = visitorSessionId;
     this.storeOptions = storeOptions;
     this.capability = createAgentRuntimeCapability({
+      locationConsent,
       getUnpublishedPreviewGrant,
       indexId,
       previewBuildId,
@@ -1952,6 +2389,11 @@ var AgentSession = class {
       version,
       visitorSessionId
     });
+    this.handoff = createHandoffClient({
+      getClient: () => this.ensureClient(),
+      getSessionId: () => this.getActiveSessionId(),
+      capability: this.capability
+    });
   }
   indexId;
   version;
@@ -1964,6 +2406,7 @@ var AgentSession = class {
   activeResponse;
   childStreams;
   capability;
+  handoff;
   getActiveSessionId() {
     return this.session?.state.sessionId ?? loadPersistedAgentSession(this.visitorSessionId, this.storeOptions)?.sessionId;
   }
@@ -2074,7 +2517,7 @@ var AgentSession = class {
           () => activeSession.send(message, { signal })
         );
       } catch (error) {
-        if (error instanceof ClientError2 && error.status === 409 && error.code === "session_not_active") {
+        if (error instanceof ClientError4 && error.status === 409 && error.code === "session_not_active") {
           clearPersistedAgentSession(this.visitorSessionId, this.storeOptions);
           this.session = void 0;
           session = void 0;
@@ -2248,10 +2691,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(
@@ -2336,10 +2779,12 @@ function createAgentClient(options) {
     visitorSessionId,
     storeOptions,
     options.previewBuildId,
-    options.getUnpublishedPreviewGrant
+    options.getUnpublishedPreviewGrant,
+    options.locationConsent
   );
   return {
     indexId,
+    handoff: session.handoff,
     version,
     runtimeOrigin,
     visitorSessionId,
@@ -2371,7 +2816,7 @@ function createAgentClient(options) {
 }
 
 // src/runtime/errors.ts
-import { ClientError as ClientError3 } from "eve/client";
+import { ClientError as ClientError5 } from "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) {
@@ -2383,7 +2828,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 ClientError3) {
+  if (error instanceof ClientError5) {
     if (error.status === 401 && error.code === "index_required") {
       return "Missing indexId \u2014 pass a published index id to createAgentClient().";
     }
@@ -2421,9 +2866,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,
@@ -2737,15 +3194,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);
@@ -2858,6 +3315,7 @@ function isJsonRecord(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value);
 }
 function useAgentChat({
+  handoffEnabled = false,
   customerId,
   getUnpublishedPreviewGrant,
   indexId,
@@ -2873,9 +3331,9 @@ function useAgentChat({
     () => createInitialState(greeting?.trim() || DEFAULT_GREETING),
     [greeting]
   );
-  const previewGrantProviderRef = useRef(getUnpublishedPreviewGrant);
+  const previewGrantProviderRef = useRef2(getUnpublishedPreviewGrant);
   previewGrantProviderRef.current = getUnpublishedPreviewGrant;
-  const toolResultRegistryRef = useRef(toolResultRegistry);
+  const toolResultRegistryRef = useRef2(toolResultRegistry);
   toolResultRegistryRef.current = toolResultRegistry;
   const resolveUnpublishedPreviewGrant = () => {
     const provider = previewGrantProviderRef.current;
@@ -2903,18 +3361,19 @@ function useAgentChat({
     }),
     [resolvedStorageKeyPrefix, visitorSessionId]
   );
-  const [state, setState] = useState(
+  const [state, setState] = useState2(
     () => stateFromConversation(
       loadPersistedAgentConversation(resolvedStorageKeyPrefix, visitorId),
       initialState
     )
   );
-  const pendingBookingRef = useRef(
+  const pendingBookingRef = useRef2(
     loadPendingWidgetBooking(resolvedStorageKeyPrefix, visitorId)
   );
-  const runRef = useRef(null);
-  const clientRef = useRef(
+  const runRef = useRef2(null);
+  const clientRef = useRef2(
     createAgentClient({
+      locationConsent: true,
       customerId,
       getUnpublishedPreviewGrant: resolveUnpublishedPreviewGrant,
       indexId,
@@ -2926,8 +3385,8 @@ function useAgentChat({
     })
   );
   const identityKey = `${customerId ?? ""}|${indexId}|${version ?? "published"}|${runtimeOrigin ?? ""}|${previewBuildId ?? ""}|${resolvedStorageKeyPrefix}|${visitorId}|${greeting ?? ""}`;
-  const identityRef = useRef(identityKey);
-  useEffect(() => {
+  const identityRef = useRef2(identityKey);
+  useEffect2(() => {
     if (identityRef.current === identityKey) {
       return;
     }
@@ -2935,6 +3394,7 @@ function useAgentChat({
     runRef.current?.abort();
     runRef.current = null;
     clientRef.current = createAgentClient({
+      locationConsent: true,
       customerId,
       getUnpublishedPreviewGrant: resolveUnpublishedPreviewGrant,
       indexId,
@@ -2965,7 +3425,7 @@ function useAgentChat({
     version,
     visitorId
   ]);
-  useEffect(() => {
+  useEffect2(() => {
     if (!hasVisitorMessages(state.messages)) return;
     savePersistedAgentConversation(resolvedStorageKeyPrefix, visitorId, {
       messages: state.messages,
@@ -2985,16 +3445,77 @@ function useAgentChat({
     state.toolResults,
     visitorId
   ]);
+  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 = useRef2(handoff.blocksAI);
+  handoffBlocksAI.current = handoff.blocksAI;
   const reset = 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]);
+  }, [
+    handoff.blocksAI,
+    handoff.canReset,
+    initialState,
+    resolvedStorageKeyPrefix,
+    visitorId
+  ]);
   const runTurn = useCallback(
     async (input) => {
+      if (handoffBlocksAI.current) return null;
       const {
         controller,
         initialText = "",
@@ -3118,6 +3639,7 @@ function useAgentChat({
           signal
         });
         if (resume && finalText === null) {
+          if (!isActiveRun() || handoffBlocksAI.current) return null;
           finalText = await clientRef.current.sendTurn(visitorText, {
             handlers,
             signal
@@ -3150,8 +3672,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"
@@ -3219,6 +3745,15 @@ function useAgentChat({
       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()
@@ -3320,9 +3855,10 @@ ${outgoing}` : outgoing;
         visitorText: runtimeText
       });
     },
-    [runTurn, state.pendingInputs]
+    [handoff, runTurn, state.pendingInputs]
   );
   const retry = useCallback(async () => {
+    if (handoffBlocksAI.current) return;
     const visitorMessage = [...state.messages].reverse().find((message) => message.role === "visitor");
     if (!visitorMessage) return;
     if (runRef.current) {
@@ -3356,6 +3892,7 @@ ${outgoing}` : outgoing;
     });
   }, [runTurn, state.messages]);
   const regenerate = 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") {
@@ -3413,7 +3950,7 @@ ${outgoing}` : outgoing;
   );
   const respondToInput = useCallback(
     async (response) => {
-      if (runRef.current) return;
+      if (handoffBlocksAI.current || runRef.current) return;
       const pending = state.pendingInputs?.find(
         (request) => request.requestId === response.requestId
       );
@@ -3441,7 +3978,8 @@ ${outgoing}` : outgoing;
     },
     [respondToToolInput, runTurn, state.pendingInputs]
   );
-  useEffect(() => {
+  useEffect2(() => {
+    if (handoff.blocksAI) return;
     const conversation = loadPersistedAgentConversation(
       resolvedStorageKeyPrefix,
       visitorId
@@ -3463,14 +4001,21 @@ ${outgoing}` : outgoing;
       }
       controller.abort();
     };
-  }, [identityKey, resolvedStorageKeyPrefix, runTurn, visitorId]);
-  useEffect(() => {
+  }, [
+    handoff.blocksAI,
+    identityKey,
+    resolvedStorageKeyPrefix,
+    runTurn,
+    visitorId
+  ]);
+  useEffect2(() => {
     return () => {
       runRef.current?.abort();
       runRef.current = null;
     };
   }, []);
   return {
+    handoff,
     state,
     reset,
     retry,
@@ -3581,12 +4126,12 @@ var defaultDarkAgentRailTheme = {
 };
 
 // src/react/components/MessageActions/MessageActions.tsx
-import { useEffect as useEffect2, useLayoutEffect, useRef as useRef2, useState as useState2 } from "react";
+import { useEffect as useEffect3, useLayoutEffect, useRef as useRef3, useState as useState3 } from "react";
 import { createPortal } from "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");
@@ -3931,12 +4476,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);
@@ -3987,16 +4532,16 @@ function MessageActions({
   speechText
 }) {
   const menuPortalRoot = useAgentRailMenuPortalRoot();
-  const [copied, setCopied] = useState2(false);
-  const [rating, setRating] = useState2(null);
-  const [menuOpen, setMenuOpen] = useState2(false);
-  const [menuPosition, setMenuPosition] = useState2(null);
-  const [speaking, setSpeaking] = useState2(false);
-  const [speechSupported, setSpeechSupported] = useState2(null);
-  const copyTimerRef = useRef2(null);
-  const menuRef = useRef2(null);
-  const portaledMenuRef = useRef2(null);
-  const moreButtonRef = useRef2(null);
+  const [copied, setCopied] = useState3(false);
+  const [rating, setRating] = useState3(null);
+  const [menuOpen, setMenuOpen] = useState3(false);
+  const [menuPosition, setMenuPosition] = useState3(null);
+  const [speaking, setSpeaking] = useState3(false);
+  const [speechSupported, setSpeechSupported] = useState3(null);
+  const copyTimerRef = useRef3(null);
+  const menuRef = useRef3(null);
+  const portaledMenuRef = useRef3(null);
+  const moreButtonRef = useRef3(null);
   const answeredLabel = formatAnsweredAt(answeredAt ?? 0);
   const resolvedSpeechText = speechText ?? toSpeechText(copyText);
   const canOpenReceipt = Boolean(receiptSteps) && Boolean(onOpenReceipt);
@@ -4023,7 +4568,7 @@ function MessageActions({
       })
     );
   }, [menuOpen, menuPortalRoot]);
-  useEffect2(() => {
+  useEffect3(() => {
     const unsubscribe = subscribeSpeechInterrupts(() => setSpeaking(false));
     return () => {
       unsubscribe();
@@ -4033,7 +4578,7 @@ function MessageActions({
       stopSpeech();
     };
   }, []);
-  useEffect2(() => {
+  useEffect3(() => {
     if (!menuOpen) return;
     const handlePointerDown = (event) => {
       const target = event.target;
@@ -4202,7 +4747,7 @@ function MessageActions({
 }
 
 // src/react/components/AgentRail/AgentRail.tsx
-import { useEffect as useEffect6, useRef as useRef6, useState as useState9 } from "react";
+import { useEffect as useEffect8, useRef as useRef8, useState as useState11 } from "react";
 
 // src/react/lib/agent-theme.ts
 function agentThemeStyle(theme, resolvedColorScheme) {
@@ -4277,7 +4822,7 @@ function resolveAgentColorScheme(colorScheme = "auto", prefersDarkMode) {
 }
 
 // src/react/components/AgentActivityBubble/AgentActivityBubble.tsx
-import { useState as useState3 } from "react";
+import { useState as useState4 } from "react";
 import { jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
 function joinLabels(labels) {
   if (labels.length <= 1) return labels[0] ?? "";
@@ -4396,7 +4941,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] = useState3(
+  const [expandedReceiptId, setExpandedReceiptId] = useState4(
     null
   );
   const detailsOpen = !active && expandedReceiptId === receiptId;
@@ -4447,7 +4992,7 @@ function AgentActivityBubble({
 }
 
 // src/react/components/AnswerReceiptDialog/AnswerReceiptDialog.tsx
-import { useEffect as useEffect3, useRef as useRef3 } from "react";
+import { useEffect as useEffect4, useRef as useRef4 } from "react";
 import { createPortal as createPortal2 } from "react-dom";
 import { jsx as jsx3, jsxs as jsxs3 } from "react/jsx-runtime";
 var FOCUSABLE_SELECTOR = 'button:not(:disabled), a[href], textarea:not(:disabled), input:not(:disabled), [tabindex]:not([tabindex="-1"])';
@@ -4469,10 +5014,10 @@ function AnswerReceiptDialog({
 }) {
   const portalRoots = useAgentRailPortalRoots();
   const overlayRoot = portalRoots?.overlayRef ?? null;
-  const cardRef = useRef3(null);
-  const closeButtonRef = useRef3(null);
-  const previouslyFocusedRef = useRef3(null);
-  useEffect3(() => {
+  const cardRef = useRef4(null);
+  const closeButtonRef = useRef4(null);
+  const previouslyFocusedRef = useRef4(null);
+  useEffect4(() => {
     previouslyFocusedRef.current = document.activeElement instanceof HTMLElement ? document.activeElement : null;
     closeButtonRef.current?.focus({ preventScroll: true });
     const handleKeyDown = (event) => {
@@ -4558,10 +5103,10 @@ function AnswerReceiptDialog({
 
 // src/react/components/Composer/Composer.tsx
 import {
-  useEffect as useEffect4,
+  useEffect as useEffect5,
   useId,
-  useRef as useRef4,
-  useState as useState4
+  useRef as useRef5,
+  useState as useState5
 } from "react";
 import { Fragment, jsx as jsx4, jsxs as jsxs4 } from "react/jsx-runtime";
 var FORM_SUBMITTED_MESSAGE = "Shared my details";
@@ -4624,17 +5169,17 @@ function Composer({
   allowFormResume = true,
   onSubmit
 }) {
-  const [value, setValue] = useState4("");
-  const [draft, setDraft] = useState4(() => createDraft(form));
-  const inputRef = useRef4(null);
-  const firstFieldRef = useRef4(null);
-  const formRef = useRef4(null);
+  const [value, setValue] = useState5("");
+  const [draft, setDraft] = useState5(() => createDraft(form));
+  const inputRef = useRef5(null);
+  const firstFieldRef = useRef5(null);
+  const formRef = useRef5(null);
   const formId = 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);
-  useEffect4(() => {
+  useEffect5(() => {
     if (activeForm) firstFieldRef.current?.focus();
     else if ((savedForm || draft.submitted) && !disabled)
       inputRef.current?.focus();
@@ -4895,7 +5440,7 @@ function FollowUpChips({
 }
 
 // src/react/components/MessageBubble/MessageBubble.tsx
-import { useState as useState6 } from "react";
+import { useState as useState7 } from "react";
 
 // src/react/components/SearchReferences/SearchReferences.tsx
 import { Fragment as Fragment2, jsx as jsx6, jsxs as jsxs6 } from "react/jsx-runtime";
@@ -4987,11 +5532,11 @@ function SearchReferences({
 
 // src/react/components/BookingCard/BookingCard.tsx
 import {
-  useEffect as useEffect5,
+  useEffect as useEffect6,
   useId as useId2,
   useMemo as useMemo2,
-  useRef as useRef5,
-  useState as useState5
+  useRef as useRef6,
+  useState as useState6
 } from "react";
 import { jsx as jsx7, jsxs as jsxs7 } from "react/jsx-runtime";
 var BOOKING_STEPS = [
@@ -5049,16 +5594,16 @@ function InteractiveBookingCard({
 }) {
   const fieldId = useId2();
   const defaultType = offer.eventTypes[0]?.uri ?? offer.slots[0]?.eventTypeUri ?? "";
-  const [step, setStep] = useState5("date");
-  const [eventTypeUri, setEventTypeUri] = useState5(defaultType);
-  const [selectedDate, setSelectedDate] = useState5("");
-  const [startTime, setStartTime] = useState5("");
-  const [name, setName] = useState5("");
-  const [email, setEmail] = useState5("");
-  const activeStepRef = useRef5(null);
-  const previousStepRef = useRef5(step);
+  const [step, setStep] = useState6("date");
+  const [eventTypeUri, setEventTypeUri] = useState6(defaultType);
+  const [selectedDate, setSelectedDate] = useState6("");
+  const [startTime, setStartTime] = useState6("");
+  const [name, setName] = useState6("");
+  const [email, setEmail] = useState6("");
+  const activeStepRef = useRef6(null);
+  const previousStepRef = useRef6(step);
   const stepIndex = BOOKING_STEPS.findIndex((item) => item.id === step);
-  useEffect5(() => {
+  useEffect6(() => {
     if (previousStepRef.current === step) return;
     previousStepRef.current = step;
     activeStepRef.current?.scrollIntoView({ block: "nearest" });
@@ -5075,7 +5620,7 @@ function InteractiveBookingCard({
     }
     return next;
   }, [slots]);
-  const [visibleMonth, setVisibleMonth] = useState5(
+  const [visibleMonth, setVisibleMonth] = useState6(
     () => firstAvailableBookingMonth(slots)
   );
   function selectEventType(nextType) {
@@ -5383,8 +5928,8 @@ function resolveMessageUrl(safeUrl, baseUrl) {
 // src/react/components/MessageBubble/MessageBubble.tsx
 import "streamdown/styles.css";
 import { jsx as jsx8, jsxs as jsxs8 } from "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);
@@ -5400,8 +5945,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]))) {
@@ -5422,13 +5967,14 @@ function MessageBubble({
   message,
   brandLogoUrl,
   bookingDisabled = false,
+  showProvenance = false,
   bookingReadOnly = false,
   linkBaseUrl,
   offer,
   onBook
 }) {
   const resolvedLogoUrl = brandLogoUrl?.trim();
-  const [failedLogoUrl, setFailedLogoUrl] = useState6(null);
+  const [failedLogoUrl, setFailedLogoUrl] = useState7(null);
   const showBrandLogo = Boolean(resolvedLogoUrl) && failedLogoUrl !== resolvedLogoUrl;
   const cards = message.role === "agent" ? extractToolCards(message.text) : [];
   const extractedOffers = cards.filter(
@@ -5443,7 +5989,34 @@ function MessageBubble({
   if (message.role === "visitor") {
     const visitorText = visitorMessageDisplayText(message).trim();
     if (!visitorText) return null;
-    return /* @__PURE__ */ jsx8("article", { className: "message-bubble message-bubble--visitor", children: /* @__PURE__ */ jsx8("p", { className: "message-bubble__text", children: visitorText }) });
+    return /* @__PURE__ */ jsxs8(
+      "article",
+      {
+        className: "message-bubble message-bubble--visitor",
+        "aria-label": "Message from visitor",
+        children: [
+          showProvenance ? /* @__PURE__ */ jsx8("span", { className: "message-bubble__speaker", children: "You \xB7 Visitor" }) : null,
+          /* @__PURE__ */ jsx8("p", { className: "message-bubble__text", children: visitorText })
+        ]
+      }
+    );
+  }
+  if (message.role === "human") {
+    return /* @__PURE__ */ jsxs8(
+      "article",
+      {
+        className: "message-bubble message-bubble--human",
+        "aria-label": `Message from ${message.representative.name}`,
+        children: [
+          /* @__PURE__ */ jsxs8("strong", { className: "message-bubble__representative", children: [
+            message.representative.name,
+            " ",
+            /* @__PURE__ */ jsx8("span", { children: "Human representative" })
+          ] }),
+          /* @__PURE__ */ jsx8("p", { className: "message-bubble__text", children: message.text })
+        ]
+      }
+    );
   }
   const citations = message.citations ?? [];
   const agentText = /* @__PURE__ */ jsxs8("div", { className: "message-bubble__text", children: [
@@ -5480,35 +6053,43 @@ function MessageBubble({
   ] });
   if (!displayText && !message.searchResults?.length && offers.length === 0)
     return null;
-  return /* @__PURE__ */ jsxs8("article", { className: "message-bubble message-bubble--agent", children: [
-    displayText || message.searchResults?.length ? showBrandLogo ? /* @__PURE__ */ jsxs8("div", { className: "message-bubble__agent-row", children: [
-      /* @__PURE__ */ jsx8("span", { className: "message-bubble__agent-avatar", "aria-hidden": "true", children: /* @__PURE__ */ jsx8(
-        "img",
-        {
-          src: resolvedLogoUrl,
-          alt: "",
-          onError: () => {
-            setFailedLogoUrl(resolvedLogoUrl ?? null);
-          }
-        }
-      ) }),
-      agentText
-    ] }) : agentText : null,
-    offers.map((nextOffer, index) => /* @__PURE__ */ jsx8(
-      BookingCard,
-      {
-        disabled: bookingDisabled,
-        readOnly: bookingReadOnly,
-        offer: nextOffer,
-        onBook
-      },
-      `${bookingOfferIdentityKey(nextOffer)}-${index}`
-    ))
-  ] });
+  return /* @__PURE__ */ jsxs8(
+    "article",
+    {
+      className: "message-bubble message-bubble--agent",
+      "aria-label": "Message from AI assistant",
+      children: [
+        showProvenance ? /* @__PURE__ */ jsx8("span", { className: "message-bubble__speaker", children: "AI assistant" }) : null,
+        displayText || message.searchResults?.length ? showBrandLogo ? /* @__PURE__ */ jsxs8("div", { className: "message-bubble__agent-row", children: [
+          /* @__PURE__ */ jsx8("span", { className: "message-bubble__agent-avatar", "aria-hidden": "true", children: /* @__PURE__ */ jsx8(
+            "img",
+            {
+              src: resolvedLogoUrl,
+              alt: "",
+              onError: () => {
+                setFailedLogoUrl(resolvedLogoUrl ?? null);
+              }
+            }
+          ) }),
+          agentText
+        ] }) : agentText : null,
+        offers.map((nextOffer, index) => /* @__PURE__ */ jsx8(
+          BookingCard,
+          {
+            disabled: bookingDisabled,
+            readOnly: bookingReadOnly,
+            offer: nextOffer,
+            onBook
+          },
+          `${bookingOfferIdentityKey(nextOffer)}-${index}`
+        ))
+      ]
+    }
+  );
 }
 
 // src/react/components/HumanInputCard/HumanInputCard.tsx
-import { useState as useState8 } from "react";
+import { useState as useState9 } from "react";
 
 // src/react/components/ConfirmationCard/ConfirmationCard.tsx
 import { jsx as jsx9, jsxs as jsxs9 } from "react/jsx-runtime";
@@ -5550,7 +6131,7 @@ function ConfirmationCard({
 }
 
 // src/react/components/ToolInputCard/ToolInputCard.tsx
-import { useState as useState7 } from "react";
+import { useState as useState8 } from "react";
 import { jsx as jsx10, jsxs as jsxs10 } from "react/jsx-runtime";
 function isRecord5(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value);
@@ -5673,13 +6254,13 @@ function valuesMatch(left, right) {
 }
 function FieldDescription({
   field,
-  id
+  id: id2
 }) {
-  return field.description ? /* @__PURE__ */ jsx10("span", { id, className: "tool-input-card__description", children: field.description }) : null;
+  return field.description ? /* @__PURE__ */ jsx10("span", { id: id2, className: "tool-input-card__description", children: field.description }) : null;
 }
 function ChoiceField({
   field,
-  id,
+  id: id2,
   value,
   disabled,
   describedBy,
@@ -5697,7 +6278,7 @@ function ChoiceField({
     return /* @__PURE__ */ jsxs10(
       "select",
       {
-        id,
+        id: id2,
         value: selectedIndex >= 0 ? String(selectedIndex) : "",
         disabled,
         required: field.required,
@@ -5720,7 +6301,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,
@@ -5731,7 +6312,7 @@ function ChoiceField({
             "input",
             {
               type: multiple ? "checkbox" : "radio",
-              name: id,
+              name: id2,
               value: String(index),
               checked,
               disabled,
@@ -5759,22 +6340,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__ */ jsxs10("div", { className: "tool-input-card__field", children: [
-      /* @__PURE__ */ jsxs10("label", { className: "tool-input-card__check", htmlFor: id, children: [
+      /* @__PURE__ */ jsxs10("label", { className: "tool-input-card__check", htmlFor: id2, children: [
         /* @__PURE__ */ jsx10(
           "input",
           {
-            id,
+            id: id2,
             type: "checkbox",
             checked: value === true,
             disabled,
@@ -5786,18 +6367,18 @@ function ToolField({
         ),
         /* @__PURE__ */ jsxs10("span", { children: [
           /* @__PURE__ */ jsx10("strong", { children: field.label }),
-          field.description ? /* @__PURE__ */ jsx10("span", { id: `${id}-description`, children: field.description }) : null
+          field.description ? /* @__PURE__ */ jsx10("span", { id: `${id2}-description`, children: field.description }) : null
         ] })
       ] }),
-      error ? /* @__PURE__ */ jsx10("span", { id: `${id}-error`, className: "tool-input-card__error", children: error }) : null
+      error ? /* @__PURE__ */ jsx10("span", { id: `${id2}-error`, className: "tool-input-card__error", children: error }) : null
     ] });
   }
-  const label = /* @__PURE__ */ jsxs10("label", { id: `${id}-label`, htmlFor: id, children: [
+  const label = /* @__PURE__ */ jsxs10("label", { id: `${id2}-label`, htmlFor: id2, children: [
     field.label,
     field.required ? /* @__PURE__ */ jsx10("span", { "aria-hidden": "true", children: " *" }) : null
   ] });
   const common = {
-    id,
+    id: id2,
     disabled,
     required: field.required,
     "aria-describedby": describedBy || void 0,
@@ -5810,7 +6391,7 @@ function ToolField({
       ChoiceField,
       {
         field,
-        id,
+        id: id2,
         value,
         disabled,
         describedBy: describedBy || void 0,
@@ -5847,7 +6428,7 @@ function ToolField({
           onChange: (event) => onChange(Number(event.target.value))
         }
       ),
-      /* @__PURE__ */ jsx10("output", { htmlFor: id, children: numericValue })
+      /* @__PURE__ */ jsx10("output", { htmlFor: id2, children: numericValue })
     ] });
   } else {
     const type = field.kind === "date-time" ? "datetime-local" : field.kind === "calendar" ? "date" : field.kind;
@@ -5871,9 +6452,9 @@ function ToolField({
   }
   return /* @__PURE__ */ jsxs10("div", { className: "tool-input-card__field", children: [
     label,
-    /* @__PURE__ */ jsx10(FieldDescription, { field, id: `${id}-description` }),
+    /* @__PURE__ */ jsx10(FieldDescription, { field, id: `${id2}-description` }),
     control,
-    error ? /* @__PURE__ */ jsx10("span", { id: `${id}-error`, className: "tool-input-card__error", children: error }) : null
+    error ? /* @__PURE__ */ jsx10("span", { id: `${id2}-error`, className: "tool-input-card__error", children: error }) : null
   ] });
 }
 function ToolInputCard({
@@ -5881,11 +6462,11 @@ function ToolInputCard({
   surface,
   onSubmit
 }) {
-  const [values, setValues] = useState7(
+  const [values, setValues] = useState8(
     () => initialValues(surface)
   );
-  const [touched, setTouched] = useState7(() => /* @__PURE__ */ new Set());
-  const [submitted, setSubmitted] = useState7(false);
+  const [touched, setTouched] = useState8(() => /* @__PURE__ */ new Set());
+  const [submitted, setSubmitted] = useState8(false);
   const errors = Object.fromEntries(
     surface.fields.map((field) => [
       field.path,
@@ -5978,7 +6559,7 @@ function HumanInputCard({
   request,
   onRespond
 }) {
-  const [text2, setText] = useState8("");
+  const [text3, setText] = useState9("");
   const options = request.options ?? [];
   const showText = request.display === "text" || request.allowFreeform && options.length === 0;
   if (request.ui) {
@@ -6003,7 +6584,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 });
   }
@@ -6021,12 +6602,12 @@ function HumanInputCard({
               "input",
               {
                 id: `human-input-text-${request.requestId}`,
-                value: text2,
+                value: text3,
                 disabled,
                 onChange: (event) => setText(event.target.value)
               }
             ),
-            /* @__PURE__ */ jsx11("button", { type: "submit", disabled: disabled || !text2.trim(), children: "Send" })
+            /* @__PURE__ */ jsx11("button", { type: "submit", disabled: disabled || !text3.trim(), children: "Send" })
           ] })
         ] }) : null,
         !showText && options.length === 0 ? /* @__PURE__ */ jsx11("p", { className: "human-input-card__unavailable", role: "status", children: "This request can\u2019t be answered here." }) : null
@@ -6035,31 +6616,173 @@ function HumanInputCard({
   );
 }
 
-// src/react/components/CollectionResultCard/CollectionResultCard.tsx
+// src/react/components/LocationConsent/LocationConsent.tsx
+import { useEffect as useEffect7, useRef as useRef7, useState as useState10 } from "react";
+
+// src/runtime/location-consent.ts
+function isLocationConsentRequest(request) {
+  return request.kind === "tool-approval" && request.action.toolName === "request_location";
+}
+function preciseLocationResponse(requestId, position) {
+  const { latitude, longitude, accuracy } = position.coords;
+  if (!Number.isFinite(latitude) || latitude < -90 || latitude > 90 || !Number.isFinite(longitude) || longitude < -180 || longitude > 180 || !Number.isFinite(accuracy) || accuracy < 0 || !Number.isFinite(position.timestamp)) {
+    throw new Error("Your device returned an invalid location.");
+  }
+  return {
+    requestId,
+    optionId: "approve",
+    text: JSON.stringify({
+      status: "shared",
+      location: {
+        source: "device",
+        latitude,
+        longitude,
+        accuracyMeters: accuracy,
+        capturedAt: new Date(position.timestamp).toISOString(),
+        consentedAt: (/* @__PURE__ */ new Date()).toISOString(),
+        scope: "conversation"
+      }
+    })
+  };
+}
+function getPreciseLocation(geolocation) {
+  return new Promise(
+    (resolve, reject) => geolocation.getCurrentPosition(
+      resolve,
+      (error) => reject(
+        new Error(
+          error.code === 1 ? "Location access is blocked. Allow it in your browser, or continue without sharing." : "Your location couldn\u2019t be found. Try again or continue without sharing."
+        )
+      ),
+      { enableHighAccuracy: true, maximumAge: 0, timeout: 1e4 }
+    )
+  );
+}
+
+// src/react/components/LocationConsent/LocationConsent.tsx
 import { jsx as jsx12, jsxs as jsxs12 } from "react/jsx-runtime";
+function LocationConsent({
+  request,
+  onRespond
+}) {
+  const [preference, setPreference] = useState10("unset");
+  const [locating, setLocating] = useState10(false);
+  const [error, setError] = useState10(null);
+  const respond = useRef7(onRespond);
+  const answered = useRef7(null);
+  const requestId = request?.requestId;
+  useEffect7(() => {
+    respond.current = onRespond;
+  }, [onRespond]);
+  useEffect7(() => {
+    if (!requestId || preference === "unset" || answered.current === requestId || !respond.current)
+      return;
+    if (preference === "off") {
+      setLocating(false);
+      answered.current = requestId;
+      respond.current({
+        requestId,
+        optionId: "approve",
+        text: JSON.stringify({ status: "declined" })
+      });
+      return;
+    }
+    let cancelled = false;
+    const pendingId = requestId;
+    setLocating(true);
+    setError(null);
+    async function locate() {
+      try {
+        if (!Reflect.has(navigator, "geolocation"))
+          throw new Error("Location sharing isn\u2019t available in this browser.");
+        const position = await getPreciseLocation(navigator.geolocation);
+        if (cancelled) return;
+        const response = preciseLocationResponse(pendingId, position);
+        answered.current = pendingId;
+        respond.current?.(response);
+      } catch (failure) {
+        if (cancelled) return;
+        setPreference("unset");
+        setError(
+          failure instanceof Error ? failure.message : "Location sharing failed. Try again or continue without sharing."
+        );
+      } finally {
+        if (!cancelled) setLocating(false);
+      }
+    }
+    void locate();
+    return () => {
+      cancelled = true;
+    };
+  }, [requestId, preference]);
+  const isLocating = Boolean(requestId) && preference === "on" && locating;
+  if (!request && preference === "unset") return null;
+  return /* @__PURE__ */ jsxs12("section", { className: "location-consent", "aria-label": "Location sharing", children: [
+    /* @__PURE__ */ jsxs12("div", { className: "location-consent__copy", children: [
+      /* @__PURE__ */ jsx12("strong", { children: isLocating ? "Getting your location\u2026" : request ? "Get better results" : "Precise location" }),
+      /* @__PURE__ */ jsx12("span", { children: isLocating ? "Allow location access in your browser." : request ? "Share your precise location" : preference === "on" ? "On for location-aware answers" : "Off for this chat" })
+    ] }),
+    /* @__PURE__ */ jsxs12("div", { className: "location-consent__actions", children: [
+      /* @__PURE__ */ jsx12(
+        "button",
+        {
+          type: "button",
+          role: "switch",
+          className: "location-consent__toggle",
+          "aria-label": "Share precise location",
+          "aria-checked": preference === "on",
+          "aria-busy": isLocating,
+          disabled: !onRespond,
+          onClick: () => {
+            setError(null);
+            setPreference(preference === "on" ? "off" : "on");
+          },
+          children: /* @__PURE__ */ jsx12("span", {})
+        }
+      ),
+      request && /* @__PURE__ */ jsx12(
+        "button",
+        {
+          type: "button",
+          className: "location-consent__decline",
+          disabled: !onRespond,
+          onClick: () => {
+            setError(null);
+            setPreference("off");
+          },
+          children: "No thanks"
+        }
+      )
+    ] }),
+    error && /* @__PURE__ */ jsx12("p", { role: "alert", className: "location-consent__error", children: error })
+  ] });
+}
+
+// src/react/components/CollectionResultCard/CollectionResultCard.tsx
+import { jsx as jsx13, jsxs as jsxs13 } from "react/jsx-runtime";
 function CollectionResultCard({
   result
 }) {
   const empty = result.items.length === 0;
-  return /* @__PURE__ */ jsxs12(
+  return /* @__PURE__ */ jsxs13(
     "section",
     {
       className: `collection-result-card tool-result-card tool-result-card--${result.status}`,
       "aria-label": result.title,
       role: result.status === "completed" ? "status" : "alert",
       children: [
-        /* @__PURE__ */ jsxs12("div", { className: "tool-result-card__heading", children: [
-          /* @__PURE__ */ jsx12("span", { className: "tool-result-card__status", "aria-hidden": "true" }),
-          /* @__PURE__ */ jsx12("strong", { children: result.title })
+        /* @__PURE__ */ jsxs13("div", { className: "tool-result-card__heading", children: [
+          /* @__PURE__ */ jsx13("span", { className: "tool-result-card__status", "aria-hidden": "true" }),
+          /* @__PURE__ */ jsx13("strong", { children: result.title })
         ] }),
-        empty ? /* @__PURE__ */ jsx12("p", { className: "collection-result-card__empty", children: "No matching record for the email you shared." }) : /* @__PURE__ */ jsx12("ul", { className: "collection-result-card__list", children: result.items.map((item) => /* @__PURE__ */ jsxs12("li", { children: [
-          /* @__PURE__ */ jsx12("div", { className: "collection-result-card__item-title", children: item.title }),
-          item.description ? /* @__PURE__ */ jsx12("p", { children: item.description }) : null,
-          item.details?.length ? /* @__PURE__ */ jsx12("dl", { children: item.details.map((detail) => /* @__PURE__ */ jsxs12("div", { children: [
-            /* @__PURE__ */ jsx12("dt", { children: detail.label }),
-            /* @__PURE__ */ jsx12("dd", { children: detail.value })
+        empty ? /* @__PURE__ */ jsx13("p", { className: "collection-result-card__empty", children: "No matching record for the email you shared." }) : /* @__PURE__ */ jsx13("ul", { className: "collection-result-card__list", children: result.items.map((item) => /* @__PURE__ */ jsxs13("li", { children: [
+          /* @__PURE__ */ jsx13("div", { className: "collection-result-card__item-title", children: item.title }),
+          item.description ? /* @__PURE__ */ jsx13("p", { children: item.description }) : null,
+          item.details?.length ? /* @__PURE__ */ jsx13("dl", { children: item.details.map((detail) => /* @__PURE__ */ jsxs13("div", { children: [
+            /* @__PURE__ */ jsx13("dt", { children: detail.label }),
+            /* @__PURE__ */ jsx13("dd", { children: detail.value })
           ] }, `${detail.label}:${detail.value}`)) }) : null,
-          item.href ? /* @__PURE__ */ jsx12("a", { href: item.href, target: "_blank", rel: "noreferrer", children: "Open record" }) : null
+          item.href ? /* @__PURE__ */ jsx13("a", { href: item.href, target: "_blank", rel: "noreferrer", children: "Open record" }) : null
         ] }, item.title)) })
       ]
     }
@@ -6067,23 +6790,23 @@ function CollectionResultCard({
 }
 
 // src/react/components/EntityResultCard/EntityResultCard.tsx
-import { Fragment as Fragment3, jsx as jsx13, jsxs as jsxs13 } from "react/jsx-runtime";
+import { Fragment as Fragment3, jsx as jsx14, jsxs as jsxs14 } from "react/jsx-runtime";
 function EntityResultCard({
   result
 }) {
   const compact = !result.description && !result.details?.length && !result.links?.length;
   const collapsible = result.status === "completed" && Boolean(result.details?.length) && !result.links?.length;
-  const heading = /* @__PURE__ */ jsxs13("span", { className: "tool-result-card__heading", children: [
-    /* @__PURE__ */ jsx13("span", { className: "tool-result-card__status", "aria-hidden": "true" }),
-    /* @__PURE__ */ jsx13("strong", { children: result.title })
+  const heading = /* @__PURE__ */ jsxs14("span", { className: "tool-result-card__heading", children: [
+    /* @__PURE__ */ jsx14("span", { className: "tool-result-card__status", "aria-hidden": "true" }),
+    /* @__PURE__ */ jsx14("strong", { children: result.title })
   ] });
-  const content = /* @__PURE__ */ jsxs13(Fragment3, { children: [
-    result.description ? /* @__PURE__ */ jsx13("p", { children: result.description }) : null,
-    result.details?.length ? /* @__PURE__ */ jsx13("dl", { children: result.details.map((detail) => /* @__PURE__ */ jsxs13("div", { children: [
-      /* @__PURE__ */ jsx13("dt", { children: detail.label }),
-      /* @__PURE__ */ jsx13("dd", { children: detail.value })
+  const content = /* @__PURE__ */ jsxs14(Fragment3, { children: [
+    result.description ? /* @__PURE__ */ jsx14("p", { children: result.description }) : null,
+    result.details?.length ? /* @__PURE__ */ jsx14("dl", { children: result.details.map((detail) => /* @__PURE__ */ jsxs14("div", { children: [
+      /* @__PURE__ */ jsx14("dt", { children: detail.label }),
+      /* @__PURE__ */ jsx14("dd", { children: detail.value })
     ] }, `${detail.label}:${detail.value}`)) }) : null,
-    result.links?.length ? /* @__PURE__ */ jsx13("div", { className: "tool-result-card__links", children: result.links.map((link) => /* @__PURE__ */ jsx13(
+    result.links?.length ? /* @__PURE__ */ jsx14("div", { className: "tool-result-card__links", children: result.links.map((link) => /* @__PURE__ */ jsx14(
       "a",
       {
         href: link.href,
@@ -6095,12 +6818,12 @@ function EntityResultCard({
     )) }) : null
   ] });
   if (collapsible) {
-    return /* @__PURE__ */ jsxs13("details", { className: "entity-result-card tool-result-card entity-result-card--disclosure", children: [
-      /* @__PURE__ */ jsx13("summary", { children: /* @__PURE__ */ jsx13("span", { role: "status", children: heading }) }),
+    return /* @__PURE__ */ jsxs14("details", { className: "entity-result-card tool-result-card entity-result-card--disclosure", children: [
+      /* @__PURE__ */ jsx14("summary", { children: /* @__PURE__ */ jsx14("span", { role: "status", children: heading }) }),
       content
     ] });
   }
-  return /* @__PURE__ */ jsxs13(
+  return /* @__PURE__ */ jsxs14(
     "section",
     {
       className: `entity-result-card tool-result-card tool-result-card--${result.status}${compact ? " entity-result-card--compact" : ""}`,
@@ -6115,24 +6838,24 @@ function EntityResultCard({
 }
 
 // src/react/components/SignatureResultCard/SignatureResultCard.tsx
-import { jsx as jsx14, jsxs as jsxs14 } from "react/jsx-runtime";
+import { jsx as jsx15, jsxs as jsxs15 } from "react/jsx-runtime";
 function SignatureResultCard({
   result
 }) {
   const primaryLink = result.links?.[0];
-  return /* @__PURE__ */ jsxs14(
+  return /* @__PURE__ */ jsxs15(
     "section",
     {
       className: `signature-result-card tool-result-card tool-result-card--${result.status}`,
       "aria-label": result.title,
       children: [
-        /* @__PURE__ */ jsxs14("div", { className: "tool-result-card__heading", children: [
-          /* @__PURE__ */ jsx14("span", { className: "tool-result-card__status", "aria-hidden": "true" }),
-          /* @__PURE__ */ jsx14("strong", { children: result.title })
+        /* @__PURE__ */ jsxs15("div", { className: "tool-result-card__heading", children: [
+          /* @__PURE__ */ jsx15("span", { className: "tool-result-card__status", "aria-hidden": "true" }),
+          /* @__PURE__ */ jsx15("strong", { children: result.title })
         ] }),
-        result.statusLabel ? /* @__PURE__ */ jsx14("span", { className: "signature-result-card__badge", children: result.statusLabel }) : null,
-        result.description ? /* @__PURE__ */ jsx14("p", { children: result.description }) : null,
-        primaryLink ? /* @__PURE__ */ jsx14(
+        result.statusLabel ? /* @__PURE__ */ jsx15("span", { className: "signature-result-card__badge", children: result.statusLabel }) : null,
+        result.description ? /* @__PURE__ */ jsx15("p", { children: result.description }) : null,
+        primaryLink ? /* @__PURE__ */ jsx15(
           "a",
           {
             className: "signature-result-card__cta",
@@ -6148,27 +6871,27 @@ function SignatureResultCard({
 }
 
 // src/react/components/ToolResultCard/ToolResultCard.tsx
-import { jsx as jsx15, jsxs as jsxs15 } from "react/jsx-runtime";
+import { jsx as jsx16, jsxs as jsxs16 } from "react/jsx-runtime";
 function ToolResultCard({
   result
 }) {
-  return /* @__PURE__ */ jsxs15(
+  return /* @__PURE__ */ jsxs16(
     "section",
     {
       className: `tool-result-card tool-result-card--${result.status}`,
       "aria-label": result.title,
       role: result.status === "completed" ? "status" : "alert",
       children: [
-        /* @__PURE__ */ jsxs15("div", { className: "tool-result-card__heading", children: [
-          /* @__PURE__ */ jsx15("span", { className: "tool-result-card__status", "aria-hidden": "true" }),
-          /* @__PURE__ */ jsx15("strong", { children: result.title })
+        /* @__PURE__ */ jsxs16("div", { className: "tool-result-card__heading", children: [
+          /* @__PURE__ */ jsx16("span", { className: "tool-result-card__status", "aria-hidden": "true" }),
+          /* @__PURE__ */ jsx16("strong", { children: result.title })
         ] }),
-        result.description ? /* @__PURE__ */ jsx15("p", { children: result.description }) : null,
-        result.details?.length ? /* @__PURE__ */ jsx15("dl", { children: result.details.map((detail) => /* @__PURE__ */ jsxs15("div", { children: [
-          /* @__PURE__ */ jsx15("dt", { children: detail.label }),
-          /* @__PURE__ */ jsx15("dd", { children: detail.value })
+        result.description ? /* @__PURE__ */ jsx16("p", { children: result.description }) : null,
+        result.details?.length ? /* @__PURE__ */ jsx16("dl", { children: result.details.map((detail) => /* @__PURE__ */ jsxs16("div", { children: [
+          /* @__PURE__ */ jsx16("dt", { children: detail.label }),
+          /* @__PURE__ */ jsx16("dd", { children: detail.value })
         ] }, `${detail.label}:${detail.value}`)) }) : null,
-        result.links?.length ? /* @__PURE__ */ jsx15("div", { className: "tool-result-card__links", children: result.links.map((link) => /* @__PURE__ */ jsx15(
+        result.links?.length ? /* @__PURE__ */ jsx16("div", { className: "tool-result-card__links", children: result.links.map((link) => /* @__PURE__ */ jsx16(
           "a",
           {
             href: link.href,
@@ -6184,14 +6907,14 @@ function ToolResultCard({
 }
 
 // src/react/components/VisitorToolResultView/VisitorToolResultView.tsx
-import { jsx as jsx16 } from "react/jsx-runtime";
+import { jsx as jsx17 } from "react/jsx-runtime";
 function VisitorToolResultView({
   disabled = false,
   onToolInput,
   result
 }) {
   if (result.kind === "input") {
-    return /* @__PURE__ */ jsx16(
+    return /* @__PURE__ */ jsx17(
       ToolInputCard,
       {
         disabled,
@@ -6201,16 +6924,16 @@ function VisitorToolResultView({
     );
   }
   if (result.kind === "entity") {
-    return /* @__PURE__ */ jsx16(EntityResultCard, { result });
+    return /* @__PURE__ */ jsx17(EntityResultCard, { result });
   }
   if (result.kind === "collection") {
-    return /* @__PURE__ */ jsx16(CollectionResultCard, { result });
+    return /* @__PURE__ */ jsx17(CollectionResultCard, { result });
   }
   if (result.kind === "signature") {
-    return /* @__PURE__ */ jsx16(SignatureResultCard, { result });
+    return /* @__PURE__ */ jsx17(SignatureResultCard, { result });
   }
   if (result.kind === "summary") {
-    return /* @__PURE__ */ jsx16(ToolResultCard, { result });
+    return /* @__PURE__ */ jsx17(ToolResultCard, { result });
   }
   return null;
 }
@@ -6219,9 +6942,9 @@ function isRenderableVisitorToolResult(result) {
 }
 
 // src/react/components/AgentRail/AgentRail.tsx
-import { Fragment as Fragment4, jsx as jsx17, jsxs as jsxs16 } from "react/jsx-runtime";
+import { Fragment as Fragment4, jsx as jsx18, jsxs as jsxs17 } from "react/jsx-runtime";
 function MinimizeIcon() {
-  return /* @__PURE__ */ jsx17("svg", { viewBox: "0 0 16 16", fill: "none", "aria-hidden": "true", children: /* @__PURE__ */ jsx17(
+  return /* @__PURE__ */ jsx18("svg", { viewBox: "0 0 16 16", fill: "none", "aria-hidden": "true", children: /* @__PURE__ */ jsx18(
     "path",
     {
       d: "M3.5 8h9",
@@ -6232,7 +6955,7 @@ function MinimizeIcon() {
   ) });
 }
 function CloseIcon2() {
-  return /* @__PURE__ */ jsx17("svg", { viewBox: "0 0 16 16", fill: "none", "aria-hidden": "true", children: /* @__PURE__ */ jsx17(
+  return /* @__PURE__ */ jsx18("svg", { viewBox: "0 0 16 16", fill: "none", "aria-hidden": "true", children: /* @__PURE__ */ jsx18(
     "path",
     {
       d: "M4 4l8 8M12 4l-8 8",
@@ -6243,7 +6966,7 @@ function CloseIcon2() {
   ) });
 }
 function NewChatIcon() {
-  return /* @__PURE__ */ jsx17("svg", { viewBox: "0 0 16 16", fill: "none", "aria-hidden": "true", children: /* @__PURE__ */ jsx17(
+  return /* @__PURE__ */ jsx18("svg", { viewBox: "0 0 16 16", fill: "none", "aria-hidden": "true", children: /* @__PURE__ */ jsx18(
     "path",
     {
       d: "M9.5 3.5h3v3M12.25 3.75 8 8M7 4H4.5A1.5 1.5 0 0 0 3 5.5v6A1.5 1.5 0 0 0 4.5 13h6a1.5 1.5 0 0 0 1.5-1.5V9",
@@ -6255,7 +6978,7 @@ function NewChatIcon() {
   ) });
 }
 function ExpandIcon() {
-  return /* @__PURE__ */ jsx17("svg", { viewBox: "0 0 16 16", fill: "none", "aria-hidden": "true", children: /* @__PURE__ */ jsx17(
+  return /* @__PURE__ */ jsx18("svg", { viewBox: "0 0 16 16", fill: "none", "aria-hidden": "true", children: /* @__PURE__ */ jsx18(
     "path",
     {
       d: "M6 3.5H3.5V6M10 3.5h2.5V6M10 12.5h2.5V10M6 12.5H3.5V10",
@@ -6267,7 +6990,7 @@ function ExpandIcon() {
   ) });
 }
 function RestoreIcon() {
-  return /* @__PURE__ */ jsx17("svg", { viewBox: "0 0 16 16", fill: "none", "aria-hidden": "true", children: /* @__PURE__ */ jsx17(
+  return /* @__PURE__ */ jsx18("svg", { viewBox: "0 0 16 16", fill: "none", "aria-hidden": "true", children: /* @__PURE__ */ jsx18(
     "path",
     {
       d: "M5.5 5.5H3.5V7.5M10.5 5.5h2V7.5M10.5 10.5h2V8.5M5.5 10.5H3.5V8.5",
@@ -6279,7 +7002,7 @@ function RestoreIcon() {
   ) });
 }
 function ChevronDownIcon() {
-  return /* @__PURE__ */ jsx17("svg", { viewBox: "0 0 16 16", fill: "none", "aria-hidden": "true", children: /* @__PURE__ */ jsx17(
+  return /* @__PURE__ */ jsx18("svg", { viewBox: "0 0 16 16", fill: "none", "aria-hidden": "true", children: /* @__PURE__ */ jsx18(
     "path",
     {
       d: "M4 6.5l4 4 4-4",
@@ -6293,6 +7016,7 @@ function ChevronDownIcon() {
 var DEFAULT_DISCLAIMER_LABEL = "Agent can make mistakes. Check important info.";
 function AgentRail({
   state,
+  handoff,
   theme,
   colorScheme = "auto",
   brandLabel = "",
@@ -6318,43 +7042,51 @@ function AgentRail({
   onInputResponse,
   onToolInput
 }) {
-  const railRef = useRef6(null);
-  const overlayRef = useRef6(null);
-  const transcriptRef = useRef6(null);
-  const responseRef = useRef6(null);
-  const threadRef = useRef6(null);
-  const lastScrolledVisitorIdRef = useRef6(void 0);
-  const pinnedToBottomRef = useRef6(true);
-  const smoothScrollToLatestRef = useRef6(false);
-  const lockedTranscriptScrollTopRef = useRef6(null);
-  const [showJumpToLatest, setShowJumpToLatest] = useState9(false);
-  const [receiptOpen, setReceiptOpen] = useState9(false);
+  const railRef = useRef8(null);
+  const overlayRef = useRef8(null);
+  const transcriptRef = useRef8(null);
+  const responseRef = useRef8(null);
+  const threadRef = useRef8(null);
+  const lastScrolledVisitorIdRef = useRef8(void 0);
+  const pinnedToBottomRef = useRef8(true);
+  const smoothScrollToLatestRef = useRef8(false);
+  const lockedTranscriptScrollTopRef = useRef8(null);
+  const [showJumpToLatest, setShowJumpToLatest] = useState11(false);
+  const [receiptOpen, setReceiptOpen] = useState11(false);
   const resolvedBrandLabel = brandLabel.trim();
   const resolvedBrandLogoUrl = brandLogoUrl?.trim();
   const resolvedDisclaimerLabel = disclaimerLabel === void 0 ? DEFAULT_DISCLAIMER_LABEL : disclaimerLabel;
-  const [failedLogoUrl, setFailedLogoUrl] = useState9(null);
+  const [failedLogoUrl, setFailedLogoUrl] = useState11(null);
   const showBrandLogo = Boolean(resolvedBrandLogoUrl) && failedLogoUrl !== resolvedBrandLogoUrl;
   const resolvedColorScheme = useAgentColorScheme(colorScheme);
   const railStyle = agentThemeStyle(theme, resolvedColorScheme);
+  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) => 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;
-  const semanticSurfaceDisabled = isBusy && state.phase !== "waiting-input";
+  const isBusy = state.phase === "thinking" || state.phase === "running-tools" || state.phase === "streaming" || state.phase === "waiting-input" && (pendingInputRequests.length > 0 || Boolean(locationRequest));
+  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"
   );
@@ -6383,7 +7115,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",
@@ -6425,7 +7157,7 @@ function AgentRail({
     ...visibleVisitorToolResults
   ].reverse().find((result) => result.kind !== "input")?.id;
   const receiptSteps = answerReceipt && state.toolSteps.length > 0 ? state.toolSteps : void 0;
-  useEffect6(() => {
+  useEffect8(() => {
     if (state.phase !== "complete") {
       setReceiptOpen(false);
     }
@@ -6447,7 +7179,7 @@ function AgentRail({
     onFollowUpSelect?.(label);
   }
   const latestVisitorId = visibleMessages[lastVisitorIndex]?.id;
-  useEffect6(() => {
+  useEffect8(() => {
     const node = transcriptRef.current;
     if (!node) return;
     if (latestVisitorId !== lastScrolledVisitorIdRef.current) {
@@ -6477,7 +7209,7 @@ function AgentRail({
     state.followUps,
     state.journey
   ]);
-  useEffect6(() => {
+  useEffect8(() => {
     const node = transcriptRef.current;
     if (!node) return;
     const handleScroll = () => {
@@ -6491,7 +7223,7 @@ function AgentRail({
     handleScroll();
     return () => node.removeEventListener("scroll", handleScroll);
   }, []);
-  useEffect6(() => {
+  useEffect8(() => {
     if (!receiptOpen) {
       lockedTranscriptScrollTopRef.current = null;
       return;
@@ -6529,7 +7261,7 @@ function AgentRail({
     window.setTimeout(settle, 900);
     node.scrollTo({ top: node.scrollHeight, behavior: "smooth" });
   }
-  return /* @__PURE__ */ jsx17(
+  return /* @__PURE__ */ jsx18(
     "aside",
     {
       ref: railRef,
@@ -6543,244 +7275,305 @@ function AgentRail({
       autoFocus: mobileFullscreen || expanded,
       role: mobileFullscreen || expanded ? "dialog" : void 0,
       tabIndex: mobileFullscreen || expanded ? -1 : void 0,
-      children: /* @__PURE__ */ jsxs16(
-        AgentRailOverlayContext.Provider,
-        {
-          value: { railRef, overlayRef },
-          children: [
-            /* @__PURE__ */ jsxs16("div", { className: "agent-rail__surface", inert: receiptOpen || void 0, children: [
-              /* @__PURE__ */ jsx17("header", { className: "agent-rail__header", children: /* @__PURE__ */ jsxs16("div", { className: "agent-rail__brand-row", children: [
-                onCollapse ? /* @__PURE__ */ jsx17(
-                  "button",
-                  {
-                    type: "button",
-                    className: "agent-rail__collapse",
-                    "aria-label": "Collapse assist",
-                    onClick: onCollapse,
-                    children: /* @__PURE__ */ jsx17(MinimizeIcon, {})
-                  }
-                ) : onClose ? /* @__PURE__ */ jsx17(
-                  "button",
-                  {
-                    type: "button",
-                    className: "agent-rail__close",
-                    "aria-label": "Close agent",
-                    onClick: onClose,
-                    children: /* @__PURE__ */ jsx17(CloseIcon2, {})
+      children: /* @__PURE__ */ jsxs17(AgentRailOverlayContext.Provider, { value: { railRef, overlayRef }, children: [
+        /* @__PURE__ */ jsxs17("div", { className: "agent-rail__surface", inert: receiptOpen || void 0, children: [
+          /* @__PURE__ */ jsx18("header", { className: "agent-rail__header", children: /* @__PURE__ */ jsxs17("div", { className: "agent-rail__brand-row", children: [
+            onCollapse ? /* @__PURE__ */ jsx18(
+              "button",
+              {
+                type: "button",
+                className: "agent-rail__collapse",
+                "aria-label": "Collapse assist",
+                onClick: onCollapse,
+                children: /* @__PURE__ */ jsx18(MinimizeIcon, {})
+              }
+            ) : onClose ? /* @__PURE__ */ jsx18(
+              "button",
+              {
+                type: "button",
+                className: "agent-rail__close",
+                "aria-label": "Close agent",
+                onClick: onClose,
+                children: /* @__PURE__ */ jsx18(CloseIcon2, {})
+              }
+            ) : /* @__PURE__ */ jsx18("span", { className: "agent-rail__brand-spacer", "aria-hidden": "true" }),
+            resolvedBrandLabel || showBrandLogo ? /* @__PURE__ */ jsxs17("span", { className: "agent-rail__identity", children: [
+              showBrandLogo ? /* @__PURE__ */ jsx18("span", { className: "agent-rail__brand-mark", "aria-hidden": "true", children: /* @__PURE__ */ jsx18(
+                "img",
+                {
+                  className: "agent-rail__brand-logo",
+                  src: resolvedBrandLogoUrl,
+                  alt: "",
+                  onError: () => {
+                    setFailedLogoUrl(resolvedBrandLogoUrl ?? null);
                   }
-                ) : /* @__PURE__ */ jsx17("span", { className: "agent-rail__brand-spacer", "aria-hidden": "true" }),
-                resolvedBrandLabel || showBrandLogo ? /* @__PURE__ */ jsxs16("span", { className: "agent-rail__identity", children: [
-                  showBrandLogo ? /* @__PURE__ */ jsx17("span", { className: "agent-rail__brand-mark", "aria-hidden": "true", children: /* @__PURE__ */ jsx17(
-                    "img",
-                    {
-                      className: "agent-rail__brand-logo",
-                      src: resolvedBrandLogoUrl,
-                      alt: "",
-                      onError: () => {
-                        setFailedLogoUrl(resolvedBrandLogoUrl ?? null);
-                      }
-                    }
-                  ) }) : null,
-                  resolvedBrandLabel ? /* @__PURE__ */ jsx17("span", { className: "agent-rail__brand-label", children: resolvedBrandLabel }) : null
-                ] }) : null,
-                /* @__PURE__ */ jsxs16("span", { className: "agent-rail__actions", children: [
-                  onReset ? /* @__PURE__ */ jsx17(
-                    "button",
-                    {
-                      type: "button",
-                      className: "agent-rail__new-chat",
-                      "aria-label": "Start a new conversation",
-                      disabled: !hasVisitorMessages2,
-                      onClick: handleReset,
-                      children: /* @__PURE__ */ jsx17(NewChatIcon, {})
-                    }
-                  ) : null,
-                  onExpandToggle ? /* @__PURE__ */ jsx17(
-                    "button",
+                }
+              ) }) : null,
+              resolvedBrandLabel ? /* @__PURE__ */ jsx18("span", { className: "agent-rail__brand-label", children: resolvedBrandLabel }) : null
+            ] }) : null,
+            /* @__PURE__ */ jsxs17("span", { className: "agent-rail__actions", children: [
+              onReset ? /* @__PURE__ */ jsx18(
+                "button",
+                {
+                  type: "button",
+                  className: "agent-rail__new-chat",
+                  "aria-label": "Start a new conversation",
+                  disabled: !hasVisitorMessages2 || handoffActive && !handoff?.canReset,
+                  onClick: handleReset,
+                  children: /* @__PURE__ */ jsx18(NewChatIcon, {})
+                }
+              ) : null,
+              onExpandToggle ? /* @__PURE__ */ jsx18(
+                "button",
+                {
+                  type: "button",
+                  className: "agent-rail__expand",
+                  "aria-label": expanded ? "Exit full screen" : "Open full screen",
+                  onClick: onExpandToggle,
+                  children: expanded ? /* @__PURE__ */ jsx18(RestoreIcon, {}) : /* @__PURE__ */ jsx18(ExpandIcon, {})
+                }
+              ) : null
+            ] })
+          ] }) }),
+          /* @__PURE__ */ jsx18("div", { ref: transcriptRef, className: "agent-rail__transcript", children: /* @__PURE__ */ jsxs17("div", { ref: threadRef, className: "agent-rail__thread", children: [
+            !hasVisitorMessages2 ? /* @__PURE__ */ jsxs17("section", { className: "agent-rail__welcome", "aria-label": "Welcome", children: [
+              greeting?.role === "agent" ? /* @__PURE__ */ jsx18(
+                MessageBubble,
+                {
+                  showProvenance: Boolean(
+                    handoff?.page?.enabled || handoffActive
+                  ),
+                  message: greeting,
+                  bookingDisabled: isBusy || handoffActive,
+                  brandLogoUrl: showBrandLogo ? resolvedBrandLogoUrl : void 0,
+                  onBook
+                }
+              ) : null,
+              showIdleFollowUps ? /* @__PURE__ */ jsx18("div", { className: "agent-rail__followups-slot", children: /* @__PURE__ */ jsx18(
+                FollowUpChips,
+                {
+                  suggestions: state.followUps,
+                  disabled: isBusy || handoffActive,
+                  label: "Start here",
+                  onSelect: (suggestion) => handleFollowUpSelect(suggestion.label)
+                }
+              ) }) : null,
+              showActivity ? /* @__PURE__ */ jsx18(
+                AgentActivityBubble,
+                {
+                  brandLabel: resolvedBrandLabel,
+                  brandLogoUrl: showBrandLogo ? resolvedBrandLogoUrl : void 0,
+                  failed: state.phase === "error",
+                  steps: activitySteps
+                }
+              ) : null,
+              visibleVisitorToolResults.map((result) => /* @__PURE__ */ jsx18(
+                VisitorToolResultView,
+                {
+                  result,
+                  disabled: semanticSurfaceDisabled,
+                  onToolInput
+                },
+                result.id
+              )),
+              pendingInputRequests.slice(0, 1).map((request) => /* @__PURE__ */ jsx18(
+                HumanInputCard,
+                {
+                  request,
+                  onRespond: onInputResponse
+                },
+                request.requestId
+              ))
+            ] }) : null,
+            transcriptMessages.map((message, index) => /* @__PURE__ */ jsxs17(
+              "div",
+              {
+                ref: index === lastVisitorIndex + 1 ? responseRef : void 0,
+                className: "agent-rail__turn-block",
+                children: [
+                  message.role === "agent" ? message.toolResults?.map((result) => /* @__PURE__ */ jsx18(
+                    VisitorToolResultView,
                     {
-                      type: "button",
-                      className: "agent-rail__expand",
-                      "aria-label": expanded ? "Exit full screen" : "Open full screen",
-                      onClick: onExpandToggle,
-                      children: expanded ? /* @__PURE__ */ jsx17(RestoreIcon, {}) : /* @__PURE__ */ jsx17(ExpandIcon, {})
-                    }
-                  ) : null
-                ] })
-              ] }) }),
-              /* @__PURE__ */ jsx17("div", { ref: transcriptRef, className: "agent-rail__transcript", children: /* @__PURE__ */ jsxs16("div", { ref: threadRef, className: "agent-rail__thread", children: [
-                !hasVisitorMessages2 ? /* @__PURE__ */ jsxs16("section", { className: "agent-rail__welcome", "aria-label": "Welcome", children: [
-                  greeting?.role === "agent" ? /* @__PURE__ */ jsx17(
+                      result
+                    },
+                    result.id
+                  )) : null,
+                  /* @__PURE__ */ jsx18(
                     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__ */ jsx17("div", { className: "agent-rail__followups-slot", children: /* @__PURE__ */ jsx17(
-                    FollowUpChips,
+                  ),
+                  index === lastAgentIndex && showMessageActions && message.role === "agent" ? /* @__PURE__ */ jsx18(
+                    MessageActions,
                     {
-                      suggestions: state.followUps,
-                      disabled: isBusy,
-                      label: "Start here",
-                      onSelect: (suggestion) => handleFollowUpSelect(suggestion.label)
-                    }
-                  ) }) : null,
-                  showActivity ? /* @__PURE__ */ jsx17(
-                    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__ */ jsx17(
-                    VisitorToolResultView,
-                    {
-                      result,
-                      disabled: semanticSurfaceDisabled,
-                      onToolInput
-                    },
-                    result.id
-                  )),
-                  pendingInputRequests.slice(0, 1).map((request) => /* @__PURE__ */ jsx17(
-                    HumanInputCard,
-                    {
-                      request,
-                      onRespond: onInputResponse
-                    },
-                    request.requestId
-                  ))
-                ] }) : null,
-                transcriptMessages.map((message, index) => /* @__PURE__ */ jsxs16(
-                  "div",
-                  {
-                    ref: index === lastVisitorIndex + 1 ? responseRef : void 0,
-                    className: "agent-rail__turn-block",
-                    children: [
-                      message.role === "agent" ? message.toolResults?.map((result) => /* @__PURE__ */ jsx17(VisitorToolResultView, { result }, result.id)) : null,
-                      /* @__PURE__ */ jsx17(
-                        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__ */ jsx17(
-                        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__ */ jsxs16(Fragment4, { children: [
-                        showActivity ? /* @__PURE__ */ jsx17(
-                          AgentActivityBubble,
-                          {
-                            brandLabel: resolvedBrandLabel,
-                            brandLogoUrl: showBrandLogo ? resolvedBrandLogoUrl : void 0,
-                            failed: state.phase === "error",
-                            steps: activitySteps
-                          }
-                        ) : null,
-                        visibleVisitorToolResults.map((result) => /* @__PURE__ */ jsx17(
-                          VisitorToolResultView,
-                          {
-                            result,
-                            disabled: semanticSurfaceDisabled,
-                            onToolInput
-                          },
-                          result.id
-                        )),
-                        pendingInputRequests.slice(0, 1).map((request) => /* @__PURE__ */ jsx17(
-                          HumanInputCard,
-                          {
-                            request,
-                            onRespond: onInputResponse
-                          },
-                          request.requestId
-                        ))
-                      ] }) : null
-                    ]
-                  },
-                  message.role === "agent" && transcriptMessages[index - 1]?.role === "visitor" ? `answer-${transcriptMessages[index - 1]?.id}` : message.id
-                )),
-                waitingForBooking ? /* @__PURE__ */ jsx17(BookingCardLoader, {}) : null,
-                state.error ? /* @__PURE__ */ jsxs16("section", { className: "agent-rail__error", role: "alert", children: [
-                  /* @__PURE__ */ jsxs16("div", { children: [
-                    /* @__PURE__ */ jsx17("strong", { children: "Something went wrong" }),
-                    /* @__PURE__ */ jsx17("p", { children: state.error })
-                  ] }),
-                  onRetry ? /* @__PURE__ */ jsx17("button", { type: "button", onClick: onRetry, children: "Try again" }) : null
-                ] }) : null
-              ] }) }),
-              showDisclaimerLabel ? /* @__PURE__ */ jsx17("div", { className: "agent-rail__disclaimer", children: /* @__PURE__ */ jsx17("p", { children: disclaimerLink ? /* @__PURE__ */ jsx17(
-                "a",
+                  index === lastVisitorIndex ? /* @__PURE__ */ jsxs17(Fragment4, { children: [
+                    showActivity ? /* @__PURE__ */ jsx18(
+                      AgentActivityBubble,
+                      {
+                        brandLabel: resolvedBrandLabel,
+                        brandLogoUrl: showBrandLogo ? resolvedBrandLogoUrl : void 0,
+                        failed: state.phase === "error",
+                        steps: activitySteps
+                      }
+                    ) : null,
+                    visibleVisitorToolResults.map((result) => /* @__PURE__ */ jsx18(
+                      VisitorToolResultView,
+                      {
+                        result,
+                        disabled: semanticSurfaceDisabled,
+                        onToolInput
+                      },
+                      result.id
+                    )),
+                    pendingInputRequests.slice(0, 1).map((request) => /* @__PURE__ */ jsx18(
+                      HumanInputCard,
+                      {
+                        request,
+                        onRespond: onInputResponse
+                      },
+                      request.requestId
+                    ))
+                  ] }) : null
+                ]
+              },
+              message.role === "agent" && transcriptMessages[index - 1]?.role === "visitor" ? `answer-${transcriptMessages[index - 1]?.id}` : message.id
+            )),
+            waitingForBooking ? /* @__PURE__ */ jsx18(BookingCardLoader, {}) : null,
+            state.error ? /* @__PURE__ */ jsxs17("section", { className: "agent-rail__error", role: "alert", children: [
+              /* @__PURE__ */ jsxs17("div", { children: [
+                /* @__PURE__ */ jsx18("strong", { children: "Something went wrong" }),
+                /* @__PURE__ */ jsx18("p", { children: state.error })
+              ] }),
+              onRetry ? /* @__PURE__ */ jsx18("button", { type: "button", onClick: onRetry, children: "Try again" }) : null
+            ] }) : null
+          ] }) }),
+          showDisclaimerLabel ? /* @__PURE__ */ jsx18("div", { className: "agent-rail__disclaimer", children: /* @__PURE__ */ jsx18("p", { children: disclaimerLink ? /* @__PURE__ */ jsx18(
+            "a",
+            {
+              href: disclaimerLink,
+              rel: "noopener noreferrer",
+              target: "_blank",
+              children: resolvedDisclaimerLabel
+            }
+          ) : resolvedDisclaimerLabel }) }) : null,
+          handoff && (handoff.page?.enabled || handoffActive) ? /* @__PURE__ */ jsxs17("div", { className: "agent-rail__handoff", children: [
+            /* @__PURE__ */ jsx18("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__ */ jsx18(
+              "button",
+              {
+                type: "button",
+                disabled: handoff.busy || handoff.hasPending || isBusy,
+                onClick: () => void handoff.start(),
+                children: "Talk to a person"
+              }
+            ) : null,
+            handoffStatus === "resolved" ? /* @__PURE__ */ jsx18(
+              "button",
+              {
+                type: "button",
+                disabled: handoff.busy || handoff.hasPending,
+                onClick: () => void handoff.returnToAI(),
+                children: "Return to AI"
+              }
+            ) : null,
+            handoffStatus === "failed" && onReset ? /* @__PURE__ */ jsx18(
+              "button",
+              {
+                type: "button",
+                disabled: !handoff.canReset,
+                onClick: handleReset,
+                children: "Start a new conversation"
+              }
+            ) : null,
+            handoff.error ? /* @__PURE__ */ jsxs17("div", { role: "alert", children: [
+              /* @__PURE__ */ jsx18("span", { children: handoff.error }),
+              /* @__PURE__ */ jsx18(
+                "button",
                 {
-                  href: disclaimerLink,
-                  rel: "noopener noreferrer",
-                  target: "_blank",
-                  children: resolvedDisclaimerLabel
+                  type: "button",
+                  disabled: handoff.busy,
+                  onClick: () => void handoff.retry(),
+                  children: "Retry"
                 }
-              ) : resolvedDisclaimerLabel }) }) : null,
-              /* @__PURE__ */ jsxs16("div", { className: "agent-rail__composer-wrap", children: [
-                showJumpToLatest ? /* @__PURE__ */ jsx17(
-                  "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__ */ jsx17(ChevronDownIcon, {})
-                  }
-                ) : null,
-                /* @__PURE__ */ jsx17(
-                  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__ */ jsx17("div", { className: "agent-rail__footer", children: /* @__PURE__ */ jsx17("p", { children: /* @__PURE__ */ jsx17("span", { children: poweredByLabel }) }) }) : null
-              ] })
-            ] }),
-            /* @__PURE__ */ jsx17("div", { ref: overlayRef, className: "agent-rail__overlay" }),
-            receiptOpen && receiptSteps ? /* @__PURE__ */ jsx17(
-              AnswerReceiptDialog,
+              )
+            ] }) : null
+          ] }) : null,
+          /* @__PURE__ */ jsxs17("div", { className: "agent-rail__composer-wrap", children: [
+            /* @__PURE__ */ jsx18(
+              LocationConsent,
+              {
+                request: locationRequest,
+                onRespond: onInputResponse
+              },
+              state.messages.find((message) => message.role === "visitor")?.id ?? "empty"
+            ),
+            showJumpToLatest ? /* @__PURE__ */ jsx18(
+              "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__ */ jsx18(ChevronDownIcon, {})
               }
-            ) : null
-          ]
-        }
-      )
+            ) : null,
+            /* @__PURE__ */ jsx18(
+              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__ */ jsx18("div", { className: "agent-rail__footer", children: /* @__PURE__ */ jsx18("p", { children: /* @__PURE__ */ jsx18("span", { children: poweredByLabel }) }) }) : null
+          ] })
+        ] }),
+        /* @__PURE__ */ jsx18("div", { ref: overlayRef, className: "agent-rail__overlay" }),
+        receiptOpen && receiptSteps ? /* @__PURE__ */ jsx18(
+          AnswerReceiptDialog,
+          {
+            brandLabel: resolvedBrandLabel,
+            onClose: () => setReceiptOpen(false),
+            steps: receiptSteps
+          }
+        ) : null
+      ] })
     }
   );
 }
 
 // src/react/components/AssistEdgeTab/AssistEdgeTab.tsx
-import { useState as useState10 } from "react";
-import { Fragment as Fragment5, jsx as jsx18, jsxs as jsxs17 } from "react/jsx-runtime";
+import { useState as useState12 } from "react";
+import { Fragment as Fragment5, jsx as jsx19, jsxs as jsxs18 } from "react/jsx-runtime";
 function ChatSparkIcon() {
-  return /* @__PURE__ */ jsxs17(
+  return /* @__PURE__ */ jsxs18(
     "svg",
     {
       className: "assist-edge-tab__chat-spark",
@@ -6788,7 +7581,7 @@ function ChatSparkIcon() {
       fill: "none",
       "aria-hidden": "true",
       children: [
-        /* @__PURE__ */ jsx18(
+        /* @__PURE__ */ jsx19(
           "path",
           {
             className: "assist-edge-tab__spark assist-edge-tab__spark--a",
@@ -6796,7 +7589,7 @@ function ChatSparkIcon() {
             fill: "currentColor"
           }
         ),
-        /* @__PURE__ */ jsx18(
+        /* @__PURE__ */ jsx19(
           "path",
           {
             className: "assist-edge-tab__spark assist-edge-tab__spark--b",
@@ -6804,8 +7597,8 @@ function ChatSparkIcon() {
             fill: "currentColor"
           }
         ),
-        /* @__PURE__ */ jsxs17("g", { className: "assist-edge-tab__bot", children: [
-          /* @__PURE__ */ jsx18(
+        /* @__PURE__ */ jsxs18("g", { className: "assist-edge-tab__bot", children: [
+          /* @__PURE__ */ jsx19(
             "path",
             {
               d: "M11.15 5.2V3.05",
@@ -6814,8 +7607,8 @@ function ChatSparkIcon() {
               strokeLinecap: "round"
             }
           ),
-          /* @__PURE__ */ jsx18("circle", { cx: "11.15", cy: "2.45", r: "0.85", fill: "currentColor" }),
-          /* @__PURE__ */ jsx18(
+          /* @__PURE__ */ jsx19("circle", { cx: "11.15", cy: "2.45", r: "0.85", fill: "currentColor" }),
+          /* @__PURE__ */ jsx19(
             "rect",
             {
               x: "3.55",
@@ -6827,7 +7620,7 @@ function ChatSparkIcon() {
               strokeWidth: "1.9"
             }
           ),
-          /* @__PURE__ */ jsx18(
+          /* @__PURE__ */ jsx19(
             "circle",
             {
               className: "assist-edge-tab__eye",
@@ -6837,7 +7630,7 @@ function ChatSparkIcon() {
               fill: "currentColor"
             }
           ),
-          /* @__PURE__ */ jsx18(
+          /* @__PURE__ */ jsx19(
             "circle",
             {
               className: "assist-edge-tab__eye assist-edge-tab__eye--r",
@@ -6858,10 +7651,10 @@ function TabMarkIcon({
 }) {
   const custom = customIconUrl?.trim();
   const logo = logoUrl?.trim();
-  const [customFailed, setCustomFailed] = useState10(false);
-  const [logoFailed, setLogoFailed] = useState10(false);
+  const [customFailed, setCustomFailed] = useState12(false);
+  const [logoFailed, setLogoFailed] = useState12(false);
   if (custom && !customFailed) {
-    return /* @__PURE__ */ jsx18(
+    return /* @__PURE__ */ jsx19(
       "img",
       {
         alt: "",
@@ -6873,7 +7666,7 @@ function TabMarkIcon({
     );
   }
   if (logo && !logoFailed) {
-    return /* @__PURE__ */ jsx18(
+    return /* @__PURE__ */ jsx19(
       "img",
       {
         alt: "",
@@ -6884,10 +7677,10 @@ function TabMarkIcon({
       }
     );
   }
-  return /* @__PURE__ */ jsx18(ChatSparkIcon, {});
+  return /* @__PURE__ */ jsx19(ChatSparkIcon, {});
 }
 function ChevronLeftIcon() {
-  return /* @__PURE__ */ jsx18("svg", { viewBox: "0 0 16 16", fill: "none", "aria-hidden": "true", children: /* @__PURE__ */ jsx18(
+  return /* @__PURE__ */ jsx19("svg", { viewBox: "0 0 16 16", fill: "none", "aria-hidden": "true", children: /* @__PURE__ */ jsx19(
     "path",
     {
       d: "M10 4L6 8l4 4",
@@ -6899,7 +7692,7 @@ function ChevronLeftIcon() {
   ) });
 }
 function ChevronDownIcon2() {
-  return /* @__PURE__ */ jsx18("svg", { viewBox: "0 0 16 16", fill: "none", "aria-hidden": "true", children: /* @__PURE__ */ jsx18(
+  return /* @__PURE__ */ jsx19("svg", { viewBox: "0 0 16 16", fill: "none", "aria-hidden": "true", children: /* @__PURE__ */ jsx19(
     "path",
     {
       d: "M4 6l4 4 4-4",
@@ -6911,7 +7704,7 @@ function ChevronDownIcon2() {
   ) });
 }
 function DragDots() {
-  return /* @__PURE__ */ jsx18("span", { className: "assist-edge-tab__dots", "aria-hidden": "true", children: Array.from({ length: 12 }, (_, index) => /* @__PURE__ */ jsx18("i", {}, index)) });
+  return /* @__PURE__ */ jsx19("span", { className: "assist-edge-tab__dots", "aria-hidden": "true", children: Array.from({ length: 12 }, (_, index) => /* @__PURE__ */ jsx19("i", {}, index)) });
 }
 var VARIANT_COPY = {
   outline: { label: "Ask anything", aria: "Ask anything" },
@@ -6966,7 +7759,7 @@ function AssistEdgeTab({
     ...!pill && resolvedTextColor ? { "--as-text": resolvedTextColor } : {},
     colorScheme: chromeScheme
   };
-  return /* @__PURE__ */ jsxs17(
+  return /* @__PURE__ */ jsxs18(
     "button",
     {
       type: "button",
@@ -6978,13 +7771,13 @@ function AssistEdgeTab({
       tabIndex: visible ? 0 : -1,
       onClick: onOpen,
       children: [
-        pill ? /* @__PURE__ */ jsxs17(Fragment5, { children: [
-          /* @__PURE__ */ jsx18(
+        pill ? /* @__PURE__ */ jsxs18(Fragment5, { children: [
+          /* @__PURE__ */ jsx19(
             "span",
             {
               className: `assist-edge-tab__mark assist-edge-tab__mark--chip${mobile ? " assist-edge-tab__mark--mobile" : ""}`,
               "aria-hidden": "true",
-              children: /* @__PURE__ */ jsx18(
+              children: /* @__PURE__ */ jsx19(
                 TabMarkIcon,
                 {
                   customIconUrl,
@@ -6994,12 +7787,12 @@ function AssistEdgeTab({
               )
             }
           ),
-          /* @__PURE__ */ jsxs17("span", { className: "assist-edge-tab__text", children: [
-            /* @__PURE__ */ jsx18("span", { className: "assist-edge-tab__label", children: visibleLabel }),
-            visibleSubLabel ? /* @__PURE__ */ jsx18("span", { className: "assist-edge-tab__sublabel", children: visibleSubLabel }) : null
+          /* @__PURE__ */ jsxs18("span", { className: "assist-edge-tab__text", children: [
+            /* @__PURE__ */ jsx19("span", { className: "assist-edge-tab__label", children: visibleLabel }),
+            visibleSubLabel ? /* @__PURE__ */ jsx19("span", { className: "assist-edge-tab__sublabel", children: visibleSubLabel }) : null
           ] })
-        ] }) : variant === "outline" ? /* @__PURE__ */ jsxs17(Fragment5, { children: [
-          /* @__PURE__ */ jsx18("span", { className: "assist-edge-tab__mark", "aria-hidden": "true", children: /* @__PURE__ */ jsx18(
+        ] }) : variant === "outline" ? /* @__PURE__ */ jsxs18(Fragment5, { children: [
+          /* @__PURE__ */ jsx19("span", { className: "assist-edge-tab__mark", "aria-hidden": "true", children: /* @__PURE__ */ jsx19(
             TabMarkIcon,
             {
               customIconUrl,
@@ -7007,16 +7800,16 @@ function AssistEdgeTab({
             },
             markSourceKey
           ) }),
-          /* @__PURE__ */ jsx18("span", { className: "assist-edge-tab__label", children: visibleLabel }),
-          /* @__PURE__ */ jsx18(ChevronDownIcon2, {})
+          /* @__PURE__ */ jsx19("span", { className: "assist-edge-tab__label", children: visibleLabel }),
+          /* @__PURE__ */ jsx19(ChevronDownIcon2, {})
         ] }) : null,
-        !pill && variant === "ask" ? /* @__PURE__ */ jsxs17(Fragment5, { children: [
-          /* @__PURE__ */ jsx18(ChevronLeftIcon, {}),
-          /* @__PURE__ */ jsx18("span", { className: "assist-edge-tab__label", children: visibleLabel }),
-          /* @__PURE__ */ jsx18(DragDots, {})
+        !pill && variant === "ask" ? /* @__PURE__ */ jsxs18(Fragment5, { children: [
+          /* @__PURE__ */ jsx19(ChevronLeftIcon, {}),
+          /* @__PURE__ */ jsx19("span", { className: "assist-edge-tab__label", children: visibleLabel }),
+          /* @__PURE__ */ jsx19(DragDots, {})
         ] }) : null,
-        !pill && variant === "fill" ? /* @__PURE__ */ jsxs17(Fragment5, { children: [
-          /* @__PURE__ */ jsx18("span", { className: "assist-edge-tab__mark", "aria-hidden": "true", children: /* @__PURE__ */ jsx18(
+        !pill && variant === "fill" ? /* @__PURE__ */ jsxs18(Fragment5, { children: [
+          /* @__PURE__ */ jsx19("span", { className: "assist-edge-tab__mark", "aria-hidden": "true", children: /* @__PURE__ */ jsx19(
             TabMarkIcon,
             {
               customIconUrl,
@@ -7024,8 +7817,8 @@ function AssistEdgeTab({
             },
             markSourceKey
           ) }),
-          /* @__PURE__ */ jsx18("span", { className: "assist-edge-tab__label", children: visibleLabel }),
-          /* @__PURE__ */ jsx18(ChevronLeftIcon, {})
+          /* @__PURE__ */ jsx19("span", { className: "assist-edge-tab__label", children: visibleLabel }),
+          /* @__PURE__ */ jsx19(ChevronLeftIcon, {})
         ] }) : null
       ]
     }
@@ -7047,8 +7840,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;
 }
@@ -7089,10 +7882,10 @@ function sendAgentAnswerFeedback(eventUrl, event) {
 }
 
 // src/react/components/AgentWidget/AgentWidget.tsx
-import { useEffect as useEffect9, useRef as useRef7, useState as useState12 } from "react";
+import { useEffect as useEffect11, useRef as useRef9, useState as useState14 } from "react";
 
 // src/react/page-shift.ts
-import { useEffect as useEffect7 } from "react";
+import { useEffect as useEffect9 } from "react";
 var PAGE_SHIFT_CLASS = "webless-agent-page-shift";
 var DEFAULT_RAIL_WIDTH_PX = 450;
 function shouldApplyPageShift(input) {
@@ -7144,7 +7937,7 @@ function clearPageMargin() {
 }
 function usePageShift(input) {
   const { active, railSlotRef } = input;
-  useEffect7(() => {
+  useEffect9(() => {
     if (typeof document === "undefined") {
       return;
     }
@@ -7172,12 +7965,12 @@ function usePageShift(input) {
 }
 
 // src/react/hooks/useIsMobile.ts
-import { useEffect as useEffect8, useState as useState11 } from "react";
+import { useEffect as useEffect10, useState as useState13 } from "react";
 function useIsMobile(breakpoint = 767) {
-  const [isMobile, setIsMobile] = useState11(
+  const [isMobile, setIsMobile] = useState13(
     () => typeof window !== "undefined" && window.matchMedia(`(max-width: ${breakpoint}px)`).matches
   );
-  useEffect8(() => {
+  useEffect10(() => {
     const media = window.matchMedia(`(max-width: ${breakpoint}px)`);
     const onChange = () => setIsMobile(media.matches);
     onChange();
@@ -7188,7 +7981,7 @@ function useIsMobile(breakpoint = 767) {
 }
 
 // src/react/components/AgentWidget/AgentWidget.tsx
-import { jsx as jsx19, jsxs as jsxs18 } from "react/jsx-runtime";
+import { jsx as jsx20, jsxs as jsxs19 } from "react/jsx-runtime";
 function AgentWidget({
   indexId,
   customerId,
@@ -7207,9 +8000,9 @@ function AgentWidget({
 }) {
   const isMobile = useIsMobile();
   const placement = normalizeAgentPlacement(placementInput);
-  const railSlotRef = useRef7(null);
-  const [railCollapsed, setRailCollapsed] = useState12(defaultCollapsed);
-  const [railExpanded, setRailExpanded] = useState12(false);
+  const railSlotRef = useRef9(null);
+  const [railCollapsed, setRailCollapsed] = useState14(defaultCollapsed);
+  const [railExpanded, setRailExpanded] = useState14(false);
   const pageShiftActive = shouldApplyPageShift({
     pageShift,
     isMobile,
@@ -7262,7 +8055,7 @@ function AgentWidget({
     } : {},
     ...branding?.colors?.border ? { border: branding.colors.border } : {}
   };
-  useEffect9(() => {
+  useEffect11(() => {
     if (!registerPanelController) return;
     registerAgentPanelController(customerId, {
       open: () => setRailCollapsed(false),
@@ -7297,7 +8090,7 @@ function AgentWidget({
       })
     );
   }
-  useEffect9(() => {
+  useEffect11(() => {
     if (railCollapsed) return;
     const handleKeyDown = (event) => {
       if (event.key === "Tab" && (isMobile || railExpanded)) {
@@ -7331,19 +8124,19 @@ function AgentWidget({
     window.addEventListener("keydown", handleKeyDown);
     return () => window.removeEventListener("keydown", handleKeyDown);
   }, [isMobile, railCollapsed, railExpanded]);
-  return /* @__PURE__ */ jsxs18("div", { className: "webless-agent-root", children: [
-    /* @__PURE__ */ jsx19(
+  return /* @__PURE__ */ jsxs19("div", { className: "webless-agent-root", children: [
+    /* @__PURE__ */ jsx20(
       "div",
       {
         className: `webless-agent-root__shell${railCollapsed ? " webless-agent-root__shell--collapsed" : ""}${railExpanded ? " webless-agent-root__shell--expanded" : ""}`,
-        children: /* @__PURE__ */ jsx19(
+        children: /* @__PURE__ */ jsx20(
           "div",
           {
             ref: railSlotRef,
             className: "webless-agent-root__rail-slot",
             inert: railCollapsed || void 0,
             "aria-hidden": railCollapsed,
-            children: /* @__PURE__ */ jsx19(
+            children: /* @__PURE__ */ jsx20(
               AgentRail,
               {
                 theme,
@@ -7380,7 +8173,7 @@ function AgentWidget({
         )
       }
     ),
-    railCollapsed ? /* @__PURE__ */ jsx19(
+    railCollapsed ? /* @__PURE__ */ jsx20(
       AssistEdgeTab,
       {
         variant: placement.variant,
@@ -7441,4 +8234,4 @@ export {
   sendAgentAnswerFeedback,
   AgentWidget
 };
-//# sourceMappingURL=chunk-74CSWSC5.js.map
+//# sourceMappingURL=chunk-EVWZF34F.js.map