@appilots/sdk 0.13.0 → 0.14.0

package/dist/{chunk-L3SY3Q4K.mjs → chunk-N66DUP54.mjs}

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

package/dist/{chunk-UZ2D4BVX.js → chunk-QAZ4TN3Z.js}

@@ -4598,18 +4598,27 @@ var WRITE_SUCCESS = {
     "a\\s+[e\xE9]t[e\xE9]\\s+(?:enregistr|cr[e\xE9]|ajout|sauvegard)[e\xE9]e?"
   ]
 };
+var SENTENCE_START = "(?:^|[.!?:;*\\n]\\s*)";
 var COMPLETION_CLAIM = {
   pt: [
     "j[a\xE1]\\s+(?:cadastrei|registrei|salvei|criei)",
     "conclu[i\xED]\\s+o\\s+cadastro",
-    "cadastro\\s+(?:foi\\s+)?(?:conclu[i\xED]do|realizado|feito)"
+    "cadastro\\s+(?:foi\\s+)?(?:conclu[i\xED]do|realizado|feito)",
+    `${SENTENCE_START}(?:eu\\s+)?(?:cadastrei|registrei|salvei|criei|adicionei|enviei)\\b`
   ],
   en: [
     "i(?:'|\u2019)?ve\\s+(?:registered|saved|created|added)",
-    "i\\s+have\\s+(?:registered|saved|created|added)"
+    "i\\s+have\\s+(?:registered|saved|created|added)",
+    `${SENTENCE_START}i\\s+(?:registered|saved|created|added|submitted)\\b`
   ],
-  es: ["ya\\s+(?:lo\\s+|la\\s+)?(?:registr[e\xE9]|guard[e\xE9]|cre[e\xE9])"],
-  fr: ["j(?:e\\s+l(?:'|\u2019)ai|(?:'|\u2019)ai)\\s+(?:enregistr|cr[e\xE9]|ajout|sauvegard)[e\xE9]"]
+  es: [
+    "ya\\s+(?:lo\\s+|la\\s+)?(?:registr[e\xE9]|guard[e\xE9]|cre[e\xE9])",
+    `${SENTENCE_START}(?:ya\\s+)?he\\s+(?:registrado|guardado|creado|enviado|a[\xF1n]adido)\\b`
+  ],
+  fr: [
+    "j(?:e\\s+l(?:'|\u2019)ai|(?:'|\u2019)ai)\\s+(?:enregistr|cr[e\xE9]|ajout|sauvegard)[e\xE9]",
+    `${SENTENCE_START}c(?:'|\u2019)est\\s+(?:enregistr|cr[e\xE9]|ajout|sauvegard)[e\xE9]`
+  ]
 };
 var SUBMIT_CONTROL = {
   pt: ["cadastrar", "registrar", "salvar", "enviar", "confirmar"],
@@ -4744,6 +4753,7 @@ var AppilotsClient = class {
   mcpVersion;
   introspectionReporter;
   user;
+  plainLanguage;
   sessionId = null;
   mission = null;
   missionDispatchPaused = false;
@@ -4762,6 +4772,7 @@ var AppilotsClient = class {
     this.mcpVersion = options.mcpVersion;
     this.introspectionReporter = options.introspectionReporter;
     this.user = options.user;
+    this.plainLanguage = options.plainLanguage;
     this.headers = {
       "Content-Type": "application/json",
       // Version telemetry: lets the server correlate behavior per SDK
@@ -4911,6 +4922,19 @@ var AppilotsClient = class {
       return {};
     }
   }
+  /**
+   * Per-session plain-language override — e.g. from the signed-in user's
+   * accessibility profile. `undefined` hands the decision back to the
+   * project setting. Applies from the next request on.
+   */
+  setPlainLanguage(value) {
+    this.plainLanguage = value;
+  }
+  /** Every relay-bound context carries the reply-style preference. */
+  withPreferences(context) {
+    if (this.plainLanguage === void 0) return context;
+    return { ...context ?? {}, plainLanguage: this.plainLanguage };
+  }
   // ── Messages ──────────────────────────────────────────────────
   async sendMessage(content, context) {
     if (this.sessionStorage && !this.sessionId) await this.loadStoredSession();
@@ -4924,7 +4948,7 @@ var AppilotsClient = class {
       body: JSON.stringify({
         content,
         sessionId: this.sessionId,
-        context,
+        context: this.withPreferences(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 } : {},
@@ -5189,7 +5213,7 @@ var AppilotsClient = class {
         JSON.stringify({
           content,
           sessionId: this.sessionId,
-          context,
+          context: this.withPreferences(context),
           ...this.mcpVersion ? { mcpVersion: this.mcpVersion } : {},
           ...this.introspectionFragment()
         })
@@ -5208,7 +5232,9 @@ var AppilotsClient = class {
         body: JSON.stringify({
           sessionId: this.sessionId,
           results,
-          context: this.mission ? { ...context, missionProtocol: 1, missionId: this.mission.scope.id } : context,
+          context: this.withPreferences(
+            this.mission ? { ...context, missionProtocol: 1, missionId: this.mission.scope.id } : context
+          ),
           hop
         })
       },
@@ -5296,7 +5322,7 @@ var AppilotsClient = class {
       body: JSON.stringify({
         command,
         missionId: this.mission.scope.id,
-        context
+        context: this.withPreferences(context)
       })
     });
     if (command === "resume") this.missionDispatchPaused = false;
@@ -5683,6 +5709,11 @@ var AppilotsClient = class {
     };
   }
 };
+function isSpeechHost(value) {
+  if (!value || typeof value !== "object") return false;
+  const candidate = value;
+  return typeof candidate.start === "function" && typeof candidate.stop === "function" && typeof candidate.cancel === "function";
+}
 var defaultLightTheme = {
   colors: {
     primary: "#6366f1",
@@ -6943,6 +6974,10 @@ function actionHasCompletedConfirmGate(action, actions) {
     return payload.destructive === true || payload.severity === "danger";
   });
 }
+function confirmExpiresAt(confirm) {
+  const scope = readPayload(confirm).missionApproval;
+  return typeof scope?.expiresAt === "number" ? scope.expiresAt : void 0;
+}
 var ActionQueueMachine = class {
   deps;
   options;
@@ -7448,6 +7483,17 @@ var ActionQueueMachine = class {
     return this.state.actions.filter((a) => a.status === "completed" || a.status === "failed");
   }
 };
+var STILL_WORKING_FIRST_MS = 1e4;
+var STILL_WORKING_EVERY_MS = 2e4;
+function startStillWorkingTimer(onTick) {
+  let elapsedMs = STILL_WORKING_FIRST_MS;
+  let timer = setTimeout(function tick() {
+    onTick(Math.round(elapsedMs / 1e3));
+    elapsedMs += STILL_WORKING_EVERY_MS;
+    timer = setTimeout(tick, STILL_WORKING_EVERY_MS);
+  }, STILL_WORKING_FIRST_MS);
+  return () => clearTimeout(timer);
+}
 function normalize3(s) {
   return s.toLowerCase().normalize("NFD").replace(/[\u0300-\u036f]/g, "").replace(/[^a-z0-9]/g, "");
 }
@@ -11268,7 +11314,7 @@ async function waitForLoadingSettle(opts = {}) {
 }
 
 // src/version.ts
-var SDK_VERSION2 = "0.13.0";
+var SDK_VERSION2 = "0.14.0";
 var FiberSentinel = class extends React2__default.default.Component {
   componentDidMount() {
     const fiber = this._reactInternals ?? this._reactInternalFiber ?? null;
@@ -11617,12 +11663,14 @@ function AppilotsProviderInner({
       apiBaseUrl: config.apiBaseUrl,
       apiKey: config.apiKey,
       debug: config.debug,
+      timeout: config.timeout,
       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,
+      plainLanguage: config.plainLanguage,
       // Only reports a FAILED reading; the happy path sends nothing.
       introspectionReporter: getIntrospectionDiagnostics
     }),
@@ -11638,6 +11686,9 @@ function AppilotsProviderInner({
       externalClient
     ]
   );
+  React2.useEffect(() => {
+    client.setPlainLanguage?.(config.plainLanguage);
+  }, [client, config.plainLanguage]);
   const fetchPersonalizationEnabled = config.fetchPersonalization !== false;
   const [remotePersonalization, setRemotePersonalization] = React2.useState(
     null
@@ -11714,6 +11765,7 @@ exports.clampSnapshotToWireLimits = clampSnapshotToWireLimits;
 exports.clearAppilotsDebugTraces = clearAppilotsDebugTraces;
 exports.clearScreenRegistry = clearScreenRegistry;
 exports.componentRegistry = componentRegistry;
+exports.confirmExpiresAt = confirmExpiresAt;
 exports.createComponentRegistry = createComponentRegistry;
 exports.createElementRegistry = createElementRegistry;
 exports.createListRegistry = createListRegistry;
@@ -11755,6 +11807,7 @@ exports.humanizeError = humanizeError;
 exports.idLooselyMatches = idLooselyMatches;
 exports.initAppilots = initAppilots;
 exports.isAlwaysListContainer = isAlwaysListContainer;
+exports.isAppilotsSensitiveMarked = isAppilotsSensitiveMarked;
 exports.isAutoTrackingEnabled = isAutoTrackingEnabled;
 exports.isGenericSelectValue = isGenericSelectValue;
 exports.isGeometryResolved = isGeometryResolved;
@@ -11765,6 +11818,7 @@ exports.isOptionalStepAutomationFailure = isOptionalStepAutomationFailure;
 exports.isRectOnScreen = isRectOnScreen;
 exports.isReferenceable = isReferenceable;
 exports.isSourceControlId = isSourceControlId;
+exports.isSpeechHost = isSpeechHost;
 exports.isSwitchLike = isSwitchLike;
 exports.isVisibleValidationText = isVisibleValidationText;
 exports.listRegistry = listRegistry;
@@ -11796,6 +11850,7 @@ exports.shouldSkipSubtree = shouldSkipSubtree;
 exports.snapshotShowsOpenCreateForm = snapshotShowsOpenCreateForm;
 exports.sourceControlId = sourceControlId;
 exports.sourceControlTarget = sourceControlTarget;
+exports.startStillWorkingTimer = startStillWorkingTimer;
 exports.subscribeAppilotsDebugTraces = subscribeAppilotsDebugTraces;
 exports.subscribeGeometryHost = subscribeGeometryHost;
 exports.switchValue = switchValue;

package/dist/hooks/index.d.mts

@@ -1,2 +1,2 @@
-export { w as SuggestedPrompt, y as UseAppilotsFieldOptions, z as UseAppilotsSliderOptions, B as UseAppilotsTargetOptions, D as UseAppilotsToggleOptions, G as UseSuggestedPromptsOptions, H as UseSuggestedPromptsReturn, Q as useAppilots, V as useAppilotsActions, W as useAppilotsChat, Y as useAppilotsField, Z as useAppilotsNavigation, _ as useAppilotsSlider, $ as useAppilotsTarget, a0 as useAppilotsToggle, a1 as useSuggestedPrompts } from '../index-CI4jmSoP.mjs';
+export { w as SuggestedPrompt, y as UseAppilotsFieldOptions, z as UseAppilotsSliderOptions, B as UseAppilotsTargetOptions, D as UseAppilotsToggleOptions, G as UseSuggestedPromptsOptions, H as UseSuggestedPromptsReturn, Q as useAppilots, V as useAppilotsActions, W as useAppilotsChat, Y as useAppilotsField, Z as useAppilotsNavigation, _ as useAppilotsSlider, $ as useAppilotsTarget, a0 as useAppilotsToggle, a1 as useSuggestedPrompts } from '../index-wMMetyrj.mjs';
 import 'react';

package/dist/hooks/index.d.ts

@@ -1,2 +1,2 @@
-export { w as SuggestedPrompt, y as UseAppilotsFieldOptions, z as UseAppilotsSliderOptions, B as UseAppilotsTargetOptions, D as UseAppilotsToggleOptions, G as UseSuggestedPromptsOptions, H as UseSuggestedPromptsReturn, Q as useAppilots, V as useAppilotsActions, W as useAppilotsChat, Y as useAppilotsField, Z as useAppilotsNavigation, _ as useAppilotsSlider, $ as useAppilotsTarget, a0 as useAppilotsToggle, a1 as useSuggestedPrompts } from '../index-CI4jmSoP.js';
+export { w as SuggestedPrompt, y as UseAppilotsFieldOptions, z as UseAppilotsSliderOptions, B as UseAppilotsTargetOptions, D as UseAppilotsToggleOptions, G as UseSuggestedPromptsOptions, H as UseSuggestedPromptsReturn, Q as useAppilots, V as useAppilotsActions, W as useAppilotsChat, Y as useAppilotsField, Z as useAppilotsNavigation, _ as useAppilotsSlider, $ as useAppilotsTarget, a0 as useAppilotsToggle, a1 as useSuggestedPrompts } from '../index-wMMetyrj.js';
 import 'react';

package/dist/hooks/index.js

@@ -1,43 +1,43 @@
 'use strict';
 
-var chunkAJDHZRBN_js = require('../chunk-AJDHZRBN.js');
-require('../chunk-UZ2D4BVX.js');
+var chunkJGUDXRXN_js = require('../chunk-JGUDXRXN.js');
+require('../chunk-QAZ4TN3Z.js');
 
 
 
 Object.defineProperty(exports, "useAppilots", {
   enumerable: true,
-  get: function () { return chunkAJDHZRBN_js.useAppilots; }
+  get: function () { return chunkJGUDXRXN_js.useAppilots; }
 });
 Object.defineProperty(exports, "useAppilotsActions", {
   enumerable: true,
-  get: function () { return chunkAJDHZRBN_js.useAppilotsActions; }
+  get: function () { return chunkJGUDXRXN_js.useAppilotsActions; }
 });
 Object.defineProperty(exports, "useAppilotsChat", {
   enumerable: true,
-  get: function () { return chunkAJDHZRBN_js.useAppilotsChat; }
+  get: function () { return chunkJGUDXRXN_js.useAppilotsChat; }
 });
 Object.defineProperty(exports, "useAppilotsField", {
   enumerable: true,
-  get: function () { return chunkAJDHZRBN_js.useAppilotsField; }
+  get: function () { return chunkJGUDXRXN_js.useAppilotsField; }
 });
 Object.defineProperty(exports, "useAppilotsNavigation", {
   enumerable: true,
-  get: function () { return chunkAJDHZRBN_js.useAppilotsNavigation; }
+  get: function () { return chunkJGUDXRXN_js.useAppilotsNavigation; }
 });
 Object.defineProperty(exports, "useAppilotsSlider", {
   enumerable: true,
-  get: function () { return chunkAJDHZRBN_js.useAppilotsSlider; }
+  get: function () { return chunkJGUDXRXN_js.useAppilotsSlider; }
 });
 Object.defineProperty(exports, "useAppilotsTarget", {
   enumerable: true,
-  get: function () { return chunkAJDHZRBN_js.useAppilotsTarget; }
+  get: function () { return chunkJGUDXRXN_js.useAppilotsTarget; }
 });
 Object.defineProperty(exports, "useAppilotsToggle", {
   enumerable: true,
-  get: function () { return chunkAJDHZRBN_js.useAppilotsToggle; }
+  get: function () { return chunkJGUDXRXN_js.useAppilotsToggle; }
 });
 Object.defineProperty(exports, "useSuggestedPrompts", {
   enumerable: true,
-  get: function () { return chunkAJDHZRBN_js.useSuggestedPrompts; }
+  get: function () { return chunkJGUDXRXN_js.useSuggestedPrompts; }
 });

package/dist/hooks/index.mjs

@@ -1,2 +1,2 @@
-export { useAppilots, useAppilotsActions, useAppilotsChat, useAppilotsField, useAppilotsNavigation, useAppilotsSlider, useAppilotsTarget, useAppilotsToggle, useSuggestedPrompts } from '../chunk-UYBKXULM.mjs';
-import '../chunk-HRWBK35Y.mjs';
+export { useAppilots, useAppilotsActions, useAppilotsChat, useAppilotsField, useAppilotsNavigation, useAppilotsSlider, useAppilotsTarget, useAppilotsToggle, useSuggestedPrompts } from '../chunk-6JWU3NBT.mjs';
+import '../chunk-AKAMWKO6.mjs';

package/dist/{index-CI4jmSoP.d.mts → index-wMMetyrj.d.mts}

@@ -408,6 +408,13 @@ interface AppilotsClientOptions {
      * id. Identifiers are dashboard-only — never sent to the LLM.
      */
     user?: AppilotsUser;
+    /**
+     * Accessibility: ask the agent to reply in plain language (short
+     * sentences, everyday words, numbered steps). `undefined` defers to the
+     * project setting in the dashboard; `true`/`false` overrides it for this
+     * session. Change it later with `setPlainLanguage`.
+     */
+    plainLanguage?: boolean;
 }
 interface AppilotsUser {
     /** The app's own user id (matches your backend). */
@@ -472,6 +479,8 @@ interface SendMessageContext {
     missionId?: string;
     /** Supported device language, independent of the app/map/visible UI locale. */
     deviceLocale?: SupportedAppilotsLocale;
+    /** Set by the client from `plainLanguage` / `setPlainLanguage`; see there. */
+    plainLanguage?: boolean;
     /**
      * Which client platform this observation came from — `'react-native'`,
      * `'web'`, `'android'`, `'ios'`, or any other client-defined string.
@@ -526,6 +535,7 @@ declare class AppilotsClient {
     private readonly mcpVersion;
     private readonly introspectionReporter;
     private readonly user;
+    private plainLanguage;
     private sessionId;
     private mission;
     private missionDispatchPaused;
@@ -566,6 +576,14 @@ declare class AppilotsClient {
      * must not take the message down with it.
      */
     private introspectionFragment;
+    /**
+     * Per-session plain-language override — e.g. from the signed-in user's
+     * accessibility profile. `undefined` hands the decision back to the
+     * project setting. Applies from the next request on.
+     */
+    setPlainLanguage(value: boolean | undefined): void;
+    /** Every relay-bound context carries the reply-style preference. */
+    private withPreferences;
     sendMessage(content: string, context?: SendMessageContext): Promise<SendMessageResponse>;
     /**
      * Streaming variant of `sendMessage` — consumes the server's SSE
@@ -786,8 +804,23 @@ interface AppilotsConfig {
      * flags silently denied the fourth.
      */
     permissions?: Partial<AgentPermissions>;
+    /**
+     * Accessibility: plain-language replies (short sentences, everyday
+     * words, numbered steps) for this session. Omit to follow the dashboard
+     * setting; `true`/`false` overrides it. Changing it later takes effect
+     * on the next message without starting a new session.
+     */
+    plainLanguage?: boolean;
     /** Enable debug logging */
     debug?: boolean;
+    /**
+     * How long (ms) the client waits for the assistant before giving up on
+     * a request, and how long a reply stream may stay silent. Default
+     * 60000; agent continuations always get at least 150000. Raise it for
+     * users or networks that need more time — the user's message stays in
+     * the transcript either way.
+     */
+    timeout?: number;
     /**
      * Host app version (e.g. package.json version). Forwarded to the API
      * as `X-App-Version` so the server can serve the MCP document matching

package/dist/{index-CI4jmSoP.d.ts → index-wMMetyrj.d.ts}

@@ -408,6 +408,13 @@ interface AppilotsClientOptions {
      * id. Identifiers are dashboard-only — never sent to the LLM.
      */
     user?: AppilotsUser;
+    /**
+     * Accessibility: ask the agent to reply in plain language (short
+     * sentences, everyday words, numbered steps). `undefined` defers to the
+     * project setting in the dashboard; `true`/`false` overrides it for this
+     * session. Change it later with `setPlainLanguage`.
+     */
+    plainLanguage?: boolean;
 }
 interface AppilotsUser {
     /** The app's own user id (matches your backend). */
@@ -472,6 +479,8 @@ interface SendMessageContext {
     missionId?: string;
     /** Supported device language, independent of the app/map/visible UI locale. */
     deviceLocale?: SupportedAppilotsLocale;
+    /** Set by the client from `plainLanguage` / `setPlainLanguage`; see there. */
+    plainLanguage?: boolean;
     /**
      * Which client platform this observation came from — `'react-native'`,
      * `'web'`, `'android'`, `'ios'`, or any other client-defined string.
@@ -526,6 +535,7 @@ declare class AppilotsClient {
     private readonly mcpVersion;
     private readonly introspectionReporter;
     private readonly user;
+    private plainLanguage;
     private sessionId;
     private mission;
     private missionDispatchPaused;
@@ -566,6 +576,14 @@ declare class AppilotsClient {
      * must not take the message down with it.
      */
     private introspectionFragment;
+    /**
+     * Per-session plain-language override — e.g. from the signed-in user's
+     * accessibility profile. `undefined` hands the decision back to the
+     * project setting. Applies from the next request on.
+     */
+    setPlainLanguage(value: boolean | undefined): void;
+    /** Every relay-bound context carries the reply-style preference. */
+    private withPreferences;
     sendMessage(content: string, context?: SendMessageContext): Promise<SendMessageResponse>;
     /**
      * Streaming variant of `sendMessage` — consumes the server's SSE
@@ -786,8 +804,23 @@ interface AppilotsConfig {
      * flags silently denied the fourth.
      */
     permissions?: Partial<AgentPermissions>;
+    /**
+     * Accessibility: plain-language replies (short sentences, everyday
+     * words, numbered steps) for this session. Omit to follow the dashboard
+     * setting; `true`/`false` overrides it. Changing it later takes effect
+     * on the next message without starting a new session.
+     */
+    plainLanguage?: boolean;
     /** Enable debug logging */
     debug?: boolean;
+    /**
+     * How long (ms) the client waits for the assistant before giving up on
+     * a request, and how long a reply stream may stay silent. Default
+     * 60000; agent continuations always get at least 150000. Raise it for
+     * users or networks that need more time — the user's message stays in
+     * the transcript either way.
+     */
+    timeout?: number;
     /**
      * Host app version (e.g. package.json version). Forwarded to the API
      * as `X-App-Version` so the server can serve the MCP document matching