@appilots/sdk 0.2.0 → 0.3.0

package/dist/{chunk-HDLZGXNF.mjs → chunk-QMSMXTED.mjs}

@@ -8,10 +8,20 @@ var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require
   throw Error('Dynamic require of "' + x + '" is not supported');
 });
 
-// src/version.ts
-var SDK_VERSION = "0.1.0";
+// ../shared/dist/chunk-43YQ52Q7.mjs
+var SENSITIVE_FIELD_NAME_RE = /(\b|_|-)(password|senha|contrase[ñn]a|mot[\s_-]*de[\s_-]*passe|passwd|pwd|secret|token|api[\s_-]*key|access[\s_-]*key|private[\s_-]*key|cvv|cvc|cvn|cvc2|cid|pin(?:[\s_-]*code)?|otp|one[\s_-]*time[\s_-]*code|2fa|mfa|security[\s_-]*code|c[óo]digo[\s_-]*seguran[çc]a|c[óo]digo[\s_-]*verifica[çc][ãa]o|verification[\s_-]*code)(\b|_|-)/i;
+function isSensitiveFieldName(id, label, placeholder, type) {
+  if (type === "password") return true;
+  for (const candidate of [id, label, placeholder]) {
+    if (typeof candidate === "string" && SENSITIVE_FIELD_NAME_RE.test(candidate)) {
+      return true;
+    }
+  }
+  return false;
+}
 
-// src/services/AppilotsClient.ts
+// ../client-core/dist/index.mjs
+var SDK_VERSION = "0.1.0";
 var StreamTransportError = class extends Error {
   constructor(message) {
     super(message);
@@ -779,6 +789,591 @@ var AppilotsClient = class {
     };
   }
 };
+var defaultLightTheme = {
+  colors: {
+    primary: "#6366f1",
+    secondary: "#8b5cf6",
+    background: "#ffffff",
+    surface: "#f3f4f6",
+    text: "#1f2937",
+    textSecondary: "#6b7280",
+    border: "#e5e7eb",
+    // NOTE (BACKLOG 4.2): success/warning/error used to have ZERO visual
+    // consumers — nothing read them, so ActionBreadcrumb's tones and the
+    // confirm card's destructive accents were hardcoded separately with
+    // their OWN hex values (#10B981/#EF4444/#9CA3AF-ish grays). Since no
+    // other UI in the SDK reads these three tokens, we picked these
+    // defaults to exactly match those pre-existing hardcoded values —
+    // wiring the tokens up to ActionBreadcrumb (see breadcrumbPresentation.ts)
+    // is now a no-op for anyone on the bundled default theme, while a
+    // custom theme's success/warning/error now actually do something.
+    success: "#10b981",
+    warning: "#9ca3af",
+    error: "#ef4444",
+    // Same value as `text` — split out so an app can diverge them, but
+    // any app that doesn't set these renders pixel-identical to before.
+    buttonText: "#1f2937",
+    bubbleText: "#1f2937",
+    userBubbleText: "#ffffff"
+  },
+  typography: {
+    fontFamily: "System",
+    fontSizeXs: 11,
+    fontSizeSm: 13,
+    fontSizeBase: 15,
+    fontSizeLg: 18
+  },
+  radii: {
+    sm: 8,
+    md: 12,
+    lg: 16
+  },
+  shadows: {
+    appearance: "light"
+  }
+};
+var defaultDarkTheme = {
+  colors: {
+    primary: "#818cf8",
+    secondary: "#a78bfa",
+    background: "#0f172a",
+    surface: "#1e293b",
+    text: "#f1f5f9",
+    textSecondary: "#94a3b8",
+    border: "#334155",
+    // Kept IDENTICAL to the light theme's success/warning/error (not the
+    // usual "lighter for dark bg" adjustment other tokens get) — the
+    // breadcrumb's tones were a fixed, theme-agnostic hardcoded palette
+    // before this token existed, rendering the SAME hex in light and dark
+    // mode. Diverging them here would change dark-mode breadcrumbs even
+    // though nothing in the token tree asked for that.
+    success: "#10b981",
+    warning: "#9ca3af",
+    error: "#ef4444",
+    buttonText: "#f1f5f9",
+    bubbleText: "#f1f5f9",
+    userBubbleText: "#ffffff"
+  },
+  typography: { ...defaultLightTheme.typography },
+  radii: { ...defaultLightTheme.radii },
+  shadows: { appearance: "dark" }
+};
+function mergeThemeTokens(base, partial) {
+  if (!partial) return base;
+  return {
+    colors: { ...base.colors, ...partial.colors ?? {} },
+    typography: { ...base.typography, ...partial.typography ?? {} },
+    radii: { ...base.radii, ...partial.radii ?? {} },
+    shadows: { ...base.shadows, ...partial.shadows ?? {} }
+  };
+}
+function resolveBaseTheme(mode, systemScheme) {
+  if (mode === "dark") return defaultDarkTheme;
+  if (mode === "light") return defaultLightTheme;
+  return systemScheme === "dark" ? defaultDarkTheme : defaultLightTheme;
+}
+var LIST_ITEM_TARGET_RE = /^list-\d+-item-\d+$/i;
+var DESTRUCTIVE_LABEL_RE = /\b(cancelar?\w*|cancel(?:ar|led|ation|amento)?|delete\w*|exclu\w*|delet\w*|remov\w*|remove|apag\w*|destroy\w*|unsubscribe\w*)\b/i;
+function isListItemPressTarget(value) {
+  if (typeof value !== "string" || !value.trim()) return false;
+  return LIST_ITEM_TARGET_RE.test(value.trim());
+}
+function looksDestructiveActionLabel(value) {
+  if (typeof value !== "string" || !value.trim()) return false;
+  return DESTRUCTIVE_LABEL_RE.test(value.trim());
+}
+function actionPressTargetId(action) {
+  if (action.type !== "ui_interaction") return null;
+  const payload = action.payload;
+  const componentId = payload?.componentId;
+  if (typeof componentId === "string" && componentId.trim()) return componentId.trim();
+  const targetId = payload?.targetId;
+  if (typeof targetId === "string" && targetId.trim()) return targetId.trim();
+  return null;
+}
+function turnHasConfirmActions(actions) {
+  return actions.some((action) => action.type === "confirm");
+}
+function normalize(value) {
+  return value.normalize("NFD").replace(/[\u0300-\u036f]/g, "").replace(/[‘’]/g, "'").toLowerCase();
+}
+function detectLocaleFromUserTexts(texts) {
+  for (const raw of texts) {
+    const normalized = normalize(raw);
+    if (/[ãõáéíóúâêôç]/i.test(raw) || /\b(voce|voces|pra|assinatura|cancela|canela|segunda|certo|quais|tenho|pode|posso)\b/.test(
+      normalized
+    )) {
+      return "pt";
+    }
+    if (/[áéíóúñ¿¡]/i.test(raw) || /\b(cancela|segunda|suscripcion|puedo|cuales|hola)\b/.test(normalized)) {
+      return "es";
+    }
+    if (/[àâçéèêëîïôûùüÿœ]/i.test(raw) || /\b(annuler|deuxieme|abonnement|bonjour)\b/.test(normalized)) {
+      return "fr";
+    }
+  }
+  return "en";
+}
+var copy = {
+  pt: {
+    rateLimit: "O provedor de IA atingiu o limite de uso durante a automa\xE7\xE3o. Aguarde um momento e pe\xE7a para continuar, ou aumente o limite de tokens por minuto.",
+    invalidInput: "N\xE3o consegui continuar a automa\xE7\xE3o por um problema interno de sincroniza\xE7\xE3o. Pode tentar de novo ou fazer essa parte manualmente?",
+    generic: (detail) => `Perdi o fio da automa\xE7\xE3o (${detail}). Pode continuar manualmente ou me pedir de novo?`
+  },
+  es: {
+    rateLimit: "El proveedor de IA alcanz\xF3 su l\xEDmite de uso durante la automatizaci\xF3n. Espera un momento y p\xEDdeme continuar, o aumenta el l\xEDmite de tokens por minuto.",
+    invalidInput: "No pude continuar la automatizaci\xF3n por un problema interno de sincronizaci\xF3n. \xBFPuedes intentarlo de nuevo o hacer esta parte manualmente?",
+    generic: (detail) => `Perd\xED el hilo de la automatizaci\xF3n (${detail}). \xBFPuedes continuar manualmente o ped\xEDrmelo de nuevo?`
+  },
+  fr: {
+    rateLimit: "Le fournisseur d'IA a atteint sa limite d'utilisation pendant l'automatisation. Attendez un instant et demandez-moi de continuer, ou augmentez la limite de tokens par minute.",
+    invalidInput: "Je n'ai pas pu poursuivre l'automatisation \xE0 cause d'un probl\xE8me interne de synchronisation. Pouvez-vous r\xE9essayer ou faire cette \xE9tape manuellement ?",
+    generic: (detail) => `J'ai perdu le fil de l'automatisation (${detail}). Vous pouvez continuer manuellement ou me redemander ?`
+  },
+  en: {
+    rateLimit: "Your AI provider hit its rate limit during automation. Wait a moment and ask me to continue, or raise your TPM limit.",
+    invalidInput: "I could not continue the automation because of an internal sync issue. You can try again or take over manually.",
+    generic: (detail) => `I lost my footing during automation (${detail}). You can take over from here.`
+  }
+};
+function buildContinuationFailureMessage(rawError, recentUserTexts) {
+  const locale = detectLocaleFromUserTexts(recentUserTexts);
+  const strings = copy[locale] ?? copy.en;
+  if (/rate limit|tokens per min|tpm/i.test(rawError)) {
+    return strings.rateLimit;
+  }
+  if (/invalid input|validation_error|422/i.test(rawError)) {
+    return strings.invalidInput;
+  }
+  return strings.generic(rawError);
+}
+function metadataMatchesComponentId(metaId, componentId) {
+  const norm = (s) => s.toLowerCase().replace(/^el:(button|link|input|toggle|listitem)[:_-]/, "").replace(/^(btn-|btn_|button-|button_|link-|link_)/, "").trim();
+  const meta = norm(metaId);
+  const comp = norm(componentId);
+  if (!meta || !comp) return false;
+  return meta === comp;
+}
+function fingerprintAction(action, screen) {
+  const p = action.payload ?? {};
+  const scope = `@${screen ?? "?"}`;
+  switch (action.type) {
+    case "navigate":
+      return `navigate${scope}:${p.screenName ?? "?"}`;
+    case "form_fill": {
+      const fields = p.fields ?? [];
+      const ids = fields.map((f) => String(f?.fieldId ?? "?")).sort();
+      return `form_fill${scope}:${ids.join(",")}`;
+    }
+    case "ui_interaction":
+      return `ui_interaction${scope}:${p.action ?? "?"}:${p.componentId ?? p.targetId ?? "?"}`;
+    case "confirm":
+      return `confirm${scope}:${p.message ?? p.title ?? "?"}`;
+    default:
+      return `${action.type}${scope}:${JSON.stringify(p)}`;
+  }
+}
+function normalize2(s) {
+  return s.toLowerCase().normalize("NFD").replace(/[\u0300-\u036f]/g, "").replace(/[^a-z0-9]/g, "");
+}
+function matchScore(needle, hay) {
+  if (!needle || !hay) return 0;
+  if (needle === hay) return 100;
+  if (hay.startsWith(needle) || needle.startsWith(hay)) return 75;
+  if (hay.endsWith(needle) || needle.endsWith(hay)) return 60;
+  if (hay.includes(needle) || needle.includes(hay)) return 40;
+  return 0;
+}
+function isGenericSelectValue(value) {
+  if (value === void 0 || value === null || value === "") return true;
+  const normalized = normalize2(String(value));
+  if (!normalized) return true;
+  return /^(any|qualquer|random|aleatorio|aleatoria|auto|automatico|automatica|mock|mockado|mockada|mockados|mockadas|dummy|sample|exemplo|default|padrao|teste|test)$/.test(
+    normalized
+  );
+}
+var LIST_ORDINAL_RE = /^list-\d+-item-\d+$/i;
+function normalizeId(value) {
+  return value.normalize("NFD").replace(/[\u0300-\u036f]/g, "").toLowerCase();
+}
+function isOptionalCosmeticTargetId(targetId) {
+  if (typeof targetId !== "string" || !targetId.trim()) return false;
+  const id = normalizeId(targetId);
+  return /foto|photo|avatar|icone|icon|emoji|sheetaction|sheet-action|btn-foto/.test(id) || id.includes("photo-sheet");
+}
+function routeLooksLikeFormContext(route) {
+  const haystack = normalizeId(route ?? "");
+  return /create|edit|form|cadastr|register|novo|vehiclecreate|subscriptioncreate|vehicleedit|subscriptioncreate/.test(
+    haystack
+  );
+}
+function screenPathParts(screen) {
+  if (!screen) return [];
+  return screen.split("/").map((part) => part.trim()).filter(Boolean);
+}
+function isMisappliedListOrdinalOnForm(targetId, screen, activePath) {
+  if (typeof targetId !== "string" || !LIST_ORDINAL_RE.test(targetId.trim())) {
+    return false;
+  }
+  const routes = [...screenPathParts(screen), ...activePath ?? []];
+  if (routes.length === 0) return routeLooksLikeFormContext(screen);
+  return routes.some((route) => routeLooksLikeFormContext(route));
+}
+function isOptionalStepAutomationFailure(targetId, screen, activePath) {
+  return isOptionalCosmeticTargetId(targetId) || isMisappliedListOrdinalOnForm(targetId, screen, activePath);
+}
+var OPTIONAL_STEP_AUTOMATION_HINT = "optional-step-automation-failed";
+var MAX_TRACE_ENTRIES = 200;
+var entries = [];
+var listeners = /* @__PURE__ */ new Set();
+var traceCounter = 0;
+function notify() {
+  const snapshot = [...entries];
+  listeners.forEach((listener) => listener(snapshot));
+}
+function append(entry) {
+  entries.push(entry);
+  if (entries.length > MAX_TRACE_ENTRIES) {
+    entries.splice(0, entries.length - MAX_TRACE_ENTRIES);
+  }
+  notify();
+}
+function recordAppilotsDebugTrace(entry) {
+  append({
+    ...entry,
+    id: entry.id ?? `trace_${++traceCounter}`
+  });
+}
+function actionFromEvent(event) {
+  const action = event.data?.action;
+  if (action && typeof action === "object" && typeof action.id === "string") {
+    return action;
+  }
+  return void 0;
+}
+function recordAppilotsEventTrace(event) {
+  if (!event.type.startsWith("agent:action:")) return;
+  const action = actionFromEvent(event);
+  const actionId = action?.id || (typeof event.data?.actionId === "string" ? event.data.actionId : void 0);
+  const actionType = action?.type || (typeof event.data?.actionType === "string" ? event.data.actionType : void 0);
+  recordAppilotsDebugTrace({
+    timestamp: event.timestamp,
+    type: event.type,
+    messageId: action?.messageId,
+    actionId,
+    actionType,
+    status: event.type === "agent:action:start" ? "started" : event.type === "agent:action:complete" ? "completed" : "error",
+    data: event.data
+  });
+}
+function getAppilotsDebugTraces() {
+  return [...entries];
+}
+function clearAppilotsDebugTraces() {
+  entries.splice(0, entries.length);
+  notify();
+}
+function subscribeAppilotsDebugTraces(listener) {
+  listeners.add(listener);
+  listener([...entries]);
+  return () => {
+    listeners.delete(listener);
+  };
+}
+function describeAction(action) {
+  const state = mapStatus(action.status);
+  const label = labelFor(action, state);
+  return { label, state };
+}
+function mapStatus(status) {
+  switch (status) {
+    case "pending":
+      return "pending";
+    case "executing":
+      return "running";
+    case "completed":
+      return "success";
+    case "failed":
+      return "failed";
+    default:
+      return "pending";
+  }
+}
+function labelFor(action, state) {
+  if (state === "failed") {
+    return failureLabel(action);
+  }
+  switch (action.type) {
+    case "navigate":
+      return navigateLabel(action, state);
+    case "form_fill":
+      return formFillLabel(action, state);
+    case "ui_interaction":
+      return uiInteractionLabel(action, state);
+    case "scroll_list":
+      return scrollListLabel(action, state);
+    case "confirm":
+      return confirmLabel(state);
+    default:
+      return genericLabel(action.type, state);
+  }
+}
+function navigateLabel(action, state) {
+  const screen = readString(action.payload, "screenName") || "a outra tela";
+  switch (state) {
+    case "pending":
+      return `Vou navegar para ${screen}`;
+    case "running":
+      return `Navegando para ${screen}...`;
+    case "success":
+      return `Naveguei para ${screen}`;
+    default:
+      return `Navega\xE7\xE3o para ${screen}`;
+  }
+}
+function formFillLabel(action, state) {
+  const fields = readArray(action.payload, "fields");
+  const summary = summariseFields(fields);
+  switch (state) {
+    case "pending":
+      return summary ? `Vou preencher ${summary}` : "Vou preencher o formul\xE1rio";
+    case "running":
+      return summary ? `Preenchendo ${summary}...` : "Preenchendo formul\xE1rio...";
+    case "success":
+      return summary ? `Preenchi ${summary}` : "Preenchi o formul\xE1rio";
+    default:
+      return "Preenchimento do formul\xE1rio";
+  }
+}
+function uiInteractionLabel(action, state) {
+  const verbBase = uiVerb(readString(action.payload, "action"));
+  const target = humanActionTarget(action.payload);
+  const where = target ? ` em ${target}` : "";
+  switch (state) {
+    case "pending":
+      return `Vou ${verbBase.infinitive}${where}`;
+    case "running":
+      return `${verbBase.gerund}${where}...`;
+    case "success":
+      return `${verbBase.past}${where}`;
+    default:
+      return `Intera\xE7\xE3o${where}`;
+  }
+}
+function scrollListLabel(action, state) {
+  const payload = action.payload;
+  const toIndex = typeof payload?.toIndex === "number" ? payload.toIndex : void 0;
+  const direction = payload?.direction === "up" ? "para cima" : "para baixo";
+  const target = toIndex !== void 0 ? `at\xE9 o item ${toIndex}` : direction;
+  switch (state) {
+    case "pending":
+      return `Vou rolar a lista ${target}`;
+    case "running":
+      return `Rolando a lista ${target}...`;
+    case "success":
+      return `Rolei a lista ${target}`;
+    default:
+      return "Rolagem da lista";
+  }
+}
+function confirmLabel(state) {
+  switch (state) {
+    case "pending":
+    case "running":
+      return "Aguardando confirma\xE7\xE3o";
+    case "success":
+      return "Voc\xEA confirmou";
+    case "failed":
+      return "Confirma\xE7\xE3o cancelada";
+    default:
+      return "Confirma\xE7\xE3o";
+  }
+}
+function genericLabel(type, state) {
+  switch (state) {
+    case "pending":
+      return `Vou executar ${type}`;
+    case "running":
+      return `Executando ${type}...`;
+    case "success":
+      return `Executei ${type}`;
+    default:
+      return type;
+  }
+}
+function failureLabel(action) {
+  const cause = humanizeError(action.error);
+  const head = failureHead(action);
+  return cause ? `${head} (${cause})` : head;
+}
+function failureHead(action) {
+  switch (action.type) {
+    case "navigate": {
+      const screen = readString(action.payload, "screenName") || "a tela";
+      return `N\xE3o consegui navegar para ${screen}`;
+    }
+    case "form_fill":
+      return "N\xE3o consegui preencher o formul\xE1rio";
+    case "ui_interaction": {
+      const verb = uiVerb(readString(action.payload, "action"));
+      const target = humanComponentId(
+        readString(action.payload, "componentId") || readString(action.payload, "targetId")
+      );
+      return target ? `N\xE3o consegui ${verb.infinitive} em ${target}` : `N\xE3o consegui ${verb.infinitive}`;
+    }
+    case "scroll_list":
+      return "N\xE3o consegui rolar a lista";
+    case "confirm":
+      return "Voc\xEA cancelou";
+    default:
+      return `N\xE3o consegui executar ${action.type}`;
+  }
+}
+var TECHNICAL_PATTERNS = [
+  /\bat\s+\S+\s*\(/,
+  // stack trace frame
+  /TypeError|ReferenceError|SyntaxError|RangeError/i,
+  /HTTP\s*[45]\d{2}/i,
+  /^\s*\{[\s\S]*\}\s*$/,
+  // JSON dump
+  /undefined is not a function/i,
+  /Cannot read propert/i
+];
+var FRIENDLY_REWRITES = [
+  [/rejected by user/i, "cancelado pelo usu\xE1rio"],
+  [/component '([^']+)' not found/i, "componente $1 n\xE3o encontrado"],
+  [/field '([^']+)' not found/i, "campo $1 n\xE3o encontrado"],
+  [/screen '([^']+)' not registered/i, "tela $1 n\xE3o registrada"],
+  [/permission denied/i, "sem permiss\xE3o"],
+  [/timeout|timed out/i, "tempo esgotado"],
+  [/network/i, "falha de rede"]
+];
+var MAX_REASON_LEN = 80;
+function humanizeError(raw, _action) {
+  if (!raw) return void 0;
+  const trimmed = String(raw).trim();
+  if (!trimmed) return void 0;
+  for (const [pattern, replacement] of FRIENDLY_REWRITES) {
+    if (pattern.test(trimmed)) {
+      return finalize(trimmed.replace(pattern, replacement));
+    }
+  }
+  if (TECHNICAL_PATTERNS.some((p) => p.test(trimmed))) {
+    return "algo deu errado";
+  }
+  if (trimmed.length > MAX_REASON_LEN) {
+    return "algo deu errado";
+  }
+  return finalize(trimmed);
+}
+function finalize(text) {
+  let out = text.trim();
+  if (out.length > MAX_REASON_LEN) out = out.slice(0, MAX_REASON_LEN - 1).trimEnd() + "\u2026";
+  if (out.length > 0) out = out[0].toLowerCase() + out.slice(1);
+  return out;
+}
+function uiVerb(raw) {
+  switch ((raw ?? "press").toLowerCase()) {
+    case "press":
+    case "tap":
+    case "click":
+      return { infinitive: "clicar", gerund: "Clicando", past: "Cliquei" };
+    case "longpress":
+    case "long_press":
+      return { infinitive: "pressionar", gerund: "Pressionando", past: "Pressionei" };
+    case "scroll":
+    case "scroll_to":
+      return { infinitive: "rolar", gerund: "Rolando", past: "Rolei" };
+    case "focus":
+      return { infinitive: "focar", gerund: "Focando", past: "Foquei" };
+    default:
+      return { infinitive: "interagir", gerund: "Interagindo", past: "Interagi" };
+  }
+}
+function summariseFields(fields) {
+  if (!Array.isArray(fields) || fields.length === 0) return void 0;
+  const parts = [];
+  const visible = fields.slice(0, 3);
+  for (const f of visible) {
+    if (!f || typeof f !== "object") continue;
+    const obj = f;
+    const name = humanFieldName(obj.label, obj.fieldId);
+    if (!name) continue;
+    const fieldIdStr = typeof obj.fieldId === "string" ? obj.fieldId : void 0;
+    const labelStr = typeof obj.label === "string" ? obj.label : void 0;
+    const fieldTypeStr = typeof obj.fieldType === "string" ? obj.fieldType : void 0;
+    const sensitive = isSensitiveFieldName(fieldIdStr, labelStr, void 0, fieldTypeStr);
+    if (sensitive) {
+      parts.push(`${name}=\u2022\u2022\u2022\u2022`);
+      continue;
+    }
+    const value = formatFieldValue(obj.value);
+    parts.push(value !== void 0 ? `${name}=${value}` : name);
+  }
+  if (parts.length === 0) return void 0;
+  const extra = fields.length - parts.length;
+  return extra > 0 ? `${parts.join(", ")} +${extra}` : parts.join(", ");
+}
+function formatFieldValue(value) {
+  if (value === void 0 || value === null || value === "") return void 0;
+  if (typeof value === "string") {
+    const v = value.length > 18 ? `${value.slice(0, 17)}\u2026` : value;
+    return `"${v}"`;
+  }
+  if (typeof value === "number" || typeof value === "boolean") return String(value);
+  return void 0;
+}
+function humanActionTarget(payload) {
+  if (!payload || typeof payload !== "object") return "";
+  const record = payload;
+  const friendly = readFriendlyString(record, "label") || readFriendlyString(record, "actionDescription") || readFriendlyString(record, "title") || readFriendlyString(record, "name");
+  if (friendly) return friendly;
+  return humanComponentId(
+    readString(payload, "componentId") || readString(payload, "targetId")
+  );
+}
+function humanFieldName(label, fieldId) {
+  if (typeof label === "string" && label.trim()) return label.trim();
+  if (typeof fieldId !== "string" || isTechnicalIdentifier(fieldId)) return void 0;
+  return humanComponentId(fieldId) || void 0;
+}
+function readFriendlyString(record, key) {
+  const value = record[key];
+  if (typeof value !== "string") return "";
+  const trimmed = value.trim();
+  if (!trimmed || isTechnicalIdentifier(trimmed)) return "";
+  return trimmed;
+}
+function humanComponentId(id) {
+  if (!id) return "";
+  if (isTechnicalIdentifier(id)) return "";
+  const cleaned = id.replace(/^(btn-|btn_|button-|component-)/i, "").replace(/([a-z0-9])([A-Z])/g, "$1 $2").replace(/[-_]+/g, " ").trim();
+  if (!cleaned) return "";
+  return cleaned[0].toUpperCase() + cleaned.slice(1);
+}
+function isTechnicalIdentifier(value) {
+  const raw = value.trim();
+  if (!raw) return false;
+  if (/^el:/i.test(raw)) return true;
+  if (/^list-\d+-item-\d+$/i.test(raw)) return true;
+  if (/(testid|test-id|accessibilityid|accessibility-id|automationid|automation-id)/i.test(raw)) {
+    return true;
+  }
+  if (/^[a-z]+:[^ ]+:[^ ]+/i.test(raw)) return true;
+  if (/^[A-Za-z][\w-]*:[^\s]+$/i.test(raw)) return true;
+  if (/^[a-z]+(?:[-_][a-z]+)*[-_][a-z0-9]{5,}$/i.test(raw)) return true;
+  return false;
+}
+function readString(payload, key) {
+  if (!payload || typeof payload !== "object") return "";
+  const v = payload[key];
+  return typeof v === "string" ? v : "";
+}
+function readArray(payload, key) {
+  if (!payload || typeof payload !== "object") return [];
+  const v = payload[key];
+  return Array.isArray(v) ? v : [];
+}
 
 // src/registry/ComponentRegistry.ts
 var ComponentRegistryImpl = class {
@@ -1012,7 +1607,7 @@ function getDefaultRegistry() {
 }
 
 // src/auto/idExtraction.ts
-function normalizeId(raw) {
+function normalizeId2(raw) {
   return raw.toLowerCase().normalize("NFD").replace(/[̀-ͯ]/g, "").replace(/^(input-|btn-|toggle-|switch-)/, "").replace(/[^a-z0-9\s-_]/g, "").trim().replace(/[-_\s]+(.)/g, (_, c) => c.toUpperCase()).replace(/[-_\s]+$/, "");
 }
 function deriveSemanticInputId(props) {
@@ -1060,7 +1655,7 @@ function sectionListFlatIndex(sections, section, localIndex) {
 function extractId(props) {
   const raw = props?.testID ?? props?.nativeID ?? props?.id ?? props?.accessibilityLabel ?? props?.name ?? props?.placeholder ?? (typeof props?.autoComplete === "string" && props.autoComplete !== "off" ? props.autoComplete : void 0);
   if (raw && typeof raw === "string") {
-    const normalized = normalizeId(raw);
+    const normalized = normalizeId2(raw);
     if (normalized && normalized.length > 0) {
       console.log(`[Appilots] extractId: raw="${raw}" \u2192 normalized="${normalized}"`);
       return normalized;
@@ -1211,7 +1806,7 @@ function componentDisplayName(type) {
 function extractListId(props, componentName) {
   const raw = props?.appilotsListId ?? props?.testID ?? props?.nativeID ?? props?.id ?? props?.accessibilityLabel ?? props?.name;
   if (typeof raw === "string" && raw.trim().length > 0) {
-    const normalized = normalizeId(raw);
+    const normalized = normalizeId2(raw);
     if (normalized) return normalized;
   }
   _generatedListIdCounter += 1;
@@ -1641,65 +2236,6 @@ function getGlobalConfig() {
   return _globalConfig;
 }
 
-// src/debug/actionTraceStore.ts
-var MAX_TRACE_ENTRIES = 200;
-var entries = [];
-var listeners = /* @__PURE__ */ new Set();
-var traceCounter = 0;
-function notify() {
-  const snapshot = [...entries];
-  listeners.forEach((listener) => listener(snapshot));
-}
-function append(entry) {
-  entries.push(entry);
-  if (entries.length > MAX_TRACE_ENTRIES) {
-    entries.splice(0, entries.length - MAX_TRACE_ENTRIES);
-  }
-  notify();
-}
-function recordAppilotsDebugTrace(entry) {
-  append({
-    ...entry,
-    id: entry.id ?? `trace_${++traceCounter}`
-  });
-}
-function actionFromEvent(event) {
-  const action = event.data?.action;
-  if (action && typeof action === "object" && typeof action.id === "string") {
-    return action;
-  }
-  return void 0;
-}
-function recordAppilotsEventTrace(event) {
-  if (!event.type.startsWith("agent:action:")) return;
-  const action = actionFromEvent(event);
-  const actionId = action?.id || (typeof event.data?.actionId === "string" ? event.data.actionId : void 0);
-  const actionType = action?.type || (typeof event.data?.actionType === "string" ? event.data.actionType : void 0);
-  recordAppilotsDebugTrace({
-    timestamp: event.timestamp,
-    type: event.type,
-    messageId: action?.messageId,
-    actionId,
-    actionType,
-    status: event.type === "agent:action:start" ? "started" : event.type === "agent:action:complete" ? "completed" : "error",
-    data: event.data
-  });
-}
-function getAppilotsDebugTraces() {
-  return [...entries];
-}
-function clearAppilotsDebugTraces() {
-  entries.splice(0, entries.length);
-  notify();
-}
-function subscribeAppilotsDebugTraces(listener) {
-  listeners.add(listener);
-  listener([...entries]);
-  return () => {
-    listeners.delete(listener);
-  };
-}
-
 // src/introspection/fiberRoot.ts
 var _fiberRoot = null;
 function setFiberRoot(fiber) {
@@ -2345,4 +2881,4 @@ function clearScreenRegistry() {
   screenRegistry.clear();
 }
 
-export { AppilotsClient, AppilotsProvider, AppilotsRegistryProvider, SDK_VERSION, StreamAbortError, StreamTransportError, _patchJsxRuntimes, appilotsDebugWarn, clearAppilotsDebugTraces, clearScreenRegistry, componentRegistry, createComponentRegistry, createElementRegistry, createListRegistry, elementRegistry, enableAppilotsAutoTracking, getActiveRouteNames, getAllScreens, getAppilotsDebugTraces, getCurrentScreen, getCurrentScreenSignature, getDefaultRegistry, getFiberRoot, getGlobalConfig, getNavigationRef, getNavigationStateSnapshot, getScreenMetadata, initAppilots, isAutoTrackingEnabled, listRegistry, probeLoadingState, recordAppilotsDebugTrace, registerScreen, routesBelongToSameFeature, screenDepartedBaseline, setCurrentScreen, setNavigationRef, subscribeAppilotsDebugTraces, useAppilotsContext, useResolvedRegistry, waitForLoadingSettle, waitForScreenSettle };
+export { AppilotsClient, AppilotsProvider, AppilotsRegistryProvider, OPTIONAL_STEP_AUTOMATION_HINT, SDK_VERSION, StreamAbortError, StreamTransportError, _patchJsxRuntimes, actionPressTargetId, appilotsDebugWarn, buildContinuationFailureMessage, clearAppilotsDebugTraces, clearScreenRegistry, componentRegistry, createComponentRegistry, createElementRegistry, createListRegistry, defaultDarkTheme, defaultLightTheme, describeAction, elementRegistry, enableAppilotsAutoTracking, fingerprintAction, getActiveRouteNames, getAllScreens, getAppilotsDebugTraces, getCurrentScreen, getCurrentScreenSignature, getDefaultRegistry, getFiberRoot, getGlobalConfig, getNavigationRef, getNavigationStateSnapshot, getScreenMetadata, humanizeError, initAppilots, isAutoTrackingEnabled, isGenericSelectValue, isListItemPressTarget, isOptionalStepAutomationFailure, listRegistry, looksDestructiveActionLabel, matchScore, mergeThemeTokens, metadataMatchesComponentId, normalize2, probeLoadingState, recordAppilotsDebugTrace, registerScreen, resolveBaseTheme, routesBelongToSameFeature, screenDepartedBaseline, setCurrentScreen, setNavigationRef, subscribeAppilotsDebugTraces, turnHasConfirmActions, useAppilotsContext, useResolvedRegistry, waitForLoadingSettle, waitForScreenSettle };