@mobileai/react-native 0.9.0 → 0.9.2

package/lib/typescript/src/index.d.ts

@@ -5,6 +5,9 @@
  * Auto-detects interactive elements via React Fiber tree traversal.
  */
 export { AIAgent } from './components/AIAgent';
+export { AIZone } from './components/AIZone';
+export { InfoCard } from './components/cards/InfoCard';
+export { ReviewSummary } from './components/cards/ReviewSummary';
 export { GeminiProvider } from './providers/GeminiProvider';
 export { OpenAIProvider } from './providers/OpenAIProvider';
 export { createProvider } from './providers/ProviderFactory';
@@ -16,4 +19,6 @@ export { KnowledgeBaseService } from './services/KnowledgeBaseService';
 export { logger } from './utils/logger';
 export type { AgentConfig, AgentMode, ExecutionResult, InteractiveElement, DehydratedScreen, ToolDefinition, ActionDefinition, TokenUsage, KnowledgeEntry, KnowledgeRetriever, KnowledgeBaseConfig, ChatBarTheme, AIMessage, AIProviderName, ScreenMap, ScreenMapEntry, } from './core/types';
 export type { VoiceServiceConfig, VoiceServiceCallbacks, VoiceStatus, } from './services/VoiceService';
+export { SupportGreeting, CSATSurvey, buildSupportPrompt, createEscalateTool } from './support';
+export type { SupportModeConfig, QuickReply, EscalationConfig, EscalationContext, CSATConfig, CSATRating, BusinessHoursConfig, } from './support';
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAG/C,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAG7D,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAGrD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAGvE,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAGxC,YAAY,EACV,WAAW,EACX,SAAS,EACT,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,UAAU,EACV,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,YAAY,EACZ,SAAS,EACT,cAAc,EACd,SAAS,EACT,cAAc,GACf,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,kBAAkB,EAClB,qBAAqB,EACrB,WAAW,GACZ,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAG7C,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAGjE,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAG7D,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAGrD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAOvE,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAGxC,YAAY,EACV,WAAW,EACX,SAAS,EACT,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,UAAU,EACV,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,YAAY,EACZ,SAAS,EACT,cAAc,EACd,SAAS,EACT,cAAc,GACf,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,kBAAkB,EAClB,qBAAqB,EACrB,WAAW,GACZ,MAAM,yBAAyB,CAAC;AAYjC,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAEhG,YAAY,EACV,iBAAiB,EACjB,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,EACV,UAAU,EACV,mBAAmB,GACpB,MAAM,WAAW,CAAC"}

package/lib/typescript/src/services/AudioOutputService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AudioOutputService.d.ts","sourceRoot":"","sources":["../../../../src/services/AudioOutputService.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAUH,MAAM,WAAW,iBAAiB;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,IAAI,CAAC;IAC7B,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;IAC3B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAID,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,eAAe,CAAa;IACpC,OAAO,CAAC,QAAQ,CAAa;IAC7B,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAK;gBAEX,MAAM,GAAE,iBAAsB;IAMpC,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IA8DpC,uEAAuE;IACvE,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAwDlC,IAAI,IAAI,IAAI;IAQZ,MAAM,IAAI,IAAI;IAQd,IAAI,OAAO,IAAI,OAAO,CAErB;IAIK,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAyBrB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAa/B"}
+{"version":3,"file":"AudioOutputService.d.ts","sourceRoot":"","sources":["../../../../src/services/AudioOutputService.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAWH,MAAM,WAAW,iBAAiB;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,IAAI,CAAC;IAC7B,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;IAC3B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAID,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,eAAe,CAAa;IACpC,OAAO,CAAC,QAAQ,CAAa;IAC7B,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAK;gBAEX,MAAM,GAAE,iBAAsB;IAMpC,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IA0EpC,uEAAuE;IACvE,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAwDlC,IAAI,IAAI,IAAI;IAQZ,MAAM,IAAI,IAAI;IAQd,IAAI,OAAO,IAAI,OAAO,CAErB;IAIK,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAyBrB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAa/B"}

package/lib/typescript/src/services/flags/FlagService.d.ts

@@ -0,0 +1,25 @@
+export interface FeatureFlagPayload {
+    key: string;
+    variants: string[];
+    rollout: number[];
+}
+export declare class FlagService {
+    private hostUrl;
+    private assignments;
+    private fetched;
+    constructor(hostUrl: string);
+    /**
+     * Fetch feature flags from the dashboard backend
+     */
+    fetch(analyticsKey: string, userId?: string): Promise<void>;
+    /**
+     * Deterministically assign a variant using murmurhash.
+     */
+    private assignVariant;
+    private assignAll;
+    /** Get a specific flag value */
+    getFlag(key: string, defaultValue?: string): string;
+    /** Get all active assignments for telemetry */
+    getAllFlags(): Record<string, string>;
+}
+//# sourceMappingURL=FlagService.d.ts.map

package/lib/typescript/src/services/flags/FlagService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FlagService.d.ts","sourceRoot":"","sources":["../../../../../src/services/flags/FlagService.ts"],"names":[],"mappings":"AA0DA,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,qBAAa,WAAW;IAIV,OAAO,CAAC,OAAO;IAH3B,OAAO,CAAC,WAAW,CAA8B;IACjD,OAAO,CAAC,OAAO,CAAkB;gBAEb,OAAO,EAAE,MAAM;IAEnC;;OAEG;IACG,KAAK,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBjE;;OAEG;IACH,OAAO,CAAC,aAAa;IAerB,OAAO,CAAC,SAAS;IAajB,gCAAgC;IAChC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM;IAOnD,+CAA+C;IAC/C,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;CAGtC"}

package/lib/typescript/src/services/telemetry/MobileAI.d.ts

@@ -0,0 +1,38 @@
+/**
+ * MobileAI — Public static API for consumer event tracking.
+ *
+ * Usage:
+ *   import { MobileAI } from '@mobileai/react-native';
+ *   MobileAI.track('purchase_complete', { total: 29.99 });
+ *
+ * The TelemetryService instance is injected by the <AIAgent> component.
+ * If no analyticsKey is configured, all calls are no-ops.
+ */
+import type { TelemetryService } from './TelemetryService';
+export declare const MobileAI: {
+    /**
+     * Track a custom business event.
+     * @param eventName - Name of the event (e.g., 'purchase_complete')
+     * @param data - Event-specific key-value data
+     */
+    track(eventName: string, data?: Record<string, unknown>): void;
+    /**
+     * Identify the current user (optional, for user-level analytics).
+     * @param userId - Unique user identifier (hashed by consumer)
+     * @param traits - Optional user traits (plan, role, etc.)
+     */
+    identify(userId: string, traits?: Record<string, unknown>): void;
+    /**
+     * Get an assigned feature flag variation for the current device.
+     * Deterministic via murmurhash. Call after MobileAI has initialized.
+     * @param key Flag key
+     * @param defaultValue Fallback if not assigned
+     */
+    getFlag(key: string, defaultValue?: string): string;
+};
+/**
+ * Internal: Bind the TelemetryService instance (called by AIAgent on mount).
+ * Not exported to consumers.
+ */
+export declare function bindTelemetryService(instance: TelemetryService | null): void;
+//# sourceMappingURL=MobileAI.d.ts.map

package/lib/typescript/src/services/telemetry/MobileAI.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MobileAI.d.ts","sourceRoot":"","sources":["../../../../../src/services/telemetry/MobileAI.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAO3D,eAAO,MAAM,QAAQ;IACnB;;;;OAIG;qBACc,MAAM,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAQ,IAAI;IAQlE;;;;OAIG;qBACc,MAAM,WAAU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAQ,IAAI;IAQpE;;;;;OAKG;iBACU,MAAM,iBAAiB,MAAM,GAAG,MAAM;CAMpD,CAAC;AAEF;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI,GAAG,IAAI,CAE5E"}

package/lib/typescript/src/services/telemetry/PiiScrubber.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Scrubs common PII patterns from strings.
+ * Used by TelemetryService to sanitize auto-captured touch labels.
+ */
+export declare function scrubPII(value: string): string;
+//# sourceMappingURL=PiiScrubber.d.ts.map

package/lib/typescript/src/services/telemetry/PiiScrubber.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PiiScrubber.d.ts","sourceRoot":"","sources":["../../../../../src/services/telemetry/PiiScrubber.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQ9C"}

package/lib/typescript/src/services/telemetry/TelemetryService.d.ts

@@ -0,0 +1,49 @@
+/**
+ * TelemetryService — Batches and sends analytics events to MobileAI Cloud.
+ *
+ * Features:
+ * - Event batching (flush every N seconds or N events)
+ * - Offline queue with retry on reconnect
+ * - Lightweight — no native dependencies
+ * - Opt-in only (requires analyticsKey or analyticsProxyUrl)
+ */
+import type { TelemetryConfig } from './types';
+import { FlagService } from '../flags/FlagService';
+export declare class TelemetryService {
+    private queue;
+    private config;
+    private sessionId;
+    private currentScreen;
+    private flushTimer;
+    private isFlushing;
+    private appStateSubscription;
+    /** Public getter for the current screen, used by auto-capture utilities */
+    get screen(): string;
+    /**
+     * True while the AI agent is executing a tool (tap, type, navigate, etc.).
+     * The touch interceptor checks this flag to avoid double-counting AI actions
+     * as human interactions. Agent steps are already tracked as agent_step events.
+     */
+    isAgentActing: boolean;
+    flags: FlagService;
+    /** Set by AgentRuntime before/after each tool execution. */
+    setAgentActing(active: boolean): void;
+    constructor(config: TelemetryConfig);
+    /** Start the telemetry service (call on mount) */
+    start(): Promise<void>;
+    /** Stop the telemetry service (call on unmount) */
+    stop(): Promise<void>;
+    /** Track an event (auto or custom) */
+    track(type: string, data?: Record<string, unknown>): void;
+    /** Update current screen (called by AIAgent on navigation) */
+    setScreen(screenName: string): void;
+    /** Send queued events to the cloud API */
+    flush(): Promise<void>;
+    /** Save queued events to AsyncStorage for crash/restart recovery */
+    private persistQueue;
+    /** Restore queued events from previous session */
+    private restoreQueue;
+    /** Check if telemetry is configured */
+    private isEnabled;
+}
+//# sourceMappingURL=TelemetryService.d.ts.map

package/lib/typescript/src/services/telemetry/TelemetryService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TelemetryService.d.ts","sourceRoot":"","sources":["../../../../../src/services/telemetry/TelemetryService.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAGV,eAAe,EAChB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AA8BnD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,KAAK,CAAwB;IACrC,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,aAAa,CAAa;IAClC,OAAO,CAAC,UAAU,CAA+C;IACjE,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,oBAAoB,CAA6D;IAEzF,2EAA2E;IAC3E,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED;;;;OAIG;IACH,aAAa,UAAS;IAEf,KAAK,EAAE,WAAW,CAAC;IAE1B,4DAA4D;IAC5D,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;gBAIzB,MAAM,EAAE,eAAe;IAgBnC,kDAAkD;IAC5C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAwC5B,mDAAmD;IAC7C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA0B3B,sCAAsC;IACtC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,IAAI;IAmC7D,8DAA8D;IAC9D,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAcnC,0CAA0C;IACpC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA8C5B,oEAAoE;YACtD,YAAY;IAS1B,kDAAkD;YACpC,YAAY;IAiB1B,uCAAuC;IACvC,OAAO,CAAC,SAAS;CAGlB"}

package/lib/typescript/src/services/telemetry/TouchAutoCapture.d.ts

@@ -0,0 +1,28 @@
+/**
+ * TouchAutoCapture — Extracts a human-readable label from a React Native
+ * touch event target by walking up the native view hierarchy.
+ *
+ * Used by AIAgent to auto-track every tap in the app without
+ * any developer code changes (zero-config analytics).
+ *
+ * Strategy:
+ * 1. Read the touched element's accessibilityLabel (best signal).
+ * 2. If none, use React Native's internal _children to find nested text.
+ * 3. Fallback to the component's testID.
+ * 4. Last resort: "Unknown Element".
+ */
+import type { TelemetryService } from './TelemetryService';
+/**
+ * Checks if the user is repeatedly tapping the same element in frustration.
+ * If rage click detected, emits 'rage_click' event to telemetry.
+ */
+export declare function checkRageClick(label: string, telemetry: TelemetryService): void;
+/**
+ * Extract a label from a GestureResponderEvent's native target.
+ *
+ * @param nativeEvent - The nativeEvent from onStartShouldSetResponderCapture
+ * @param rootRef - The root View ref (to resolve relative positions)
+ * @returns A descriptive label string for the tapped element
+ */
+export declare function extractTouchLabel(nativeEvent: any): string;
+//# sourceMappingURL=TouchAutoCapture.d.ts.map

package/lib/typescript/src/services/telemetry/TouchAutoCapture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TouchAutoCapture.d.ts","sourceRoot":"","sources":["../../../../../src/services/telemetry/TouchAutoCapture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAM3D;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,gBAAgB,GAAG,IAAI,CAgB/E;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,GAAG,GAAG,MAAM,CA6D1D"}

package/lib/typescript/src/services/telemetry/device.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Deterministic device ID based on platform info.
+ * This ensures analytics and flags remain consistent across sessions
+ * without collecting PII hardware identifiers.
+ */
+export declare function getDeviceId(): string;
+//# sourceMappingURL=device.d.ts.map

package/lib/typescript/src/services/telemetry/device.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device.d.ts","sourceRoot":"","sources":["../../../../../src/services/telemetry/device.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAQpC"}

package/lib/typescript/src/services/telemetry/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Telemetry module barrel export.
+ */
+export { TelemetryService } from './TelemetryService';
+export { MobileAI, bindTelemetryService } from './MobileAI';
+export type { TelemetryEvent, TelemetryBatch, TelemetryConfig, AutoEventType, EventType, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/services/telemetry/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/services/telemetry/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAC5D,YAAY,EACV,cAAc,EACd,cAAc,EACd,eAAe,EACf,aAAa,EACb,SAAS,GACV,MAAM,SAAS,CAAC"}

package/lib/typescript/src/services/telemetry/types.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Telemetry types for the MobileAI analytics module.
+ *
+ * Events are split into two categories:
+ * 1. Auto-captured: SDK captures these without consumer code
+ * 2. Consumer-tracked: via MobileAI.track() API
+ */
+/** Auto-captured event types */
+export type AutoEventType = 'screen_view' | 'user_action' | 'scroll_depth' | 'idle_detected' | 'session_start' | 'session_end' | 'agent_request' | 'agent_step' | 'agent_complete' | 'escalation' | 'knowledge_query' | 'knowledge_miss' | 'csat_response';
+/** All event types (auto + custom) */
+export type EventType = AutoEventType | string;
+export interface TelemetryEvent {
+    /** Event type identifier */
+    type: EventType;
+    /** Event-specific data */
+    data: Record<string, unknown>;
+    /** ISO 8601 timestamp (auto-set by SDK) */
+    timestamp: string;
+    /** Current screen name (auto-attached) */
+    screen: string;
+    /** Session ID (auto-generated per app lifecycle) */
+    sessionId: string;
+}
+export interface TelemetryBatch {
+    /** Publishable analytics key */
+    analyticsKey: string;
+    /** App identifier (bundle ID / package name) */
+    appId: string;
+    /** Hashed user/device identifier */
+    deviceId: string;
+    /** SDK version */
+    sdkVersion: string;
+    /** Batch of events */
+    events: TelemetryEvent[];
+}
+export interface TelemetryConfig {
+    /** Publishable analytics key (mobileai_pub_xxx) */
+    analyticsKey?: string;
+    /** Proxy URL for enterprise customers (replaces direct cloud API) */
+    analyticsProxyUrl?: string;
+    /** Custom headers for proxy requests */
+    analyticsProxyHeaders?: Record<string, string>;
+    /** Flush interval in ms (default: 30000) */
+    flushIntervalMs?: number;
+    /** Max events before auto-flush (default: 50) */
+    maxBatchSize?: number;
+    /** Enable debug logging for telemetry (default: false) */
+    debug?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/typescript/src/services/telemetry/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/services/telemetry/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,gCAAgC;AAChC,MAAM,MAAM,aAAa,GACrB,aAAa,GACb,aAAa,GACb,cAAc,GACd,eAAe,GACf,eAAe,GACf,aAAa,GACb,eAAe,GACf,YAAY,GACZ,gBAAgB,GAChB,YAAY,GACZ,iBAAiB,GACjB,gBAAgB,GAChB,eAAe,CAAC;AAEpB,sCAAsC;AACtC,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,MAAM,CAAC;AAI/C,MAAM,WAAW,cAAc;IAC7B,4BAA4B;IAC5B,IAAI,EAAE,SAAS,CAAC;IAChB,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAC;CACnB;AAID,MAAM,WAAW,cAAc;IAC7B,gCAAgC;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,sBAAsB;IACtB,MAAM,EAAE,cAAc,EAAE,CAAC;CAC1B;AAID,MAAM,WAAW,eAAe;IAC9B,mDAAmD;IACnD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qEAAqE;IACrE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,wCAAwC;IACxC,qBAAqB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C,4CAA4C;IAC5C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iDAAiD;IACjD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0DAA0D;IAC1D,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB"}

package/lib/typescript/src/support/CSATSurvey.d.ts

@@ -0,0 +1,20 @@
+/**
+ * CSAT Survey — Customer Satisfaction component.
+ *
+ * Shown after a support conversation ends (or after idle timeout).
+ * Supports three rating types: emoji, stars, thumbs.
+ */
+import type { CSATConfig, CSATRating } from './types';
+interface CSATSurveyProps {
+    config: CSATConfig;
+    metadata: CSATRating['metadata'];
+    onDismiss: () => void;
+    theme?: {
+        primaryColor?: string;
+        textColor?: string;
+        backgroundColor?: string;
+    };
+}
+export declare function CSATSurvey({ config, metadata, onDismiss, theme, }: CSATSurveyProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=CSATSurvey.d.ts.map

package/lib/typescript/src/support/CSATSurvey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CSATSurvey.d.ts","sourceRoot":"","sources":["../../../../src/support/CSATSurvey.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEtD,UAAU,eAAe;IACvB,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC;IACjC,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,KAAK,CAAC,EAAE;QACN,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;CACH;AAYD,wBAAgB,UAAU,CAAC,EACzB,MAAM,EACN,QAAQ,EACR,SAAS,EACT,KAAK,GACN,EAAE,eAAe,2CAqKjB"}

package/lib/typescript/src/support/EscalationSocket.d.ts

@@ -0,0 +1,38 @@
+/**
+ * EscalationSocket — manages a WebSocket connection to the MobileAI platform
+ * for receiving real-time replies from human support agents.
+ *
+ * Lifecycle:
+ * 1. SDK calls escalate_to_human → POST /api/v1/escalations → gets { ticketId, wsUrl }
+ * 2. EscalationSocket.connect(wsUrl) opens a WS connection
+ * 3. Platform pushes { type: 'reply', ticketId, reply } when agent responds
+ * 4. onReply callback fires → shown in chat UI as "👤 Human Agent: <reply>"
+ * 5. disconnect() on chat close / unmount
+ *
+ * Handles:
+ * - Server heartbeat pings (type: 'ping') — acknowledged silently
+ * - Auto-reconnect on unexpected close (max 3 attempts, exponential backoff)
+ */
+export type SocketReplyHandler = (reply: string) => void;
+interface EscalationSocketOptions {
+    onReply: SocketReplyHandler;
+    onError?: (error: Event) => void;
+    maxReconnectAttempts?: number;
+}
+export declare class EscalationSocket {
+    private ws;
+    private wsUrl;
+    private reconnectAttempts;
+    private reconnectTimer;
+    private intentionalClose;
+    private readonly onReply;
+    private readonly onError?;
+    private readonly maxReconnectAttempts;
+    constructor(options: EscalationSocketOptions);
+    connect(wsUrl: string): void;
+    disconnect(): void;
+    private openConnection;
+    private scheduleReconnect;
+}
+export {};
+//# sourceMappingURL=EscalationSocket.d.ts.map

package/lib/typescript/src/support/EscalationSocket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EscalationSocket.d.ts","sourceRoot":"","sources":["../../../../src/support/EscalationSocket.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;AAEzD,UAAU,uBAAuB;IAC/B,OAAO,EAAE,kBAAkB,CAAC;IAC5B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,cAAc,CAA8C;IACpE,OAAO,CAAC,gBAAgB,CAAS;IAEjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAyB;IAClD,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAS;gBAElC,OAAO,EAAE,uBAAuB;IAM5C,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAM5B,UAAU,IAAI,IAAI;IAYlB,OAAO,CAAC,cAAc;IAuCtB,OAAO,CAAC,iBAAiB;CAc1B"}

package/lib/typescript/src/support/SupportGreeting.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Support Greeting & Quick Replies — shown when chat opens in support mode.
+ *
+ * Renders a welcome message with an avatar and quick reply buttons
+ * that pre-fill the user's first message.
+ */
+import type { SupportModeConfig } from './types';
+interface SupportGreetingProps {
+    config: SupportModeConfig;
+    onQuickReply: (message: string) => void;
+    theme?: {
+        primaryColor?: string;
+        textColor?: string;
+        backgroundColor?: string;
+    };
+}
+export declare function SupportGreeting({ config, onQuickReply, theme, }: SupportGreetingProps): import("react/jsx-runtime").JSX.Element | null;
+export {};
+//# sourceMappingURL=SupportGreeting.d.ts.map

package/lib/typescript/src/support/SupportGreeting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SupportGreeting.d.ts","sourceRoot":"","sources":["../../../../src/support/SupportGreeting.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD,UAAU,oBAAoB;IAC5B,MAAM,EAAE,iBAAiB,CAAC;IAC1B,YAAY,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,KAAK,CAAC,EAAE;QACN,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;CACH;AAED,wBAAgB,eAAe,CAAC,EAC9B,MAAM,EACN,YAAY,EACZ,KAAK,GACN,EAAE,oBAAoB,kDAgEtB"}

package/lib/typescript/src/support/escalateTool.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Escalate tool — hands off the conversation to a human agent.
+ *
+ * Providers:
+ * - 'mobileai' (default when analyticsKey present):
+ *   POSTs to MobileAI /api/v1/escalations → gets ticketId + wsUrl
+ *   Opens WebSocket via EscalationSocket → agent reply pushed in real time
+ * - 'custom': fires the consumer's onEscalate callback (backward compatible)
+ */
+import type { ToolDefinition } from '../core/types';
+import type { EscalationConfig, EscalationContext } from './types';
+export interface EscalationToolDeps {
+    config: EscalationConfig;
+    analyticsKey?: string;
+    getContext: () => Omit<EscalationContext, 'conversationSummary'>;
+    getHistory: () => Array<{
+        role: string;
+        content: string;
+    }>;
+    onHumanReply?: (reply: string) => void;
+}
+export declare function createEscalateTool(deps: EscalationToolDeps): ToolDefinition;
+/** @deprecated Use createEscalateTool({ config, analyticsKey, getContext, getHistory }) */
+export declare function createEscalateTool(config: EscalationConfig, getContext: () => Omit<EscalationContext, 'conversationSummary'>): ToolDefinition;
+//# sourceMappingURL=escalateTool.d.ts.map

package/lib/typescript/src/support/escalateTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"escalateTool.d.ts","sourceRoot":"","sources":["../../../../src/support/escalateTool.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAKnE,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,gBAAgB,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,IAAI,CAAC,iBAAiB,EAAE,qBAAqB,CAAC,CAAC;IACjE,UAAU,EAAE,MAAM,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3D,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACxC;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,kBAAkB,GAAG,cAAc,CAAC;AAC7E,2FAA2F;AAC3F,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,gBAAgB,EACxB,UAAU,EAAE,MAAM,IAAI,CAAC,iBAAiB,EAAE,qBAAqB,CAAC,GAC/D,cAAc,CAAC"}

package/lib/typescript/src/support/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Support Mode — barrel export.
+ */
+export type { SupportModeConfig, QuickReply, EscalationConfig, EscalationContext, CSATConfig, CSATRating, BusinessHoursConfig, } from './types';
+export { buildSupportPrompt } from './supportPrompt';
+export { createEscalateTool } from './escalateTool';
+export { EscalationSocket } from './EscalationSocket';
+export type { SocketReplyHandler } from './EscalationSocket';
+export { SupportGreeting } from './SupportGreeting';
+export { CSATSurvey } from './CSATSurvey';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/support/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/support/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,YAAY,EACV,iBAAiB,EACjB,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,EACV,UAAU,EACV,mBAAmB,GACpB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAGrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAG7D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC"}

package/lib/typescript/src/support/supportPrompt.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Support Mode prompt — injected into the system prompt when support mode is enabled.
+ *
+ * Uses POSITIVE framing (what TO DO) instead of negative rules (per user's prompt engineering rules).
+ */
+import type { SupportModeConfig } from './types';
+/**
+ * Build the support mode system prompt addition.
+ * This gets appended to the main system prompt when support mode is active.
+ */
+export declare function buildSupportPrompt(config: SupportModeConfig): string;
+//# sourceMappingURL=supportPrompt.d.ts.map

package/lib/typescript/src/support/supportPrompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supportPrompt.d.ts","sourceRoot":"","sources":["../../../../src/support/supportPrompt.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CA0CpE"}

package/lib/typescript/src/support/types.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Support Mode — types and configuration.
+ *
+ * Transforms the AI agent into a customer support assistant with:
+ * - Custom greeting message
+ * - Quick reply suggestions
+ * - Human escalation capability
+ * - CSAT (Customer Satisfaction) collection after conversation
+ */
+export interface SupportModeConfig {
+    /** Enable support mode. Default: false */
+    enabled: boolean;
+    /** Greeting message shown when the chat opens */
+    greeting?: {
+        /** Main greeting text (e.g., "Hi! 👋 How can I help you today?") */
+        message: string;
+        /** Agent name shown above the greeting (e.g., "MobileAI Support") */
+        agentName?: string;
+        /** Avatar URL for the support agent */
+        avatarUrl?: string;
+    };
+    /** Quick reply buttons shown below the greeting */
+    quickReplies?: QuickReply[];
+    /** Escalation configuration */
+    escalation?: EscalationConfig;
+    /** CSAT survey configuration */
+    csat?: CSATConfig;
+    /** Business hours (optional — shows offline message outside hours) */
+    businessHours?: BusinessHoursConfig;
+    /**
+     * Additional system prompt context for the support persona.
+     * Merged with the base system prompt.
+     * Example: "You are a friendly support agent for FeedYum food delivery app."
+     */
+    systemContext?: string;
+    /**
+     * Topics the AI should NOT attempt to resolve — escalate immediately.
+     * Example: ['billing dispute', 'account deletion', 'legal']
+     */
+    autoEscalateTopics?: string[];
+}
+export interface QuickReply {
+    /** Display text on the button */
+    label: string;
+    /** Message sent when tapped (defaults to label if not set) */
+    message?: string;
+    /** Icon emoji (optional) */
+    icon?: string;
+}
+export interface EscalationConfig {
+    /**
+     * Where to route the escalation.
+     * - 'mobileai' (default when analyticsKey is set): ticket goes to MobileAI
+     *   dashboard inbox via POST /api/v1/escalations + WebSocket reply delivery.
+     * - 'custom': fires the onEscalate callback — wire to Intercom, Zendesk, etc.
+     */
+    provider?: 'mobileai' | 'custom';
+    /**
+     * Callback when user requests human support (required when provider='custom').
+     * Use this to open a live chat widget, send email, etc.
+     */
+    onEscalate?: (context: EscalationContext) => void;
+    /** Label for the escalate button. Default: "Talk to a human" */
+    buttonLabel?: string;
+    /** Message shown to user when escalated. Default: "Connecting you to a human agent..." */
+    escalationMessage?: string;
+}
+export interface EscalationContext {
+    /** Summary of the conversation so far */
+    conversationSummary: string;
+    /** Current screen the user is on */
+    currentScreen: string;
+    /** User's original question/issue */
+    originalQuery: string;
+    /** Number of AI steps taken before escalation */
+    stepsBeforeEscalation: number;
+}
+export interface CSATConfig {
+    /** Enable CSAT survey after conversation. Default: true if support mode enabled */
+    enabled?: boolean;
+    /** Question text. Default: "How was your experience?" */
+    question?: string;
+    /** Rating type. Default: 'emoji' */
+    ratingType?: 'stars' | 'emoji' | 'thumbs';
+    /** Callback when user submits rating */
+    onSubmit: (rating: CSATRating) => void;
+    /** Show after N seconds of inactivity. Default: 10 */
+    showAfterIdleSeconds?: number;
+}
+export interface CSATRating {
+    /** Numeric score (1-5 for stars/emoji, 0-1 for thumbs) */
+    score: number;
+    /** Optional text feedback */
+    feedback?: string;
+    /** Conversation metadata */
+    metadata: {
+        conversationDuration: number;
+        stepsCount: number;
+        wasEscalated: boolean;
+        screen: string;
+    };
+}
+export interface BusinessHoursConfig {
+    /** Timezone (IANA format, e.g., 'Africa/Cairo') */
+    timezone: string;
+    /** Schedule per day of week (0=Sunday, 6=Saturday) */
+    schedule: Record<number, {
+        start: string;
+        end: string;
+    } | null>;
+    /** Message shown outside business hours */
+    offlineMessage?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/typescript/src/support/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/support/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,MAAM,WAAW,iBAAiB;IAChC,0CAA0C;IAC1C,OAAO,EAAE,OAAO,CAAC;IAEjB,iDAAiD;IACjD,QAAQ,CAAC,EAAE;QACT,oEAAoE;QACpE,OAAO,EAAE,MAAM,CAAC;QAChB,qEAAqE;QACrE,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,uCAAuC;QACvC,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IAEF,mDAAmD;IACnD,YAAY,CAAC,EAAE,UAAU,EAAE,CAAC;IAE5B,+BAA+B;IAC/B,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAE9B,gCAAgC;IAChC,IAAI,CAAC,EAAE,UAAU,CAAC;IAElB,sEAAsE;IACtE,aAAa,CAAC,EAAE,mBAAmB,CAAC;IAEpC;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B;AAID,MAAM,WAAW,UAAU;IACzB,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4BAA4B;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAID,MAAM,WAAW,gBAAgB;IAC/B;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,UAAU,GAAG,QAAQ,CAAC;IAEjC;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAElD,gEAAgE;IAChE,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,0FAA0F;IAC1F,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,iBAAiB;IAChC,yCAAyC;IACzC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,oCAAoC;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,qCAAqC;IACrC,aAAa,EAAE,MAAM,CAAC;IACtB,iDAAiD;IACjD,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAID,MAAM,WAAW,UAAU;IACzB,mFAAmF;IACnF,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,oCAAoC;IACpC,UAAU,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;IAE1C,wCAAwC;IACxC,QAAQ,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI,CAAC;IAEvC,sDAAsD;IACtD,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,UAAU;IACzB,0DAA0D;IAC1D,KAAK,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4BAA4B;IAC5B,QAAQ,EAAE;QACR,oBAAoB,EAAE,MAAM,CAAC;QAC7B,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,OAAO,CAAC;QACtB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAID,MAAM,WAAW,mBAAmB;IAClC,mDAAmD;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IAChE,2CAA2C;IAC3C,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB"}

package/lib/typescript/src/tools/guideTool.d.ts

@@ -0,0 +1,4 @@
+import type { ToolDefinition } from '../core/types';
+import type { ToolContext } from './types';
+export declare function createGuideTool(context: ToolContext): ToolDefinition;
+//# sourceMappingURL=guideTool.d.ts.map

package/lib/typescript/src/tools/guideTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guideTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/guideTool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAG3C,wBAAgB,eAAe,CAAC,OAAO,EAAE,WAAW,GAAG,cAAc,CA6DpE"}

package/lib/typescript/src/tools/index.d.ts

@@ -12,5 +12,8 @@ export { createSliderTool } from './sliderTool';
 export { createPickerTool } from './pickerTool';
 export { createDatePickerTool } from './datePickerTool';
 export { createKeyboardTool } from './keyboardTool';
+export { createGuideTool } from './guideTool';
+export { createSimplifyTool } from './simplifyTool';
+export { createRestoreTool } from './restoreTool';
 export type { AgentTool, ToolContext, ToolParameter } from './types';
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/tools/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEpD,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAElD,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC"}

package/lib/typescript/src/tools/restoreTool.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDefinition } from '../core/types';
+export declare function createRestoreTool(): ToolDefinition;
+//# sourceMappingURL=restoreTool.d.ts.map

package/lib/typescript/src/tools/restoreTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restoreTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/restoreTool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAIpD,wBAAgB,iBAAiB,IAAI,cAAc,CA4BlD"}

package/lib/typescript/src/tools/simplifyTool.d.ts

@@ -0,0 +1,3 @@
+import type { ToolDefinition } from '../core/types';
+export declare function createSimplifyTool(): ToolDefinition;
+//# sourceMappingURL=simplifyTool.d.ts.map

package/lib/typescript/src/tools/simplifyTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simplifyTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/simplifyTool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAIpD,wBAAgB,kBAAkB,IAAI,cAAc,CA4BnD"}

package/lib/typescript/src/tools/types.d.ts

@@ -43,5 +43,7 @@ export interface ToolContext {
     buildNestedParams?: (path: string[], params?: any) => any;
     /** Capture screenshot (optional) */
     captureScreenshot?: () => Promise<string | null>;
+    /** Get the most recently dehydrated screen (with layout coords) */
+    getLastDehydratedRoot?: () => any;
 }
 //# sourceMappingURL=types.d.ts.map