@spotpatch/shared 1.14.3 → 1.16.0

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

@@ -34,7 +34,7 @@ declare const CONTEXTUAL_ASK_LIMITS: Readonly<{
     readonly maximumModels: 800;
     readonly contentHashHexCharacters: 64;
 }>;
-declare const CONTEXTUAL_ASK_EXECUTOR_KINDS: readonly ["configured-key", "managed-codex"];
+declare const CONTEXTUAL_ASK_EXECUTOR_KINDS: readonly ["configured-key", "managed-codex", "claude-code"];
 type ContextualAskExecutorKind = (typeof CONTEXTUAL_ASK_EXECUTOR_KINDS)[number];
 declare const CONTEXTUAL_ASK_EXECUTOR_STATES: readonly ["ready", "degraded", "unavailable"];
 type ContextualAskExecutorState = (typeof CONTEXTUAL_ASK_EXECUTOR_STATES)[number];
@@ -59,6 +59,8 @@ declare const contextualAskExecutorPreferenceSchema: z.ZodDiscriminatedUnion<[z.
     modelProfileId: z.ZodString;
 }, z.core.$strict>, z.ZodObject<{
     kind: z.ZodLiteral<"managed-codex">;
+}, z.core.$strict>, z.ZodObject<{
+    kind: z.ZodLiteral<"claude-code">;
 }, z.core.$strict>], "kind">;
 declare const contextualAskOptionsSchema: z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
     defaultExecutor: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -67,6 +69,8 @@ declare const contextualAskOptionsSchema: z.ZodUnion<readonly [z.ZodBoolean, z.Z
         modelProfileId: z.ZodString;
     }, z.core.$strict>, z.ZodObject<{
         kind: z.ZodLiteral<"managed-codex">;
+    }, z.core.$strict>, z.ZodObject<{
+        kind: z.ZodLiteral<"claude-code">;
     }, z.core.$strict>], "kind">>;
 }, z.core.$strict>]>;
 declare const spotSelectionTargetSchema: z.ZodObject<{
@@ -117,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;
@@ -222,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;
@@ -343,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;
@@ -469,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;
@@ -585,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;
@@ -710,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;
@@ -883,6 +977,7 @@ declare const askAnswerResultSchema: z.ZodObject<{
         kind: z.ZodEnum<{
             "configured-key": "configured-key";
             "managed-codex": "managed-codex";
+            "claude-code": "claude-code";
         }>;
         label: z.ZodString;
         modelLabel: z.ZodString;
@@ -935,6 +1030,7 @@ declare const contextualAskExecutorCapabilitySchema: z.ZodObject<{
     kind: z.ZodEnum<{
         "configured-key": "configured-key";
         "managed-codex": "managed-codex";
+        "claude-code": "claude-code";
     }>;
     label: z.ZodString;
     requestedModelLabel: z.ZodString;
@@ -974,6 +1070,7 @@ declare const contextualAskCapabilitySchema: z.ZodObject<{
         kind: z.ZodEnum<{
             "configured-key": "configured-key";
             "managed-codex": "managed-codex";
+            "claude-code": "claude-code";
         }>;
         label: z.ZodString;
         requestedModelLabel: z.ZodString;
@@ -1097,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;
@@ -1177,6 +1289,7 @@ declare const askJobSnapshotSchema: z.ZodObject<{
         kind: z.ZodEnum<{
             "configured-key": "configured-key";
             "managed-codex": "managed-codex";
+            "claude-code": "claude-code";
         }>;
         label: z.ZodString;
         modelLabel: z.ZodString;
@@ -1223,6 +1336,7 @@ declare const askJobResultResponseSchema: z.ZodObject<{
             kind: z.ZodEnum<{
                 "configured-key": "configured-key";
                 "managed-codex": "managed-codex";
+                "claude-code": "claude-code";
             }>;
             label: z.ZodString;
             modelLabel: z.ZodString;
@@ -1260,6 +1374,7 @@ declare const askJobResultResponseSchema: z.ZodObject<{
             kind: z.ZodEnum<{
                 "configured-key": "configured-key";
                 "managed-codex": "managed-codex";
+                "claude-code": "claude-code";
             }>;
             label: z.ZodString;
             modelLabel: z.ZodString;
@@ -1328,6 +1443,7 @@ declare const askJobEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             kind: z.ZodEnum<{
                 "configured-key": "configured-key";
                 "managed-codex": "managed-codex";
+                "claude-code": "claude-code";
             }>;
             label: z.ZodString;
             modelLabel: z.ZodString;

package/dist/contextual-ask-browser.cjs

@@ -75,7 +75,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",

package/dist/contextual-ask-browser.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/contextual-ask-browser.ts","../src/protocol/contextual-ask-constants.ts","../src/protocol/endpoints.ts"],"sourcesContent":["import type { ERROR_CODES as GLOBAL_ERROR_CODES } from \"./errors/error-code.js\";\nimport type { ContextualAskErrorCode } from \"./errors/error-code.js\";\n\nconst CONTEXTUAL_ASK_ERRORS = {\n  ASK_DISABLED: \"ASK_DISABLED\",\n  ASK_SELECTION_REQUIRED: \"ASK_SELECTION_REQUIRED\",\n  ASK_SELECTION_STALE: \"ASK_SELECTION_STALE\",\n  ASK_QUESTION_INVALID: \"ASK_QUESTION_INVALID\",\n  ASK_EXECUTOR_UNAVAILABLE: \"ASK_EXECUTOR_UNAVAILABLE\",\n  ASK_TIMEOUT: \"ASK_TIMEOUT\",\n  ASK_CONSENT_REQUIRED: \"ASK_CONSENT_REQUIRED\",\n  ASK_BUSY: \"ASK_BUSY\",\n  ASK_IDEMPOTENCY_CONFLICT: \"ASK_IDEMPOTENCY_CONFLICT\",\n  ASK_SOURCE_SCOPE_DENIED: \"ASK_SOURCE_SCOPE_DENIED\",\n  ASK_LIMIT_EXCEEDED: \"ASK_LIMIT_EXCEEDED\",\n  ASK_ANSWER_INVALID: \"ASK_ANSWER_INVALID\",\n  ASK_WRITE_ATTEMPTED: \"ASK_WRITE_ATTEMPTED\",\n  ASK_CANCELLED: \"ASK_CANCELLED\",\n  ASK_RESULT_EXPIRED: \"ASK_RESULT_EXPIRED\",\n  ASK_PROTOCOL_INCOMPATIBLE: \"ASK_PROTOCOL_INCOMPATIBLE\",\n} as const satisfies Record<ContextualAskErrorCode, ContextualAskErrorCode>;\n\n/** Browser-reachable Ask errors only; no provider details or Node failures. */\nexport const ERROR_CODES = Object.freeze({\n  INVALID_REQUEST: \"INVALID_REQUEST\",\n  INVALID_TOKEN: \"INVALID_TOKEN\",\n  ORIGIN_NOT_ALLOWED: \"ORIGIN_NOT_ALLOWED\",\n  ...CONTEXTUAL_ASK_ERRORS,\n  INTERNAL_ERROR: \"INTERNAL_ERROR\",\n} as const satisfies Pick<\n  typeof GLOBAL_ERROR_CODES,\n  \"INTERNAL_ERROR\" | \"INVALID_REQUEST\" | \"INVALID_TOKEN\" | \"ORIGIN_NOT_ALLOWED\"\n>);\nexport type ErrorCode = (typeof ERROR_CODES)[keyof typeof ERROR_CODES];\nconst ERROR_CODE_VALUES: readonly string[] = Object.values(ERROR_CODES);\n\nexport function isErrorCode(value: unknown): value is ErrorCode {\n  return typeof value === \"string\" && ERROR_CODE_VALUES.includes(value);\n}\n\nexport {\n  ASK_ANSWER_WARNING_CODES,\n  ASK_EXECUTOR_ANSWER_WARNING_CODES,\n  ASK_FILE_COUNT_BUCKETS,\n  ASK_JOB_STATUSES,\n  ASK_READ_ACTIVITY_STATES,\n  ASK_SOURCE_CONFIDENCES,\n  CONTEXTUAL_ASK_EXECUTOR_KINDS,\n  CONTEXTUAL_ASK_EXECUTOR_STATES,\n  CONTEXTUAL_ASK_LIMITS,\n  CONTEXTUAL_ASK_SCHEMA_VERSION,\n  type AskAnswerWarningCode,\n  type AskExecutorAnswerWarningCode,\n  type AskFileCountBucket,\n  type AskJobStatus,\n  type AskReadActivityState,\n  type AskSourceConfidence,\n  type ContextualAskExecutorKind,\n  type ContextualAskExecutorState,\n} from \"./protocol/contextual-ask-constants.js\";\nexport {\n  getAskJobEndpoint,\n  SPOTPATCH_ENDPOINTS,\n  SPOTPATCH_TOKEN_HEADER,\n  type AskJobAction,\n} from \"./protocol/endpoints.js\";\nexport type {\n  AskAnswerBlock,\n  AskAnswerResult,\n  AskAnswerWarning,\n  AskDraftOrigin,\n  AskSourceReference,\n  ContextualAskCapability,\n  ContextualAskExecutorCapability,\n  SpotAskTaskEnvelope,\n  SpotChangeTaskEnvelope,\n  SpotSelectionContext,\n  SpotSelectionTarget,\n  SpotTaskEnvelope,\n} from \"./model/contextual-ask.js\";\nexport type {\n  AskJobActionRequest,\n  AskJobCreateRequest,\n  AskJobEvent,\n  AskJobEventsRequest,\n  AskJobResultResponse,\n  AskJobSnapshot,\n  ContextualAskCapabilityRequest,\n} from \"./protocol/contextual-ask.js\";\n","export const CONTEXTUAL_ASK_SCHEMA_VERSION = 1 as const;\n\nexport const CONTEXTUAL_ASK_LIMITS = Object.freeze({\n  maximumTargets: 20,\n  maximumQuestionCharacters: 4_000,\n  maximumAnswerCharacters: 40_000,\n  maximumAnswerBlocks: 40,\n  maximumSources: 64,\n  maximumReadFiles: 32,\n  maximumReadBytesPerFile: 64 * 1_024,\n  maximumReadBytesTotal: 512 * 1_024,\n  maximumToolCalls: 48,\n  maximumModelTurns: 12,\n  jobTimeoutMs: 300_000,\n  resultTtlMs: 900_000,\n  maximumActiveJobsPerSession: 1,\n  maximumRetainedResultsPerSession: 1,\n  maximumRetainedEvents: 256,\n  maximumEventSubscribers: 4,\n  eventHeartbeatMs: 15_000,\n  maximumRequestBodyBytes: 256 * 1_024,\n  maximumSearchQueryCharacters: 256,\n  maximumSearchResults: 64,\n  maximumSearchPreviewCharacters: 500,\n  capabilityTimeoutMs: 30_000,\n  maximumIdCharacters: 128,\n  maximumProfileIdCharacters: 64,\n  maximumLabelCharacters: 256,\n  maximumRelativePathCharacters: 1_024,\n  maximumLanguageCharacters: 64,\n  maximumPhaseMessageCharacters: 1_024,\n  maximumExecutors: 32,\n  maximumModels: 800,\n  contentHashHexCharacters: 64,\n} as const);\n\nexport const CONTEXTUAL_ASK_EXECUTOR_KINDS = Object.freeze([\n  \"configured-key\",\n  \"managed-codex\",\n] as const);\nexport type ContextualAskExecutorKind = (typeof CONTEXTUAL_ASK_EXECUTOR_KINDS)[number];\n\nexport const CONTEXTUAL_ASK_EXECUTOR_STATES = Object.freeze([\n  \"ready\",\n  \"degraded\",\n  \"unavailable\",\n] as const);\nexport type ContextualAskExecutorState =\n  (typeof CONTEXTUAL_ASK_EXECUTOR_STATES)[number];\n\nexport const ASK_JOB_STATUSES = Object.freeze([\n  \"queued\",\n  \"authorizing\",\n  \"running\",\n  \"cancelling\",\n  \"answered\",\n  \"cancelled\",\n  \"failed\",\n] as const);\nexport type AskJobStatus = (typeof ASK_JOB_STATUSES)[number];\n\nexport const ASK_ANSWER_WARNING_CODES = Object.freeze([\n  \"insufficient-evidence\",\n  \"partial-context\",\n  \"source-truncated\",\n  \"source-stale\",\n] as const);\nexport type AskAnswerWarningCode = (typeof ASK_ANSWER_WARNING_CODES)[number];\n\n/** Warnings an executor may declare from its own evidence assessment. */\nexport const ASK_EXECUTOR_ANSWER_WARNING_CODES = Object.freeze([\n  \"insufficient-evidence\",\n  \"partial-context\",\n] as const satisfies readonly AskAnswerWarningCode[]);\nexport type AskExecutorAnswerWarningCode =\n  (typeof ASK_EXECUTOR_ANSWER_WARNING_CODES)[number];\n\nexport const ASK_READ_ACTIVITY_STATES = Object.freeze([\n  \"started\",\n  \"succeeded\",\n  \"failed\",\n] as const);\nexport type AskReadActivityState = (typeof ASK_READ_ACTIVITY_STATES)[number];\n\nexport const ASK_FILE_COUNT_BUCKETS = Object.freeze([\"one\", \"few\", \"many\"] as const);\nexport type AskFileCountBucket = (typeof ASK_FILE_COUNT_BUCKETS)[number];\n\nexport const ASK_SOURCE_CONFIDENCES = Object.freeze([\n  \"exact\",\n  \"probable\",\n  \"approximate\",\n] as const);\nexport type AskSourceConfidence = (typeof ASK_SOURCE_CONFIDENCES)[number];\n\nexport const CONTEXTUAL_ASK_PERMISSION_PROFILE = \"spotpatch-ask-readonly\" as const;\n","export const SPOTPATCH_API_BASE = \"/__spotpatch/v1\" as const;\nexport const SPOTPATCH_TOKEN_HEADER = \"X-SpotPatch-Token\" as const;\n\nexport const SPOTPATCH_ENDPOINTS = Object.freeze({\n  bootstrap: `${SPOTPATCH_API_BASE}/bootstrap`,\n  sourceContext: `${SPOTPATCH_API_BASE}/source-context`,\n  openEditor: `${SPOTPATCH_API_BASE}/open-editor`,\n  dataFlowComponentReport: `${SPOTPATCH_API_BASE}/data-flow/component-report`,\n  dataFlowPageReport: `${SPOTPATCH_API_BASE}/data-flow/page-report`,\n  agentCapability: `${SPOTPATCH_API_BASE}/agent/capability`,\n  agentWorkspaceHealth: `${SPOTPATCH_API_BASE}/agent/workspace-health`,\n  agentJobs: `${SPOTPATCH_API_BASE}/agent/jobs`,\n  askCapability: `${SPOTPATCH_API_BASE}/ask/capability`,\n  askJobs: `${SPOTPATCH_API_BASE}/ask/jobs`,\n  externalHandoffCapability: `${SPOTPATCH_API_BASE}/external-handoff/capability`,\n  externalHandoffPublish: `${SPOTPATCH_API_BASE}/external-handoff/publish`,\n  externalHandoffStatus: `${SPOTPATCH_API_BASE}/external-handoff/status`,\n  externalHandoffResolveDelivery: `${SPOTPATCH_API_BASE}/external-handoff/resolve-delivery`,\n  externalAgentControlStatus: `${SPOTPATCH_API_BASE}/external-agent/control/status`,\n  externalAgentControlConnect: `${SPOTPATCH_API_BASE}/external-agent/control/connect`,\n  externalAgentControlDisconnect: `${SPOTPATCH_API_BASE}/external-agent/control/disconnect`,\n  externalAgentControlCancel: `${SPOTPATCH_API_BASE}/external-agent/control/cancel`,\n  externalAgentEvents: `${SPOTPATCH_API_BASE}/external-agent/events`,\n  externalAgentResult: `${SPOTPATCH_API_BASE}/external-agent/result`,\n});\n\nexport type AgentJobAction = \"events\" | \"result\" | \"cancel\" | \"apply\" | \"revert\";\nexport type AskJobAction = \"events\" | \"result\" | \"cancel\";\n\nexport function getAgentJobEndpoint(jobId: string, action: AgentJobAction): string {\n  return `${SPOTPATCH_ENDPOINTS.agentJobs}/${encodeURIComponent(jobId)}/${action}`;\n}\n\nexport function getAskJobEndpoint(\n  jobId: string,\n  action: AskJobAction,\n  options: Readonly<{ afterSequence?: number }> = {},\n): string {\n  const endpoint = `${SPOTPATCH_ENDPOINTS.askJobs}/${encodeURIComponent(jobId)}/${action}`;\n  if (action !== \"events\" && options.afterSequence !== undefined) {\n    throw new RangeError(\"afterSequence is only valid for the events endpoint.\");\n  }\n  if (options.afterSequence === undefined) return endpoint;\n  if (!Number.isSafeInteger(options.afterSequence) || options.afterSequence < 0) {\n    throw new RangeError(\"afterSequence must be a non-negative safe integer.\");\n  }\n  return `${endpoint}?afterSequence=${String(options.afterSequence)}`;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/contextual-ask-browser.ts","../src/protocol/contextual-ask-constants.ts","../src/protocol/endpoints.ts"],"sourcesContent":["import type { ERROR_CODES as GLOBAL_ERROR_CODES } from \"./errors/error-code.js\";\nimport type { ContextualAskErrorCode } from \"./errors/error-code.js\";\n\nconst CONTEXTUAL_ASK_ERRORS = {\n  ASK_DISABLED: \"ASK_DISABLED\",\n  ASK_SELECTION_REQUIRED: \"ASK_SELECTION_REQUIRED\",\n  ASK_SELECTION_STALE: \"ASK_SELECTION_STALE\",\n  ASK_QUESTION_INVALID: \"ASK_QUESTION_INVALID\",\n  ASK_EXECUTOR_UNAVAILABLE: \"ASK_EXECUTOR_UNAVAILABLE\",\n  ASK_TIMEOUT: \"ASK_TIMEOUT\",\n  ASK_CONSENT_REQUIRED: \"ASK_CONSENT_REQUIRED\",\n  ASK_BUSY: \"ASK_BUSY\",\n  ASK_IDEMPOTENCY_CONFLICT: \"ASK_IDEMPOTENCY_CONFLICT\",\n  ASK_SOURCE_SCOPE_DENIED: \"ASK_SOURCE_SCOPE_DENIED\",\n  ASK_LIMIT_EXCEEDED: \"ASK_LIMIT_EXCEEDED\",\n  ASK_ANSWER_INVALID: \"ASK_ANSWER_INVALID\",\n  ASK_WRITE_ATTEMPTED: \"ASK_WRITE_ATTEMPTED\",\n  ASK_CANCELLED: \"ASK_CANCELLED\",\n  ASK_RESULT_EXPIRED: \"ASK_RESULT_EXPIRED\",\n  ASK_PROTOCOL_INCOMPATIBLE: \"ASK_PROTOCOL_INCOMPATIBLE\",\n} as const satisfies Record<ContextualAskErrorCode, ContextualAskErrorCode>;\n\n/** Browser-reachable Ask errors only; no provider details or Node failures. */\nexport const ERROR_CODES = Object.freeze({\n  INVALID_REQUEST: \"INVALID_REQUEST\",\n  INVALID_TOKEN: \"INVALID_TOKEN\",\n  ORIGIN_NOT_ALLOWED: \"ORIGIN_NOT_ALLOWED\",\n  ...CONTEXTUAL_ASK_ERRORS,\n  INTERNAL_ERROR: \"INTERNAL_ERROR\",\n} as const satisfies Pick<\n  typeof GLOBAL_ERROR_CODES,\n  \"INTERNAL_ERROR\" | \"INVALID_REQUEST\" | \"INVALID_TOKEN\" | \"ORIGIN_NOT_ALLOWED\"\n>);\nexport type ErrorCode = (typeof ERROR_CODES)[keyof typeof ERROR_CODES];\nconst ERROR_CODE_VALUES: readonly string[] = Object.values(ERROR_CODES);\n\nexport function isErrorCode(value: unknown): value is ErrorCode {\n  return typeof value === \"string\" && ERROR_CODE_VALUES.includes(value);\n}\n\nexport {\n  ASK_ANSWER_WARNING_CODES,\n  ASK_EXECUTOR_ANSWER_WARNING_CODES,\n  ASK_FILE_COUNT_BUCKETS,\n  ASK_JOB_STATUSES,\n  ASK_READ_ACTIVITY_STATES,\n  ASK_SOURCE_CONFIDENCES,\n  CONTEXTUAL_ASK_EXECUTOR_KINDS,\n  CONTEXTUAL_ASK_EXECUTOR_STATES,\n  CONTEXTUAL_ASK_LIMITS,\n  CONTEXTUAL_ASK_SCHEMA_VERSION,\n  type AskAnswerWarningCode,\n  type AskExecutorAnswerWarningCode,\n  type AskFileCountBucket,\n  type AskJobStatus,\n  type AskReadActivityState,\n  type AskSourceConfidence,\n  type ContextualAskExecutorKind,\n  type ContextualAskExecutorState,\n} from \"./protocol/contextual-ask-constants.js\";\nexport {\n  getAskJobEndpoint,\n  SPOTPATCH_ENDPOINTS,\n  SPOTPATCH_TOKEN_HEADER,\n  type AskJobAction,\n} from \"./protocol/endpoints.js\";\nexport type {\n  AskAnswerBlock,\n  AskAnswerResult,\n  AskAnswerWarning,\n  AskDraftOrigin,\n  AskSourceReference,\n  ContextualAskCapability,\n  ContextualAskExecutorCapability,\n  SpotAskTaskEnvelope,\n  SpotChangeTaskEnvelope,\n  SpotSelectionContext,\n  SpotSelectionTarget,\n  SpotTaskEnvelope,\n} from \"./model/contextual-ask.js\";\nexport type {\n  AskJobActionRequest,\n  AskJobCreateRequest,\n  AskJobEvent,\n  AskJobEventsRequest,\n  AskJobResultResponse,\n  AskJobSnapshot,\n  ContextualAskCapabilityRequest,\n} from \"./protocol/contextual-ask.js\";\n","export const CONTEXTUAL_ASK_SCHEMA_VERSION = 1 as const;\n\nexport const CONTEXTUAL_ASK_LIMITS = Object.freeze({\n  maximumTargets: 20,\n  maximumQuestionCharacters: 4_000,\n  maximumAnswerCharacters: 40_000,\n  maximumAnswerBlocks: 40,\n  maximumSources: 64,\n  maximumReadFiles: 32,\n  maximumReadBytesPerFile: 64 * 1_024,\n  maximumReadBytesTotal: 512 * 1_024,\n  maximumToolCalls: 48,\n  maximumModelTurns: 12,\n  jobTimeoutMs: 300_000,\n  resultTtlMs: 900_000,\n  maximumActiveJobsPerSession: 1,\n  maximumRetainedResultsPerSession: 1,\n  maximumRetainedEvents: 256,\n  maximumEventSubscribers: 4,\n  eventHeartbeatMs: 15_000,\n  maximumRequestBodyBytes: 256 * 1_024,\n  maximumSearchQueryCharacters: 256,\n  maximumSearchResults: 64,\n  maximumSearchPreviewCharacters: 500,\n  capabilityTimeoutMs: 30_000,\n  maximumIdCharacters: 128,\n  maximumProfileIdCharacters: 64,\n  maximumLabelCharacters: 256,\n  maximumRelativePathCharacters: 1_024,\n  maximumLanguageCharacters: 64,\n  maximumPhaseMessageCharacters: 1_024,\n  maximumExecutors: 32,\n  maximumModels: 800,\n  contentHashHexCharacters: 64,\n} as const);\n\nexport const CONTEXTUAL_ASK_EXECUTOR_KINDS = Object.freeze([\n  \"configured-key\",\n  \"managed-codex\",\n  \"claude-code\",\n] as const);\nexport type ContextualAskExecutorKind = (typeof CONTEXTUAL_ASK_EXECUTOR_KINDS)[number];\n\nexport const CONTEXTUAL_ASK_EXECUTOR_STATES = Object.freeze([\n  \"ready\",\n  \"degraded\",\n  \"unavailable\",\n] as const);\nexport type ContextualAskExecutorState =\n  (typeof CONTEXTUAL_ASK_EXECUTOR_STATES)[number];\n\nexport const ASK_JOB_STATUSES = Object.freeze([\n  \"queued\",\n  \"authorizing\",\n  \"running\",\n  \"cancelling\",\n  \"answered\",\n  \"cancelled\",\n  \"failed\",\n] as const);\nexport type AskJobStatus = (typeof ASK_JOB_STATUSES)[number];\n\nexport const ASK_ANSWER_WARNING_CODES = Object.freeze([\n  \"insufficient-evidence\",\n  \"partial-context\",\n  \"source-truncated\",\n  \"source-stale\",\n] as const);\nexport type AskAnswerWarningCode = (typeof ASK_ANSWER_WARNING_CODES)[number];\n\n/** Warnings an executor may declare from its own evidence assessment. */\nexport const ASK_EXECUTOR_ANSWER_WARNING_CODES = Object.freeze([\n  \"insufficient-evidence\",\n  \"partial-context\",\n] as const satisfies readonly AskAnswerWarningCode[]);\nexport type AskExecutorAnswerWarningCode =\n  (typeof ASK_EXECUTOR_ANSWER_WARNING_CODES)[number];\n\nexport const ASK_READ_ACTIVITY_STATES = Object.freeze([\n  \"started\",\n  \"succeeded\",\n  \"failed\",\n] as const);\nexport type AskReadActivityState = (typeof ASK_READ_ACTIVITY_STATES)[number];\n\nexport const ASK_FILE_COUNT_BUCKETS = Object.freeze([\"one\", \"few\", \"many\"] as const);\nexport type AskFileCountBucket = (typeof ASK_FILE_COUNT_BUCKETS)[number];\n\nexport const ASK_SOURCE_CONFIDENCES = Object.freeze([\n  \"exact\",\n  \"probable\",\n  \"approximate\",\n] as const);\nexport type AskSourceConfidence = (typeof ASK_SOURCE_CONFIDENCES)[number];\n\nexport const CONTEXTUAL_ASK_PERMISSION_PROFILE = \"spotpatch-ask-readonly\" as const;\n","export const SPOTPATCH_API_BASE = \"/__spotpatch/v1\" as const;\nexport const SPOTPATCH_TOKEN_HEADER = \"X-SpotPatch-Token\" as const;\n\nexport const SPOTPATCH_ENDPOINTS = Object.freeze({\n  bootstrap: `${SPOTPATCH_API_BASE}/bootstrap`,\n  sourceContext: `${SPOTPATCH_API_BASE}/source-context`,\n  openEditor: `${SPOTPATCH_API_BASE}/open-editor`,\n  dataFlowComponentReport: `${SPOTPATCH_API_BASE}/data-flow/component-report`,\n  dataFlowPageReport: `${SPOTPATCH_API_BASE}/data-flow/page-report`,\n  agentCapability: `${SPOTPATCH_API_BASE}/agent/capability`,\n  agentWorkspaceHealth: `${SPOTPATCH_API_BASE}/agent/workspace-health`,\n  agentJobs: `${SPOTPATCH_API_BASE}/agent/jobs`,\n  askCapability: `${SPOTPATCH_API_BASE}/ask/capability`,\n  askJobs: `${SPOTPATCH_API_BASE}/ask/jobs`,\n  externalHandoffCapability: `${SPOTPATCH_API_BASE}/external-handoff/capability`,\n  externalHandoffPublish: `${SPOTPATCH_API_BASE}/external-handoff/publish`,\n  externalHandoffStatus: `${SPOTPATCH_API_BASE}/external-handoff/status`,\n  externalHandoffResolveDelivery: `${SPOTPATCH_API_BASE}/external-handoff/resolve-delivery`,\n  externalAgentControlStatus: `${SPOTPATCH_API_BASE}/external-agent/control/status`,\n  externalAgentControlConnect: `${SPOTPATCH_API_BASE}/external-agent/control/connect`,\n  externalAgentControlDisconnect: `${SPOTPATCH_API_BASE}/external-agent/control/disconnect`,\n  externalAgentControlCancel: `${SPOTPATCH_API_BASE}/external-agent/control/cancel`,\n  externalAgentEvents: `${SPOTPATCH_API_BASE}/external-agent/events`,\n  externalAgentResult: `${SPOTPATCH_API_BASE}/external-agent/result`,\n});\n\nexport type AgentJobAction = \"events\" | \"result\" | \"cancel\" | \"apply\" | \"revert\";\nexport type AskJobAction = \"events\" | \"result\" | \"cancel\";\n\nexport function getAgentJobEndpoint(jobId: string, action: AgentJobAction): string {\n  return `${SPOTPATCH_ENDPOINTS.agentJobs}/${encodeURIComponent(jobId)}/${action}`;\n}\n\nexport function getAskJobEndpoint(\n  jobId: string,\n  action: AskJobAction,\n  options: Readonly<{ afterSequence?: number }> = {},\n): string {\n  const endpoint = `${SPOTPATCH_ENDPOINTS.askJobs}/${encodeURIComponent(jobId)}/${action}`;\n  if (action !== \"events\" && options.afterSequence !== undefined) {\n    throw new RangeError(\"afterSequence is only valid for the events endpoint.\");\n  }\n  if (options.afterSequence === undefined) return endpoint;\n  if (!Number.isSafeInteger(options.afterSequence) || options.afterSequence < 0) {\n    throw new RangeError(\"afterSequence must be a non-negative safe integer.\");\n  }\n  return `${endpoint}?afterSequence=${String(options.afterSequence)}`;\n}\n"],"mappings":"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","names":[]}

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-BpbkpFFf.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-BpbkpFFf.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-browser.js

@@ -9,7 +9,7 @@ import {
   CONTEXTUAL_ASK_EXECUTOR_STATES,
   CONTEXTUAL_ASK_LIMITS,
   CONTEXTUAL_ASK_SCHEMA_VERSION
-} from "./chunk-EWJTKNL4.js";
+} from "./chunk-RWFGFW4N.js";
 import {
   SPOTPATCH_ENDPOINTS,
   SPOTPATCH_TOKEN_HEADER,

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),
@@ -282,7 +306,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",
@@ -340,7 +365,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(),