@spotpatch/shared 1.14.3 → 1.16.0

package/dist/index.cjs

@@ -55,6 +55,9 @@ __export(index_exports, {
   DEFAULT_AGENT_LIMITS: () => DEFAULT_AGENT_LIMITS,
   DEFAULT_DATA_FLOW_LIMITS: () => DEFAULT_DATA_FLOW_LIMITS,
   DEFAULT_RUNTIME_DATA_FLOW_LIMITS: () => DEFAULT_RUNTIME_DATA_FLOW_LIMITS,
+  ELEMENT_INSTANCE_HINT_ATTRIBUTE: () => ELEMENT_INSTANCE_HINT_ATTRIBUTE,
+  ELEMENT_INSTANCE_LIMITS: () => ELEMENT_INSTANCE_LIMITS,
+  ELEMENT_INSTANCE_STATES: () => ELEMENT_INSTANCE_STATES,
   ERROR_CODES: () => ERROR_CODES,
   ERROR_CODE_VALUES: () => ERROR_CODE_VALUES,
   EXTERNAL_AGENT_ACTIONS: () => EXTERNAL_AGENT_ACTIONS,
@@ -82,6 +85,7 @@ __export(index_exports, {
   EXTERNAL_HANDOFF_REPORTABLE_DISPATCH_PHASES: () => EXTERNAL_HANDOFF_REPORTABLE_DISPATCH_PHASES,
   EXTERNAL_HANDOFF_SNAPSHOT_SCHEMA_VERSION: () => EXTERNAL_HANDOFF_SNAPSHOT_SCHEMA_VERSION,
   EXTERNAL_HANDOFF_STATES: () => EXTERNAL_HANDOFF_STATES,
+  INSTANCE_SELECTION_INSTRUCTIONS: () => INSTANCE_SELECTION_INSTRUCTIONS,
   MAX_ANNOTATION_INSTRUCTION_CHARACTERS: () => MAX_ANNOTATION_INSTRUCTION_CHARACTERS,
   MAX_ANNOTATION_TARGETS: () => MAX_ANNOTATION_TARGETS,
   MAX_TARGET_INSTRUCTION_CHARACTERS: () => MAX_TARGET_INSTRUCTION_CHARACTERS,
@@ -353,6 +357,24 @@ var SPOTPATCH_LOCALE_PREFERENCES = Object.freeze([
   ...SPOTPATCH_LOCALES
 ]);
 
+// src/model/element-instance.ts
+var ELEMENT_INSTANCE_LIMITS = Object.freeze({
+  idCharacters: 128,
+  contextCharacters: 1200,
+  labelCharacters: 160,
+  selectorCharacters: 2048,
+  ancestorDepth: 8,
+  locatorDepth: 32
+});
+var ELEMENT_INSTANCE_STATES = [
+  "captured",
+  "changed",
+  "detached",
+  "restored"
+];
+var ELEMENT_INSTANCE_HINT_ATTRIBUTE = "data-spotpatch-instance";
+var INSTANCE_SELECTION_INSTRUCTIONS = "Selected targets can be different rendered instances of the same source. Preserve each target and its instruction even when source locations match. Instance IDs identify captures, not business records. Selectors are capture-time evidence, never stable record IDs. Nearby DOM context is not a proven component boundary. Changed, detached, or restored instances are historical snapshots; verify their identity before changing code. Follow the requested scope: a selected instance does not by itself authorize changes to every instance or imply instance-only changes. For an instance-only request, establish the corresponding record/condition and check the shared component's impact; if evidence is insufficient, explain what is missing rather than guessing.";
+
 // src/model/contextual-ask.ts
 var import_zod2 = require("zod");
 
@@ -393,7 +415,8 @@ var CONTEXTUAL_ASK_LIMITS = Object.freeze({
 });
 var CONTEXTUAL_ASK_EXECUTOR_KINDS = Object.freeze([
   "configured-key",
-  "managed-codex"
+  "managed-codex",
+  "claude-code"
 ]);
 var CONTEXTUAL_ASK_EXECUTOR_STATES = Object.freeze([
   "ready",
@@ -435,6 +458,13 @@ var CONTEXTUAL_ASK_PERMISSION_PROFILE = "spotpatch-ask-readonly";
 // src/model/context-schema.ts
 var import_zod = require("zod");
 var boundedString = (maximum) => import_zod.z.string().max(maximum);
+var elementInstanceContextSchema = import_zod.z.strictObject({
+  id: import_zod.z.string().min(1).max(ELEMENT_INSTANCE_LIMITS.idCharacters).regex(/^[A-Za-z0-9_-]+$/u),
+  state: import_zod.z.enum(ELEMENT_INSTANCE_STATES),
+  selectorStatus: import_zod.z.enum(["unique-at-capture", "unavailable"]),
+  label: boundedString(ELEMENT_INSTANCE_LIMITS.labelCharacters),
+  context: boundedString(ELEMENT_INSTANCE_LIMITS.contextCharacters)
+});
 var sourceRefSchema = import_zod.z.strictObject({
   fileId: boundedString(128).optional(),
   relativePath: boundedString(1024).optional(),
@@ -479,6 +509,7 @@ var spotTargetContextSchema = import_zod.z.strictObject({
     source: sourceRefSchema.optional()
   }),
   element: import_zod.z.strictObject({
+    instance: elementInstanceContextSchema.optional(),
     tagName: boundedString(128),
     selector: boundedString(2048),
     sanitizedHtml: boundedString(8192),
@@ -541,7 +572,8 @@ var contextualAskExecutorPreferenceSchema = import_zod2.z.discriminatedUnion("ki
     providerProfileId: profileIdSchema,
     modelProfileId: profileIdSchema
   }),
-  import_zod2.z.strictObject({ kind: import_zod2.z.literal("managed-codex") })
+  import_zod2.z.strictObject({ kind: import_zod2.z.literal("managed-codex") }),
+  import_zod2.z.strictObject({ kind: import_zod2.z.literal("claude-code") })
 ]);
 var contextualAskOptionsSchema = import_zod2.z.union([
   import_zod2.z.boolean(),
@@ -2402,6 +2434,9 @@ var SPOTPATCH_REPOSITORY_URL = "https://github.com/huanglvjing/spotpatch";
   DEFAULT_AGENT_LIMITS,
   DEFAULT_DATA_FLOW_LIMITS,
   DEFAULT_RUNTIME_DATA_FLOW_LIMITS,
+  ELEMENT_INSTANCE_HINT_ATTRIBUTE,
+  ELEMENT_INSTANCE_LIMITS,
+  ELEMENT_INSTANCE_STATES,
   ERROR_CODES,
   ERROR_CODE_VALUES,
   EXTERNAL_AGENT_ACTIONS,
@@ -2429,6 +2464,7 @@ var SPOTPATCH_REPOSITORY_URL = "https://github.com/huanglvjing/spotpatch";
   EXTERNAL_HANDOFF_REPORTABLE_DISPATCH_PHASES,
   EXTERNAL_HANDOFF_SNAPSHOT_SCHEMA_VERSION,
   EXTERNAL_HANDOFF_STATES,
+  INSTANCE_SELECTION_INSTRUCTIONS,
   MAX_ANNOTATION_INSTRUCTION_CHARACTERS,
   MAX_ANNOTATION_TARGETS,
   MAX_TARGET_INSTRUCTION_CHARACTERS,