local-operator-ui 0.41.0 → 0.41.2

package/out/main/index.js

@@ -2423,6 +2423,7 @@ const desktopRequestUnion = zod.z.discriminatedUnion("op", [
   }).strict(),
   zod.z.object({
     op: zod.z.literal("team_bridge.conversations.create"),
+    expected_account_id: id$1.optional(),
     tenant_id: id$1.optional(),
     kind: zod.z.enum(["dm", "group", "channel"]),
     name: zod.z.string().min(1).max(128).optional(),
@@ -2440,6 +2441,8 @@ const desktopRequestUnion = zod.z.discriminatedUnion("op", [
   }).strict(),
   zod.z.object({
     op: zod.z.literal("team_bridge.conversations.lifecycle"),
+    expected_account_id: id$1.optional(),
+    tenant_id: id$1.optional(),
     conversation_id: id$1,
     action: zod.z.enum(["archive", "unarchive", "join", "leave"])
   }).strict(),
@@ -2456,17 +2459,20 @@ const desktopRequestUnion = zod.z.discriminatedUnion("op", [
    */
   zod.z.object({
     op: zod.z.literal("team_bridge.conversations.join"),
+    expected_account_id: id$1.optional(),
     conversation_id: id$1,
     tenant_id: id$1.optional()
   }).strict(),
   zod.z.object({
     op: zod.z.literal("team_bridge.conversations.notify"),
+    expected_account_id: id$1.optional(),
     conversation_id: id$1,
     tenant_id: id$1.optional(),
     notify: zod.z.enum(["all", "mention", "mute"])
   }).strict(),
   zod.z.object({
     op: zod.z.literal("team_bridge.conversations.members.add"),
+    expected_account_id: id$1.optional(),
     conversation_id: id$1,
     tenant_id: id$1.optional(),
     members: zod.z.array(
@@ -2480,11 +2486,14 @@ const desktopRequestUnion = zod.z.discriminatedUnion("op", [
   }).strict(),
   zod.z.object({
     op: zod.z.literal("team_bridge.conversations.members.remove"),
+    expected_account_id: id$1.optional(),
+    tenant_id: id$1.optional(),
     conversation_id: id$1,
     account_id: id$1
   }).strict(),
   zod.z.object({
     op: zod.z.literal("team_bridge.conversations.consent"),
+    expected_account_id: id$1.optional(),
     conversation_id: id$1,
     account_id: id$1,
     decision: zod.z.enum(["accept", "decline"]),
@@ -2509,6 +2518,7 @@ const desktopRequestUnion = zod.z.discriminatedUnion("op", [
   }).strict(),
   zod.z.object({
     op: zod.z.literal("team_bridge.messages.send"),
+    expected_account_id: id$1.optional(),
     conversation_id: id$1,
     tenant_id: id$1.optional(),
     client_ref: id$1,
@@ -2531,6 +2541,7 @@ const desktopRequestUnion = zod.z.discriminatedUnion("op", [
   }).strict(),
   zod.z.object({
     op: zod.z.literal("team_bridge.read"),
+    expected_account_id: id$1.optional(),
     conversation_id: id$1,
     tenant_id: id$1.optional(),
     seq: zod.z.number().int().nonnegative().optional(),
@@ -3058,6 +3069,14 @@ const desktopRequestUnion = zod.z.discriminatedUnion("op", [
 ]);
 const desktopRequestSchema = desktopRequestUnion.superRefine(
   (request, ctx) => {
+    if (request.op.startsWith("team_bridge.") && "expected_account_id" in request && request.expected_account_id && (!("tenant_id" in request) || !request.tenant_id)) {
+      ctx.addIssue({
+        code: zod.z.ZodIssueCode.custom,
+        path: ["tenant_id"],
+        message: "Guarded conversation writes require an explicit tenant"
+      });
+      return;
+    }
     if (request.op === "hub.skillPull" || request.op === "hub.skillSubscribe" || request.op === "hub.skillPublish") {
       if (request.visibility === "public" && request.tenantId !== null || request.visibility === "org" && !request.tenantId) {
         ctx.addIssue({
@@ -3631,6 +3650,13 @@ function harnessImportBody(request) {
     ...request.maxSessions === void 0 ? {} : { max_sessions: request.maxSessions }
   };
 }
+function conversationOwnerQuery(request) {
+  const query = new URLSearchParams();
+  if (request.tenant_id) query.set("tenant_id", request.tenant_id);
+  if (request.expected_account_id)
+    query.set("expected_account_id", request.expected_account_id);
+  return query.size ? `?${query.toString()}` : "";
+}
 function tenantQuery(tenantId) {
   return tenantId === void 0 ? "" : `?tenant_id=${encodeURIComponent(tenantId)}`;
 }
@@ -5026,6 +5052,7 @@ function desktopEndpoint(request) {
         path: "/v1/desktop/team-bridge/conversations",
         method: "POST",
         body: {
+          ...request.expected_account_id ? { expected_account_id: request.expected_account_id } : {},
           ...request.tenant_id ? { tenant_id: request.tenant_id } : {},
           kind: request.kind,
           ...request.name ? { name: request.name } : {},
@@ -5037,14 +5064,25 @@ function desktopEndpoint(request) {
       };
     case "team_bridge.conversations.lifecycle":
       return {
-        path: `/v1/desktop/team-bridge/conversations/${encodeURIComponent(request.conversation_id)}/${request.action}`,
-        method: "POST"
+        path: `/v1/desktop/team-bridge/conversations/${encodeURIComponent(request.conversation_id)}/${request.action}${request.action === "join" ? "" : conversationOwnerQuery(request)}`,
+        method: "POST",
+        ...request.action === "join" && (request.tenant_id || request.expected_account_id) ? {
+          body: {
+            ...request.tenant_id ? { tenant_id: request.tenant_id } : {},
+            ...request.expected_account_id ? { expected_account_id: request.expected_account_id } : {}
+          }
+        } : {}
       };
     case "team_bridge.conversations.join":
       return {
         path: `/v1/desktop/team-bridge/conversations/${encodeURIComponent(request.conversation_id)}/join`,
         method: "POST",
-        ...request.tenant_id ? { body: { tenant_id: request.tenant_id } } : {}
+        ...request.tenant_id || request.expected_account_id ? {
+          body: {
+            ...request.tenant_id ? { tenant_id: request.tenant_id } : {},
+            ...request.expected_account_id ? { expected_account_id: request.expected_account_id } : {}
+          }
+        } : {}
       };
     case "team_bridge.conversations.notify":
       return {
@@ -5053,6 +5091,7 @@ function desktopEndpoint(request) {
         path: `/v1/desktop/team-bridge/conversations/${encodeURIComponent(request.conversation_id)}/read`,
         method: "POST",
         body: {
+          ...request.expected_account_id ? { expected_account_id: request.expected_account_id } : {},
           ...request.tenant_id ? { tenant_id: request.tenant_id } : {},
           notify: request.notify
         }
@@ -5060,6 +5099,8 @@ function desktopEndpoint(request) {
     case "team_bridge.conversations.members.add": {
       const query = new URLSearchParams();
       if (request.tenant_id) query.set("tenant_id", request.tenant_id);
+      if (request.expected_account_id)
+        query.set("expected_account_id", request.expected_account_id);
       const suffix = query.size > 0 ? `?${query.toString()}` : "";
       return {
         path: `/v1/desktop/team-bridge/conversations/${encodeURIComponent(request.conversation_id)}/members${suffix}`,
@@ -5069,7 +5110,7 @@ function desktopEndpoint(request) {
     }
     case "team_bridge.conversations.members.remove":
       return {
-        path: `/v1/desktop/team-bridge/conversations/${encodeURIComponent(request.conversation_id)}/members/${encodeURIComponent(request.account_id)}`,
+        path: `/v1/desktop/team-bridge/conversations/${encodeURIComponent(request.conversation_id)}/members/${encodeURIComponent(request.account_id)}${conversationOwnerQuery(request)}`,
         method: "DELETE"
       };
     case "team_bridge.conversations.consent":
@@ -5077,6 +5118,7 @@ function desktopEndpoint(request) {
         path: `/v1/desktop/team-bridge/conversations/${encodeURIComponent(request.conversation_id)}/members/${encodeURIComponent(request.account_id)}/consent`,
         method: "POST",
         body: {
+          ...request.expected_account_id ? { expected_account_id: request.expected_account_id } : {},
           ...request.tenant_id ? { tenant_id: request.tenant_id } : {},
           decision: request.decision,
           consent_version: request.consent_version
@@ -5112,6 +5154,7 @@ function desktopEndpoint(request) {
         path: `/v1/desktop/team-bridge/conversations/${encodeURIComponent(request.conversation_id)}/messages`,
         method: "POST",
         body: {
+          ...request.expected_account_id ? { expected_account_id: request.expected_account_id } : {},
           ...request.tenant_id ? { tenant_id: request.tenant_id } : {},
           client_ref: request.client_ref,
           body: request.body,
@@ -5137,6 +5180,7 @@ function desktopEndpoint(request) {
         path: `/v1/desktop/team-bridge/conversations/${encodeURIComponent(request.conversation_id)}/read`,
         method: "POST",
         body: {
+          ...request.expected_account_id ? { expected_account_id: request.expected_account_id } : {},
           ...request.tenant_id ? { tenant_id: request.tenant_id } : {},
           ...request.seq === void 0 ? {} : { seq: request.seq },
           ...request.muted === void 0 ? {} : { muted: request.muted }
@@ -38790,9 +38834,6 @@ const enUiTeamBridge = {
   "ui.teamBridge.section.chiefs_empty": "No teammate has an agent on Team Bridge yet.",
   "ui.teamBridge.chief.label": "{agent} ({person})",
   "ui.teamBridge.chief.fallback": "Chief of staff",
-  "ui.teamBridge.chief.unnamed": "{person}’s chief of staff",
-  "ui.teamBridge.message.sending": "Sending…",
-  "ui.teamBridge.message.failed": "Not sent",
   "ui.teamBridge.people.self_named": "{name} (you)",
   "ui.teamBridge.row.menu": "More actions for {name}",
   "ui.teamBridge.row.start_group": "Start a group conversation",
@@ -42434,9 +42475,6 @@ const esUiTeamBridge = {
   "ui.teamBridge.section.chiefs_empty": "Ningún miembro del equipo tiene todavía un agente en Team Bridge.",
   "ui.teamBridge.chief.label": "{agent} ({person})",
   "ui.teamBridge.chief.fallback": "Jefe de gabinete",
-  "ui.teamBridge.chief.unnamed": "Jefe de gabinete de {person}",
-  "ui.teamBridge.message.sending": "Enviando…",
-  "ui.teamBridge.message.failed": "No enviado",
   "ui.teamBridge.people.self_named": "{name} (tú)",
   "ui.teamBridge.row.menu": "Más acciones para {name}",
   "ui.teamBridge.row.start_group": "Iniciar una conversación grupal",
@@ -46078,9 +46116,6 @@ const frUiTeamBridge = {
   "ui.teamBridge.section.chiefs_empty": "Aucun membre de l’équipe n’a encore d’agent sur Team Bridge.",
   "ui.teamBridge.chief.label": "{agent} ({person})",
   "ui.teamBridge.chief.fallback": "Cheffe de cabinet",
-  "ui.teamBridge.chief.unnamed": "Cheffe de cabinet ({person})",
-  "ui.teamBridge.message.sending": "Envoi…",
-  "ui.teamBridge.message.failed": "Non envoyé",
   "ui.teamBridge.people.self_named": "{name} (vous)",
   "ui.teamBridge.row.menu": "Plus d’actions pour {name}",
   "ui.teamBridge.row.start_group": "Démarrer une conversation de groupe",
@@ -49680,9 +49715,6 @@ const hiUiTeamBridge = {
   "ui.teamBridge.section.chiefs_empty": "अभी किसी टीम सदस्य का एजेंट Team Bridge पर नहीं है।",
   "ui.teamBridge.chief.label": "{agent} ({person})",
   "ui.teamBridge.chief.fallback": "चीफ़ ऑफ़ स्टाफ़",
-  "ui.teamBridge.chief.unnamed": "{person} के चीफ़ ऑफ़ स्टाफ़",
-  "ui.teamBridge.message.sending": "भेजा जा रहा है…",
-  "ui.teamBridge.message.failed": "भेजा नहीं गया",
   "ui.teamBridge.people.self_named": "{name} (आप)",
   "ui.teamBridge.row.menu": "{name} के लिए और कार्रवाइयाँ",
   "ui.teamBridge.row.start_group": "समूह बातचीत शुरू करें",
@@ -53302,9 +53334,6 @@ const ruUiTeamBridge = {
   "ui.teamBridge.section.chiefs_empty": "Ни у одного участника команды пока нет агента в Team Bridge.",
   "ui.teamBridge.chief.label": "{agent} ({person})",
   "ui.teamBridge.chief.fallback": "Координатор",
-  "ui.teamBridge.chief.unnamed": "Координатор ({person})",
-  "ui.teamBridge.message.sending": "Отправка…",
-  "ui.teamBridge.message.failed": "Не отправлено",
   "ui.teamBridge.people.self_named": "{name} (вы)",
   "ui.teamBridge.row.menu": "Другие действия для {name}",
   "ui.teamBridge.row.start_group": "Начать групповой разговор",
@@ -56924,9 +56953,6 @@ const urUiTeamBridge = {
   "ui.teamBridge.section.chiefs_empty": "ابھی ٹیم کے کسی رکن کا ایجنٹ Team Bridge پر نہیں۔",
   "ui.teamBridge.chief.label": "{agent} ({person})",
   "ui.teamBridge.chief.fallback": "چیف آف اسٹاف",
-  "ui.teamBridge.chief.unnamed": "{person} کے چیف آف اسٹاف",
-  "ui.teamBridge.message.sending": "بھیجا جا رہا ہے…",
-  "ui.teamBridge.message.failed": "بھیجا نہیں گیا",
   "ui.teamBridge.people.self_named": "{name} (آپ)",
   "ui.teamBridge.row.menu": "{name} کے مزید اقدامات",
   "ui.teamBridge.row.start_group": "گروپ گفتگو شروع کریں",
@@ -60355,9 +60381,6 @@ const viUiTeamBridge = {
   "ui.teamBridge.section.chiefs_empty": "Chưa có đồng nghiệp nào đưa tác nhân lên Team Bridge.",
   "ui.teamBridge.chief.label": "{agent} ({person})",
   "ui.teamBridge.chief.fallback": "Chánh văn phòng",
-  "ui.teamBridge.chief.unnamed": "Chánh văn phòng của {person}",
-  "ui.teamBridge.message.sending": "Đang gửi…",
-  "ui.teamBridge.message.failed": "Chưa gửi được",
   "ui.teamBridge.people.self_named": "{name} (bạn)",
   "ui.teamBridge.row.menu": "Thao tác khác cho {name}",
   "ui.teamBridge.row.start_group": "Bắt đầu trò chuyện nhóm",
@@ -63999,9 +64022,6 @@ const zhCNUiTeamBridge = {
   "ui.teamBridge.section.chiefs_empty": "还没有团队成员将智能体接入Team Bridge。",
   "ui.teamBridge.chief.label": "{agent}（{person}）",
   "ui.teamBridge.chief.fallback": "首席助理",
-  "ui.teamBridge.chief.unnamed": "{person}的首席助理",
-  "ui.teamBridge.message.sending": "发送中……",
-  "ui.teamBridge.message.failed": "未发送",
   "ui.teamBridge.people.self_named": "{name}（你）",
   "ui.teamBridge.row.menu": "{name}的更多操作",
   "ui.teamBridge.row.start_group": "发起群组对话",
@@ -64830,6 +64850,158 @@ function pageOf(view) {
     title: view.webContents.isDestroyed() ? "" : view.webContents.getTitle()
   };
 }
+const LABELLABLE = /* @__PURE__ */ new Set([
+  "checkbox",
+  "radio",
+  "switch",
+  "textbox",
+  "searchbox",
+  "combobox",
+  "listbox",
+  "spinbutton",
+  "slider",
+  "button"
+]);
+const CLICKABLE = /* @__PURE__ */ new Set([
+  "button",
+  "link",
+  "menuitem",
+  "menuitemcheckbox",
+  "menuitemradio",
+  "tab",
+  "option",
+  "treeitem",
+  "DisclosureTriangle",
+  "checkbox",
+  "radio",
+  "switch"
+]);
+function normalise(value) {
+  return String(value ?? "").replace(/\s+/g, " ").trim();
+}
+function readValue(raw) {
+  const text = raw.trim();
+  if (!text) return null;
+  const quote = text[0];
+  if (quote === '"' || quote === "'") {
+    let value = "";
+    for (let index = 1; index < text.length; index += 1) {
+      const char = text[index] ?? "";
+      if (char === "\\" && index + 1 < text.length) {
+        value += text[index + 1] ?? "";
+        index += 1;
+        continue;
+      }
+      if (char === quote) {
+        return index === text.length - 1 ? value : null;
+      }
+      value += char;
+    }
+    return null;
+  }
+  if (/[\[\]]/.test(text) || text.startsWith("*")) return null;
+  return text;
+}
+function parseLocator(value) {
+  const text = value.trim();
+  const match = /^(role|label|text)(\*?)=([\s\S]+)$/i.exec(text);
+  if (!match) return null;
+  const kind = (match[1] ?? "").toLowerCase();
+  const prefixSubstring = match[2] === "*";
+  const rest = (match[3] ?? "").trim();
+  if (kind === "role") {
+    const roleMatch = /^([A-Za-z][A-Za-z0-9_-]*)\s*(?:\[\s*name(\*?)=\s*([\s\S]+?)\s*\])?$/.exec(rest);
+    if (!roleMatch) return null;
+    const role = roleMatch[1] ?? "";
+    const substring = roleMatch[2] === "*";
+    const rawName = roleMatch[3];
+    const name2 = rawName === void 0 ? "" : readValue(rawName);
+    if (name2 === null) return null;
+    return { kind: "role", role: role.toLowerCase(), name: name2, substring };
+  }
+  const name = readValue(rest);
+  if (name === null) return null;
+  return { kind: kind === "label" ? "label" : "text", name, substring: prefixSubstring };
+}
+function matches(haystack, needle, substring) {
+  const left = normalise(haystack).toLowerCase();
+  const right = normalise(needle).toLowerCase();
+  if (!right) return false;
+  return substring ? left.includes(right) : left === right;
+}
+function candidateNodes(nodes) {
+  return nodes.filter((node) => !node.ignored && node.backendDOMNodeId !== void 0);
+}
+function resolveLocator(nodes, locator) {
+  const pool = candidateNodes(nodes);
+  const hits = [];
+  const consider = (role, name) => {
+    if (locator.kind === "role") {
+      if (role.toLowerCase() !== locator.role) return false;
+      if (locator.name && !matches(name, locator.name, locator.substring)) return false;
+      return true;
+    }
+    return matches(name, locator.name, locator.substring);
+  };
+  const collect = (accept) => {
+    for (const node of pool) {
+      const role = String(node.role?.value ?? "");
+      const name = normalise(node.name?.value);
+      if (!accept(role)) continue;
+      if (!consider(role, name)) continue;
+      hits.push({ backendNodeId: node.backendDOMNodeId, role, name, matched: 0 });
+    }
+  };
+  if (locator.kind === "role") {
+    collect(() => true);
+  } else if (locator.kind === "label") {
+    collect((role) => LABELLABLE.has(role));
+    if (!hits.length) collect((role) => CLICKABLE.has(role));
+  } else {
+    collect((role) => CLICKABLE.has(role));
+    if (!hits.length) collect(() => true);
+  }
+  const first = hits[0];
+  if (!first) return null;
+  return { ...first, matched: hits.length };
+}
+function locatorSuggestions(nodes, query, limit = 5) {
+  const wanted = normalise(query).toLowerCase();
+  const parsed = parseLocator(query);
+  const term = parsed ? parsed.name.toLowerCase() : wanted;
+  const words = term.split(/[^a-z0-9]+/).filter((word) => word.length > 1);
+  const wantedRole = parsed && parsed.kind === "role" ? parsed.role : "";
+  const scored = [];
+  for (const node of candidateNodes(nodes)) {
+    const role = String(node.role?.value ?? "");
+    const name = normalise(node.name?.value);
+    if (!name) continue;
+    const lowerName = name.toLowerCase();
+    let score = 0;
+    if (term && lowerName === term) score += 100;
+    else if (term && lowerName.includes(term)) score += 60;
+    for (const word of words) if (lowerName.includes(word)) score += 8;
+    if (wantedRole && role.toLowerCase() === wantedRole) score += 25;
+    if (CLICKABLE.has(role)) score += 4;
+    if (!score) continue;
+    scored.push({ score, role, name });
+  }
+  scored.sort((left, right) => right.score - left.score || left.name.localeCompare(right.name));
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const entry of scored) {
+    const key = `${entry.role}\0${entry.name}`;
+    if (seen.has(key)) continue;
+    seen.add(key);
+    out.push({ role: entry.role, name: entry.name, locator: locatorFor(entry.role, entry.name) });
+    if (out.length >= limit) break;
+  }
+  return out;
+}
+function locatorFor(role, name) {
+  const quoted = name.includes('"') && !name.includes("'") ? `'${name.replace(/\\/g, "\\\\")}'` : JSON.stringify(name);
+  return role && /^[A-Za-z][A-Za-z0-9_-]*$/.test(role) ? `role=${role}[name=${quoted}]` : `text=${quoted}`;
+}
 const FRAME_HOP = ">>>";
 const MAX_FRAME_DEPTH = 3;
 const MAX_FRAMES_SEARCHED = 20;
@@ -65080,7 +65252,7 @@ async function resolveHops(ctx, contents, hops) {
   return { scope, nodeId };
 }
 async function searchFrames(ctx, contents, selector) {
-  const matches = [];
+  const matches2 = [];
   const walk = await listFrames(ctx, contents);
   for (const scope of walk.frames) {
     const nodeId = await queryIn(ctx, contents, scope, selector).catch(
@@ -65089,9 +65261,9 @@ async function searchFrames(ctx, contents, selector) {
         return 0;
       }
     );
-    if (nodeId) matches.push({ scope, nodeId });
+    if (nodeId) matches2.push({ scope, nodeId });
   }
-  return { matches, walk };
+  return { matches: matches2, walk };
 }
 async function listFrames(ctx, contents) {
   const walk = {
@@ -65226,24 +65398,46 @@ async function editableInFrame(ctx, contents, scope, target2) {
 }
 const LANDMARKS = /* @__PURE__ */ new Set(["banner", "main", "navigation", "complementary", "contentinfo", "form", "region"]);
 const INTERACTIVE = /* @__PURE__ */ new Set(["button", "link", "textbox", "checkbox", "radio", "combobox", "menuitem", "tab", "switch", "slider", "spinbutton"]);
-function compactAX(nodes, epoch) {
+function stateSuffix(node) {
+  const truthy = (value) => value === true || value === "true";
+  const falsy = (value) => value === false || value === "false";
+  const property = (name) => node.properties?.find((entry) => entry.name === name)?.value.value;
+  const markers = [];
+  if (falsy(property("expanded"))) markers.push("collapsed");
+  const checked = property("checked");
+  if (truthy(checked)) markers.push("checked");
+  else if (checked === "mixed") markers.push("mixed");
+  if (truthy(property("disabled"))) markers.push("disabled");
+  return markers.length ? ` [${markers.join("] [")}]` : "";
+}
+function compactAX(nodes, epoch, options = {}) {
   const byId = new Map(nodes.map((node) => [node.nodeId, node]));
   const refs = {};
   const lines = [];
   let sequence = 0;
+  const scopeId = options.rootBackendNodeId;
+  let scopeAt = null;
+  let framesInScope = 0;
   const visited = /* @__PURE__ */ new Set();
   function visit2(node, depth) {
     if (visited.has(node.nodeId)) return;
     visited.add(node.nodeId);
+    const savedScope = scopeAt;
+    if (scopeAt === null && scopeId !== void 0 && node.backendDOMNodeId === scopeId) {
+      scopeAt = depth;
+    }
+    const inside2 = scopeId === void 0 || scopeAt !== null && depth >= scopeAt;
     if (node.ignored) {
       for (const child of node.childIds ?? []) {
         const found = byId.get(child);
         if (found) visit2(found, depth);
       }
+      scopeAt = savedScope;
       return;
     }
     const role = String(node.role?.value ?? "");
     const name = String(node.name?.value ?? "").trim();
+    if (inside2 && role === "Iframe") framesInScope += 1;
     const focusable = node.properties?.some((property) => property.name === "focusable" && property.value.value === true);
     const interesting = INTERACTIVE.has(role) || LANDMARKS.has(role) || focusable || Boolean(name && role !== "StaticText");
     if (interesting) {
@@ -65252,16 +65446,54 @@ function compactAX(nodes, epoch) {
         ref = `e${++sequence}`;
         refs[ref] = { backendNodeId: node.backendDOMNodeId, epoch };
       }
-      lines.push(`${"  ".repeat(depth)}- ${role || "node"}${name ? ` ${JSON.stringify(name)}` : ""}${ref ? ` [${ref}]` : ""}`);
+      if (inside2) {
+        const shown = depth - (scopeAt ?? 0);
+        lines.push(`${"  ".repeat(shown)}- ${role || "node"}${name ? ` ${JSON.stringify(name)}` : ""}${ref ? ` [${ref}]` : ""}${stateSuffix(node)}`);
+      }
     }
     for (const child of node.childIds ?? []) {
       const found = byId.get(child);
       if (found) visit2(found, interesting ? depth + 1 : depth);
     }
+    scopeAt = savedScope;
+  }
+  const scopedRoot = scopeId === void 0 ? void 0 : nodes.find((node) => node.backendDOMNodeId === scopeId);
+  if (scopeId !== void 0 && scopedRoot === void 0) {
+    return { snapshot: "", refs, framesInScope: 0, totalLines: 0, scoped: false };
   }
   const childIds = new Set(nodes.flatMap((node) => node.childIds ?? []));
   for (const root of nodes.filter((node) => !childIds.has(node.nodeId))) visit2(root, 0);
-  return { snapshot: lines.join("\n"), refs };
+  return {
+    snapshot: lines.join("\n"),
+    refs,
+    // Unscoped means "the whole page", and every frame is then read by the
+    // caller's own frame walk: the count exists only to explain a SCOPE.
+    framesInScope: scopeId === void 0 ? 0 : framesInScope,
+    totalLines: lines.length,
+    scoped: scopeId !== void 0
+  };
+}
+function windowSnapshot(text, options = {}) {
+  const lines = text ? text.split("\n").filter((line) => line.length > 0) : [];
+  const totalLines = lines.length;
+  const search = String(options.search ?? "").trim();
+  const matched = search ? lines.filter((line) => line.toLowerCase().includes(search.toLowerCase())) : lines;
+  const matchedLines = matched.length;
+  const requested = Number(options.start ?? 1);
+  const start = Number.isFinite(requested) && requested >= 1 ? Math.floor(requested) : 1;
+  const rawLimit = Number(options.limit ?? 0);
+  const limit = Number.isFinite(rawLimit) && rawLimit > 0 ? Math.floor(rawLimit) : 0;
+  const end = limit ? start - 1 + limit : matchedLines;
+  const page = matched.slice(start - 1, end);
+  return {
+    text: page.join("\n"),
+    totalLines,
+    matchedLines,
+    returnedLines: page.length,
+    start,
+    limit,
+    search
+  };
 }
 const PAGE_OVERLAP_PX = 80;
 function defaultScrollExpression() {
@@ -65341,6 +65573,8 @@ async function read(ctx, params) {
 async function snapshot(ctx, params) {
   const record = ctx.registry.requireSurface(params.tab);
   const contents = record.view.webContents;
+  const scope = stringParam(params, "selector");
+  const rootBackendNodeId = scope ? await backendNodeIdForSelector(ctx, record.view, scope) : void 0;
   await ctx.cdp.send(contents, "Accessibility.enable", {});
   let nodes = [];
   try {
@@ -65354,22 +65588,49 @@ async function snapshot(ctx, params) {
     await ctx.cdp.send(contents, "Accessibility.disable", {}).catch(() => {
     });
   }
-  const { snapshot: topRendered, refs: topRefs } = compactAX(
-    nodes,
-    record.epoch
-  );
+  const {
+    snapshot: topRendered,
+    refs: topRefs,
+    scoped,
+    framesInScope
+  } = compactAX(nodes, record.epoch, { rootBackendNodeId });
+  if (rootBackendNodeId !== void 0 && !scoped) {
+    throw new BridgeCommandError(
+      "element_not_found",
+      `selector ${scope} matched an element with no accessibility subtree (hidden, aria-hidden, or inside a collapsed section); expand it first, then snapshot again`
+    );
+  }
   const refs = { ...topRefs };
   let rendered = topRendered;
-  if (nodes.some(isFrameNode)) {
+  if (!scope && nodes.some(isFrameNode)) {
     const blocks = await frameSnapshots(ctx, record, nodes, refs);
     if (blocks.length) rendered = [rendered, ...blocks].join("\n");
   }
   record.refs = refs;
   ctx.registry.touch(record);
+  let note = "";
+  if (scope && framesInScope > 0) {
+    const frames = framesInScope;
+    note = `
+- (a scoped snapshot does not read frames: this section contains ${frames} frame${frames === 1 ? "" : "s"}; snapshot without selector= for their contents)`;
+  }
+  const page = windowSnapshot(rendered, {
+    search: stringParam(params, "search"),
+    start: numberParam(params, "start") ?? 1,
+    limit: numberParam(params, "limit") ?? 0
+  });
   return {
-    snapshot: rendered,
+    snapshot: page.text + note,
     refs: Object.keys(refs).length,
     epoch: record.epoch,
+    scoped,
+    frames_in_scope: framesInScope,
+    total_lines: page.totalLines,
+    matched_lines: page.matchedLines,
+    returned_lines: page.returnedLines,
+    start: page.start,
+    limit: page.limit,
+    search: page.search,
     ...pageOf(record.view)
   };
 }
@@ -65620,6 +65881,22 @@ async function nodeIdForSelector(ctx, view, selector) {
   }
   return queried.nodeId;
 }
+async function backendNodeIdForSelector(ctx, view, selector) {
+  const nodeId = await nodeIdForSelector(ctx, view, selector);
+  const described = await ctx.cdp.send(
+    view.webContents,
+    "DOM.describeNode",
+    { nodeId, depth: 0 }
+  );
+  const backendNodeId = described?.node?.backendNodeId;
+  if (backendNodeId === void 0) {
+    throw new BridgeCommandError(
+      "element_not_found",
+      `selector ${selector} has no backend node id`
+    );
+  }
+  return backendNodeId;
+}
 const CLICK_FUNCTION = `function () {
   const r = this.getBoundingClientRect();
   const cx = r.left + r.width / 2, cy = r.top + r.height / 2;
@@ -65718,9 +65995,33 @@ const READ_VALUE_FUNCTION = `function () {
   return String(this.textContent || '');
 }`;
 const SNAPSHOT_REF = /^e\d+$/;
+function resolvedFields(node) {
+  return node.resolvedBy === "locator" ? {
+    resolved: {
+      by: "locator",
+      role: node.role ?? "",
+      name: node.name ?? "",
+      matched: node.matched ?? 1
+    }
+  } : {};
+}
 function frameFields(node) {
   return node.frame ? { frame_origin: node.frame.origin ?? "" } : {};
 }
+async function readAccessibilityTree(ctx, contents) {
+  await ctx.cdp.send(contents, "Accessibility.enable", {});
+  try {
+    const tree = await ctx.cdp.send(
+      contents,
+      "Accessibility.getFullAXTree",
+      {}
+    );
+    return Array.isArray(tree?.nodes) ? tree.nodes : [];
+  } finally {
+    await ctx.cdp.send(contents, "Accessibility.disable", {}).catch(() => {
+    });
+  }
+}
 async function resolveNode(ctx, record, target2) {
   const view = record.view;
   const contents = view.webContents;
@@ -65745,6 +66046,39 @@ async function resolveNode(ctx, record, target2) {
     }
     return finishTop(ctx, contents, target2, pushedId, ref.frameOrigin);
   }
+  const locator = parseLocator(target2);
+  if (locator) {
+    const nodes = await readAccessibilityTree(ctx, contents);
+    const hit = resolveLocator(nodes, locator);
+    if (!hit) {
+      throw new BridgeCommandError(
+        "element_not_found",
+        `no element matches ${target2}`,
+        { candidates: locatorSuggestions(nodes, target2), matched: 0 }
+      );
+    }
+    await ctx.cdp.send(contents, "DOM.getDocument", { depth: 0 });
+    const pushed = await ctx.cdp.send(
+      contents,
+      "DOM.pushNodesByBackendIdsToFrontend",
+      { backendNodeIds: [hit.backendNodeId] }
+    );
+    const nodeId2 = pushed?.nodeIds?.[0];
+    if (nodeId2 === void 0) {
+      throw new BridgeCommandError(
+        "element_not_found",
+        `${target2} is no longer in the document`
+      );
+    }
+    const resolved = await finishTop(ctx, contents, target2, nodeId2);
+    return {
+      ...resolved,
+      resolvedBy: "locator",
+      role: hit.role,
+      name: hit.name,
+      matched: hit.matched
+    };
+  }
   const hops = parseFrameHops(target2);
   if (hops) {
     const hit = await resolveHops(ctx, contents, hops);
@@ -65757,8 +66091,8 @@ async function resolveNode(ctx, record, target2) {
     if (!(error instanceof BridgeCommandError) || !TOP_MISS.test(error.message)) {
       throw error;
     }
-    const { matches, walk } = await searchFrames(ctx, contents, target2);
-    if (matches.length === 0) {
+    const { matches: matches2, walk } = await searchFrames(ctx, contents, target2);
+    if (matches2.length === 0) {
       if (!walk.truncated && walk.skipped === 0 && walk.denied === 0)
         throw error;
       throw new BridgeCommandError(
@@ -65766,21 +66100,21 @@ async function resolveNode(ctx, record, target2) {
         `selector ${target2} matched nothing in the page itself or the frames searched (${walkNote(walk)}); address the frame explicitly as <iframe-selector> ${FRAME_HOP} <selector>`
       );
     }
-    if (matches.length === 1 && (walk.truncated || walk.skipped > 0)) {
-      const candidate = candidatePath(matches[0].scope, target2);
+    if (matches2.length === 1 && (walk.truncated || walk.skipped > 0)) {
+      const candidate = candidatePath(matches2[0].scope, target2);
       throw new BridgeCommandError(
         "element_not_found",
         `selector ${target2} matched nothing in the page itself and one element in the frames searched, but not every frame was searched (${walkNote(walk)}), so nothing was done; if this is the one, name it: ${candidate}`,
         { candidates: [candidate] }
       );
     }
-    if (matches.length > 1) {
-      const candidates = matches.map(
+    if (matches2.length > 1) {
+      const candidates = matches2.map(
         (match) => candidatePath(match.scope, target2)
       );
       throw new BridgeCommandError(
         "element_not_found",
-        `selector ${target2} matched nothing in the page itself and ${matches.length} elements inside its frames, so nothing was done; name one: ${candidates.join(", ")}`,
+        `selector ${target2} matched nothing in the page itself and ${matches2.length} elements inside its frames, so nothing was done; name one: ${candidates.join(", ")}`,
         { candidates }
       );
     }
@@ -65788,8 +66122,8 @@ async function resolveNode(ctx, record, target2) {
       ctx,
       contents,
       target2,
-      matches[0].scope,
-      matches[0].nodeId
+      matches2[0].scope,
+      matches2[0].nodeId
     );
   }
   return finishTop(ctx, contents, target2, nodeId);
@@ -65942,6 +66276,7 @@ async function click(ctx, params) {
   return {
     navigated: navigationSeen || after.url !== before,
     ...frameFields(node),
+    ...resolvedFields(node),
     ...after
   };
 }
@@ -65954,7 +66289,12 @@ async function type(ctx, params) {
   const typed = await typeInto(ctx, contents, node, text, target2);
   if (typed) {
     ctx.registry.touch(record);
-    return { ...typed, ...frameFields(node), ...pageOf(record.view) };
+    return {
+      ...typed,
+      ...frameFields(node),
+      ...resolvedFields(node),
+      ...pageOf(record.view)
+    };
   }
   const frame = await iframeScopeOf(ctx, contents, node);
   if (frame) {