@guidelytech/shared 0.16.0 → 0.17.0

package/dist/index.cjs

@@ -42,6 +42,7 @@ __export(index_exports, {
   AuthoringPickSchema: () => AuthoringPickSchema,
   AutocaptureSettingsSchema: () => AutocaptureSettingsSchema,
   BUTTON_ACTIONS: () => BUTTON_ACTIONS,
+  BugReportSchema: () => BugReportSchema,
   ButtonSchema: () => ButtonSchema,
   CAPTURE_PARAM: () => CAPTURE_PARAM,
   CAPTURE_SCREENSHOT_MAX_BYTES: () => CAPTURE_SCREENSHOT_MAX_BYTES,
@@ -107,6 +108,10 @@ __export(index_exports, {
   LocaleSchema: () => LocaleSchema,
   LocalizationSettingsSchema: () => LocalizationSettingsSchema,
   MAX_ANNOTATIONS: () => MAX_ANNOTATIONS,
+  MAX_APP_VERSION_LENGTH: () => MAX_APP_VERSION_LENGTH,
+  MAX_BREADCRUMBS: () => MAX_BREADCRUMBS,
+  MAX_BUG_REPORT_LENGTH: () => MAX_BUG_REPORT_LENGTH,
+  MAX_BUG_REPORT_SCREENSHOT_BYTES: () => MAX_BUG_REPORT_SCREENSHOT_BYTES,
   MAX_COLLECTION_DEPTH: () => MAX_COLLECTION_DEPTH,
   MAX_COMPLAINT_ANSWER_LENGTH: () => MAX_COMPLAINT_ANSWER_LENGTH,
   MAX_COMPLAINT_ATTACHMENT_BYTES: () => MAX_COMPLAINT_ATTACHMENT_BYTES,
@@ -114,6 +119,13 @@ __export(index_exports, {
   MAX_COMPLAINT_FIELDS: () => MAX_COMPLAINT_FIELDS,
   MAX_COMPLAINT_LENGTH: () => MAX_COMPLAINT_LENGTH,
   MAX_CUSTOM_CSS: () => MAX_CUSTOM_CSS,
+  MAX_DEBUG_IMAGES: () => MAX_DEBUG_IMAGES,
+  MAX_DETAIL_FRAMES: () => MAX_DETAIL_FRAMES,
+  MAX_DETAIL_THREADS: () => MAX_DETAIL_THREADS,
+  MAX_ERROR_TAGS: () => MAX_ERROR_TAGS,
+  MAX_EXCEPTION_CHAIN: () => MAX_EXCEPTION_CHAIN,
+  MAX_EXCEPTION_DETAIL_BYTES: () => MAX_EXCEPTION_DETAIL_BYTES,
+  MAX_EXCEPTION_DETAIL_RAW_BYTES: () => MAX_EXCEPTION_DETAIL_RAW_BYTES,
   MAX_FEEDBACK_COMMENT: () => MAX_FEEDBACK_COMMENT,
   MAX_FEEDBACK_DESCRIPTION: () => MAX_FEEDBACK_DESCRIPTION,
   MAX_FEEDBACK_NOTE: () => MAX_FEEDBACK_NOTE,
@@ -141,6 +153,7 @@ __export(index_exports, {
   PDF_PAGES_CLASS: () => PDF_PAGES_CLASS,
   PLACEMENTS: () => PLACEMENTS,
   PLATFORMS: () => PLATFORMS,
+  PerformanceSettingsSchema: () => PerformanceSettingsSchema,
   PostMessageSchema: () => PostMessageSchema,
   ProjectThemeSchema: () => ProjectThemeSchema,
   PublishedGuideSchema: () => PublishedGuideSchema,
@@ -210,11 +223,13 @@ __export(index_exports, {
   contrastIssues: () => contrastIssues,
   contrastRatio: () => contrastRatio,
   cssSelectorError: () => cssSelectorError,
+  customFingerprint: () => customFingerprint,
   defaultGuideConfig: () => defaultGuideConfig,
   defaultStep: () => defaultStep,
   describeCaptureStep: () => describeCaptureStep,
   describeRule: () => describeRule,
   emptyRuleGroup: () => emptyRuleGroup,
+  errorFilterDrops: () => errorFilterDrops,
   evaluateRule: () => evaluateRule,
   evaluateRules: () => evaluateRules,
   evenWeights: () => evenWeights,
@@ -257,10 +272,12 @@ __export(index_exports, {
   mediaKind: () => mediaKind,
   mediaMaxBytes: () => mediaMaxBytes,
   needsReview: () => needsReview,
+  normalizeAppVersion: () => normalizeAppVersion,
   normalizeErrorMessage: () => normalizeErrorMessage,
   normalizeFrameFile: () => normalizeFrameFile,
   normalizeLocale: () => normalizeLocale,
   normalizeSnapshot: () => normalizeSnapshot,
+  normalizeTags: () => normalizeTags,
   orderedModules: () => orderedModules,
   pageLabel: () => pageLabel,
   pageName: () => pageName,
@@ -278,6 +295,7 @@ __export(index_exports, {
   propertyAttributeAllowed: () => propertyAttributeAllowed,
   queryConditionRegex: () => queryConditionRegex,
   randomId: () => randomId,
+  reactNativeBundleUrl: () => reactNativeBundleUrl,
   readableTextOn: () => readableTextOn,
   recordingLevel: () => recordingLevel,
   relativeLuminance: () => relativeLuminance,
@@ -308,6 +326,7 @@ __export(index_exports, {
   toTranslationCsv: () => toTranslationCsv,
   toXliff: () => toXliff,
   translationCoverage: () => translationCoverage,
+  trimExceptionDetail: () => trimExceptionDetail,
   unreadAnnouncements: () => unreadAnnouncements,
   validateGuideConfig: () => validateGuideConfig,
   variantProblems: () => variantProblems,
@@ -340,18 +359,18 @@ function slugify(input) {
   return input.toLowerCase().trim().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 64) || "untitled";
 }
 var ALPHABET = "0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ";
-function randomId(size = 16) {
+function randomId(size2 = 16) {
   const g = typeof globalThis !== "undefined" ? globalThis : {};
   let bytes;
   if (g.crypto && typeof g.crypto.getRandomValues === "function") {
-    bytes = new Uint8Array(size);
+    bytes = new Uint8Array(size2);
     g.crypto.getRandomValues(bytes);
   } else {
-    bytes = new Uint8Array(size);
-    for (let i = 0; i < size; i++) bytes[i] = Math.floor(Math.random() * 256);
+    bytes = new Uint8Array(size2);
+    for (let i = 0; i < size2; i++) bytes[i] = Math.floor(Math.random() * 256);
   }
   let out = "";
-  for (let i = 0; i < size; i++) out += ALPHABET[bytes[i] % ALPHABET.length];
+  for (let i = 0; i < size2; i++) out += ALPHABET[bytes[i] % ALPHABET.length];
   return out;
 }
 function isPlainObject(v) {
@@ -1088,19 +1107,91 @@ var ProjectThemeSchema = import_zod2.z.object({
 // src/events.ts
 var import_zod3 = require("zod");
 
+// src/error-detail.ts
+var MAX_EXCEPTION_DETAIL_BYTES = 64 * 1024;
+var MAX_EXCEPTION_DETAIL_RAW_BYTES = 1024 * 1024;
+var MAX_BREADCRUMBS = 100;
+var MAX_EXCEPTION_CHAIN = 20;
+var MAX_DETAIL_FRAMES = 250;
+var MAX_DETAIL_THREADS = 100;
+var MAX_DEBUG_IMAGES = 500;
+var MAX_ERROR_TAGS = 50;
+var size = (v) => {
+  try {
+    return JSON.stringify(v)?.length ?? 0;
+  } catch {
+    return Infinity;
+  }
+};
+function normalizeTags(tags) {
+  const out = {};
+  for (const [k, v] of Object.entries(tags ?? {})) {
+    if (Object.keys(out).length >= MAX_ERROR_TAGS) break;
+    if (!k || v === void 0 || v === null) continue;
+    out[k.slice(0, 32)] = String(v).slice(0, 200);
+  }
+  return out;
+}
+function trimExceptionDetail(detail, max = MAX_EXCEPTION_DETAIL_BYTES) {
+  const d = detail;
+  if (d.breadcrumbs?.values && d.breadcrumbs.values.length > MAX_BREADCRUMBS) d.breadcrumbs.values = d.breadcrumbs.values.slice(-MAX_BREADCRUMBS);
+  if (d.exception?.values && d.exception.values.length > MAX_EXCEPTION_CHAIN) d.exception.values = d.exception.values.slice(-MAX_EXCEPTION_CHAIN);
+  if (d.threads?.values && d.threads.values.length > MAX_DETAIL_THREADS) d.threads.values = d.threads.values.slice(0, MAX_DETAIL_THREADS);
+  if (d.debug_meta?.images && d.debug_meta.images.length > MAX_DEBUG_IMAGES) d.debug_meta.images = d.debug_meta.images.slice(0, MAX_DEBUG_IMAGES);
+  const stacks = () => [...d.exception?.values ?? [], ...d.threads?.values ?? []].map((x) => x.stacktrace).filter((s) => !!s);
+  for (const s of stacks()) if (s.frames && s.frames.length > MAX_DETAIL_FRAMES) s.frames = s.frames.slice(-MAX_DETAIL_FRAMES);
+  if (size(d) <= max) return d;
+  while (d.breadcrumbs?.values.length && size(d) > max) d.breadcrumbs.values = d.breadcrumbs.values.slice(Math.ceil(d.breadcrumbs.values.length / 2));
+  if (size(d) <= max) return d;
+  for (const s of stacks())
+    for (const f of s.frames ?? []) {
+      delete f.vars;
+      delete f.pre_context;
+      delete f.post_context;
+    }
+  if (size(d) <= max) return d;
+  if (d.threads?.values) d.threads.values = d.threads.values.filter((t) => t.crashed || t.current);
+  if (size(d) <= max) return d;
+  if (d.extra) d.extra = { _trimmed: true };
+  if (d.request) delete d.request.data;
+  for (const s of stacks()) while (s.frames && s.frames.length > 20 && size(d) > max) s.frames.splice(Math.floor(s.frames.length / 2) - 5, 10);
+  if (d.debug_meta?.images && size(d) > max) d.debug_meta.images = d.debug_meta.images.slice(0, 50);
+  return d;
+}
+var matches = (patterns, value) => patterns.some((p) => typeof p === "string" ? p !== "" && value.includes(p) : safeTest(p, value));
+function safeTest(re, value) {
+  re.lastIndex = 0;
+  return re.test(value);
+}
+function errorFilterDrops(e, opts) {
+  const message = e.message ?? "";
+  if (opts.ignoreErrors?.length && (matches(opts.ignoreErrors, `${e.type || "Error"}: ${message}`) || matches(opts.ignoreErrors, message))) return true;
+  if (!e.file) return false;
+  if (opts.denyUrls?.length && matches(opts.denyUrls, e.file)) return true;
+  if (opts.allowUrls?.length && !matches(opts.allowUrls, e.file)) return true;
+  return false;
+}
+
 // src/events-util.ts
 var SENSITIVE_PROPERTY_PATTERN = /(password|passwd|secret|token|credit|card|cvv|ssn|iban)/i;
 var MAX_PROPERTY_BYTES = 8 * 1024;
+var MAX_APP_VERSION_LENGTH = 64;
+function normalizeAppVersion(input) {
+  if (typeof input !== "string" && typeof input !== "number") return null;
+  const printable = Array.from(String(input)).filter((c) => c.charCodeAt(0) > 31 && c.charCodeAt(0) !== 127).join("");
+  const v = printable.trim().slice(0, MAX_APP_VERSION_LENGTH).trim();
+  return v || null;
+}
 function sanitizeProperties(props) {
   if (!props) return {};
   const out = {};
-  let size = 0;
+  let size2 = 0;
   for (const [k, v] of Object.entries(props)) {
     if (SENSITIVE_PROPERTY_PATTERN.test(k)) continue;
     if (typeof v === "function" || typeof v === "symbol") continue;
     const str2 = typeof v === "string" ? v : JSON.stringify(v ?? null);
-    size += k.length + (str2?.length ?? 0);
-    if (size > MAX_PROPERTY_BYTES) break;
+    size2 += k.length + (str2?.length ?? 0);
+    if (size2 > MAX_PROPERTY_BYTES) break;
     out[k.slice(0, 100)] = typeof v === "string" ? v.slice(0, 1e3) : v;
   }
   return out;
@@ -1110,16 +1201,23 @@ function sanitizeProperties(props) {
 var MAX_STACK_FRAMES = 30;
 var V8 = /^\s*at (?:(.+?) \()?((?:[a-z][\w+.-]*:)?[^\s()]+?):(\d+):(\d+)\)?\s*$/i;
 var GECKO = /^\s*(.*?)@(.+?):(\d+):(\d+)\s*$/;
+var HERMES = /^\s*at (?:(.+?) \()?address at ([^\s()]+?):(\d+):(\d+)\)?\s*$/;
+function reactNativeBundleUrl(file) {
+  const base = file.replace(/[?#].*$/, "").split("/").pop() || file;
+  return `app:///${base}`;
+}
 function parseStack(stack, max = MAX_STACK_FRAMES) {
   if (!stack || typeof stack !== "string") return [];
   const frames = [];
   for (const raw of stack.split("\n")) {
     if (frames.length >= max) break;
     const line = raw.slice(0, 1e3);
-    const m = V8.exec(line) ?? GECKO.exec(line);
+    const hermes = HERMES.exec(line);
+    const m = hermes ?? V8.exec(line) ?? GECKO.exec(line);
     if (!m) continue;
     const fn = (m[1] || "").trim();
-    frames.push({ fn: fn ? fn.slice(0, 200) : void 0, file: m[2]?.slice(0, 500), line: Number(m[3]), col: Number(m[4]) });
+    const file = hermes ? reactNativeBundleUrl(m[2]) : m[2];
+    frames.push({ fn: fn ? fn.slice(0, 200) : void 0, file: file?.slice(0, 500), line: Number(m[3]), col: Number(m[4]) });
   }
   return frames;
 }
@@ -1139,13 +1237,23 @@ function normalizeFrameFile(file) {
 var SOURCEMAP_MAX_FILE_BYTES = 100 * 1024 * 1024;
 var SOURCEMAP_MAX_FILES_PER_UPLOAD = 200;
 function fingerprintError(input) {
-  const top = (input.frames ?? []).find((f) => f.file);
-  const frameKey = input.original ? `src:${input.original.source}:${input.original.name || "?"}` : top ? `${normalizeFrameFile(top.file)}:${top.fn || "?"}` : "";
+  const withFile = (input.frames ?? []).filter((f) => f.file || f.module);
+  const top = withFile.find((f) => f.inApp === true) ?? withFile.find((f) => f.inApp !== false) ?? withFile[0];
+  const frameKey = input.original ? `src:${input.original.source}:${input.original.name || "?"}` : top ? `${top.file ? normalizeFrameFile(top.file) : `mod:${top.module}`}:${top.fn || "?"}` : "";
   const key = [input.type || "Error", normalizeErrorMessage(input.message || ""), frameKey].join("|");
   const a = fnv1a(key).toString(16).padStart(8, "0");
   const b = fnv1a(`guidely:${key}`).toString(16).padStart(8, "0");
   return a + b;
 }
+function customFingerprint(parts, computed) {
+  if (!Array.isArray(parts) || parts.length === 0) return computed;
+  const items = parts.filter((p) => typeof p === "string" || typeof p === "number").map((p) => String(p).slice(0, 200)).slice(0, 20);
+  if (items.length === 0) return computed;
+  const isDefault = (p) => /^\{\{\s*default\s*\}\}$/i.test(p);
+  if (items.every(isDefault)) return computed;
+  const key = items.map((p) => isDefault(p) ? computed : p).join("|");
+  return fnv1a(key).toString(16).padStart(8, "0") + fnv1a(`guidely:fp:${key}`).toString(16).padStart(8, "0");
+}
 
 // src/events.ts
 var EVENT_NAMES = [
@@ -1191,6 +1299,14 @@ var EVENT_NAMES = [
 var AUTOCAPTURE_EVENTS = ["page_view", "page_leave", "click", "rage_click", "exception", "heatmap", "app_install", "app_update", "app_open", "app_background"];
 var APP_LIFECYCLE_EVENTS = ["app_install", "app_update", "app_open", "app_background"];
 var GUIDE_LIFECYCLE_EVENTS = ["guide_viewed", "guide_started", "step_viewed", "step_completed", "guide_completed", "guide_skipped", "guide_dismissed", "guide_abandoned"];
+var ExceptionDetailField = import_zod3.z.preprocess((v) => {
+  if (!v || typeof v !== "object" || Array.isArray(v)) return void 0;
+  try {
+    return JSON.stringify(v).length > MAX_EXCEPTION_DETAIL_RAW_BYTES ? void 0 : v;
+  } catch {
+    return void 0;
+  }
+}, import_zod3.z.record(import_zod3.z.string(), import_zod3.z.unknown()).optional());
 var SdkEventSchema = import_zod3.z.object({
   eventId: import_zod3.z.string().min(8).max(64),
   name: import_zod3.z.enum(EVENT_NAMES),
@@ -1206,7 +1322,19 @@ var SdkEventSchema = import_zod3.z.object({
   stepId: import_zod3.z.string().max(64).optional(),
   stepIndex: import_zod3.z.number().int().min(0).optional(),
   url: import_zod3.z.string().max(2e3).optional(),
-  properties: import_zod3.z.record(import_zod3.z.string(), import_zod3.z.unknown()).optional()
+  /**
+   * Version of the customer's app when the event happened (`appVersion` SDK option, auto-detected on
+   * mobile). Stored per event so reports can filter and break down by version; see `normalizeAppVersion`.
+   */
+  appVersion: import_zod3.z.string().max(200).optional().nullable(),
+  properties: import_zod3.z.record(import_zod3.z.string(), import_zod3.z.unknown()).optional(),
+  /**
+   * `exception` events only: breadcrumbs, contexts, tags, extra, the exception chain, threads and
+   * debug images in the Sentry event shape (`ExceptionDetail`, docs/error-monitoring/sdks.md), outside
+   * the 8 KB property budget. The server trims it to 64 KB and stores it in ErrorEventDetail; one over
+   * 1 MB (or that isn't an object) is dropped without failing the batch.
+   */
+  detail: ExceptionDetailField
 });
 var EventBatchSchema = import_zod3.z.object({
   events: import_zod3.z.array(SdkEventSchema).min(1).max(50),
@@ -1337,9 +1465,38 @@ var FileComplaintSchema = import_zod6.z.object({
   }).optional().nullable()
 });
 
-// src/agents.ts
+// src/bug-reports.ts
 var import_zod7 = require("zod");
 
+// src/bug-reports-limits.ts
+var MAX_BUG_REPORT_LENGTH = 4e3;
+var MAX_BUG_REPORT_SCREENSHOT_BYTES = 4 * 1024 * 1024;
+
+// src/bug-reports.ts
+var BugReportSchema = import_zod7.z.object({
+  anonymousId: import_zod7.z.string().min(1).max(128),
+  userId: import_zod7.z.string().max(256).optional().nullable(),
+  sessionId: import_zod7.z.string().max(128).optional().nullable(),
+  message: import_zod7.z.string().trim().min(1).max(MAX_BUG_REPORT_LENGTH),
+  email: import_zod7.z.string().trim().toLowerCase().email().max(254).optional().nullable(),
+  name: import_zod7.z.string().trim().max(200).optional().nullable(),
+  /** The exception event the report is about (the SDK sends the page's last error unless told otherwise). */
+  associatedEventId: import_zod7.z.string().trim().max(64).optional().nullable(),
+  url: import_zod7.z.string().max(2e3).optional().nullable(),
+  appVersion: import_zod7.z.string().max(200).optional().nullable(),
+  /** widget (the built-in dialog) or api (captureFeedback). */
+  source: import_zod7.z.enum(["widget", "api"]).default("api"),
+  tags: import_zod7.z.record(import_zod7.z.string().max(64), import_zod7.z.string().max(200)).optional(),
+  sdk: import_zod7.z.object({ name: import_zod7.z.string().max(60), version: import_zod7.z.string().max(30) }).optional(),
+  screenshot: import_zod7.z.object({
+    fileName: import_zod7.z.string().trim().min(1).max(200),
+    data: import_zod7.z.string().max(Math.ceil(MAX_BUG_REPORT_SCREENSHOT_BYTES * 4 / 3) + 64)
+  }).optional().nullable()
+});
+
+// src/agents.ts
+var import_zod8 = require("zod");
+
 // src/agents-limits.ts
 var AGENT_TURN_ROLES = ["user", "assistant", "tool", "system"];
 var AGENT_OUTCOMES = ["success", "failure", "escalated", "abandoned"];
@@ -1352,51 +1509,51 @@ var AGENT_METADATA_MAX_BYTES = 4096;
 var SCOUT_AGENT_ID = "scout";
 
 // src/agents.ts
-var ENVIRONMENTS = ["development", "staging", "production"];
-var AgentToolCallSchema = import_zod7.z.object({
-  name: import_zod7.z.string().trim().min(1).max(100),
-  status: import_zod7.z.enum(AGENT_TOOL_STATUSES).optional(),
-  latencyMs: import_zod7.z.number().int().min(0).max(36e5).optional()
+var EnvironmentKey = import_zod8.z.string().trim().regex(/^[a-z][a-z0-9-]{0,29}$/, "environment: use an environment key such as production");
+var AgentToolCallSchema = import_zod8.z.object({
+  name: import_zod8.z.string().trim().min(1).max(100),
+  status: import_zod8.z.enum(AGENT_TOOL_STATUSES).optional(),
+  latencyMs: import_zod8.z.number().int().min(0).max(36e5).optional()
 }).strip();
-var AgentMetadataSchema = import_zod7.z.record(import_zod7.z.string().max(100), import_zod7.z.unknown()).transform((m) => {
+var AgentMetadataSchema = import_zod8.z.record(import_zod8.z.string().max(100), import_zod8.z.unknown()).transform((m) => {
   const out = {};
-  let size = 0;
+  let size2 = 0;
   for (const [k, v] of Object.entries(m)) {
     const key = k.trim();
     if (!key || key.startsWith("$") || SENSITIVE_PROPERTY_PATTERN.test(key)) continue;
     if (!(typeof v === "string" || typeof v === "boolean" || v === null || typeof v === "number" && Number.isFinite(v))) continue;
     const value = typeof v === "string" ? v.slice(0, 500) : v;
-    size += key.length + String(value).length;
-    if (size > AGENT_METADATA_MAX_BYTES || Object.keys(out).length >= AGENT_METADATA_MAX_KEYS) break;
+    size2 += key.length + String(value).length;
+    if (size2 > AGENT_METADATA_MAX_BYTES || Object.keys(out).length >= AGENT_METADATA_MAX_KEYS) break;
     out[key] = value;
   }
   return out;
 });
-var id = (max) => import_zod7.z.string().trim().min(1).max(max);
-var optionalId = (max) => import_zod7.z.string().trim().max(max).optional().nullable().transform((v) => v || null);
-var AgentTurnInputSchema = import_zod7.z.object({
-  type: import_zod7.z.literal("agent.conversation").optional(),
+var id = (max) => import_zod8.z.string().trim().min(1).max(max);
+var optionalId = (max) => import_zod8.z.string().trim().max(max).optional().nullable().transform((v) => v || null);
+var AgentTurnInputSchema = import_zod8.z.object({
+  type: import_zod8.z.literal("agent.conversation").optional(),
   conversationId: id(128),
   agentId: id(64).refine((v) => v.toLowerCase() !== SCOUT_AGENT_ID, { message: `"${SCOUT_AGENT_ID}" is reserved for Guidely's built-in Scout agent` }),
-  agentName: import_zod7.z.string().trim().max(100).optional(),
-  turnId: import_zod7.z.string().trim().min(1).max(128).optional(),
-  role: import_zod7.z.enum(AGENT_TURN_ROLES),
-  text: import_zod7.z.string().max(AGENT_TURN_MAX_TEXT).default(""),
-  toolCalls: import_zod7.z.array(AgentToolCallSchema).max(AGENT_TOOL_CALLS_PER_TURN).default([]),
-  latencyMs: import_zod7.z.number().int().min(0).max(36e5).optional(),
-  outcome: import_zod7.z.enum(AGENT_OUTCOMES).optional(),
-  taskSuccess: import_zod7.z.boolean().optional(),
-  occurredAt: import_zod7.z.string().datetime({ offset: true }).optional(),
+  agentName: import_zod8.z.string().trim().max(100).optional(),
+  turnId: import_zod8.z.string().trim().min(1).max(128).optional(),
+  role: import_zod8.z.enum(AGENT_TURN_ROLES),
+  text: import_zod8.z.string().max(AGENT_TURN_MAX_TEXT).default(""),
+  toolCalls: import_zod8.z.array(AgentToolCallSchema).max(AGENT_TOOL_CALLS_PER_TURN).default([]),
+  latencyMs: import_zod8.z.number().int().min(0).max(36e5).optional(),
+  outcome: import_zod8.z.enum(AGENT_OUTCOMES).optional(),
+  taskSuccess: import_zod8.z.boolean().optional(),
+  occurredAt: import_zod8.z.string().datetime({ offset: true }).optional(),
   userId: optionalId(256),
   anonymousId: optionalId(128),
   accountId: optionalId(256),
   sessionId: optionalId(128),
   metadata: AgentMetadataSchema.default({})
 });
-var turns = import_zod7.z.array(AgentTurnInputSchema).min(1).max(AGENT_TURNS_PER_BATCH);
-var sdkInfo = import_zod7.z.object({ name: import_zod7.z.string().max(60), version: import_zod7.z.string().max(30) }).optional();
-var SdkAgentEventsSchema = import_zod7.z.object({ turns, sdk: sdkInfo });
-var AgentEventsRequestSchema = import_zod7.z.preprocess(
+var turns = import_zod8.z.array(AgentTurnInputSchema).min(1).max(AGENT_TURNS_PER_BATCH);
+var sdkInfo = import_zod8.z.object({ name: import_zod8.z.string().max(60), version: import_zod8.z.string().max(30) }).optional();
+var SdkAgentEventsSchema = import_zod8.z.object({ turns, sdk: sdkInfo });
+var AgentEventsRequestSchema = import_zod8.z.preprocess(
   (v) => {
     if (Array.isArray(v)) return { turns: v };
     if (v && typeof v === "object" && !("turns" in v)) {
@@ -1405,11 +1562,11 @@ var AgentEventsRequestSchema = import_zod7.z.preprocess(
     }
     return v;
   },
-  import_zod7.z.object({ turns, environment: import_zod7.z.enum(ENVIRONMENTS).default("production"), sdk: sdkInfo })
+  import_zod8.z.object({ turns, environment: EnvironmentKey.default("production"), sdk: sdkInfo })
 );
 
 // src/feedback.ts
-var import_zod8 = require("zod");
+var import_zod9 = require("zod");
 
 // src/feedback-limits.ts
 var FEEDBACK_STATUSES = ["new", "under_review", "planned", "in_progress", "released", "declined"];
@@ -1433,58 +1590,60 @@ var feedbackReference = (number) => `#${number}`;
 
 // src/feedback.ts
 var visitor = {
-  anonymousId: import_zod8.z.string().min(1).max(128),
-  userId: import_zod8.z.string().max(256).optional().nullable()
+  anonymousId: import_zod9.z.string().min(1).max(128),
+  userId: import_zod9.z.string().max(256).optional().nullable()
 };
-var FeedbackListRequestSchema = import_zod8.z.object({
+var FeedbackListRequestSchema = import_zod9.z.object({
   ...visitor,
-  q: import_zod8.z.string().trim().max(200).optional(),
-  sort: import_zod8.z.enum(["top", "new", "trending"]).default("top"),
-  status: import_zod8.z.enum(FEEDBACK_STATUSES).optional(),
+  q: import_zod9.z.string().trim().max(200).optional(),
+  sort: import_zod9.z.enum(["top", "new", "trending"]).default("top"),
+  status: import_zod9.z.enum(FEEDBACK_STATUSES).optional(),
   /** "open" = not released or declined. */
-  filter: import_zod8.z.enum(["open", "all", "mine", "following"]).default("open"),
-  productArea: import_zod8.z.string().trim().max(60).optional(),
-  page: import_zod8.z.number().int().min(1).max(100).default(1)
+  filter: import_zod9.z.enum(["open", "all", "mine", "following"]).default("open"),
+  productArea: import_zod9.z.string().trim().max(60).optional(),
+  page: import_zod9.z.number().int().min(1).max(100).default(1)
 });
-var FeedbackVisitorSchema = import_zod8.z.object(visitor);
-var SubmitFeedbackSchema = import_zod8.z.object({
+var FeedbackVisitorSchema = import_zod9.z.object(visitor);
+var SubmitFeedbackSchema = import_zod9.z.object({
   ...visitor,
-  title: import_zod8.z.string().trim().min(3, "Give your idea a short title").max(MAX_FEEDBACK_TITLE),
-  description: import_zod8.z.string().trim().max(MAX_FEEDBACK_DESCRIPTION).default(""),
-  productArea: import_zod8.z.string().trim().max(60).optional().nullable(),
-  priority: import_zod8.z.enum(FEEDBACK_PRIORITIES).default("nice_to_have"),
+  title: import_zod9.z.string().trim().min(3, "Give your idea a short title").max(MAX_FEEDBACK_TITLE),
+  description: import_zod9.z.string().trim().max(MAX_FEEDBACK_DESCRIPTION).default(""),
+  productArea: import_zod9.z.string().trim().max(60).optional().nullable(),
+  priority: import_zod9.z.enum(FEEDBACK_PRIORITIES).default("nice_to_have"),
   /** Filed from this Scout conversation (Scout offered it). */
-  conversationId: import_zod8.z.string().min(1).max(64).optional().nullable(),
-  pageUrl: import_zod8.z.string().max(2e3).optional()
+  conversationId: import_zod9.z.string().min(1).max(64).optional().nullable(),
+  pageUrl: import_zod9.z.string().max(2e3).optional()
 });
-var FeedbackVoteSchema = import_zod8.z.object({
+var FeedbackVoteSchema = import_zod9.z.object({
   ...visitor,
-  priority: import_zod8.z.enum(FEEDBACK_PRIORITIES).default("nice_to_have"),
-  note: import_zod8.z.string().trim().max(MAX_FEEDBACK_NOTE).optional(),
-  conversationId: import_zod8.z.string().min(1).max(64).optional().nullable()
+  priority: import_zod9.z.enum(FEEDBACK_PRIORITIES).default("nice_to_have"),
+  note: import_zod9.z.string().trim().max(MAX_FEEDBACK_NOTE).optional(),
+  conversationId: import_zod9.z.string().min(1).max(64).optional().nullable()
 });
-var FeedbackFollowSchema = import_zod8.z.object({ ...visitor, follow: import_zod8.z.boolean() });
-var FeedbackCommentSchema = import_zod8.z.object({ ...visitor, body: import_zod8.z.string().trim().min(1).max(MAX_FEEDBACK_COMMENT) });
-var FeedbackSimilarSchema = import_zod8.z.object({ ...visitor, title: import_zod8.z.string().trim().min(3).max(MAX_FEEDBACK_TITLE) });
-var FeedbackUpdatesReadSchema = import_zod8.z.object({ ...visitor, ids: import_zod8.z.array(import_zod8.z.string().min(1).max(64)).max(100).optional() });
+var FeedbackFollowSchema = import_zod9.z.object({ ...visitor, follow: import_zod9.z.boolean() });
+var FeedbackCommentSchema = import_zod9.z.object({ ...visitor, body: import_zod9.z.string().trim().min(1).max(MAX_FEEDBACK_COMMENT) });
+var FeedbackSimilarSchema = import_zod9.z.object({ ...visitor, title: import_zod9.z.string().trim().min(3).max(MAX_FEEDBACK_TITLE) });
+var FeedbackUpdatesReadSchema = import_zod9.z.object({ ...visitor, ids: import_zod9.z.array(import_zod9.z.string().min(1).max(64)).max(100).optional() });
 
 // src/capture.ts
-var import_zod9 = require("zod");
-var AutocaptureSettingsSchema = import_zod9.z.object({ pageviews: import_zod9.z.boolean(), pageLeave: import_zod9.z.boolean(), clicks: import_zod9.z.boolean(), rageClicks: import_zod9.z.boolean(), heatmaps: import_zod9.z.boolean(), mouseMovement: import_zod9.z.boolean(), appLifecycle: import_zod9.z.boolean() }).partial();
-var ErrorTrackingSettingsSchema = import_zod9.z.object({ enabled: import_zod9.z.boolean() }).partial();
-var ReplaySettingsSchema = import_zod9.z.object({
-  enabled: import_zod9.z.boolean(),
-  sampleRate: import_zod9.z.number().int().min(0).max(100),
-  recordConsole: import_zod9.z.boolean(),
-  recordNetwork: import_zod9.z.boolean(),
-  recordNetworkPayloads: import_zod9.z.boolean(),
-  maskAllText: import_zod9.z.boolean(),
-  blockSelectors: import_zod9.z.array(import_zod9.z.string().min(1).max(200)).max(50),
-  retentionDays: import_zod9.z.number().int().min(1).max(365)
+var import_zod10 = require("zod");
+var AutocaptureSettingsSchema = import_zod10.z.object({ pageviews: import_zod10.z.boolean(), pageLeave: import_zod10.z.boolean(), clicks: import_zod10.z.boolean(), rageClicks: import_zod10.z.boolean(), heatmaps: import_zod10.z.boolean(), mouseMovement: import_zod10.z.boolean(), appLifecycle: import_zod10.z.boolean() }).partial();
+var ErrorTrackingSettingsSchema = import_zod10.z.object({ enabled: import_zod10.z.boolean() }).partial();
+var PerformanceSettingsSchema = import_zod10.z.object({ enabled: import_zod10.z.boolean(), sampleRate: import_zod10.z.number().min(0).max(100) }).partial();
+var ReplaySettingsSchema = import_zod10.z.object({
+  enabled: import_zod10.z.boolean(),
+  sampleRate: import_zod10.z.number().int().min(0).max(100),
+  recordConsole: import_zod10.z.boolean(),
+  recordNetwork: import_zod10.z.boolean(),
+  recordNetworkPayloads: import_zod10.z.boolean(),
+  maskAllText: import_zod10.z.boolean(),
+  blockSelectors: import_zod10.z.array(import_zod10.z.string().min(1).max(200)).max(50),
+  retentionDays: import_zod10.z.number().int().min(1).max(365)
 }).partial();
 var DEFAULT_CAPTURE_SETTINGS = {
   autocapture: { pageviews: true, pageLeave: true, clicks: true, rageClicks: true, heatmaps: true, mouseMovement: true, appLifecycle: true },
   errorTracking: { enabled: true },
+  performance: { enabled: false, sampleRate: 100 },
   replay: { enabled: false, sampleRate: 100, recordConsole: true, recordNetwork: true, recordNetworkPayloads: false, maskAllText: false, blockSelectors: [], retentionDays: 30 }
 };
 var RECORDING_LEVELS = ["off", "privacy", "standard", "full"];
@@ -1511,25 +1670,29 @@ function resolveCaptureSettings(settings) {
   const a = AutocaptureSettingsSchema.safeParse(obj(s.autocapture));
   const e = ErrorTrackingSettingsSchema.safeParse(obj(s.errorTracking));
   const r = ReplaySettingsSchema.safeParse(obj(s.replay));
+  const p = PerformanceSettingsSchema.safeParse(obj(s.performance));
   return {
     autocapture: { ...d.autocapture, ...a.success ? a.data : {} },
     errorTracking: { ...d.errorTracking, ...e.success ? e.data : {} },
-    replay: { ...d.replay, ...r.success ? r.data : {} }
+    replay: { ...d.replay, ...r.success ? r.data : {} },
+    performance: { ...d.performance, ...p.success ? p.data : {} }
   };
 }
 var HEATMAP_VIEWPORTS = { mobile: [0, 767], tablet: [768, 1279], desktop: [1280, 1e5] };
-var ReplayChunkSchema = import_zod9.z.object({
-  sessionId: import_zod9.z.string().min(1).max(128),
-  windowId: import_zod9.z.string().min(1).max(64),
-  seq: import_zod9.z.number().int().min(0).max(1e6),
-  anonymousId: import_zod9.z.string().min(1).max(128),
-  userId: import_zod9.z.string().max(256).optional().nullable(),
+var ReplayChunkSchema = import_zod10.z.object({
+  sessionId: import_zod10.z.string().min(1).max(128),
+  windowId: import_zod10.z.string().min(1).max(64),
+  seq: import_zod10.z.number().int().min(0).max(1e6),
+  anonymousId: import_zod10.z.string().min(1).max(128),
+  userId: import_zod10.z.string().max(256).optional().nullable(),
   /** rrweb `eventWithTime` objects, in order. */
-  events: import_zod9.z.array(import_zod9.z.object({ type: import_zod9.z.number().int(), timestamp: import_zod9.z.number() }).passthrough()).min(1).max(5e4),
-  url: import_zod9.z.string().max(2e3).optional(),
-  device: import_zod9.z.object({ type: import_zod9.z.string().max(20), browser: import_zod9.z.string().max(40).optional(), os: import_zod9.z.string().max(40).optional() }).optional(),
-  viewport: import_zod9.z.object({ width: import_zod9.z.number().int().min(0).max(1e5), height: import_zod9.z.number().int().min(0).max(1e5) }).optional(),
-  sdk: import_zod9.z.object({ name: import_zod9.z.string().max(60), version: import_zod9.z.string().max(30) }).optional()
+  events: import_zod10.z.array(import_zod10.z.object({ type: import_zod10.z.number().int(), timestamp: import_zod10.z.number() }).passthrough()).min(1).max(5e4),
+  url: import_zod10.z.string().max(2e3).optional(),
+  device: import_zod10.z.object({ type: import_zod10.z.string().max(20), browser: import_zod10.z.string().max(40).optional(), os: import_zod10.z.string().max(40).optional() }).optional(),
+  viewport: import_zod10.z.object({ width: import_zod10.z.number().int().min(0).max(1e5), height: import_zod10.z.number().int().min(0).max(1e5) }).optional(),
+  sdk: import_zod10.z.object({ name: import_zod10.z.string().max(60), version: import_zod10.z.string().max(30) }).optional(),
+  /** The app's version (`appVersion` SDK option); recordings can be filtered by it. */
+  appVersion: import_zod10.z.string().max(200).optional()
 });
 var REPLAY_MAX_COMPRESSED_BYTES = 2 * 1024 * 1024;
 var REPLAY_MAX_RAW_BYTES = 16 * 1024 * 1024;
@@ -1993,7 +2156,7 @@ function articleIdFromHref(href) {
 }
 
 // src/howto.ts
-var import_zod10 = require("zod");
+var import_zod11 = require("zod");
 
 // src/howto-limits.ts
 var CAPTURE_PARAM = "guidely_capture";
@@ -2002,36 +2165,36 @@ var CAPTURE_SCREENSHOT_MAX_BYTES = 8 * 1024 * 1024;
 // src/howto.ts
 var HOWTO_STEP_KINDS = ["action", "text", "heading", "tip", "alert"];
 var HOWTO_ACTIONS = ["click", "type", "select", "navigate"];
-var NormalizedRectSchema = import_zod10.z.object({
-  x: import_zod10.z.number().min(0).max(1),
-  y: import_zod10.z.number().min(0).max(1),
-  width: import_zod10.z.number().min(0).max(1),
-  height: import_zod10.z.number().min(0).max(1)
+var NormalizedRectSchema = import_zod11.z.object({
+  x: import_zod11.z.number().min(0).max(1),
+  y: import_zod11.z.number().min(0).max(1),
+  width: import_zod11.z.number().min(0).max(1),
+  height: import_zod11.z.number().min(0).max(1)
 });
-var CapturedElementSchema = import_zod10.z.object({
+var CapturedElementSchema = import_zod11.z.object({
   /** Visible name: aria-label, associated label, text, placeholder, alt or title. */
-  label: import_zod10.z.string().max(200).default(""),
+  label: import_zod11.z.string().max(200).default(""),
   /** button, link, tab, menuitem, checkbox, radio, field, dropdown, option, element… */
-  role: import_zod10.z.string().max(40).default("element"),
-  tag: import_zod10.z.string().max(40).default("")
+  role: import_zod11.z.string().max(40).default("element"),
+  tag: import_zod11.z.string().max(40).default("")
 });
-var CaptureStepSchema = import_zod10.z.object({
+var CaptureStepSchema = import_zod11.z.object({
   /** Random id from the SDK; a retried upload with the same id is stored once. */
-  clientId: import_zod10.z.string().min(1).max(64),
-  action: import_zod10.z.enum(HOWTO_ACTIONS),
-  url: import_zod10.z.string().max(2e3),
-  pageTitle: import_zod10.z.string().max(300).default(""),
+  clientId: import_zod11.z.string().min(1).max(64),
+  action: import_zod11.z.enum(HOWTO_ACTIONS),
+  url: import_zod11.z.string().max(2e3),
+  pageTitle: import_zod11.z.string().max(300).default(""),
   element: CapturedElementSchema.optional(),
   /** Typed text or chosen option; absent when it was sensitive (`valueRedacted`). */
-  value: import_zod10.z.string().max(200).optional(),
-  valueRedacted: import_zod10.z.boolean().default(false),
+  value: import_zod11.z.string().max(200).optional(),
+  valueRedacted: import_zod11.z.boolean().default(false),
   /** Selectors for the element, so the step can later become an interactive tour step. */
-  selectors: import_zod10.z.array(SelectorStrategySchema).max(10).default([]),
+  selectors: import_zod11.z.array(SelectorStrategySchema).max(10).default([]),
   /** Where the element sits in the screenshot. */
   highlight: NormalizedRectSchema.optional(),
   /** Number of regions the SDK blurred in the screenshot before upload. */
-  redactions: import_zod10.z.number().int().min(0).max(1e3).default(0),
-  occurredAt: import_zod10.z.string().datetime().optional()
+  redactions: import_zod11.z.number().int().min(0).max(1e3).default(0),
+  occurredAt: import_zod11.z.string().datetime().optional()
 });
 function quoted(s) {
   const t = (s ?? "").replace(/\s+/g, " ").trim();
@@ -2102,12 +2265,12 @@ function hostAndPath(url) {
     return url.slice(0, 80);
   }
 }
-var NormalizedPointSchema = import_zod10.z.object({ x: import_zod10.z.number().min(0).max(1), y: import_zod10.z.number().min(0).max(1) });
+var NormalizedPointSchema = import_zod11.z.object({ x: import_zod11.z.number().min(0).max(1), y: import_zod11.z.number().min(0).max(1) });
 var ANNOTATION_COLORS = ["brand", "red", "amber", "green", "black", "white"];
-var HowToAnnotationSchema = import_zod10.z.discriminatedUnion("type", [
-  import_zod10.z.object({ id: import_zod10.z.string().min(1).max(32), type: import_zod10.z.literal("arrow"), from: NormalizedPointSchema, to: NormalizedPointSchema, color: import_zod10.z.enum(ANNOTATION_COLORS).default("brand") }),
-  import_zod10.z.object({ id: import_zod10.z.string().min(1).max(32), type: import_zod10.z.literal("text"), at: NormalizedPointSchema, text: import_zod10.z.string().trim().min(1).max(120), color: import_zod10.z.enum(ANNOTATION_COLORS).default("brand") }),
-  import_zod10.z.object({ id: import_zod10.z.string().min(1).max(32), type: import_zod10.z.literal("box"), rect: NormalizedRectSchema, color: import_zod10.z.enum(ANNOTATION_COLORS).default("brand") })
+var HowToAnnotationSchema = import_zod11.z.discriminatedUnion("type", [
+  import_zod11.z.object({ id: import_zod11.z.string().min(1).max(32), type: import_zod11.z.literal("arrow"), from: NormalizedPointSchema, to: NormalizedPointSchema, color: import_zod11.z.enum(ANNOTATION_COLORS).default("brand") }),
+  import_zod11.z.object({ id: import_zod11.z.string().min(1).max(32), type: import_zod11.z.literal("text"), at: NormalizedPointSchema, text: import_zod11.z.string().trim().min(1).max(120), color: import_zod11.z.enum(ANNOTATION_COLORS).default("brand") }),
+  import_zod11.z.object({ id: import_zod11.z.string().min(1).max(32), type: import_zod11.z.literal("box"), rect: NormalizedRectSchema, color: import_zod11.z.enum(ANNOTATION_COLORS).default("brand") })
 ]);
 var MAX_ANNOTATIONS = 30;
 
@@ -2709,6 +2872,16 @@ var SCRIPT_STUB_METHODS = [
   "openComplaint",
   "openIdeas",
   "captureException",
+  "captureFeedback",
+  "showBugReport",
+  "captureMessage",
+  "addBreadcrumb",
+  "setTag",
+  "setTags",
+  "setExtra",
+  "setExtras",
+  "setContext",
+  "setUser",
   "agentConversation",
   "trackAgentTurn",
   "on"
@@ -3240,7 +3413,7 @@ function parseTranslationCsv(text) {
 
 // src/index.ts
 var SDK_API_VERSION = "v1";
-var SHARED_VERSION = "0.16.0";
+var SHARED_VERSION = "0.17.0";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ADVANCE_ON,
@@ -3265,6 +3438,7 @@ var SHARED_VERSION = "0.16.0";
   AuthoringPickSchema,
   AutocaptureSettingsSchema,
   BUTTON_ACTIONS,
+  BugReportSchema,
   ButtonSchema,
   CAPTURE_PARAM,
   CAPTURE_SCREENSHOT_MAX_BYTES,
@@ -3330,6 +3504,10 @@ var SHARED_VERSION = "0.16.0";
   LocaleSchema,
   LocalizationSettingsSchema,
   MAX_ANNOTATIONS,
+  MAX_APP_VERSION_LENGTH,
+  MAX_BREADCRUMBS,
+  MAX_BUG_REPORT_LENGTH,
+  MAX_BUG_REPORT_SCREENSHOT_BYTES,
   MAX_COLLECTION_DEPTH,
   MAX_COMPLAINT_ANSWER_LENGTH,
   MAX_COMPLAINT_ATTACHMENT_BYTES,
@@ -3337,6 +3515,13 @@ var SHARED_VERSION = "0.16.0";
   MAX_COMPLAINT_FIELDS,
   MAX_COMPLAINT_LENGTH,
   MAX_CUSTOM_CSS,
+  MAX_DEBUG_IMAGES,
+  MAX_DETAIL_FRAMES,
+  MAX_DETAIL_THREADS,
+  MAX_ERROR_TAGS,
+  MAX_EXCEPTION_CHAIN,
+  MAX_EXCEPTION_DETAIL_BYTES,
+  MAX_EXCEPTION_DETAIL_RAW_BYTES,
   MAX_FEEDBACK_COMMENT,
   MAX_FEEDBACK_DESCRIPTION,
   MAX_FEEDBACK_NOTE,
@@ -3364,6 +3549,7 @@ var SHARED_VERSION = "0.16.0";
   PDF_PAGES_CLASS,
   PLACEMENTS,
   PLATFORMS,
+  PerformanceSettingsSchema,
   PostMessageSchema,
   ProjectThemeSchema,
   PublishedGuideSchema,
@@ -3433,11 +3619,13 @@ var SHARED_VERSION = "0.16.0";
   contrastIssues,
   contrastRatio,
   cssSelectorError,
+  customFingerprint,
   defaultGuideConfig,
   defaultStep,
   describeCaptureStep,
   describeRule,
   emptyRuleGroup,
+  errorFilterDrops,
   evaluateRule,
   evaluateRules,
   evenWeights,
@@ -3480,10 +3668,12 @@ var SHARED_VERSION = "0.16.0";
   mediaKind,
   mediaMaxBytes,
   needsReview,
+  normalizeAppVersion,
   normalizeErrorMessage,
   normalizeFrameFile,
   normalizeLocale,
   normalizeSnapshot,
+  normalizeTags,
   orderedModules,
   pageLabel,
   pageName,
@@ -3501,6 +3691,7 @@ var SHARED_VERSION = "0.16.0";
   propertyAttributeAllowed,
   queryConditionRegex,
   randomId,
+  reactNativeBundleUrl,
   readableTextOn,
   recordingLevel,
   relativeLuminance,
@@ -3531,6 +3722,7 @@ var SHARED_VERSION = "0.16.0";
   toTranslationCsv,
   toXliff,
   translationCoverage,
+  trimExceptionDetail,
   unreadAnnouncements,
   validateGuideConfig,
   variantProblems,