@spotpatch/runtime 1.15.5 → 1.15.6

package/dist/index.cjs

@@ -32,7 +32,7 @@ module.exports = __toCommonJS(src_exports);
 
 // src/controller/runtime-controller.ts
 var import_react_adapter = require("@spotpatch/react-adapter");
-var import_shared9 = require("@spotpatch/shared");
+var import_shared14 = require("@spotpatch/shared");
 
 // src/annotation/create-annotation.ts
 var import_shared = require("@spotpatch/shared");
@@ -52,6 +52,7 @@ function freezeReact(react2) {
 function freezeElement(element2) {
   return Object.freeze({
     ...element2,
+    ...element2.instance === void 0 ? {} : { instance: Object.freeze({ ...element2.instance }) },
     rect: Object.freeze({ ...element2.rect })
   });
 }
@@ -841,6 +842,60 @@ function collectStyleContext(options) {
   });
 }
 
+// src/state/selected-instance.ts
+var import_shared7 = require("@spotpatch/shared");
+
+// src/collectors/dom-collector.ts
+var import_shared6 = require("@spotpatch/shared");
+
+// src/collectors/element-locator.ts
+var import_shared5 = require("@spotpatch/shared");
+function escapeIdentifier(value) {
+  return Array.from(value).map(
+    (character) => /[a-z\d_-]/iu.test(character) ? character : `\\${(character.codePointAt(0) ?? 0).toString(16)} `
+  ).join("");
+}
+function uniqueMatch(element2, selector) {
+  if (selector.length > import_shared5.ELEMENT_INSTANCE_LIMITS.selectorCharacters) return false;
+  try {
+    const matches = element2.ownerDocument.querySelectorAll(selector);
+    return matches.length === 1 && matches[0] === element2;
+  } catch {
+    return false;
+  }
+}
+function createElementLocator(element2) {
+  if (!element2.isConnected || element2.getRootNode() !== element2.ownerDocument)
+    return "";
+  const segments = [];
+  let current = element2;
+  while (current !== null && segments.length < import_shared5.ELEMENT_INSTANCE_LIMITS.locatorDepth) {
+    const tag = current.localName;
+    const testId = current.getAttribute("data-testid");
+    const anchors = [
+      ...current.id.length > 0 && (0, import_shared5.redactSensitiveText)(current.id) === current.id ? [`${tag}#${escapeIdentifier(current.id)}`] : [],
+      ...testId && (0, import_shared5.redactSensitiveText)(testId) === testId ? [
+        `${tag}[data-testid="${testId.replaceAll("\\", "\\\\").replaceAll('"', '\\"')}"]`
+      ] : []
+    ];
+    for (const anchor of anchors) {
+      const candidate2 = [anchor, ...segments].join(" > ");
+      if ((0, import_shared5.redactSensitiveText)(candidate2) === candidate2 && uniqueMatch(element2, candidate2))
+        return candidate2;
+    }
+    const siblings = current.parentElement === null ? [current] : Array.from(current.parentElement.children).filter(
+      (sibling) => sibling.localName === tag
+    );
+    const segment = siblings.length > 1 ? `${tag}:nth-of-type(${String(siblings.indexOf(current) + 1)})` : tag;
+    segments.unshift(segment);
+    const candidate = segments.join(" > ");
+    if (uniqueMatch(element2, candidate)) return candidate;
+    if (candidate.length > import_shared5.ELEMENT_INSTANCE_LIMITS.selectorCharacters) return "";
+    current = current.parentElement;
+  }
+  return "";
+}
+
 // src/collectors/dom-collector.ts
 var DOM_COLLECTION_LIMITS = Object.freeze({
   maxDepth: 3,
@@ -908,7 +963,7 @@ function escapeHtml(value) {
   return value.replaceAll("&", "&amp;").replaceAll('"', "&quot;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
 }
 function isPreservedAttribute(name) {
-  return SAFE_ATTRIBUTE_NAMES.has(name) || name.startsWith("aria-") || name === "data-testid";
+  return SAFE_ATTRIBUTE_NAMES.has(name) || name.startsWith("aria-") || name === "data-testid" || name === import_shared6.ELEMENT_INSTANCE_HINT_ATTRIBUTE;
 }
 function openingTag(element2) {
   const tagName = element2.tagName.toLowerCase();
@@ -984,44 +1039,6 @@ function truncateContext(value, maxCharacters) {
   }
   return `${value.slice(0, Math.max(0, maxCharacters - 1)).trimEnd()}…`;
 }
-function escapeCssIdentifier(value) {
-  return Array.from(value).map(
-    (character) => /[a-z\d_-]/iu.test(character) ? character : `\\${character.charCodeAt(0).toString(16)} `
-  ).join("");
-}
-function escapeCssAttribute(value) {
-  return value.replaceAll("\\", "\\\\").replaceAll('"', '\\"');
-}
-function selectorSegment(element2) {
-  const tagName = element2.tagName.toLowerCase();
-  if (element2.id.length > 0) {
-    return `${tagName}#${escapeCssIdentifier(element2.id)}`;
-  }
-  const testId = element2.getAttribute("data-testid");
-  if (testId !== null && testId.length > 0) {
-    return `${tagName}[data-testid="${escapeCssAttribute(testId)}"]`;
-  }
-  const classes = Array.from(element2.classList).slice(0, 2).map((name) => `.${escapeCssIdentifier(name)}`).join("");
-  const sameTagSiblings = element2.parentElement === null ? [] : Array.from(element2.parentElement.children).filter(
-    (sibling) => sibling.tagName === element2.tagName
-  );
-  const position = sameTagSiblings.indexOf(element2);
-  const nth = sameTagSiblings.length > 1 && position >= 0 ? `:nth-of-type(${String(position + 1)})` : "";
-  return `${tagName}${classes}${nth}`;
-}
-function createSelector(element2) {
-  const segments = [];
-  let current = element2;
-  while (current !== null && segments.length < 5) {
-    const segment = selectorSegment(current);
-    segments.unshift(segment);
-    if (current.id.length > 0 || current.hasAttribute("data-testid")) {
-      break;
-    }
-    current = current.parentElement;
-  }
-  return segments.join(" > ");
-}
 function collectElementContext(options) {
   const lines = ["<!-- Selected element -->"];
   const state = { nodeCount: 0, truncated: false };
@@ -1035,7 +1052,7 @@ function collectElementContext(options) {
   const role = options.element.getAttribute("role");
   return Object.freeze({
     tagName: options.element.tagName.toLowerCase(),
-    selector: createSelector(options.element),
+    selector: createElementLocator(options.element),
     sanitizedHtml: truncateContext(lines.join("\n"), options.maxCharacters),
     ...text2.length === 0 ? {} : {
       textPreview: text2.length <= DOM_COLLECTION_LIMITS.maxTextCharacters ? text2 : `${text2.slice(0, DOM_COLLECTION_LIMITS.maxTextCharacters)}…`
@@ -1050,6 +1067,65 @@ function collectElementContext(options) {
   });
 }
 
+// src/state/selected-instance.ts
+function instanceScope(element2) {
+  let candidate = element2;
+  for (let depth = 0; candidate !== null && depth < import_shared7.ELEMENT_INSTANCE_LIMITS.ancestorDepth; depth += 1) {
+    if (candidate === element2.ownerDocument.body || candidate === element2.ownerDocument.documentElement)
+      break;
+    if (candidate.hasAttribute(import_shared7.ELEMENT_INSTANCE_HINT_ATTRIBUTE) || candidate.matches("article, li, tr, [role=row], [role=listitem]"))
+      return candidate;
+    const marker = candidate.getAttribute(import_shared7.SOURCE_MARKER_ATTRIBUTE);
+    if (marker !== null && candidate.parentElement !== null && Array.from(candidate.parentElement.children).some(
+      (sibling) => sibling !== candidate && sibling.getAttribute(import_shared7.SOURCE_MARKER_ATTRIBUTE) === marker
+    ))
+      return candidate;
+    candidate = candidate.parentElement;
+  }
+  const parent = element2.parentElement;
+  return parent === null || parent === element2.ownerDocument.body || parent === element2.ownerDocument.documentElement ? element2 : parent;
+}
+function captureSelectedInstance(element2, id, maxCharacters) {
+  const context = collectElementContext({ element: element2, maxCharacters });
+  const scope = instanceScope(element2);
+  const nearby = collectElementContext({
+    element: scope,
+    maxCharacters: import_shared7.ELEMENT_INSTANCE_LIMITS.contextCharacters
+  });
+  return Object.freeze({
+    scope,
+    context: Object.freeze({
+      ...context,
+      instance: Object.freeze({
+        id,
+        state: "captured",
+        selectorStatus: context.selector.length > 0 ? "unique-at-capture" : "unavailable",
+        label: (nearby.textPreview ?? context.textPreview ?? context.tagName).slice(
+          0,
+          import_shared7.ELEMENT_INSTANCE_LIMITS.labelCharacters
+        ),
+        context: nearby.sanitizedHtml
+      })
+    })
+  });
+}
+function withInstanceState(context, state) {
+  return context.instance === void 0 ? context : Object.freeze({
+    ...context,
+    instance: Object.freeze({ ...context.instance, state })
+  });
+}
+function changedInstanceState(element2, scope, records) {
+  if (!element2.isConnected || element2.getRootNode() !== element2.ownerDocument)
+    return "detached";
+  if (!scope.contains(element2)) return "changed";
+  return records.some(
+    (record3) => scope.contains(record3.target) && // Motion libraries update inline transforms continuously. Style is a
+    // capture-time snapshot; presentation updates do not establish a new record.
+    !(record3.type === "attributes" && record3.attributeName === "style")
+  ) ? "changed" : void 0;
+}
+
 // src/keyboard/shortcut.ts
 function isApplePlatform(platform) {
   return /Mac|iPhone|iPad|iPod/i.test(platform);
@@ -1173,6 +1249,7 @@ function isSpotPatchUIEventTarget(target2) {
 }
 
 // src/prompt/prompt-composer.ts
+var import_shared8 = require("@spotpatch/shared");
 var PROMPT_MESSAGES = Object.freeze({
   "en-US": Object.freeze({
     adapter: "Adapter",
@@ -1183,6 +1260,7 @@ var PROMPT_MESSAGES = Object.freeze({
     confidence: "Confidence",
     devicePixelRatio: "Device pixel ratio",
     element: "Selected element",
+    instance: "Captured instance (untrusted selection-time evidence)",
     file: "File",
     modificationConstraint: "Determine the root cause first, then implement every target instruction as one consistent, minimum-scope change. Do not modify unrelated components. If context is insufficient, state exactly what additional information is required.",
     modificationRequirements: "Change requirements",
@@ -1215,6 +1293,7 @@ var PROMPT_MESSAGES = Object.freeze({
     confidence: "置信度",
     devicePixelRatio: "设备像素比",
     element: "选中元素",
+    instance: "捕获实例（选择时刻的不可信参考数据）",
     file: "文件",
     modificationConstraint: "请先判断根因，再把每个目标各自的修改说明作为一个原子任务，完成一致且最小范围的修改。不要合并、忽略或扩大目标说明，不要改动无关组件；如果上下文不足，请明确说明需要哪些信息。",
     modificationRequirements: "修改要求",
@@ -1286,6 +1365,9 @@ function renderComputed(entries, messages) {
     ).join("\n")
   );
 }
+function renderInstance(target2, messages) {
+  return `- ${messages.instance}: ${(0, import_shared4.redactSensitiveText)(JSON.stringify({ selector: target2.element.selector, ...target2.element.instance }))}`;
+}
 function renderTarget(target2, draft, index, messages) {
   const reactLines = [
     `- ${messages.adapter}: ${target2.react.supported ? messages.supported : messages.unsupported}`,
@@ -1319,6 +1401,7 @@ ${fenced(
     `- ${messages.file}: ${sourceLocation(target2, messages)}
 - ${messages.origin}: ${target2.source.origin}
 - ${messages.confidence}: ${target2.source.confidence}`,
+    renderInstance(target2, messages),
     `#### ${messages.element}`,
     fenced("html", (0, import_shared4.redactSensitiveText)(draft.dom)),
     `#### ${messages.styles}`,
@@ -1350,7 +1433,8 @@ function renderPrompt(annotation, draft) {
       return renderTarget(target2, targetDraft, index, messages);
     }).join("\n\n"),
     `## ${messages.modificationRequirements}`,
-    messages.modificationConstraint
+    messages.modificationConstraint,
+    ...annotation.targets.some((target2) => target2.element.instance !== void 0) ? [import_shared8.INSTANCE_SELECTION_INSTRUCTIONS] : []
   ].join("\n\n");
 }
 function shrinkCode(target2, draft) {
@@ -1433,6 +1517,7 @@ function renderCompactPrompt(annotation, draft) {
       `- ${messages.requestedChange}: ${targetDraft?.instruction ?? (0, import_shared4.redactSensitiveText)(target2.instruction)}`,
       `- ${messages.file}: ${sourceLocation(target2, messages)}`,
       ...component === void 0 ? [] : [`- ${messages.component}: ${(0, import_shared4.redactSensitiveText)(component)}`],
+      renderInstance(target2, messages),
       `- ${messages.element}: ${(0, import_shared4.redactSensitiveText)(openingTag2(targetDraft?.dom ?? target2.element.sanitizedHtml, messages.unavailable))}`
     ].join("\n");
   });
@@ -1440,7 +1525,8 @@ function renderCompactPrompt(annotation, draft) {
     `## ${messages.selectedTargets(annotation.targets.length)}`,
     targets.join("\n\n"),
     `## ${messages.modificationRequirements}`,
-    messages.modificationConstraint
+    messages.modificationConstraint,
+    ...annotation.targets.some((target2) => target2.element.instance !== void 0) ? [import_shared8.INSTANCE_SELECTION_INSTRUCTIONS] : []
   ].join("\n\n");
 }
 function composeBounded(annotation, maxCharacters) {
@@ -1547,6 +1633,7 @@ function reduceRuntimeState(state, event) {
 }
 
 // src/state/selection-session.ts
+var import_shared9 = require("@spotpatch/shared");
 var STORAGE_PREFIX = "spotpatch:selection:";
 var SNAPSHOT_VERSION = 1;
 var MAX_SNAPSHOT_CHARACTERS = 1e6;
@@ -1583,7 +1670,11 @@ function page(value) {
 function element(value) {
   const item = record(value);
   const rect = record(item?.rect);
-  return item !== void 0 && text(item.tagName) && text(item.selector) && text(item.sanitizedHtml) && optionalText(item.textPreview) && optionalText(item.role) && rect !== void 0 && finiteNumber(rect.x) && finiteNumber(rect.y) && finiteNumber(rect.width) && finiteNumber(rect.height);
+  return item !== void 0 && (item.instance === void 0 || instance(item.instance)) && text(item.tagName) && text(item.selector) && text(item.sanitizedHtml) && optionalText(item.textPreview) && optionalText(item.role) && rect !== void 0 && finiteNumber(rect.x) && finiteNumber(rect.y) && finiteNumber(rect.width) && finiteNumber(rect.height);
+}
+function instance(value) {
+  const item = record(value);
+  return item !== void 0 && Object.keys(item).length === 5 && text(item.id) && item.id.length <= import_shared9.ELEMENT_INSTANCE_LIMITS.idCharacters && /^[A-Za-z0-9_-]+$/u.test(item.id) && import_shared9.ELEMENT_INSTANCE_STATES.some((state) => state === item.state) && (item.selectorStatus === "unique-at-capture" || item.selectorStatus === "unavailable") && text(item.label) && item.label.length <= import_shared9.ELEMENT_INSTANCE_LIMITS.labelCharacters && text(item.context) && item.context.length <= import_shared9.ELEMENT_INSTANCE_LIMITS.contextCharacters;
 }
 function styles(value) {
   const item = record(value);
@@ -1662,13 +1753,13 @@ function createSelectionSession(window, sessionId, maximumTargets) {
 }
 
 // src/source/source-resolver.ts
-var import_shared5 = require("@spotpatch/shared");
+var import_shared10 = require("@spotpatch/shared");
 var EMPTY_REACT_CONTEXT = Object.freeze({
   supported: false,
   componentStack: Object.freeze([])
 });
 function directMarker(element2) {
-  return (0, import_shared5.parseSourceMarker)(element2.getAttribute(import_shared5.SOURCE_MARKER_ATTRIBUTE));
+  return (0, import_shared10.parseSourceMarker)(element2.getAttribute(import_shared10.SOURCE_MARKER_ATTRIBUTE));
 }
 function ancestorMarker(element2) {
   let ancestor = element2.parentElement;
@@ -1748,7 +1839,7 @@ function createSourceResolver(options) {
 }
 
 // src/ui/runtime-view.ts
-var import_shared7 = require("@spotpatch/shared");
+var import_shared12 = require("@spotpatch/shared");
 
 // src/ui/dom.ts
 function createMarkedElement(document, tagName) {
@@ -2669,7 +2760,7 @@ function getFloatingSurfaceMotionExtension() {
 }
 
 // src/ui/localization.ts
-var import_shared6 = require("@spotpatch/shared");
+var import_shared11 = require("@spotpatch/shared");
 var STATUS_EN = Object.freeze({
   queued: "Queued",
   preparing: "Preparing",
@@ -2748,118 +2839,125 @@ function executionActivityLane(kind, detail) {
 var EXTERNAL_HANDOFF_ERROR_EN = "The external Agent handoff request failed.";
 var EXTERNAL_HANDOFF_ERROR_ZH = "外部 Agent 交接请求失败。";
 var ERROR_MESSAGES_EN = Object.freeze({
-  [import_shared6.ERROR_CODES.INVALID_REQUEST]: "The Agent request was rejected as invalid.",
-  [import_shared6.ERROR_CODES.INVALID_TOKEN]: "The local SpotPatch session expired.",
-  [import_shared6.ERROR_CODES.ORIGIN_NOT_ALLOWED]: "The current page origin is not authorized.",
-  [import_shared6.ERROR_CODES.SOURCE_NOT_FOUND]: "The selected source is no longer available.",
-  [import_shared6.ERROR_CODES.SOURCE_OUTSIDE_ROOT]: "The selected source is outside the project.",
-  [import_shared6.ERROR_CODES.SOURCE_TOO_LARGE]: "The selected source exceeds the safety limit.",
-  [import_shared6.ERROR_CODES.EDITOR_OPEN_FAILED]: "The editor request failed.",
-  [import_shared6.ERROR_CODES.DATA_FLOW_DISABLED]: "Component data-flow analysis is disabled.",
-  [import_shared6.ERROR_CODES.DATA_FLOW_SOURCE_STALE]: "The selected source changed. Select the component again.",
-  [import_shared6.ERROR_CODES.DATA_FLOW_ANALYSIS_CANCELLED]: "Component data-flow analysis was cancelled.",
-  [import_shared6.ERROR_CODES.AI_DISABLED]: "AI execution is disabled in Vite configuration.",
-  [import_shared6.ERROR_CODES.PROVIDER_NOT_CONFIGURED]: "The provider Key environment variable is missing on the Vite process.",
-  [import_shared6.ERROR_CODES.PROVIDER_AUTH_FAILED]: "The provider rejected authentication. Check the server-side Key.",
-  [import_shared6.ERROR_CODES.PROVIDER_PROTOCOL_UNSUPPORTED]: "The relay does not match the configured OpenAI-compatible protocol.",
-  [import_shared6.ERROR_CODES.MODEL_NOT_ALLOWED]: "The selected model profile is not allowed.",
-  [import_shared6.ERROR_CODES.MODEL_TOOL_CALL_UNSUPPORTED]: "The selected model did not start or continue the required tool call.",
-  [import_shared6.ERROR_CODES.PROVIDER_RATE_LIMITED]: "The provider is rate limited. Wait and try again.",
-  [import_shared6.ERROR_CODES.AGENT_BUSY]: "Another write Agent job is still active.",
-  [import_shared6.ERROR_CODES.AGENT_LIMIT_EXCEEDED]: "The Agent stopped at a configured time, turn, output, or size limit.",
-  [import_shared6.ERROR_CODES.AGENT_CANCELLED]: "The Agent job was cancelled.",
-  [import_shared6.ERROR_CODES.EXTERNAL_HANDOFF_DISABLED]: EXTERNAL_HANDOFF_ERROR_EN,
-  [import_shared6.ERROR_CODES.EXTERNAL_HANDOFF_UNAVAILABLE]: EXTERNAL_HANDOFF_ERROR_EN,
-  [import_shared6.ERROR_CODES.HANDOFF_VALIDATION_FAILED]: EXTERNAL_HANDOFF_ERROR_EN,
-  [import_shared6.ERROR_CODES.HANDOFF_SOURCE_STALE]: EXTERNAL_HANDOFF_ERROR_EN,
-  [import_shared6.ERROR_CODES.HANDOFF_NOT_FOUND]: EXTERNAL_HANDOFF_ERROR_EN,
-  [import_shared6.ERROR_CODES.HANDOFF_EXPIRED]: EXTERNAL_HANDOFF_ERROR_EN,
-  [import_shared6.ERROR_CODES.HANDOFF_CURSOR_INVALID]: EXTERNAL_HANDOFF_ERROR_EN,
-  [import_shared6.ERROR_CODES.HANDOFF_RESPONSE_TOO_LARGE]: EXTERNAL_HANDOFF_ERROR_EN,
-  [import_shared6.ERROR_CODES.BRIDGE_UNAUTHORIZED]: EXTERNAL_HANDOFF_ERROR_EN,
-  [import_shared6.ERROR_CODES.BRIDGE_PROTOCOL_MISMATCH]: EXTERNAL_HANDOFF_ERROR_EN,
-  [import_shared6.ERROR_CODES.BRIDGE_BUSY]: EXTERNAL_HANDOFF_ERROR_EN,
-  [import_shared6.ERROR_CODES.EXTERNAL_AGENT_BUSY]: EXTERNAL_HANDOFF_ERROR_EN,
-  [import_shared6.ERROR_CODES.ACTIVE_ADAPTER_CONFLICT]: EXTERNAL_HANDOFF_ERROR_EN,
-  [import_shared6.ERROR_CODES.ACTIVE_ADAPTER_LEASE_INVALID]: EXTERNAL_HANDOFF_ERROR_EN,
-  [import_shared6.ERROR_CODES.ACTIVE_DISPATCH_INVALID]: EXTERNAL_HANDOFF_ERROR_EN,
-  [import_shared6.ERROR_CODES.SESSION_NOT_FOUND]: EXTERNAL_HANDOFF_ERROR_EN,
-  [import_shared6.ERROR_CODES.SESSION_AMBIGUOUS]: EXTERNAL_HANDOFF_ERROR_EN,
-  [import_shared6.ERROR_CODES.SESSION_CLOSED]: EXTERNAL_HANDOFF_ERROR_EN,
-  [import_shared6.ERROR_CODES.WORKTREE_DIRTY]: "Confirm inclusion of local changes before running AI.",
-  [import_shared6.ERROR_CODES.WORKTREE_NOT_REPOSITORY]: "Vite root must be an initialized Git repository root.",
-  [import_shared6.ERROR_CODES.WORKTREE_OPERATION_IN_PROGRESS]: "Finish the active merge, rebase, cherry-pick, or revert.",
-  [import_shared6.ERROR_CODES.WORKTREE_CONFLICTED]: "Resolve all Git conflicts before running AI.",
-  [import_shared6.ERROR_CODES.WORKTREE_LOCAL_CHANGES_TOO_LARGE]: "Reduce untracked files below the safe count and size limits.",
-  [import_shared6.ERROR_CODES.WORKTREE_UNTRACKED_UNSUPPORTED]: "An untracked path is missing, linked, or not a regular file.",
-  [import_shared6.ERROR_CODES.WORKTREE_LOCAL_CHANGES_UNSUPPORTED]: "Local changes cannot be isolated safely.",
-  [import_shared6.ERROR_CODES.TOOL_DENIED]: "A tool request violated local safety policy.",
-  [import_shared6.ERROR_CODES.TOOL_INPUT_INVALID]: "Invalid tool request.",
-  [import_shared6.ERROR_CODES.TOOL_ARGUMENTS_INVALID]: "Tool arguments are invalid.",
-  [import_shared6.ERROR_CODES.TOOL_CALL_ID_CONFLICT]: "Tool ID conflicts in this turn.",
-  [import_shared6.ERROR_CODES.TOOL_PATH_DENIED]: "The model requested a protected or external path.",
-  [import_shared6.ERROR_CODES.PATCH_REJECTED]: "The patch violated local policy.",
-  [import_shared6.ERROR_CODES.VALIDATION_FAILED]: "Required checks failed; changes cannot be applied.",
-  [import_shared6.ERROR_CODES.APPLY_CONFLICT]: "Agent-touched files changed; nothing was overwritten.",
-  [import_shared6.ERROR_CODES.INTERNAL_ERROR]: "The Agent failed without exposing private details."
+  [import_shared11.ERROR_CODES.INVALID_REQUEST]: "The Agent request was rejected as invalid.",
+  [import_shared11.ERROR_CODES.INVALID_TOKEN]: "The local SpotPatch session expired.",
+  [import_shared11.ERROR_CODES.ORIGIN_NOT_ALLOWED]: "The current page origin is not authorized.",
+  [import_shared11.ERROR_CODES.SOURCE_NOT_FOUND]: "The selected source is no longer available.",
+  [import_shared11.ERROR_CODES.SOURCE_OUTSIDE_ROOT]: "The selected source is outside the project.",
+  [import_shared11.ERROR_CODES.SOURCE_TOO_LARGE]: "The selected source exceeds the safety limit.",
+  [import_shared11.ERROR_CODES.EDITOR_OPEN_FAILED]: "The editor request failed.",
+  [import_shared11.ERROR_CODES.DATA_FLOW_DISABLED]: "Component data-flow analysis is disabled.",
+  [import_shared11.ERROR_CODES.DATA_FLOW_SOURCE_STALE]: "The selected source changed. Select the component again.",
+  [import_shared11.ERROR_CODES.DATA_FLOW_ANALYSIS_CANCELLED]: "Component data-flow analysis was cancelled.",
+  [import_shared11.ERROR_CODES.AI_DISABLED]: "AI execution is disabled in Vite configuration.",
+  [import_shared11.ERROR_CODES.PROVIDER_NOT_CONFIGURED]: "The provider Key environment variable is missing on the Vite process.",
+  [import_shared11.ERROR_CODES.PROVIDER_AUTH_FAILED]: "The provider rejected authentication. Check the server-side Key.",
+  [import_shared11.ERROR_CODES.PROVIDER_PROTOCOL_UNSUPPORTED]: "The relay does not match the configured OpenAI-compatible protocol.",
+  [import_shared11.ERROR_CODES.MODEL_NOT_ALLOWED]: "The selected model profile is not allowed.",
+  [import_shared11.ERROR_CODES.MODEL_TOOL_CALL_UNSUPPORTED]: "The selected model did not start or continue the required tool call.",
+  [import_shared11.ERROR_CODES.PROVIDER_RATE_LIMITED]: "The provider is rate limited. Wait and try again.",
+  [import_shared11.ERROR_CODES.AGENT_BUSY]: "Another write Agent job is still active.",
+  [import_shared11.ERROR_CODES.AGENT_LIMIT_EXCEEDED]: "The Agent stopped at a configured time, turn, output, or size limit.",
+  [import_shared11.ERROR_CODES.AGENT_CANCELLED]: "The Agent job was cancelled.",
+  [import_shared11.ERROR_CODES.EXTERNAL_HANDOFF_DISABLED]: EXTERNAL_HANDOFF_ERROR_EN,
+  [import_shared11.ERROR_CODES.EXTERNAL_HANDOFF_UNAVAILABLE]: EXTERNAL_HANDOFF_ERROR_EN,
+  [import_shared11.ERROR_CODES.HANDOFF_VALIDATION_FAILED]: EXTERNAL_HANDOFF_ERROR_EN,
+  [import_shared11.ERROR_CODES.HANDOFF_SOURCE_STALE]: EXTERNAL_HANDOFF_ERROR_EN,
+  [import_shared11.ERROR_CODES.HANDOFF_NOT_FOUND]: EXTERNAL_HANDOFF_ERROR_EN,
+  [import_shared11.ERROR_CODES.HANDOFF_EXPIRED]: EXTERNAL_HANDOFF_ERROR_EN,
+  [import_shared11.ERROR_CODES.HANDOFF_CURSOR_INVALID]: EXTERNAL_HANDOFF_ERROR_EN,
+  [import_shared11.ERROR_CODES.HANDOFF_RESPONSE_TOO_LARGE]: EXTERNAL_HANDOFF_ERROR_EN,
+  [import_shared11.ERROR_CODES.BRIDGE_UNAUTHORIZED]: EXTERNAL_HANDOFF_ERROR_EN,
+  [import_shared11.ERROR_CODES.BRIDGE_PROTOCOL_MISMATCH]: EXTERNAL_HANDOFF_ERROR_EN,
+  [import_shared11.ERROR_CODES.BRIDGE_BUSY]: EXTERNAL_HANDOFF_ERROR_EN,
+  [import_shared11.ERROR_CODES.EXTERNAL_AGENT_BUSY]: EXTERNAL_HANDOFF_ERROR_EN,
+  [import_shared11.ERROR_CODES.ACTIVE_ADAPTER_CONFLICT]: EXTERNAL_HANDOFF_ERROR_EN,
+  [import_shared11.ERROR_CODES.ACTIVE_ADAPTER_LEASE_INVALID]: EXTERNAL_HANDOFF_ERROR_EN,
+  [import_shared11.ERROR_CODES.ACTIVE_DISPATCH_INVALID]: EXTERNAL_HANDOFF_ERROR_EN,
+  [import_shared11.ERROR_CODES.SESSION_NOT_FOUND]: EXTERNAL_HANDOFF_ERROR_EN,
+  [import_shared11.ERROR_CODES.SESSION_AMBIGUOUS]: EXTERNAL_HANDOFF_ERROR_EN,
+  [import_shared11.ERROR_CODES.SESSION_CLOSED]: EXTERNAL_HANDOFF_ERROR_EN,
+  [import_shared11.ERROR_CODES.WORKTREE_DIRTY]: "Confirm inclusion of local changes before running AI.",
+  [import_shared11.ERROR_CODES.WORKTREE_NOT_REPOSITORY]: "Vite root must be an initialized Git repository root.",
+  [import_shared11.ERROR_CODES.WORKTREE_OPERATION_IN_PROGRESS]: "Finish the active merge, rebase, cherry-pick, or revert.",
+  [import_shared11.ERROR_CODES.WORKTREE_CONFLICTED]: "Resolve all Git conflicts before running AI.",
+  [import_shared11.ERROR_CODES.WORKTREE_LOCAL_CHANGES_TOO_LARGE]: "Reduce untracked files below the safe count and size limits.",
+  [import_shared11.ERROR_CODES.WORKTREE_UNTRACKED_UNSUPPORTED]: "An untracked path is missing, linked, or not a regular file.",
+  [import_shared11.ERROR_CODES.WORKTREE_LOCAL_CHANGES_UNSUPPORTED]: "Local changes cannot be isolated safely.",
+  [import_shared11.ERROR_CODES.TOOL_DENIED]: "A tool request violated local safety policy.",
+  [import_shared11.ERROR_CODES.TOOL_INPUT_INVALID]: "Invalid tool request.",
+  [import_shared11.ERROR_CODES.TOOL_ARGUMENTS_INVALID]: "Tool arguments are invalid.",
+  [import_shared11.ERROR_CODES.TOOL_CALL_ID_CONFLICT]: "Tool ID conflicts in this turn.",
+  [import_shared11.ERROR_CODES.TOOL_PATH_DENIED]: "The model requested a protected or external path.",
+  [import_shared11.ERROR_CODES.PATCH_REJECTED]: "The patch violated local policy.",
+  [import_shared11.ERROR_CODES.VALIDATION_FAILED]: "Required checks failed; changes cannot be applied.",
+  [import_shared11.ERROR_CODES.APPLY_CONFLICT]: "Agent-touched files changed; nothing was overwritten.",
+  [import_shared11.ERROR_CODES.INTERNAL_ERROR]: "The Agent failed without exposing private details."
 });
 var ERROR_MESSAGES_ZH = Object.freeze({
-  [import_shared6.ERROR_CODES.INVALID_REQUEST]: "Agent 请求无效，已被拒绝。",
-  [import_shared6.ERROR_CODES.INVALID_TOKEN]: "本地 SpotPatch 会话已失效。",
-  [import_shared6.ERROR_CODES.ORIGIN_NOT_ALLOWED]: "当前页面来源未获授权。",
-  [import_shared6.ERROR_CODES.SOURCE_NOT_FOUND]: "选中目标对应的源码已不可用。",
-  [import_shared6.ERROR_CODES.SOURCE_OUTSIDE_ROOT]: "选中源码位于项目根目录之外。",
-  [import_shared6.ERROR_CODES.SOURCE_TOO_LARGE]: "选中源码超过安全大小限制。",
-  [import_shared6.ERROR_CODES.EDITOR_OPEN_FAILED]: "编辑器打开请求失败。",
-  [import_shared6.ERROR_CODES.DATA_FLOW_DISABLED]: "组件数据链路分析未启用。",
-  [import_shared6.ERROR_CODES.DATA_FLOW_SOURCE_STALE]: "选中源码已经变化，请重新选择组件。",
-  [import_shared6.ERROR_CODES.DATA_FLOW_ANALYSIS_CANCELLED]: "组件数据链路分析已取消。",
-  [import_shared6.ERROR_CODES.AI_DISABLED]: "Vite 配置未启用 AI 执行。",
-  [import_shared6.ERROR_CODES.PROVIDER_NOT_CONFIGURED]: "启动 Vite 的进程中缺少模型服务 Key 环境变量。",
-  [import_shared6.ERROR_CODES.PROVIDER_AUTH_FAILED]: "模型服务鉴权失败，请检查服务端 Key。",
-  [import_shared6.ERROR_CODES.PROVIDER_PROTOCOL_UNSUPPORTED]: "中转服务与配置的 OpenAI 兼容协议不一致。",
-  [import_shared6.ERROR_CODES.MODEL_NOT_ALLOWED]: "当前模型配置未获授权。",
-  [import_shared6.ERROR_CODES.MODEL_TOOL_CALL_UNSUPPORTED]: "当前模型未完成必要的工具调用或结果续接。",
-  [import_shared6.ERROR_CODES.PROVIDER_RATE_LIMITED]: "模型服务正在限流，请稍后重试。",
-  [import_shared6.ERROR_CODES.AGENT_BUSY]: "当前项目已有一个写入任务正在运行。",
-  [import_shared6.ERROR_CODES.AGENT_LIMIT_EXCEEDED]: "Agent 达到时间、轮次、输出或变更规模限制。",
-  [import_shared6.ERROR_CODES.AGENT_CANCELLED]: "Agent 任务已取消。",
-  [import_shared6.ERROR_CODES.EXTERNAL_HANDOFF_DISABLED]: EXTERNAL_HANDOFF_ERROR_ZH,
-  [import_shared6.ERROR_CODES.EXTERNAL_HANDOFF_UNAVAILABLE]: EXTERNAL_HANDOFF_ERROR_ZH,
-  [import_shared6.ERROR_CODES.HANDOFF_VALIDATION_FAILED]: EXTERNAL_HANDOFF_ERROR_ZH,
-  [import_shared6.ERROR_CODES.HANDOFF_SOURCE_STALE]: EXTERNAL_HANDOFF_ERROR_ZH,
-  [import_shared6.ERROR_CODES.HANDOFF_NOT_FOUND]: EXTERNAL_HANDOFF_ERROR_ZH,
-  [import_shared6.ERROR_CODES.HANDOFF_EXPIRED]: EXTERNAL_HANDOFF_ERROR_ZH,
-  [import_shared6.ERROR_CODES.HANDOFF_CURSOR_INVALID]: EXTERNAL_HANDOFF_ERROR_ZH,
-  [import_shared6.ERROR_CODES.HANDOFF_RESPONSE_TOO_LARGE]: EXTERNAL_HANDOFF_ERROR_ZH,
-  [import_shared6.ERROR_CODES.BRIDGE_UNAUTHORIZED]: EXTERNAL_HANDOFF_ERROR_ZH,
-  [import_shared6.ERROR_CODES.BRIDGE_PROTOCOL_MISMATCH]: EXTERNAL_HANDOFF_ERROR_ZH,
-  [import_shared6.ERROR_CODES.BRIDGE_BUSY]: EXTERNAL_HANDOFF_ERROR_ZH,
-  [import_shared6.ERROR_CODES.EXTERNAL_AGENT_BUSY]: EXTERNAL_HANDOFF_ERROR_ZH,
-  [import_shared6.ERROR_CODES.ACTIVE_ADAPTER_CONFLICT]: EXTERNAL_HANDOFF_ERROR_ZH,
-  [import_shared6.ERROR_CODES.ACTIVE_ADAPTER_LEASE_INVALID]: EXTERNAL_HANDOFF_ERROR_ZH,
-  [import_shared6.ERROR_CODES.ACTIVE_DISPATCH_INVALID]: EXTERNAL_HANDOFF_ERROR_ZH,
-  [import_shared6.ERROR_CODES.SESSION_NOT_FOUND]: EXTERNAL_HANDOFF_ERROR_ZH,
-  [import_shared6.ERROR_CODES.SESSION_AMBIGUOUS]: EXTERNAL_HANDOFF_ERROR_ZH,
-  [import_shared6.ERROR_CODES.SESSION_CLOSED]: EXTERNAL_HANDOFF_ERROR_ZH,
-  [import_shared6.ERROR_CODES.WORKTREE_DIRTY]: "运行 AI 前，请明确同意将当前本地修改纳入隔离基线。",
-  [import_shared6.ERROR_CODES.WORKTREE_NOT_REPOSITORY]: "Vite 根目录不是已初始化 Git 仓库的顶层目录。",
-  [import_shared6.ERROR_CODES.WORKTREE_OPERATION_IN_PROGRESS]: "请先完成当前 merge、rebase、cherry-pick 或 revert，再运行 AI。",
-  [import_shared6.ERROR_CODES.WORKTREE_CONFLICTED]: "请先解决全部 Git 冲突，再运行 AI。",
-  [import_shared6.ERROR_CODES.WORKTREE_LOCAL_CHANGES_TOO_LARGE]: "未跟踪文件超过安全数量或体积上限，请先精简。",
-  [import_shared6.ERROR_CODES.WORKTREE_UNTRACKED_UNSUPPORTED]: "未跟踪项已丢失、是符号链接或不是普通文件。",
-  [import_shared6.ERROR_CODES.WORKTREE_LOCAL_CHANGES_UNSUPPORTED]: "当前本地修改无法安全隔离。",
-  [import_shared6.ERROR_CODES.TOOL_DENIED]: "工具请求违反本地安全策略。",
-  [import_shared6.ERROR_CODES.TOOL_INPUT_INVALID]: "工具请求无效。",
-  [import_shared6.ERROR_CODES.TOOL_ARGUMENTS_INVALID]: "工具参数无效。",
-  [import_shared6.ERROR_CODES.TOOL_CALL_ID_CONFLICT]: "本轮工具 ID 冲突。",
-  [import_shared6.ERROR_CODES.TOOL_PATH_DENIED]: "模型请求了受保护或项目外路径。",
-  [import_shared6.ERROR_CODES.PATCH_REJECTED]: "补丁违反本地策略。",
-  [import_shared6.ERROR_CODES.VALIDATION_FAILED]: "必需检查失败，无法应用变更。",
-  [import_shared6.ERROR_CODES.APPLY_CONFLICT]: "Agent 触及文件已变化，未覆盖。",
-  [import_shared6.ERROR_CODES.INTERNAL_ERROR]: "Agent 失败，未暴露私有细节。"
+  [import_shared11.ERROR_CODES.INVALID_REQUEST]: "Agent 请求无效，已被拒绝。",
+  [import_shared11.ERROR_CODES.INVALID_TOKEN]: "本地 SpotPatch 会话已失效。",
+  [import_shared11.ERROR_CODES.ORIGIN_NOT_ALLOWED]: "当前页面来源未获授权。",
+  [import_shared11.ERROR_CODES.SOURCE_NOT_FOUND]: "选中目标对应的源码已不可用。",
+  [import_shared11.ERROR_CODES.SOURCE_OUTSIDE_ROOT]: "选中源码位于项目根目录之外。",
+  [import_shared11.ERROR_CODES.SOURCE_TOO_LARGE]: "选中源码超过安全大小限制。",
+  [import_shared11.ERROR_CODES.EDITOR_OPEN_FAILED]: "编辑器打开请求失败。",
+  [import_shared11.ERROR_CODES.DATA_FLOW_DISABLED]: "组件数据链路分析未启用。",
+  [import_shared11.ERROR_CODES.DATA_FLOW_SOURCE_STALE]: "选中源码已经变化，请重新选择组件。",
+  [import_shared11.ERROR_CODES.DATA_FLOW_ANALYSIS_CANCELLED]: "组件数据链路分析已取消。",
+  [import_shared11.ERROR_CODES.AI_DISABLED]: "Vite 配置未启用 AI 执行。",
+  [import_shared11.ERROR_CODES.PROVIDER_NOT_CONFIGURED]: "启动 Vite 的进程中缺少模型服务 Key 环境变量。",
+  [import_shared11.ERROR_CODES.PROVIDER_AUTH_FAILED]: "模型服务鉴权失败，请检查服务端 Key。",
+  [import_shared11.ERROR_CODES.PROVIDER_PROTOCOL_UNSUPPORTED]: "中转服务与配置的 OpenAI 兼容协议不一致。",
+  [import_shared11.ERROR_CODES.MODEL_NOT_ALLOWED]: "当前模型配置未获授权。",
+  [import_shared11.ERROR_CODES.MODEL_TOOL_CALL_UNSUPPORTED]: "当前模型未完成必要的工具调用或结果续接。",
+  [import_shared11.ERROR_CODES.PROVIDER_RATE_LIMITED]: "模型服务正在限流，请稍后重试。",
+  [import_shared11.ERROR_CODES.AGENT_BUSY]: "当前项目已有一个写入任务正在运行。",
+  [import_shared11.ERROR_CODES.AGENT_LIMIT_EXCEEDED]: "Agent 达到时间、轮次、输出或变更规模限制。",
+  [import_shared11.ERROR_CODES.AGENT_CANCELLED]: "Agent 任务已取消。",
+  [import_shared11.ERROR_CODES.EXTERNAL_HANDOFF_DISABLED]: EXTERNAL_HANDOFF_ERROR_ZH,
+  [import_shared11.ERROR_CODES.EXTERNAL_HANDOFF_UNAVAILABLE]: EXTERNAL_HANDOFF_ERROR_ZH,
+  [import_shared11.ERROR_CODES.HANDOFF_VALIDATION_FAILED]: EXTERNAL_HANDOFF_ERROR_ZH,
+  [import_shared11.ERROR_CODES.HANDOFF_SOURCE_STALE]: EXTERNAL_HANDOFF_ERROR_ZH,
+  [import_shared11.ERROR_CODES.HANDOFF_NOT_FOUND]: EXTERNAL_HANDOFF_ERROR_ZH,
+  [import_shared11.ERROR_CODES.HANDOFF_EXPIRED]: EXTERNAL_HANDOFF_ERROR_ZH,
+  [import_shared11.ERROR_CODES.HANDOFF_CURSOR_INVALID]: EXTERNAL_HANDOFF_ERROR_ZH,
+  [import_shared11.ERROR_CODES.HANDOFF_RESPONSE_TOO_LARGE]: EXTERNAL_HANDOFF_ERROR_ZH,
+  [import_shared11.ERROR_CODES.BRIDGE_UNAUTHORIZED]: EXTERNAL_HANDOFF_ERROR_ZH,
+  [import_shared11.ERROR_CODES.BRIDGE_PROTOCOL_MISMATCH]: EXTERNAL_HANDOFF_ERROR_ZH,
+  [import_shared11.ERROR_CODES.BRIDGE_BUSY]: EXTERNAL_HANDOFF_ERROR_ZH,
+  [import_shared11.ERROR_CODES.EXTERNAL_AGENT_BUSY]: EXTERNAL_HANDOFF_ERROR_ZH,
+  [import_shared11.ERROR_CODES.ACTIVE_ADAPTER_CONFLICT]: EXTERNAL_HANDOFF_ERROR_ZH,
+  [import_shared11.ERROR_CODES.ACTIVE_ADAPTER_LEASE_INVALID]: EXTERNAL_HANDOFF_ERROR_ZH,
+  [import_shared11.ERROR_CODES.ACTIVE_DISPATCH_INVALID]: EXTERNAL_HANDOFF_ERROR_ZH,
+  [import_shared11.ERROR_CODES.SESSION_NOT_FOUND]: EXTERNAL_HANDOFF_ERROR_ZH,
+  [import_shared11.ERROR_CODES.SESSION_AMBIGUOUS]: EXTERNAL_HANDOFF_ERROR_ZH,
+  [import_shared11.ERROR_CODES.SESSION_CLOSED]: EXTERNAL_HANDOFF_ERROR_ZH,
+  [import_shared11.ERROR_CODES.WORKTREE_DIRTY]: "运行 AI 前，请明确同意将当前本地修改纳入隔离基线。",
+  [import_shared11.ERROR_CODES.WORKTREE_NOT_REPOSITORY]: "Vite 根目录不是已初始化 Git 仓库的顶层目录。",
+  [import_shared11.ERROR_CODES.WORKTREE_OPERATION_IN_PROGRESS]: "请先完成当前 merge、rebase、cherry-pick 或 revert，再运行 AI。",
+  [import_shared11.ERROR_CODES.WORKTREE_CONFLICTED]: "请先解决全部 Git 冲突，再运行 AI。",
+  [import_shared11.ERROR_CODES.WORKTREE_LOCAL_CHANGES_TOO_LARGE]: "未跟踪文件超过安全数量或体积上限，请先精简。",
+  [import_shared11.ERROR_CODES.WORKTREE_UNTRACKED_UNSUPPORTED]: "未跟踪项已丢失、是符号链接或不是普通文件。",
+  [import_shared11.ERROR_CODES.WORKTREE_LOCAL_CHANGES_UNSUPPORTED]: "当前本地修改无法安全隔离。",
+  [import_shared11.ERROR_CODES.TOOL_DENIED]: "工具请求违反本地安全策略。",
+  [import_shared11.ERROR_CODES.TOOL_INPUT_INVALID]: "工具请求无效。",
+  [import_shared11.ERROR_CODES.TOOL_ARGUMENTS_INVALID]: "工具参数无效。",
+  [import_shared11.ERROR_CODES.TOOL_CALL_ID_CONFLICT]: "本轮工具 ID 冲突。",
+  [import_shared11.ERROR_CODES.TOOL_PATH_DENIED]: "模型请求了受保护或项目外路径。",
+  [import_shared11.ERROR_CODES.PATCH_REJECTED]: "补丁违反本地策略。",
+  [import_shared11.ERROR_CODES.VALIDATION_FAILED]: "必需检查失败，无法应用变更。",
+  [import_shared11.ERROR_CODES.APPLY_CONFLICT]: "Agent 触及文件已变化，未覆盖。",
+  [import_shared11.ERROR_CODES.INTERNAL_ERROR]: "Agent 失败，未暴露私有细节。"
 });
 var SUMMARY_MESSAGES_EN = Object.freeze({
+  instance: "Selected instance",
+  instanceStates: {
+    captured: "Captured element; locator describes selection time",
+    changed: "Page content changed; snapshot preserved. Select again to confirm the current instance",
+    detached: "Element unloaded; historical snapshot preserved",
+    restored: "Restored snapshot; not bound to the current page"
+  },
   adapter: "React adapter",
   api: "API",
   apiStatuses: Object.freeze({
@@ -2900,6 +2998,13 @@ var SUMMARY_MESSAGES_EN = Object.freeze({
   warning: "Warning"
 });
 var SUMMARY_MESSAGES_ZH = Object.freeze({
+  instance: "选中实例",
+  instanceStates: {
+    captured: "已捕获元素；定位信息对应选择时刻",
+    changed: "页面内容已变化，已保留快照；请重新选择以确认当前实例",
+    detached: "元素已卸载，已保留历史快照",
+    restored: "已恢复历史快照，未绑定当前页面"
+  },
   adapter: "React 适配器",
   api: "API",
   apiStatuses: Object.freeze({
@@ -3084,13 +3189,13 @@ var UI_MESSAGES = Object.freeze({
       addCancelled: "Additional selection cancelled.",
       selectionLimit: (maximum) => `The selection limit of ${String(maximum)} elements has been reached.`,
       chooseAdditional: (selected, maximum) => `Choose another element. ${String(selected)} of ${String(maximum)} selected.`,
-      duplicate: "That source target is already selected.",
+      duplicate: "That page element is already selected.",
+      instanceBudgetExceeded: "The prompt cannot preserve every selected instance within its budget. Remove some targets or increase the context budget.",
       sourceProbable: "A probable React component was found without an authorized file token.",
       sourceMissing: "No authorized source marker was found for the selected element.",
       noSelectable: "No selectable element was found.",
       allTargetsRemoved: "All targets were removed. Choose an element to continue.",
       targetRemoved: "Selected target removed.",
-      detachedTargetPreserved: "The page element was unloaded; its collected context remains selected.",
       contextWarning: "Browser context collection completed with a warning.",
       contextCollected: "Browser context collected.",
       editorOpening: "Opening source…",
@@ -3248,13 +3353,13 @@ var UI_MESSAGES = Object.freeze({
       addCancelled: "已取消追加选择。",
       selectionLimit: (maximum) => `已达到 ${String(maximum)} 个元素的选择上限。`,
       chooseAdditional: (selected, maximum) => `请选择另一个元素，当前已选 ${String(selected)} / ${String(maximum)}。`,
-      duplicate: "该源码目标已经在当前选择中。",
+      duplicate: "该页面元素已经在当前选择中。",
+      instanceBudgetExceeded: "上下文预算无法完整保留所有选中实例，请减少目标数量或提高上下文预算。",
       sourceProbable: "找到可能的 React 组件，但没有获授权的源码标记。",
       sourceMissing: "选中元素没有获授权的源码标记。",
       noSelectable: "当前位置没有可选择的元素。",
       allTargetsRemoved: "已移除全部目标，请重新选择元素。",
       targetRemoved: "已移除选中目标。",
-      detachedTargetPreserved: "页面元素已卸载，已采集的上下文仍保留在选择中。",
       contextWarning: "浏览器上下文采集完成，但存在警告。",
       contextCollected: "浏览器上下文采集完成。",
       editorOpening: "正在打开源码……",
@@ -4574,7 +4679,7 @@ function createRuntimeView(document, shortcut, ai = Object.freeze({ enabled: fal
   headerControls.className = "spotpatch-header-controls";
   const repositoryLink = createMarkedElement(document, "a");
   repositoryLink.className = "spotpatch-repository";
-  repositoryLink.href = import_shared7.SPOTPATCH_REPOSITORY_URL;
+  repositoryLink.href = import_shared12.SPOTPATCH_REPOSITORY_URL;
   repositoryLink.target = "_blank";
   repositoryLink.rel = "noopener noreferrer";
   const localeButton = createButton(document, "", "spotpatch-locale");
@@ -5086,6 +5191,9 @@ function createRuntimeView(document, shortcut, ai = Object.freeze({ enabled: fal
     requestFloatingSurfaceLayout();
   }
   function statusText(target2) {
+    if (target2.instanceState !== void 0 && target2.instanceState !== "captured") {
+      return messages.summary.instanceStates[target2.instanceState];
+    }
     if (target2.status === "ready") {
       return messages.targets.statusReady;
     }
@@ -5128,14 +5236,14 @@ function createRuntimeView(document, shortcut, ai = Object.freeze({ enabled: fal
       completeCount,
       targets.length
     );
-    const instructionLimitExceeded = instructionCharacters > import_shared7.MAX_ANNOTATION_INSTRUCTION_CHARACTERS;
+    const instructionLimitExceeded = instructionCharacters > import_shared12.MAX_ANNOTATION_INSTRUCTION_CHARACTERS;
     targetBudget.dataset.state = instructionLimitExceeded ? "over" : "ready";
     targetBudget.textContent = instructionLimitExceeded ? messages.targets.instructionBudgetExceeded(
       instructionCharacters,
-      import_shared7.MAX_ANNOTATION_INSTRUCTION_CHARACTERS
+      import_shared12.MAX_ANNOTATION_INSTRUCTION_CHARACTERS
     ) : messages.targets.instructionBudget(
       instructionCharacters,
-      import_shared7.MAX_ANNOTATION_INSTRUCTION_CHARACTERS
+      import_shared12.MAX_ANNOTATION_INSTRUCTION_CHARACTERS
     );
     addTargetButton.disabled = !editingEnabled || targets.length >= maximum;
     addTargetButton.title = targets.length >= maximum ? messages.targets.limitTitle(maximum) : messages.targets.addTitle;
@@ -5195,12 +5303,12 @@ function createRuntimeView(document, shortcut, ai = Object.freeze({ enabled: fal
         characterCount.className = "spotpatch-target-editor-count";
         characterCount.textContent = messages.targets.instructionCount(
           target2.instruction.length,
-          import_shared7.MAX_TARGET_INSTRUCTION_CHARACTERS
+          import_shared12.MAX_TARGET_INSTRUCTION_CHARACTERS
         );
         editorHead.append(editorLabel, characterCount);
         const input = createMarkedElement(document, "textarea");
         input.rows = 4;
-        input.maxLength = import_shared7.MAX_TARGET_INSTRUCTION_CHARACTERS;
+        input.maxLength = import_shared12.MAX_TARGET_INSTRUCTION_CHARACTERS;
         input.value = target2.instruction;
         input.placeholder = messages.targets.instructionPlaceholder;
         input.disabled = !editingEnabled;
@@ -5243,7 +5351,7 @@ function createRuntimeView(document, shortcut, ai = Object.freeze({ enabled: fal
     if (count !== null) {
       count.textContent = messages.targets.instructionCount(
         instruction.length,
-        import_shared7.MAX_TARGET_INSTRUCTION_CHARACTERS
+        import_shared12.MAX_TARGET_INSTRUCTION_CHARACTERS
       );
     }
     const completeCount = currentTargets.filter(
@@ -5258,14 +5366,14 @@ function createRuntimeView(document, shortcut, ai = Object.freeze({ enabled: fal
       (total, target2) => total + target2.instruction.trim().length,
       0
     );
-    const instructionLimitExceeded = instructionCharacters > import_shared7.MAX_ANNOTATION_INSTRUCTION_CHARACTERS;
+    const instructionLimitExceeded = instructionCharacters > import_shared12.MAX_ANNOTATION_INSTRUCTION_CHARACTERS;
     targetBudget.dataset.state = instructionLimitExceeded ? "over" : "ready";
     targetBudget.textContent = instructionLimitExceeded ? messages.targets.instructionBudgetExceeded(
       instructionCharacters,
-      import_shared7.MAX_ANNOTATION_INSTRUCTION_CHARACTERS
+      import_shared12.MAX_ANNOTATION_INSTRUCTION_CHARACTERS
     ) : messages.targets.instructionBudget(
       instructionCharacters,
-      import_shared7.MAX_ANNOTATION_INSTRUCTION_CHARACTERS
+      import_shared12.MAX_ANNOTATION_INSTRUCTION_CHARACTERS
     );
   }
   function showSelectionHighlights(targets) {
@@ -5386,7 +5494,7 @@ function createRuntimeView(document, shortcut, ai = Object.freeze({ enabled: fal
       targetBudget.dataset.state = "ready";
       targetBudget.textContent = messages.targets.instructionBudget(
         0,
-        import_shared7.MAX_ANNOTATION_INSTRUCTION_CHARACTERS
+        import_shared12.MAX_ANNOTATION_INSTRUCTION_CHARACTERS
       );
       targetLabel.textContent = messages.context.selectedElement;
     }
@@ -5726,6 +5834,11 @@ function createSelectionSummary(input, messages) {
     `${messages.confidence}: ${input.resolution.source.confidence} (${messages.confidenceLabels[input.resolution.source.confidence]})`,
     `${messages.origin}: ${input.resolution.source.origin}`
   ];
+  if (input.instance !== void 0) {
+    lines.push(
+      `${messages.instance}: ${messages.instanceStates[input.instance.state]}`
+    );
+  }
   if (input.resolution.react.componentName !== void 0) {
     lines.push(`${messages.component}: ${input.resolution.react.componentName}`);
   }
@@ -5759,7 +5872,7 @@ function createSelectionSummary(input, messages) {
 }
 
 // src/controller/agent-workflow.ts
-var import_shared8 = require("@spotpatch/shared");
+var import_shared13 = require("@spotpatch/shared");
 function capabilityKey(providerProfileId, modelProfileId) {
   return `${providerProfileId}:${modelProfileId}`;
 }
@@ -5797,7 +5910,7 @@ function activityFromEvent(event) {
   return void 0;
 }
 function createAgentWorkflow(options) {
-  const errorCode = (error) => runtimeApiErrorCode(error) ?? import_shared8.ERROR_CODES.INTERNAL_ERROR;
+  const errorCode = (error) => runtimeApiErrorCode(error) ?? import_shared13.ERROR_CODES.INTERNAL_ERROR;
   const errorMessage = (error) => options.view.messages().errors[errorCode(error)];
   const capabilities = /* @__PURE__ */ new Map();
   const providerConsents = /* @__PURE__ */ new Set();
@@ -5883,7 +5996,7 @@ function createAgentWorkflow(options) {
     }
     if (capability.state !== "agent-ready") {
       throw new RuntimeApiError(
-        capability.errorCode ?? import_shared8.ERROR_CODES.MODEL_TOOL_CALL_UNSUPPORTED
+        capability.errorCode ?? import_shared13.ERROR_CODES.MODEL_TOOL_CALL_UNSUPPORTED
       );
     }
     capabilities.set(key, capability);
@@ -6077,11 +6190,11 @@ function createAgentWorkflow(options) {
         }
         if (health.state === "blocked") {
           throw new RuntimeApiError(
-            health.errorCode ?? import_shared8.ERROR_CODES.WORKTREE_LOCAL_CHANGES_UNSUPPORTED
+            health.errorCode ?? import_shared13.ERROR_CODES.WORKTREE_LOCAL_CHANGES_UNSUPPORTED
           );
         }
         if (health.state === "consent-required" && !options.view.agentWorkspaceConsentGranted()) {
-          throw new RuntimeApiError(import_shared8.ERROR_CODES.WORKTREE_DIRTY);
+          throw new RuntimeApiError(import_shared13.ERROR_CODES.WORKTREE_DIRTY);
         }
         const created = await options.api.createAgentJob({
           annotation,
@@ -6182,7 +6295,7 @@ function sourceLabel(target2, unavailable) {
   return `${path}${line === void 0 ? "" : `:${String(line)}`}${column === void 0 ? "" : `:${String(column)}`}`;
 }
 function targetStatus(target2) {
-  if (target2.apiStatus === "failed" || target2.collectionStatus === "failed") {
+  if (target2.apiStatus === "failed" || target2.collectionStatus === "failed" || target2.elementContext?.instance !== void 0 && target2.elementContext.instance.state !== "captured") {
     return "warning";
   }
   if (target2.apiStatus === "loading" || target2.collectionStatus === "loading") {
@@ -6225,6 +6338,7 @@ function createController(config, dependencies = {}) {
   const now = dependencies.now ?? (() => (/* @__PURE__ */ new Date()).toISOString());
   const selectionSession = dependencies.selectionSession ?? createSelectionSession(browser.window, config.sessionId, config.maxTargets);
   const restoredSelection = selectionSession.load();
+  const instanceNamespace = createBrowserAnnotationId(browser.window);
   const sourceResolver = createSourceResolver({
     adapter: dependencies.reactAdapter ?? (0, import_react_adapter.createReact18Adapter)({
       ...config.dataFlow.enabled ? {
@@ -6256,7 +6370,8 @@ function createController(config, dependencies = {}) {
       dataFlowReport: void 0,
       dataFlowStatus: "idle",
       element: void 0,
-      elementContext: target2.element,
+      instanceScope: void 0,
+      elementContext: withInstanceState(target2.element, "restored"),
       instruction: target2.instruction,
       marker,
       page: target2.page,
@@ -6290,14 +6405,14 @@ function createController(config, dependencies = {}) {
     const react2 = target2.resolution.react;
     if (react2.componentSourceId !== void 0 && react2.sourceVersion !== void 0) {
       return Object.freeze({
-        schemaVersion: import_shared9.DATA_FLOW_SCHEMA_VERSION,
+        schemaVersion: import_shared14.DATA_FLOW_SCHEMA_VERSION,
         componentSourceId: react2.componentSourceId,
         sourceVersion: react2.sourceVersion
       });
     }
     const marker = target2.marker;
     return marker === void 0 ? void 0 : Object.freeze({
-      schemaVersion: import_shared9.DATA_FLOW_SCHEMA_VERSION,
+      schemaVersion: import_shared14.DATA_FLOW_SCHEMA_VERSION,
       fileId: marker.fileId,
       line: marker.line,
       column: marker.column
@@ -6345,7 +6460,7 @@ function createController(config, dependencies = {}) {
     const [componentResult, pageResult] = await Promise.allSettled([
       currentRequest === void 0 ? Promise.resolve(void 0) : api.componentDataFlowReport(currentRequest),
       pageTargets.length === 0 ? Promise.resolve(void 0) : api.pageDataFlowReport({
-        schemaVersion: import_shared9.DATA_FLOW_SCHEMA_VERSION,
+        schemaVersion: import_shared14.DATA_FLOW_SCHEMA_VERSION,
         targets: pageTargets
       })
     ]);
@@ -6410,11 +6525,12 @@ function createController(config, dependencies = {}) {
       (total, target2) => total + target2.instruction.trim().length,
       0
     );
-    return targets.length > 0 && instructionCharacters <= import_shared9.MAX_ANNOTATION_INSTRUCTION_CHARACTERS && targets.every(
+    return targets.length > 0 && instructionCharacters <= import_shared14.MAX_ANNOTATION_INSTRUCTION_CHARACTERS && targets.every(
       (target2) => target2.instruction.trim().length > 0 && target2.elementContext !== void 0 && target2.styles !== void 0 && target2.apiStatus !== "loading"
     );
   }
   function selectedAskSelection() {
+    refreshInstanceStates(mutationObserver?.takeRecords() ?? []);
     const snapshots = targets.flatMap((target2) => {
       const snapshot = snapshotTarget(target2);
       return snapshot === void 0 ? [] : [snapshot];
@@ -6433,6 +6549,7 @@ function createController(config, dependencies = {}) {
       const summary = createSelectionSummary(
         {
           resolution: target2.resolution,
+          ...target2.elementContext?.instance === void 0 ? {} : { instance: target2.elementContext.instance },
           ...target2.code === void 0 ? {} : { code: target2.code },
           ...target2.styles === void 0 ? {} : { styles: target2.styles },
           apiStatus: target2.apiStatus,
@@ -6478,7 +6595,11 @@ ${summary}`;
     view.renderTargets(
       targets.map((target2) => ({
         id: target2.id,
-        label: target2.resolution.react.componentName ?? (target2.element === void 0 ? target2.elementContext?.tagName ?? "Element" : elementLabel(target2.element)),
+        ...target2.elementContext?.instance === void 0 ? {} : { instanceState: target2.elementContext.instance.state },
+        label: [
+          target2.resolution.react.componentName ?? target2.elementContext?.tagName ?? "Element",
+          (target2.elementContext?.instance?.label ?? target2.elementContext?.textPreview)?.slice(0, 80)
+        ].filter(Boolean).join(" · "),
         source: sourceLabel(target2, view.messages().context.sourceUnavailable),
         canOpenEditor: target2.marker !== void 0,
         status: targetStatus(target2),
@@ -6498,6 +6619,7 @@ ${summary}`;
     }
   }
   function selectedAnnotation() {
+    refreshInstanceStates(mutationObserver?.takeRecords() ?? []);
     if (!canPreview()) {
       return void 0;
     }
@@ -6650,6 +6772,9 @@ ${summary}`;
     resizeObserver?.disconnect();
     for (const target2 of targets) {
       target2.element = void 0;
+      target2.instanceScope = void 0;
+      if (target2.elementContext !== void 0)
+        target2.elementContext = withInstanceState(target2.elementContext, "detached");
     }
     view.hideHighlight();
     view.hideSelectionHighlights();
@@ -6737,17 +6862,11 @@ ${summary}`;
       if (!targetIsCurrent(target2, revision)) {
         return;
       }
-      let failed = false;
-      try {
-        target2.elementContext = collectElementContext({
-          element: element2,
-          maxCharacters: config.budget.domCharacters
-        });
-      } catch {
-        target2.elementContext = void 0;
-        failed = true;
-      }
+      refreshInstanceStates(mutationObserver?.takeRecords() ?? []);
+      let failed = target2.elementContext === void 0;
       try {
+        if (target2.element !== element2)
+          throw new Error("Selected instance changed before style collection.");
         target2.styles = collectStyleContext({
           document: browser.document,
           element: element2,
@@ -6771,18 +6890,11 @@ ${summary}`;
     }, 0);
     collectionTimers.set(target2.id, timer);
   }
-  function duplicateTarget(element2, marker) {
-    if (marker !== void 0) {
-      return targets.find(
-        (target2) => target2.marker?.fileId === marker.fileId && target2.marker.line === marker.line && target2.marker.column === marker.column
-      );
-    }
-    return targets.find((target2) => target2.element === element2);
-  }
   function selectElement(element2) {
+    refreshInstanceStates(mutationObserver?.takeRecords() ?? []);
     const resolution = sourceResolver.resolve(element2);
     const marker = sourceRefToMarker(resolution.source);
-    const duplicate = duplicateTarget(element2, marker);
+    const duplicate = targets.find((target3) => target3.element === element2);
     if (duplicate !== void 0) {
       activeTargetId = duplicate.id;
       addingTarget = false;
@@ -6814,6 +6926,7 @@ ${summary}`;
     const target2 = {
       id: `target-${String(targetSequence)}`,
       element: element2,
+      instanceScope: void 0,
       resolution,
       marker,
       page: collectPageContext(browser.document, browser.window),
@@ -6826,6 +6939,17 @@ ${summary}`;
       dataFlowReport: void 0,
       dataFlowStatus: "idle"
     };
+    try {
+      const capture = captureSelectedInstance(
+        element2,
+        `${instanceNamespace}_${target2.id}`,
+        config.budget.domCharacters
+      );
+      target2.elementContext = capture.context;
+      target2.instanceScope = capture.scope;
+    } catch {
+      target2.collectionStatus = "failed";
+    }
     targets.push(target2);
     if (!initialSelection) {
       contextualAskWorkflow?.selectionChanged();
@@ -6956,25 +7080,32 @@ ${summary}`;
     persistSelection();
     view.announce(view.messages().announcements.targetRemoved);
   }
-  function refreshSelectedGeometry() {
-    if (state.status === "idle" || targets.length === 0) {
-      return;
+  function refreshInstanceStates(records) {
+    let changed = false;
+    for (const target2 of targets) {
+      if (target2.element === void 0) continue;
+      const next = target2.page.url !== browser.window.location.href ? "changed" : changedInstanceState(
+        target2.element,
+        target2.instanceScope ?? target2.element,
+        records
+      );
+      if (next === void 0) continue;
+      resizeObserver?.unobserve(target2.element);
+      target2.element = void 0;
+      target2.instanceScope = void 0;
+      if (target2.elementContext !== void 0)
+        target2.elementContext = withInstanceState(target2.elementContext, next);
+      changed = true;
     }
-    const disconnected = targets.filter(
-      (target2) => target2.element !== void 0 && !target2.element.isConnected
-    );
-    if (disconnected.length > 0) {
-      for (const target2 of disconnected) {
-        if (target2.element !== void 0) {
-          resizeObserver?.unobserve(target2.element);
-          target2.element = void 0;
-        }
-      }
+    if (changed) {
       refreshSelectionView();
       persistSelection();
-      view.announce(view.messages().announcements.detachedTargetPreserved);
-      return;
+      contextualAskWorkflow?.selectionChanged();
     }
+  }
+  function refreshSelectedGeometry() {
+    if (state.status === "idle" || targets.length === 0) return;
+    refreshInstanceStates(mutationObserver?.takeRecords() ?? []);
     refreshHighlights();
   }
   function handleOpenEditor(targetId) {
@@ -7028,6 +7159,15 @@ ${summary}`;
       agentWorkflow.run();
     }
   }
+  function composeSelectionPrompt(annotation) {
+    try {
+      return promptComposer.compose(annotation);
+    } catch (error) {
+      if (!(error instanceof RangeError)) throw error;
+      view.announce(view.messages().announcements.instanceBudgetExceeded);
+      return void 0;
+    }
+  }
   function handlePreview() {
     if (state.status !== "selected") {
       return;
@@ -7037,7 +7177,9 @@ ${summary}`;
       view.announce(view.messages().announcements.completeInstructions);
       return;
     }
-    previewPrompt = promptComposer.compose(annotation);
+    const composed = composeSelectionPrompt(annotation);
+    if (composed === void 0) return;
+    previewPrompt = composed;
     transition({ type: "PREVIEW" });
     view.showPreview(previewPrompt);
     view.focusPrompt();
@@ -7046,6 +7188,12 @@ ${summary}`;
     if (state.status !== "previewing" || previewPrompt.length === 0) {
       return;
     }
+    const annotation = selectedAnnotation();
+    if (annotation === void 0) return;
+    const composed = composeSelectionPrompt(annotation);
+    if (composed === void 0) return;
+    previewPrompt = composed;
+    view.showPreview(previewPrompt);
     if (clipboard === void 0) {
       transition({ type: "COPY_FAILURE" });
       view.focusPrompt();
@@ -7082,8 +7230,11 @@ ${summary}`;
     if (state.status === "previewing") {
       const annotation = selectedAnnotation();
       if (annotation !== void 0) {
-        previewPrompt = promptComposer.compose(annotation);
-        view.showPreview(previewPrompt);
+        const composed = composeSelectionPrompt(annotation);
+        if (composed !== void 0) {
+          previewPrompt = composed;
+          view.showPreview(previewPrompt);
+        }
       }
     }
   }
@@ -7137,6 +7288,8 @@ ${summary}`;
     browser.document.addEventListener("keydown", handleKeydown, true);
     browser.window.addEventListener("scroll", refreshSelectedGeometry, true);
     browser.window.addEventListener("resize", refreshSelectedGeometry);
+    browser.window.addEventListener("popstate", refreshSelectedGeometry);
+    browser.window.addEventListener("hashchange", refreshSelectedGeometry);
     view.triggerButton.addEventListener("click", activate);
     view.addTargetButton.addEventListener("click", beginAddTarget);
     view.reselectButton.addEventListener("click", handleReselect);
@@ -7173,10 +7326,15 @@ ${summary}`;
       resizeObserver = new browser.resizeObserver(refreshSelectedGeometry);
     }
     if (browser.mutationObserver !== void 0) {
-      mutationObserver = new browser.mutationObserver(refreshSelectedGeometry);
+      mutationObserver = new browser.mutationObserver((records) => {
+        refreshInstanceStates(records);
+        refreshHighlights();
+      });
       mutationObserver.observe(browser.document.documentElement, {
         childList: true,
-        subtree: true
+        subtree: true,
+        attributes: true,
+        characterData: true
       });
     }
     if (selectionOpen && targets.length > 0) {
@@ -7211,6 +7369,8 @@ ${summary}`;
     browser.document.removeEventListener("keydown", handleKeydown, true);
     browser.window.removeEventListener("scroll", refreshSelectedGeometry, true);
     browser.window.removeEventListener("resize", refreshSelectedGeometry);
+    browser.window.removeEventListener("popstate", refreshSelectedGeometry);
+    browser.window.removeEventListener("hashchange", refreshSelectedGeometry);
     view.triggerButton.removeEventListener("click", activate);
     view.addTargetButton.removeEventListener("click", beginAddTarget);
     view.reselectButton.removeEventListener("click", handleReselect);
@@ -7696,7 +7856,7 @@ function getDataFlowRuntime(target2 = globalThis) {
 }
 
 // src/data-flow/report-merger.ts
-var import_shared10 = require("@spotpatch/shared");
+var import_shared15 = require("@spotpatch/shared");
 function observationMatchesDependency(observation, dependency) {
   const origin = dependency.origin;
   const transportMatches = dependency.kind === "rpc" ? observation.transport === "trpc" && dependency.operation !== void 0 && observation.operation === dependency.operation : dependency.kind === "http" ? observation.transport === "fetch" || observation.transport === "xhr" : false;
@@ -7766,7 +7926,7 @@ function mergeComponentDataFlowReport(report, observations) {
     (observation) => observation.componentSourceId === void 0 || owners.has(observation.componentSourceId)
   );
   const merged = mergeDependencies(report.dependencies, componentObservations);
-  return (0, import_shared10.limitDataFlowReportCollections)(
+  return (0, import_shared15.limitDataFlowReportCollections)(
     Object.freeze({
       ...report,
       dependencies: merged.dependencies,
@@ -7795,7 +7955,7 @@ function unassignedDependency(observation) {
         (path) => Object.freeze({
           path,
           position: "query",
-          sensitive: (0, import_shared10.isSensitiveName)(path),
+          sensitive: (0, import_shared15.isSensitiveName)(path),
           valueState: "not-collected",
           evidenceIds: Object.freeze([observation.id])
         })
@@ -7817,7 +7977,7 @@ function mergePageDataFlowReport(report, observations) {
   const merged = mergeDependencies(report.dependencies, currentObservations);
   const unassigned = currentObservations.filter(({ id }) => !merged.matchedObservationIds.has(id)).map(unassignedDependency);
   const allObservationIds = new Set(currentObservations.map(({ id }) => id));
-  return (0, import_shared10.limitDataFlowReportCollections)(
+  return (0, import_shared15.limitDataFlowReportCollections)(
     Object.freeze({
       ...report,
       dependencies: Object.freeze([...merged.dependencies, ...unassigned]),