local-operator-ui 0.41.1 → 0.42.0

package/out/main/index.js

@@ -200,6 +200,8 @@ zod.z.object({
     }).passthrough()
   }).passthrough()
 }).passthrough();
+const MAX_ATTACHMENT_UPLOAD_BYTES = 32 * 1024 * 1024;
+const DESKTOP_MESSAGE_MAX_FILES = 8;
 const SIDEBAR_DESTINATION_IDS = [
   "aida",
   "library",
@@ -213,9 +215,9 @@ const SIDEBAR_DESTINATION_IDS = [
 ];
 const JOURNAL_ORDER_QUERY_BYTES = 6 * 1024;
 const JOURNAL_ORDER_ID_LIMIT = 512;
-function appendJournalOrderIds(query, path2, ids) {
+function appendJournalOrderIds(query2, path2, ids) {
   let bytes = new TextEncoder().encode(
-    `${path2}${query.size ? `?${query}` : ""}`
+    `${path2}${query2.size ? `?${query2}` : ""}`
   ).length;
   const selected = [];
   for (const id2 of ids) {
@@ -223,7 +225,7 @@ function appendJournalOrderIds(query, path2, ids) {
     const encoded = new URLSearchParams({ order_ids: id2 }).toString();
     const extra = encoded.length + 1;
     if (bytes + extra > JOURNAL_ORDER_QUERY_BYTES) break;
-    query.append("order_ids", id2);
+    query2.append("order_ids", id2);
     selected.push(id2);
     bytes += extra;
   }
@@ -251,7 +253,21 @@ const libraryAssetId = zod.z.string().regex(/^la_[0-9a-f]{16}$/);
 const libraryTagId = zod.z.string().min(1).max(128).regex(/^[A-Za-z0-9_.:-]+$/);
 const sessionImage = zod.z.object({
   data_b64: zod.z.string().min(1).max(1e6),
-  mime_type: zod.z.enum(["image/png", "image/jpeg", "image/gif", "image/webp"])
+  mime_type: zod.z.enum(["image/png", "image/jpeg", "image/gif", "image/webp"]),
+  /**
+   * Where the image came from, when it came from disk. Provenance only: the
+   * daemon carries it to `ImageContent.path` and every provider serializer
+   * ignores it (attachment contract v1 §1.3). Absent on pasted images, which
+   * have no path.
+   */
+  origin_path: zod.z.string().max(4096).optional()
+}).strict();
+const sessionFile = zod.z.object({
+  digest: zod.z.string().regex(/^[0-9a-f]{32}$/),
+  name: zod.z.string().max(1024).optional(),
+  mime_type: zod.z.string().max(255).optional(),
+  bytes: zod.z.number().int().min(0).optional(),
+  path: zod.z.string().max(4096).optional()
 }).strict();
 const DESKTOP_MESSAGE_MAX_CHARS = 2e5;
 const DESKTOP_MESSAGE_MAX_IMAGES = 8;
@@ -1222,6 +1238,13 @@ const desktopRequestUnion = zod.z.discriminatedUnion("op", [
     requestId,
     text: zod.z.string().max(DESKTOP_MESSAGE_MAX_CHARS),
     images: zod.z.array(sessionImage).max(DESKTOP_MESSAGE_MAX_IMAGES).optional(),
+    /**
+     * Uploaded files this message references, bounded to the backend's
+     * `Prompt.files` ceiling. Absent rather than empty when the send carries
+     * none, so an older harness's `extra=forbid` sees a legacy body - the same
+     * rule the optional fields below follow.
+     */
+    files: zod.z.array(sessionFile).max(DESKTOP_MESSAGE_MAX_FILES).optional(),
     mode: zod.z.enum(["prompt", "steer"]).optional(),
     /*
      * HOW THE MESSAGE WAS PRODUCED (arch §4.2), and the harness gate is what
@@ -1318,7 +1341,28 @@ const desktopRequestUnion = zod.z.discriminatedUnion("op", [
      * its own sentence once the response row exists; this client does not
      * pre-judge that, it renders the owner's refusal.
      */
-    revise: zod.z.boolean().optional()
+    revise: zod.z.boolean().optional(),
+    /**
+     * PUT AN OPEN ASK AWAY instead of answering it (harness PR #2833, SA-D5).
+     *
+     * A modifier on the SAME `{ask_id}` body rather than a fourth op: a dismissal
+     * is the same epoch-free queued-ask door an answer is, addressed by an id that
+     * outlives any owner. Only `true` selects the shape — `false` is the same
+     * statement as omitting it — and the shape rules below refuse it beside
+     * answers/decline/revise, because no single body may answer and dismiss one ask.
+     *
+     * GATED ON `features.ask_dismiss` at the surface that offers the control: the
+     * backend's `Answer` is `extra="forbid"`, so an older daemon answers 422 to this
+     * field rather than ignoring it.
+     */
+    dismiss: zod.z.boolean().optional(),
+    /**
+     * Why the operator put it away: `answered_in_chat` (the conversation already
+     * answered it) or `moot` (no longer needed). Optional; the ask log records
+     * `moot` when absent. Refused without `dismiss: true` — the same no-op rule
+     * `revise` follows above.
+     */
+    reason: zod.z.enum(["answered_in_chat", "moot"]).optional()
   }).strict(),
   zod.z.object({
     op: zod.z.literal("sessions.seen"),
@@ -2423,6 +2467,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 +2485,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 +2503,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 +2530,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 +2562,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 +2585,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 +3113,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({
@@ -3147,7 +3210,22 @@ const desktopRequestSchema = desktopRequestUnion.superRefine(
             message: "ask_id must be a non-empty string",
             path: ["askId"]
           });
-        if (request.decline !== true && !request.answers)
+        if (request.dismiss === true) {
+          if (request.answers !== void 0 || request.decline === true || request.revise === true)
+            ctx.addIssue({
+              code: zod.z.ZodIssueCode.custom,
+              message: "A dismissal carries no answers, decline or revise",
+              path: ["dismiss"]
+            });
+          return;
+        }
+        if (request.reason !== void 0)
+          ctx.addIssue({
+            code: zod.z.ZodIssueCode.custom,
+            message: "A reason applies to a dismissal",
+            path: ["reason"]
+          });
+        else if (request.decline !== true && !request.answers)
           ctx.addIssue({
             code: zod.z.ZodIssueCode.custom,
             message: "A queued-ask answer needs answers or decline",
@@ -3191,6 +3269,18 @@ const desktopRequestSchema = desktopRequestUnion.superRefine(
           message: "revise applies to a queued ask",
           path: ["revise"]
         });
+      if (request.dismiss === true)
+        ctx.addIssue({
+          code: zod.z.ZodIssueCode.custom,
+          message: "dismiss applies to a queued ask",
+          path: ["dismiss"]
+        });
+      if (request.reason !== void 0)
+        ctx.addIssue({
+          code: zod.z.ZodIssueCode.custom,
+          message: "reason applies to a queued ask",
+          path: ["reason"]
+        });
       return;
     }
     if (request.op === "sessions.create" && request.purpose === void 0) {
@@ -3631,6 +3721,13 @@ function harnessImportBody(request) {
     ...request.maxSessions === void 0 ? {} : { max_sessions: request.maxSessions }
   };
 }
+function conversationOwnerQuery(request) {
+  const query2 = new URLSearchParams();
+  if (request.tenant_id) query2.set("tenant_id", request.tenant_id);
+  if (request.expected_account_id)
+    query2.set("expected_account_id", request.expected_account_id);
+  return query2.size ? `?${query2.toString()}` : "";
+}
 function tenantQuery(tenantId) {
   return tenantId === void 0 ? "" : `?tenant_id=${encodeURIComponent(tenantId)}`;
 }
@@ -3732,10 +3829,10 @@ function desktopEndpoint(request) {
     case "imports.sources":
       return { path: "/v1/desktop/imports/sources", method: "GET" };
     case "imports.sessions": {
-      const query = new URLSearchParams({ source: request.source });
-      if (request.includeSubagents) query.set("include_subagents", "true");
+      const query2 = new URLSearchParams({ source: request.source });
+      if (request.includeSubagents) query2.set("include_subagents", "true");
       return {
-        path: `/v1/desktop/imports/sessions?${query.toString()}`,
+        path: `/v1/desktop/imports/sessions?${query2.toString()}`,
         method: "GET"
       };
     }
@@ -4000,13 +4097,13 @@ function desktopEndpoint(request) {
         method: "POST"
       };
     case "sessions.search": {
-      const query = new URLSearchParams({
+      const query2 = new URLSearchParams({
         q: request.q,
         limit: String(request.limit ?? SESSION_SEARCH_DEFAULT_LIMIT)
       });
-      if (request.include_archived) query.set("include_archived", "true");
+      if (request.include_archived) query2.set("include_archived", "true");
       return {
-        path: `/v1/desktop/sessions/search?${query}`,
+        path: `/v1/desktop/sessions/search?${query2}`,
         method: "GET"
       };
     }
@@ -4086,23 +4183,23 @@ function desktopEndpoint(request) {
         }
       };
     case "sessions.get": {
-      const query = new URLSearchParams();
+      const query2 = new URLSearchParams();
       if (request.journalOrder) {
-        query.set("journal_order", "1");
-        if (request.peerJournalSource) query.set("peer_journal_source", "1");
+        query2.set("journal_order", "1");
+        if (request.peerJournalSource) query2.set("peer_journal_source", "1");
         appendJournalOrderIds(
-          query,
+          query2,
           `/v1/desktop/sessions/${request.sessionId}`,
           request.orderIds ?? []
         );
       }
       return {
-        path: `/v1/desktop/sessions/${request.sessionId}${query.size ? `?${query}` : ""}`,
+        path: `/v1/desktop/sessions/${request.sessionId}${query2.size ? `?${query2}` : ""}`,
         method: "GET"
       };
     }
     case "sessions.files": {
-      const query = new URLSearchParams({
+      const query2 = new URLSearchParams({
         limit: String(request.limit ?? 200)
       });
       for (const key of [
@@ -4114,10 +4211,10 @@ function desktopEndpoint(request) {
         "cursor"
       ]) {
         const value = request[key];
-        if (value !== void 0) query.set(key, value);
+        if (value !== void 0) query2.set(key, value);
       }
       return {
-        path: `/v1/desktop/sessions/${encodeURIComponent(request.sessionId)}/files?${query}`,
+        path: `/v1/desktop/sessions/${encodeURIComponent(request.sessionId)}/files?${query2}`,
         method: "GET"
       };
     }
@@ -4127,34 +4224,34 @@ function desktopEndpoint(request) {
         method: "POST"
       };
     case "sessions.history": {
-      const query = new URLSearchParams({
+      const query2 = new URLSearchParams({
         limit: String(request.limit ?? 100)
       });
-      if (request.beforeId) query.set("before_id", request.beforeId);
+      if (request.beforeId) query2.set("before_id", request.beforeId);
       if (request.openFrame) {
-        query.set("open_frame", "1");
-        query.set("supplements", "1");
+        query2.set("open_frame", "1");
+        query2.set("supplements", "1");
       }
       if (request.journalOrder) {
-        query.set("journal_order", "1");
-        if (request.peerJournalSource) query.set("peer_journal_source", "1");
+        query2.set("journal_order", "1");
+        if (request.peerJournalSource) query2.set("peer_journal_source", "1");
         if (request.sourceRead === "metadata")
-          query.set("source_read", "metadata");
+          query2.set("source_read", "metadata");
         else if (request.sourceRead === "payload" && request.expectedJournalGeneration)
-          query.set("source_read", "payload");
+          query2.set("source_read", "payload");
         if (request.expectedJournalGeneration)
-          query.set(
+          query2.set(
             "expected_journal_generation",
             request.expectedJournalGeneration
           );
         appendJournalOrderIds(
-          query,
+          query2,
           `/v1/desktop/sessions/${request.sessionId}/history`,
           request.orderIds ?? []
         );
       }
       return {
-        path: `/v1/desktop/sessions/${request.sessionId}/history?${query}`,
+        path: `/v1/desktop/sessions/${request.sessionId}/history?${query2}`,
         method: "GET"
       };
     }
@@ -4179,22 +4276,22 @@ function desktopEndpoint(request) {
         }
       };
     case "sessions.find": {
-      const query = new URLSearchParams({
+      const query2 = new URLSearchParams({
         q: request.q,
         limit: String(request.limit ?? THREAD_FIND_DEFAULT_LIMIT)
       });
       return {
-        path: `/v1/desktop/sessions/${request.sessionId}/find?${query}`,
+        path: `/v1/desktop/sessions/${request.sessionId}/find?${query2}`,
         method: "GET"
       };
     }
     case "subagents.transcript": {
-      const query = new URLSearchParams({
+      const query2 = new URLSearchParams({
         limit: String(request.limit ?? 100)
       });
-      if (request.beforeId) query.set("before_id", request.beforeId);
+      if (request.beforeId) query2.set("before_id", request.beforeId);
       return {
-        path: `/v1/desktop/sessions/${request.sessionId}/children/${request.childId}/transcript?${query}`,
+        path: `/v1/desktop/sessions/${request.sessionId}/children/${request.childId}/transcript?${query2}`,
         method: "GET"
       };
     }
@@ -4206,6 +4303,7 @@ function desktopEndpoint(request) {
           request_id: request.requestId,
           text: request.text,
           images: request.images ?? [],
+          ...request.files?.length ? { files: request.files } : {},
           mode: request.mode ?? "prompt",
           /*
            * ABSENT, not empty, when the app has nothing to say: an older harness
@@ -4246,7 +4344,16 @@ function desktopEndpoint(request) {
              * body that carried `revise: false` on every ordinary submit would be
              * asserting an intent it does not have.
              */
-            ...request.revise === true ? { revise: true } : {}
+            ...request.revise === true ? { revise: true } : {},
+            /*
+             * The dismissal modifier and its reason, on the same absent-when-not-
+             * asked-for rule: an older harness refuses the field outright
+             * (`extra="forbid"`), so an ordinary answer must not carry it.
+             */
+            ...request.dismiss === true ? {
+              dismiss: true,
+              ...request.reason !== void 0 ? { reason: request.reason } : {}
+            } : {}
           }
         };
       return {
@@ -4424,12 +4531,12 @@ function desktopEndpoint(request) {
         method: "DELETE"
       };
     case "legacy.models": {
-      const query = new URLSearchParams();
-      if (request.provider) query.set("provider", request.provider);
-      if (request.sort) query.set("sort", request.sort);
-      if (request.direction) query.set("direction", request.direction);
+      const query2 = new URLSearchParams();
+      if (request.provider) query2.set("provider", request.provider);
+      if (request.sort) query2.set("sort", request.sort);
+      if (request.direction) query2.set("direction", request.direction);
       return {
-        path: query.size > 0 ? `/v1/models?${query}` : "/v1/models",
+        path: query2.size > 0 ? `/v1/models?${query2}` : "/v1/models",
         method: "GET"
       };
     }
@@ -4444,12 +4551,12 @@ function desktopEndpoint(request) {
       return { path: `/v1/agents/${request.agentId}/upload`, method: "POST" };
     case "agent.publish": {
       assertPairedPublicationTarget(request);
-      const query = new URLSearchParams();
+      const query2 = new URLSearchParams();
       if (request.visibility === "org" && request.tenantId) {
-        query.set("visibility", "org");
-        query.set("tenant_id", request.tenantId);
+        query2.set("visibility", "org");
+        query2.set("tenant_id", request.tenantId);
       }
-      const search = query.toString();
+      const search = query2.toString();
       return {
         path: `/v1/agents/${request.agentId}/publish${search ? `?${search}` : ""}`,
         method: "POST",
@@ -4466,12 +4573,12 @@ function desktopEndpoint(request) {
     }
     case "agent.republish": {
       assertPairedPublicationTarget(request);
-      const query = new URLSearchParams();
+      const query2 = new URLSearchParams();
       if (request.visibility === "org" && request.tenantId) {
-        query.set("visibility", "org");
-        query.set("tenant_id", request.tenantId);
+        query2.set("visibility", "org");
+        query2.set("tenant_id", request.tenantId);
       }
-      const search = query.toString();
+      const search = query2.toString();
       return {
         path: `/v1/agents/${request.agentId}/publish${search ? `?${search}` : ""}`,
         method: "PUT",
@@ -4485,49 +4592,49 @@ function desktopEndpoint(request) {
     }
     case "team.publish": {
       assertPairedPublicationTarget(request);
-      const query = new URLSearchParams();
+      const query2 = new URLSearchParams();
       if (request.visibility === "org" && request.tenantId) {
-        query.set("visibility", "org");
-        query.set("tenant_id", request.tenantId);
+        query2.set("visibility", "org");
+        query2.set("tenant_id", request.tenantId);
       }
       return {
-        path: `/v1/teams/${request.teamId}/publish${query.size ? `?${query}` : ""}`,
+        path: `/v1/teams/${request.teamId}/publish${query2.size ? `?${query2}` : ""}`,
         method: "POST",
         body: publicationPolicyBody(request)
       };
     }
     case "team.pull": {
-      const query = new URLSearchParams();
-      if (request.tenantId) query.set("tenant_id", request.tenantId);
-      const search = query.toString();
+      const query2 = new URLSearchParams();
+      if (request.tenantId) query2.set("tenant_id", request.tenantId);
+      const search = query2.toString();
       return {
         path: `/v1/teams/pull/${request.teamId}${search ? `?${search}` : ""}`,
         method: "GET"
       };
     }
     case "agent.nameAvailability": {
-      const query = new URLSearchParams({ name: request.name });
-      return { path: `/v1/agent-name-availability?${query}`, method: "GET" };
+      const query2 = new URLSearchParams({ name: request.name });
+      return { path: `/v1/agent-name-availability?${query2}`, method: "GET" };
     }
     case "legacy.agents.list": {
-      const query = new URLSearchParams({
+      const query2 = new URLSearchParams({
         page: String(request.page ?? 1),
         per_page: String(request.perPage ?? 10)
       });
-      if (request.name) query.set("name", request.name);
-      if (request.sort) query.set("sort", request.sort);
-      if (request.direction) query.set("direction", request.direction);
-      return { path: `/v1/agents?${query}`, method: "GET" };
+      if (request.name) query2.set("name", request.name);
+      if (request.sort) query2.set("sort", request.sort);
+      if (request.direction) query2.set("direction", request.direction);
+      return { path: `/v1/agents?${query2}`, method: "GET" };
     }
     case "legacy.agent.get":
       return { path: `/v1/agents/${request.agentId}`, method: "GET" };
     case "legacy.agent.history": {
-      const query = new URLSearchParams({
+      const query2 = new URLSearchParams({
         page: String(request.page ?? 1),
         per_page: String(request.perPage ?? 10)
       });
       return {
-        path: `/v1/agents/${request.agentId}/history?${query}`,
+        path: `/v1/agents/${request.agentId}/history?${query2}`,
         method: "GET"
       };
     }
@@ -4537,13 +4644,13 @@ function desktopEndpoint(request) {
      * what the backend's models declare.
      */
     case "wakes.list": {
-      const query = new URLSearchParams();
+      const query2 = new URLSearchParams();
       if (request.limit !== void 0)
-        query.set("limit", String(request.limit));
+        query2.set("limit", String(request.limit));
       if (request.includeDormant !== void 0)
-        query.set("include_dormant", String(request.includeDormant));
+        query2.set("include_dormant", String(request.includeDormant));
       return {
-        path: query.size > 0 ? `/v1/desktop/wakes?${query}` : "/v1/desktop/wakes",
+        path: query2.size > 0 ? `/v1/desktop/wakes?${query2}` : "/v1/desktop/wakes",
         method: "GET"
       };
     }
@@ -4600,30 +4707,30 @@ function desktopEndpoint(request) {
         method: "POST"
       };
     case "legacy.jobs.list": {
-      const query = new URLSearchParams();
-      if (request.agentId) query.set("agent_id", request.agentId);
-      if (request.status) query.set("status", request.status);
+      const query2 = new URLSearchParams();
+      if (request.agentId) query2.set("agent_id", request.agentId);
+      if (request.status) query2.set("status", request.status);
       return {
-        path: query.size > 0 ? `/v1/jobs?${query}` : "/v1/jobs",
+        path: query2.size > 0 ? `/v1/jobs?${query2}` : "/v1/jobs",
         method: "GET"
       };
     }
     case "legacy.job.get":
       return { path: `/v1/jobs/${request.jobId}`, method: "GET" };
     case "legacy.schedules.list": {
-      const query = new URLSearchParams({
+      const query2 = new URLSearchParams({
         page: String(request.page ?? 1),
         per_page: String(request.perPage ?? 10)
       });
-      return { path: `/v1/schedules?${query}`, method: "GET" };
+      return { path: `/v1/schedules?${query2}`, method: "GET" };
     }
     case "legacy.agent.schedules.list": {
-      const query = new URLSearchParams({
+      const query2 = new URLSearchParams({
         page: String(request.page ?? 1),
         per_page: String(request.perPage ?? 10)
       });
       return {
-        path: `/v1/agents/${request.agentId}/schedules?${query}`,
+        path: `/v1/agents/${request.agentId}/schedules?${query2}`,
         method: "GET"
       };
     }
@@ -4688,29 +4795,29 @@ function desktopEndpoint(request) {
       };
     }
     case "usage.get": {
-      const query = new URLSearchParams({
+      const query2 = new URLSearchParams({
         live: String(request.live ?? false),
         refresh: String(request.refresh ?? false)
       });
-      if (request.provider) query.set("provider", request.provider);
-      return { path: `/v1/desktop/usage?${query}`, method: "GET" };
+      if (request.provider) query2.set("provider", request.provider);
+      return { path: `/v1/desktop/usage?${query2}`, method: "GET" };
     }
     case "quota.notice": {
-      const query = new URLSearchParams({
+      const query2 = new URLSearchParams({
         refresh: String(request.refresh ?? false)
       });
-      if (request.provider) query.set("provider", request.provider);
-      if (request.model) query.set("model", request.model);
-      return { path: `/v1/desktop/quota-notice?${query}`, method: "GET" };
+      if (request.provider) query2.set("provider", request.provider);
+      if (request.model) query2.set("model", request.model);
+      return { path: `/v1/desktop/quota-notice?${query2}`, method: "GET" };
     }
     case "analytics.get": {
-      const query = new URLSearchParams({ days: String(request.days ?? 30) });
-      if (request.sessionId) query.set("session_id", request.sessionId);
+      const query2 = new URLSearchParams({ days: String(request.days ?? 30) });
+      if (request.sessionId) query2.set("session_id", request.sessionId);
       if (request.sinceMs !== void 0)
-        query.set("since_ms", String(request.sinceMs));
+        query2.set("since_ms", String(request.sinceMs));
       if (request.untilMs !== void 0)
-        query.set("until_ms", String(request.untilMs));
-      return { path: `/v1/desktop/analytics?${query}`, method: "GET" };
+        query2.set("until_ms", String(request.untilMs));
+      return { path: `/v1/desktop/analytics?${query2}`, method: "GET" };
     }
     /*
      * `/analytics/models`, NOT `/analytics?models=1`.
@@ -4723,31 +4830,31 @@ function desktopEndpoint(request) {
      * the server resolves one window from either.
      */
     case "analytics.models": {
-      const query = new URLSearchParams({ days: String(request.days ?? 30) });
-      if (request.sessionId) query.set("session_id", request.sessionId);
+      const query2 = new URLSearchParams({ days: String(request.days ?? 30) });
+      if (request.sessionId) query2.set("session_id", request.sessionId);
       if (request.sinceMs !== void 0)
-        query.set("since_ms", String(request.sinceMs));
+        query2.set("since_ms", String(request.sinceMs));
       if (request.untilMs !== void 0)
-        query.set("until_ms", String(request.untilMs));
-      return { path: `/v1/desktop/analytics/models?${query}`, method: "GET" };
+        query2.set("until_ms", String(request.untilMs));
+      return { path: `/v1/desktop/analytics/models?${query2}`, method: "GET" };
     }
     case "info.get":
       return { path: "/v1/desktop/info", method: "GET" };
     case "sessions.report": {
-      const query = new URLSearchParams({
+      const query2 = new URLSearchParams({
         recent_limit: String(request.recentLimit ?? 12)
       });
       return {
-        path: `/v1/desktop/sessions/${request.sessionId}/report?${query}`,
+        path: `/v1/desktop/sessions/${request.sessionId}/report?${query2}`,
         method: "GET"
       };
     }
     case "skills.list": {
-      const query = new URLSearchParams();
-      if (request.sessionId) query.set("session_id", request.sessionId);
-      if (request.cwd) query.set("cwd", request.cwd);
-      if (request.name) query.set("name", request.name);
-      const encoded = query.toString();
+      const query2 = new URLSearchParams();
+      if (request.sessionId) query2.set("session_id", request.sessionId);
+      if (request.cwd) query2.set("cwd", request.cwd);
+      if (request.name) query2.set("name", request.name);
+      const encoded = query2.toString();
       return {
         path: `/v1/desktop/skills${encoded ? `?${encoded}` : ""}`,
         method: "GET"
@@ -4852,10 +4959,10 @@ function desktopEndpoint(request) {
         body: request.control
       };
     case "mcp.catalog": {
-      const query = new URLSearchParams();
-      if (request.cwd) query.set("cwd", request.cwd);
-      if (request.sessionId) query.set("session_id", request.sessionId);
-      const suffix = query.toString();
+      const query2 = new URLSearchParams();
+      if (request.cwd) query2.set("cwd", request.cwd);
+      if (request.sessionId) query2.set("session_id", request.sessionId);
+      const suffix = query2.toString();
       return {
         path: suffix ? `/v1/desktop/mcp?${suffix}` : "/v1/desktop/mcp",
         method: "GET"
@@ -5003,14 +5110,14 @@ function desktopEndpoint(request) {
         }
       };
     case "team_bridge.conversations.list": {
-      const query = new URLSearchParams();
-      if (request.scope === "account") query.set("scope", "account");
-      if (request.tenant_id) query.set("tenant_id", request.tenant_id);
+      const query2 = new URLSearchParams();
+      if (request.scope === "account") query2.set("scope", "account");
+      if (request.tenant_id) query2.set("tenant_id", request.tenant_id);
       if (request.limit !== void 0)
-        query.set("limit", String(request.limit));
-      if (request.cursor) query.set("cursor", request.cursor);
-      if (request.before) query.set("before", request.before);
-      const suffix = query.size > 0 ? `?${query.toString()}` : "";
+        query2.set("limit", String(request.limit));
+      if (request.cursor) query2.set("cursor", request.cursor);
+      if (request.before) query2.set("before", request.before);
+      const suffix = query2.size > 0 ? `?${query2.toString()}` : "";
       return {
         path: `/v1/desktop/team-bridge/conversations${suffix}`,
         method: "GET"
@@ -5026,6 +5133,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 +5145,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,14 +5172,17 @@ 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
         }
       };
     case "team_bridge.conversations.members.add": {
-      const query = new URLSearchParams();
-      if (request.tenant_id) query.set("tenant_id", request.tenant_id);
-      const suffix = query.size > 0 ? `?${query.toString()}` : "";
+      const query2 = new URLSearchParams();
+      if (request.tenant_id) query2.set("tenant_id", request.tenant_id);
+      if (request.expected_account_id)
+        query2.set("expected_account_id", request.expected_account_id);
+      const suffix = query2.size > 0 ? `?${query2.toString()}` : "";
       return {
         path: `/v1/desktop/team-bridge/conversations/${encodeURIComponent(request.conversation_id)}/members${suffix}`,
         method: "POST",
@@ -5069,7 +5191,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,20 +5199,21 @@ 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
         }
       };
     case "team_bridge.messages.list": {
-      const query = new URLSearchParams();
-      if (request.tenant_id) query.set("tenant_id", request.tenant_id);
+      const query2 = new URLSearchParams();
+      if (request.tenant_id) query2.set("tenant_id", request.tenant_id);
       if (request.limit !== void 0)
-        query.set("limit", String(request.limit));
+        query2.set("limit", String(request.limit));
       if (request.before_seq !== void 0)
-        query.set("before_seq", String(request.before_seq));
-      if (request.endpoint_id) query.set("endpoint_id", request.endpoint_id);
-      const suffix = query.size > 0 ? `?${query.toString()}` : "";
+        query2.set("before_seq", String(request.before_seq));
+      if (request.endpoint_id) query2.set("endpoint_id", request.endpoint_id);
+      const suffix = query2.size > 0 ? `?${query2.toString()}` : "";
       return {
         path: `/v1/desktop/team-bridge/conversations/${encodeURIComponent(request.conversation_id)}/messages${suffix}`,
         method: "GET"
@@ -5112,6 +5235,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,
@@ -5120,13 +5244,13 @@ function desktopEndpoint(request) {
         }
       };
     case "team_bridge.messages.replies": {
-      const query = new URLSearchParams();
-      if (request.tenant_id) query.set("tenant_id", request.tenant_id);
+      const query2 = new URLSearchParams();
+      if (request.tenant_id) query2.set("tenant_id", request.tenant_id);
       if (request.limit !== void 0)
-        query.set("limit", String(request.limit));
+        query2.set("limit", String(request.limit));
       if (request.after_seq !== void 0)
-        query.set("after_seq", String(request.after_seq));
-      const suffix = query.size > 0 ? `?${query.toString()}` : "";
+        query2.set("after_seq", String(request.after_seq));
+      const suffix = query2.size > 0 ? `?${query2.toString()}` : "";
       return {
         path: `/v1/desktop/team-bridge/conversations/${encodeURIComponent(request.conversation_id)}/messages/${encodeURIComponent(request.message_id)}/replies${suffix}`,
         method: "GET"
@@ -5137,16 +5261,17 @@ 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 }
         }
       };
     case "team_bridge.unread": {
-      const query = new URLSearchParams();
-      if (request.scope === "account") query.set("scope", "account");
-      else if (request.tenant_id) query.set("tenant_id", request.tenant_id);
-      const suffix = query.size > 0 ? `?${query.toString()}` : "";
+      const query2 = new URLSearchParams();
+      if (request.scope === "account") query2.set("scope", "account");
+      else if (request.tenant_id) query2.set("tenant_id", request.tenant_id);
+      const suffix = query2.size > 0 ? `?${query2.toString()}` : "";
       return {
         path: `/v1/desktop/team-bridge/unread${suffix}`,
         method: "GET"
@@ -5174,9 +5299,9 @@ function desktopEndpoint(request) {
      * op would emit for a missing value.
      */
     case "team_bridge.status": {
-      const query = new URLSearchParams();
-      if (request.boundary) query.set("boundary", request.boundary);
-      const suffix = query.size > 0 ? `?${query.toString()}` : "";
+      const query2 = new URLSearchParams();
+      if (request.boundary) query2.set("boundary", request.boundary);
+      const suffix = query2.size > 0 ? `?${query2.toString()}` : "";
       return {
         path: `/v1/desktop/team-bridge/status${suffix}`,
         method: "GET"
@@ -5235,29 +5360,29 @@ function desktopEndpoint(request) {
      * `op` because that key already names the desktop operation.
      */
     case "library.list": {
-      const query = new URLSearchParams();
-      if (request.scope) query.set("scope", request.scope);
-      if (request.q) query.set("q", request.q);
-      if (request.category) query.set("category", request.category);
-      if (request.kind) query.set("kind", request.kind);
-      if (request.origin_group) query.set("origin_group", request.origin_group);
-      if (request.origin) query.set("origin", request.origin);
-      if (request.tag) query.set("tag", request.tag);
-      if (request.tag_mode) query.set("tag_mode", request.tag_mode);
+      const query2 = new URLSearchParams();
+      if (request.scope) query2.set("scope", request.scope);
+      if (request.q) query2.set("q", request.q);
+      if (request.category) query2.set("category", request.category);
+      if (request.kind) query2.set("kind", request.kind);
+      if (request.origin_group) query2.set("origin_group", request.origin_group);
+      if (request.origin) query2.set("origin", request.origin);
+      if (request.tag) query2.set("tag", request.tag);
+      if (request.tag_mode) query2.set("tag_mode", request.tag_mode);
       if (request.highlighted !== void 0)
-        query.set("highlighted", request.highlighted ? "1" : "0");
+        query2.set("highlighted", request.highlighted ? "1" : "0");
       if (request.organized !== void 0)
-        query.set("organized", request.organized ? "1" : "0");
+        query2.set("organized", request.organized ? "1" : "0");
       if (request.favorite !== void 0)
-        query.set("favorite", request.favorite ? "1" : "0");
-      if (request.session) query.set("session", request.session);
-      if (request.session_id) query.set("session_id", request.session_id);
-      if (request.sort) query.set("sort", request.sort);
-      if (request.order) query.set("order", request.order);
+        query2.set("favorite", request.favorite ? "1" : "0");
+      if (request.session) query2.set("session", request.session);
+      if (request.session_id) query2.set("session_id", request.session_id);
+      if (request.sort) query2.set("sort", request.sort);
+      if (request.order) query2.set("order", request.order);
       if (request.limit !== void 0)
-        query.set("limit", String(request.limit));
-      if (request.cursor) query.set("cursor", request.cursor);
-      const suffix = query.toString();
+        query2.set("limit", String(request.limit));
+      if (request.cursor) query2.set("cursor", request.cursor);
+      const suffix = query2.toString();
       return {
         path: `/v1/desktop/library/assets${suffix ? `?${suffix}` : ""}`,
         method: "GET"
@@ -5418,12 +5543,12 @@ function desktopEndpoint(request) {
         method: "POST"
       };
     case "projects.search": {
-      const query = new URLSearchParams({
+      const query2 = new URLSearchParams({
         q: request.q,
         limit: String(request.limit ?? PROJECTS_SEARCH_DEFAULT_LIMIT)
       });
       return {
-        path: `/v1/desktop/projects/search?${query}`,
+        path: `/v1/desktop/projects/search?${query2}`,
         method: "GET"
       };
     }
@@ -5823,6 +5948,187 @@ function windowGlassArgument(state2, scheme) {
   const { settings, capability } = state2;
   return `${WINDOW_GLASS_ARG}=${capability.mechanism}:${settings.coverage}:${settings.intensity}:${settings.material}:${scheme}`;
 }
+const UPLOAD_DEADLINE_MS = 5 * 6e4;
+const DIGEST_SHAPE = /^[0-9a-f]{32}$/;
+const PATH_SEPARATOR = /[/\\]/;
+const basenameOf = (filePath) => filePath.split(PATH_SEPARATOR).pop() || filePath;
+function bytesFromDataUrl(dataUrl) {
+  const comma = dataUrl.indexOf(",");
+  if (comma < 0 || !dataUrl.startsWith("data:")) return null;
+  const header = dataUrl.slice(5, comma);
+  const payload = dataUrl.slice(comma + 1);
+  try {
+    if (header.endsWith(";base64"))
+      return new Uint8Array(Buffer.from(payload, "base64"));
+    return new Uint8Array(Buffer.from(decodeURIComponent(payload), "utf8"));
+  } catch {
+    return null;
+  }
+}
+function readRecord(payload) {
+  if (payload === null || typeof payload !== "object") return null;
+  const body = payload;
+  const inner = body.result;
+  if (inner !== null && typeof inner === "object")
+    return inner;
+  return body;
+}
+function toAttachment(payload) {
+  const record = readRecord(payload);
+  if (!record) return null;
+  const digest = record.digest;
+  const mime = record.mime_type;
+  const bytes = record.bytes;
+  if (typeof digest !== "string" || !DIGEST_SHAPE.test(digest)) return null;
+  if (typeof mime !== "string" || mime.length === 0) return null;
+  if (typeof bytes !== "number" || !Number.isFinite(bytes) || bytes < 0)
+    return null;
+  return {
+    digest,
+    name: typeof record.name === "string" ? record.name : null,
+    mime_type: mime,
+    bytes,
+    path: typeof record.path === "string" ? record.path : null,
+    stored_path: typeof record.stored_path === "string" ? record.stored_path : null
+  };
+}
+function refusalDetail(payload) {
+  if (payload === null || typeof payload !== "object") return null;
+  const detail = payload.detail;
+  if (typeof detail === "string" && detail.trim()) return detail;
+  if (detail !== null && typeof detail === "object") {
+    const message = detail.message;
+    if (typeof message === "string" && message.trim()) return message;
+  }
+  return null;
+}
+async function uploadAttachment(input) {
+  const cap = input.maxBytes ?? MAX_ATTACHMENT_UPLOAD_BYTES;
+  const source = input.source;
+  const displayName = source.name?.trim() || (source.kind === "path" ? basenameOf(source.path) : "pasted-file");
+  let originPath = null;
+  let size;
+  if (source.kind === "path") {
+    const filePath = source.path;
+    originPath = filePath;
+    try {
+      const stat = fs.statSync(filePath, { throwIfNoEntry: false });
+      if (!stat) {
+        return {
+          success: false,
+          code: "not-found",
+          error: `No file at ${filePath}`
+        };
+      }
+      if (!stat.isFile()) {
+        return {
+          success: false,
+          code: "not-a-file",
+          error: `${filePath} is not a regular file`
+        };
+      }
+      size = stat.size;
+    } catch (error) {
+      return {
+        success: false,
+        code: "unreadable",
+        error: error instanceof Error ? error.message : String(error)
+      };
+    }
+  } else {
+    const decoded = bytesFromDataUrl(source.dataUrl);
+    if (!decoded) {
+      return {
+        success: false,
+        code: "unreadable",
+        error: `${displayName} did not carry usable bytes`
+      };
+    }
+    size = decoded.byteLength;
+  }
+  if (size === 0) {
+    return {
+      success: false,
+      code: "refused",
+      error: `${displayName} is empty`,
+      sizeBytes: 0
+    };
+  }
+  if (size > cap) {
+    return {
+      success: false,
+      code: "too-large",
+      error: `${displayName} is ${size} bytes, over the ${cap}-byte attachment limit`,
+      sizeBytes: size
+    };
+  }
+  let bytes;
+  try {
+    bytes = source.kind === "path" ? new Uint8Array(fs.readFileSync(source.path)) : bytesFromDataUrl(source.dataUrl);
+  } catch (error) {
+    return {
+      success: false,
+      code: "unreadable",
+      error: error instanceof Error ? error.message : String(error)
+    };
+  }
+  const form = new FormData();
+  form.append(
+    "file",
+    new Blob([bytes], {
+      type: "application/octet-stream"
+    }),
+    displayName
+  );
+  form.append("name", displayName);
+  if (originPath) form.append("origin_path", originPath);
+  let response;
+  try {
+    const doFetch = input.fetchImpl ?? fetch;
+    response = await doFetch(
+      new URL("/v1/desktop/attachments", input.backendUrl),
+      {
+        method: "POST",
+        headers: {
+          Accept: "application/json",
+          ...input.token ? { Authorization: `Bearer ${input.token}` } : {}
+        },
+        body: form,
+        redirect: "error",
+        signal: AbortSignal.timeout(UPLOAD_DEADLINE_MS)
+      }
+    );
+  } catch (error) {
+    return {
+      success: false,
+      code: "unreachable",
+      error: error instanceof Error ? error.message : "The daemon did not answer the upload."
+    };
+  }
+  let payload = null;
+  try {
+    payload = await response.json();
+  } catch {
+  }
+  if (response.status < 200 || response.status >= 300) {
+    return {
+      success: false,
+      code: "refused",
+      error: refusalDetail(payload) ?? `The daemon refused the upload (HTTP ${response.status}).`,
+      sizeBytes: size
+    };
+  }
+  const attachment = toAttachment(payload);
+  if (!attachment) {
+    return {
+      success: false,
+      code: "refused",
+      error: `${displayName} was uploaded but the daemon's answer carried no attachment record.`,
+      sizeBytes: size
+    };
+  }
+  return { success: true, attachment };
+}
 const SERVE_RUN_DIRNAME = "run/serve";
 const REAPED_DIRNAME = "reaped";
 const REAPED_MAX_FILES = 200;
@@ -9422,25 +9728,25 @@ class DesktopStreamRelay {
     const streamId = node_crypto.randomBytes(16).toString("hex");
     const controller = new AbortController();
     this.streams.set(streamId, controller);
-    const query = new URLSearchParams();
-    if (args.epoch) query.set("epoch", args.epoch);
+    const query2 = new URLSearchParams();
+    if (args.epoch) query2.set("epoch", args.epoch);
     if (args.afterSeq !== void 0)
-      query.set("after_seq", String(args.afterSeq));
-    query.set("frontend_replace", "1");
-    if (args.openFrame === true) query.set("open_frame", "1");
+      query2.set("after_seq", String(args.afterSeq));
+    query2.set("frontend_replace", "1");
+    if (args.openFrame === true) query2.set("open_frame", "1");
     if (args.journalOrder === true) {
-      query.set("journal_order", "1");
+      query2.set("journal_order", "1");
       if (args.peerJournalSource === true)
-        query.set("peer_journal_source", "1");
+        query2.set("peer_journal_source", "1");
     }
-    query.set("supplements", "1");
+    query2.set("supplements", "1");
     if (args.journalOrder === true)
       appendJournalOrderIds(
-        query,
+        query2,
         `/v1/desktop/sessions/${args.sessionId}/events`,
         args.orderIds ?? []
       );
-    const suffix = query.size > 0 ? `?${query}` : "";
+    const suffix = query2.size > 0 ? `?${query2}` : "";
     const url = new URL(
       `/v1/desktop/sessions/${args.sessionId}/events${suffix}`,
       this.backendUrl
@@ -14694,6 +15000,20 @@ class BackendServiceManager {
   getBackendUrl() {
     return this.backendUrl;
   }
+  /**
+   * The bearer token this app presents to THAT daemon, or null while none has
+   * been minted/adopted yet.
+   *
+   * Exposed for the one request that does not travel through the op plane: the
+   * attachment UPLOAD (attachment contract v1 §1.1). It carries raw bytes in a
+   * multipart body, which the op plane's JSON schemas cannot describe, so it
+   * goes over `fetch` from main and has to present the same credential the
+   * plane would. Kept a getter rather than a public field so the token's
+   * lifecycle stays owned here (`mintDesktopToken`, adoption, persistence).
+   */
+  getDesktopToken() {
+    return this.desktopToken;
+  }
   /**
    * Check if the backend service is using an external backend
    * @returns True if using an external backend, false if we started our own
@@ -14839,12 +15159,12 @@ const REASON_LIMIT = 240;
 function installFailureReason(stdout, stderr) {
   const lines = `${stderr}
 ${stdout}`.split(/\r?\n/);
-  const pick = (accept) => {
+  const pick = (accept2) => {
     for (let index = lines.length - 1; index >= 0; index -= 1) {
       const line = lines[index].trim();
       if (line.length === 0) continue;
       if (NOISE.some((pattern) => pattern.test(line))) continue;
-      if (!accept(line)) continue;
+      if (!accept2(line)) continue;
       return line.length > REASON_LIMIT ? `${line.slice(0, REASON_LIMIT - 1).trimEnd()}…` : line;
     }
     return null;
@@ -16725,6 +17045,10 @@ const METHODS$1 = [
   "styles",
   "hit_test",
   "ancestors",
+  // The read-only DOM query: CSS in, element descriptors out. A read by
+  // construction (no write, no navigation, no caller-supplied code), served by
+  // every non-cmux host like the structured reads above.
+  "query",
   "request_access",
   "await_access",
   "cancel_access",
@@ -16789,6 +17113,7 @@ const HOST_CAPABILITIES = [
   "styles",
   "hit_test",
   "ancestors",
+  "query",
   "download",
   "upload"
 ];
@@ -28089,7 +28414,7 @@ function nativeCapacityProbe(trustedPython) {
   let ptyMax = null;
   let stopped = false;
   const children = /* @__PURE__ */ new Set();
-  function readNumber(executable, args, accept) {
+  function readNumber(executable, args, accept2) {
     const child = node_child_process.execFile(
       executable,
       args,
@@ -28104,7 +28429,7 @@ function nativeCapacityProbe(trustedPython) {
         children.delete(child);
         if (stopped || error) return;
         const value = Number(stdout.trim());
-        if (Number.isSafeInteger(value) && value > 0) accept(value);
+        if (Number.isSafeInteger(value) && value > 0) accept2(value);
       }
     );
     children.add(child);
@@ -35690,6 +36015,34 @@ const enUiChatAnalytics = {
   "ui.chat.analytics.toolbar.refreshing": "Refreshing",
   "ui.chat.analytics.toolbar.this_session_only": "This session only"
 };
+const enUiChatAsks = {
+  "ui.chat.asks.context.messages_since": "{count, plural, one {# message from you since this was asked} other {# messages from you since this was asked}} (last message {time})",
+  "ui.chat.asks.dismiss.answered_in_chat.note": "you already replied in the conversation",
+  "ui.chat.asks.dismiss.answered_in_chat.title": "Answered in chat",
+  "ui.chat.asks.dismiss.cancel": "Cancel",
+  "ui.chat.asks.dismiss.heading": "Dismiss this ask",
+  "ui.chat.asks.dismiss.in_flight": "Dismissing…",
+  "ui.chat.asks.dismiss.moot.note": "stop waiting on it",
+  "ui.chat.asks.dismiss.moot.title": "No longer needed",
+  "ui.chat.asks.dismiss.receipt.answered_in_chat": "Dismissed — settled in chat",
+  "ui.chat.asks.dismiss.receipt.moot": "Dismissed — no longer needed",
+  "ui.chat.asks.dismiss.refused": "Couldn't dismiss this ask — nothing was sent.",
+  "ui.chat.asks.dismiss.trigger": "Dismiss…"
+};
+const enUiChatAttachments = {
+  "ui.chat.attachments.pending_caption": "Not sent yet",
+  "ui.chat.attachments.file_meta": "{type} · {size}",
+  "ui.chat.attachments.file_missing": "Moved or deleted",
+  "ui.chat.attachments.file_retained": "Still retained in the attachment store ({digest})",
+  "ui.chat.attachments.file_unnamed": "Attached file",
+  "ui.chat.attachments.copy_path": "Copy path",
+  "ui.chat.attachments.path_copied": "Path copied",
+  "ui.chat.attachments.file_missing_recovery": "The file is no longer at this path.",
+  "ui.chat.attachments.file_type_unknown": "File",
+  "ui.chat.attachments.copy_saved_path": "Copy saved copy path",
+  "ui.chat.attachments.saved_path_copied": "Saved copy path copied",
+  "ui.chat.attachments.saved_copy_label": "Saved copy"
+};
 const enUiChatCanonical = {
   "ui.chat.canonical.sound.batch_attachment_unavailable": "Audio attachment unavailable.",
   "ui.chat.canonical.sound.player_failed": "This sound could not be played",
@@ -39470,6 +39823,34 @@ const esUiCanvas = {
   "ui.canvas.files.prepareError": "No se pudo preparar una copia local para esta acción",
   "ui.canvas.files.pathCopyNote": "Las acciones de abrir, carpeta y ruta crean una copia local en el scratchpad de esta conversación."
 };
+const esUiChatAsks = {
+  "ui.chat.asks.context.messages_since": "{count, plural, one {# mensaje tuyo desde que se hizo esta consulta (último mensaje: {time})} many {# de mensajes tuyos desde que se hizo esta consulta (último mensaje: {time})} other {# mensajes tuyos desde que se hizo esta consulta (último mensaje: {time})}}",
+  "ui.chat.asks.dismiss.answered_in_chat.note": "ya respondiste en la conversación",
+  "ui.chat.asks.dismiss.answered_in_chat.title": "Respondida en la conversación",
+  "ui.chat.asks.dismiss.cancel": "Cancelar",
+  "ui.chat.asks.dismiss.heading": "Descartar esta consulta",
+  "ui.chat.asks.dismiss.in_flight": "Descartando…",
+  "ui.chat.asks.dismiss.moot.note": "el agente dejará de esperar respuesta",
+  "ui.chat.asks.dismiss.moot.title": "Ya no hace falta",
+  "ui.chat.asks.dismiss.receipt.answered_in_chat": "Descartada — resuelta en la conversación",
+  "ui.chat.asks.dismiss.receipt.moot": "Descartada — ya no hace falta",
+  "ui.chat.asks.dismiss.refused": "No se pudo descartar esta consulta: no se envió nada.",
+  "ui.chat.asks.dismiss.trigger": "Descartar…"
+};
+const esUiChatAttachments = {
+  "ui.chat.attachments.pending_caption": "Aún no enviado",
+  "ui.chat.attachments.file_meta": "{type} · {size}",
+  "ui.chat.attachments.file_missing": "Movido o eliminado",
+  "ui.chat.attachments.file_retained": "Todavía se conserva en el almacén de adjuntos ({digest})",
+  "ui.chat.attachments.file_unnamed": "Archivo adjunto",
+  "ui.chat.attachments.copy_path": "Copiar ruta",
+  "ui.chat.attachments.path_copied": "Ruta copiada",
+  "ui.chat.attachments.file_missing_recovery": "El archivo ya no está en esta ruta.",
+  "ui.chat.attachments.file_type_unknown": "Archivo",
+  "ui.chat.attachments.copy_saved_path": "Copiar ruta de la copia guardada",
+  "ui.chat.attachments.saved_path_copied": "Ruta de la copia guardada copiada",
+  "ui.chat.attachments.saved_copy_label": "Copia guardada"
+};
 const esUiChatComposer = {
   "ui.chat.composer.clear_message": "Borrar mensaje",
   "ui.chat.composer.message": "Mensaje",
@@ -43111,6 +43492,34 @@ const frUiCanvas = {
   "ui.canvas.files.prepareError": "Impossible de préparer une copie locale pour cette action",
   "ui.canvas.files.pathCopyNote": "Les actions Ouvrir, Dossier et Chemin créent une copie locale dans le dossier de travail de cette conversation."
 };
+const frUiChatAsks = {
+  "ui.chat.asks.context.messages_since": "{count, plural, one {# message de votre part depuis cette demande (dernier message à {time})} many {# de messages de votre part depuis cette demande (dernier message à {time})} other {# messages de votre part depuis cette demande (dernier message à {time})}}",
+  "ui.chat.asks.dismiss.answered_in_chat.note": "vous avez déjà répondu dans la conversation",
+  "ui.chat.asks.dismiss.answered_in_chat.title": "Répondu dans la conversation",
+  "ui.chat.asks.dismiss.cancel": "Annuler",
+  "ui.chat.asks.dismiss.heading": "Ignorer cette demande",
+  "ui.chat.asks.dismiss.in_flight": "En cours…",
+  "ui.chat.asks.dismiss.moot.note": "l’agent n’attendra plus de réponse",
+  "ui.chat.asks.dismiss.moot.title": "Plus nécessaire",
+  "ui.chat.asks.dismiss.receipt.answered_in_chat": "Ignorée — réglée dans la conversation",
+  "ui.chat.asks.dismiss.receipt.moot": "Ignorée — plus nécessaire",
+  "ui.chat.asks.dismiss.refused": "Impossible d’ignorer cette demande : rien n’a été envoyé.",
+  "ui.chat.asks.dismiss.trigger": "Ignorer…"
+};
+const frUiChatAttachments = {
+  "ui.chat.attachments.pending_caption": "Pas encore envoyé",
+  "ui.chat.attachments.file_meta": "{type} · {size}",
+  "ui.chat.attachments.file_missing": "Déplacé ou supprimé",
+  "ui.chat.attachments.file_retained": "Toujours conservé dans le stockage des pièces jointes ({digest})",
+  "ui.chat.attachments.file_unnamed": "Pièce jointe",
+  "ui.chat.attachments.copy_path": "Copier le chemin",
+  "ui.chat.attachments.path_copied": "Chemin copié",
+  "ui.chat.attachments.file_missing_recovery": "Le fichier n'est plus à cet emplacement.",
+  "ui.chat.attachments.file_type_unknown": "Fichier",
+  "ui.chat.attachments.copy_saved_path": "Copier le chemin de la copie conservée",
+  "ui.chat.attachments.saved_path_copied": "Chemin de la copie conservée copié",
+  "ui.chat.attachments.saved_copy_label": "Copie conservée"
+};
 const frUiChatComposer = {
   "ui.chat.composer.clear_message": "Effacer le message",
   "ui.chat.composer.message": "Message",
@@ -46752,6 +47161,34 @@ const hiUiCanvas = {
   "ui.canvas.files.prepareError": "इस कार्रवाई के लिए स्थानीय कॉपी तैयार नहीं हो सकी",
   "ui.canvas.files.pathCopyNote": "खोलने, फ़ोल्डर और पाथ की कार्रवाइयाँ इस बातचीत के स्क्रैचपैड में एक स्थानीय कॉपी बनाती हैं।"
 };
+const hiUiChatAsks = {
+  "ui.chat.asks.context.messages_since": "{count, plural, one {इस सवाल के बाद से आपका # संदेश} other {इस सवाल के बाद से आपके # संदेश}} (अंतिम संदेश {time})",
+  "ui.chat.asks.dismiss.answered_in_chat.note": "आप बातचीत में पहले ही जवाब दे चुके हैं",
+  "ui.chat.asks.dismiss.answered_in_chat.title": "चैट में जवाब दिया गया",
+  "ui.chat.asks.dismiss.cancel": "रद्द करें",
+  "ui.chat.asks.dismiss.heading": "यह सवाल हटाएँ",
+  "ui.chat.asks.dismiss.in_flight": "हटाया जा रहा है…",
+  "ui.chat.asks.dismiss.moot.note": "एजेंट अब जवाब का इंतज़ार नहीं करेगा",
+  "ui.chat.asks.dismiss.moot.title": "अब ज़रूरत नहीं",
+  "ui.chat.asks.dismiss.receipt.answered_in_chat": "हटाया गया — चैट में तय हो गया",
+  "ui.chat.asks.dismiss.receipt.moot": "हटाया गया — अब ज़रूरत नहीं",
+  "ui.chat.asks.dismiss.refused": "यह सवाल हटाया नहीं जा सका — कुछ भी नहीं भेजा गया।",
+  "ui.chat.asks.dismiss.trigger": "हटाएँ…"
+};
+const hiUiChatAttachments = {
+  "ui.chat.attachments.pending_caption": "अभी तक नहीं भेजा गया",
+  "ui.chat.attachments.file_meta": "{type} · {size}",
+  "ui.chat.attachments.file_missing": "स्थानांतरित या हटाया गया",
+  "ui.chat.attachments.file_retained": "अभी भी अनुलग्नक स्टोर में सुरक्षित है ({digest})",
+  "ui.chat.attachments.file_unnamed": "अनुलग्नक फ़ाइल",
+  "ui.chat.attachments.copy_path": "पाथ कॉपी करें",
+  "ui.chat.attachments.path_copied": "पाथ कॉपी हो गया",
+  "ui.chat.attachments.file_missing_recovery": "फ़ाइल अब इस पाथ पर नहीं है।",
+  "ui.chat.attachments.file_type_unknown": "फ़ाइल",
+  "ui.chat.attachments.copy_saved_path": "सहेजी गई प्रति का पाथ कॉपी करें",
+  "ui.chat.attachments.saved_path_copied": "सहेजी गई प्रति का पाथ कॉपी हो गया",
+  "ui.chat.attachments.saved_copy_label": "सहेजी गई प्रति"
+};
 const hiUiChatComposer = {
   "ui.chat.composer.clear_message": "संदेश मिटाएँ",
   "ui.chat.composer.message": "संदेश",
@@ -50351,6 +50788,34 @@ const ruUiCanvas = {
   "ui.canvas.files.videos": "Видео",
   "ui.canvas.files.working": "Рабочие файлы"
 };
+const ruUiChatAsks = {
+  "ui.chat.asks.context.messages_since": "{count, plural, one {# сообщение от вас с момента этого запроса} few {# сообщения от вас с момента этого запроса} many {# сообщений от вас с момента этого запроса} other {# сообщения от вас с момента этого запроса}} (последнее сообщение: {time})",
+  "ui.chat.asks.dismiss.answered_in_chat.note": "вы уже ответили в чате",
+  "ui.chat.asks.dismiss.answered_in_chat.title": "Ответ дан в чате",
+  "ui.chat.asks.dismiss.cancel": "Отмена",
+  "ui.chat.asks.dismiss.heading": "Убрать этот запрос",
+  "ui.chat.asks.dismiss.in_flight": "Убираем…",
+  "ui.chat.asks.dismiss.moot.note": "агент больше не будет ждать ответа",
+  "ui.chat.asks.dismiss.moot.title": "Больше не нужно",
+  "ui.chat.asks.dismiss.receipt.answered_in_chat": "Убрано — решено в чате",
+  "ui.chat.asks.dismiss.receipt.moot": "Убрано — больше не нужно",
+  "ui.chat.asks.dismiss.refused": "Не удалось убрать этот запрос — ничего не отправлено.",
+  "ui.chat.asks.dismiss.trigger": "Убрать…"
+};
+const ruUiChatAttachments = {
+  "ui.chat.attachments.pending_caption": "Ещё не отправлено",
+  "ui.chat.attachments.file_meta": "{type} · {size}",
+  "ui.chat.attachments.file_missing": "Перемещено или удалено",
+  "ui.chat.attachments.file_retained": "Всё ещё хранится в хранилище вложений ({digest})",
+  "ui.chat.attachments.file_unnamed": "Вложенный файл",
+  "ui.chat.attachments.copy_path": "Скопировать путь",
+  "ui.chat.attachments.path_copied": "Путь скопирован",
+  "ui.chat.attachments.file_missing_recovery": "Файла по этому пути больше нет.",
+  "ui.chat.attachments.file_type_unknown": "Файл",
+  "ui.chat.attachments.copy_saved_path": "Скопировать путь сохранённой копии",
+  "ui.chat.attachments.saved_path_copied": "Путь сохранённой копии скопирован",
+  "ui.chat.attachments.saved_copy_label": "Сохранённая копия"
+};
 const ruUiChatComposer = {
   "ui.chat.composer.ask_aside": "Спросить отдельно",
   "ui.chat.composer.attach_file": "Прикрепить файл",
@@ -53970,6 +54435,34 @@ const urUiCanvas = {
   "ui.canvas.files.prepareError": "اس عمل کے لیے مقامی نقل تیار نہیں ہو سکی",
   "ui.canvas.files.pathCopyNote": "کھولنے، فولڈر اور راستے کے اعمال اس گفتگو کے اسکریچ پیڈ میں مقامی نقل بناتے ہیں۔"
 };
+const urUiChatAsks = {
+  "ui.chat.asks.context.messages_since": "{count, plural, one {اس سوال کے بعد سے آپ کا # پیغام} other {اس سوال کے بعد سے آپ کے # پیغامات}} (آخری پیغام {time})",
+  "ui.chat.asks.dismiss.answered_in_chat.note": "آپ گفتگو میں پہلے ہی جواب دے چکے ہیں",
+  "ui.chat.asks.dismiss.answered_in_chat.title": "چیٹ میں جواب دیا گیا",
+  "ui.chat.asks.dismiss.cancel": "منسوخ کریں",
+  "ui.chat.asks.dismiss.heading": "یہ سوال ہٹائیں",
+  "ui.chat.asks.dismiss.in_flight": "ہٹایا جا رہا ہے…",
+  "ui.chat.asks.dismiss.moot.note": "ایجنٹ اب جواب کا انتظار نہیں کرے گا",
+  "ui.chat.asks.dismiss.moot.title": "اب ضرورت نہیں",
+  "ui.chat.asks.dismiss.receipt.answered_in_chat": "ہٹا دیا — چیٹ میں طے ہو گیا",
+  "ui.chat.asks.dismiss.receipt.moot": "ہٹا دیا — اب ضرورت نہیں",
+  "ui.chat.asks.dismiss.refused": "یہ سوال ہٹایا نہیں جا سکا — کچھ نہیں بھیجا گیا۔",
+  "ui.chat.asks.dismiss.trigger": "ہٹائیں…"
+};
+const urUiChatAttachments = {
+  "ui.chat.attachments.pending_caption": "ابھی نہیں بھیجا گیا",
+  "ui.chat.attachments.file_meta": "{type} · {size}",
+  "ui.chat.attachments.file_missing": "منتقل یا حذف شدہ",
+  "ui.chat.attachments.file_retained": "اب بھی منسلکات کے ذخیرے میں محفوظ ہے ({digest})",
+  "ui.chat.attachments.file_unnamed": "منسلک فائل",
+  "ui.chat.attachments.copy_path": "راستہ نقل کریں",
+  "ui.chat.attachments.path_copied": "راستہ نقل ہو گیا",
+  "ui.chat.attachments.file_missing_recovery": "فائل اب اس راستے پر موجود نہیں ہے۔",
+  "ui.chat.attachments.file_type_unknown": "فائل",
+  "ui.chat.attachments.copy_saved_path": "محفوظ شدہ نقل کا راستہ نقل کریں",
+  "ui.chat.attachments.saved_path_copied": "محفوظ شدہ نقل کا راستہ نقل ہو گیا",
+  "ui.chat.attachments.saved_copy_label": "محفوظ شدہ نقل"
+};
 const urUiChatComposer = {
   "ui.chat.composer.clear_message": "پیغام صاف کریں",
   "ui.chat.composer.message": "پیغام",
@@ -57589,6 +58082,34 @@ const viUiCanvas = {
   "ui.canvas.files.prepareError": "Không chuẩn bị được bản sao cục bộ cho thao tác này",
   "ui.canvas.files.pathCopyNote": "Các thao tác mở tệp, mở thư mục và thao tác với đường dẫn sẽ tạo bản sao cục bộ trong thư mục nháp của cuộc trò chuyện này."
 };
+const viUiChatAsks = {
+  "ui.chat.asks.context.messages_since": "{count, plural, other {# tin nhắn của bạn kể từ khi câu hỏi này được đưa ra}} (tin nhắn gần nhất lúc {time})",
+  "ui.chat.asks.dismiss.answered_in_chat.note": "bạn đã trả lời trong cuộc trò chuyện",
+  "ui.chat.asks.dismiss.answered_in_chat.title": "Đã trả lời trong cuộc trò chuyện",
+  "ui.chat.asks.dismiss.cancel": "Hủy",
+  "ui.chat.asks.dismiss.heading": "Bỏ qua câu hỏi này",
+  "ui.chat.asks.dismiss.in_flight": "Đang bỏ qua…",
+  "ui.chat.asks.dismiss.moot.note": "tác nhân sẽ không chờ câu trả lời nữa",
+  "ui.chat.asks.dismiss.moot.title": "Không còn cần nữa",
+  "ui.chat.asks.dismiss.receipt.answered_in_chat": "Đã bỏ qua — đã giải quyết trong cuộc trò chuyện",
+  "ui.chat.asks.dismiss.receipt.moot": "Đã bỏ qua — không còn cần nữa",
+  "ui.chat.asks.dismiss.refused": "Không thể bỏ qua câu hỏi này — không có gì được gửi đi.",
+  "ui.chat.asks.dismiss.trigger": "Bỏ qua…"
+};
+const viUiChatAttachments = {
+  "ui.chat.attachments.pending_caption": "Chưa được gửi",
+  "ui.chat.attachments.file_meta": "{type} · {size}",
+  "ui.chat.attachments.file_missing": "Đã di chuyển hoặc bị xóa",
+  "ui.chat.attachments.file_retained": "Vẫn được lưu trong kho tệp đính kèm ({digest})",
+  "ui.chat.attachments.file_unnamed": "Tệp đính kèm",
+  "ui.chat.attachments.copy_path": "Sao chép đường dẫn",
+  "ui.chat.attachments.path_copied": "Đã sao chép đường dẫn",
+  "ui.chat.attachments.file_missing_recovery": "Tệp không còn ở đường dẫn này.",
+  "ui.chat.attachments.file_type_unknown": "Tệp",
+  "ui.chat.attachments.copy_saved_path": "Sao chép đường dẫn bản sao đã lưu",
+  "ui.chat.attachments.saved_path_copied": "Đã sao chép đường dẫn bản sao đã lưu",
+  "ui.chat.attachments.saved_copy_label": "Bản sao đã lưu"
+};
 const viUiChatComposer = {
   "ui.chat.composer.clear_message": "Xóa tin nhắn",
   "ui.chat.composer.message": "Tin nhắn",
@@ -61017,6 +61538,34 @@ const zhCNUiCanvas = {
   "ui.canvas.files.prepareError": "无法为此操作准备本地副本",
   "ui.canvas.files.pathCopyNote": "打开文件、打开文件夹及路径相关操作会在此对话的暂存区中创建本地副本。"
 };
+const zhCNUiChatAsks = {
+  "ui.chat.asks.context.messages_since": "{count, plural, other {自提出这个请求以来你发来了#条消息}}（最后一条消息于{time}）",
+  "ui.chat.asks.dismiss.answered_in_chat.note": "你已在对话中回复过",
+  "ui.chat.asks.dismiss.answered_in_chat.title": "已在对话中回答",
+  "ui.chat.asks.dismiss.cancel": "取消",
+  "ui.chat.asks.dismiss.heading": "关闭此请求",
+  "ui.chat.asks.dismiss.in_flight": "正在关闭……",
+  "ui.chat.asks.dismiss.moot.note": "无需继续等待",
+  "ui.chat.asks.dismiss.moot.title": "不再需要",
+  "ui.chat.asks.dismiss.receipt.answered_in_chat": "已关闭——已在对话中解决",
+  "ui.chat.asks.dismiss.receipt.moot": "已关闭——不再需要",
+  "ui.chat.asks.dismiss.refused": "无法关闭此请求——未发送任何内容。",
+  "ui.chat.asks.dismiss.trigger": "关闭……"
+};
+const zhCNUiChatAttachments = {
+  "ui.chat.attachments.pending_caption": "尚未发送",
+  "ui.chat.attachments.file_meta": "{type} · {size}",
+  "ui.chat.attachments.file_missing": "已移动或删除",
+  "ui.chat.attachments.file_retained": "仍保留在附件存储中（{digest}）",
+  "ui.chat.attachments.file_unnamed": "附件",
+  "ui.chat.attachments.copy_path": "复制路径",
+  "ui.chat.attachments.path_copied": "路径已复制",
+  "ui.chat.attachments.file_missing_recovery": "该文件已不在这个路径。",
+  "ui.chat.attachments.file_type_unknown": "文件",
+  "ui.chat.attachments.copy_saved_path": "复制已保存副本的路径",
+  "ui.chat.attachments.saved_path_copied": "已复制保存副本的路径",
+  "ui.chat.attachments.saved_copy_label": "保存的副本"
+};
 const zhCNUiChatComposer = {
   "ui.chat.composer.clear_message": "清空消息",
   "ui.chat.composer.message": "消息",
@@ -64047,6 +64596,8 @@ const bundledEnglish = {
   ...enUiBrowser,
   ...enUiCanvas,
   ...enUiChatAnalytics,
+  ...enUiChatAsks,
+  ...enUiChatAttachments,
   ...enUiChatCanonical,
   ...enUiChatCommentaryActions,
   ...enUiChatComposer,
@@ -64121,6 +64672,8 @@ const bundledCatalogues = {
     ...esUiBrowserChrome,
     ...esUiBrowser,
     ...esUiCanvas,
+    ...esUiChatAsks,
+    ...esUiChatAttachments,
     ...esUiChatComposer,
     ...esUiChatComposerMedia,
     ...esUiChatDialogs,
@@ -64185,6 +64738,8 @@ const bundledCatalogues = {
     ...frUiBrowserChrome,
     ...frUiBrowser,
     ...frUiCanvas,
+    ...frUiChatAsks,
+    ...frUiChatAttachments,
     ...frUiChatComposer,
     ...frUiChatComposerMedia,
     ...frUiChatDialogs,
@@ -64249,6 +64804,8 @@ const bundledCatalogues = {
     ...hiUiBrowserChrome,
     ...hiUiBrowser,
     ...hiUiCanvas,
+    ...hiUiChatAsks,
+    ...hiUiChatAttachments,
     ...hiUiChatComposer,
     ...hiUiChatComposerMedia,
     ...hiUiChatDialogs,
@@ -64310,6 +64867,8 @@ const bundledCatalogues = {
     ...ruUiBrowserChrome,
     ...ruUiBrowser,
     ...ruUiCanvas,
+    ...ruUiChatAsks,
+    ...ruUiChatAttachments,
     ...ruUiChatComposer,
     ...ruUiChatComposerMedia,
     ...ruUiChatDialogs,
@@ -64372,6 +64931,8 @@ const bundledCatalogues = {
     ...urUiBrowserChrome,
     ...urUiBrowser,
     ...urUiCanvas,
+    ...urUiChatAsks,
+    ...urUiChatAttachments,
     ...urUiChatComposer,
     ...urUiChatComposerMedia,
     ...urUiChatDialogs,
@@ -64434,6 +64995,8 @@ const bundledCatalogues = {
     ...viUiBrowserChrome,
     ...viUiBrowser,
     ...viUiCanvas,
+    ...viUiChatAsks,
+    ...viUiChatAttachments,
     ...viUiChatComposer,
     ...viUiChatComposerMedia,
     ...viUiChatDialogs,
@@ -64495,6 +65058,8 @@ const bundledCatalogues = {
     ...zhCNUiBrowserChrome,
     ...zhCNUiBrowser,
     ...zhCNUiCanvas,
+    ...zhCNUiChatAsks,
+    ...zhCNUiChatAttachments,
     ...zhCNUiChatComposer,
     ...zhCNUiChatComposerMedia,
     ...zhCNUiChatDialogs,
@@ -64806,6 +65371,160 @@ 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;
+}
+const NEVER_TARGETED = /* @__PURE__ */ new Set(["StaticText", "InlineTextBox", "none", "generic"]);
+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 = (accept2) => {
+    for (const node of pool) {
+      const role = String(node.role?.value ?? "");
+      const name = normalise(node.name?.value);
+      if (!accept2(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, query2, limit = 5) {
+  const wanted = normalise(query2).toLowerCase();
+  const parsed = parseLocator(query2);
+  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;
+    if (NEVER_TARGETED.has(role)) 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 += 12;
+    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;
@@ -65056,7 +65775,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(
@@ -65065,9 +65784,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 = {
@@ -65202,24 +65921,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) {
@@ -65228,16 +65969,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() {
@@ -65317,6 +66096,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 {
@@ -65330,22 +66111,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)
   };
 }
@@ -65591,11 +66399,48 @@ async function nodeIdForSelector(ctx, view, selector) {
   if (!queried?.nodeId) {
     throw new BridgeCommandError(
       "element_not_found",
-      `selector ${selector} matched nothing`
+      `selector ${selector} matched nothing`,
+      { candidates: await missCandidates(ctx, view, selector) }
     );
   }
   return queried.nodeId;
 }
+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 missCandidates(ctx, view, selector) {
+  const nodes = await readAccessibilityTree(ctx, view.webContents).catch(
+    () => []
+  );
+  return locatorSuggestions(nodes, selector);
+}
+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;
@@ -65694,6 +66539,16 @@ 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 ?? "" } : {};
 }
@@ -65721,6 +66576,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);
@@ -65733,8 +66621,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(
@@ -65742,21 +66630,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 }
       );
     }
@@ -65764,8 +66652,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);
@@ -65918,6 +66806,7 @@ async function click(ctx, params) {
   return {
     navigated: navigationSeen || after.url !== before,
     ...frameFields(node),
+    ...resolvedFields(node),
     ...after
   };
 }
@@ -65930,7 +66819,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) {
@@ -66091,6 +66985,7 @@ function clampTimeout(requested) {
 const READ_STYLES_SOURCE = '(selector, properties) => {\n  const DEFAULTS = [\n    "display",\n    "position",\n    "visibility",\n    "opacity",\n    "z-index",\n    "transform",\n    "transform-origin",\n    "top",\n    "right",\n    "bottom",\n    "left",\n    "width",\n    "height",\n    "contain",\n    "filter",\n    "will-change",\n    "overflow",\n    "overflow-x",\n    "overflow-y",\n    "pointer-events"\n  ];\n  const MAX_MATCHES = 5;\n  const MAX_STYLES = 30;\n  const MAX_INLINE = 30;\n  const MAX_IDENTITY = 120;\n  const MAX_VALUE = 200;\n  const all = document.querySelectorAll(selector);\n  if (!all || all.length === 0) return null;\n  const names = DEFAULTS.slice();\n  if (Array.isArray(properties)) {\n    for (let i = 0; i < properties.length && names.length < MAX_STYLES; i++) {\n      const name = String(properties[i] ?? "").trim();\n      if (name && names.indexOf(name) === -1) names.push(name);\n    }\n  }\n  const round2 = (value) => {\n    const rounded = Math.round(value * 100) / 100;\n    return rounded === 0 ? 0 : rounded;\n  };\n  const clip = (value, limit) => value.length > limit ? value.slice(0, limit - 1) + "\\u2026" : value;\n  const rectOf = (el) => {\n    const r = el.getBoundingClientRect();\n    return {\n      x: round2(r.x),\n      y: round2(r.y),\n      top: round2(r.top),\n      right: round2(r.right),\n      bottom: round2(r.bottom),\n      width: round2(r.width),\n      height: round2(r.height)\n    };\n  };\n  const attrOf = (el, name) => clip(el.getAttribute(name) || "", MAX_IDENTITY);\n  const matches = [];\n  const first = Array.from(all).slice(0, MAX_MATCHES);\n  for (const el of first) {\n    const computed = getComputedStyle(el);\n    const styles = {};\n    for (const name of names) {\n      styles[name] = clip(String(computed.getPropertyValue(name) || "").trim(), MAX_VALUE);\n    }\n    const inline = {};\n    const declaration = el.style;\n    let inlineCount = 0;\n    for (let j = 0; j < declaration.length && inlineCount < MAX_INLINE; j++) {\n      const name = declaration.item(j);\n      if (name && name.indexOf("--") === 0) {\n        const key = clip(name, MAX_IDENTITY);\n        if (!(key in inline)) {\n          inline[key] = clip(\n            String(declaration.getPropertyValue(name) || "").trim(),\n            MAX_VALUE\n          );\n          inlineCount += 1;\n        }\n      }\n    }\n    matches.push({\n      tag: clip(el.tagName.toLowerCase(), MAX_IDENTITY),\n      id: attrOf(el, "id"),\n      role: attrOf(el, "role"),\n      className: attrOf(el, "class"),\n      rect: rectOf(el),\n      styles,\n      inline\n    });\n  }\n  return { count: matches.length, matches, truncated: all.length > matches.length };\n}';
 const HIT_TEST_SOURCE = '(x, y) => {\n  const PROPS = ["display", "position", "visibility", "opacity", "z-index", "pointer-events"];\n  const MAX_ELEMENTS = 8;\n  const MAX_IDENTITY = 120;\n  const MAX_VALUE = 200;\n  const px = Number(x);\n  const py = Number(y);\n  if (!Number.isFinite(px) || !Number.isFinite(py)) return null;\n  const stack = document.elementsFromPoint(px, py);\n  if (!stack || stack.length === 0) return null;\n  const round2 = (value) => {\n    const rounded = Math.round(value * 100) / 100;\n    return rounded === 0 ? 0 : rounded;\n  };\n  const clip = (value, limit) => value.length > limit ? value.slice(0, limit - 1) + "\\u2026" : value;\n  const attrOf = (el, name) => clip(el.getAttribute(name) || "", MAX_IDENTITY);\n  const elements = [];\n  for (const el of stack.slice(0, MAX_ELEMENTS)) {\n    const computed = getComputedStyle(el);\n    const styles = {};\n    for (const name of PROPS) {\n      styles[name] = clip(String(computed.getPropertyValue(name) || "").trim(), MAX_VALUE);\n    }\n    const r = el.getBoundingClientRect();\n    elements.push({\n      tag: clip(el.tagName.toLowerCase(), MAX_IDENTITY),\n      id: attrOf(el, "id"),\n      role: attrOf(el, "role"),\n      className: attrOf(el, "class"),\n      rect: {\n        x: round2(r.x),\n        y: round2(r.y),\n        top: round2(r.top),\n        right: round2(r.right),\n        bottom: round2(r.bottom),\n        width: round2(r.width),\n        height: round2(r.height)\n      },\n      styles\n    });\n  }\n  return { count: elements.length, elements };\n}';
 const ANCESTORS_SOURCE = '(selector, depth) => {\n  const PROPS = [\n    "display",\n    "position",\n    "visibility",\n    "overflow",\n    "overflow-x",\n    "overflow-y",\n    "transform",\n    "transform-origin",\n    "contain",\n    "filter",\n    "will-change",\n    "z-index",\n    "isolation",\n    "top",\n    "left"\n  ];\n  const DEFAULT_DEPTH = 12;\n  const MAX_DEPTH = 16;\n  const MAX_IDENTITY = 120;\n  const MAX_VALUE = 200;\n  const el = document.querySelector(selector);\n  if (!el) return null;\n  const wanted = typeof depth === "number" && Number.isFinite(depth) ? Math.floor(depth) : DEFAULT_DEPTH;\n  const bound = Math.max(1, Math.min(MAX_DEPTH, wanted));\n  const round2 = (value) => {\n    const rounded = Math.round(value * 100) / 100;\n    return rounded === 0 ? 0 : rounded;\n  };\n  const clip = (value, limit) => value.length > limit ? value.slice(0, limit - 1) + "\\u2026" : value;\n  const attrOf = (el2, name) => clip(el2.getAttribute(name) || "", MAX_IDENTITY);\n  const chain = [];\n  let node = el;\n  while (node && chain.length < bound) {\n    const computed = getComputedStyle(node);\n    const styles = {};\n    for (const name of PROPS) {\n      styles[name] = clip(String(computed.getPropertyValue(name) || "").trim(), MAX_VALUE);\n    }\n    const r = node.getBoundingClientRect();\n    chain.push({\n      tag: clip(node.tagName.toLowerCase(), MAX_IDENTITY),\n      id: attrOf(node, "id"),\n      role: attrOf(node, "role"),\n      className: attrOf(node, "class"),\n      rect: {\n        x: round2(r.x),\n        y: round2(r.y),\n        top: round2(r.top),\n        right: round2(r.right),\n        bottom: round2(r.bottom),\n        width: round2(r.width),\n        height: round2(r.height)\n      },\n      styles\n    });\n    if (node === document.documentElement) break;\n    node = node.parentElement;\n  }\n  return { count: chain.length, chain };\n}';
+const QUERY_SOURCE = '(selector, limit) => {\n  const MAX_ELEMENTS = 50;\n  const MAX_IDENTITY = 120;\n  const MAX_TEXT = 120;\n  const MAX_VALUE = 120;\n  if (typeof selector !== "string" || !selector.trim()) return null;\n  const wanted = typeof limit === "number" && Number.isFinite(limit) ? Math.floor(limit) : 20;\n  const bound = Math.max(1, Math.min(MAX_ELEMENTS, wanted));\n  const round2 = (value) => {\n    const rounded = Math.round(value * 100) / 100;\n    return rounded === 0 ? 0 : rounded;\n  };\n  const clip = (value, cap) => value.length > cap ? `${value.slice(0, cap - 1)}\\u2026` : value;\n  const attrOf = (el, name) => clip(String(el.getAttribute(name) || ""), MAX_IDENTITY);\n  const visibleOf = (el, rect) => {\n    if (rect.width <= 0 || rect.height <= 0) return false;\n    const computed = getComputedStyle(el);\n    if (computed.display === "none" || computed.visibility === "hidden") return false;\n    return computed.contentVisibility !== "hidden";\n  };\n  let nodes;\n  try {\n    nodes = Array.from(document.querySelectorAll(selector));\n  } catch {\n    return { count: 0, truncated: false, matches: [], error: "invalid_selector" };\n  }\n  const viewport = {\n    width: document.documentElement.clientWidth || window.innerWidth || 0,\n    height: document.documentElement.clientHeight || window.innerHeight || 0\n  };\n  const matches = [];\n  for (const el of nodes.slice(0, bound)) {\n    const rect = el.getBoundingClientRect();\n    const tag = clip(String(el.tagName || "").toLowerCase(), MAX_IDENTITY);\n    const type = attrOf(el, "type").toLowerCase();\n    const isPassword = tag === "input" && type === "password";\n    const rawValue = el.value;\n    const checkable = tag === "input" && (type === "checkbox" || type === "radio");\n    const checked = checkable ? Boolean(el.checked) : null;\n    matches.push({\n      tag,\n      id: attrOf(el, "id"),\n      name: attrOf(el, "name"),\n      role: attrOf(el, "role"),\n      ariaLabel: attrOf(el, "aria-label"),\n      // `innerText` is the RENDERED text (a hidden node reports ""), which is\n      // what an agent reading a page means by "the text"; `textContent` would\n      // report text nobody can see, including inside a collapsed section.\n      text: clip(String(el.innerText || "").replace(/\\s+/g, " ").trim(), MAX_TEXT),\n      type,\n      visible: visibleOf(el, rect),\n      inView: rect.top < viewport.height && rect.bottom > 0 && rect.left < viewport.width && rect.right > 0,\n      disabled: el.hasAttribute("disabled") || el.disabled === true,\n      checked,\n      value: isPassword || rawValue === void 0 || rawValue === null ? "" : clip(String(rawValue), MAX_VALUE),\n      rect: {\n        x: round2(rect.x),\n        y: round2(rect.y),\n        width: round2(rect.width),\n        height: round2(rect.height)\n      }\n    });\n  }\n  return { count: nodes.length, truncated: nodes.length > matches.length, matches };\n}';
 const MAX_REQUESTED_PROPERTIES = 20;
 const DEFAULT_DEPTH = 12;
 const MAX_DEPTH = 16;
@@ -66217,6 +67112,51 @@ async function ancestors(ctx, params) {
     ...pageOf(record.view)
   };
 }
+const DEFAULT_LIMIT = 20;
+const MAX_LIMIT = 50;
+async function query(ctx, params) {
+  const record = ctx.registry.requireSurface(params.tab);
+  const selector = stringParam(params, "selector");
+  if (!selector) {
+    throw new BridgeCommandError("element_not_found", "selector is required");
+  }
+  const requested = numberParam(params, "limit") ?? DEFAULT_LIMIT;
+  const limit = Math.max(1, Math.min(MAX_LIMIT, Math.floor(requested)));
+  const code = `(${QUERY_SOURCE})(${JSON.stringify(selector)}, ${JSON.stringify(limit)})`;
+  let result;
+  try {
+    result = await deadline(
+      record.view.webContents.executeJavaScriptInIsolatedWorld(
+        ISOLATED_WORLD_ID,
+        [{ code }]
+      ),
+      SCRIPTING_DEADLINE_MS,
+      `query(${record.tabId})`
+    );
+  } catch (error) {
+    if (error instanceof Error && INVALID_SELECTOR.test(error.message)) {
+      throw new BridgeCommandError(
+        "element_not_found",
+        `selector ${selector} is not valid`
+      );
+    }
+    throw error;
+  }
+  if (typeof result !== "object" || result === null) {
+    throw new BridgeCommandError(
+      "internal",
+      "the page returned no structured query result"
+    );
+  }
+  if (result.error === "invalid_selector") {
+    throw new BridgeCommandError(
+      "element_not_found",
+      `selector ${selector} is not valid`
+    );
+  }
+  ctx.registry.touch(record);
+  return { ...result, ...pageOf(record.view) };
+}
 const MAX_AGENT_TABS = 8;
 const BACKGROUND_VIEWPORT = {
   x: 0,
@@ -67104,7 +68044,7 @@ async function upload(ctx, params) {
       { selector, frame_origin: node.frame.origin ?? "" }
     );
   }
-  const accept = await acceptsOf(ctx, record, node.nodeId);
+  const accept2 = await acceptsOf(ctx, record, node.nodeId);
   await ctx.cdp.send(contents, "DOM.setFileInputFiles", {
     files: paths,
     nodeId: node.nodeId
@@ -67112,7 +68052,7 @@ async function upload(ctx, params) {
     if (!/not a file input/i.test(String(error))) throw error;
     throw new BridgeCommandError("element_not_found", NOT_A_FILE_INPUT, {
       selector,
-      accept
+      accept: accept2
     });
   });
   let held = null;
@@ -67126,10 +68066,10 @@ async function upload(ctx, params) {
     if (!held) {
       throw new BridgeCommandError("element_not_found", NOT_A_FILE_INPUT, {
         selector,
-        accept
+        accept: accept2
       });
     }
-    assertHolds(paths, held, selector, accept);
+    assertHolds(paths, held, selector, accept2);
   }
   ctx.registry.touch(record);
   const facts = paths.map(factOf);
@@ -67210,7 +68150,7 @@ async function readBack(ctx, record, objectId) {
   });
   return answer?.result?.value ?? null;
 }
-function assertHolds(paths, held, selector, accept) {
+function assertHolds(paths, held, selector, accept2) {
   const expected = paths.map((path2) => path$1.basename(path2));
   const mismatch = held.count !== expected.length || expected.some((name, index) => held.names[index] !== name) || paths.some((path2, index) => sizeOf(path2) !== held.sizes[index]);
   if (!mismatch) return;
@@ -67221,7 +68161,7 @@ function assertHolds(paths, held, selector, accept) {
       selector,
       attached: expected,
       held: held.names,
-      accept,
+      accept: accept2,
       reason: "read_back_mismatch"
     }
   );
@@ -67376,7 +68316,7 @@ function collectAddressHistory(tabs2, activeTabId) {
 function foldAscii(value) {
   return value.replace(/[A-Z]/g, (letter) => letter.toLowerCase());
 }
-function mergeAddressHistory(tabEntries, historyEntries, query, limit) {
+function mergeAddressHistory(tabEntries, historyEntries, query2, limit) {
   const cap = Math.max(0, Math.floor(limit));
   if (cap === 0) return [];
   const seen = /* @__PURE__ */ new Set();
@@ -67394,7 +68334,7 @@ function mergeAddressHistory(tabEntries, historyEntries, query, limit) {
       source: "history"
     });
   }
-  const needle = foldAscii(query.trim());
+  const needle = foldAscii(query2.trim());
   for (const entry of tabEntries) {
     if (merged.length >= cap) break;
     if (seen.has(entry.url)) continue;
@@ -67828,25 +68768,25 @@ class PageControls {
     };
     active.view.webContents.on("found-in-page", this.listener);
   }
-  search(active, query, forward, next) {
+  search(active, query2, forward, next) {
     this.open(active);
     if (!this.find || this.record !== active) return;
     this.stopTimer();
-    const same = this.find.query === query;
+    const same = this.find.query === query2;
     const continuing = same && next && this.requestId !== null && !this.find.unreported;
     this.requestId = null;
     this.find = {
       ...this.find,
-      query,
-      pending: query.length > 0,
+      query: query2,
+      pending: query2.length > 0,
       unreported: false,
       ...same ? {} : { ordinal: 0, matches: 0 }
     };
-    if (!query) {
+    if (!query2) {
       active.view.webContents.stopFindInPage?.("clearSelection");
       return;
     }
-    this.requestId = active.view.webContents.findInPage?.(query, {
+    this.requestId = active.view.webContents.findInPage?.(query2, {
       forward,
       // Electron's misleading name means NEW SESSION (44.3 native maps
       // it to options->new_session), not "advance". Initial/changed/retry
@@ -68001,6 +68941,12 @@ const DOCUMENT_SCOPED = /* @__PURE__ */ new Set([
   "hit_test",
   "ancestors",
   "snapshot",
+  // `query` is a read of the CURRENT document's DOM (CSS in, descriptors out),
+  // so it is authorized against that document on entry and again on the result
+  // exactly as `read` is: an answer that raced a navigation it did not cause
+  // must be discarded, not reported as the new page's (agent review round 2 on
+  // the query slice — the action was missing from BOTH sets).
+  "query",
   "screenshot",
   "click",
   "type",
@@ -68031,6 +68977,7 @@ const TAB_SCOPED = /* @__PURE__ */ new Set([
   "hit_test",
   "ancestors",
   "snapshot",
+  "query",
   "screenshot",
   "click",
   "type",
@@ -68248,6 +69195,8 @@ class BrowserHost {
         return hitTest(this, params);
       case "ancestors":
         return ancestors(this, params);
+      case "query":
+        return query(this, params);
       case "snapshot":
         return snapshot(this, params);
       case "scroll":
@@ -68659,7 +69608,7 @@ class BrowserHost {
   onChordFocusChanged;
   /** An explicit tab id fences queued chrome intents: a switch between key
    * delivery and IPC must never search/zoom the newly active tab instead. */
-  async controlPage(tabId, action, query = "", forward = true, next = false) {
+  async controlPage(tabId, action, query2 = "", forward = true, next = false) {
     return this.registry.lane(tabId, async () => {
       const active = this.registry.activeTab;
       if (!active || active.tabId !== tabId || !active.presented || active.view.webContents.isDestroyed())
@@ -68668,7 +69617,7 @@ class BrowserHost {
       else if (action === "print") this.pageControls.print(active);
       else if (action === "close") this.pageControls.clear();
       else if (action === "search")
-        this.pageControls.search(active, query, forward, next);
+        this.pageControls.search(active, query2, forward, next);
       else this.pageControls.zoom(active, action);
       this.onChanged();
       return this.chromeState();
@@ -70318,18 +71267,18 @@ function registerBrowserIpc(options) {
   });
   electron.ipcMain.handle(
     "browser-page-control",
-    (event, tabId, action, query, forward, next) => {
+    (event, tabId, action, query2, forward, next) => {
       const host = authorize(event);
       if (typeof action !== "string" || !["open", "close", "search", "print", "in", "out", "reset"].includes(
         action
       ))
         throw new Error("Invalid page control action.");
-      if (typeof query !== "string" || query.length > 4096 || typeof forward !== "boolean" || typeof next !== "boolean")
+      if (typeof query2 !== "string" || query2.length > 4096 || typeof forward !== "boolean" || typeof next !== "boolean")
         throw new Error("Invalid page search input.");
       return host.controlPage(
         numberOrThrow(tabId, "tabId"),
         action,
-        query,
+        query2,
         forward,
         next
       );
@@ -70539,14 +71488,14 @@ function addressHistoryRequestOrThrow(value) {
   if (typeof request.query !== "string") {
     throw new Error("The address history query must be a string.");
   }
-  const query = request.query;
-  if (query.length > ADDRESS_HISTORY_MAX_QUERY_LENGTH || CONTROL_CHARS.test(query)) {
+  const query2 = request.query;
+  if (query2.length > ADDRESS_HISTORY_MAX_QUERY_LENGTH || CONTROL_CHARS.test(query2)) {
     throw new Error("The address history query is invalid.");
   }
   if (typeof request.limit !== "number" || !Number.isSafeInteger(request.limit) || request.limit < 1 || request.limit > ADDRESS_HISTORY_MAX_LIMIT) {
     throw new Error("The address history limit is invalid.");
   }
-  return { requestId: requestId2, expectedTabId, query, limit: request.limit };
+  return { requestId: requestId2, expectedTabId, query: query2, limit: request.limit };
 }
 function closeTabsIntentOrThrow(value) {
   if (!value || typeof value !== "object") {
@@ -74380,6 +75329,41 @@ class DesktopNotifier {
     notification.show();
   }
 }
+const ATTACH_FLAG = "--attach";
+function readAttachArguments(argv) {
+  const paths = [];
+  const problems = [];
+  for (let index = 0; index < argv.length; index += 1) {
+    const argument = argv[index];
+    if (argument === ATTACH_FLAG) {
+      const value = argv[index + 1];
+      if (!value || value.startsWith("--")) {
+        problems.push(`${ATTACH_FLAG} needs an absolute path`);
+        continue;
+      }
+      index += 1;
+      accept(value, paths, problems);
+      continue;
+    }
+    if (argument.startsWith(`${ATTACH_FLAG}=`)) {
+      accept(argument.slice(ATTACH_FLAG.length + 1), paths, problems);
+    }
+  }
+  return { paths, problems };
+}
+function accept(value, paths, problems) {
+  if (!value.trim()) {
+    problems.push(`${ATTACH_FLAG} needs an absolute path`);
+    return;
+  }
+  if (!path$1.isAbsolute(value)) {
+    problems.push(
+      `${ATTACH_FLAG} takes an absolute path (got ${JSON.stringify(value)})`
+    );
+    return;
+  }
+  paths.push(value);
+}
 const FRAME_LABEL = /^[a-z0-9][a-z0-9_-]{0,63}$/;
 function registerDevDriverIPC(options) {
   const { window, expectedUrl, outDir, identity: identity2 } = options;
@@ -83896,18 +84880,18 @@ function frameNavigationVerdict(input, trustedRendererUrls) {
     return ALLOW;
   return deny(`a child frame may not navigate to ${url.protocol}`);
 }
-function permissionVerdict(query, trustedRendererUrls) {
-  if (!query.isMainFrame) return false;
+function permissionVerdict(query2, trustedRendererUrls) {
+  if (!query2.isMainFrame) return false;
   if (!trustedRendererUrls.some(
-    (trusted) => trustedDesktopFrame(query.requestingUrl, trusted)
+    (trusted) => trustedDesktopFrame(query2.requestingUrl, trusted)
   ))
     return false;
-  if (query.permission === "clipboard-sanitized-write" || query.permission === "fullscreen")
+  if (query2.permission === "clipboard-sanitized-write" || query2.permission === "fullscreen")
     return true;
-  if (query.permission !== "media") return false;
-  if (query.mediaTypes)
-    return query.mediaTypes.length > 0 && query.mediaTypes.every((type2) => type2 === "audio");
-  return query.mediaType === "audio";
+  if (query2.permission !== "media") return false;
+  if (query2.mediaTypes)
+    return query2.mediaTypes.length > 0 && query2.mediaTypes.every((type2) => type2 === "audio");
+  return query2.mediaType === "audio";
 }
 function decodedPathname(pathname) {
   let current = pathname;
@@ -84725,6 +85709,13 @@ const devDriverArming = resolveDevDriverArming({
 });
 const devDriverLine = describeDevDriverArming(devDriverArming);
 if (devDriverLine) console.log(devDriverLine);
+const attachQueue = devDriverArming.armed ? readAttachArguments(process.argv) : { paths: [], problems: [] };
+for (const problem of attachQueue.problems)
+  console.error(`[dev-driver] ${problem}`);
+if (devDriverArming.armed && attachQueue.paths.length > 0)
+  console.log(
+    `[dev-driver] attach queue: ${attachQueue.paths.length} path(s) will answer the next file dialog`
+  );
 const addressOverlayGate = resolveAddressOverlayGate({
   env: launchEnv,
   devDriverArmed: devDriverArming.armed,
@@ -85550,6 +86541,24 @@ electron.app.whenReady().then(async () => {
       }
     }
   );
+  electron.ipcMain.handle(
+    "upload-attachment",
+    async (event, source) => {
+      if (!isAdmittedSender(event, trustedLocalFileSenders())) {
+        return {
+          success: false,
+          code: "unreadable",
+          error: "This window cannot read local files."
+        };
+      }
+      const resolved = source.kind === "path" ? { ...source, path: resolveUserPath(source.path) } : source;
+      return uploadAttachment({
+        source: resolved,
+        backendUrl: backendService.getBackendUrl(),
+        token: backendService.getDesktopToken()
+      });
+    }
+  );
   electron.ipcMain.handle("open-external", async (_, url) => openExternalVetted(url));
   electron.ipcMain.handle(
     "show-item-in-folder",
@@ -85595,6 +86604,13 @@ electron.app.whenReady().then(async () => {
     }
   });
   electron.ipcMain.handle("show-open-dialog", async (event, options) => {
+    if (attachQueue.paths.length > 0) {
+      const filePaths = attachQueue.paths.splice(0);
+      console.log(
+        `[dev-driver] answered the file dialog with ${filePaths.length} queued path(s)`
+      );
+      return { canceled: false, filePaths };
+    }
     const parent = electron.BrowserWindow.fromWebContents(event.sender) ?? mainWindow;
     if (!parent) {
       logger.error(