@spotpatch/shared 1.11.0 → 1.13.0

package/dist/external-agent-node.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/external-agent-node.ts"],"sourcesContent":["/// <reference types=\"node\" />\n\nimport { createHash } from \"node:crypto\";\nimport { lstat, mkdir, realpath } from \"node:fs/promises\";\nimport os from \"node:os\";\nimport path from \"node:path\";\n\nimport { z } from \"zod\";\n\nimport {\n  EXTERNAL_HANDOFF_ACTIVE_ADAPTER_KINDS,\n  EXTERNAL_HANDOFF_BROKER_PROTOCOL_VERSION,\n  EXTERNAL_HANDOFF_FRAMEWORKS,\n  EXTERNAL_HANDOFF_LIMITS,\n  activeAdapterSummarySchema,\n  dispatchSummarySchema,\n  externalHandoffReportableDispatchPhaseSchema,\n  externalHandoffSnapshotSchema,\n  externalHandoffSummarySchema,\n  type ActiveAdapterSummary,\n  type DispatchSummary,\n  type ExternalHandoffSnapshot,\n} from \"./protocol/external-handoff.js\";\nimport { ERROR_CODES } from \"./errors/error-code.js\";\nimport { SpotPatchError } from \"./errors/spotpatch-error.js\";\n\nexport const SPOTPATCH_BRIDGE_TOKEN_HEADER = \"X-SpotPatch-Bridge-Token\" as const;\nexport const SPOTPATCH_BRIDGE_PATHS = Object.freeze({\n  status: \"/bridge/v1/status\",\n  current: \"/bridge/v1/handoff/current\",\n  wait: \"/bridge/v1/handoff/wait\",\n  ack: \"/bridge/v1/handoff/ack\",\n  activeClaim: \"/bridge/v1/active/claim\",\n  activeHeartbeat: \"/bridge/v1/active/heartbeat\",\n  activeReport: \"/bridge/v1/active/report\",\n  activeRelease: \"/bridge/v1/active/release\",\n});\nexport const EXTERNAL_HANDOFF_PROJECT_KEY_SALT =\n  \"spotpatch-external-agent-project-v1\" as const;\n\nconst opaqueIdSchema = z\n  .string()\n  .min(22)\n  .max(128)\n  .regex(/^[A-Za-z0-9_-]+$/u);\nconst projectKeySchema = z\n  .string()\n  .length(64)\n  .regex(/^[a-f0-9]+$/u);\nconst loopbackEndpointSchema = z.url().refine((value) => {\n  const match = /^http:\\/\\/127\\.0\\.0\\.1:([1-9][0-9]{0,4})$/u.exec(value);\n\n  if (match?.[1] === undefined) {\n    return false;\n  }\n\n  const port = Number(match[1]);\n  return Number.isSafeInteger(port) && port <= 65_535;\n});\n\nexport const externalHandoffDescriptorSchema = z.strictObject({\n  schemaVersion: z.literal(1),\n  brokerProtocolVersion: z.literal(EXTERNAL_HANDOFF_BROKER_PROTOCOL_VERSION),\n  projectKey: projectKeySchema,\n  sessionId: opaqueIdSchema,\n  framework: z.enum(EXTERNAL_HANDOFF_FRAMEWORKS),\n  endpoint: loopbackEndpointSchema,\n  bridgeToken: z\n    .string()\n    .min(43)\n    .max(128)\n    .regex(/^[A-Za-z0-9_-]+$/u),\n  pid: z.number().int().positive(),\n  createdAt: z.iso.datetime(),\n});\n\nexport const bridgeStatusRequestSchema = z.strictObject({});\nexport const bridgeCurrentRequestSchema = z.strictObject({\n  cursor: opaqueIdSchema.optional(),\n});\nexport const bridgeWaitRequestSchema = z.strictObject({\n  afterCursor: opaqueIdSchema.optional(),\n  timeoutMs: z\n    .number()\n    .int()\n    .positive()\n    .max(EXTERNAL_HANDOFF_LIMITS.maximumWaitMs)\n    .default(EXTERNAL_HANDOFF_LIMITS.defaultWaitMs),\n});\nexport const bridgeAckRequestSchema = z.strictObject({\n  cursor: opaqueIdSchema,\n  connectorInstanceId: opaqueIdSchema,\n});\nexport const bridgeActiveClaimRequestSchema = z.strictObject({\n  adapterKind: z.enum(EXTERNAL_HANDOFF_ACTIVE_ADAPTER_KINDS),\n  connectorInstanceId: opaqueIdSchema,\n});\nexport const bridgeActiveHeartbeatRequestSchema = z.strictObject({\n  leaseToken: opaqueIdSchema,\n});\nexport const bridgeActiveReportRequestSchema = z.strictObject({\n  leaseToken: opaqueIdSchema,\n  cursor: opaqueIdSchema,\n  phase: externalHandoffReportableDispatchPhaseSchema,\n});\nexport const bridgeActiveReleaseRequestSchema = z.strictObject({\n  leaseToken: opaqueIdSchema,\n});\nexport const bridgeStatusSchema = z.strictObject({\n  brokerProtocolVersion: z.literal(EXTERNAL_HANDOFF_BROKER_PROTOCOL_VERSION),\n  projectKey: projectKeySchema,\n  sessionId: opaqueIdSchema,\n  framework: z.enum(EXTERNAL_HANDOFF_FRAMEWORKS),\n  current: externalHandoffSummarySchema.nullable(),\n});\nexport const bridgeCurrentResultSchema = z.strictObject({\n  outcome: z.literal(\"handoff\"),\n  snapshot: externalHandoffSnapshotSchema,\n});\nexport const bridgeWaitResultSchema = z.discriminatedUnion(\"outcome\", [\n  bridgeCurrentResultSchema,\n  z.strictObject({ outcome: z.literal(\"timeout\") }),\n]);\nexport const bridgeAckResultSchema = z.strictObject({\n  summary: externalHandoffSummarySchema,\n});\nexport const bridgeActiveClaimResultSchema = z.strictObject({\n  leaseToken: opaqueIdSchema,\n  heartbeatIntervalMs: z.literal(EXTERNAL_HANDOFF_LIMITS.activeHeartbeatIntervalMs),\n  baselineCursor: opaqueIdSchema.nullable(),\n  activeAdapter: activeAdapterSummarySchema,\n});\nexport const bridgeActiveStateResultSchema = z.strictObject({\n  activeAdapter: activeAdapterSummarySchema.nullable(),\n  dispatch: dispatchSummarySchema.nullable(),\n});\nexport const bridgeActiveHeartbeatResultSchema = bridgeActiveStateResultSchema;\nexport const bridgeActiveReportResultSchema = bridgeActiveStateResultSchema;\nexport const bridgeActiveReleaseResultSchema = bridgeActiveStateResultSchema;\n\nexport type ExternalHandoffDescriptor = z.infer<typeof externalHandoffDescriptorSchema>;\nexport type BridgeStatus = z.infer<typeof bridgeStatusSchema>;\nexport type BridgeWaitResult =\n  | Readonly<{ outcome: \"handoff\"; snapshot: ExternalHandoffSnapshot }>\n  | Readonly<{ outcome: \"timeout\" }>;\nexport interface BridgeActiveClaimResult {\n  readonly leaseToken: string;\n  readonly heartbeatIntervalMs: typeof EXTERNAL_HANDOFF_LIMITS.activeHeartbeatIntervalMs;\n  readonly baselineCursor: string | null;\n  readonly activeAdapter: ActiveAdapterSummary;\n}\nexport interface BridgeActiveStateResult {\n  readonly activeAdapter: ActiveAdapterSummary | null;\n  readonly dispatch: DispatchSummary | null;\n}\n\nfunction currentUid(): number {\n  const uid = process.getuid?.();\n\n  if (uid === undefined) {\n    throw new SpotPatchError(ERROR_CODES.BRIDGE_UNAUTHORIZED);\n  }\n\n  return uid;\n}\n\nasync function assertPrivateDirectory(directory: string, uid: number): Promise<void> {\n  const status = await lstat(directory);\n\n  if (\n    !status.isDirectory() ||\n    status.isSymbolicLink() ||\n    status.uid !== uid ||\n    (status.mode & 0o077) !== 0\n  ) {\n    throw new SpotPatchError(ERROR_CODES.BRIDGE_UNAUTHORIZED);\n  }\n}\n\nasync function ensurePrivateSubdirectory(\n  base: string,\n  uid: number,\n  create: boolean,\n): Promise<string> {\n  const directory = path.join(base, \"spotpatch\");\n\n  if (create) {\n    try {\n      await mkdir(directory, { mode: 0o700 });\n    } catch (error: unknown) {\n      if ((error as NodeJS.ErrnoException).code !== \"EEXIST\") {\n        throw error;\n      }\n    }\n  }\n\n  await assertPrivateDirectory(directory, uid);\n  return directory;\n}\n\nexport async function resolveExternalHandoffRuntimeDirectory(\n  create: boolean,\n): Promise<string> {\n  if (process.platform === \"win32\") {\n    throw new SpotPatchError(ERROR_CODES.BRIDGE_UNAUTHORIZED);\n  }\n\n  const uid = currentUid();\n  const xdgRuntimeDirectory = process.env.XDG_RUNTIME_DIR;\n\n  if (xdgRuntimeDirectory !== undefined && !path.isAbsolute(xdgRuntimeDirectory)) {\n    throw new SpotPatchError(ERROR_CODES.BRIDGE_UNAUTHORIZED);\n  }\n\n  if (xdgRuntimeDirectory !== undefined) {\n    try {\n      await assertPrivateDirectory(xdgRuntimeDirectory, uid);\n      return await ensurePrivateSubdirectory(xdgRuntimeDirectory, uid, create);\n    } catch (error: unknown) {\n      if (!create && (error as NodeJS.ErrnoException).code === \"ENOENT\") {\n        throw new SpotPatchError(ERROR_CODES.SESSION_NOT_FOUND);\n      }\n\n      throw error;\n    }\n  }\n\n  const fallback = path.join(os.tmpdir(), `spotpatch-${String(uid)}`);\n\n  if (create) {\n    try {\n      await mkdir(fallback, { mode: 0o700 });\n    } catch (error: unknown) {\n      if ((error as NodeJS.ErrnoException).code !== \"EEXIST\") {\n        throw error;\n      }\n    }\n  }\n\n  try {\n    await assertPrivateDirectory(fallback, uid);\n  } catch (error: unknown) {\n    if (!create && (error as NodeJS.ErrnoException).code === \"ENOENT\") {\n      throw new SpotPatchError(ERROR_CODES.SESSION_NOT_FOUND);\n    }\n\n    throw error;\n  }\n\n  return fallback;\n}\n\nexport async function computeExternalHandoffProjectKey(root: string): Promise<string> {\n  const canonicalRoot = await realpath(root);\n  return createHash(\"sha256\")\n    .update(`${EXTERNAL_HANDOFF_PROJECT_KEY_SALT}\\0${canonicalRoot}`)\n    .digest(\"hex\");\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/external-agent-node.ts"],"sourcesContent":["/// <reference types=\"node\" />\n\nimport { createHash } from \"node:crypto\";\nimport { lstat, mkdir, realpath } from \"node:fs/promises\";\nimport os from \"node:os\";\nimport path from \"node:path\";\n\nimport { z } from \"zod\";\n\nimport {\n  EXTERNAL_HANDOFF_ACTIVE_ADAPTER_KINDS,\n  EXTERNAL_HANDOFF_BROKER_PROTOCOL_VERSION,\n  EXTERNAL_HANDOFF_FRAMEWORKS,\n  EXTERNAL_HANDOFF_LIMITS,\n  activeAdapterSummarySchema,\n  dispatchSummarySchema,\n  externalHandoffReportableDispatchPhaseSchema,\n  externalHandoffSnapshotSchema,\n  externalHandoffSummarySchema,\n  type ActiveAdapterSummary,\n  type DispatchSummary,\n  type ExternalHandoffSnapshot,\n} from \"./protocol/external-handoff.js\";\nimport { ERROR_CODES } from \"./errors/error-code.js\";\nimport { SpotPatchError } from \"./errors/spotpatch-error.js\";\n\nexport const SPOTPATCH_BRIDGE_TOKEN_HEADER = \"X-SpotPatch-Bridge-Token\" as const;\nexport const SPOTPATCH_BRIDGE_PATHS = Object.freeze({\n  status: \"/bridge/v1/status\",\n  current: \"/bridge/v1/handoff/current\",\n  wait: \"/bridge/v1/handoff/wait\",\n  ack: \"/bridge/v1/handoff/ack\",\n  activeClaim: \"/bridge/v1/active/claim\",\n  activeHeartbeat: \"/bridge/v1/active/heartbeat\",\n  activeReport: \"/bridge/v1/active/report\",\n  activeRelease: \"/bridge/v1/active/release\",\n});\nexport const EXTERNAL_HANDOFF_PROJECT_KEY_SALT =\n  \"spotpatch-external-agent-project-v1\" as const;\n\nconst opaqueIdSchema = z\n  .string()\n  .min(22)\n  .max(128)\n  .regex(/^[A-Za-z0-9_-]+$/u);\nconst projectKeySchema = z\n  .string()\n  .length(64)\n  .regex(/^[a-f0-9]+$/u);\nconst loopbackEndpointSchema = z.url().refine((value) => {\n  const match = /^http:\\/\\/127\\.0\\.0\\.1:([1-9][0-9]{0,4})$/u.exec(value);\n\n  if (match?.[1] === undefined) {\n    return false;\n  }\n\n  const port = Number(match[1]);\n  return Number.isSafeInteger(port) && port <= 65_535;\n});\n\nexport const externalHandoffDescriptorSchema = z.strictObject({\n  schemaVersion: z.literal(1),\n  brokerProtocolVersion: z.literal(EXTERNAL_HANDOFF_BROKER_PROTOCOL_VERSION),\n  projectKey: projectKeySchema,\n  sessionId: opaqueIdSchema,\n  framework: z.enum(EXTERNAL_HANDOFF_FRAMEWORKS),\n  endpoint: loopbackEndpointSchema,\n  bridgeToken: z\n    .string()\n    .min(43)\n    .max(128)\n    .regex(/^[A-Za-z0-9_-]+$/u),\n  pid: z.number().int().positive(),\n  createdAt: z.iso.datetime(),\n});\n\nexport const bridgeStatusRequestSchema = z.strictObject({});\nexport const bridgeCurrentRequestSchema = z.strictObject({\n  cursor: opaqueIdSchema.optional(),\n});\nexport const bridgeWaitRequestSchema = z.strictObject({\n  afterCursor: opaqueIdSchema.optional(),\n  timeoutMs: z\n    .number()\n    .int()\n    .positive()\n    .max(EXTERNAL_HANDOFF_LIMITS.maximumWaitMs)\n    .default(EXTERNAL_HANDOFF_LIMITS.defaultWaitMs),\n});\nexport const bridgeAckRequestSchema = z.strictObject({\n  cursor: opaqueIdSchema,\n  connectorInstanceId: opaqueIdSchema,\n});\nexport const bridgeActiveClaimRequestSchema = z.strictObject({\n  adapterKind: z.enum(EXTERNAL_HANDOFF_ACTIVE_ADAPTER_KINDS),\n  connectorInstanceId: opaqueIdSchema,\n});\nexport const bridgeActiveHeartbeatRequestSchema = z.strictObject({\n  leaseToken: opaqueIdSchema,\n});\nexport const bridgeActiveReportRequestSchema = z.strictObject({\n  leaseToken: opaqueIdSchema,\n  cursor: opaqueIdSchema,\n  phase: externalHandoffReportableDispatchPhaseSchema,\n});\nexport const bridgeActiveReleaseRequestSchema = z.strictObject({\n  leaseToken: opaqueIdSchema,\n});\nexport const bridgeStatusSchema = z.strictObject({\n  brokerProtocolVersion: z.literal(EXTERNAL_HANDOFF_BROKER_PROTOCOL_VERSION),\n  projectKey: projectKeySchema,\n  sessionId: opaqueIdSchema,\n  framework: z.enum(EXTERNAL_HANDOFF_FRAMEWORKS),\n  current: externalHandoffSummarySchema.nullable(),\n});\nexport const bridgeCurrentResultSchema = z.strictObject({\n  outcome: z.literal(\"handoff\"),\n  snapshot: externalHandoffSnapshotSchema,\n});\nexport const bridgeWaitResultSchema = z.discriminatedUnion(\"outcome\", [\n  bridgeCurrentResultSchema,\n  z.strictObject({ outcome: z.literal(\"timeout\") }),\n]);\nexport const bridgeAckResultSchema = z.strictObject({\n  summary: externalHandoffSummarySchema,\n});\nexport const bridgeActiveClaimResultSchema = z.strictObject({\n  leaseToken: opaqueIdSchema,\n  heartbeatIntervalMs: z.literal(EXTERNAL_HANDOFF_LIMITS.activeHeartbeatIntervalMs),\n  baselineCursor: opaqueIdSchema.nullable(),\n  activeAdapter: activeAdapterSummarySchema,\n});\nexport const bridgeActiveStateResultSchema = z.strictObject({\n  activeAdapter: activeAdapterSummarySchema.nullable(),\n  dispatch: dispatchSummarySchema.nullable(),\n});\nexport const bridgeActiveHeartbeatResultSchema = bridgeActiveStateResultSchema;\nexport const bridgeActiveReportResultSchema = bridgeActiveStateResultSchema;\nexport const bridgeActiveReleaseResultSchema = bridgeActiveStateResultSchema;\n\nexport type ExternalHandoffDescriptor = z.infer<typeof externalHandoffDescriptorSchema>;\nexport type BridgeStatus = z.infer<typeof bridgeStatusSchema>;\nexport type BridgeWaitResult =\n  | Readonly<{ outcome: \"handoff\"; snapshot: ExternalHandoffSnapshot }>\n  | Readonly<{ outcome: \"timeout\" }>;\nexport interface BridgeActiveClaimResult {\n  readonly leaseToken: string;\n  readonly heartbeatIntervalMs: typeof EXTERNAL_HANDOFF_LIMITS.activeHeartbeatIntervalMs;\n  readonly baselineCursor: string | null;\n  readonly activeAdapter: ActiveAdapterSummary;\n}\nexport interface BridgeActiveStateResult {\n  readonly activeAdapter: ActiveAdapterSummary | null;\n  readonly dispatch: DispatchSummary | null;\n}\n\nfunction currentUid(): number {\n  const uid = process.getuid?.();\n\n  if (uid === undefined) {\n    throw new SpotPatchError(ERROR_CODES.BRIDGE_UNAUTHORIZED);\n  }\n\n  return uid;\n}\n\nasync function assertPrivateDirectory(directory: string, uid: number): Promise<void> {\n  const status = await lstat(directory);\n\n  if (\n    !status.isDirectory() ||\n    status.isSymbolicLink() ||\n    status.uid !== uid ||\n    (status.mode & 0o077) !== 0\n  ) {\n    throw new SpotPatchError(ERROR_CODES.BRIDGE_UNAUTHORIZED);\n  }\n}\n\nasync function ensurePrivateSubdirectory(\n  base: string,\n  uid: number,\n  create: boolean,\n): Promise<string> {\n  const directory = path.join(base, \"spotpatch\");\n\n  if (create) {\n    try {\n      await mkdir(directory, { mode: 0o700 });\n    } catch (error: unknown) {\n      if ((error as NodeJS.ErrnoException).code !== \"EEXIST\") {\n        throw error;\n      }\n    }\n  }\n\n  await assertPrivateDirectory(directory, uid);\n  return directory;\n}\n\nexport async function resolveExternalHandoffRuntimeDirectory(\n  create: boolean,\n): Promise<string> {\n  if (process.platform === \"win32\") {\n    throw new SpotPatchError(ERROR_CODES.BRIDGE_UNAUTHORIZED);\n  }\n\n  const uid = currentUid();\n  const xdgRuntimeDirectory = process.env.XDG_RUNTIME_DIR;\n\n  if (xdgRuntimeDirectory !== undefined && !path.isAbsolute(xdgRuntimeDirectory)) {\n    throw new SpotPatchError(ERROR_CODES.BRIDGE_UNAUTHORIZED);\n  }\n\n  if (xdgRuntimeDirectory !== undefined) {\n    try {\n      await assertPrivateDirectory(xdgRuntimeDirectory, uid);\n      return await ensurePrivateSubdirectory(xdgRuntimeDirectory, uid, create);\n    } catch (error: unknown) {\n      if (!create && (error as NodeJS.ErrnoException).code === \"ENOENT\") {\n        throw new SpotPatchError(ERROR_CODES.SESSION_NOT_FOUND);\n      }\n\n      throw error;\n    }\n  }\n\n  const fallback = path.join(os.tmpdir(), `spotpatch-${String(uid)}`);\n\n  if (create) {\n    try {\n      await mkdir(fallback, { mode: 0o700 });\n    } catch (error: unknown) {\n      if ((error as NodeJS.ErrnoException).code !== \"EEXIST\") {\n        throw error;\n      }\n    }\n  }\n\n  try {\n    await assertPrivateDirectory(fallback, uid);\n  } catch (error: unknown) {\n    if (!create && (error as NodeJS.ErrnoException).code === \"ENOENT\") {\n      throw new SpotPatchError(ERROR_CODES.SESSION_NOT_FOUND);\n    }\n\n    throw error;\n  }\n\n  return fallback;\n}\n\nexport async function computeExternalHandoffProjectKey(root: string): Promise<string> {\n  const canonicalRoot = await realpath(root);\n  return createHash(\"sha256\")\n    .update(`${EXTERNAL_HANDOFF_PROJECT_KEY_SALT}\\0${canonicalRoot}`)\n    .digest(\"hex\");\n}\n"],"mappings":"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","names":[]}

package/dist/{external-handoff--lT9XQEw.d.ts → external-handoff-DighrWn8.d.ts}

@@ -1,105 +1,5 @@
 import { z } from 'zod';
-
-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;
-}
+import { S as SpotAnnotation } from './annotation-C0Me9mN2.js';
 
 declare const EXTERNAL_HANDOFF_SNAPSHOT_SCHEMA_VERSION: 1;
 declare const EXTERNAL_HANDOFF_BROKER_PROTOCOL_VERSION: 2;
@@ -144,11 +44,11 @@ type ExternalHandoffDispatchPhase = (typeof EXTERNAL_HANDOFF_DISPATCH_PHASES)[nu
 type ExternalHandoffReportableDispatchPhase = (typeof EXTERNAL_HANDOFF_REPORTABLE_DISPATCH_PHASES)[number];
 
 declare const externalHandoffReportableDispatchPhaseSchema: z.ZodEnum<{
-    dispatching: "dispatching";
+    failed: "failed";
     dispatched: "dispatched";
-    working: "working";
     completed: "completed";
-    failed: "failed";
+    dispatching: "dispatching";
+    working: "working";
     "delivery-unknown": "delivery-unknown";
 }>;
 declare const externalHandoffSummarySchema: z.ZodObject<{
@@ -167,8 +67,8 @@ declare const externalHandoffSummarySchema: z.ZodObject<{
     publishedAt: z.ZodISODateTime;
     expiresAt: z.ZodISODateTime;
     state: z.ZodEnum<{
-        available: "available";
         expired: "expired";
+        available: "available";
         superseded: "superseded";
     }>;
     pickupCount: z.ZodNumber;
@@ -307,8 +207,8 @@ declare const activeAdapterSummarySchema: z.ZodObject<{
     }>;
     state: z.ZodEnum<{
         ready: "ready";
-        busy: "busy";
         blocked: "blocked";
+        busy: "busy";
     }>;
     canDispatch: z.ZodBoolean;
     connectedAt: z.ZodISODateTime;
@@ -321,13 +221,13 @@ declare const dispatchSummarySchema: z.ZodObject<{
     }>;
     revision: z.ZodNumber;
     phase: z.ZodEnum<{
-        dispatching: "dispatching";
+        queued: "queued";
+        failed: "failed";
         dispatched: "dispatched";
-        working: "working";
         completed: "completed";
-        failed: "failed";
+        dispatching: "dispatching";
+        working: "working";
         "delivery-unknown": "delivery-unknown";
-        queued: "queued";
     }>;
     updatedAt: z.ZodISODateTime;
 }, z.core.$strict>;
@@ -467,8 +367,8 @@ declare const externalHandoffCapabilitySchema: z.ZodObject<{
         }>;
         state: z.ZodEnum<{
             ready: "ready";
-            busy: "busy";
             blocked: "blocked";
+            busy: "busy";
         }>;
         canDispatch: z.ZodBoolean;
         connectedAt: z.ZodISODateTime;
@@ -481,13 +381,13 @@ declare const externalHandoffCapabilitySchema: z.ZodObject<{
         }>;
         revision: z.ZodNumber;
         phase: z.ZodEnum<{
-            dispatching: "dispatching";
+            queued: "queued";
+            failed: "failed";
             dispatched: "dispatched";
-            working: "working";
             completed: "completed";
-            failed: "failed";
+            dispatching: "dispatching";
+            working: "working";
             "delivery-unknown": "delivery-unknown";
-            queued: "queued";
         }>;
         updatedAt: z.ZodISODateTime;
     }, z.core.$strict>>;
@@ -503,8 +403,8 @@ declare const externalHandoffPublishDeliverySchema: z.ZodDiscriminatedUnion<[z.Z
         }>;
         state: z.ZodEnum<{
             ready: "ready";
-            busy: "busy";
             blocked: "blocked";
+            busy: "busy";
         }>;
         canDispatch: z.ZodBoolean;
         connectedAt: z.ZodISODateTime;
@@ -517,13 +417,13 @@ declare const externalHandoffPublishDeliverySchema: z.ZodDiscriminatedUnion<[z.Z
         }>;
         revision: z.ZodNumber;
         phase: z.ZodEnum<{
-            dispatching: "dispatching";
+            queued: "queued";
+            failed: "failed";
             dispatched: "dispatched";
-            working: "working";
             completed: "completed";
-            failed: "failed";
+            dispatching: "dispatching";
+            working: "working";
             "delivery-unknown": "delivery-unknown";
-            queued: "queued";
         }>;
         updatedAt: z.ZodISODateTime;
     }, z.core.$strict>;
@@ -545,8 +445,8 @@ declare const externalHandoffPublishResultSchema: z.ZodObject<{
         publishedAt: z.ZodISODateTime;
         expiresAt: z.ZodISODateTime;
         state: z.ZodEnum<{
-            available: "available";
             expired: "expired";
+            available: "available";
             superseded: "superseded";
         }>;
         pickupCount: z.ZodNumber;
@@ -563,8 +463,8 @@ declare const externalHandoffPublishResultSchema: z.ZodObject<{
             }>;
             state: z.ZodEnum<{
                 ready: "ready";
-                busy: "busy";
                 blocked: "blocked";
+                busy: "busy";
             }>;
             canDispatch: z.ZodBoolean;
             connectedAt: z.ZodISODateTime;
@@ -577,13 +477,13 @@ declare const externalHandoffPublishResultSchema: z.ZodObject<{
             }>;
             revision: z.ZodNumber;
             phase: z.ZodEnum<{
-                dispatching: "dispatching";
+                queued: "queued";
+                failed: "failed";
                 dispatched: "dispatched";
-                working: "working";
                 completed: "completed";
-                failed: "failed";
+                dispatching: "dispatching";
+                working: "working";
                 "delivery-unknown": "delivery-unknown";
-                queued: "queued";
             }>;
             updatedAt: z.ZodISODateTime;
         }, z.core.$strict>;
@@ -607,8 +507,8 @@ declare const externalHandoffStatusResultSchema: z.ZodObject<{
         publishedAt: z.ZodISODateTime;
         expiresAt: z.ZodISODateTime;
         state: z.ZodEnum<{
-            available: "available";
             expired: "expired";
+            available: "available";
             superseded: "superseded";
         }>;
         pickupCount: z.ZodNumber;
@@ -621,8 +521,8 @@ declare const externalHandoffStatusResultSchema: z.ZodObject<{
         }>;
         state: z.ZodEnum<{
             ready: "ready";
-            busy: "busy";
             blocked: "blocked";
+            busy: "busy";
         }>;
         canDispatch: z.ZodBoolean;
         connectedAt: z.ZodISODateTime;
@@ -635,13 +535,13 @@ declare const externalHandoffStatusResultSchema: z.ZodObject<{
         }>;
         revision: z.ZodNumber;
         phase: z.ZodEnum<{
-            dispatching: "dispatching";
+            queued: "queued";
+            failed: "failed";
             dispatched: "dispatched";
-            working: "working";
             completed: "completed";
-            failed: "failed";
+            dispatching: "dispatching";
+            working: "working";
             "delivery-unknown": "delivery-unknown";
-            queued: "queued";
         }>;
         updatedAt: z.ZodISODateTime;
     }, z.core.$strict>>;
@@ -717,4 +617,4 @@ type ExternalHandoffPublishRequest = z.infer<typeof externalHandoffPublishReques
 type ExternalHandoffStatusRequest = z.infer<typeof externalHandoffStatusRequestSchema>;
 type ExternalHandoffResolveDeliveryRequest = z.infer<typeof externalHandoffResolveDeliveryRequestSchema>;
 
-export { externalHandoffResolveDeliveryRequestSchema as $, type ActiveAdapterSummary as A, type ElementContext as B, type ContextBudget as C, type DispatchSummary as D, EXTERNAL_HANDOFF_LIMITS as E, MAX_ANNOTATION_TARGETS as F, MAX_TARGET_INSTRUCTION_CHARACTERS as G, type MatchedStyleRule as H, SPOTPATCH_LOCALES as I, type SourceConfidence as J, type SourceOrigin as K, type SourceRef as L, MAX_ANNOTATION_INSTRUCTION_CHARACTERS as M, type SpotPatchLocalePreference as N, type SpotTargetContext as O, type PageContext as P, type StyleContext as Q, type ReactContext as R, type SpotAnnotation as S, activeAdapterSummarySchema as T, dispatchSummarySchema as U, externalHandoffCapabilityRequestSchema as V, externalHandoffCapabilitySchema as W, externalHandoffPublishDeliverySchema as X, externalHandoffPublishRequestSchema as Y, externalHandoffPublishResultSchema as Z, externalHandoffReportableDispatchPhaseSchema as _, type ExternalHandoffSnapshot as a, externalHandoffSnapshotSchema as a0, externalHandoffStatusRequestSchema as a1, externalHandoffStatusResultSchema as a2, externalHandoffSummarySchema as a3, EXTERNAL_HANDOFF_ACTIVE_ADAPTER_KINDS as b, EXTERNAL_HANDOFF_ACTIVE_ADAPTER_STATES as c, EXTERNAL_HANDOFF_BROKER_PROTOCOL_VERSION as d, EXTERNAL_HANDOFF_DISPATCH_PHASES as e, EXTERNAL_HANDOFF_FRAMEWORKS as f, EXTERNAL_HANDOFF_REPORTABLE_DISPATCH_PHASES as g, EXTERNAL_HANDOFF_SNAPSHOT_SCHEMA_VERSION as h, EXTERNAL_HANDOFF_STATES as i, type ExternalHandoffActiveAdapterKind as j, type ExternalHandoffActiveAdapterState as k, type ExternalHandoffCapability as l, type ExternalHandoffDispatchPhase as m, type ExternalHandoffFramework as n, type ExternalHandoffPublishDelivery as o, type ExternalHandoffPublishRequest as p, type ExternalHandoffPublishResult as q, type ExternalHandoffReportableDispatchPhase as r, type ExternalHandoffResolveDeliveryRequest as s, type ExternalHandoffState as t, type ExternalHandoffStatusRequest as u, type ExternalHandoffStatusResult as v, type ExternalHandoffSummary as w, type SpotPatchLocale as x, SPOTPATCH_LOCALE_PREFERENCES as y, type CodeContext as z };
+export { type ActiveAdapterSummary as A, externalHandoffCapabilitySchema as B, externalHandoffPublishDeliverySchema as C, type DispatchSummary as D, EXTERNAL_HANDOFF_LIMITS as E, externalHandoffPublishRequestSchema as F, externalHandoffPublishResultSchema as G, externalHandoffReportableDispatchPhaseSchema as H, externalHandoffResolveDeliveryRequestSchema as I, externalHandoffSnapshotSchema as J, externalHandoffStatusRequestSchema as K, externalHandoffStatusResultSchema as L, externalHandoffSummarySchema as M, type ExternalHandoffSnapshot as a, EXTERNAL_HANDOFF_ACTIVE_ADAPTER_KINDS as b, EXTERNAL_HANDOFF_ACTIVE_ADAPTER_STATES as c, EXTERNAL_HANDOFF_BROKER_PROTOCOL_VERSION as d, EXTERNAL_HANDOFF_DISPATCH_PHASES as e, EXTERNAL_HANDOFF_FRAMEWORKS as f, EXTERNAL_HANDOFF_REPORTABLE_DISPATCH_PHASES as g, EXTERNAL_HANDOFF_SNAPSHOT_SCHEMA_VERSION as h, EXTERNAL_HANDOFF_STATES as i, type ExternalHandoffActiveAdapterKind as j, type ExternalHandoffActiveAdapterState as k, type ExternalHandoffCapability as l, type ExternalHandoffDispatchPhase as m, type ExternalHandoffFramework as n, type ExternalHandoffPublishDelivery as o, type ExternalHandoffPublishRequest as p, type ExternalHandoffPublishResult as q, type ExternalHandoffReportableDispatchPhase as r, type ExternalHandoffResolveDeliveryRequest as s, type ExternalHandoffState as t, type ExternalHandoffStatusRequest as u, type ExternalHandoffStatusResult as v, type ExternalHandoffSummary as w, activeAdapterSummarySchema as x, dispatchSummarySchema as y, externalHandoffCapabilityRequestSchema as z };

package/dist/{external-handoff--lT9XQEw.d.cts → external-handoff-DwtFFR6F.d.cts}

@@ -1,105 +1,5 @@
 import { z } from 'zod';
-
-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;
-}
+import { S as SpotAnnotation } from './annotation-C0Me9mN2.cjs';
 
 declare const EXTERNAL_HANDOFF_SNAPSHOT_SCHEMA_VERSION: 1;
 declare const EXTERNAL_HANDOFF_BROKER_PROTOCOL_VERSION: 2;
@@ -144,11 +44,11 @@ type ExternalHandoffDispatchPhase = (typeof EXTERNAL_HANDOFF_DISPATCH_PHASES)[nu
 type ExternalHandoffReportableDispatchPhase = (typeof EXTERNAL_HANDOFF_REPORTABLE_DISPATCH_PHASES)[number];
 
 declare const externalHandoffReportableDispatchPhaseSchema: z.ZodEnum<{
-    dispatching: "dispatching";
+    failed: "failed";
     dispatched: "dispatched";
-    working: "working";
     completed: "completed";
-    failed: "failed";
+    dispatching: "dispatching";
+    working: "working";
     "delivery-unknown": "delivery-unknown";
 }>;
 declare const externalHandoffSummarySchema: z.ZodObject<{
@@ -167,8 +67,8 @@ declare const externalHandoffSummarySchema: z.ZodObject<{
     publishedAt: z.ZodISODateTime;
     expiresAt: z.ZodISODateTime;
     state: z.ZodEnum<{
-        available: "available";
         expired: "expired";
+        available: "available";
         superseded: "superseded";
     }>;
     pickupCount: z.ZodNumber;
@@ -307,8 +207,8 @@ declare const activeAdapterSummarySchema: z.ZodObject<{
     }>;
     state: z.ZodEnum<{
         ready: "ready";
-        busy: "busy";
         blocked: "blocked";
+        busy: "busy";
     }>;
     canDispatch: z.ZodBoolean;
     connectedAt: z.ZodISODateTime;
@@ -321,13 +221,13 @@ declare const dispatchSummarySchema: z.ZodObject<{
     }>;
     revision: z.ZodNumber;
     phase: z.ZodEnum<{
-        dispatching: "dispatching";
+        queued: "queued";
+        failed: "failed";
         dispatched: "dispatched";
-        working: "working";
         completed: "completed";
-        failed: "failed";
+        dispatching: "dispatching";
+        working: "working";
         "delivery-unknown": "delivery-unknown";
-        queued: "queued";
     }>;
     updatedAt: z.ZodISODateTime;
 }, z.core.$strict>;
@@ -467,8 +367,8 @@ declare const externalHandoffCapabilitySchema: z.ZodObject<{
         }>;
         state: z.ZodEnum<{
             ready: "ready";
-            busy: "busy";
             blocked: "blocked";
+            busy: "busy";
         }>;
         canDispatch: z.ZodBoolean;
         connectedAt: z.ZodISODateTime;
@@ -481,13 +381,13 @@ declare const externalHandoffCapabilitySchema: z.ZodObject<{
         }>;
         revision: z.ZodNumber;
         phase: z.ZodEnum<{
-            dispatching: "dispatching";
+            queued: "queued";
+            failed: "failed";
             dispatched: "dispatched";
-            working: "working";
             completed: "completed";
-            failed: "failed";
+            dispatching: "dispatching";
+            working: "working";
             "delivery-unknown": "delivery-unknown";
-            queued: "queued";
         }>;
         updatedAt: z.ZodISODateTime;
     }, z.core.$strict>>;
@@ -503,8 +403,8 @@ declare const externalHandoffPublishDeliverySchema: z.ZodDiscriminatedUnion<[z.Z
         }>;
         state: z.ZodEnum<{
             ready: "ready";
-            busy: "busy";
             blocked: "blocked";
+            busy: "busy";
         }>;
         canDispatch: z.ZodBoolean;
         connectedAt: z.ZodISODateTime;
@@ -517,13 +417,13 @@ declare const externalHandoffPublishDeliverySchema: z.ZodDiscriminatedUnion<[z.Z
         }>;
         revision: z.ZodNumber;
         phase: z.ZodEnum<{
-            dispatching: "dispatching";
+            queued: "queued";
+            failed: "failed";
             dispatched: "dispatched";
-            working: "working";
             completed: "completed";
-            failed: "failed";
+            dispatching: "dispatching";
+            working: "working";
             "delivery-unknown": "delivery-unknown";
-            queued: "queued";
         }>;
         updatedAt: z.ZodISODateTime;
     }, z.core.$strict>;
@@ -545,8 +445,8 @@ declare const externalHandoffPublishResultSchema: z.ZodObject<{
         publishedAt: z.ZodISODateTime;
         expiresAt: z.ZodISODateTime;
         state: z.ZodEnum<{
-            available: "available";
             expired: "expired";
+            available: "available";
             superseded: "superseded";
         }>;
         pickupCount: z.ZodNumber;
@@ -563,8 +463,8 @@ declare const externalHandoffPublishResultSchema: z.ZodObject<{
             }>;
             state: z.ZodEnum<{
                 ready: "ready";
-                busy: "busy";
                 blocked: "blocked";
+                busy: "busy";
             }>;
             canDispatch: z.ZodBoolean;
             connectedAt: z.ZodISODateTime;
@@ -577,13 +477,13 @@ declare const externalHandoffPublishResultSchema: z.ZodObject<{
             }>;
             revision: z.ZodNumber;
             phase: z.ZodEnum<{
-                dispatching: "dispatching";
+                queued: "queued";
+                failed: "failed";
                 dispatched: "dispatched";
-                working: "working";
                 completed: "completed";
-                failed: "failed";
+                dispatching: "dispatching";
+                working: "working";
                 "delivery-unknown": "delivery-unknown";
-                queued: "queued";
             }>;
             updatedAt: z.ZodISODateTime;
         }, z.core.$strict>;
@@ -607,8 +507,8 @@ declare const externalHandoffStatusResultSchema: z.ZodObject<{
         publishedAt: z.ZodISODateTime;
         expiresAt: z.ZodISODateTime;
         state: z.ZodEnum<{
-            available: "available";
             expired: "expired";
+            available: "available";
             superseded: "superseded";
         }>;
         pickupCount: z.ZodNumber;
@@ -621,8 +521,8 @@ declare const externalHandoffStatusResultSchema: z.ZodObject<{
         }>;
         state: z.ZodEnum<{
             ready: "ready";
-            busy: "busy";
             blocked: "blocked";
+            busy: "busy";
         }>;
         canDispatch: z.ZodBoolean;
         connectedAt: z.ZodISODateTime;
@@ -635,13 +535,13 @@ declare const externalHandoffStatusResultSchema: z.ZodObject<{
         }>;
         revision: z.ZodNumber;
         phase: z.ZodEnum<{
-            dispatching: "dispatching";
+            queued: "queued";
+            failed: "failed";
             dispatched: "dispatched";
-            working: "working";
             completed: "completed";
-            failed: "failed";
+            dispatching: "dispatching";
+            working: "working";
             "delivery-unknown": "delivery-unknown";
-            queued: "queued";
         }>;
         updatedAt: z.ZodISODateTime;
     }, z.core.$strict>>;
@@ -717,4 +617,4 @@ type ExternalHandoffPublishRequest = z.infer<typeof externalHandoffPublishReques
 type ExternalHandoffStatusRequest = z.infer<typeof externalHandoffStatusRequestSchema>;
 type ExternalHandoffResolveDeliveryRequest = z.infer<typeof externalHandoffResolveDeliveryRequestSchema>;
 
-export { externalHandoffResolveDeliveryRequestSchema as $, type ActiveAdapterSummary as A, type ElementContext as B, type ContextBudget as C, type DispatchSummary as D, EXTERNAL_HANDOFF_LIMITS as E, MAX_ANNOTATION_TARGETS as F, MAX_TARGET_INSTRUCTION_CHARACTERS as G, type MatchedStyleRule as H, SPOTPATCH_LOCALES as I, type SourceConfidence as J, type SourceOrigin as K, type SourceRef as L, MAX_ANNOTATION_INSTRUCTION_CHARACTERS as M, type SpotPatchLocalePreference as N, type SpotTargetContext as O, type PageContext as P, type StyleContext as Q, type ReactContext as R, type SpotAnnotation as S, activeAdapterSummarySchema as T, dispatchSummarySchema as U, externalHandoffCapabilityRequestSchema as V, externalHandoffCapabilitySchema as W, externalHandoffPublishDeliverySchema as X, externalHandoffPublishRequestSchema as Y, externalHandoffPublishResultSchema as Z, externalHandoffReportableDispatchPhaseSchema as _, type ExternalHandoffSnapshot as a, externalHandoffSnapshotSchema as a0, externalHandoffStatusRequestSchema as a1, externalHandoffStatusResultSchema as a2, externalHandoffSummarySchema as a3, EXTERNAL_HANDOFF_ACTIVE_ADAPTER_KINDS as b, EXTERNAL_HANDOFF_ACTIVE_ADAPTER_STATES as c, EXTERNAL_HANDOFF_BROKER_PROTOCOL_VERSION as d, EXTERNAL_HANDOFF_DISPATCH_PHASES as e, EXTERNAL_HANDOFF_FRAMEWORKS as f, EXTERNAL_HANDOFF_REPORTABLE_DISPATCH_PHASES as g, EXTERNAL_HANDOFF_SNAPSHOT_SCHEMA_VERSION as h, EXTERNAL_HANDOFF_STATES as i, type ExternalHandoffActiveAdapterKind as j, type ExternalHandoffActiveAdapterState as k, type ExternalHandoffCapability as l, type ExternalHandoffDispatchPhase as m, type ExternalHandoffFramework as n, type ExternalHandoffPublishDelivery as o, type ExternalHandoffPublishRequest as p, type ExternalHandoffPublishResult as q, type ExternalHandoffReportableDispatchPhase as r, type ExternalHandoffResolveDeliveryRequest as s, type ExternalHandoffState as t, type ExternalHandoffStatusRequest as u, type ExternalHandoffStatusResult as v, type ExternalHandoffSummary as w, type SpotPatchLocale as x, SPOTPATCH_LOCALE_PREFERENCES as y, type CodeContext as z };
+export { type ActiveAdapterSummary as A, externalHandoffCapabilitySchema as B, externalHandoffPublishDeliverySchema as C, type DispatchSummary as D, EXTERNAL_HANDOFF_LIMITS as E, externalHandoffPublishRequestSchema as F, externalHandoffPublishResultSchema as G, externalHandoffReportableDispatchPhaseSchema as H, externalHandoffResolveDeliveryRequestSchema as I, externalHandoffSnapshotSchema as J, externalHandoffStatusRequestSchema as K, externalHandoffStatusResultSchema as L, externalHandoffSummarySchema as M, type ExternalHandoffSnapshot as a, EXTERNAL_HANDOFF_ACTIVE_ADAPTER_KINDS as b, EXTERNAL_HANDOFF_ACTIVE_ADAPTER_STATES as c, EXTERNAL_HANDOFF_BROKER_PROTOCOL_VERSION as d, EXTERNAL_HANDOFF_DISPATCH_PHASES as e, EXTERNAL_HANDOFF_FRAMEWORKS as f, EXTERNAL_HANDOFF_REPORTABLE_DISPATCH_PHASES as g, EXTERNAL_HANDOFF_SNAPSHOT_SCHEMA_VERSION as h, EXTERNAL_HANDOFF_STATES as i, type ExternalHandoffActiveAdapterKind as j, type ExternalHandoffActiveAdapterState as k, type ExternalHandoffCapability as l, type ExternalHandoffDispatchPhase as m, type ExternalHandoffFramework as n, type ExternalHandoffPublishDelivery as o, type ExternalHandoffPublishRequest as p, type ExternalHandoffPublishResult as q, type ExternalHandoffReportableDispatchPhase as r, type ExternalHandoffResolveDeliveryRequest as s, type ExternalHandoffState as t, type ExternalHandoffStatusRequest as u, type ExternalHandoffStatusResult as v, type ExternalHandoffSummary as w, activeAdapterSummarySchema as x, dispatchSummarySchema as y, externalHandoffCapabilityRequestSchema as z };

package/dist/external-handoff-browser.cjs

@@ -126,6 +126,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`,