@appilots/web-sdk 0.2.0

package/dist/index.js

@@ -0,0 +1,234 @@
+'use strict';
+
+var chunkT5TUFZ6T_js = require('./chunk-T5TUFZ6T.js');
+
+
+
+Object.defineProperty(exports, "APPILOTS_CHAT_ATTR", {
+  enumerable: true,
+  get: function () { return chunkT5TUFZ6T_js.APPILOTS_CHAT_ATTR; }
+});
+Object.defineProperty(exports, "APPILOTS_ID_ATTR", {
+  enumerable: true,
+  get: function () { return chunkT5TUFZ6T_js.APPILOTS_ID_ATTR; }
+});
+Object.defineProperty(exports, "APPILOTS_ITEM_COUNT_ATTR", {
+  enumerable: true,
+  get: function () { return chunkT5TUFZ6T_js.APPILOTS_ITEM_COUNT_ATTR; }
+});
+Object.defineProperty(exports, "APPILOTS_ITEM_INDEX_ATTR", {
+  enumerable: true,
+  get: function () { return chunkT5TUFZ6T_js.APPILOTS_ITEM_INDEX_ATTR; }
+});
+Object.defineProperty(exports, "APPILOTS_ITEM_KEY_ATTR", {
+  enumerable: true,
+  get: function () { return chunkT5TUFZ6T_js.APPILOTS_ITEM_KEY_ATTR; }
+});
+Object.defineProperty(exports, "APPILOTS_LIST_ID_ATTR", {
+  enumerable: true,
+  get: function () { return chunkT5TUFZ6T_js.APPILOTS_LIST_ID_ATTR; }
+});
+Object.defineProperty(exports, "APPILOTS_LIST_ITEM_ATTR", {
+  enumerable: true,
+  get: function () { return chunkT5TUFZ6T_js.APPILOTS_LIST_ITEM_ATTR; }
+});
+Object.defineProperty(exports, "APPILOTS_SENSITIVE_ATTR", {
+  enumerable: true,
+  get: function () { return chunkT5TUFZ6T_js.APPILOTS_SENSITIVE_ATTR; }
+});
+Object.defineProperty(exports, "APPILOTS_SKIP_ATTR", {
+  enumerable: true,
+  get: function () { return chunkT5TUFZ6T_js.APPILOTS_SKIP_ATTR; }
+});
+Object.defineProperty(exports, "ActionQueueMachine", {
+  enumerable: true,
+  get: function () { return chunkT5TUFZ6T_js.ActionQueueMachine; }
+});
+Object.defineProperty(exports, "AppilotsClient", {
+  enumerable: true,
+  get: function () { return chunkT5TUFZ6T_js.AppilotsClient; }
+});
+Object.defineProperty(exports, "AppilotsWebRuntime", {
+  enumerable: true,
+  get: function () { return chunkT5TUFZ6T_js.AppilotsWebRuntime; }
+});
+Object.defineProperty(exports, "ChatSessionMachine", {
+  enumerable: true,
+  get: function () { return chunkT5TUFZ6T_js.ChatSessionMachine; }
+});
+Object.defineProperty(exports, "RateLimitedError", {
+  enumerable: true,
+  get: function () { return chunkT5TUFZ6T_js.RateLimitedError; }
+});
+Object.defineProperty(exports, "SDK_VERSION", {
+  enumerable: true,
+  get: function () { return chunkT5TUFZ6T_js.SDK_VERSION; }
+});
+Object.defineProperty(exports, "WebNavigationAdapter", {
+  enumerable: true,
+  get: function () { return chunkT5TUFZ6T_js.WebNavigationAdapter; }
+});
+Object.defineProperty(exports, "accessibleName", {
+  enumerable: true,
+  get: function () { return chunkT5TUFZ6T_js.accessibleName; }
+});
+Object.defineProperty(exports, "bestId", {
+  enumerable: true,
+  get: function () { return chunkT5TUFZ6T_js.bestId; }
+});
+Object.defineProperty(exports, "buildPath", {
+  enumerable: true,
+  get: function () { return chunkT5TUFZ6T_js.buildPath; }
+});
+Object.defineProperty(exports, "candidateIds", {
+  enumerable: true,
+  get: function () { return chunkT5TUFZ6T_js.candidateIds; }
+});
+Object.defineProperty(exports, "captureSnapshot", {
+  enumerable: true,
+  get: function () { return chunkT5TUFZ6T_js.captureSnapshot; }
+});
+Object.defineProperty(exports, "clickElement", {
+  enumerable: true,
+  get: function () { return chunkT5TUFZ6T_js.clickElement; }
+});
+Object.defineProperty(exports, "describeAction", {
+  enumerable: true,
+  get: function () { return chunkT5TUFZ6T_js.describeAction; }
+});
+Object.defineProperty(exports, "elementRole", {
+  enumerable: true,
+  get: function () { return chunkT5TUFZ6T_js.elementRole; }
+});
+Object.defineProperty(exports, "executeAction", {
+  enumerable: true,
+  get: function () { return chunkT5TUFZ6T_js.executeAction; }
+});
+Object.defineProperty(exports, "findListItemElements", {
+  enumerable: true,
+  get: function () { return chunkT5TUFZ6T_js.findListItemElements; }
+});
+Object.defineProperty(exports, "findScrollContainer", {
+  enumerable: true,
+  get: function () { return chunkT5TUFZ6T_js.findScrollContainer; }
+});
+Object.defineProperty(exports, "focusElement", {
+  enumerable: true,
+  get: function () { return chunkT5TUFZ6T_js.focusElement; }
+});
+Object.defineProperty(exports, "getRegisteredElement", {
+  enumerable: true,
+  get: function () { return chunkT5TUFZ6T_js.getRegisteredElement; }
+});
+Object.defineProperty(exports, "hidesSubtree", {
+  enumerable: true,
+  get: function () { return chunkT5TUFZ6T_js.hidesSubtree; }
+});
+Object.defineProperty(exports, "humanizeError", {
+  enumerable: true,
+  get: function () { return chunkT5TUFZ6T_js.humanizeError; }
+});
+Object.defineProperty(exports, "isOccludedByModal", {
+  enumerable: true,
+  get: function () { return chunkT5TUFZ6T_js.isOccludedByModal; }
+});
+Object.defineProperty(exports, "isVisible", {
+  enumerable: true,
+  get: function () { return chunkT5TUFZ6T_js.isVisible; }
+});
+Object.defineProperty(exports, "longPressElement", {
+  enumerable: true,
+  get: function () { return chunkT5TUFZ6T_js.longPressElement; }
+});
+Object.defineProperty(exports, "matchRoute", {
+  enumerable: true,
+  get: function () { return chunkT5TUFZ6T_js.matchRoute; }
+});
+Object.defineProperty(exports, "modalCandidateLabels", {
+  enumerable: true,
+  get: function () { return chunkT5TUFZ6T_js.modalCandidateLabels; }
+});
+Object.defineProperty(exports, "normalizeLabelToId", {
+  enumerable: true,
+  get: function () { return chunkT5TUFZ6T_js.normalizeLabelToId; }
+});
+Object.defineProperty(exports, "parseSyntheticListItemId", {
+  enumerable: true,
+  get: function () { return chunkT5TUFZ6T_js.parseSyntheticListItemId; }
+});
+Object.defineProperty(exports, "primaryControlOf", {
+  enumerable: true,
+  get: function () { return chunkT5TUFZ6T_js.primaryControlOf; }
+});
+Object.defineProperty(exports, "probeLoadingState", {
+  enumerable: true,
+  get: function () { return chunkT5TUFZ6T_js.probeLoadingState; }
+});
+Object.defineProperty(exports, "readControlValue", {
+  enumerable: true,
+  get: function () { return chunkT5TUFZ6T_js.readControlValue; }
+});
+Object.defineProperty(exports, "readOwnText", {
+  enumerable: true,
+  get: function () { return chunkT5TUFZ6T_js.readOwnText; }
+});
+Object.defineProperty(exports, "readScrollMetrics", {
+  enumerable: true,
+  get: function () { return chunkT5TUFZ6T_js.readScrollMetrics; }
+});
+Object.defineProperty(exports, "readToggleValue", {
+  enumerable: true,
+  get: function () { return chunkT5TUFZ6T_js.readToggleValue; }
+});
+Object.defineProperty(exports, "registeredElements", {
+  enumerable: true,
+  get: function () { return chunkT5TUFZ6T_js.registeredElements; }
+});
+Object.defineProperty(exports, "resolveListItem", {
+  enumerable: true,
+  get: function () { return chunkT5TUFZ6T_js.resolveListItem; }
+});
+Object.defineProperty(exports, "resolveTargetElement", {
+  enumerable: true,
+  get: function () { return chunkT5TUFZ6T_js.resolveTargetElement; }
+});
+Object.defineProperty(exports, "routesBelongToSameFeature", {
+  enumerable: true,
+  get: function () { return chunkT5TUFZ6T_js.routesBelongToSameFeature; }
+});
+Object.defineProperty(exports, "screenDepartedBaseline", {
+  enumerable: true,
+  get: function () { return chunkT5TUFZ6T_js.screenDepartedBaseline; }
+});
+Object.defineProperty(exports, "scrollIntoView", {
+  enumerable: true,
+  get: function () { return chunkT5TUFZ6T_js.scrollIntoView; }
+});
+Object.defineProperty(exports, "scrollToOffset", {
+  enumerable: true,
+  get: function () { return chunkT5TUFZ6T_js.scrollToOffset; }
+});
+Object.defineProperty(exports, "setControlValue", {
+  enumerable: true,
+  get: function () { return chunkT5TUFZ6T_js.setControlValue; }
+});
+Object.defineProperty(exports, "setToggleValue", {
+  enumerable: true,
+  get: function () { return chunkT5TUFZ6T_js.setToggleValue; }
+});
+Object.defineProperty(exports, "stripComponentPrefix", {
+  enumerable: true,
+  get: function () { return chunkT5TUFZ6T_js.stripComponentPrefix; }
+});
+Object.defineProperty(exports, "waitForLoadingSettle", {
+  enumerable: true,
+  get: function () { return chunkT5TUFZ6T_js.waitForLoadingSettle; }
+});
+Object.defineProperty(exports, "waitForScreenSettle", {
+  enumerable: true,
+  get: function () { return chunkT5TUFZ6T_js.waitForScreenSettle; }
+});
+Object.defineProperty(exports, "walkDom", {
+  enumerable: true,
+  get: function () { return chunkT5TUFZ6T_js.walkDom; }
+});

package/dist/index.mjs

@@ -0,0 +1 @@
+export { APPILOTS_CHAT_ATTR, APPILOTS_ID_ATTR, APPILOTS_ITEM_COUNT_ATTR, APPILOTS_ITEM_INDEX_ATTR, APPILOTS_ITEM_KEY_ATTR, APPILOTS_LIST_ID_ATTR, APPILOTS_LIST_ITEM_ATTR, APPILOTS_SENSITIVE_ATTR, APPILOTS_SKIP_ATTR, ActionQueueMachine, AppilotsClient, AppilotsWebRuntime, ChatSessionMachine, RateLimitedError, SDK_VERSION, WebNavigationAdapter, accessibleName, bestId, buildPath, candidateIds, captureSnapshot, clickElement, describeAction, elementRole, executeAction, findListItemElements, findScrollContainer, focusElement, getRegisteredElement, hidesSubtree, humanizeError, isOccludedByModal, isVisible, longPressElement, matchRoute, modalCandidateLabels, normalizeLabelToId, parseSyntheticListItemId, primaryControlOf, probeLoadingState, readControlValue, readOwnText, readScrollMetrics, readToggleValue, registeredElements, resolveListItem, resolveTargetElement, routesBelongToSameFeature, screenDepartedBaseline, scrollIntoView, scrollToOffset, setControlValue, setToggleValue, stripComponentPrefix, waitForLoadingSettle, waitForScreenSettle, walkDom } from './chunk-VHRE4RUO.mjs';

package/dist/react/index.d.mts

@@ -0,0 +1,84 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as react from 'react';
+import { ReactNode, CSSProperties } from 'react';
+import { k as AppilotsWebRuntimeOptions, j as AppilotsWebRuntime, A as AgentAction, l as ChatMessage, E as EscalationState, n as ChatSessionOptions } from '../AppilotsWebRuntime-DZF26UyU.mjs';
+export { t as WebScreenMetadata } from '../AppilotsWebRuntime-DZF26UyU.mjs';
+
+/**
+ * Either build the runtime from config, or hand in one you already
+ * built. Injecting a runtime must not require repeating its config, so
+ * `projectId` is only mandatory in the first form.
+ */
+type AppilotsWebProviderProps = (AppilotsWebRuntimeOptions & {
+    children: ReactNode;
+    runtime?: undefined;
+}) | (Partial<AppilotsWebRuntimeOptions> & {
+    children: ReactNode;
+    /** An already-built runtime (tests, or a non-React owner). */
+    runtime: AppilotsWebRuntime;
+});
+/**
+ * Provides an `AppilotsWebRuntime` to the tree. The runtime itself is
+ * framework-agnostic — this is only the plumbing that hands it to
+ * hooks and keeps its mutable configuration (routes, navigate,
+ * permissions) current across renders.
+ */
+declare function AppilotsWebProvider(props: AppilotsWebProviderProps): react_jsx_runtime.JSX.Element;
+declare function useAppilotsRuntime(): AppilotsWebRuntime;
+
+interface UseAppilotsChatReturn {
+    messages: ChatMessage[];
+    isLoading: boolean;
+    loadingStatusKey: 'thinking' | 'statusAnalyzing' | 'statusWaitingApp' | 'statusAdjusting';
+    error: string | null;
+    pendingActions: AgentAction[];
+    escalation: EscalationState | null;
+    requestHuman: (reason?: 'user_requested' | 'agent_gave_up') => Promise<void>;
+    sendMessage: (content: string) => Promise<void>;
+    cancelMessage: () => void;
+    clearMessages: () => void;
+    clearError: () => void;
+}
+/**
+ * React binding for the chat loop. Same surface as the React Native
+ * SDK's hook of the same name, because both are thin views over the
+ * same `ChatSessionMachine`.
+ */
+declare function useAppilotsChat(options?: ChatSessionOptions): UseAppilotsChatReturn;
+interface UseAppilotsActionsReturn {
+    pendingActions: AgentAction[];
+    executingActions: AgentAction[];
+    completedActions: AgentAction[];
+    approveAction: (actionId: string) => Promise<boolean>;
+    rejectAction: (actionId: string) => Promise<void>;
+}
+/**
+ * React binding for the action queue — the confirm cards a chat UI
+ * renders read their state from here.
+ */
+declare function useAppilotsActions(): UseAppilotsActionsReturn;
+
+interface AppilotsChatProps {
+    title?: string;
+    placeholder?: string;
+    locale?: 'en' | 'pt-BR';
+    /** Empty-state prompts prefill the composer; sending remains a user action. */
+    suggestedPrompts?: string[];
+    style?: CSSProperties;
+    /** Optional close control for a host-provided panel. */
+    onClose?: () => void;
+}
+/** Chat controls use the same session and human-support channel as the mobile SDK. */
+declare function AppilotsChat({ title, placeholder, locale, suggestedPrompts, style, onClose, }: AppilotsChatProps): react_jsx_runtime.JSX.Element;
+
+interface AppilotsChatFabProps extends Omit<AppilotsChatProps, 'onClose'> {
+    position?: 'bottom-right' | 'bottom-left';
+    defaultOpen?: boolean;
+    accentColor?: string;
+    /** Place the widget below the host app's blocking dialogs. Defaults to 1000. */
+    zIndex?: number;
+}
+/** Floating launcher and chat panel. Closing only hides the UI; the session stays alive. */
+declare function AppilotsChatFab({ position, defaultOpen, accentColor, zIndex, locale, style, ...chatProps }: AppilotsChatFabProps): react.ReactPortal | null;
+
+export { AppilotsChat, AppilotsChatFab, type AppilotsChatFabProps, type AppilotsChatProps, AppilotsWebProvider, type AppilotsWebProviderProps, AppilotsWebRuntime, AppilotsWebRuntimeOptions, type UseAppilotsActionsReturn, type UseAppilotsChatReturn, useAppilotsActions, useAppilotsChat, useAppilotsRuntime };

package/dist/react/index.d.ts

@@ -0,0 +1,84 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as react from 'react';
+import { ReactNode, CSSProperties } from 'react';
+import { k as AppilotsWebRuntimeOptions, j as AppilotsWebRuntime, A as AgentAction, l as ChatMessage, E as EscalationState, n as ChatSessionOptions } from '../AppilotsWebRuntime-DZF26UyU.js';
+export { t as WebScreenMetadata } from '../AppilotsWebRuntime-DZF26UyU.js';
+
+/**
+ * Either build the runtime from config, or hand in one you already
+ * built. Injecting a runtime must not require repeating its config, so
+ * `projectId` is only mandatory in the first form.
+ */
+type AppilotsWebProviderProps = (AppilotsWebRuntimeOptions & {
+    children: ReactNode;
+    runtime?: undefined;
+}) | (Partial<AppilotsWebRuntimeOptions> & {
+    children: ReactNode;
+    /** An already-built runtime (tests, or a non-React owner). */
+    runtime: AppilotsWebRuntime;
+});
+/**
+ * Provides an `AppilotsWebRuntime` to the tree. The runtime itself is
+ * framework-agnostic — this is only the plumbing that hands it to
+ * hooks and keeps its mutable configuration (routes, navigate,
+ * permissions) current across renders.
+ */
+declare function AppilotsWebProvider(props: AppilotsWebProviderProps): react_jsx_runtime.JSX.Element;
+declare function useAppilotsRuntime(): AppilotsWebRuntime;
+
+interface UseAppilotsChatReturn {
+    messages: ChatMessage[];
+    isLoading: boolean;
+    loadingStatusKey: 'thinking' | 'statusAnalyzing' | 'statusWaitingApp' | 'statusAdjusting';
+    error: string | null;
+    pendingActions: AgentAction[];
+    escalation: EscalationState | null;
+    requestHuman: (reason?: 'user_requested' | 'agent_gave_up') => Promise<void>;
+    sendMessage: (content: string) => Promise<void>;
+    cancelMessage: () => void;
+    clearMessages: () => void;
+    clearError: () => void;
+}
+/**
+ * React binding for the chat loop. Same surface as the React Native
+ * SDK's hook of the same name, because both are thin views over the
+ * same `ChatSessionMachine`.
+ */
+declare function useAppilotsChat(options?: ChatSessionOptions): UseAppilotsChatReturn;
+interface UseAppilotsActionsReturn {
+    pendingActions: AgentAction[];
+    executingActions: AgentAction[];
+    completedActions: AgentAction[];
+    approveAction: (actionId: string) => Promise<boolean>;
+    rejectAction: (actionId: string) => Promise<void>;
+}
+/**
+ * React binding for the action queue — the confirm cards a chat UI
+ * renders read their state from here.
+ */
+declare function useAppilotsActions(): UseAppilotsActionsReturn;
+
+interface AppilotsChatProps {
+    title?: string;
+    placeholder?: string;
+    locale?: 'en' | 'pt-BR';
+    /** Empty-state prompts prefill the composer; sending remains a user action. */
+    suggestedPrompts?: string[];
+    style?: CSSProperties;
+    /** Optional close control for a host-provided panel. */
+    onClose?: () => void;
+}
+/** Chat controls use the same session and human-support channel as the mobile SDK. */
+declare function AppilotsChat({ title, placeholder, locale, suggestedPrompts, style, onClose, }: AppilotsChatProps): react_jsx_runtime.JSX.Element;
+
+interface AppilotsChatFabProps extends Omit<AppilotsChatProps, 'onClose'> {
+    position?: 'bottom-right' | 'bottom-left';
+    defaultOpen?: boolean;
+    accentColor?: string;
+    /** Place the widget below the host app's blocking dialogs. Defaults to 1000. */
+    zIndex?: number;
+}
+/** Floating launcher and chat panel. Closing only hides the UI; the session stays alive. */
+declare function AppilotsChatFab({ position, defaultOpen, accentColor, zIndex, locale, style, ...chatProps }: AppilotsChatFabProps): react.ReactPortal | null;
+
+export { AppilotsChat, AppilotsChatFab, type AppilotsChatFabProps, type AppilotsChatProps, AppilotsWebProvider, type AppilotsWebProviderProps, AppilotsWebRuntime, AppilotsWebRuntimeOptions, type UseAppilotsActionsReturn, type UseAppilotsChatReturn, useAppilotsActions, useAppilotsChat, useAppilotsRuntime };