@appilots/sdk 0.6.0 → 0.8.0

package/README.md

@@ -33,6 +33,47 @@ function App() {
 }
 ```
 
+## What happens when Appilots breaks
+
+The SDK renders inside your app, so a bug of ours must never become an
+outage of yours. Both render surfaces sit behind an error boundary:
+
+- If the **provider** throws, your app keeps rendering. The assistant
+  goes inert — `AppilotsChat` renders nothing, and `useAppilots()` keeps
+  returning a context (with `degraded: true`) so your own code does not
+  throw either.
+- If the **chat** throws, only the chat disappears.
+- If the **auto-tracking interceptor** throws on some element, that
+  element renders untouched; the agent just does not see it.
+
+In every case we log a `console.error` that says plainly it is our bug,
+not yours, and the failure is reported to the Appilots dashboard on the
+next session so we find out without you having to file anything.
+
+Degradation lasts for the session — a surface that crashed once usually
+crashes again, and an assistant blinking in and out of your product is
+worse than an absent one. An exception thrown by **your** components is
+never swallowed: it propagates to your own error boundary as it would
+without us.
+
+## Native confirmation dialogs
+
+When the user approves a destructive action on the chat's confirm card
+and your code then calls `Alert.alert` to double-check, the SDK answers
+that dialog once on their behalf — otherwise they are asked the same
+question twice and the second dialog is one the agent cannot press.
+
+Doing that means briefly replacing `Alert.alert`, a global that belongs
+to your app. The replacement is refcounted, restored even if the action
+throws, answers at most one dialog, never presses a `style: 'cancel'`
+button, and expires about a second after the press so unrelated alerts
+(background sync, push handlers) are never touched. To turn it off and
+show your own dialog instead:
+
+```tsx
+<AppilotsProvider config={{ projectId: '…', suppressNativeConfirm: false }}>
+```
+
 ## Documentation
 
 Full documentation available at [docs.appilots.com](https://docs.appilots.com)

package/dist/{chunk-DZ7QRFHD.js → chunk-AYWMBMSN.js}

@@ -82,7 +82,9 @@ var AppilotsClient = class {
       "Content-Type": "application/json",
       // Version telemetry: lets the server correlate behavior per SDK
       // release and pick the MCP doc matching this app build (B.4).
-      "X-Appilots-Sdk-Version": SDK_VERSION,
+      // The platform SDK supplies its own published version; the
+      // client-core constant is only the fallback (see `sdkVersion`).
+      "X-Appilots-Sdk-Version": options.sdkVersion ?? SDK_VERSION,
       ...options.appVersion ? { "X-App-Version": options.appVersion } : {},
       ...options.mcpVersion ? { "X-Appilots-Mcp-Version": options.mcpVersion } : {},
       ...options.apiKey ? { Authorization: `Bearer ${options.apiKey}` } : {},
@@ -197,7 +199,8 @@ var AppilotsClient = class {
   introspectionFragment() {
     try {
       const report = this.introspectionReporter?.();
-      if (!report || report.captured !== false) return {};
+      if (!report) return {};
+      if (report.captured !== false && !report.failureReason) return {};
       return { introspection: report };
     } catch {
       return {};
@@ -2848,6 +2851,114 @@ function attachElementIdsToChoiceGroups(choiceGroups, elements) {
     })
   }));
 }
+var WIRE_LIMITS = {
+  route: 200,
+  texts: 500,
+  textLength: 2e3,
+  inputs: 300,
+  buttons: 300,
+  toggles: 300,
+  sliders: 100,
+  lists: 100,
+  listItems: 500,
+  listDataPreview: 500,
+  listDataPreviewTextLength: 500,
+  choiceGroups: 100,
+  choiceOptions: 200,
+  elements: 1e3,
+  elementTexts: 50,
+  elementTextLength: 500,
+  elementActions: 20,
+  idLength: 160,
+  labelLength: 300,
+  valueLength: 4096,
+  containerTypeLength: 60};
+var Cut = class {
+  dropped = false;
+  /** Cap an array's length, remembering whether entries were lost. */
+  array(values, max) {
+    if (!values || values.length <= max) return values;
+    this.dropped = true;
+    return values.slice(0, max);
+  }
+  string(value, max) {
+    if (value === void 0 || value.length <= max) return value;
+    this.dropped = true;
+    return value.slice(0, max);
+  }
+};
+function clampInput(cut, input) {
+  input.id = cut.string(input.id, WIRE_LIMITS.idLength);
+  input.label = cut.string(input.label, WIRE_LIMITS.labelLength);
+  input.placeholder = cut.string(input.placeholder, WIRE_LIMITS.labelLength);
+  input.value = cut.string(input.value, WIRE_LIMITS.valueLength);
+  return input;
+}
+function clampList(cut, list) {
+  list.id = cut.string(list.id, WIRE_LIMITS.idLength);
+  list.containerType = cut.string(list.containerType, WIRE_LIMITS.containerTypeLength);
+  list.label = cut.string(list.label, WIRE_LIMITS.labelLength);
+  list.items = cut.array(list.items, WIRE_LIMITS.listItems) ?? [];
+  if (list.dataPreview) {
+    list.dataPreview = cut.array(list.dataPreview, WIRE_LIMITS.listDataPreview);
+    for (const entry of list.dataPreview ?? []) {
+      entry.key = cut.string(entry.key, WIRE_LIMITS.idLength);
+      entry.text = cut.string(entry.text, WIRE_LIMITS.listDataPreviewTextLength);
+    }
+  }
+  return list;
+}
+function clampChoiceGroup(cut, group) {
+  group.id = cut.string(group.id, WIRE_LIMITS.idLength);
+  group.label = cut.string(group.label, WIRE_LIMITS.labelLength);
+  group.options = cut.array(group.options, WIRE_LIMITS.choiceOptions) ?? [];
+  return group;
+}
+function clampSnapshotToWireLimits(snapshot) {
+  const cut = new Cut();
+  if (typeof snapshot.route === "string") {
+    snapshot.route = cut.string(snapshot.route, WIRE_LIMITS.route);
+  }
+  snapshot.texts = (cut.array(snapshot.texts, WIRE_LIMITS.texts) ?? []).map(
+    (text) => cut.string(text, WIRE_LIMITS.textLength)
+  );
+  snapshot.inputs = (cut.array(snapshot.inputs, WIRE_LIMITS.inputs) ?? []).map(
+    (input) => clampInput(cut, input)
+  );
+  snapshot.buttons = (cut.array(snapshot.buttons, WIRE_LIMITS.buttons) ?? []).map((button) => {
+    button.id = cut.string(button.id, WIRE_LIMITS.idLength);
+    button.label = cut.string(button.label, WIRE_LIMITS.labelLength);
+    return button;
+  });
+  snapshot.toggles = (cut.array(snapshot.toggles, WIRE_LIMITS.toggles) ?? []).map((toggle) => {
+    toggle.id = cut.string(toggle.id, WIRE_LIMITS.idLength);
+    toggle.label = cut.string(toggle.label, WIRE_LIMITS.labelLength);
+    return toggle;
+  });
+  snapshot.sliders = (cut.array(snapshot.sliders, WIRE_LIMITS.sliders) ?? []).map((slider) => {
+    slider.id = cut.string(slider.id, WIRE_LIMITS.idLength);
+    slider.label = cut.string(slider.label, WIRE_LIMITS.labelLength);
+    return slider;
+  });
+  snapshot.lists = (cut.array(snapshot.lists, WIRE_LIMITS.lists) ?? []).map(
+    (list) => clampList(cut, list)
+  );
+  snapshot.choiceGroups = (cut.array(snapshot.choiceGroups, WIRE_LIMITS.choiceGroups) ?? []).map(
+    (group) => clampChoiceGroup(cut, group)
+  );
+  snapshot.elements = (cut.array(snapshot.elements, WIRE_LIMITS.elements) ?? []).map((element) => {
+    element.id = cut.string(element.id, WIRE_LIMITS.idLength);
+    element.label = cut.string(element.label, WIRE_LIMITS.labelLength);
+    element.targetId = cut.string(element.targetId, WIRE_LIMITS.idLength);
+    element.texts = (cut.array(element.texts, WIRE_LIMITS.elementTexts) ?? []).map(
+      (text) => cut.string(text, WIRE_LIMITS.elementTextLength)
+    );
+    element.actions = cut.array(element.actions, WIRE_LIMITS.elementActions) ?? [];
+    return element;
+  });
+  if (cut.dropped) snapshot.truncated = true;
+  return snapshot;
+}
 
 // src/registry/ComponentRegistry.ts
 var ComponentRegistryImpl = class {
@@ -3125,6 +3236,40 @@ function sectionListFlatIndex(sections, section, localIndex) {
   return base + localIndex;
 }
 
+// src/auto/interceptGuard.ts
+var _intercept = null;
+var _failures = 0;
+var INTERCEPT_FAILURE_LIMIT = 25;
+function setInterceptor(fn) {
+  _intercept = fn;
+  _failures = 0;
+}
+function isInterceptionActive() {
+  return _intercept !== null;
+}
+function safeIntercept(type, props) {
+  const intercept = _intercept;
+  if (!intercept) return null;
+  try {
+    return intercept(type, props);
+  } catch (err) {
+    _failures += 1;
+    if (_failures === 1) {
+      console.error(
+        "[Appilots] Auto-tracking failed to inspect an element and passed it through unchanged. Your app is unaffected; the agent may not see this component. This is an Appilots bug \u2014 please report it: https://github.com/Axtern-Labs/Appilots/issues",
+        err
+      );
+    }
+    if (_failures >= INTERCEPT_FAILURE_LIMIT) {
+      _intercept = null;
+      console.error(
+        `[Appilots] Auto-tracking disabled after ${INTERCEPT_FAILURE_LIMIT} failures. The agent will only see components registered explicitly via registerScreen(). Your app is unaffected.`
+      );
+    }
+    return null;
+  }
+}
+
 // src/auto/enableAutoTracking.tsx
 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);
@@ -3583,15 +3728,15 @@ function enableAppilotsAutoTracking(options) {
     }
     return null;
   }
+  setInterceptor(interceptType);
   React2__default.default.createElement = function(type, props, ...children) {
-    const replacement = interceptType(type, props);
+    const replacement = safeIntercept(type, props);
     if (replacement) {
       return originalCreateElement(replacement.type, replacement.props, ...children);
     }
     return originalCreateElement(type, props, ...children);
   };
   console.log("[Appilots] Auto-tracking: React.createElement patched");
-  _interceptType = interceptType;
   try {
     const jsxRuntime = __require("react/jsx-runtime");
     if (jsxRuntime) {
@@ -3609,18 +3754,16 @@ function enableAppilotsAutoTracking(options) {
     console.log("[Appilots] Auto-tracking: react/jsx-dev-runtime not available internally (will be patched by metro shim)");
   }
 }
-var _interceptType = null;
 var _jsxRuntimePatched = false;
 var _jsxDevRuntimePatched = false;
 function _patchJsxRuntimeModule(jsxRuntime) {
-  if (_jsxRuntimePatched || !_interceptType || !jsxRuntime) return;
+  if (_jsxRuntimePatched || !isInterceptionActive() || !jsxRuntime) return;
   _jsxRuntimePatched = true;
-  const interceptType = _interceptType;
   const origJsx = jsxRuntime.jsx;
   const origJsxs = jsxRuntime.jsxs;
   if (origJsx) {
     jsxRuntime.jsx = function(type, props, key) {
-      const replacement = interceptType(type, props);
+      const replacement = safeIntercept(type, props);
       if (replacement) {
         return origJsx(replacement.type, replacement.props, key);
       }
@@ -3630,7 +3773,7 @@ function _patchJsxRuntimeModule(jsxRuntime) {
   }
   if (origJsxs) {
     jsxRuntime.jsxs = function(type, props, key) {
-      const replacement = interceptType(type, props);
+      const replacement = safeIntercept(type, props);
       if (replacement) {
         return origJsxs(replacement.type, replacement.props, key);
       }
@@ -3640,13 +3783,12 @@ function _patchJsxRuntimeModule(jsxRuntime) {
   }
 }
 function _patchJsxDevRuntimeModule(jsxDevRuntime) {
-  if (_jsxDevRuntimePatched || !_interceptType || !jsxDevRuntime) return;
+  if (_jsxDevRuntimePatched || !isInterceptionActive() || !jsxDevRuntime) return;
   _jsxDevRuntimePatched = true;
-  const interceptType = _interceptType;
   if (jsxDevRuntime.jsxDEV) {
     const origJsxDEV = jsxDevRuntime.jsxDEV;
     jsxDevRuntime.jsxDEV = function(type, props, key, isStaticChildren, source, self) {
-      const replacement = interceptType(type, props);
+      const replacement = safeIntercept(type, props);
       if (replacement) {
         return origJsxDEV(replacement.type, replacement.props, key, isStaticChildren, source, self);
       }
@@ -3656,7 +3798,7 @@ function _patchJsxDevRuntimeModule(jsxDevRuntime) {
   }
 }
 function _patchJsxRuntimes(jsxRuntime, jsxDevRuntime) {
-  if (!_interceptType) {
+  if (!isInterceptionActive()) {
     console.warn("[Appilots] _patchJsxRuntimes called but auto-tracking is not enabled");
     return;
   }
@@ -3726,7 +3868,14 @@ function setFiberRoot(fiber) {
   _diagnostics.captured = true;
 }
 function getFiberRoot() {
-  return _fiberRoot;
+  return resolveCurrentRoot(_fiberRoot);
+}
+function resolveCurrentRoot(fiber) {
+  const current = fiber?.stateNode?.current;
+  if (current && (current === fiber || current.alternate === fiber)) {
+    return current;
+  }
+  return fiber;
 }
 function recordIntrospectionFailure(reason, reactVersion) {
   _diagnostics.failureCount += 1;
@@ -3735,6 +3884,13 @@ function recordIntrospectionFailure(reason, reactVersion) {
     _diagnostics.reactVersion = reactVersion;
   }
 }
+function recordRenderFailure(reactVersion) {
+  _fiberRoot = null;
+  _diagnostics.captured = false;
+  _diagnostics.failureCount += 1;
+  _diagnostics.failureReason = "render-crashed";
+  _diagnostics.reactVersion = reactVersion;
+}
 function getIntrospectionDiagnostics() {
   return { ..._diagnostics };
 }
@@ -3746,6 +3902,9 @@ function typeName(fiber) {
   if (typeof t === "object") return t.displayName ?? t.render?.displayName ?? t.render?.name ?? "forwardRef/memo";
   return String(t);
 }
+
+// src/version.ts
+var SDK_VERSION2 = "0.8.0";
 var FiberSentinel = class extends React2__default.default.Component {
   componentDidMount() {
     const fiber = this._reactInternals ?? this._reactInternalFiber ?? null;
@@ -3795,10 +3954,83 @@ function appilotsDebugWarn(...args) {
   if (!isDebugEnabled()) return;
   console.log("[Appilots]", ...args);
 }
+var AppilotsErrorBoundary = class extends React2__default.default.Component {
+  state = { degraded: false, escalate: null };
+  /**
+   * Instance field rather than state: `componentDidCatch` needs to know
+   * whether THIS is the first failure, and by the time it runs
+   * `getDerivedStateFromError` has already flipped `state.degraded`.
+   */
+  hasDegradedOnce = false;
+  static getDerivedStateFromError() {
+    return { degraded: true };
+  }
+  componentDidCatch(error, info) {
+    if (this.hasDegradedOnce) {
+      this.setState({ escalate: error ?? new Error("Appilots: re-thrown host render error") });
+      return;
+    }
+    this.hasDegradedOnce = true;
+    console.error(
+      `[Appilots] The Appilots ${this.props.surface} threw while rendering and has been disabled for the rest of this session. Your app keeps running \u2014 this is an Appilots bug, not a bug in your code. Please report it with the stack below: https://github.com/Axtern-Labs/Appilots/issues`,
+      error
+    );
+    try {
+      this.props.onError?.(error, info?.componentStack ?? null);
+    } catch {
+    }
+  }
+  render() {
+    if (this.state.escalate !== null) throw this.state.escalate;
+    if (this.state.degraded) return this.props.fallback;
+    return this.props.children;
+  }
+};
 
 // src/context/AppilotsProvider.tsx
 var AppilotsContext = React2.createContext(null);
-function AppilotsProvider({ config: configProp, children, client: externalClient }) {
+function createInertClient() {
+  const unavailable = () => Promise.reject(
+    new Error("Appilots is unavailable: the SDK degraded after a render error.")
+  );
+  return new Proxy({}, {
+    get: (_target, prop) => {
+      if (prop === "then" || typeof prop === "symbol") return void 0;
+      return unavailable;
+    }
+  });
+}
+function createDegradedContext(config) {
+  return {
+    config: config ?? { projectId: "" },
+    client: createInertClient(),
+    subscribe: () => () => {
+    },
+    emit: () => {
+    },
+    remotePersonalization: null,
+    degraded: true
+  };
+}
+function AppilotsProvider({ config, children, client }) {
+  return /* @__PURE__ */ React2__default.default.createElement(
+    AppilotsErrorBoundary,
+    {
+      surface: "provider",
+      onError: reportProviderRenderFailure,
+      fallback: /* @__PURE__ */ React2__default.default.createElement(AppilotsContext.Provider, { value: createDegradedContext(config ?? null) }, children)
+    },
+    /* @__PURE__ */ React2__default.default.createElement(AppilotsProviderInner, { config, client }, children)
+  );
+}
+function reportProviderRenderFailure() {
+  recordRenderFailure(readReactVersion());
+}
+function readReactVersion() {
+  const version = React2__default.default.version;
+  return typeof version === "string" ? version : null;
+}
+function AppilotsProviderInner({ config: configProp, children, client: externalClient }) {
   console.log(`[Appilots] AppilotsProvider initializing \u2014 config source: ${configProp ? "prop" : "auto (globalThis.__APPILOTS_RC__)"}`);
   tryAutoConfig();
   const globalConfig = getGlobalConfig();
@@ -3811,7 +4043,8 @@ function AppilotsProvider({ config: configProp, children, client: externalClient
     debug: globalConfig.debug,
     appVersion: globalConfig.appVersion,
     mcpVersion: globalConfig.mcpVersion,
-    fetchPersonalization: globalConfig.fetchPersonalization
+    fetchPersonalization: globalConfig.fetchPersonalization,
+    suppressNativeConfirm: globalConfig.suppressNativeConfirm
   } : null);
   if (!config?.projectId) {
     throw new Error(
@@ -3850,6 +4083,9 @@ function AppilotsProvider({ config: configProp, children, client: externalClient
       debug: config.debug,
       appVersion: config.appVersion,
       mcpVersion: config.mcpVersion,
+      // This package's published version, so the server knows which
+      // SDK is actually in the field (issue #312).
+      sdkVersion: SDK_VERSION2,
       user: config.user,
       // Only reports a FAILED reading; the happy path sends nothing.
       introspectionReporter: getIntrospectionDiagnostics
@@ -4394,17 +4630,19 @@ function clearScreenRegistry() {
 
 exports.ActionQueueMachine = ActionQueueMachine;
 exports.AppilotsClient = AppilotsClient;
+exports.AppilotsErrorBoundary = AppilotsErrorBoundary;
 exports.AppilotsProvider = AppilotsProvider;
 exports.AppilotsRegistryProvider = AppilotsRegistryProvider;
 exports.ChatSessionMachine = ChatSessionMachine;
 exports.OPTIONAL_STEP_AUTOMATION_HINT = OPTIONAL_STEP_AUTOMATION_HINT;
 exports.RateLimitedError = RateLimitedError;
-exports.SDK_VERSION = SDK_VERSION;
+exports.SDK_VERSION = SDK_VERSION2;
 exports._patchJsxRuntimes = _patchJsxRuntimes;
 exports.actionPressTargetId = actionPressTargetId;
 exports.appilotsDebugLog = appilotsDebugLog;
 exports.appilotsDebugWarn = appilotsDebugWarn;
 exports.attachElementIdsToChoiceGroups = attachElementIdsToChoiceGroups;
+exports.clampSnapshotToWireLimits = clampSnapshotToWireLimits;
 exports.clearAppilotsDebugTraces = clearAppilotsDebugTraces;
 exports.clearScreenRegistry = clearScreenRegistry;
 exports.componentRegistry = componentRegistry;