@spotpatch/shared 1.12.0 → 1.13.0

package/dist/annotation-C0Me9mN2.d.cts

@@ -0,0 +1,102 @@
+interface ContextBudget {
+    readonly totalCharacters: number;
+    readonly domCharacters: number;
+    readonly cssCharacters: number;
+    readonly codeCharacters: number;
+    readonly maxCodeLines: number;
+    readonly maxComponentDepth: number;
+}
+interface CodeContext {
+    readonly relativePath: string;
+    readonly language: "tsx" | "jsx";
+    readonly startLine: number;
+    readonly endLine: number;
+    readonly excerpt: string;
+    readonly boundary: "component" | "nearby-lines";
+}
+
+type SourceConfidence = "exact" | "probable" | "approximate" | "unknown";
+type SourceOrigin = "jsx-host" | "react-fiber" | "dom-ancestor" | "none";
+interface SourceRef {
+    readonly fileId?: string;
+    readonly relativePath?: string;
+    readonly line?: number;
+    readonly column?: number;
+    readonly origin: SourceOrigin;
+    readonly confidence: SourceConfidence;
+}
+interface ReactContext {
+    readonly supported: boolean;
+    readonly version?: string;
+    readonly componentName?: string;
+    readonly componentSourceId?: string;
+    readonly sourceVersion?: string;
+    readonly componentStack: readonly string[];
+    readonly source?: SourceRef;
+}
+
+interface MatchedStyleRule {
+    readonly selector: string;
+    readonly declarations: string;
+    readonly source?: string;
+    readonly media?: string;
+}
+interface StyleContext {
+    readonly classNames: readonly string[];
+    readonly inlineStyle?: string;
+    readonly matchedRules: readonly MatchedStyleRule[];
+    readonly computed: Readonly<Record<string, string>>;
+    readonly warnings: readonly string[];
+}
+
+interface PageContext {
+    readonly url: string;
+    readonly pathname: string;
+    readonly title: string;
+    readonly viewportWidth: number;
+    readonly viewportHeight: number;
+    readonly devicePixelRatio: number;
+}
+interface ElementContext {
+    readonly tagName: string;
+    readonly selector: string;
+    readonly sanitizedHtml: string;
+    readonly textPreview?: string;
+    readonly role?: string;
+    readonly rect: Readonly<{
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    }>;
+}
+/** Protocol hard limit. Runtime configuration may choose a smaller limit. */
+declare const MAX_ANNOTATION_TARGETS = 20;
+/** Each target owns its requested change; the UI enforces the same bound. */
+declare const MAX_TARGET_INSTRUCTION_CHARACTERS = 2000;
+/** Keeps the complete, atomic user intent within the prompt and request budgets. */
+declare const MAX_ANNOTATION_INSTRUCTION_CHARACTERS = 4000;
+declare const SPOTPATCH_LOCALES: readonly ["en-US", "zh-CN"];
+type SpotPatchLocale = (typeof SPOTPATCH_LOCALES)[number];
+declare const SPOTPATCH_LOCALE_PREFERENCES: readonly ["auto", "en-US", "zh-CN"];
+type SpotPatchLocalePreference = (typeof SPOTPATCH_LOCALE_PREFERENCES)[number];
+interface SpotTargetContext {
+    readonly instruction: string;
+    readonly page?: Readonly<PageContext>;
+    readonly source: SourceRef;
+    readonly react: ReactContext;
+    readonly element: ElementContext;
+    readonly styles: StyleContext;
+    readonly code?: CodeContext;
+    readonly warnings: readonly string[];
+}
+interface SpotAnnotation {
+    readonly schemaVersion: 3;
+    readonly id: string;
+    readonly locale: SpotPatchLocale;
+    readonly page: Readonly<PageContext>;
+    readonly targets: readonly SpotTargetContext[];
+    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 };

package/dist/annotation-C0Me9mN2.d.ts

@@ -0,0 +1,102 @@
+interface ContextBudget {
+    readonly totalCharacters: number;
+    readonly domCharacters: number;
+    readonly cssCharacters: number;
+    readonly codeCharacters: number;
+    readonly maxCodeLines: number;
+    readonly maxComponentDepth: number;
+}
+interface CodeContext {
+    readonly relativePath: string;
+    readonly language: "tsx" | "jsx";
+    readonly startLine: number;
+    readonly endLine: number;
+    readonly excerpt: string;
+    readonly boundary: "component" | "nearby-lines";
+}
+
+type SourceConfidence = "exact" | "probable" | "approximate" | "unknown";
+type SourceOrigin = "jsx-host" | "react-fiber" | "dom-ancestor" | "none";
+interface SourceRef {
+    readonly fileId?: string;
+    readonly relativePath?: string;
+    readonly line?: number;
+    readonly column?: number;
+    readonly origin: SourceOrigin;
+    readonly confidence: SourceConfidence;
+}
+interface ReactContext {
+    readonly supported: boolean;
+    readonly version?: string;
+    readonly componentName?: string;
+    readonly componentSourceId?: string;
+    readonly sourceVersion?: string;
+    readonly componentStack: readonly string[];
+    readonly source?: SourceRef;
+}
+
+interface MatchedStyleRule {
+    readonly selector: string;
+    readonly declarations: string;
+    readonly source?: string;
+    readonly media?: string;
+}
+interface StyleContext {
+    readonly classNames: readonly string[];
+    readonly inlineStyle?: string;
+    readonly matchedRules: readonly MatchedStyleRule[];
+    readonly computed: Readonly<Record<string, string>>;
+    readonly warnings: readonly string[];
+}
+
+interface PageContext {
+    readonly url: string;
+    readonly pathname: string;
+    readonly title: string;
+    readonly viewportWidth: number;
+    readonly viewportHeight: number;
+    readonly devicePixelRatio: number;
+}
+interface ElementContext {
+    readonly tagName: string;
+    readonly selector: string;
+    readonly sanitizedHtml: string;
+    readonly textPreview?: string;
+    readonly role?: string;
+    readonly rect: Readonly<{
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    }>;
+}
+/** Protocol hard limit. Runtime configuration may choose a smaller limit. */
+declare const MAX_ANNOTATION_TARGETS = 20;
+/** Each target owns its requested change; the UI enforces the same bound. */
+declare const MAX_TARGET_INSTRUCTION_CHARACTERS = 2000;
+/** Keeps the complete, atomic user intent within the prompt and request budgets. */
+declare const MAX_ANNOTATION_INSTRUCTION_CHARACTERS = 4000;
+declare const SPOTPATCH_LOCALES: readonly ["en-US", "zh-CN"];
+type SpotPatchLocale = (typeof SPOTPATCH_LOCALES)[number];
+declare const SPOTPATCH_LOCALE_PREFERENCES: readonly ["auto", "en-US", "zh-CN"];
+type SpotPatchLocalePreference = (typeof SPOTPATCH_LOCALE_PREFERENCES)[number];
+interface SpotTargetContext {
+    readonly instruction: string;
+    readonly page?: Readonly<PageContext>;
+    readonly source: SourceRef;
+    readonly react: ReactContext;
+    readonly element: ElementContext;
+    readonly styles: StyleContext;
+    readonly code?: CodeContext;
+    readonly warnings: readonly string[];
+}
+interface SpotAnnotation {
+    readonly schemaVersion: 3;
+    readonly id: string;
+    readonly locale: SpotPatchLocale;
+    readonly page: Readonly<PageContext>;
+    readonly targets: readonly SpotTargetContext[];
+    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 };

package/dist/chunk-C2PJ4UUU.js

@@ -0,0 +1,195 @@
+// src/model/annotation.ts
+var MAX_ANNOTATION_TARGETS = 20;
+var MAX_TARGET_INSTRUCTION_CHARACTERS = 2e3;
+var MAX_ANNOTATION_INSTRUCTION_CHARACTERS = 4e3;
+var SPOTPATCH_LOCALES = Object.freeze(["en-US", "zh-CN"]);
+var SPOTPATCH_LOCALE_PREFERENCES = Object.freeze([
+  "auto",
+  ...SPOTPATCH_LOCALES
+]);
+
+// src/model/context-schema.ts
+import { z } from "zod";
+var boundedString = (maximum) => z.string().max(maximum);
+var sourceRefSchema = z.strictObject({
+  fileId: boundedString(128).optional(),
+  relativePath: boundedString(1024).optional(),
+  line: z.number().int().positive().optional(),
+  column: z.number().int().positive().optional(),
+  origin: z.enum(["jsx-host", "react-fiber", "dom-ancestor", "none"]),
+  confidence: z.enum(["exact", "probable", "approximate", "unknown"])
+});
+var matchedStyleRuleSchema = z.strictObject({
+  selector: boundedString(2048),
+  declarations: boundedString(8192),
+  source: boundedString(1024).optional(),
+  media: boundedString(1024).optional()
+});
+var codeContextSchema = z.strictObject({
+  relativePath: boundedString(1024),
+  language: z.enum(["tsx", "jsx"]),
+  startLine: z.number().int().positive(),
+  endLine: z.number().int().positive(),
+  excerpt: boundedString(16e3),
+  boundary: z.enum(["component", "nearby-lines"])
+});
+var pageContextSchema = z.strictObject({
+  url: boundedString(2048),
+  pathname: boundedString(2048),
+  title: boundedString(1024),
+  viewportWidth: z.number().nonnegative(),
+  viewportHeight: z.number().nonnegative(),
+  devicePixelRatio: z.number().positive()
+});
+var spotTargetContextSchema = z.strictObject({
+  instruction: z.string().trim().min(1).max(MAX_TARGET_INSTRUCTION_CHARACTERS),
+  page: pageContextSchema.optional(),
+  source: sourceRefSchema,
+  react: z.strictObject({
+    supported: z.boolean(),
+    version: boundedString(64).optional(),
+    componentName: boundedString(256).optional(),
+    componentSourceId: boundedString(128).optional(),
+    sourceVersion: boundedString(128).optional(),
+    componentStack: z.array(boundedString(256)).max(64),
+    source: sourceRefSchema.optional()
+  }),
+  element: z.strictObject({
+    tagName: boundedString(128),
+    selector: boundedString(2048),
+    sanitizedHtml: boundedString(8192),
+    textPreview: boundedString(2048).optional(),
+    role: boundedString(256).optional(),
+    rect: z.strictObject({
+      x: z.number(),
+      y: z.number(),
+      width: z.number().nonnegative(),
+      height: z.number().nonnegative()
+    })
+  }),
+  styles: z.strictObject({
+    classNames: z.array(boundedString(512)).max(256),
+    inlineStyle: boundedString(8192).optional(),
+    matchedRules: z.array(matchedStyleRuleSchema).max(256),
+    computed: z.record(boundedString(256), boundedString(2048)),
+    warnings: z.array(boundedString(1024)).max(64)
+  }),
+  code: codeContextSchema.optional(),
+  warnings: z.array(boundedString(1024)).max(64)
+});
+var spotAnnotationSchema = z.strictObject({
+  schemaVersion: z.literal(3),
+  id: boundedString(128),
+  locale: z.enum(SPOTPATCH_LOCALES),
+  page: pageContextSchema,
+  targets: z.array(spotTargetContextSchema).min(1).max(MAX_ANNOTATION_TARGETS),
+  createdAt: z.iso.datetime()
+}).superRefine((annotation, context) => {
+  const total = annotation.targets.reduce(
+    (characters, target) => characters + target.instruction.length,
+    0
+  );
+  if (total > MAX_ANNOTATION_INSTRUCTION_CHARACTERS) {
+    context.addIssue({
+      code: "custom",
+      message: "Combined target instructions exceed the annotation limit.",
+      path: ["targets"]
+    });
+  }
+});
+
+// src/errors/error-code.ts
+var ERROR_CODES = {
+  INVALID_REQUEST: "INVALID_REQUEST",
+  INVALID_TOKEN: "INVALID_TOKEN",
+  ORIGIN_NOT_ALLOWED: "ORIGIN_NOT_ALLOWED",
+  SOURCE_NOT_FOUND: "SOURCE_NOT_FOUND",
+  SOURCE_OUTSIDE_ROOT: "SOURCE_OUTSIDE_ROOT",
+  SOURCE_TOO_LARGE: "SOURCE_TOO_LARGE",
+  EDITOR_OPEN_FAILED: "EDITOR_OPEN_FAILED",
+  DATA_FLOW_DISABLED: "DATA_FLOW_DISABLED",
+  DATA_FLOW_SOURCE_STALE: "DATA_FLOW_SOURCE_STALE",
+  DATA_FLOW_ANALYSIS_CANCELLED: "DATA_FLOW_ANALYSIS_CANCELLED",
+  AI_DISABLED: "AI_DISABLED",
+  PROVIDER_NOT_CONFIGURED: "PROVIDER_NOT_CONFIGURED",
+  PROVIDER_AUTH_FAILED: "PROVIDER_AUTH_FAILED",
+  PROVIDER_PROTOCOL_UNSUPPORTED: "PROVIDER_PROTOCOL_UNSUPPORTED",
+  MODEL_NOT_ALLOWED: "MODEL_NOT_ALLOWED",
+  MODEL_TOOL_CALL_UNSUPPORTED: "MODEL_TOOL_CALL_UNSUPPORTED",
+  PROVIDER_RATE_LIMITED: "PROVIDER_RATE_LIMITED",
+  AGENT_BUSY: "AGENT_BUSY",
+  AGENT_LIMIT_EXCEEDED: "AGENT_LIMIT_EXCEEDED",
+  AGENT_CANCELLED: "AGENT_CANCELLED",
+  EXTERNAL_HANDOFF_DISABLED: "EXTERNAL_HANDOFF_DISABLED",
+  EXTERNAL_HANDOFF_UNAVAILABLE: "EXTERNAL_HANDOFF_UNAVAILABLE",
+  HANDOFF_VALIDATION_FAILED: "HANDOFF_VALIDATION_FAILED",
+  HANDOFF_SOURCE_STALE: "HANDOFF_SOURCE_STALE",
+  HANDOFF_NOT_FOUND: "HANDOFF_NOT_FOUND",
+  HANDOFF_EXPIRED: "HANDOFF_EXPIRED",
+  HANDOFF_CURSOR_INVALID: "HANDOFF_CURSOR_INVALID",
+  HANDOFF_RESPONSE_TOO_LARGE: "HANDOFF_RESPONSE_TOO_LARGE",
+  BRIDGE_UNAUTHORIZED: "BRIDGE_UNAUTHORIZED",
+  BRIDGE_PROTOCOL_MISMATCH: "BRIDGE_PROTOCOL_MISMATCH",
+  BRIDGE_BUSY: "BRIDGE_BUSY",
+  EXTERNAL_AGENT_BUSY: "EXTERNAL_AGENT_BUSY",
+  ACTIVE_ADAPTER_CONFLICT: "ACTIVE_ADAPTER_CONFLICT",
+  ACTIVE_ADAPTER_LEASE_INVALID: "ACTIVE_ADAPTER_LEASE_INVALID",
+  ACTIVE_DISPATCH_INVALID: "ACTIVE_DISPATCH_INVALID",
+  SESSION_NOT_FOUND: "SESSION_NOT_FOUND",
+  SESSION_AMBIGUOUS: "SESSION_AMBIGUOUS",
+  SESSION_CLOSED: "SESSION_CLOSED",
+  WORKTREE_DIRTY: "WORKTREE_DIRTY",
+  WORKTREE_NOT_REPOSITORY: "WORKTREE_NOT_REPOSITORY",
+  WORKTREE_OPERATION_IN_PROGRESS: "WORKTREE_OPERATION_IN_PROGRESS",
+  WORKTREE_CONFLICTED: "WORKTREE_CONFLICTED",
+  WORKTREE_LOCAL_CHANGES_TOO_LARGE: "WORKTREE_LOCAL_CHANGES_TOO_LARGE",
+  WORKTREE_UNTRACKED_UNSUPPORTED: "WORKTREE_UNTRACKED_UNSUPPORTED",
+  WORKTREE_LOCAL_CHANGES_UNSUPPORTED: "WORKTREE_LOCAL_CHANGES_UNSUPPORTED",
+  TOOL_DENIED: "TOOL_DENIED",
+  TOOL_INPUT_INVALID: "TOOL_INPUT_INVALID",
+  TOOL_ARGUMENTS_INVALID: "TOOL_ARGUMENTS_INVALID",
+  TOOL_CALL_ID_CONFLICT: "TOOL_CALL_ID_CONFLICT",
+  TOOL_PATH_DENIED: "TOOL_PATH_DENIED",
+  PATCH_REJECTED: "PATCH_REJECTED",
+  VALIDATION_FAILED: "VALIDATION_FAILED",
+  APPLY_CONFLICT: "APPLY_CONFLICT",
+  INTERNAL_ERROR: "INTERNAL_ERROR"
+};
+var CONTEXTUAL_ASK_ERROR_CODES = Object.freeze([
+  "ASK_DISABLED",
+  "ASK_SELECTION_REQUIRED",
+  "ASK_SELECTION_STALE",
+  "ASK_QUESTION_INVALID",
+  "ASK_EXECUTOR_UNAVAILABLE",
+  "ASK_TIMEOUT",
+  "ASK_CONSENT_REQUIRED",
+  "ASK_BUSY",
+  "ASK_IDEMPOTENCY_CONFLICT",
+  "ASK_SOURCE_SCOPE_DENIED",
+  "ASK_LIMIT_EXCEEDED",
+  "ASK_ANSWER_INVALID",
+  "ASK_WRITE_ATTEMPTED",
+  "ASK_CANCELLED",
+  "ASK_RESULT_EXPIRED",
+  "ASK_PROTOCOL_INCOMPATIBLE"
+]);
+var ERROR_CODE_VALUES = Object.freeze(Object.values(ERROR_CODES));
+function isErrorCode(value) {
+  return typeof value === "string" && ERROR_CODE_VALUES.includes(value);
+}
+
+export {
+  MAX_ANNOTATION_TARGETS,
+  MAX_TARGET_INSTRUCTION_CHARACTERS,
+  MAX_ANNOTATION_INSTRUCTION_CHARACTERS,
+  SPOTPATCH_LOCALES,
+  SPOTPATCH_LOCALE_PREFERENCES,
+  pageContextSchema,
+  spotTargetContextSchema,
+  spotAnnotationSchema,
+  ERROR_CODES,
+  CONTEXTUAL_ASK_ERROR_CODES,
+  ERROR_CODE_VALUES,
+  isErrorCode
+};
+//# sourceMappingURL=chunk-C2PJ4UUU.js.map

package/dist/chunk-C2PJ4UUU.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/model/annotation.ts","../src/model/context-schema.ts","../src/errors/error-code.ts"],"sourcesContent":["import type { CodeContext } from \"./code-context.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 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\";\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 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\", \"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\"]),\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    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/chunk-DYTWEIES.js

@@ -0,0 +1,89 @@
+// src/protocol/contextual-ask-constants.ts
+var CONTEXTUAL_ASK_SCHEMA_VERSION = 1;
+var CONTEXTUAL_ASK_LIMITS = Object.freeze({
+  maximumTargets: 20,
+  maximumQuestionCharacters: 4e3,
+  maximumAnswerCharacters: 4e4,
+  maximumAnswerBlocks: 40,
+  maximumSources: 64,
+  maximumReadFiles: 32,
+  maximumReadBytesPerFile: 64 * 1024,
+  maximumReadBytesTotal: 512 * 1024,
+  maximumToolCalls: 48,
+  maximumModelTurns: 12,
+  jobTimeoutMs: 3e5,
+  resultTtlMs: 9e5,
+  maximumActiveJobsPerSession: 1,
+  maximumRetainedResultsPerSession: 1,
+  maximumRetainedEvents: 256,
+  maximumEventSubscribers: 4,
+  eventHeartbeatMs: 15e3,
+  maximumRequestBodyBytes: 256 * 1024,
+  maximumSearchQueryCharacters: 256,
+  maximumSearchResults: 64,
+  maximumSearchPreviewCharacters: 500,
+  capabilityTimeoutMs: 3e4,
+  maximumIdCharacters: 128,
+  maximumProfileIdCharacters: 64,
+  maximumLabelCharacters: 256,
+  maximumRelativePathCharacters: 1024,
+  maximumLanguageCharacters: 64,
+  maximumPhaseMessageCharacters: 1024,
+  maximumExecutors: 32,
+  contentHashHexCharacters: 64
+});
+var CONTEXTUAL_ASK_EXECUTOR_KINDS = Object.freeze([
+  "configured-key",
+  "managed-codex"
+]);
+var CONTEXTUAL_ASK_EXECUTOR_STATES = Object.freeze([
+  "ready",
+  "degraded",
+  "unavailable"
+]);
+var ASK_JOB_STATUSES = Object.freeze([
+  "queued",
+  "authorizing",
+  "running",
+  "cancelling",
+  "answered",
+  "cancelled",
+  "failed"
+]);
+var ASK_ANSWER_WARNING_CODES = Object.freeze([
+  "insufficient-evidence",
+  "partial-context",
+  "source-truncated",
+  "source-stale"
+]);
+var ASK_EXECUTOR_ANSWER_WARNING_CODES = Object.freeze([
+  "insufficient-evidence",
+  "partial-context"
+]);
+var ASK_READ_ACTIVITY_STATES = Object.freeze([
+  "started",
+  "succeeded",
+  "failed"
+]);
+var ASK_FILE_COUNT_BUCKETS = Object.freeze(["one", "few", "many"]);
+var ASK_SOURCE_CONFIDENCES = Object.freeze([
+  "exact",
+  "probable",
+  "approximate"
+]);
+var CONTEXTUAL_ASK_PERMISSION_PROFILE = "spotpatch-ask-readonly";
+
+export {
+  CONTEXTUAL_ASK_SCHEMA_VERSION,
+  CONTEXTUAL_ASK_LIMITS,
+  CONTEXTUAL_ASK_EXECUTOR_KINDS,
+  CONTEXTUAL_ASK_EXECUTOR_STATES,
+  ASK_JOB_STATUSES,
+  ASK_ANSWER_WARNING_CODES,
+  ASK_EXECUTOR_ANSWER_WARNING_CODES,
+  ASK_READ_ACTIVITY_STATES,
+  ASK_FILE_COUNT_BUCKETS,
+  ASK_SOURCE_CONFIDENCES,
+  CONTEXTUAL_ASK_PERMISSION_PROFILE
+};
+//# sourceMappingURL=chunk-DYTWEIES.js.map

package/dist/chunk-DYTWEIES.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/protocol/contextual-ask-constants.ts"],"sourcesContent":["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  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"],"mappings":";AAAO,IAAM,gCAAgC;AAEtC,IAAM,wBAAwB,OAAO,OAAO;AAAA,EACjD,gBAAgB;AAAA,EAChB,2BAA2B;AAAA,EAC3B,yBAAyB;AAAA,EACzB,qBAAqB;AAAA,EACrB,gBAAgB;AAAA,EAChB,kBAAkB;AAAA,EAClB,yBAAyB,KAAK;AAAA,EAC9B,uBAAuB,MAAM;AAAA,EAC7B,kBAAkB;AAAA,EAClB,mBAAmB;AAAA,EACnB,cAAc;AAAA,EACd,aAAa;AAAA,EACb,6BAA6B;AAAA,EAC7B,kCAAkC;AAAA,EAClC,uBAAuB;AAAA,EACvB,yBAAyB;AAAA,EACzB,kBAAkB;AAAA,EAClB,yBAAyB,MAAM;AAAA,EAC/B,8BAA8B;AAAA,EAC9B,sBAAsB;AAAA,EACtB,gCAAgC;AAAA,EAChC,qBAAqB;AAAA,EACrB,qBAAqB;AAAA,EACrB,4BAA4B;AAAA,EAC5B,wBAAwB;AAAA,EACxB,+BAA+B;AAAA,EAC/B,2BAA2B;AAAA,EAC3B,+BAA+B;AAAA,EAC/B,kBAAkB;AAAA,EAClB,0BAA0B;AAC5B,CAAU;AAEH,IAAM,gCAAgC,OAAO,OAAO;AAAA,EACzD;AAAA,EACA;AACF,CAAU;AAGH,IAAM,iCAAiC,OAAO,OAAO;AAAA,EAC1D;AAAA,EACA;AAAA,EACA;AACF,CAAU;AAIH,IAAM,mBAAmB,OAAO,OAAO;AAAA,EAC5C;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAU;AAGH,IAAM,2BAA2B,OAAO,OAAO;AAAA,EACpD;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAU;AAIH,IAAM,oCAAoC,OAAO,OAAO;AAAA,EAC7D;AAAA,EACA;AACF,CAAoD;AAI7C,IAAM,2BAA2B,OAAO,OAAO;AAAA,EACpD;AAAA,EACA;AAAA,EACA;AACF,CAAU;AAGH,IAAM,yBAAyB,OAAO,OAAO,CAAC,OAAO,OAAO,MAAM,CAAU;AAG5E,IAAM,yBAAyB,OAAO,OAAO;AAAA,EAClD;AAAA,EACA;AAAA,EACA;AACF,CAAU;AAGH,IAAM,oCAAoC;","names":[]}

package/dist/{chunk-JGOIBOFI.js → chunk-FPDSZDP2.js}

@@ -10,6 +10,8 @@ var SPOTPATCH_ENDPOINTS = Object.freeze({
   agentCapability: `${SPOTPATCH_API_BASE}/agent/capability`,
   agentWorkspaceHealth: `${SPOTPATCH_API_BASE}/agent/workspace-health`,
   agentJobs: `${SPOTPATCH_API_BASE}/agent/jobs`,
+  askCapability: `${SPOTPATCH_API_BASE}/ask/capability`,
+  askJobs: `${SPOTPATCH_API_BASE}/ask/jobs`,
   externalHandoffCapability: `${SPOTPATCH_API_BASE}/external-handoff/capability`,
   externalHandoffPublish: `${SPOTPATCH_API_BASE}/external-handoff/publish`,
   externalHandoffStatus: `${SPOTPATCH_API_BASE}/external-handoff/status`,
@@ -24,11 +26,23 @@ var SPOTPATCH_ENDPOINTS = Object.freeze({
 function getAgentJobEndpoint(jobId, action) {
   return `${SPOTPATCH_ENDPOINTS.agentJobs}/${encodeURIComponent(jobId)}/${action}`;
 }
+function getAskJobEndpoint(jobId, action, options = {}) {
+  const endpoint = `${SPOTPATCH_ENDPOINTS.askJobs}/${encodeURIComponent(jobId)}/${action}`;
+  if (action !== "events" && options.afterSequence !== void 0) {
+    throw new RangeError("afterSequence is only valid for the events endpoint.");
+  }
+  if (options.afterSequence === void 0) return endpoint;
+  if (!Number.isSafeInteger(options.afterSequence) || options.afterSequence < 0) {
+    throw new RangeError("afterSequence must be a non-negative safe integer.");
+  }
+  return `${endpoint}?afterSequence=${String(options.afterSequence)}`;
+}
 
 export {
   SPOTPATCH_API_BASE,
   SPOTPATCH_TOKEN_HEADER,
   SPOTPATCH_ENDPOINTS,
-  getAgentJobEndpoint
+  getAgentJobEndpoint,
+  getAskJobEndpoint
 };
-//# sourceMappingURL=chunk-JGOIBOFI.js.map
+//# sourceMappingURL=chunk-FPDSZDP2.js.map

package/dist/chunk-FPDSZDP2.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/protocol/endpoints.ts"],"sourcesContent":["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":";AAAO,IAAM,qBAAqB;AAC3B,IAAM,yBAAyB;AAE/B,IAAM,sBAAsB,OAAO,OAAO;AAAA,EAC/C,WAAW,GAAG,kBAAkB;AAAA,EAChC,eAAe,GAAG,kBAAkB;AAAA,EACpC,YAAY,GAAG,kBAAkB;AAAA,EACjC,yBAAyB,GAAG,kBAAkB;AAAA,EAC9C,oBAAoB,GAAG,kBAAkB;AAAA,EACzC,iBAAiB,GAAG,kBAAkB;AAAA,EACtC,sBAAsB,GAAG,kBAAkB;AAAA,EAC3C,WAAW,GAAG,kBAAkB;AAAA,EAChC,eAAe,GAAG,kBAAkB;AAAA,EACpC,SAAS,GAAG,kBAAkB;AAAA,EAC9B,2BAA2B,GAAG,kBAAkB;AAAA,EAChD,wBAAwB,GAAG,kBAAkB;AAAA,EAC7C,uBAAuB,GAAG,kBAAkB;AAAA,EAC5C,gCAAgC,GAAG,kBAAkB;AAAA,EACrD,4BAA4B,GAAG,kBAAkB;AAAA,EACjD,6BAA6B,GAAG,kBAAkB;AAAA,EAClD,gCAAgC,GAAG,kBAAkB;AAAA,EACrD,4BAA4B,GAAG,kBAAkB;AAAA,EACjD,qBAAqB,GAAG,kBAAkB;AAAA,EAC1C,qBAAqB,GAAG,kBAAkB;AAC5C,CAAC;AAKM,SAAS,oBAAoB,OAAe,QAAgC;AACjF,SAAO,GAAG,oBAAoB,SAAS,IAAI,mBAAmB,KAAK,CAAC,IAAI,MAAM;AAChF;AAEO,SAAS,kBACd,OACA,QACA,UAAgD,CAAC,GACzC;AACR,QAAM,WAAW,GAAG,oBAAoB,OAAO,IAAI,mBAAmB,KAAK,CAAC,IAAI,MAAM;AACtF,MAAI,WAAW,YAAY,QAAQ,kBAAkB,QAAW;AAC9D,UAAM,IAAI,WAAW,sDAAsD;AAAA,EAC7E;AACA,MAAI,QAAQ,kBAAkB,OAAW,QAAO;AAChD,MAAI,CAAC,OAAO,cAAc,QAAQ,aAAa,KAAK,QAAQ,gBAAgB,GAAG;AAC7E,UAAM,IAAI,WAAW,oDAAoD;AAAA,EAC3E;AACA,SAAO,GAAG,QAAQ,kBAAkB,OAAO,QAAQ,aAAa,CAAC;AACnE;","names":[]}