@appilots/sdk 0.4.1 → 0.6.0

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

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

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

@@ -42,6 +42,21 @@ var StreamAbortError = class extends Error {
     this.partialContent = partialContent;
   }
 };
+var RateLimitedError = class extends Error {
+  retryAfterSeconds;
+  constructor(message, retryAfterSeconds) {
+    super(message);
+    this.name = "RateLimitedError";
+    this.retryAfterSeconds = retryAfterSeconds;
+  }
+};
+function parseRetryAfter(...candidates) {
+  for (const candidate of candidates) {
+    const seconds = Number(candidate);
+    if (Number.isFinite(seconds) && seconds > 0) return Math.ceil(seconds);
+  }
+  return 60;
+}
 var CONTINUATION_TIMEOUT_MS = 15e4;
 var AppilotsClient = class {
   baseUrl;
@@ -50,6 +65,7 @@ var AppilotsClient = class {
   timeout;
   debug;
   mcpVersion;
+  introspectionReporter;
   user;
   sessionId = null;
   /** Guard so identify fires at most once per client instance. */
@@ -60,6 +76,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",
@@ -104,6 +121,15 @@ var AppilotsClient = class {
       }
       if (!response.ok) {
         const errorMsg = json?.error?.message ?? json?.error ?? `HTTP ${response.status}`;
+        if (response.status === 429) {
+          throw new RateLimitedError(
+            errorMsg,
+            parseRetryAfter(
+              json?.error?.retryAfterSeconds,
+              response.headers?.get?.("retry-after")
+            )
+          );
+        }
         throw new Error(errorMsg);
       }
       return json.data ?? json;
@@ -162,6 +188,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 +216,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) {
@@ -332,11 +374,25 @@ var AppilotsClient = class {
         const contentType = String(xhr.getResponseHeader?.("content-type") ?? "");
         if (xhr.status !== 200 || !contentType.includes("text/event-stream")) {
           let message2 = `HTTP ${xhr.status || 0}`;
+          let retryAfterSeconds;
           try {
             const json = JSON.parse(xhr.responseText || "{}");
             message2 = json?.error?.message ?? json?.error ?? message2;
+            retryAfterSeconds = json?.error?.retryAfterSeconds;
           } catch {
           }
+          if (xhr.status === 429) {
+            fail(
+              new RateLimitedError(
+                message2,
+                parseRetryAfter(
+                  retryAfterSeconds,
+                  xhr.getResponseHeader?.("retry-after")
+                )
+              )
+            );
+            return;
+          }
           fail(
             sawAnyEvent ? new Error(message2) : new StreamTransportError(message2)
           );
@@ -402,7 +458,8 @@ var AppilotsClient = class {
           content,
           sessionId: this.sessionId,
           context,
-          ...this.mcpVersion ? { mcpVersion: this.mcpVersion } : {}
+          ...this.mcpVersion ? { mcpVersion: this.mcpVersion } : {},
+          ...this.introspectionFragment()
         })
       );
     });
@@ -923,25 +980,41 @@ function detectLocaleFromUserTexts(texts) {
 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.",
+    platformRateLimit: (wait) => `Recebi pedidos demais em pouco tempo e precisei pausar. Tente de novo em ${wait}.`,
     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.",
+    platformRateLimit: (wait) => `Recib\xED demasiadas solicitudes en poco tiempo y tuve que pausar. Int\xE9ntalo de nuevo en ${wait}.`,
     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.",
+    platformRateLimit: (wait) => `J'ai re\xE7u trop de demandes en peu de temps et j'ai d\xFB faire une pause. R\xE9essayez dans ${wait}.`,
     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.",
+    platformRateLimit: (wait) => `I got too many requests in a short time and had to pause. Try again in ${wait}.`,
     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.`
   }
 };
+var waitPhrase = {
+  pt: (s) => s < 90 ? `${Math.ceil(s)} segundos` : `cerca de ${Math.ceil(s / 60)} minutos`,
+  es: (s) => s < 90 ? `${Math.ceil(s)} segundos` : `unos ${Math.ceil(s / 60)} minutos`,
+  fr: (s) => s < 90 ? `${Math.ceil(s)} secondes` : `environ ${Math.ceil(s / 60)} minutes`,
+  en: (s) => s < 90 ? `${Math.ceil(s)} seconds` : `about ${Math.ceil(s / 60)} minutes`
+};
+function buildRateLimitedMessage(retryAfterSeconds, recentUserTexts) {
+  const locale = detectLocaleFromUserTexts(recentUserTexts);
+  const strings = copy[locale] ?? copy.en;
+  const seconds = Number.isFinite(retryAfterSeconds) && retryAfterSeconds > 0 ? retryAfterSeconds : 60;
+  return strings.platformRateLimit(waitPhrase[locale](seconds));
+}
 function buildContinuationFailureMessage(rawError, recentUserTexts) {
   const locale = detectLocaleFromUserTexts(recentUserTexts);
   const strings = copy[locale] ?? copy.en;
@@ -1545,7 +1618,7 @@ var ChatSessionMachine = class {
       const raw = err instanceof Error ? err.message : "Continuation failed";
       this.warn("ChatSessionMachine: continuation failed \u2014", raw);
       const recentUserTexts = this.state.messages.filter((m) => m.role === "user").slice(-4).map((m) => m.content);
-      const friendly = buildContinuationFailureMessage(raw, recentUserTexts);
+      const friendly = err instanceof RateLimitedError ? buildRateLimitedMessage(err.retryAfterSeconds, recentUserTexts) : buildContinuationFailureMessage(raw, recentUserTexts);
       this.addAssistantMessage({
         id: `error_${++this.messageIdCounter}`,
         role: "assistant",
@@ -1707,6 +1780,17 @@ var ChatSessionMachine = class {
       removeStreamingPlaceholder();
       const errorMessage = err instanceof Error ? err.message : "Failed to send message";
       this.setState({ error: errorMessage });
+      if (err instanceof RateLimitedError) {
+        const recentUserTexts = this.state.messages.filter((m) => m.role === "user").slice(-4).map((m) => m.content);
+        this.addAssistantMessage({
+          id: `error_${++this.messageIdCounter}`,
+          role: "assistant",
+          content: buildRateLimitedMessage(err.retryAfterSeconds, recentUserTexts),
+          timestamp: Date.now()
+        });
+        this.setState({ isLoading: false, loadingStatusKey: "thinking" });
+        return;
+      }
       this.addAssistantMessage({
         id: `error_${++this.messageIdCounter}`,
         role: "assistant",
@@ -3628,15 +3712,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 +3746,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 +3766,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 +3832,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 +3850,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 +3873,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);
@@ -4281,6 +4398,7 @@ 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._patchJsxRuntimes = _patchJsxRuntimes;
 exports.actionPressTargetId = actionPressTargetId;
@@ -4307,6 +4425,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 +4444,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;