@appilots/sdk 0.4.1 → 0.5.0

package/dist/{chunk-L2A4EZ6V.mjs → chunk-3D7PHOV7.mjs}

@@ -1,4 +1,4 @@
-import { getFiberRoot, getCurrentScreen, getActiveRouteNames, deriveInteractionElements, attachElementIdsToChoiceGroups, elementRegistry, appilotsDebugWarn, getDefaultRegistry, useAppilotsContext, ChatSessionMachine, getCurrentScreenSignature, ActionQueueMachine, getScreenMetadata, setCurrentScreen, useResolvedRegistry, listRegistry, componentRegistry, probeLoadingState, isListItemPressTarget, waitForLoadingSettle, appilotsDebugLog, waitForScreenSettle, screenDepartedBaseline, routesBelongToSameFeature, actionPressTargetId, getNavigationStateSnapshot, getNavigationRef, isOptionalStepAutomationFailure, OPTIONAL_STEP_AUTOMATION_HINT, normalize3, matchScore, idLooselyMatches, parseStableElementId, getAllScreens, snapshotShowsOpenCreateForm, looksDestructiveActionLabel, isGenericSelectValue } from './chunk-4GUPZDWT.mjs';
+import { getFiberRoot, recordIntrospectionFailure, getCurrentScreen, getActiveRouteNames, deriveInteractionElements, attachElementIdsToChoiceGroups, elementRegistry, appilotsDebugWarn, getDefaultRegistry, useAppilotsContext, ChatSessionMachine, getCurrentScreenSignature, ActionQueueMachine, getScreenMetadata, setCurrentScreen, useResolvedRegistry, listRegistry, componentRegistry, probeLoadingState, isListItemPressTarget, waitForLoadingSettle, appilotsDebugLog, waitForScreenSettle, screenDepartedBaseline, routesBelongToSameFeature, actionPressTargetId, getNavigationStateSnapshot, getNavigationRef, isOptionalStepAutomationFailure, OPTIONAL_STEP_AUTOMATION_HINT, normalize3, matchScore, idLooselyMatches, parseStableElementId, getAllScreens, snapshotShowsOpenCreateForm, looksDestructiveActionLabel, isGenericSelectValue } from './chunk-BIEF6MNR.mjs';
 import { useMemo, useRef, useSyncExternalStore, useEffect, useCallback, useState } from 'react';
 import { Alert } from 'react-native';
 
@@ -748,6 +748,7 @@ function captureSnapshot() {
     console.warn(
       "[Appilots] captureSnapshot: fiber root not captured yet. Ensure <AppilotsProvider> has rendered before calling this."
     );
+    recordIntrospectionFailure("never-mounted", null);
     return {
       route: getCurrentScreen(),
       texts: [],

package/dist/{chunk-ZWPABTLA.js → chunk-45AMQGS3.js}

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkJ75B2HWG_js = require('./chunk-J75B2HWG.js');
+var chunkPQHZTAFG_js = require('./chunk-PQHZTAFG.js');
 var React = require('react');
 
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
@@ -15,11 +15,11 @@ function getActiveRouteName(state) {
   return route.name;
 }
 function AppilotsNavigationContainer({ children }) {
-  const { emit } = chunkJ75B2HWG_js.useAppilotsContext();
+  const { emit } = chunkPQHZTAFG_js.useAppilotsContext();
   const internalRef = React.useRef(null);
   const handleRef = React.useCallback((instance) => {
     internalRef.current = instance;
-    chunkJ75B2HWG_js.setNavigationRef(instance);
+    chunkPQHZTAFG_js.setNavigationRef(instance);
     const childRef = children.ref;
     if (typeof childRef === "function") childRef(instance);
     else if (childRef && typeof childRef === "object") childRef.current = instance;
@@ -32,7 +32,7 @@ function AppilotsNavigationContainer({ children }) {
       const routeName = getActiveRouteName(state);
       if (routeName) {
         console.log(`[Appilots] Screen changed \u2192 "${routeName}"`);
-        chunkJ75B2HWG_js.setCurrentScreen(routeName);
+        chunkPQHZTAFG_js.setCurrentScreen(routeName);
         emit({
           type: "navigation:change",
           timestamp: Date.now(),
@@ -48,7 +48,7 @@ function AppilotsNavigationContainer({ children }) {
       const route = internalRef.current?.getCurrentRoute?.();
       if (route?.name) {
         console.log(`[Appilots] Initial screen \u2192 "${route.name}"`);
-        chunkJ75B2HWG_js.setCurrentScreen(route.name);
+        chunkPQHZTAFG_js.setCurrentScreen(route.name);
         emit({
           type: "navigation:change",
           timestamp: Date.now(),

package/dist/{chunk-4GUPZDWT.mjs → chunk-BIEF6MNR.mjs}

@@ -44,6 +44,7 @@ var AppilotsClient = class {
   timeout;
   debug;
   mcpVersion;
+  introspectionReporter;
   user;
   sessionId = null;
   /** Guard so identify fires at most once per client instance. */
@@ -54,6 +55,7 @@ var AppilotsClient = class {
     this.timeout = options.timeout ?? 6e4;
     this.debug = options.debug ?? false;
     this.mcpVersion = options.mcpVersion;
+    this.introspectionReporter = options.introspectionReporter;
     this.user = options.user;
     this.headers = {
       "Content-Type": "application/json",
@@ -156,6 +158,21 @@ var AppilotsClient = class {
   getSessionId() {
     return this.sessionId;
   }
+  /**
+   * Wire fragment for introspection health. Empty on the happy path —
+   * a working client sends nothing, so the field costs a byte only
+   * when something is actually wrong. Never throws: a broken reporter
+   * must not take the message down with it.
+   */
+  introspectionFragment() {
+    try {
+      const report = this.introspectionReporter?.();
+      if (!report || report.captured !== false) return {};
+      return { introspection: report };
+    } catch {
+      return {};
+    }
+  }
   // ── Messages ──────────────────────────────────────────────────
   async sendMessage(content, context) {
     if (!this.sessionId) {
@@ -169,7 +186,8 @@ var AppilotsClient = class {
         context,
         // Optional MCP version bundled with this app build. Server
         // compares vs the active MCP doc to detect stale uploads.
-        ...this.mcpVersion ? { mcpVersion: this.mcpVersion } : {}
+        ...this.mcpVersion ? { mcpVersion: this.mcpVersion } : {},
+        ...this.introspectionFragment()
       })
     });
     if (data.sessionId) {
@@ -396,7 +414,8 @@ var AppilotsClient = class {
           content,
           sessionId: this.sessionId,
           context,
-          ...this.mcpVersion ? { mcpVersion: this.mcpVersion } : {}
+          ...this.mcpVersion ? { mcpVersion: this.mcpVersion } : {},
+          ...this.introspectionFragment()
         })
       );
     });
@@ -3622,15 +3641,32 @@ function getGlobalConfig() {
 
 // src/introspection/fiberRoot.ts
 var _fiberRoot = null;
+var _diagnostics = {
+  captured: false,
+  failureReason: null,
+  reactVersion: null,
+  failureCount: 0
+};
 function setFiberRoot(fiber) {
   if (_fiberRoot !== fiber) {
     console.log(`[Appilots] Introspection: fiber root captured (type=${typeName(fiber)})`);
     _fiberRoot = fiber;
   }
+  _diagnostics.captured = true;
 }
 function getFiberRoot() {
   return _fiberRoot;
 }
+function recordIntrospectionFailure(reason, reactVersion) {
+  _diagnostics.failureCount += 1;
+  if (_diagnostics.failureReason === null) {
+    _diagnostics.failureReason = reason;
+    _diagnostics.reactVersion = reactVersion;
+  }
+}
+function getIntrospectionDiagnostics() {
+  return { ..._diagnostics };
+}
 function typeName(fiber) {
   const t = fiber?.type ?? fiber?.elementType;
   if (!t) return "unknown";
@@ -3639,15 +3675,16 @@ function typeName(fiber) {
   if (typeof t === "object") return t.displayName ?? t.render?.displayName ?? t.render?.name ?? "forwardRef/memo";
   return String(t);
 }
-
-// src/introspection/AppilotsFiberRoot.tsx
 var FiberSentinel = class extends React2.Component {
   componentDidMount() {
     const fiber = this._reactInternals ?? this._reactInternalFiber ?? null;
     if (!fiber) {
+      const reactVersion = React2.version ?? null;
       console.warn(
-        "[Appilots] FiberSentinel: this._reactInternals is undefined; snapshot capture will fall back to render-time owner. React version may be incompatible."
+        `[Appilots] FiberSentinel: this._reactInternals is undefined; snapshot capture will fall back to render-time owner. React version may be incompatible (react=${reactVersion}).`
       );
+      recordIntrospectionFailure("sentinel-missing-internals", reactVersion);
+      this.props.onUnavailable?.({ reactVersion });
       return;
     }
     let top = fiber;
@@ -3658,13 +3695,16 @@ var FiberSentinel = class extends React2.Component {
     return this.props.children ?? null;
   }
 };
-function AppilotsFiberRoot({ children }) {
+function AppilotsFiberRoot({
+  children,
+  onUnavailable
+}) {
   const Internals = React2.__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED_IN_THIS_VERSION_OF_REACT;
   const ownerFiber = Internals?.ReactCurrentOwner?.current;
   if (ownerFiber && !getFiberRoot()) {
     setFiberRoot(ownerFiber);
   }
-  return /* @__PURE__ */ React2.createElement(FiberSentinel, null, children);
+  return /* @__PURE__ */ React2.createElement(FiberSentinel, { onUnavailable }, children);
 }
 
 // src/debug/logger.ts
@@ -3721,6 +3761,16 @@ function AppilotsProvider({ config: configProp, children, client: externalClient
     recordAppilotsEventTrace(event);
     listenersRef.current.forEach((handler) => handler(event));
   }, []);
+  const handleIntrospectionUnavailable = useCallback(
+    ({ reactVersion }) => {
+      emit({
+        type: "sdk:introspection:unavailable",
+        timestamp: Date.now(),
+        data: { reason: "sentinel-missing-internals", reactVersion }
+      });
+    },
+    [emit]
+  );
   const client = useMemo(
     () => externalClient ?? new AppilotsClient({
       projectId: config.projectId,
@@ -3729,7 +3779,9 @@ function AppilotsProvider({ config: configProp, children, client: externalClient
       debug: config.debug,
       appVersion: config.appVersion,
       mcpVersion: config.mcpVersion,
-      user: config.user
+      user: config.user,
+      // Only reports a FAILED reading; the happy path sends nothing.
+      introspectionReporter: getIntrospectionDiagnostics
     }),
     [config.projectId, config.apiBaseUrl, config.apiKey, config.debug, config.appVersion, config.mcpVersion, config.user, externalClient]
   );
@@ -3750,7 +3802,7 @@ function AppilotsProvider({ config: configProp, children, client: externalClient
     () => ({ config, client, subscribe, emit, remotePersonalization }),
     [config, client, subscribe, emit, remotePersonalization]
   );
-  return /* @__PURE__ */ React2.createElement(AppilotsContext.Provider, { value }, /* @__PURE__ */ React2.createElement(AppilotsFiberRoot, null, children));
+  return /* @__PURE__ */ React2.createElement(AppilotsContext.Provider, { value }, /* @__PURE__ */ React2.createElement(AppilotsFiberRoot, { onUnavailable: handleIntrospectionUnavailable }, children));
 }
 function useAppilotsContext() {
   const context = useContext(AppilotsContext);
@@ -4269,4 +4321,4 @@ function clearScreenRegistry() {
   screenRegistry.clear();
 }
 
-export { ActionQueueMachine, AppilotsClient, AppilotsProvider, AppilotsRegistryProvider, ChatSessionMachine, OPTIONAL_STEP_AUTOMATION_HINT, SDK_VERSION, _patchJsxRuntimes, actionPressTargetId, appilotsDebugLog, appilotsDebugWarn, attachElementIdsToChoiceGroups, clearAppilotsDebugTraces, clearScreenRegistry, componentRegistry, createComponentRegistry, createElementRegistry, createListRegistry, defaultDarkTheme, defaultLightTheme, deriveInteractionElements, describeAction, elementRegistry, enableAppilotsAutoTracking, getActiveRouteNames, getAllScreens, getAppilotsDebugTraces, getCurrentScreen, getCurrentScreenSignature, getDefaultRegistry, getFiberRoot, getGlobalConfig, getNavigationRef, getNavigationStateSnapshot, getScreenMetadata, humanizeError, idLooselyMatches, initAppilots, isAutoTrackingEnabled, isGenericSelectValue, isListItemPressTarget, isOptionalStepAutomationFailure, listRegistry, looksDestructiveActionLabel, matchScore, mergeThemeTokens, normalize3, parseStableElementId, probeLoadingState, recordAppilotsDebugTrace, registerScreen, resolveBaseTheme, routesBelongToSameFeature, screenDepartedBaseline, setCurrentScreen, setNavigationRef, snapshotShowsOpenCreateForm, subscribeAppilotsDebugTraces, useAppilotsContext, useResolvedRegistry, waitForLoadingSettle, waitForScreenSettle };
+export { ActionQueueMachine, AppilotsClient, AppilotsProvider, AppilotsRegistryProvider, ChatSessionMachine, OPTIONAL_STEP_AUTOMATION_HINT, SDK_VERSION, _patchJsxRuntimes, actionPressTargetId, appilotsDebugLog, appilotsDebugWarn, attachElementIdsToChoiceGroups, clearAppilotsDebugTraces, clearScreenRegistry, componentRegistry, createComponentRegistry, createElementRegistry, createListRegistry, defaultDarkTheme, defaultLightTheme, deriveInteractionElements, describeAction, elementRegistry, enableAppilotsAutoTracking, getActiveRouteNames, getAllScreens, getAppilotsDebugTraces, getCurrentScreen, getCurrentScreenSignature, getDefaultRegistry, getFiberRoot, getGlobalConfig, getIntrospectionDiagnostics, getNavigationRef, getNavigationStateSnapshot, getScreenMetadata, humanizeError, idLooselyMatches, initAppilots, isAutoTrackingEnabled, isGenericSelectValue, isListItemPressTarget, isOptionalStepAutomationFailure, listRegistry, looksDestructiveActionLabel, matchScore, mergeThemeTokens, normalize3, parseStableElementId, probeLoadingState, recordAppilotsDebugTrace, recordIntrospectionFailure, registerScreen, resolveBaseTheme, routesBelongToSameFeature, screenDepartedBaseline, setCurrentScreen, setNavigationRef, snapshotShowsOpenCreateForm, subscribeAppilotsDebugTraces, useAppilotsContext, useResolvedRegistry, waitForLoadingSettle, waitForScreenSettle };

package/dist/{chunk-P2BR4DFF.mjs → chunk-NIW7E3QD.mjs}

@@ -1,4 +1,4 @@
-import { useAppilotsContext, setNavigationRef, setCurrentScreen } from './chunk-4GUPZDWT.mjs';
+import { useAppilotsContext, setNavigationRef, setCurrentScreen } from './chunk-BIEF6MNR.mjs';
 import React, { useRef, useCallback, useEffect } from 'react';
 
 function getActiveRouteName(state) {

package/dist/{chunk-J75B2HWG.js → chunk-PQHZTAFG.js}

@@ -50,6 +50,7 @@ var AppilotsClient = class {
   timeout;
   debug;
   mcpVersion;
+  introspectionReporter;
   user;
   sessionId = null;
   /** Guard so identify fires at most once per client instance. */
@@ -60,6 +61,7 @@ var AppilotsClient = class {
     this.timeout = options.timeout ?? 6e4;
     this.debug = options.debug ?? false;
     this.mcpVersion = options.mcpVersion;
+    this.introspectionReporter = options.introspectionReporter;
     this.user = options.user;
     this.headers = {
       "Content-Type": "application/json",
@@ -162,6 +164,21 @@ var AppilotsClient = class {
   getSessionId() {
     return this.sessionId;
   }
+  /**
+   * Wire fragment for introspection health. Empty on the happy path —
+   * a working client sends nothing, so the field costs a byte only
+   * when something is actually wrong. Never throws: a broken reporter
+   * must not take the message down with it.
+   */
+  introspectionFragment() {
+    try {
+      const report = this.introspectionReporter?.();
+      if (!report || report.captured !== false) return {};
+      return { introspection: report };
+    } catch {
+      return {};
+    }
+  }
   // ── Messages ──────────────────────────────────────────────────
   async sendMessage(content, context) {
     if (!this.sessionId) {
@@ -175,7 +192,8 @@ var AppilotsClient = class {
         context,
         // Optional MCP version bundled with this app build. Server
         // compares vs the active MCP doc to detect stale uploads.
-        ...this.mcpVersion ? { mcpVersion: this.mcpVersion } : {}
+        ...this.mcpVersion ? { mcpVersion: this.mcpVersion } : {},
+        ...this.introspectionFragment()
       })
     });
     if (data.sessionId) {
@@ -402,7 +420,8 @@ var AppilotsClient = class {
           content,
           sessionId: this.sessionId,
           context,
-          ...this.mcpVersion ? { mcpVersion: this.mcpVersion } : {}
+          ...this.mcpVersion ? { mcpVersion: this.mcpVersion } : {},
+          ...this.introspectionFragment()
         })
       );
     });
@@ -3628,15 +3647,32 @@ function getGlobalConfig() {
 
 // src/introspection/fiberRoot.ts
 var _fiberRoot = null;
+var _diagnostics = {
+  captured: false,
+  failureReason: null,
+  reactVersion: null,
+  failureCount: 0
+};
 function setFiberRoot(fiber) {
   if (_fiberRoot !== fiber) {
     console.log(`[Appilots] Introspection: fiber root captured (type=${typeName(fiber)})`);
     _fiberRoot = fiber;
   }
+  _diagnostics.captured = true;
 }
 function getFiberRoot() {
   return _fiberRoot;
 }
+function recordIntrospectionFailure(reason, reactVersion) {
+  _diagnostics.failureCount += 1;
+  if (_diagnostics.failureReason === null) {
+    _diagnostics.failureReason = reason;
+    _diagnostics.reactVersion = reactVersion;
+  }
+}
+function getIntrospectionDiagnostics() {
+  return { ..._diagnostics };
+}
 function typeName(fiber) {
   const t = fiber?.type ?? fiber?.elementType;
   if (!t) return "unknown";
@@ -3645,15 +3681,16 @@ function typeName(fiber) {
   if (typeof t === "object") return t.displayName ?? t.render?.displayName ?? t.render?.name ?? "forwardRef/memo";
   return String(t);
 }
-
-// src/introspection/AppilotsFiberRoot.tsx
 var FiberSentinel = class extends React2__default.default.Component {
   componentDidMount() {
     const fiber = this._reactInternals ?? this._reactInternalFiber ?? null;
     if (!fiber) {
+      const reactVersion = React2__default.default.version ?? null;
       console.warn(
-        "[Appilots] FiberSentinel: this._reactInternals is undefined; snapshot capture will fall back to render-time owner. React version may be incompatible."
+        `[Appilots] FiberSentinel: this._reactInternals is undefined; snapshot capture will fall back to render-time owner. React version may be incompatible (react=${reactVersion}).`
       );
+      recordIntrospectionFailure("sentinel-missing-internals", reactVersion);
+      this.props.onUnavailable?.({ reactVersion });
       return;
     }
     let top = fiber;
@@ -3664,13 +3701,16 @@ var FiberSentinel = class extends React2__default.default.Component {
     return this.props.children ?? null;
   }
 };
-function AppilotsFiberRoot({ children }) {
+function AppilotsFiberRoot({
+  children,
+  onUnavailable
+}) {
   const Internals = React2__default.default.__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED_IN_THIS_VERSION_OF_REACT;
   const ownerFiber = Internals?.ReactCurrentOwner?.current;
   if (ownerFiber && !getFiberRoot()) {
     setFiberRoot(ownerFiber);
   }
-  return /* @__PURE__ */ React2__default.default.createElement(FiberSentinel, null, children);
+  return /* @__PURE__ */ React2__default.default.createElement(FiberSentinel, { onUnavailable }, children);
 }
 
 // src/debug/logger.ts
@@ -3727,6 +3767,16 @@ function AppilotsProvider({ config: configProp, children, client: externalClient
     recordAppilotsEventTrace(event);
     listenersRef.current.forEach((handler) => handler(event));
   }, []);
+  const handleIntrospectionUnavailable = React2.useCallback(
+    ({ reactVersion }) => {
+      emit({
+        type: "sdk:introspection:unavailable",
+        timestamp: Date.now(),
+        data: { reason: "sentinel-missing-internals", reactVersion }
+      });
+    },
+    [emit]
+  );
   const client = React2.useMemo(
     () => externalClient ?? new AppilotsClient({
       projectId: config.projectId,
@@ -3735,7 +3785,9 @@ function AppilotsProvider({ config: configProp, children, client: externalClient
       debug: config.debug,
       appVersion: config.appVersion,
       mcpVersion: config.mcpVersion,
-      user: config.user
+      user: config.user,
+      // Only reports a FAILED reading; the happy path sends nothing.
+      introspectionReporter: getIntrospectionDiagnostics
     }),
     [config.projectId, config.apiBaseUrl, config.apiKey, config.debug, config.appVersion, config.mcpVersion, config.user, externalClient]
   );
@@ -3756,7 +3808,7 @@ function AppilotsProvider({ config: configProp, children, client: externalClient
     () => ({ config, client, subscribe, emit, remotePersonalization }),
     [config, client, subscribe, emit, remotePersonalization]
   );
-  return /* @__PURE__ */ React2__default.default.createElement(AppilotsContext.Provider, { value }, /* @__PURE__ */ React2__default.default.createElement(AppilotsFiberRoot, null, children));
+  return /* @__PURE__ */ React2__default.default.createElement(AppilotsContext.Provider, { value }, /* @__PURE__ */ React2__default.default.createElement(AppilotsFiberRoot, { onUnavailable: handleIntrospectionUnavailable }, children));
 }
 function useAppilotsContext() {
   const context = React2.useContext(AppilotsContext);
@@ -4307,6 +4359,7 @@ exports.getCurrentScreenSignature = getCurrentScreenSignature;
 exports.getDefaultRegistry = getDefaultRegistry;
 exports.getFiberRoot = getFiberRoot;
 exports.getGlobalConfig = getGlobalConfig;
+exports.getIntrospectionDiagnostics = getIntrospectionDiagnostics;
 exports.getNavigationRef = getNavigationRef;
 exports.getNavigationStateSnapshot = getNavigationStateSnapshot;
 exports.getScreenMetadata = getScreenMetadata;
@@ -4325,6 +4378,7 @@ exports.normalize3 = normalize3;
 exports.parseStableElementId = parseStableElementId;
 exports.probeLoadingState = probeLoadingState;
 exports.recordAppilotsDebugTrace = recordAppilotsDebugTrace;
+exports.recordIntrospectionFailure = recordIntrospectionFailure;
 exports.registerScreen = registerScreen;
 exports.resolveBaseTheme = resolveBaseTheme;
 exports.routesBelongToSameFeature = routesBelongToSameFeature;