@spotpatch/shared 1.15.0 → 1.16.0

package/dist/{annotation-Cz-NNgR4.d.cts → annotation-eo_ltNRm.d.cts}

@@ -15,6 +15,28 @@ interface CodeContext {
     readonly boundary: "component" | "nearby-lines";
 }
 
+/** Capture evidence is framework-neutral and never grants source access. */
+declare const ELEMENT_INSTANCE_LIMITS: Readonly<{
+    idCharacters: 128;
+    contextCharacters: 1200;
+    labelCharacters: 160;
+    selectorCharacters: 2048;
+    ancestorDepth: 8;
+    locatorDepth: 32;
+}>;
+declare const ELEMENT_INSTANCE_STATES: readonly ["captured", "changed", "detached", "restored"];
+declare const ELEMENT_INSTANCE_HINT_ATTRIBUTE = "data-spotpatch-instance";
+interface ElementInstanceContext {
+    /** Opaque capture identity, not a framework key or a business record ID. */
+    readonly id: string;
+    readonly state: (typeof ELEMENT_INSTANCE_STATES)[number];
+    readonly selectorStatus: "unique-at-capture" | "unavailable";
+    readonly label: string;
+    /** Sanitized nearby DOM scope; it is not a proven component boundary. */
+    readonly context: string;
+}
+declare const 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.";
+
 type SourceConfidence = "exact" | "probable" | "approximate" | "unknown";
 type SourceOrigin = "jsx-host" | "astro-host" | "react-fiber" | "dom-ancestor" | "none";
 interface SourceRef {
@@ -58,6 +80,7 @@ interface PageContext {
     readonly devicePixelRatio: number;
 }
 interface ElementContext {
+    readonly instance?: ElementInstanceContext;
     readonly tagName: string;
     readonly selector: string;
     readonly sanitizedHtml: string;
@@ -99,4 +122,4 @@ interface SpotAnnotation {
     readonly createdAt: string;
 }
 
-export { type ContextBudget as C, type ElementContext as E, MAX_ANNOTATION_INSTRUCTION_CHARACTERS as M, type PageContext as P, type ReactContext as R, type SpotAnnotation as S, type SpotPatchLocale as a, SPOTPATCH_LOCALE_PREFERENCES as b, type CodeContext as c, MAX_ANNOTATION_TARGETS as d, MAX_TARGET_INSTRUCTION_CHARACTERS as e, type MatchedStyleRule as f, SPOTPATCH_LOCALES as g, type SourceConfidence as h, type SourceOrigin as i, type SourceRef as j, type SpotPatchLocalePreference as k, type SpotTargetContext as l, type StyleContext as m };
+export { type ContextBudget as C, ELEMENT_INSTANCE_HINT_ATTRIBUTE as E, INSTANCE_SELECTION_INSTRUCTIONS as I, MAX_ANNOTATION_INSTRUCTION_CHARACTERS as M, type PageContext as P, type ReactContext as R, type SpotAnnotation as S, type SpotPatchLocale as a, SPOTPATCH_LOCALE_PREFERENCES as b, type CodeContext as c, ELEMENT_INSTANCE_LIMITS as d, ELEMENT_INSTANCE_STATES as e, type ElementContext as f, type ElementInstanceContext as g, MAX_ANNOTATION_TARGETS as h, MAX_TARGET_INSTRUCTION_CHARACTERS as i, type MatchedStyleRule as j, SPOTPATCH_LOCALES as k, type SourceConfidence as l, type SourceOrigin as m, type SourceRef as n, type SpotPatchLocalePreference as o, type SpotTargetContext as p, type StyleContext as q };

package/dist/{annotation-Cz-NNgR4.d.ts → annotation-eo_ltNRm.d.ts}

@@ -15,6 +15,28 @@ interface CodeContext {
     readonly boundary: "component" | "nearby-lines";
 }
 
+/** Capture evidence is framework-neutral and never grants source access. */
+declare const ELEMENT_INSTANCE_LIMITS: Readonly<{
+    idCharacters: 128;
+    contextCharacters: 1200;
+    labelCharacters: 160;
+    selectorCharacters: 2048;
+    ancestorDepth: 8;
+    locatorDepth: 32;
+}>;
+declare const ELEMENT_INSTANCE_STATES: readonly ["captured", "changed", "detached", "restored"];
+declare const ELEMENT_INSTANCE_HINT_ATTRIBUTE = "data-spotpatch-instance";
+interface ElementInstanceContext {
+    /** Opaque capture identity, not a framework key or a business record ID. */
+    readonly id: string;
+    readonly state: (typeof ELEMENT_INSTANCE_STATES)[number];
+    readonly selectorStatus: "unique-at-capture" | "unavailable";
+    readonly label: string;
+    /** Sanitized nearby DOM scope; it is not a proven component boundary. */
+    readonly context: string;
+}
+declare const 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.";
+
 type SourceConfidence = "exact" | "probable" | "approximate" | "unknown";
 type SourceOrigin = "jsx-host" | "astro-host" | "react-fiber" | "dom-ancestor" | "none";
 interface SourceRef {
@@ -58,6 +80,7 @@ interface PageContext {
     readonly devicePixelRatio: number;
 }
 interface ElementContext {
+    readonly instance?: ElementInstanceContext;
     readonly tagName: string;
     readonly selector: string;
     readonly sanitizedHtml: string;
@@ -99,4 +122,4 @@ interface SpotAnnotation {
     readonly createdAt: string;
 }
 
-export { type ContextBudget as C, type ElementContext as E, MAX_ANNOTATION_INSTRUCTION_CHARACTERS as M, type PageContext as P, type ReactContext as R, type SpotAnnotation as S, type SpotPatchLocale as a, SPOTPATCH_LOCALE_PREFERENCES as b, type CodeContext as c, MAX_ANNOTATION_TARGETS as d, MAX_TARGET_INSTRUCTION_CHARACTERS as e, type MatchedStyleRule as f, SPOTPATCH_LOCALES as g, type SourceConfidence as h, type SourceOrigin as i, type SourceRef as j, type SpotPatchLocalePreference as k, type SpotTargetContext as l, type StyleContext as m };
+export { type ContextBudget as C, ELEMENT_INSTANCE_HINT_ATTRIBUTE as E, INSTANCE_SELECTION_INSTRUCTIONS as I, MAX_ANNOTATION_INSTRUCTION_CHARACTERS as M, type PageContext as P, type ReactContext as R, type SpotAnnotation as S, type SpotPatchLocale as a, SPOTPATCH_LOCALE_PREFERENCES as b, type CodeContext as c, ELEMENT_INSTANCE_LIMITS as d, ELEMENT_INSTANCE_STATES as e, type ElementContext as f, type ElementInstanceContext as g, MAX_ANNOTATION_TARGETS as h, MAX_TARGET_INSTRUCTION_CHARACTERS as i, type MatchedStyleRule as j, SPOTPATCH_LOCALES as k, type SourceConfidence as l, type SourceOrigin as m, type SourceRef as n, type SpotPatchLocalePreference as o, type SpotTargetContext as p, type StyleContext as q };

package/dist/{chunk-JTZFOTPT.js → chunk-7777QFBJ.js}

@@ -1,7 +1,7 @@
 import {
   MAX_ANNOTATION_TARGETS,
   spotAnnotationSchema
-} from "./chunk-R6QJFNT2.js";
+} from "./chunk-FCY5V76A.js";
 import {
   EXTERNAL_HANDOFF_ACTIVE_ADAPTER_KINDS,
   EXTERNAL_HANDOFF_ACTIVE_ADAPTER_STATES,
@@ -263,4 +263,4 @@ export {
   externalHandoffStatusResultSchema,
   SpotPatchError
 };
-//# sourceMappingURL=chunk-JTZFOTPT.js.map
+//# sourceMappingURL=chunk-7777QFBJ.js.map

package/dist/{chunk-R3BQKCCY.js → chunk-D7R32NFF.js}

@@ -17,7 +17,7 @@ import {
   SPOTPATCH_LOCALES,
   pageContextSchema,
   spotTargetContextSchema
-} from "./chunk-R6QJFNT2.js";
+} from "./chunk-FCY5V76A.js";
 
 // src/model/contextual-ask.ts
 import { z } from "zod";
@@ -584,4 +584,4 @@ export {
   askJobResultResponseSchema,
   askJobEventSchema
 };
-//# sourceMappingURL=chunk-R3BQKCCY.js.map
+//# sourceMappingURL=chunk-D7R32NFF.js.map

package/dist/{chunk-R6QJFNT2.js → chunk-FCY5V76A.js}

@@ -1,3 +1,21 @@
+// 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/annotation.ts
 var MAX_ANNOTATION_TARGETS = 20;
 var MAX_TARGET_INSTRUCTION_CHARACTERS = 2e3;
@@ -11,6 +29,13 @@ var SPOTPATCH_LOCALE_PREFERENCES = Object.freeze([
 // src/model/context-schema.ts
 import { z } from "zod";
 var boundedString = (maximum) => z.string().max(maximum);
+var elementInstanceContextSchema = z.strictObject({
+  id: z.string().min(1).max(ELEMENT_INSTANCE_LIMITS.idCharacters).regex(/^[A-Za-z0-9_-]+$/u),
+  state: z.enum(ELEMENT_INSTANCE_STATES),
+  selectorStatus: z.enum(["unique-at-capture", "unavailable"]),
+  label: boundedString(ELEMENT_INSTANCE_LIMITS.labelCharacters),
+  context: boundedString(ELEMENT_INSTANCE_LIMITS.contextCharacters)
+});
 var sourceRefSchema = z.strictObject({
   fileId: boundedString(128).optional(),
   relativePath: boundedString(1024).optional(),
@@ -55,6 +80,7 @@ var spotTargetContextSchema = z.strictObject({
     source: sourceRefSchema.optional()
   }),
   element: z.strictObject({
+    instance: elementInstanceContextSchema.optional(),
     tagName: boundedString(128),
     selector: boundedString(2048),
     sanitizedHtml: boundedString(8192),
@@ -179,6 +205,10 @@ function isErrorCode(value) {
 }
 
 export {
+  ELEMENT_INSTANCE_LIMITS,
+  ELEMENT_INSTANCE_STATES,
+  ELEMENT_INSTANCE_HINT_ATTRIBUTE,
+  INSTANCE_SELECTION_INSTRUCTIONS,
   MAX_ANNOTATION_TARGETS,
   MAX_TARGET_INSTRUCTION_CHARACTERS,
   MAX_ANNOTATION_INSTRUCTION_CHARACTERS,
@@ -192,4 +222,4 @@ export {
   ERROR_CODE_VALUES,
   isErrorCode
 };
-//# sourceMappingURL=chunk-R6QJFNT2.js.map
+//# sourceMappingURL=chunk-FCY5V76A.js.map

package/dist/chunk-FCY5V76A.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/model/element-instance.ts","../src/model/annotation.ts","../src/model/context-schema.ts","../src/errors/error-code.ts"],"sourcesContent":["/** Capture evidence is framework-neutral and never grants source access. */\nexport const ELEMENT_INSTANCE_LIMITS = Object.freeze({\n  idCharacters: 128,\n  contextCharacters: 1_200,\n  labelCharacters: 160,\n  selectorCharacters: 2_048,\n  ancestorDepth: 8,\n  locatorDepth: 32,\n});\n\nexport const ELEMENT_INSTANCE_STATES = [\n  \"captured\",\n  \"changed\",\n  \"detached\",\n  \"restored\",\n] as const;\n\nexport const ELEMENT_INSTANCE_HINT_ATTRIBUTE = \"data-spotpatch-instance\";\n\nexport interface ElementInstanceContext {\n  /** Opaque capture identity, not a framework key or a business record ID. */\n  readonly id: string;\n  readonly state: (typeof ELEMENT_INSTANCE_STATES)[number];\n  readonly selectorStatus: \"unique-at-capture\" | \"unavailable\";\n  readonly label: string;\n  /** Sanitized nearby DOM scope; it is not a proven component boundary. */\n  readonly context: string;\n}\n\nexport const INSTANCE_SELECTION_INSTRUCTIONS =\n  \"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.\";\n","import type { CodeContext } from \"./code-context.js\";\nimport type { ElementInstanceContext } from \"./element-instance.js\";\nimport type { ReactContext, SourceRef } from \"./source-ref.js\";\nimport type { StyleContext } from \"./style-context.js\";\n\nexport interface PageContext {\n  readonly url: string;\n  readonly pathname: string;\n  readonly title: string;\n  readonly viewportWidth: number;\n  readonly viewportHeight: number;\n  readonly devicePixelRatio: number;\n}\n\nexport interface ElementContext {\n  readonly instance?: ElementInstanceContext;\n  readonly tagName: string;\n  readonly selector: string;\n  readonly sanitizedHtml: string;\n  readonly textPreview?: string;\n  readonly role?: string;\n  readonly rect: Readonly<{\n    x: number;\n    y: number;\n    width: number;\n    height: number;\n  }>;\n}\n\n/** Protocol hard limit. Runtime configuration may choose a smaller limit. */\nexport const MAX_ANNOTATION_TARGETS = 20;\n\n/** Each target owns its requested change; the UI enforces the same bound. */\nexport const MAX_TARGET_INSTRUCTION_CHARACTERS = 2_000;\n\n/** Keeps the complete, atomic user intent within the prompt and request budgets. */\nexport const MAX_ANNOTATION_INSTRUCTION_CHARACTERS = 4_000;\n\nexport const SPOTPATCH_LOCALES = Object.freeze([\"en-US\", \"zh-CN\"] as const);\nexport type SpotPatchLocale = (typeof SPOTPATCH_LOCALES)[number];\nexport const SPOTPATCH_LOCALE_PREFERENCES = Object.freeze([\n  \"auto\",\n  ...SPOTPATCH_LOCALES,\n] as const);\nexport type SpotPatchLocalePreference = (typeof SPOTPATCH_LOCALE_PREFERENCES)[number];\n\nexport interface SpotTargetContext {\n  readonly instruction: string;\n  readonly page?: Readonly<PageContext>;\n  readonly source: SourceRef;\n  readonly react: ReactContext;\n  readonly element: ElementContext;\n  readonly styles: StyleContext;\n  readonly code?: CodeContext;\n  readonly warnings: readonly string[];\n}\n\nexport interface SpotAnnotation {\n  readonly schemaVersion: 3;\n  readonly id: string;\n  readonly locale: SpotPatchLocale;\n  readonly page: Readonly<PageContext>;\n  readonly targets: readonly SpotTargetContext[];\n  readonly createdAt: string;\n}\n","import { z } from \"zod\";\nimport {\n  ELEMENT_INSTANCE_LIMITS,\n  ELEMENT_INSTANCE_STATES,\n} from \"./element-instance.js\";\n\nimport {\n  MAX_ANNOTATION_INSTRUCTION_CHARACTERS,\n  MAX_ANNOTATION_TARGETS,\n  MAX_TARGET_INSTRUCTION_CHARACTERS,\n  SPOTPATCH_LOCALES,\n} from \"./annotation.js\";\n\nconst boundedString = (maximum: number): z.ZodString => z.string().max(maximum);\n\nexport const elementInstanceContextSchema = z.strictObject({\n  id: z\n    .string()\n    .min(1)\n    .max(ELEMENT_INSTANCE_LIMITS.idCharacters)\n    .regex(/^[A-Za-z0-9_-]+$/u),\n  state: z.enum(ELEMENT_INSTANCE_STATES),\n  selectorStatus: z.enum([\"unique-at-capture\", \"unavailable\"]),\n  label: boundedString(ELEMENT_INSTANCE_LIMITS.labelCharacters),\n  context: boundedString(ELEMENT_INSTANCE_LIMITS.contextCharacters),\n});\n\nexport const sourceRefSchema = z.strictObject({\n  fileId: boundedString(128).optional(),\n  relativePath: boundedString(1_024).optional(),\n  line: z.number().int().positive().optional(),\n  column: z.number().int().positive().optional(),\n  origin: z.enum([\"jsx-host\", \"astro-host\", \"react-fiber\", \"dom-ancestor\", \"none\"]),\n  confidence: z.enum([\"exact\", \"probable\", \"approximate\", \"unknown\"]),\n});\n\nexport const matchedStyleRuleSchema = z.strictObject({\n  selector: boundedString(2_048),\n  declarations: boundedString(8_192),\n  source: boundedString(1_024).optional(),\n  media: boundedString(1_024).optional(),\n});\n\nexport const codeContextSchema = z.strictObject({\n  relativePath: boundedString(1_024),\n  language: z.enum([\"tsx\", \"jsx\", \"astro\"]),\n  startLine: z.number().int().positive(),\n  endLine: z.number().int().positive(),\n  excerpt: boundedString(16_000),\n  boundary: z.enum([\"component\", \"nearby-lines\"]),\n});\n\nexport const pageContextSchema = z.strictObject({\n  url: boundedString(2_048),\n  pathname: boundedString(2_048),\n  title: boundedString(1_024),\n  viewportWidth: z.number().nonnegative(),\n  viewportHeight: z.number().nonnegative(),\n  devicePixelRatio: z.number().positive(),\n});\n\nexport const spotTargetContextSchema = z.strictObject({\n  instruction: z.string().trim().min(1).max(MAX_TARGET_INSTRUCTION_CHARACTERS),\n  page: pageContextSchema.optional(),\n  source: sourceRefSchema,\n  react: z.strictObject({\n    supported: z.boolean(),\n    version: boundedString(64).optional(),\n    componentName: boundedString(256).optional(),\n    componentSourceId: boundedString(128).optional(),\n    sourceVersion: boundedString(128).optional(),\n    componentStack: z.array(boundedString(256)).max(64),\n    source: sourceRefSchema.optional(),\n  }),\n  element: z.strictObject({\n    instance: elementInstanceContextSchema.optional(),\n    tagName: boundedString(128),\n    selector: boundedString(2_048),\n    sanitizedHtml: boundedString(8_192),\n    textPreview: boundedString(2_048).optional(),\n    role: boundedString(256).optional(),\n    rect: z.strictObject({\n      x: z.number(),\n      y: z.number(),\n      width: z.number().nonnegative(),\n      height: z.number().nonnegative(),\n    }),\n  }),\n  styles: z.strictObject({\n    classNames: z.array(boundedString(512)).max(256),\n    inlineStyle: boundedString(8_192).optional(),\n    matchedRules: z.array(matchedStyleRuleSchema).max(256),\n    computed: z.record(boundedString(256), boundedString(2_048)),\n    warnings: z.array(boundedString(1_024)).max(64),\n  }),\n  code: codeContextSchema.optional(),\n  warnings: z.array(boundedString(1_024)).max(64),\n});\n\nexport const spotAnnotationSchema = z\n  .strictObject({\n    schemaVersion: z.literal(3),\n    id: boundedString(128),\n    locale: z.enum(SPOTPATCH_LOCALES),\n    page: pageContextSchema,\n    targets: z.array(spotTargetContextSchema).min(1).max(MAX_ANNOTATION_TARGETS),\n    createdAt: z.iso.datetime(),\n  })\n  .superRefine((annotation, context) => {\n    const total = annotation.targets.reduce(\n      (characters, target) => characters + target.instruction.length,\n      0,\n    );\n    if (total > MAX_ANNOTATION_INSTRUCTION_CHARACTERS) {\n      context.addIssue({\n        code: \"custom\",\n        message: \"Combined target instructions exceed the annotation limit.\",\n        path: [\"targets\"],\n      });\n    }\n  });\n","export const ERROR_CODES = {\n  INVALID_REQUEST: \"INVALID_REQUEST\",\n  INVALID_TOKEN: \"INVALID_TOKEN\",\n  ORIGIN_NOT_ALLOWED: \"ORIGIN_NOT_ALLOWED\",\n  SOURCE_NOT_FOUND: \"SOURCE_NOT_FOUND\",\n  SOURCE_OUTSIDE_ROOT: \"SOURCE_OUTSIDE_ROOT\",\n  SOURCE_TOO_LARGE: \"SOURCE_TOO_LARGE\",\n  EDITOR_OPEN_FAILED: \"EDITOR_OPEN_FAILED\",\n  DATA_FLOW_DISABLED: \"DATA_FLOW_DISABLED\",\n  DATA_FLOW_SOURCE_STALE: \"DATA_FLOW_SOURCE_STALE\",\n  DATA_FLOW_ANALYSIS_CANCELLED: \"DATA_FLOW_ANALYSIS_CANCELLED\",\n  AI_DISABLED: \"AI_DISABLED\",\n  PROVIDER_NOT_CONFIGURED: \"PROVIDER_NOT_CONFIGURED\",\n  PROVIDER_AUTH_FAILED: \"PROVIDER_AUTH_FAILED\",\n  PROVIDER_PROTOCOL_UNSUPPORTED: \"PROVIDER_PROTOCOL_UNSUPPORTED\",\n  MODEL_NOT_ALLOWED: \"MODEL_NOT_ALLOWED\",\n  MODEL_TOOL_CALL_UNSUPPORTED: \"MODEL_TOOL_CALL_UNSUPPORTED\",\n  PROVIDER_RATE_LIMITED: \"PROVIDER_RATE_LIMITED\",\n  AGENT_BUSY: \"AGENT_BUSY\",\n  AGENT_LIMIT_EXCEEDED: \"AGENT_LIMIT_EXCEEDED\",\n  AGENT_CANCELLED: \"AGENT_CANCELLED\",\n  EXTERNAL_HANDOFF_DISABLED: \"EXTERNAL_HANDOFF_DISABLED\",\n  EXTERNAL_HANDOFF_UNAVAILABLE: \"EXTERNAL_HANDOFF_UNAVAILABLE\",\n  HANDOFF_VALIDATION_FAILED: \"HANDOFF_VALIDATION_FAILED\",\n  HANDOFF_SOURCE_STALE: \"HANDOFF_SOURCE_STALE\",\n  HANDOFF_NOT_FOUND: \"HANDOFF_NOT_FOUND\",\n  HANDOFF_EXPIRED: \"HANDOFF_EXPIRED\",\n  HANDOFF_CURSOR_INVALID: \"HANDOFF_CURSOR_INVALID\",\n  HANDOFF_RESPONSE_TOO_LARGE: \"HANDOFF_RESPONSE_TOO_LARGE\",\n  BRIDGE_UNAUTHORIZED: \"BRIDGE_UNAUTHORIZED\",\n  BRIDGE_PROTOCOL_MISMATCH: \"BRIDGE_PROTOCOL_MISMATCH\",\n  BRIDGE_BUSY: \"BRIDGE_BUSY\",\n  EXTERNAL_AGENT_BUSY: \"EXTERNAL_AGENT_BUSY\",\n  ACTIVE_ADAPTER_CONFLICT: \"ACTIVE_ADAPTER_CONFLICT\",\n  ACTIVE_ADAPTER_LEASE_INVALID: \"ACTIVE_ADAPTER_LEASE_INVALID\",\n  ACTIVE_DISPATCH_INVALID: \"ACTIVE_DISPATCH_INVALID\",\n  SESSION_NOT_FOUND: \"SESSION_NOT_FOUND\",\n  SESSION_AMBIGUOUS: \"SESSION_AMBIGUOUS\",\n  SESSION_CLOSED: \"SESSION_CLOSED\",\n  WORKTREE_DIRTY: \"WORKTREE_DIRTY\",\n  WORKTREE_NOT_REPOSITORY: \"WORKTREE_NOT_REPOSITORY\",\n  WORKTREE_OPERATION_IN_PROGRESS: \"WORKTREE_OPERATION_IN_PROGRESS\",\n  WORKTREE_CONFLICTED: \"WORKTREE_CONFLICTED\",\n  WORKTREE_LOCAL_CHANGES_TOO_LARGE: \"WORKTREE_LOCAL_CHANGES_TOO_LARGE\",\n  WORKTREE_UNTRACKED_UNSUPPORTED: \"WORKTREE_UNTRACKED_UNSUPPORTED\",\n  WORKTREE_LOCAL_CHANGES_UNSUPPORTED: \"WORKTREE_LOCAL_CHANGES_UNSUPPORTED\",\n  TOOL_DENIED: \"TOOL_DENIED\",\n  TOOL_INPUT_INVALID: \"TOOL_INPUT_INVALID\",\n  TOOL_ARGUMENTS_INVALID: \"TOOL_ARGUMENTS_INVALID\",\n  TOOL_CALL_ID_CONFLICT: \"TOOL_CALL_ID_CONFLICT\",\n  TOOL_PATH_DENIED: \"TOOL_PATH_DENIED\",\n  PATCH_REJECTED: \"PATCH_REJECTED\",\n  VALIDATION_FAILED: \"VALIDATION_FAILED\",\n  APPLY_CONFLICT: \"APPLY_CONFLICT\",\n  INTERNAL_ERROR: \"INTERNAL_ERROR\",\n} as const;\n\nexport const CONTEXTUAL_ASK_ERROR_CODES = Object.freeze([\n  \"ASK_DISABLED\",\n  \"ASK_SELECTION_REQUIRED\",\n  \"ASK_SELECTION_STALE\",\n  \"ASK_QUESTION_INVALID\",\n  \"ASK_EXECUTOR_UNAVAILABLE\",\n  \"ASK_TIMEOUT\",\n  \"ASK_CONSENT_REQUIRED\",\n  \"ASK_BUSY\",\n  \"ASK_IDEMPOTENCY_CONFLICT\",\n  \"ASK_SOURCE_SCOPE_DENIED\",\n  \"ASK_LIMIT_EXCEEDED\",\n  \"ASK_ANSWER_INVALID\",\n  \"ASK_WRITE_ATTEMPTED\",\n  \"ASK_CANCELLED\",\n  \"ASK_RESULT_EXPIRED\",\n  \"ASK_PROTOCOL_INCOMPATIBLE\",\n] as const);\n\nexport type ContextualAskErrorCode = (typeof CONTEXTUAL_ASK_ERROR_CODES)[number];\n\nexport type ErrorCode = (typeof ERROR_CODES)[keyof typeof ERROR_CODES];\n\nexport const ERROR_CODE_VALUES = Object.freeze(Object.values(ERROR_CODES));\n\nexport function isErrorCode(value: unknown): value is ErrorCode {\n  return (\n    typeof value === \"string\" &&\n    (ERROR_CODE_VALUES as readonly string[]).includes(value)\n  );\n}\n"],"mappings":"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","names":[]}

package/dist/{contextual-ask-BbmHG3Z8.d.cts → contextual-ask-Dz3Mh9LR.d.cts}

@@ -121,6 +121,21 @@ declare const spotSelectionTargetSchema: z.ZodObject<{
         }, z.core.$strict>>;
     }, z.core.$strict>;
     element: z.ZodObject<{
+        instance: z.ZodOptional<z.ZodObject<{
+            id: z.ZodString;
+            state: z.ZodEnum<{
+                captured: "captured";
+                changed: "changed";
+                detached: "detached";
+                restored: "restored";
+            }>;
+            selectorStatus: z.ZodEnum<{
+                unavailable: "unavailable";
+                "unique-at-capture": "unique-at-capture";
+            }>;
+            label: z.ZodString;
+            context: z.ZodString;
+        }, z.core.$strict>>;
         tagName: z.ZodString;
         selector: z.ZodString;
         sanitizedHtml: z.ZodString;
@@ -226,6 +241,21 @@ declare const spotSelectionContextSchema: z.ZodObject<{
             }, z.core.$strict>>;
         }, z.core.$strict>;
         element: z.ZodObject<{
+            instance: z.ZodOptional<z.ZodObject<{
+                id: z.ZodString;
+                state: z.ZodEnum<{
+                    captured: "captured";
+                    changed: "changed";
+                    detached: "detached";
+                    restored: "restored";
+                }>;
+                selectorStatus: z.ZodEnum<{
+                    unavailable: "unavailable";
+                    "unique-at-capture": "unique-at-capture";
+                }>;
+                label: z.ZodString;
+                context: z.ZodString;
+            }, z.core.$strict>>;
             tagName: z.ZodString;
             selector: z.ZodString;
             sanitizedHtml: z.ZodString;
@@ -347,6 +377,21 @@ declare const spotAskTaskEnvelopeSchema: z.ZodObject<{
                 }, z.core.$strict>>;
             }, z.core.$strict>;
             element: z.ZodObject<{
+                instance: z.ZodOptional<z.ZodObject<{
+                    id: z.ZodString;
+                    state: z.ZodEnum<{
+                        captured: "captured";
+                        changed: "changed";
+                        detached: "detached";
+                        restored: "restored";
+                    }>;
+                    selectorStatus: z.ZodEnum<{
+                        unavailable: "unavailable";
+                        "unique-at-capture": "unique-at-capture";
+                    }>;
+                    label: z.ZodString;
+                    context: z.ZodString;
+                }, z.core.$strict>>;
                 tagName: z.ZodString;
                 selector: z.ZodString;
                 sanitizedHtml: z.ZodString;
@@ -473,6 +518,21 @@ declare const spotChangeTaskEnvelopeSchema: z.ZodObject<{
                 }, z.core.$strict>>;
             }, z.core.$strict>;
             element: z.ZodObject<{
+                instance: z.ZodOptional<z.ZodObject<{
+                    id: z.ZodString;
+                    state: z.ZodEnum<{
+                        captured: "captured";
+                        changed: "changed";
+                        detached: "detached";
+                        restored: "restored";
+                    }>;
+                    selectorStatus: z.ZodEnum<{
+                        unavailable: "unavailable";
+                        "unique-at-capture": "unique-at-capture";
+                    }>;
+                    label: z.ZodString;
+                    context: z.ZodString;
+                }, z.core.$strict>>;
                 tagName: z.ZodString;
                 selector: z.ZodString;
                 sanitizedHtml: z.ZodString;
@@ -589,6 +649,21 @@ declare const spotTaskEnvelopeSchema: z.ZodUnion<readonly [z.ZodObject<{
                 }, z.core.$strict>>;
             }, z.core.$strict>;
             element: z.ZodObject<{
+                instance: z.ZodOptional<z.ZodObject<{
+                    id: z.ZodString;
+                    state: z.ZodEnum<{
+                        captured: "captured";
+                        changed: "changed";
+                        detached: "detached";
+                        restored: "restored";
+                    }>;
+                    selectorStatus: z.ZodEnum<{
+                        unavailable: "unavailable";
+                        "unique-at-capture": "unique-at-capture";
+                    }>;
+                    label: z.ZodString;
+                    context: z.ZodString;
+                }, z.core.$strict>>;
                 tagName: z.ZodString;
                 selector: z.ZodString;
                 sanitizedHtml: z.ZodString;
@@ -714,6 +789,21 @@ declare const spotTaskEnvelopeSchema: z.ZodUnion<readonly [z.ZodObject<{
                 }, z.core.$strict>>;
             }, z.core.$strict>;
             element: z.ZodObject<{
+                instance: z.ZodOptional<z.ZodObject<{
+                    id: z.ZodString;
+                    state: z.ZodEnum<{
+                        captured: "captured";
+                        changed: "changed";
+                        detached: "detached";
+                        restored: "restored";
+                    }>;
+                    selectorStatus: z.ZodEnum<{
+                        unavailable: "unavailable";
+                        "unique-at-capture": "unique-at-capture";
+                    }>;
+                    label: z.ZodString;
+                    context: z.ZodString;
+                }, z.core.$strict>>;
                 tagName: z.ZodString;
                 selector: z.ZodString;
                 sanitizedHtml: z.ZodString;
@@ -1104,6 +1194,21 @@ declare const askJobCreateRequestSchema: z.ZodObject<{
                     }, z.core.$strict>>;
                 }, z.core.$strict>;
                 element: z.ZodObject<{
+                    instance: z.ZodOptional<z.ZodObject<{
+                        id: z.ZodString;
+                        state: z.ZodEnum<{
+                            captured: "captured";
+                            changed: "changed";
+                            detached: "detached";
+                            restored: "restored";
+                        }>;
+                        selectorStatus: z.ZodEnum<{
+                            unavailable: "unavailable";
+                            "unique-at-capture": "unique-at-capture";
+                        }>;
+                        label: z.ZodString;
+                        context: z.ZodString;
+                    }, z.core.$strict>>;
                     tagName: z.ZodString;
                     selector: z.ZodString;
                     sanitizedHtml: z.ZodString;

package/dist/{contextual-ask-BbmHG3Z8.d.ts → contextual-ask-Dz3Mh9LR.d.ts}

@@ -121,6 +121,21 @@ declare const spotSelectionTargetSchema: z.ZodObject<{
         }, z.core.$strict>>;
     }, z.core.$strict>;
     element: z.ZodObject<{
+        instance: z.ZodOptional<z.ZodObject<{
+            id: z.ZodString;
+            state: z.ZodEnum<{
+                captured: "captured";
+                changed: "changed";
+                detached: "detached";
+                restored: "restored";
+            }>;
+            selectorStatus: z.ZodEnum<{
+                unavailable: "unavailable";
+                "unique-at-capture": "unique-at-capture";
+            }>;
+            label: z.ZodString;
+            context: z.ZodString;
+        }, z.core.$strict>>;
         tagName: z.ZodString;
         selector: z.ZodString;
         sanitizedHtml: z.ZodString;
@@ -226,6 +241,21 @@ declare const spotSelectionContextSchema: z.ZodObject<{
             }, z.core.$strict>>;
         }, z.core.$strict>;
         element: z.ZodObject<{
+            instance: z.ZodOptional<z.ZodObject<{
+                id: z.ZodString;
+                state: z.ZodEnum<{
+                    captured: "captured";
+                    changed: "changed";
+                    detached: "detached";
+                    restored: "restored";
+                }>;
+                selectorStatus: z.ZodEnum<{
+                    unavailable: "unavailable";
+                    "unique-at-capture": "unique-at-capture";
+                }>;
+                label: z.ZodString;
+                context: z.ZodString;
+            }, z.core.$strict>>;
             tagName: z.ZodString;
             selector: z.ZodString;
             sanitizedHtml: z.ZodString;
@@ -347,6 +377,21 @@ declare const spotAskTaskEnvelopeSchema: z.ZodObject<{
                 }, z.core.$strict>>;
             }, z.core.$strict>;
             element: z.ZodObject<{
+                instance: z.ZodOptional<z.ZodObject<{
+                    id: z.ZodString;
+                    state: z.ZodEnum<{
+                        captured: "captured";
+                        changed: "changed";
+                        detached: "detached";
+                        restored: "restored";
+                    }>;
+                    selectorStatus: z.ZodEnum<{
+                        unavailable: "unavailable";
+                        "unique-at-capture": "unique-at-capture";
+                    }>;
+                    label: z.ZodString;
+                    context: z.ZodString;
+                }, z.core.$strict>>;
                 tagName: z.ZodString;
                 selector: z.ZodString;
                 sanitizedHtml: z.ZodString;
@@ -473,6 +518,21 @@ declare const spotChangeTaskEnvelopeSchema: z.ZodObject<{
                 }, z.core.$strict>>;
             }, z.core.$strict>;
             element: z.ZodObject<{
+                instance: z.ZodOptional<z.ZodObject<{
+                    id: z.ZodString;
+                    state: z.ZodEnum<{
+                        captured: "captured";
+                        changed: "changed";
+                        detached: "detached";
+                        restored: "restored";
+                    }>;
+                    selectorStatus: z.ZodEnum<{
+                        unavailable: "unavailable";
+                        "unique-at-capture": "unique-at-capture";
+                    }>;
+                    label: z.ZodString;
+                    context: z.ZodString;
+                }, z.core.$strict>>;
                 tagName: z.ZodString;
                 selector: z.ZodString;
                 sanitizedHtml: z.ZodString;
@@ -589,6 +649,21 @@ declare const spotTaskEnvelopeSchema: z.ZodUnion<readonly [z.ZodObject<{
                 }, z.core.$strict>>;
             }, z.core.$strict>;
             element: z.ZodObject<{
+                instance: z.ZodOptional<z.ZodObject<{
+                    id: z.ZodString;
+                    state: z.ZodEnum<{
+                        captured: "captured";
+                        changed: "changed";
+                        detached: "detached";
+                        restored: "restored";
+                    }>;
+                    selectorStatus: z.ZodEnum<{
+                        unavailable: "unavailable";
+                        "unique-at-capture": "unique-at-capture";
+                    }>;
+                    label: z.ZodString;
+                    context: z.ZodString;
+                }, z.core.$strict>>;
                 tagName: z.ZodString;
                 selector: z.ZodString;
                 sanitizedHtml: z.ZodString;
@@ -714,6 +789,21 @@ declare const spotTaskEnvelopeSchema: z.ZodUnion<readonly [z.ZodObject<{
                 }, z.core.$strict>>;
             }, z.core.$strict>;
             element: z.ZodObject<{
+                instance: z.ZodOptional<z.ZodObject<{
+                    id: z.ZodString;
+                    state: z.ZodEnum<{
+                        captured: "captured";
+                        changed: "changed";
+                        detached: "detached";
+                        restored: "restored";
+                    }>;
+                    selectorStatus: z.ZodEnum<{
+                        unavailable: "unavailable";
+                        "unique-at-capture": "unique-at-capture";
+                    }>;
+                    label: z.ZodString;
+                    context: z.ZodString;
+                }, z.core.$strict>>;
                 tagName: z.ZodString;
                 selector: z.ZodString;
                 sanitizedHtml: z.ZodString;
@@ -1104,6 +1194,21 @@ declare const askJobCreateRequestSchema: z.ZodObject<{
                     }, z.core.$strict>>;
                 }, z.core.$strict>;
                 element: z.ZodObject<{
+                    instance: z.ZodOptional<z.ZodObject<{
+                        id: z.ZodString;
+                        state: z.ZodEnum<{
+                            captured: "captured";
+                            changed: "changed";
+                            detached: "detached";
+                            restored: "restored";
+                        }>;
+                        selectorStatus: z.ZodEnum<{
+                            unavailable: "unavailable";
+                            "unique-at-capture": "unique-at-capture";
+                        }>;
+                        label: z.ZodString;
+                        context: z.ZodString;
+                    }, z.core.$strict>>;
                     tagName: z.ZodString;
                     selector: z.ZodString;
                     sanitizedHtml: z.ZodString;

package/dist/contextual-ask-browser.d.cts

@@ -1,4 +1,4 @@
-export { A as ASK_ANSWER_WARNING_CODES, a as ASK_EXECUTOR_ANSWER_WARNING_CODES, b as ASK_FILE_COUNT_BUCKETS, c as ASK_JOB_STATUSES, d as ASK_READ_ACTIVITY_STATES, e as ASK_SOURCE_CONFIDENCES, f as AskAnswerBlock, g as AskAnswerResult, h as AskAnswerWarning, i as AskAnswerWarningCode, j as AskDraftOrigin, k as AskExecutorAnswerWarningCode, l as AskFileCountBucket, m as AskJobActionRequest, n as AskJobCreateRequest, o as AskJobEvent, p as AskJobEventsRequest, q as AskJobResultResponse, r as AskJobSnapshot, s as AskJobStatus, t as AskReadActivityState, u as AskSourceConfidence, v as AskSourceReference, C as CONTEXTUAL_ASK_EXECUTOR_KINDS, w as CONTEXTUAL_ASK_EXECUTOR_STATES, x as CONTEXTUAL_ASK_LIMITS, y as CONTEXTUAL_ASK_SCHEMA_VERSION, z as ContextualAskCapability, B as ContextualAskCapabilityRequest, D as ContextualAskExecutorCapability, E as ContextualAskExecutorKind, F as ContextualAskExecutorState, S as SpotAskTaskEnvelope, G as SpotChangeTaskEnvelope, H as SpotSelectionContext, I as SpotSelectionTarget, J as SpotTaskEnvelope } from './contextual-ask-BbmHG3Z8.cjs';
+export { A as ASK_ANSWER_WARNING_CODES, a as ASK_EXECUTOR_ANSWER_WARNING_CODES, b as ASK_FILE_COUNT_BUCKETS, c as ASK_JOB_STATUSES, d as ASK_READ_ACTIVITY_STATES, e as ASK_SOURCE_CONFIDENCES, f as AskAnswerBlock, g as AskAnswerResult, h as AskAnswerWarning, i as AskAnswerWarningCode, j as AskDraftOrigin, k as AskExecutorAnswerWarningCode, l as AskFileCountBucket, m as AskJobActionRequest, n as AskJobCreateRequest, o as AskJobEvent, p as AskJobEventsRequest, q as AskJobResultResponse, r as AskJobSnapshot, s as AskJobStatus, t as AskReadActivityState, u as AskSourceConfidence, v as AskSourceReference, C as CONTEXTUAL_ASK_EXECUTOR_KINDS, w as CONTEXTUAL_ASK_EXECUTOR_STATES, x as CONTEXTUAL_ASK_LIMITS, y as CONTEXTUAL_ASK_SCHEMA_VERSION, z as ContextualAskCapability, B as ContextualAskCapabilityRequest, D as ContextualAskExecutorCapability, E as ContextualAskExecutorKind, F as ContextualAskExecutorState, S as SpotAskTaskEnvelope, G as SpotChangeTaskEnvelope, H as SpotSelectionContext, I as SpotSelectionTarget, J as SpotTaskEnvelope } from './contextual-ask-Dz3Mh9LR.cjs';
 export { A as AskJobAction, S as SPOTPATCH_ENDPOINTS, a as SPOTPATCH_TOKEN_HEADER, g as getAskJobEndpoint } from './endpoints-O3ohYyAo.cjs';
 import 'zod';
 

package/dist/contextual-ask-browser.d.ts

@@ -1,4 +1,4 @@
-export { A as ASK_ANSWER_WARNING_CODES, a as ASK_EXECUTOR_ANSWER_WARNING_CODES, b as ASK_FILE_COUNT_BUCKETS, c as ASK_JOB_STATUSES, d as ASK_READ_ACTIVITY_STATES, e as ASK_SOURCE_CONFIDENCES, f as AskAnswerBlock, g as AskAnswerResult, h as AskAnswerWarning, i as AskAnswerWarningCode, j as AskDraftOrigin, k as AskExecutorAnswerWarningCode, l as AskFileCountBucket, m as AskJobActionRequest, n as AskJobCreateRequest, o as AskJobEvent, p as AskJobEventsRequest, q as AskJobResultResponse, r as AskJobSnapshot, s as AskJobStatus, t as AskReadActivityState, u as AskSourceConfidence, v as AskSourceReference, C as CONTEXTUAL_ASK_EXECUTOR_KINDS, w as CONTEXTUAL_ASK_EXECUTOR_STATES, x as CONTEXTUAL_ASK_LIMITS, y as CONTEXTUAL_ASK_SCHEMA_VERSION, z as ContextualAskCapability, B as ContextualAskCapabilityRequest, D as ContextualAskExecutorCapability, E as ContextualAskExecutorKind, F as ContextualAskExecutorState, S as SpotAskTaskEnvelope, G as SpotChangeTaskEnvelope, H as SpotSelectionContext, I as SpotSelectionTarget, J as SpotTaskEnvelope } from './contextual-ask-BbmHG3Z8.js';
+export { A as ASK_ANSWER_WARNING_CODES, a as ASK_EXECUTOR_ANSWER_WARNING_CODES, b as ASK_FILE_COUNT_BUCKETS, c as ASK_JOB_STATUSES, d as ASK_READ_ACTIVITY_STATES, e as ASK_SOURCE_CONFIDENCES, f as AskAnswerBlock, g as AskAnswerResult, h as AskAnswerWarning, i as AskAnswerWarningCode, j as AskDraftOrigin, k as AskExecutorAnswerWarningCode, l as AskFileCountBucket, m as AskJobActionRequest, n as AskJobCreateRequest, o as AskJobEvent, p as AskJobEventsRequest, q as AskJobResultResponse, r as AskJobSnapshot, s as AskJobStatus, t as AskReadActivityState, u as AskSourceConfidence, v as AskSourceReference, C as CONTEXTUAL_ASK_EXECUTOR_KINDS, w as CONTEXTUAL_ASK_EXECUTOR_STATES, x as CONTEXTUAL_ASK_LIMITS, y as CONTEXTUAL_ASK_SCHEMA_VERSION, z as ContextualAskCapability, B as ContextualAskCapabilityRequest, D as ContextualAskExecutorCapability, E as ContextualAskExecutorKind, F as ContextualAskExecutorState, S as SpotAskTaskEnvelope, G as SpotChangeTaskEnvelope, H as SpotSelectionContext, I as SpotSelectionTarget, J as SpotTaskEnvelope } from './contextual-ask-Dz3Mh9LR.js';
 export { A as AskJobAction, S as SPOTPATCH_ENDPOINTS, a as SPOTPATCH_TOKEN_HEADER, g as getAskJobEndpoint } from './endpoints-O3ohYyAo.js';
 import 'zod';
 

package/dist/contextual-ask-node.cjs

@@ -66,6 +66,22 @@ module.exports = __toCommonJS(contextual_ask_node_exports);
 // src/model/context-schema.ts
 var import_zod = require("zod");
 
+// 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"
+];
+
 // src/model/annotation.ts
 var MAX_ANNOTATION_TARGETS = 20;
 var MAX_TARGET_INSTRUCTION_CHARACTERS = 2e3;
@@ -78,6 +94,13 @@ var SPOTPATCH_LOCALE_PREFERENCES = Object.freeze([
 
 // src/model/context-schema.ts
 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(),
@@ -122,6 +145,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),