dewee-webchat 0.4.1 → 0.5.0-beta.1

package/dist/{chunk-VU2M42GA.js → chunk-M6J3IXEI.js}

@@ -9,7 +9,7 @@ import {
   isLinkErrorCode,
   parseJobAccessLaunch,
   stripPageBlock
-} from "./chunk-EVZ5K7BN.js";
+} from "./chunk-WHHQ6FKK.js";
 
 // src/actions/directives.ts
 var DIRECTIVE_LANG = "dewee-action";
@@ -79,14 +79,44 @@ function stripDirectives(content) {
   return removeBlocks(lines, findBlocks(lines, DIRECTIVE_OPEN_RE));
 }
 function isActionResultMessage(content) {
-  return RESULT_OPEN_RE.test(content.trimStart().split("\n", 1)[0] ?? "");
+  return /^\s*```dewee-action-result(?:\s|$)/.test(content);
+}
+function compactResultBodies(content) {
+  const open = /```dewee-action-result\s+/g;
+  const bodies = [];
+  let match;
+  while (match = open.exec(content)) {
+    const start = open.lastIndex;
+    if (content[start] !== "{") continue;
+    let depth = 0, quoted = false, escaped = false;
+    for (let i = start; i < content.length; i++) {
+      const c = content[i];
+      if (quoted) {
+        if (escaped) escaped = false;
+        else if (c === "\\") escaped = true;
+        else if (c === '"') quoted = false;
+      } else if (c === '"') quoted = true;
+      else if (c === "{") depth++;
+      else if (c === "}" && --depth === 0) {
+        const close = /^\s*```/.exec(content.slice(i + 1));
+        if (close) {
+          bodies.push(content.slice(start, i + 1));
+          open.lastIndex = i + 1 + close[0].length;
+        }
+        break;
+      }
+    }
+  }
+  return bodies;
 }
 function parseActionResults(content) {
   const lines = content.replace(/\r\n?/g, "\n").split("\n");
   const out = [];
-  for (const b of findBlocks(lines, RESULT_OPEN_RE)) {
+  const blocks = findBlocks(lines, RESULT_OPEN_RE);
+  const bodies = blocks.length ? blocks.map((b) => b.body.join("\n")) : compactResultBodies(content);
+  for (const body of bodies) {
     try {
-      const r = JSON.parse(b.body.join("\n"));
+      const r = JSON.parse(body);
       if (r && typeof r.id === "string" && ["ok", "denied", "error"].includes(r.status)) out.push(r);
     } catch {
     }
@@ -279,6 +309,257 @@ function raceAbort(p, signal) {
   });
 }
 
+// src/actions/dom-actions.ts
+var DOM_ACTION_NAMES = ["page.snapshot", "page.scroll", "page.click", "page.fill"];
+var INTERACTIVE = [
+  "a[href]",
+  "button",
+  "input",
+  "select",
+  "textarea",
+  "summary",
+  "[contenteditable]:not([contenteditable=false])",
+  ...["button", "link", "checkbox", "radio", "switch", "tab", "menuitem", "option", "combobox", "textbox", "searchbox"].map((r) => `[role=${r}]`)
+].join(",");
+var UNFILLABLE_INPUTS = /* @__PURE__ */ new Set(["checkbox", "radio", "file", "submit", "button", "image", "reset", "hidden", "password"]);
+var SENSITIVE_AUTOCOMPLETE = /\b(cc-[a-z-]+|one-time-code|current-password|new-password)\b/i;
+var SENSITIVE_NAME = /(passw|passcode|\bpin\b|otp|one.?time|cvv|cvc|card.?(num|no)|cc.?num|security.?code|\bssn\b)/i;
+var MAX_NAME = 80;
+var MAX_VALUE = 60;
+var DEFAULT_LIMIT = 40;
+var clip = (s, n) => s.length > n ? s.slice(0, n - 1) + "\u2026" : s;
+var squash = (s) => (s ?? "").replace(/\s+/g, " ").trim();
+var refSchema = { type: "string", pattern: "^e[0-9]{1,4}$" };
+var genSchema = { type: "integer", minimum: 1 };
+function createDomActions(o) {
+  let generation = 0;
+  let refs = /* @__PURE__ */ new Map();
+  const rootEl = () => {
+    const r = o.root();
+    const el2 = typeof r === "string" ? document.querySelector(r) : r;
+    if (r !== void 0 && !el2) throw new Error(`domActionsRoot ${JSON.stringify(r)} matches no element`);
+    return el2 ?? document.body;
+  };
+  const allowed = (el2, root) => el2.isConnected && root.contains(el2) && !o.exclude?.(el2) && !el2.closest("[data-dewee-ignore]") && !isSensitive(el2) && isVisible(el2);
+  const resolve = (args) => {
+    if (args.generation !== generation) {
+      throw new Error(`Stale ref: generation ${args.generation} is not the latest snapshot (${generation || "none"}). Call page.snapshot again.`);
+    }
+    const el2 = refs.get(args.ref);
+    if (!el2) throw new Error(`Unknown ref "${args.ref}". Call page.snapshot again.`);
+    if (!allowed(el2, rootEl())) throw new Error(`Ref "${args.ref}" is no longer available. Call page.snapshot again.`);
+    return el2;
+  };
+  const snapshot = {
+    name: "page.snapshot",
+    description: 'List the interactive elements visible on the page (links, buttons, form fields) as lines `ref role "name" [state]`. Use the ref together with the returned generation in page.scroll, page.click and page.fill. Every snapshot invalidates older refs. Use query to filter by visible name, offset/limit to page through long lists.',
+    sensitivity: "read",
+    parameters: {
+      type: "object",
+      properties: { query: { type: "string", maxLength: 100 }, offset: { type: "integer", minimum: 0 }, limit: { type: "integer", minimum: 1, maximum: 100 } },
+      additionalProperties: false
+    },
+    handler: ({ query, offset = 0, limit = DEFAULT_LIMIT }) => {
+      const root = rootEl();
+      generation++;
+      refs = /* @__PURE__ */ new Map();
+      const q = squash(query).toLowerCase();
+      const lines = [];
+      let total = 0;
+      for (const el2 of root.querySelectorAll(INTERACTIVE)) {
+        if (!allowed(el2, root)) continue;
+        const line = describe(el2);
+        if (q && !line.toLowerCase().includes(q)) continue;
+        total++;
+        if (total <= offset || lines.length >= limit) continue;
+        const ref = `e${total}`;
+        refs.set(ref, el2);
+        lines.push(`${ref} ${line}`);
+      }
+      return { generation, url: location.pathname + location.search, title: clip(document.title, MAX_NAME), total, offset, elements: lines, ...scrollState(root) };
+    }
+  };
+  const scroll = {
+    name: "page.scroll",
+    description: "Scroll the page by about one screen (direction up/down) or to the top/bottom, or scroll an element from page.snapshot into view (ref + generation).",
+    sensitivity: "read",
+    parameters: {
+      type: "object",
+      properties: { direction: { type: "string", enum: ["up", "down", "top", "bottom"] }, ref: refSchema, generation: genSchema },
+      additionalProperties: false
+    },
+    handler: ({ direction, ref, generation: gen }) => {
+      const root = rootEl();
+      if (ref !== void 0) {
+        if (gen === void 0) throw new Error("generation is required with ref");
+        const el2 = resolve({ ref, generation: gen });
+        el2.scrollIntoView?.({ block: "center", inline: "nearest" });
+        return { ref, ...scrollState(root) };
+      }
+      if (!direction) throw new Error("Give a direction or a ref");
+      const box = scroller(root);
+      const page = box === null ? window.innerHeight : box.clientHeight;
+      const current = box === null ? window.scrollY : box.scrollTop;
+      const max = box === null ? document.documentElement.scrollHeight : box.scrollHeight;
+      const top = direction === "top" ? 0 : direction === "bottom" ? max : current + (direction === "down" ? 0.8 : -0.8) * page;
+      if (box === null) window.scrollTo({ top });
+      else box.scrollTop = top;
+      return { direction, ...scrollState(root) };
+    }
+  };
+  const click = {
+    name: "page.click",
+    description: "Click an element from page.snapshot (ref + generation). The visitor approves every click.",
+    sensitivity: "mutate",
+    parameters: { type: "object", properties: { ref: refSchema, generation: genSchema }, required: ["ref", "generation"], additionalProperties: false },
+    handler: (args) => {
+      const el2 = resolve(args);
+      if (isDisabled(el2)) throw new Error(`Ref "${args.ref}" is disabled`);
+      el2.scrollIntoView?.({ block: "center", inline: "nearest" });
+      if (el2 instanceof HTMLElement) {
+        el2.focus({ preventScroll: true });
+        el2.click();
+      } else {
+        el2.dispatchEvent(new MouseEvent("click", { bubbles: true, cancelable: true, composed: true }));
+      }
+      return { ref: args.ref, clicked: describe(el2) };
+    }
+  };
+  const fill = {
+    name: "page.fill",
+    description: "Replace the value of a text field, textarea, select (option value or label) or editable area from page.snapshot (ref + generation). The visitor approves every fill.",
+    sensitivity: "mutate",
+    parameters: {
+      type: "object",
+      properties: { ref: refSchema, generation: genSchema, text: { type: "string", maxLength: 1e4 } },
+      required: ["ref", "generation", "text"],
+      additionalProperties: false
+    },
+    handler: (args) => {
+      const el2 = resolve(args);
+      if (isDisabled(el2) || el2.readOnly) throw new Error(`Ref "${args.ref}" is not editable`);
+      setValue(el2, args.text);
+      return { ref: args.ref, value: clip(currentValue(el2), MAX_VALUE) };
+    }
+  };
+  return {
+    actions: [snapshot, scroll, click, fill],
+    target: (args) => {
+      try {
+        return describe(resolve(args));
+      } catch {
+        return void 0;
+      }
+    }
+  };
+}
+function setValue(el2, text) {
+  if (el2 instanceof HTMLInputElement) {
+    if (UNFILLABLE_INPUTS.has(el2.type)) throw new Error(`Inputs of type "${el2.type}" cannot be filled; use page.click`);
+    nativeSet(HTMLInputElement.prototype, el2, text);
+  } else if (el2 instanceof HTMLTextAreaElement) {
+    nativeSet(HTMLTextAreaElement.prototype, el2, text);
+  } else if (el2 instanceof HTMLSelectElement) {
+    const opt = [...el2.options].find((op) => op.value === text) ?? [...el2.options].find((op) => squash(op.textContent).toLowerCase() === squash(text).toLowerCase());
+    if (!opt) throw new Error(`No option "${clip(text, MAX_VALUE)}"`);
+    nativeSet(HTMLSelectElement.prototype, el2, opt.value);
+  } else if (el2 instanceof HTMLElement && el2.isContentEditable) {
+    el2.focus({ preventScroll: true });
+    el2.textContent = text;
+    el2.dispatchEvent(new InputEvent("input", { bubbles: true, composed: true, inputType: "insertReplacementText", data: text }));
+    return;
+  } else {
+    throw new Error("This element cannot be filled; use page.click");
+  }
+  el2.focus({ preventScroll: true });
+  el2.dispatchEvent(new Event("input", { bubbles: true, composed: true }));
+  el2.dispatchEvent(new Event("change", { bubbles: true }));
+}
+function nativeSet(proto, el2, value) {
+  const set = Object.getOwnPropertyDescriptor(proto, "value")?.set;
+  if (set) set.call(el2, value);
+  else el2.value = value;
+}
+function currentValue(el2) {
+  if (el2 instanceof HTMLInputElement || el2 instanceof HTMLTextAreaElement || el2 instanceof HTMLSelectElement) return el2.value;
+  return squash(el2.textContent);
+}
+function isDisabled(el2) {
+  return el2.disabled === true || el2.closest("fieldset[disabled]") !== null || el2.getAttribute("aria-disabled") === "true";
+}
+function isSensitive(el2) {
+  if (el2 instanceof HTMLInputElement && el2.type === "password") return true;
+  if (!(el2 instanceof HTMLInputElement || el2 instanceof HTMLTextAreaElement || el2 instanceof HTMLSelectElement)) return false;
+  if (SENSITIVE_AUTOCOMPLETE.test(el2.getAttribute("autocomplete") ?? "")) return true;
+  const hint = [el2.name, el2.id, el2.getAttribute("aria-label"), el2.placeholder].filter(Boolean).join(" ");
+  return SENSITIVE_NAME.test(hint);
+}
+function isVisible(el2) {
+  if (el2 instanceof HTMLInputElement && el2.type === "hidden") return false;
+  if (el2.closest("[hidden],[inert],[aria-hidden=true]")) return false;
+  for (let n = el2; n; n = n.parentElement) {
+    const cs = getComputedStyle(n);
+    if (cs.display === "none" || n === el2 && (cs.visibility === "hidden" || cs.visibility === "collapse")) return false;
+  }
+  return true;
+}
+function role(el2) {
+  const explicit = el2.getAttribute("role");
+  if (explicit) return explicit;
+  const tag = el2.tagName.toLowerCase();
+  if (tag === "a") return "link";
+  if (tag === "select") return "combobox";
+  if (tag === "textarea") return "textbox";
+  if (tag === "summary") return "button";
+  if (el2 instanceof HTMLInputElement) {
+    const t = el2.type;
+    if (t === "checkbox" || t === "radio") return t;
+    if (t === "submit" || t === "button" || t === "reset" || t === "image") return "button";
+    if (t === "search") return "searchbox";
+    if (t === "range") return "slider";
+    return t === "text" ? "textbox" : `textbox:${t}`;
+  }
+  if (el2.isContentEditable) return "textbox";
+  return tag;
+}
+function accessibleName(el2) {
+  const labelledBy = el2.getAttribute("aria-labelledby");
+  if (labelledBy) {
+    const text2 = labelledBy.split(/\s+/).map((id) => squash(document.getElementById(id)?.textContent)).filter(Boolean).join(" ");
+    if (text2) return text2;
+  }
+  const aria = squash(el2.getAttribute("aria-label"));
+  if (aria) return aria;
+  const labels = el2.labels;
+  if (labels?.length) {
+    const text2 = squash([...labels].map((l) => l.textContent).join(" "));
+    if (text2) return text2;
+  }
+  if (el2 instanceof HTMLInputElement && ["submit", "button", "reset"].includes(el2.type)) return squash(el2.value);
+  const text = el2 instanceof HTMLSelectElement || el2 instanceof HTMLTextAreaElement || el2 instanceof HTMLInputElement ? "" : squash(el2.textContent);
+  return text || squash(el2.getAttribute("placeholder")) || squash(el2.getAttribute("title")) || squash(el2.querySelector("img[alt]")?.getAttribute("alt")) || squash(el2.getAttribute("name"));
+}
+function describe(el2) {
+  const parts = [role(el2), JSON.stringify(clip(accessibleName(el2), MAX_NAME))];
+  if (el2 instanceof HTMLInputElement && (el2.type === "checkbox" || el2.type === "radio")) parts.push(el2.checked ? "checked" : "unchecked");
+  else if (el2 instanceof HTMLInputElement || el2 instanceof HTMLTextAreaElement || el2 instanceof HTMLSelectElement) {
+    const v = currentValue(el2);
+    if (v && !(el2 instanceof HTMLInputElement && ["submit", "button", "reset"].includes(el2.type))) parts.push(`value=${JSON.stringify(clip(v, MAX_VALUE))}`);
+  }
+  if (el2 instanceof HTMLAnchorElement) parts.push(`href=${JSON.stringify(clip(el2.getAttribute("href") ?? "", MAX_NAME))}`);
+  if (isDisabled(el2)) parts.push("disabled");
+  return parts.join(" ");
+}
+function scroller(root) {
+  if (root === document.body || root === document.documentElement) return null;
+  return root.scrollHeight > root.clientHeight ? root : null;
+}
+function scrollState(root) {
+  const box = scroller(root);
+  if (box === null) return { scrollY: Math.round(window.scrollY), maxScrollY: Math.max(0, Math.round(document.documentElement.scrollHeight - window.innerHeight)) };
+  return { scrollY: Math.round(box.scrollTop), maxScrollY: Math.max(0, Math.round(box.scrollHeight - box.clientHeight)) };
+}
+
 // src/widget/api-client.ts
 var RENEW_CODES = /* @__PURE__ */ new Set(["LINK_EXPIRED", "LINK_REVOKED"]);
 var VERIFIED_REFRESH_MS = 6e4;
@@ -333,6 +614,8 @@ var ApiClient = class {
   session = null;
   config = null;
   sessionPromise = null;
+  supersededSessions = /* @__PURE__ */ new Map();
+  sessionGeneration = 0;
   url(action, qs) {
     const base = this.o.endpoint.replace(/\/+$/, "");
     const q = qs ? "?" + new URLSearchParams(qs).toString() : "";
@@ -367,7 +650,7 @@ var ApiClient = class {
       h[HEADER_GATEWAY_TOKEN] = this.o.gatewayToken;
     }
     if (auth) {
-      const s = this.session && this.fresh(this.session) ? this.session : await this.ensureSession();
+      const s = await this.ensureSession();
       h.authorization = `Bearer ${s.token}`;
     }
     return h;
@@ -381,16 +664,24 @@ var ApiClient = class {
     }
     return body;
   }
-  async getConfig(force = false) {
+  /** Obtain a short-lived, URL-bound image capability without exposing the visitor bearer in src. */
+  async imageUrl(source, signal) {
+    const res = await this.request(this.url("image-ticket"), { method: "POST", headers: await this.headers(true), body: JSON.stringify({ url: source }), redirect: "error", signal });
+    const data = await this.parse(res);
+    if (typeof data.ticket !== "string" || !/^[A-Za-z0-9_-]{1,8192}$/.test(data.ticket)) throw new Error("Invalid image ticket");
+    return this.url("image", { ticket: data.ticket });
+  }
+  async getConfig(force = false, probePageContext = false) {
     if (this.config && !force) return this.config;
-    this.config = await this.parse(await this.request(this.url("config"), { headers: await this.headers() }));
+    this.config = await this.parse(await this.request(this.url("config", probePageContext ? { pageContext: "1" } : void 0), { headers: await this.headers() }));
     return this.config;
   }
   /** When each signed-in session should be refreshed, on this browser's clock. */
   refreshAt = /* @__PURE__ */ new WeakMap();
   /**
    * Session reuse. A signed-in session follows its schedule (see `scheduleRefresh`). An anonymous
-   * token is refreshed once less than 10% of its lifetime (at most 24 h, at least 30 s) remains; a
+   * token is refreshed once less than 10% of its lifetime (at most 24 h, at least 30 s, and no more
+   * than half the lifetime) remains; a
    * stored token from before `obtainedAt` existed uses the 24 h margin. When the backend reports the
    * lifetime (`expiresIn`), it is counted from receipt, so a skewed browser clock does not matter.
    */
@@ -399,7 +690,7 @@ var ApiClient = class {
     const reported = typeof s.expiresIn === "number" && s.expiresIn >= 0 && s.obtainedAt;
     const end = reported ? s.obtainedAt + s.expiresIn : s.expiresAt;
     const lifetime = reported ? s.expiresIn : s.obtainedAt ? s.expiresAt - s.obtainedAt : Infinity;
-    const margin = Math.min(864e5, Math.max(3e4, lifetime * 0.1));
+    const margin = Math.min(864e5, lifetime / 2, Math.max(3e4, lifetime * 0.1));
     return end - Date.now() > margin;
   }
   /**
@@ -417,28 +708,50 @@ var ApiClient = class {
     if (!saved) return null;
     try {
       const s = JSON.parse(saved);
-      return s.verified ? null : s;
+      if (s.verified) {
+        store.del(this.storageKey);
+        return null;
+      }
+      return s;
     } catch {
       return null;
     }
   }
+  /** The visitor of the session in use, or null before one is held. Backend conversations are keyed by it. */
+  visitorId() {
+    return this.session?.visitorId ?? null;
+  }
   /** Returns a valid visitor session, creating or refreshing it when needed. */
   ensureSession() {
+    if (this.sessionPromise) return this.sessionPromise;
     if (this.session && this.fresh(this.session)) return Promise.resolve(this.session);
-    return this.sessionPromise ??= this.loadSession().finally(() => this.sessionPromise = null);
+    const generation = this.sessionGeneration;
+    const promise = this.loadSession(generation).catch((error) => {
+      if (generation !== this.sessionGeneration) return this.supersededSessions.get(generation);
+      throw error;
+    }).finally(() => {
+      if (this.sessionPromise === promise) this.sessionPromise = null;
+      this.supersededSessions.delete(generation);
+    });
+    return this.sessionPromise = promise;
   }
-  async loadSession() {
+  async loadSession(generation) {
     if (!this.session) {
       const s = this.stored();
       if (s) {
-        if (this.fresh(s) && !(await this.getConfig()).identity) return this.session = s;
+        if (this.fresh(s)) {
+          const cfg = await this.getConfig();
+          if (generation !== this.sessionGeneration) return this.supersededSessions.get(generation);
+          if (!cfg.identity) return this.session = s;
+        }
         this.session = s;
       }
     }
-    return this.createSession();
+    return this.createSession(generation);
   }
-  async createSession() {
+  async createSession(generation) {
     const cfg = await this.getConfig();
+    if (generation !== this.sessionGeneration) return this.supersededSessions.get(generation);
     const body = {};
     const previous = this.session && !this.session.verified ? this.session : this.stored();
     if (previous?.token) body.token = previous.token;
@@ -462,9 +775,12 @@ var ApiClient = class {
         s = await post();
       }
     } catch (e) {
+      if (generation !== this.sessionGeneration) return this.supersededSessions.get(generation);
+      this.session = null;
       if (e instanceof ApiError && e.status === 401) tabStore.del(this.reuseKey);
       throw e;
     }
+    if (generation !== this.sessionGeneration) return this.supersededSessions.get(generation);
     const now = Date.now();
     const held = { ...s, obtainedAt: now };
     this.session = held;
@@ -494,8 +810,14 @@ var ApiClient = class {
    * stored anonymous visitor id is kept, so an anonymous visitor's history survives.
    */
   async renewSession() {
+    const previousGeneration = this.sessionGeneration;
+    const previous = this.sessionPromise;
+    this.sessionGeneration++;
     this.session = null;
-    return this.ensureSession();
+    this.sessionPromise = null;
+    const next = this.ensureSession();
+    if (previous) this.supersededSessions.set(previousGeneration, next);
+    return next;
   }
   /** Requests a single-use launch ticket. Does not refresh or swap the signed-in session after refusal. */
   async jobAccess(signal) {
@@ -547,8 +869,10 @@ var ApiClient = class {
     await this.ensureSession();
     let res = await this.request(this.url("chat"), { method: "POST", headers: await this.headers(true), body: JSON.stringify(input), signal });
     if (res.status === 401) {
+      const before = this.visitorId();
       this.forgetSession();
       await this.ensureSession();
+      if (input.actionsHash && this.visitorId() !== before) input = { ...input, actionsHash: void 0 };
       res = await this.request(this.url("chat"), { method: "POST", headers: await this.headers(true), body: JSON.stringify(input), signal });
     }
     if (!res.ok || !res.body) await this.parse(res);
@@ -821,7 +1145,10 @@ var en = {
   jobAccessOpened: "Job access opened in a new window. Review and confirm any permissions there.",
   jobAccessUnavailable: "Job access could not be opened. Sign in again or retry.",
   jobAccessPopupBlocked: "Allow popups for this site, then choose Job access again.",
-  jobAccessPopupClosed: "The window was closed. Choose Job access again to retry."
+  jobAccessPopupClosed: "The window was closed. Choose Job access again to retry.",
+  pageShare: "Share this page with the assistant for this message",
+  pageChanged: "The page changed. Review it and choose to share again before sending.",
+  pageUnavailable: "Page details are unavailable. You can send without them."
 };
 var vi = {
   title: "Tr\u1EE3 l\xFD",
@@ -881,7 +1208,10 @@ var vi = {
   jobAccessOpened: "\u0110\xE3 m\u1EDF c\u1EEDa s\u1ED5 quy\u1EC1n c\xF4ng vi\u1EC7c. H\xE3y xem l\u1EA1i v\xE0 x\xE1c nh\u1EADn quy\u1EC1n t\u1EA1i \u0111\xF3.",
   jobAccessUnavailable: "Ch\u01B0a m\u1EDF \u0111\u01B0\u1EE3c quy\u1EC1n c\xF4ng vi\u1EC7c. H\xE3y \u0111\u0103ng nh\u1EADp l\u1EA1i ho\u1EB7c th\u1EED l\u1EA1i.",
   jobAccessPopupBlocked: "Cho ph\xE9p c\u1EEDa s\u1ED5 b\u1EADt l\xEAn cho trang n\xE0y r\u1ED3i ch\u1ECDn Quy\u1EC1n c\xF4ng vi\u1EC7c l\u1EA7n n\u1EEFa.",
-  jobAccessPopupClosed: "C\u1EEDa s\u1ED5 \u0111\xE3 \u0111\xF3ng. Ch\u1ECDn Quy\u1EC1n c\xF4ng vi\u1EC7c l\u1EA7n n\u1EEFa \u0111\u1EC3 th\u1EED l\u1EA1i."
+  jobAccessPopupClosed: "C\u1EEDa s\u1ED5 \u0111\xE3 \u0111\xF3ng. Ch\u1ECDn Quy\u1EC1n c\xF4ng vi\u1EC7c l\u1EA7n n\u1EEFa \u0111\u1EC3 th\u1EED l\u1EA1i.",
+  pageShare: "Chia s\u1EBB trang n\xE0y v\u1EDBi tr\u1EE3 l\xFD trong tin nh\u1EAFn n\xE0y",
+  pageChanged: "Trang \u0111\xE3 thay \u0111\u1ED5i. H\xE3y xem l\u1EA1i v\xE0 ch\u1ECDn chia s\u1EBB tr\u01B0\u1EDBc khi g\u1EEDi.",
+  pageUnavailable: "Kh\xF4ng th\u1EC3 \u0111\u1ECDc n\u1ED9i dung trang. B\u1EA1n v\u1EABn c\xF3 th\u1EC3 g\u1EEDi tin nh\u1EAFn."
 };
 function pickStrings(locale) {
   const l = (locale || (typeof document !== "undefined" ? document.documentElement.lang : "") || (typeof navigator !== "undefined" ? navigator.language : "") || "en").toLowerCase();
@@ -901,6 +1231,40 @@ var icons = {
 };
 
 // src/widget/markdown.ts
+var imageObservers = /* @__PURE__ */ new WeakMap();
+var imageLoads = /* @__PURE__ */ new WeakMap();
+function disposeMarkdownImages(root) {
+  for (const image of root.querySelectorAll("img.md-image")) {
+    imageObservers.get(image)?.disconnect();
+    imageObservers.delete(image);
+    imageLoads.get(image)?.abort();
+    imageLoads.delete(image);
+  }
+}
+function safeImageSrc(doc, raw, allowed) {
+  try {
+    if (!raw || /[\u0000-\u0020\u007f\\]/.test(raw) || raw.startsWith("//")) return null;
+    const decoded = decodeURIComponent(raw);
+    if (/[\u0000-\u0020\u007f\\]/.test(decoded) || decoded.startsWith("//")) return null;
+    const page = new URL(doc.defaultView?.location.href ?? doc.baseURI);
+    const url = new URL(raw, doc.baseURI);
+    if (url.username || url.password || !["http:", "https:"].includes(url.protocol)) return null;
+    if (/\.svg$/i.test(decodeURIComponent(url.pathname))) return null;
+    if (url.origin === page.origin) return url.href;
+    if (url.protocol !== "https:") return null;
+    const trusted = allowed.some((item) => {
+      try {
+        const origin = new URL(item);
+        return origin.protocol === "https:" && !origin.username && !origin.password && origin.href === origin.origin + "/" && origin.origin === url.origin;
+      } catch {
+        return false;
+      }
+    });
+    return trusted ? url.href : null;
+  } catch {
+    return null;
+  }
+}
 function el(doc, tag, cls) {
   const e = doc.createElement(tag);
   if (cls) e.className = cls;
@@ -912,45 +1276,87 @@ function safeHref(url) {
   if (/^[/#?]/.test(u) && !u.startsWith("//")) return u;
   return null;
 }
-var INLINE_SRC = /(`+)([\s\S]*?[^`])\1(?!`)|\*\*([^*]+?)\*\*|__([^_]+?)__|~~([^~]+?)~~|\*([^*\s][^*]*?)\*|(?<![\w])_([^_\s][^_]*?)_(?![\w])|\[([^\]]+)\]\(([^)\s]+)(?:\s+"[^"]*")?\)|(https?:\/\/[^\s<>()]+[^\s<>().,;:!?'"])/;
-function renderInline(doc, text, parent) {
+var INLINE_SRC = /\\!\[[^\]]*\]\([^)\s]+\)|(`+)([\s\S]*?[^`])\1(?!`)|\*\*([^*]+?)\*\*|__([^_]+?)__|~~([^~]+?)~~|\*([^*\s][^*]*?)\*|(?<![\w])_([^_\s][^_]*?)_(?![\w])|(?<!\\)!\[([^\]]*)\]\(([^)\s]+)\)|\[([^\]]+)\]\(([^)\s]+)(?:\s+"[^"]*")?\)|(https?:\/\/[^\s<>()]+[^\s<>().,;:!?'"])/;
+function renderInline(doc, text, parent, options = {}) {
   const re = new RegExp(INLINE_SRC.source, "g");
   let last = 0;
   for (let m; m = re.exec(text); ) {
     if (m.index > last) parent.appendChild(doc.createTextNode(text.slice(last, m.index)));
     last = m.index + m[0].length;
-    if (m[2] !== void 0) {
+    if (m[0].startsWith("\\!")) {
+      parent.appendChild(doc.createTextNode(m[0].slice(1)));
+    } else if (m[2] !== void 0) {
       const c = el(doc, "code");
       c.textContent = m[2];
       parent.appendChild(c);
     } else if (m[3] !== void 0 || m[4] !== void 0) {
       const s = el(doc, "strong");
-      renderInline(doc, m[3] ?? m[4], s);
+      renderInline(doc, m[3] ?? m[4], s, options);
       parent.appendChild(s);
     } else if (m[5] !== void 0) {
       const s = el(doc, "del");
-      renderInline(doc, m[5], s);
+      renderInline(doc, m[5], s, options);
       parent.appendChild(s);
     } else if (m[6] !== void 0 || m[7] !== void 0) {
       const s = el(doc, "em");
-      renderInline(doc, m[6] ?? m[7], s);
+      renderInline(doc, m[6] ?? m[7], s, options);
       parent.appendChild(s);
     } else if (m[8] !== void 0) {
-      const href = safeHref(m[9]);
+      const original = options.deferImages ? null : safeImageSrc(doc, m[9], options.imageOrigins ?? []);
+      if (!original || !options.imageProxy) parent.appendChild(doc.createTextNode(m[8]));
+      else {
+        const img = el(doc, "img", "md-image");
+        img.alt = m[8];
+        img.setAttribute("loading", "lazy");
+        img.setAttribute("decoding", "async");
+        img.referrerPolicy = "no-referrer";
+        let retried = false;
+        const load = () => {
+          const controller = new AbortController();
+          imageLoads.set(img, controller);
+          return options.imageProxy(original, controller.signal).then((src) => {
+            if (!controller.signal.aborted && img.isConnected) img.src = src;
+          }).catch(() => {
+            if (!controller.signal.aborted && img.isConnected) img.replaceWith(doc.createTextNode(img.alt));
+          }).finally(() => {
+            if (imageLoads.get(img) === controller) imageLoads.delete(img);
+          });
+        };
+        img.addEventListener("error", () => {
+          if (!retried) {
+            retried = true;
+            void load();
+          } else img.replaceWith(doc.createTextNode(img.alt));
+        });
+        parent.appendChild(img);
+        const Observer = doc.defaultView?.IntersectionObserver;
+        if (Observer) {
+          const observer = new Observer((entries) => {
+            if (!entries.some((entry) => entry.isIntersecting)) return;
+            observer.disconnect();
+            imageObservers.delete(img);
+            if (img.parentNode) void load();
+          }, { rootMargin: "200px" });
+          imageObservers.set(img, observer);
+          observer.observe(img);
+        } else void load();
+      }
+    } else if (m[10] !== void 0) {
+      const href = safeHref(m[11]);
       if (href) {
         const a = el(doc, "a");
         a.href = href;
         a.target = "_blank";
         a.rel = "noopener noreferrer nofollow";
-        renderInline(doc, m[8], a);
+        renderInline(doc, m[10], a, options);
         parent.appendChild(a);
-      } else parent.appendChild(doc.createTextNode(m[8]));
-    } else if (m[10] !== void 0) {
+      } else parent.appendChild(doc.createTextNode(m[10]));
+    } else if (m[12] !== void 0) {
       const a = el(doc, "a");
-      a.href = m[10];
+      a.href = m[12];
       a.target = "_blank";
       a.rel = "noopener noreferrer nofollow";
-      a.textContent = m[10];
+      a.textContent = m[12];
       parent.appendChild(a);
     }
   }
@@ -958,7 +1364,7 @@ function renderInline(doc, text, parent) {
 }
 var isTableSep = (l) => /^\s*\|?\s*:?-{2,}:?\s*(\|\s*:?-{2,}:?\s*)*\|?\s*$/.test(l);
 var splitRow = (l) => l.trim().replace(/^\||\|$/g, "").split("|").map((c) => c.trim());
-function renderMarkdown(doc, src) {
+function renderMarkdown(doc, src, options = {}) {
   const frag = doc.createDocumentFragment();
   const lines = src.replace(/\r\n?/g, "\n").split("\n");
   let i = 0;
@@ -986,7 +1392,7 @@ function renderMarkdown(doc, src) {
     if (h) {
       const tag = `h${Math.min(6, h[1].length + 2)}`;
       const e = el(doc, tag);
-      renderInline(doc, h[2], e);
+      renderInline(doc, h[2], e, options);
       frag.appendChild(e);
       i++;
       continue;
@@ -1003,7 +1409,7 @@ function renderMarkdown(doc, src) {
       const tr = el(doc, "tr");
       for (const c of splitRow(line)) {
         const th = el(doc, "th");
-        renderInline(doc, c, th);
+        renderInline(doc, c, th, options);
         tr.appendChild(th);
       }
       thead.appendChild(tr);
@@ -1014,7 +1420,7 @@ function renderMarkdown(doc, src) {
         const r = el(doc, "tr");
         for (const c of splitRow(lines[i])) {
           const td = el(doc, "td");
-          renderInline(doc, c, td);
+          renderInline(doc, c, td, options);
           r.appendChild(td);
         }
         tbody.appendChild(r);
@@ -1029,7 +1435,7 @@ function renderMarkdown(doc, src) {
       const body = [];
       while (i < lines.length && /^\s*>/.test(lines[i])) body.push(lines[i++].replace(/^\s*>\s?/, ""));
       const q = el(doc, "blockquote");
-      q.appendChild(renderMarkdown(doc, body.join("\n")));
+      q.appendChild(renderMarkdown(doc, body.join("\n"), options));
       frag.appendChild(q);
       continue;
     }
@@ -1045,11 +1451,11 @@ function renderMarkdown(doc, src) {
         if (m[1].length > baseIndent) {
           const sub = [];
           while (i < lines.length && (/^\s+/.test(lines[i]) && lines[i].match(/^(\s*)/)[1].length > baseIndent)) sub.push(lines[i++].slice(baseIndent + 2));
-          list.lastElementChild?.appendChild(renderMarkdown(doc, sub.join("\n")));
+          list.lastElementChild?.appendChild(renderMarkdown(doc, sub.join("\n"), options));
           continue;
         }
         const item = el(doc, "li");
-        renderInline(doc, m[3], item);
+        renderInline(doc, m[3], item, options);
         list.appendChild(item);
         i++;
       }
@@ -1062,7 +1468,7 @@ function renderMarkdown(doc, src) {
     const p = el(doc, "p");
     para.forEach((l, idx) => {
       if (idx) p.appendChild(el(doc, "br"));
-      renderInline(doc, l, p);
+      renderInline(doc, l, p, options);
     });
     frag.appendChild(p);
   }
@@ -1260,6 +1666,7 @@ button { font: inherit; color: inherit; background: none; border: 0; cursor: poi
 .md li { margin: 3px 0; }
 .md h3, .md h4, .md h5, .md h6 { margin: 14px 0 6px; font-size: 15px; line-height: 1.35; }
 .md a { color: var(--dw-accent); text-decoration: underline; text-underline-offset: 2px; }
+.md .md-image { display: block; max-width: 100%; max-height: 320px; min-height: 48px; width: auto; height: auto; object-fit: contain; border-radius: 8px; }
 .md code { font-family: var(--dw-mono); font-size: .86em; background: var(--dw-surface); padding: 1.5px 5px; border-radius: 5px; }
 .md pre { background: #12132a; color: #e6e6f5; padding: 12px 14px; border-radius: 12px; overflow-x: auto; font-size: 12.5px; line-height: 1.55; }
 .md pre code { background: none; padding: 0; color: inherit; font-size: inherit; }
@@ -1354,6 +1761,9 @@ details > summary svg.ic { width: 14px; height: 14px; flex: none; }
 
 /* ---------- composer ---------- */
 .composer { padding: 10px 12px 12px; border-top: 1px solid var(--dw-border); background: var(--dw-bg); }
+.page-context { font-size: 12px; margin-bottom: 8px; }
+.page-context label { display: flex; align-items: center; gap: 6px; cursor: pointer; }
+.page-preview { max-height: 96px; overflow: auto; white-space: pre-wrap; overflow-wrap: anywhere; padding: 6px; margin: 6px 0; border: 1px solid var(--dw-border); border-radius: 6px; font: inherit; }
 .box {
   display: flex; align-items: flex-end; gap: 8px; border: 1px solid var(--dw-border); border-radius: 14px;
   padding: 6px 6px 6px 12px; background: var(--dw-bg); transition: border-color .15s, box-shadow .15s;
@@ -1386,7 +1796,7 @@ textarea::placeholder { color: var(--dw-muted); }
 
 // src/widget/element.ts
 var DEFAULT_COOLDOWN_MS = 5e3;
-var BOOL_ATTRS = ["show-reasoning", "show-tool-calls", "allow-agent-switch", "open", "persist", "hide-branding", "launcher-avatar"];
+var BOOL_ATTRS = ["show-reasoning", "show-tool-calls", "allow-agent-switch", "open", "persist", "hide-branding", "launcher-avatar", "dom-actions"];
 var ATTRS = [
   "endpoint",
   "agent",
@@ -1407,6 +1817,11 @@ var ATTRS = [
   "width",
   "height",
   "z-index",
+  "dom-actions-root",
+  "image-origins",
+  "page-context",
+  "context-selector",
+  "exclude-selectors",
   ...BOOL_ATTRS
 ];
 var camel = (s) => s.replace(/-([a-z])/g, (_, c) => c.toUpperCase());
@@ -1454,17 +1869,24 @@ var DeweeChatElement = class extends ElementBase {
   api = null;
   apiKey = "";
   server = null;
+  sharedPage;
+  preparingPage = false;
+  pagePending = false;
+  pageGeneration = 0;
   agentId = "";
   conversationId = "";
   messages = [];
   running = null;
   jobAccessLaunch = null;
   activated = false;
+  probedPage = false;
   strings = pickStrings();
   mql = null;
   registry = new ActionRegistry();
   propActionNames = /* @__PURE__ */ new Set();
   hooks = {};
+  /** Built-in DOM actions, created on first use when `domActions` is on (keeps the snapshot refs). */
+  dom = null;
   acks = /* @__PURE__ */ new Map();
   /** Pause after a RATE_LIMITED refusal; send stays disabled until it ends. */
   cooldown = new SendCooldown((s) => this.renderCooldown(s), () => this.endCooldown());
@@ -1482,6 +1904,8 @@ var DeweeChatElement = class extends ElementBase {
       if (v === null) continue;
       if (BOOL_ATTRS.includes(a)) c[camel(a)] = parseBool(v);
       else if (a === "suggestions") c.suggestions = v.trim().startsWith("[") ? safeJson(v, []) : v.split("|").map((s) => s.trim()).filter(Boolean);
+      else if (a === "image-origins") c.imageOrigins = v.trim().startsWith("[") ? safeJson(v, []) : v.split(",").map((s) => s.trim()).filter(Boolean);
+      else if (a === "exclude-selectors") c.excludeSelectors = v.trim().startsWith("[") ? safeJson(v, []) : v.split(",").map((s) => s.trim()).filter(Boolean);
       else if (a === "z-index") c.zIndex = Number(v);
       else c[camel(a)] = v;
     }
@@ -1489,13 +1913,18 @@ var DeweeChatElement = class extends ElementBase {
   }
   /** Updates configuration at runtime (wins over attributes). */
   configure(partial) {
-    const { actions, confirm, getPageContext, headers, fetch, ...rest } = partial;
+    const { actions, confirm, getPageContext, headers, fetch, domActionsRoot, contextProvider, ...rest } = partial;
     const has = (k) => Object.prototype.hasOwnProperty.call(partial, k);
     if (has("actions")) this.setPropActions(actions ?? []);
     if (has("confirm")) this.hooks.confirm = confirm;
     if (has("getPageContext")) this.hooks.getPageContext = getPageContext;
     if (has("headers")) this.hooks.headers = headers;
     if (has("fetch")) this.hooks.fetch = fetch;
+    if (has("contextProvider")) this.hooks.contextProvider = contextProvider;
+    if (has("domActionsRoot")) {
+      if (domActionsRoot === void 0) delete this.hooks.domActionsRoot;
+      else this.hooks.domActionsRoot = domActionsRoot;
+    }
     if (!Object.keys(rest).length) return;
     this.overrides = { ...this.overrides, ...rest };
     if (this.els) this.applyConfig();
@@ -1523,9 +1952,23 @@ var DeweeChatElement = class extends ElementBase {
   set fetch(v) {
     this.hooks.fetch = v;
   }
-  /** Names of the currently registered page actions. */
+  /** Names of the page actions offered to the agent (host actions, then enabled built-ins). */
   get actionNames() {
-    return this.registry.names();
+    return this.actionRegistry().names();
+  }
+  /** Host actions plus the enabled built-in DOM actions whose names the host did not take. */
+  actionRegistry() {
+    if (!this.config.domActions) return this.registry;
+    this.dom ??= createDomActions({
+      root: () => this.hooks.domActionsRoot ?? this.getAttribute("dom-actions-root") ?? void 0,
+      exclude: (el2) => el2 === this || this.contains(el2) || el2.closest("dewee-chat") !== null
+    });
+    const host = this.registry.names().map((n) => this.registry.get(n));
+    const room = ACTION_LIMITS.maxActions - host.length;
+    const builtins = this.dom.actions.filter((a) => !this.registry.get(a.name)).slice(0, Math.max(0, room));
+    const all = new ActionRegistry();
+    all.register([...host, ...builtins]);
+    return all;
   }
   setPropActions(actions) {
     const next = new Set(actions.map((a) => a.name));
@@ -1554,16 +1997,49 @@ var DeweeChatElement = class extends ElementBase {
   /** Sends a message programmatically (opens the widget first). */
   async send(text) {
     const message = text.trim();
-    if (!message || this.running || this.cooldown.active) return;
+    if (!message || this.running || this.preparingPage || this.cooldown.active) return;
     if (this.config.mode !== "inline" && !this.hasAttribute("data-open")) this.open();
     await this.activate();
+    let attachment;
+    if (this.els.pageChoice.checked) {
+      if (this.pagePending) {
+        this.showNotice(this.strings.pageUnavailable);
+        return;
+      }
+      this.preparingPage = true;
+      const generation = this.pageGeneration;
+      try {
+        const previous = this.sharedPage;
+        const current = await this.captureCurrentPage();
+        if (!this.els.pageChoice.checked || generation !== this.pageGeneration) return;
+        if (!previous || !current || this.pageFingerprint(previous) !== this.pageFingerprint(current)) {
+          this.sharedPage = current;
+          this.renderPagePreview();
+          this.els.pageChoice.checked = false;
+          this.showNotice(this.strings.pageChanged);
+          return;
+        }
+        attachment = current;
+      } catch {
+        this.sharedPage = void 0;
+        this.els.pageChoice.checked = false;
+        this.renderPagePreview();
+        this.showNotice(this.strings.pageUnavailable);
+        return;
+      } finally {
+        this.preparingPage = false;
+      }
+      this.els.pageChoice.checked = false;
+      this.sharedPage = void 0;
+      this.renderPagePreview();
+    }
     this.els.input.value = "";
     this.autosize();
     let next = { message, hidden: false };
     for (let round = 0; next; round++) {
-      const reply = await this.runTurn(next.message, next.hidden);
+      const reply = await this.runTurn(next.message, next.hidden, round === 0 ? attachment : void 0);
       next = null;
-      if (reply.status !== "done" || reply.stopped || !this.registry.size) break;
+      if (reply.status !== "done" || reply.stopped || !this.actionRegistry().size) break;
       const { calls } = parseDirectives(reply.content);
       if (!calls.length) break;
       reply.actions = calls.map((c) => ({ id: c.id, name: c.name, args: c.ok ? c.args : void 0, status: "pending" }));
@@ -1580,14 +2056,15 @@ var DeweeChatElement = class extends ElementBase {
     }
   }
   /** One request/response with the agent. */
-  async runTurn(message, hidden) {
+  async runTurn(message, hidden, attachment) {
     this.pushMessage({ role: "user", content: message, hidden });
     const reply = { role: "assistant", content: "", status: "streaming", startedAt: Date.now() };
     this.pushMessage(reply);
     this.setRunning(new AbortController());
     this.emit("dewee:send", { message, agent: this.agentId, conversationId: this.conversationId, auto: hidden || void 0 });
     try {
-      await this.client().chat(this.chatBody(message), (e) => this.onStreamEvent(reply, e), this.running.signal);
+      await this.client().ensureSession();
+      await this.client().chat({ ...this.chatBody(message), ...attachment ? { page_context: attachment } : {} }, (e) => this.onStreamEvent(reply, e), this.running.signal);
       if (reply.status === "streaming") reply.status = "done";
     } catch (e) {
       if (e.name === "AbortError") {
@@ -1603,7 +2080,7 @@ var DeweeChatElement = class extends ElementBase {
       this.updateMessage(reply);
       this.setRunning(null);
       if (reply.status === "done") {
-        if (reply.actionsHash && !reply.stopped) this.setAck(reply.actionsHash);
+        if (reply.actionsHash && reply.ackVisitor && !reply.stopped) this.setAck(reply.actionsHash, reply.ackVisitor);
         this.emit("dewee:reply", { content: reply.content, agent: this.agentId, conversationId: this.conversationId });
         if (this.config.mode !== "inline" && !this.hasAttribute("data-open")) this.setAttribute("data-unread", "");
       }
@@ -1612,9 +2089,11 @@ var DeweeChatElement = class extends ElementBase {
   }
   chatBody(message) {
     const body = { message, agent: this.agentId, conversationId: this.conversationId };
-    if (this.registry.size) {
-      body.actions = this.registry.manifest();
-      const ack = this.getAck();
+    const registry = this.actionRegistry();
+    if (registry.size) {
+      body.actions = registry.manifest();
+      const visitor = this.client().visitorId();
+      const ack = visitor ? this.getAck(visitor) : void 0;
       if (ack) body.actionsHash = ack;
     }
     const ctx = this.pageContext();
@@ -1637,15 +2116,21 @@ var DeweeChatElement = class extends ElementBase {
       return void 0;
     }
   }
-  ackKey() {
-    return `dewee-webchat:actions:${this.config.endpoint}:${this.agentId}:${this.conversationId}`;
+  /**
+   * The backend keys a conversation by visitor as well as by id, so a sign-in, a sign-out or another
+   * user starts a conversation that has not seen the manifest, even with the same conversation id.
+   */
+  ackKey(visitor) {
+    return `dewee-webchat:actions:${this.config.endpoint}:${this.agentId}:${visitor}:${this.conversationId}`;
   }
-  getAck() {
-    return this.acks.get(this.ackKey()) ?? (this.config.persist !== false ? store2.get(this.ackKey()) ?? void 0 : void 0);
+  getAck(visitor) {
+    const key = this.ackKey(visitor);
+    return this.acks.get(key) ?? (this.config.persist !== false ? store2.get(key) ?? void 0 : void 0);
   }
-  setAck(hash) {
-    this.acks.set(this.ackKey(), hash);
-    if (this.config.persist !== false) store2.set(this.ackKey(), hash);
+  setAck(hash, visitor) {
+    const key = this.ackKey(visitor);
+    this.acks.set(key, hash);
+    if (this.config.persist !== false) store2.set(key, hash);
   }
   /** Executes the calls of one answer in order. Resolves null when the visitor stopped the chain. */
   async runActions(reply, calls) {
@@ -1653,15 +2138,16 @@ var DeweeChatElement = class extends ElementBase {
     this.setRunning(ctrl);
     const results = [];
     const base = { agent: this.agentId, conversationId: this.conversationId };
+    const registry = this.actionRegistry();
     try {
       for (const [i, call] of calls.entries()) {
         const view = reply.actions[i];
-        const sensitivity = call.ok ? this.registry.get(call.name)?.sensitivity : void 0;
+        const sensitivity = call.ok ? registry.get(call.name)?.sensitivity : void 0;
         const args = call.ok ? call.args : void 0;
         this.emit("dewee:action", { phase: "start", id: call.id, name: call.name, sensitivity, args, ...base });
         const r = await runActionCall(call, {
-          registry: this.registry,
-          confirm: (action, a) => this.confirmAction(action, a, ctrl.signal),
+          registry,
+          confirm: (action, a) => this.confirmAction(registry, action, a, ctrl.signal),
           signal: ctrl.signal,
           timeoutMs: this.config.actionTimeoutMs,
           ...base,
@@ -1680,10 +2166,13 @@ var DeweeChatElement = class extends ElementBase {
     }
     return ctrl.signal.aborted ? null : results;
   }
-  confirmAction(action, args, signal) {
-    if (this.hooks.confirm) return this.hooks.confirm(action, args);
+  confirmAction(registry, action, args, signal) {
+    const builtin = this.dom?.actions.includes(registry.get(action.name));
+    const target = builtin ? this.dom.target(args) : void 0;
+    const shown = target ? { ...args, target } : args;
+    if (this.hooks.confirm) return this.hooks.confirm(action, shown);
     if (this.config.mode !== "inline" && !this.hasAttribute("data-open")) this.open();
-    return showConfirmDialog(this.els.panel, this.strings, action, args, signal);
+    return showConfirmDialog(this.els.panel, this.strings, action, shown, signal);
   }
   showNotice(text) {
     const div = document.createElement("div");
@@ -1811,6 +2300,12 @@ var DeweeChatElement = class extends ElementBase {
     }
   }
   disconnectedCallback() {
+    this.pageGeneration++;
+    this.sharedPage = void 0;
+    this.els.pageChoice.checked = false;
+    this.renderPagePreview();
+    disposeMarkdownImages(this.root);
+    for (const message of this.messages) if (message.view) message.view.mdKey = void 0;
     this.jobAccessLaunch?.abort();
     this.stop();
     this.mql?.removeEventListener("change", this.onScheme);
@@ -1892,6 +2387,8 @@ var DeweeChatElement = class extends ElementBase {
     e.jobAccess.setAttribute("aria-label", s.jobAccess);
     e.jobAccess.title = s.jobAccess;
     e.input.placeholder = c.placeholder || s.placeholder;
+    e.pageLabel.textContent = s.pageShare;
+    this.updatePageChoice();
     e.foot.hidden = !!c.hideBranding;
     e.foot.querySelector(".by").textContent = s.poweredBy + " ";
     this.renderSubtitle();
@@ -1899,11 +2396,16 @@ var DeweeChatElement = class extends ElementBase {
     if (this.activated && this.api && this.apiKey !== [c.endpoint, c.gatewayUrl, c.gatewayToken].join("|")) {
       this.activated = false;
       this.server = null;
+      this.probedPage = false;
+      this.activate();
+    } else if (this.activated && !this.probedPage && (c.pageContext === "metadata" || c.pageContext === "content")) {
+      this.activated = false;
       this.activate();
     } else if (this.activated && c.agent && c.agent !== this.agentId && this.server) {
       this.switchAgent(c.agent);
     } else if (this.activated) {
-      this.renderLog();
+      if (!this.messages.length) this.renderLog();
+      else for (const message of this.messages) this.updateMessage(message);
     }
   }
   renderShell() {
@@ -1924,6 +2426,7 @@ var DeweeChatElement = class extends ElementBase {
         <div class="log" part="log" role="log" aria-live="polite"></div>
         <div class="challenge"><slot name="challenge"></slot></div>
         <form class="composer" part="composer">
+          <div class="page-context" hidden><label><input type="checkbox" class="page-choice"> <span class="page-label"></span></label><pre class="page-preview" hidden></pre></div>
           <div class="cooldown" part="cooldown" aria-hidden="true" hidden></div>
           <div class="sr-only announcer" role="status" aria-live="polite"></div>
           <div class="box">
@@ -1950,7 +2453,11 @@ var DeweeChatElement = class extends ElementBase {
       close: $(".close"),
       foot: $(".foot"),
       cooldown: $(".cooldown"),
-      announcer: $(".announcer")
+      announcer: $(".announcer"),
+      pageChoice: $(".page-choice"),
+      pageWrap: $(".page-context"),
+      pageLabel: $(".page-label"),
+      pagePreview: $(".page-preview")
     };
     const e = this.els;
     e.launcher.addEventListener("click", () => this.toggle());
@@ -1962,6 +2469,9 @@ var DeweeChatElement = class extends ElementBase {
     e.jobAccess.addEventListener("click", () => {
       void this.openJobAccess();
     });
+    e.pageChoice.addEventListener("change", () => {
+      void this.choosePage();
+    });
     e.select.addEventListener("change", () => this.switchAgent(e.select.value));
     $("form").addEventListener("submit", (ev) => {
       ev.preventDefault();
@@ -1986,6 +2496,80 @@ var DeweeChatElement = class extends ElementBase {
     t.style.height = "auto";
     t.style.height = Math.min(t.scrollHeight, 140) + "px";
   }
+  updatePageChoice() {
+    const mode = this.config.pageContext;
+    const available = (mode === "metadata" || mode === "content") && this.server?.pageContextVersions?.includes(1) === true;
+    this.els.pageWrap.hidden = !available;
+    if (!available) {
+      this.pageGeneration++;
+      this.pagePending = false;
+      this.els.pageChoice.checked = false;
+      this.sharedPage = void 0;
+      this.renderPagePreview();
+    }
+  }
+  async captureCurrentPage() {
+    const c = this.config;
+    if (c.pageContext !== "metadata" && c.pageContext !== "content" || !this.server?.pageContextVersions?.includes(1)) return void 0;
+    const before = document.location.href;
+    const { capturePageContext, providedPageContext } = await import("./page-context-H3ZROFAV.js");
+    const provider = this.hooks.contextProvider;
+    const configKey = JSON.stringify([c.pageContext, c.contextSelector, c.excludeSelectors]);
+    const base = capturePageContext(document, { mode: provider ? "metadata" : c.pageContext, selector: c.contextSelector, excludeSelectors: c.excludeSelectors });
+    let result = base;
+    if (base && provider) {
+      let timer;
+      try {
+        const supplied = await Promise.race([provider(), new Promise((_, reject) => {
+          timer = setTimeout(() => reject(new Error("Page context timed out")), 5e3);
+        })]);
+        result = providedPageContext(supplied, base, c.pageContext);
+      } finally {
+        if (timer) clearTimeout(timer);
+      }
+    }
+    const now = this.config;
+    if (!this.isConnected || before !== document.location.href || provider !== this.hooks.contextProvider || configKey !== JSON.stringify([now.pageContext, now.contextSelector, now.excludeSelectors])) return void 0;
+    return result;
+  }
+  pageFingerprint(page) {
+    const { captured_at: _capturedAt, ...stable } = page;
+    return JSON.stringify(stable);
+  }
+  renderPagePreview() {
+    const preview = this.els.pagePreview;
+    preview.hidden = !this.sharedPage;
+    preview.textContent = this.sharedPage ? [this.sharedPage.title, this.sharedPage.url, this.sharedPage.description, this.sharedPage.selection, this.sharedPage.content?.text].filter(Boolean).join("\n\n") : "";
+  }
+  async choosePage() {
+    const generation = ++this.pageGeneration;
+    if (!this.els.pageChoice.checked) {
+      this.pagePending = false;
+      this.sharedPage = void 0;
+      this.renderPagePreview();
+      return;
+    }
+    this.sharedPage = void 0;
+    this.renderPagePreview();
+    this.pagePending = true;
+    try {
+      const page = await this.captureCurrentPage();
+      if (generation !== this.pageGeneration || !this.els.pageChoice.checked) return;
+      if (!page) throw new Error("Page unavailable");
+      this.sharedPage = page;
+      this.renderPagePreview();
+      this.emit("dewee:context-ready", { available: true });
+    } catch {
+      if (generation !== this.pageGeneration) return;
+      this.sharedPage = void 0;
+      this.els.pageChoice.checked = false;
+      this.renderPagePreview();
+      this.showNotice(this.strings.pageUnavailable);
+      this.emit("dewee:context-error", { code: "page_unavailable" });
+    } finally {
+      if (generation === this.pageGeneration) this.pagePending = false;
+    }
+  }
   updateSendButton() {
     const b = this.els.send;
     b.innerHTML = this.running ? icons.stop : icons.send;
@@ -2036,7 +2620,8 @@ var DeweeChatElement = class extends ElementBase {
     this.activated = true;
     this.renderLog();
     try {
-      this.server = await this.client().getConfig(true);
+      this.probedPage = this.config.pageContext === "metadata" || this.config.pageContext === "content";
+      this.server = await this.client().getConfig(true, this.probedPage);
       this.els.input.maxLength = this.server.maxMessageLength;
       const wanted = this.config.agent;
       const known = (id) => !!id && (this.server.agents.length === 0 || this.server.agents.some((a) => a.id === id));
@@ -2048,6 +2633,7 @@ var DeweeChatElement = class extends ElementBase {
       this.showError(null, e);
     }
     this.renderSubtitle();
+    this.updatePageChoice();
     this.emit("dewee:ready", { agent: this.agentId, config: this.server });
   }
   async switchAgent(id) {
@@ -2074,6 +2660,7 @@ var DeweeChatElement = class extends ElementBase {
   }
   renderLog() {
     const log = this.els.log;
+    disposeMarkdownImages(log);
     log.replaceChildren();
     if (!this.messages.length) log.appendChild(this.renderWelcome());
     for (const m of this.messages) log.appendChild(this.renderMessage(m));
@@ -2173,13 +2760,18 @@ var DeweeChatElement = class extends ElementBase {
       v.tools.clear();
     }
     v.trace.hidden = !v.trace.childElementCount;
-    const shown = this.registry.size || m.actions ? stripDirectives(m.content) : m.content;
+    const shown = this.actionRegistry().size || m.actions ? stripDirectives(m.content) : m.content;
     const typing = m.status === "streaming" && !shown;
     v.md.hidden = !typing && !shown && !!m.actions?.length;
-    if (typing) {
-      v.md.innerHTML = `<span class="typing" aria-label="${this.strings.thinking}"><i></i><i></i><i></i></span>`;
-    } else {
-      v.md.replaceChildren(renderMarkdown(document, shown));
+    const mdKey = JSON.stringify([shown, typing, m.status === "streaming", c.endpoint, c.imageOrigins, this.strings.thinking]);
+    if (v.mdKey !== mdKey) {
+      v.mdKey = mdKey;
+      disposeMarkdownImages(v.md);
+      if (typing) {
+        v.md.innerHTML = `<span class="typing" aria-label="${this.strings.thinking}"><i></i><i></i><i></i></span>`;
+      } else {
+        v.md.replaceChildren(renderMarkdown(document, shown, { imageOrigins: Array.isArray(c.imageOrigins) ? c.imageOrigins : [], imageProxy: (source, signal) => this.client().imageUrl(source, signal), deferImages: m.status === "streaming" }));
+      }
       v.md.classList.toggle("cursor", m.status === "streaming");
     }
     this.renderActions(v, m.actions ?? []);
@@ -2233,7 +2825,10 @@ var DeweeChatElement = class extends ElementBase {
   onStreamEvent(m, e) {
     switch (e.type) {
       case "start":
-        if (e.actionsHash) m.actionsHash = e.actionsHash;
+        if (e.actionsHash) {
+          m.actionsHash = e.actionsHash;
+          m.ackVisitor = this.client().visitorId() ?? void 0;
+        }
         if (e.conversationId && e.conversationId !== this.conversationId) {
           this.conversationId = e.conversationId;
           if (this.config.persist !== false) store2.set(this.convKey(), e.conversationId);
@@ -2416,6 +3011,7 @@ function mount(config = {}, target) {
 defineDeweeChat();
 
 export {
+  DOM_ACTION_NAMES,
   RESERVED_HEADERS,
   ApiError,
   ApiClient,