@supernal/interface 1.0.0

package/dist/esm/src/types/Tool.js

@@ -0,0 +1,38 @@
+/**
+ * Tool Interface
+ *
+ * This interface defines the structure for callable tools that can be used by LLMs.
+ * Tools are exposed by ToolProviders and follow industry standards for compatibility
+ * with OpenAI, Anthropic, and LangChain.
+ */
+/**
+ * Category of tool functionality
+ */
+export var ToolCategory;
+(function (ToolCategory) {
+    // Original categories
+    ToolCategory["CONTENT_CREATION"] = "content_creation";
+    ToolCategory["CONTENT_RETRIEVAL"] = "content_retrieval";
+    ToolCategory["DATA_MANIPULATION"] = "data_manipulation";
+    ToolCategory["EXTERNAL_SERVICE"] = "external_service";
+    ToolCategory["SYSTEM"] = "system";
+    ToolCategory["USER_INTERACTION"] = "user_interaction";
+    // Extended categories from ClassifiedTool
+    ToolCategory["MEMORY"] = "memory";
+    ToolCategory["DATA"] = "data";
+    ToolCategory["SEARCH"] = "search";
+    ToolCategory["UTILITY"] = "utility";
+    ToolCategory["TIME"] = "time";
+    ToolCategory["DOM"] = "dom";
+    ToolCategory["API"] = "api";
+    ToolCategory["FILE"] = "file";
+    ToolCategory["COMMUNICATION"] = "communication";
+    ToolCategory["CONTEXT_APP"] = "context-app";
+    ToolCategory["WORKFLOW"] = "workflow";
+    // New categories for specialized tools
+    ToolCategory["CHAT"] = "chat";
+    ToolCategory["SETTINGS"] = "settings";
+    ToolCategory["NAVIGATION"] = "navigation";
+    ToolCategory["ONBOARDING"] = "onboarding";
+})(ToolCategory || (ToolCategory = {}));
+//# sourceMappingURL=Tool.js.map

package/dist/esm/src/types/Tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tool.js","sourceRoot":"","sources":["../../../../src/types/Tool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;GAEG;AACH,MAAM,CAAN,IAAY,YA2BX;AA3BD,WAAY,YAAY;IACtB,sBAAsB;IACtB,qDAAqC,CAAA;IACrC,uDAAuC,CAAA;IACvC,uDAAuC,CAAA;IACvC,qDAAqC,CAAA;IACrC,iCAAiB,CAAA;IACjB,qDAAqC,CAAA;IAErC,0CAA0C;IAC1C,iCAAiB,CAAA;IACjB,6BAAa,CAAA;IACb,iCAAiB,CAAA;IACjB,mCAAmB,CAAA;IACnB,6BAAa,CAAA;IACb,2BAAW,CAAA;IACX,2BAAW,CAAA;IACX,6BAAa,CAAA;IACb,+CAA+B,CAAA;IAC/B,2CAA2B,CAAA;IAC3B,qCAAqB,CAAA;IAErB,uCAAuC;IACvC,6BAAa,CAAA;IACb,qCAAqB,CAAA;IACrB,yCAAyB,CAAA;IACzB,yCAAyB,CAAA;AAC3B,CAAC,EA3BW,YAAY,KAAZ,YAAY,QA2BvB"}

package/dist/esm/src/types/ToolPermissions.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Tool Permissions Interface
+ *
+ * This interface defines the permission model for tools that can be called by LLMs.
+ * It follows a standardized approach to tool access control and security.
+ */
+/**
+ * Permission level for tool execution
+ */
+export declare enum ToolPermissionLevel {
+    /**
+     * User must approve each tool execution
+     */
+    ALWAYS_REQUIRE_APPROVAL = "always_require_approval",
+    /**
+     * User approves once, then allowed for session
+     */
+    APPROVE_ONCE = "approve_once",
+    /**
+     * Automatically approved for non-sensitive tools
+     */
+    AUTO_APPROVE = "auto_approve",
+    /**
+     * Can only be called by system components, not LLMs
+     */
+    SYSTEM_ONLY = "system_only"
+}
+/**
+ * Permission scope for tools
+ */
+export declare enum ToolPermissionScope {
+    DATA_READ = "data:read",
+    DATA_WRITE = "data:write",
+    DATA_DELETE = "data:delete",
+    CONTENT_READ = "content:read",
+    CONTENT_WRITE = "content:write",
+    CONTENT_DELETE = "content:delete",
+    EXTERNAL_SERVICE = "external:service",
+    NETWORK_ACCESS = "network:access",
+    USER_INTERACTION = "user:interaction",
+    USER_NOTIFICATION = "user:notification",
+    SYSTEM_ACCESS = "system:access"
+}
+/**
+ * Permission model for a tool
+ */
+export interface ToolPermissions {
+    /**
+     * Permission level required for the tool
+     */
+    level: ToolPermissionLevel;
+    /**
+     * Required permission scopes
+     */
+    requiredScopes: string[];
+    /**
+     * Whether the tool accesses sensitive data
+     */
+    sensitiveDataAccess: boolean;
+    /**
+     * Whether permanent storage changes are made
+     */
+    persistentChanges?: boolean;
+    /**
+     * Whether the tool can access network resources
+     */
+    networkAccess?: boolean;
+    /**
+     * Custom permission validator function (defined at runtime)
+     */
+    customValidator?: boolean;
+}
+//# sourceMappingURL=ToolPermissions.d.ts.map

package/dist/esm/src/types/ToolPermissions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolPermissions.d.ts","sourceRoot":"","sources":["../../../../src/types/ToolPermissions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,oBAAY,mBAAmB;IAC7B;;OAEG;IACH,uBAAuB,4BAA4B;IAEnD;;OAEG;IACH,YAAY,iBAAiB;IAE7B;;OAEG;IACH,YAAY,iBAAiB;IAE7B;;OAEG;IACH,WAAW,gBAAgB;CAC5B;AAED;;GAEG;AACH,oBAAY,mBAAmB;IAE7B,SAAS,cAAc;IACvB,UAAU,eAAe;IACzB,WAAW,gBAAgB;IAG3B,YAAY,iBAAiB;IAC7B,aAAa,kBAAkB;IAC/B,cAAc,mBAAmB;IAGjC,gBAAgB,qBAAqB;IACrC,cAAc,mBAAmB;IAGjC,gBAAgB,qBAAqB;IACrC,iBAAiB,sBAAsB;IAGvC,aAAa,kBAAkB;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,KAAK,EAAE,mBAAmB,CAAC;IAE3B;;OAEG;IACH,cAAc,EAAE,MAAM,EAAE,CAAC;IAEzB;;OAEG;IACH,mBAAmB,EAAE,OAAO,CAAC;IAE7B;;OAEG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B;;OAEG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;OAEG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B"}

package/dist/esm/src/types/ToolPermissions.js

@@ -0,0 +1,51 @@
+/**
+ * Tool Permissions Interface
+ *
+ * This interface defines the permission model for tools that can be called by LLMs.
+ * It follows a standardized approach to tool access control and security.
+ */
+/**
+ * Permission level for tool execution
+ */
+export var ToolPermissionLevel;
+(function (ToolPermissionLevel) {
+    /**
+     * User must approve each tool execution
+     */
+    ToolPermissionLevel["ALWAYS_REQUIRE_APPROVAL"] = "always_require_approval";
+    /**
+     * User approves once, then allowed for session
+     */
+    ToolPermissionLevel["APPROVE_ONCE"] = "approve_once";
+    /**
+     * Automatically approved for non-sensitive tools
+     */
+    ToolPermissionLevel["AUTO_APPROVE"] = "auto_approve";
+    /**
+     * Can only be called by system components, not LLMs
+     */
+    ToolPermissionLevel["SYSTEM_ONLY"] = "system_only";
+})(ToolPermissionLevel || (ToolPermissionLevel = {}));
+/**
+ * Permission scope for tools
+ */
+export var ToolPermissionScope;
+(function (ToolPermissionScope) {
+    // Data access scopes
+    ToolPermissionScope["DATA_READ"] = "data:read";
+    ToolPermissionScope["DATA_WRITE"] = "data:write";
+    ToolPermissionScope["DATA_DELETE"] = "data:delete";
+    // Content scopes
+    ToolPermissionScope["CONTENT_READ"] = "content:read";
+    ToolPermissionScope["CONTENT_WRITE"] = "content:write";
+    ToolPermissionScope["CONTENT_DELETE"] = "content:delete";
+    // External service scopes
+    ToolPermissionScope["EXTERNAL_SERVICE"] = "external:service";
+    ToolPermissionScope["NETWORK_ACCESS"] = "network:access";
+    // User interaction scopes
+    ToolPermissionScope["USER_INTERACTION"] = "user:interaction";
+    ToolPermissionScope["USER_NOTIFICATION"] = "user:notification";
+    // System scopes
+    ToolPermissionScope["SYSTEM_ACCESS"] = "system:access";
+})(ToolPermissionScope || (ToolPermissionScope = {}));
+//# sourceMappingURL=ToolPermissions.js.map

package/dist/esm/src/types/ToolPermissions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolPermissions.js","sourceRoot":"","sources":["../../../../src/types/ToolPermissions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,CAAN,IAAY,mBAoBX;AApBD,WAAY,mBAAmB;IAC7B;;OAEG;IACH,0EAAmD,CAAA;IAEnD;;OAEG;IACH,oDAA6B,CAAA;IAE7B;;OAEG;IACH,oDAA6B,CAAA;IAE7B;;OAEG;IACH,kDAA2B,CAAA;AAC7B,CAAC,EApBW,mBAAmB,KAAnB,mBAAmB,QAoB9B;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,mBAqBX;AArBD,WAAY,mBAAmB;IAC7B,qBAAqB;IACrB,8CAAuB,CAAA;IACvB,gDAAyB,CAAA;IACzB,kDAA2B,CAAA;IAE3B,iBAAiB;IACjB,oDAA6B,CAAA;IAC7B,sDAA+B,CAAA;IAC/B,wDAAiC,CAAA;IAEjC,0BAA0B;IAC1B,4DAAqC,CAAA;IACrC,wDAAiC,CAAA;IAEjC,0BAA0B;IAC1B,4DAAqC,CAAA;IACrC,8DAAuC,CAAA;IAEvC,gBAAgB;IAChB,sDAA+B,CAAA;AACjC,CAAC,EArBW,mBAAmB,KAAnB,mBAAmB,QAqB9B"}

package/dist/esm/src/types/ToolResult.d.ts

@@ -0,0 +1,129 @@
+/**
+ * Tool Result Interface
+ *
+ * This interface defines the structure for results returned from tool executions.
+ * It is designed to be compatible with various LLM providers while maintaining
+ * a standardized structure across our platform.
+ */
+/**
+ * Status of a tool execution
+ */
+export declare enum ToolExecutionStatus {
+    SUCCESS = "success",
+    ERROR = "error",
+    PARTIAL = "partial",
+    CANCELLED = "cancelled",
+    TIMEOUT = "timeout",
+    PERMISSION_DENIED = "permission_denied",
+    PENDING = "pending",
+    RUNNING = "running"
+}
+/**
+ * Record of a tool call execution, used for tracking and displaying tool usage
+ */
+export interface ToolCallRecord {
+    /**
+     * Unique identifier for this tool call
+     */
+    id: string;
+    /**
+     * ID of the tool that was called
+     */
+    toolId: string;
+    /**
+     * Name of the tool for display purposes
+     */
+    toolName: string;
+    /**
+     * Input parameters provided to the tool
+     */
+    input: any;
+    /**
+     * Output returned by the tool execution
+     */
+    output: any | null;
+    /**
+     * Current status of the tool execution
+     */
+    status: ToolExecutionStatus;
+    /**
+     * Timestamp when the execution was initiated
+     */
+    timestamp: number;
+    /**
+     * Error message if the execution failed
+     */
+    error?: string;
+}
+/**
+ * Basic tool result interface
+ */
+export interface ToolResult {
+    /**
+     * Whether the operation was successful
+     */
+    success: boolean;
+    /**
+     * Output data from the tool execution
+     * This can be any valid JSON data, depending on the tool
+     */
+    output?: any;
+    /**
+     * Error message if the operation failed
+     */
+    error?: string;
+    /**
+     * Error code if applicable
+     */
+    errorCode?: string;
+    /**
+     * Detailed status of the execution
+     */
+    status?: ToolExecutionStatus;
+    /**
+     * Timestamp when the tool execution completed
+     */
+    timestamp?: number;
+    /**
+     * Time taken to execute the tool in milliseconds
+     */
+    executionTime?: number;
+    /**
+     * Whether the result should be cached
+     */
+    cacheable?: boolean;
+    /**
+     * Tool's declared return format (markdown or json)
+     */
+    returnType?: 'markdown' | 'json';
+}
+/**
+ * Extended tool result with provider-specific fields
+ */
+export interface EnhancedToolResult extends ToolResult {
+    /**
+     * Additional metadata about the execution
+     */
+    metadata?: Record<string, any>;
+    /**
+     * References to any resources created or modified
+     */
+    references?: string[];
+    /**
+     * Permissions that were used during execution
+     */
+    usedPermissions?: string[];
+    /**
+     * Whether the user was prompted for permission
+     */
+    userPrompted?: boolean;
+    /**
+     * Whether the result has been truncated
+     */
+    truncated?: boolean;
+    /**
+     * Suggestions for follow-up actions
+     */
+    suggestions?: string[];
+}
+//# sourceMappingURL=ToolResult.d.ts.map

package/dist/esm/src/types/ToolResult.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolResult.d.ts","sourceRoot":"","sources":["../../../../src/types/ToolResult.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,oBAAY,mBAAmB;IAC7B,OAAO,YAAY;IACnB,KAAK,UAAU;IACf,OAAO,YAAY;IACnB,SAAS,cAAc;IACvB,OAAO,YAAY;IACnB,iBAAiB,sBAAsB;IACvC,OAAO,YAAY;IACnB,OAAO,YAAY;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,KAAK,EAAE,GAAG,CAAC;IAEX;;OAEG;IACH,MAAM,EAAE,GAAG,GAAG,IAAI,CAAC;IAEnB;;OAEG;IACH,MAAM,EAAE,mBAAmB,CAAC;IAE5B;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;;OAGG;IACH,MAAM,CAAC,EAAE,GAAG,CAAC;IAEb;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAE7B;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;OAEG;IACH,UAAU,CAAC,EAAE,UAAU,GAAG,MAAM,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,UAAU;IACpD;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE/B;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAEtB;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAE3B;;OAEG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB"}

package/dist/esm/src/types/ToolResult.js

@@ -0,0 +1,22 @@
+/**
+ * Tool Result Interface
+ *
+ * This interface defines the structure for results returned from tool executions.
+ * It is designed to be compatible with various LLM providers while maintaining
+ * a standardized structure across our platform.
+ */
+/**
+ * Status of a tool execution
+ */
+export var ToolExecutionStatus;
+(function (ToolExecutionStatus) {
+    ToolExecutionStatus["SUCCESS"] = "success";
+    ToolExecutionStatus["ERROR"] = "error";
+    ToolExecutionStatus["PARTIAL"] = "partial";
+    ToolExecutionStatus["CANCELLED"] = "cancelled";
+    ToolExecutionStatus["TIMEOUT"] = "timeout";
+    ToolExecutionStatus["PERMISSION_DENIED"] = "permission_denied";
+    ToolExecutionStatus["PENDING"] = "pending";
+    ToolExecutionStatus["RUNNING"] = "running";
+})(ToolExecutionStatus || (ToolExecutionStatus = {}));
+//# sourceMappingURL=ToolResult.js.map

package/dist/esm/src/types/ToolResult.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolResult.js","sourceRoot":"","sources":["../../../../src/types/ToolResult.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,CAAN,IAAY,mBASX;AATD,WAAY,mBAAmB;IAC7B,0CAAmB,CAAA;IACnB,sCAAe,CAAA;IACf,0CAAmB,CAAA;IACnB,8CAAuB,CAAA;IACvB,0CAAmB,CAAA;IACnB,8DAAuC,CAAA;IACvC,0CAAmB,CAAA;IACnB,0CAAmB,CAAA;AACrB,CAAC,EATW,mBAAmB,KAAnB,mBAAmB,QAS9B"}

package/dist/esm/src/types/index.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Tools Types - Index File
+ *
+ * This is the main entry point for all tool-related types.
+ * It re-exports all tool types from their specialized modules.
+ */
+export * from './Tool';
+export * from './ToolPermissions';
+export * from './ToolResult';
+export * from './ExposureState';
+export * from './NavigationGraph';
+export * from './ClassifiedTool';
+export * from './DiscoverableToolProvider';
+export * from './StateManagers';
+export * from './OperationType';
+export * from './ComponentState';
+export interface ComponentInfo {
+    constantName: string;
+    testId: string;
+    elementType: ElementType;
+    actionType: ActionType;
+    methodName: string;
+    confidence: number;
+    source: string;
+}
+export declare enum ElementType {
+    BUTTON = "button",
+    INPUT = "input",
+    SELECT = "select",
+    TEXTAREA = "textarea",
+    LINK = "link",
+    DIV = "div"
+}
+export declare enum ActionType {
+    CLICK = "click",
+    TYPE = "type",
+    SELECT = "select",
+    NAVIGATE = "navigate",
+    HOVER = "hover",
+    SCROLL = "scroll"
+}
+/**
+ * Tools Types
+ *
+ * Export of all tool-related types, interfaces and constants
+ */
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/src/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,cAAc,QAAQ,CAAC;AACvB,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,4BAA4B,CAAC;AAG3C,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AAGjC,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,WAAW,CAAC;IACzB,UAAU,EAAE,UAAU,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,oBAAY,WAAW;IACrB,MAAM,WAAW;IACjB,KAAK,UAAU;IACf,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,IAAI,SAAS;IACb,GAAG,QAAQ;CACZ;AAED,oBAAY,UAAU;IACpB,KAAK,UAAU;IACf,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,KAAK,UAAU;IACf,MAAM,WAAW;CAClB;AAED;;;;GAIG"}

package/dist/esm/src/types/index.js

@@ -0,0 +1,42 @@
+/**
+ * Tools Types - Index File
+ *
+ * This is the main entry point for all tool-related types.
+ * It re-exports all tool types from their specialized modules.
+ */
+// Export tool types
+export * from './Tool.js';
+export * from './ToolPermissions.js';
+export * from './ToolResult.js';
+export * from './ExposureState.js';
+export * from './NavigationGraph.js';
+export * from './ClassifiedTool.js';
+export * from './DiscoverableToolProvider.js';
+// Export state system types
+export * from './StateManagers.js';
+export * from './OperationType.js';
+export * from './ComponentState.js';
+export var ElementType;
+(function (ElementType) {
+    ElementType["BUTTON"] = "button";
+    ElementType["INPUT"] = "input";
+    ElementType["SELECT"] = "select";
+    ElementType["TEXTAREA"] = "textarea";
+    ElementType["LINK"] = "link";
+    ElementType["DIV"] = "div";
+})(ElementType || (ElementType = {}));
+export var ActionType;
+(function (ActionType) {
+    ActionType["CLICK"] = "click";
+    ActionType["TYPE"] = "type";
+    ActionType["SELECT"] = "select";
+    ActionType["NAVIGATE"] = "navigate";
+    ActionType["HOVER"] = "hover";
+    ActionType["SCROLL"] = "scroll";
+})(ActionType || (ActionType = {}));
+/**
+ * Tools Types
+ *
+ * Export of all tool-related types, interfaces and constants
+ */
+//# sourceMappingURL=index.js.map

package/dist/esm/src/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,oBAAoB;AACpB,cAAc,QAAQ,CAAC;AACvB,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,4BAA4B,CAAC;AAE3C,4BAA4B;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AAajC,MAAM,CAAN,IAAY,WAOX;AAPD,WAAY,WAAW;IACrB,gCAAiB,CAAA;IACjB,8BAAe,CAAA;IACf,gCAAiB,CAAA;IACjB,oCAAqB,CAAA;IACrB,4BAAa,CAAA;IACb,0BAAW,CAAA;AACb,CAAC,EAPW,WAAW,KAAX,WAAW,QAOtB;AAED,MAAM,CAAN,IAAY,UAOX;AAPD,WAAY,UAAU;IACpB,6BAAe,CAAA;IACf,2BAAa,CAAA;IACb,+BAAiB,CAAA;IACjB,mCAAqB,CAAA;IACrB,6BAAe,CAAA;IACf,+BAAiB,CAAA;AACnB,CAAC,EAPW,UAAU,KAAV,UAAU,QAOrB;AAED;;;;GAIG"}

package/dist/esm/src/ui/react/chat/ChatBubble.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Persistent Chat Bubble Component
+ *
+ * Fixed position chat bubble in lower right corner that:
+ * - Appears on every page
+ * - Expands/collapses without blocking content
+ * - Provides AI interface for tool execution
+ */
+import React from 'react';
+interface Message {
+    id: string;
+    text: string;
+    type: 'user' | 'ai' | 'system';
+    timestamp: string;
+}
+interface ChatBubbleProps {
+    messages: Message[];
+    onSendMessage: (message: string) => void;
+    onClearChat?: () => void;
+}
+export declare const ChatBubble: React.FC<ChatBubbleProps>;
+export {};
+//# sourceMappingURL=ChatBubble.d.ts.map

package/dist/esm/src/ui/react/chat/ChatBubble.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatBubble.d.ts","sourceRoot":"","sources":["../../../../../../src/ui/react/chat/ChatBubble.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAsC,MAAM,OAAO,CAAC;AAgB3D,UAAU,OAAO;IACf,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,QAAQ,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,eAAe;IACvB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;CAC1B;AAID,eAAO,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CA0RhD,CAAC"}

package/dist/esm/src/ui/react/chat/ChatBubble.js

@@ -0,0 +1,184 @@
+/**
+ * Persistent Chat Bubble Component
+ *
+ * Fixed position chat bubble in lower right corner that:
+ * - Appears on every page
+ * - Expands/collapses without blocking content
+ * - Provides AI interface for tool execution
+ */
+import React, { useState, useRef, useEffect } from 'react';
+import { Components } from '../../../../names/Components.js';
+// Chat component names (use the flat Components namespace)
+const ChatNames = {
+    bubble: Components.ChatToggleButton,
+    input: Components.ChatInput,
+    sendButton: Components.ChatSendButton,
+    clearButton: Components.ChatClearButton,
+};
+// Mock useChatInput for now - this should be injected via props or context
+const useChatInput = () => ({
+    registerInput: (callback) => { }
+});
+const CHAT_EXPANDED_KEY = 'supernal-chat-expanded';
+export const ChatBubble = ({ messages, onSendMessage, onClearChat }) => {
+    // Initialize with default value (true) for both server and client to prevent hydration mismatch
+    const [isExpanded, setIsExpanded] = useState(true);
+    const [inputValue, setInputValue] = useState('');
+    const [lastReadMessageCount, setLastReadMessageCount] = useState(0);
+    const [showWelcome, setShowWelcome] = useState(messages.length === 0);
+    const messagesEndRef = useRef(null);
+    const inputRef = useRef(null);
+    // Load expanded state from localStorage after hydration
+    useEffect(() => {
+        try {
+            const stored = localStorage.getItem(CHAT_EXPANDED_KEY);
+            if (stored !== null) {
+                setIsExpanded(JSON.parse(stored));
+            }
+        }
+        catch {
+            // Keep default value
+        }
+    }, []);
+    // Register with chat input context
+    const { registerInput } = useChatInput();
+    useEffect(() => {
+        registerInput((text, submit = false) => {
+            setInputValue(text);
+            if (!isExpanded) {
+                setIsExpanded(true);
+            }
+            // Auto-focus and submit if requested
+            setTimeout(() => {
+                inputRef.current?.focus();
+                if (submit) {
+                    onSendMessage(text);
+                    setInputValue('');
+                }
+            }, 100);
+        });
+    }, [registerInput, onSendMessage, isExpanded]);
+    // Track unread messages
+    const unreadCount = Math.max(0, messages.length - lastReadMessageCount);
+    const hasUnread = unreadCount > 0 && !isExpanded;
+    useEffect(() => {
+        if (isExpanded) {
+            // Position at bottom without scrolling animation
+            messagesEndRef.current?.scrollIntoView({ behavior: 'auto' });
+            // Mark all messages as read when chat is expanded
+            setLastReadMessageCount(messages.length);
+            // Hide welcome if messages exist
+            if (messages.length > 0) {
+                setShowWelcome(false);
+            }
+            // Auto-focus input when expanded
+            inputRef.current?.focus();
+        }
+    }, [messages, isExpanded]);
+    // Auto-focus on mount
+    useEffect(() => {
+        if (isExpanded) {
+            inputRef.current?.focus();
+        }
+    }, [isExpanded]);
+    // Command+/ keyboard shortcut to focus input
+    useEffect(() => {
+        const handleKeyDown = (e) => {
+            if ((e.metaKey || e.ctrlKey) && e.key === '/') {
+                e.preventDefault();
+                if (!isExpanded) {
+                    setIsExpanded(true);
+                }
+                inputRef.current?.focus();
+            }
+        };
+        window.addEventListener('keydown', handleKeyDown);
+        return () => window.removeEventListener('keydown', handleKeyDown);
+    }, [isExpanded]);
+    const handleSend = (e) => {
+        e.preventDefault();
+        if (!inputValue.trim())
+            return;
+        onSendMessage(inputValue.trim());
+        setInputValue('');
+        // Re-focus input after sending
+        setTimeout(() => inputRef.current?.focus(), 0);
+    };
+    const handleToggle = () => {
+        const newExpandedState = !isExpanded;
+        setIsExpanded(newExpandedState);
+        // Persist the expanded state to localStorage
+        try {
+            localStorage.setItem(CHAT_EXPANDED_KEY, JSON.stringify(newExpandedState));
+        }
+        catch (error) {
+            console.error('Failed to save chat expanded state:', error);
+        }
+    };
+    return (React.createElement(React.Fragment, null,
+        React.createElement("div", { className: "fixed bottom-4 right-4 sm:bottom-6 sm:right-6 z-50" },
+            isExpanded && (React.createElement("div", { className: "absolute bottom-16 right-0 w-[calc(100vw-2rem)] sm:w-[500px] lg:w-[600px] h-[calc(100vh-10rem)] sm:h-[600px] lg:h-[700px] bg-white rounded-lg shadow-2xl border border-gray-200 flex flex-col" },
+                React.createElement("div", { className: "flex items-center justify-between p-3 sm:p-4 border-b border-gray-200 bg-gradient-to-r from-blue-50 to-purple-50 rounded-t-lg" },
+                    React.createElement("div", { className: "flex items-center space-x-2 sm:space-x-3" },
+                        React.createElement("div", { className: "relative" },
+                            React.createElement("div", { className: "w-8 h-8 sm:w-10 sm:h-10 bg-gradient-to-br from-blue-500 to-purple-600 rounded-full flex items-center justify-center" },
+                                React.createElement("span", { className: "text-white text-base sm:text-lg" }, "\uD83E\uDD16")),
+                            React.createElement("div", { className: "absolute -bottom-1 -right-1 w-3 h-3 sm:w-4 sm:h-4 bg-green-500 rounded-full border-2 border-white" })),
+                        React.createElement("div", null,
+                            React.createElement("h3", { className: "font-bold text-gray-900 text-sm sm:text-base" }, "Supernal AI Interface"),
+                            React.createElement("p", { className: "text-xs text-gray-600 hidden sm:block" }, "I'm a TOOL system AI can use to control this site"))),
+                    React.createElement("div", { className: "flex items-center space-x-1" },
+                        onClearChat && (React.createElement("button", { onClick: onClearChat, className: "p-1 text-gray-400 hover:text-gray-600 transition-colors", title: "Clear chat", "data-testid": ChatNames.clearButton },
+                            React.createElement("svg", { className: "w-4 h-4", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24" },
+                                React.createElement("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M19 7l-.867 12.142A2 2 0 0116.138 21H7.862a2 2 0 01-1.995-1.858L5 7m5 4v6m4-6v6m1-10V4a1 1 0 00-1-1h-4a1 1 0 00-1 1v3M4 7h16" })))),
+                        React.createElement("button", { onClick: handleToggle, className: "p-1 text-gray-400 hover:text-gray-600 transition-colors", title: "Minimize chat" },
+                            React.createElement("svg", { className: "w-4 h-4", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24" },
+                                React.createElement("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M19 9l-7 7-7-7" }))))),
+                React.createElement("div", { className: "flex-1 overflow-y-auto p-3 sm:p-4 space-y-3" },
+                    showWelcome && messages.length === 0 && (React.createElement("div", { className: "bg-gradient-to-br from-blue-50 to-purple-50 p-3 sm:p-4 rounded-lg border border-blue-200 mb-4" },
+                        React.createElement("h4", { className: "font-bold text-gray-900 mb-2 text-xs sm:text-sm" }, "\uD83D\uDC4B Welcome! I'm NOT an AI"),
+                        React.createElement("p", { className: "text-xs text-gray-700 mb-3" },
+                            "I'm a ",
+                            React.createElement("strong", null, "tool system"),
+                            " that AI assistants (like Claude, GPT) can use to navigate and control this site. This enables ",
+                            React.createElement("strong", null, "agentic UX"),
+                            " \u2014 instead of clicking around, you tell an AI what you want, and it uses me to do it."),
+                        React.createElement("div", { className: "bg-white p-2 sm:p-3 rounded border border-gray-200 mb-3" },
+                            React.createElement("p", { className: "text-xs font-medium text-gray-900 mb-2" }, "Try these commands:"),
+                            React.createElement("div", { className: "space-y-1" }, [
+                                { text: 'open the docs', desc: 'Navigate to documentation' },
+                                { text: 'show me the story system', desc: 'View story system guide' },
+                                { text: 'go to examples', desc: 'Browse code examples' },
+                            ].map((cmd, idx) => (React.createElement("button", { key: idx, onClick: () => {
+                                    setInputValue(cmd.text);
+                                    setShowWelcome(false);
+                                    setTimeout(() => inputRef.current?.focus(), 0);
+                                }, className: "w-full text-left px-2 py-1.5 rounded hover:bg-blue-50 transition-colors group" },
+                                React.createElement("div", { className: "text-xs font-mono text-blue-700 group-hover:text-blue-900" },
+                                    "\"",
+                                    cmd.text,
+                                    "\""),
+                                React.createElement("div", { className: "text-xs text-gray-500 hidden sm:block" }, cmd.desc)))))),
+                        React.createElement("p", { className: "text-xs text-gray-600 italic" }, "Type a command or click a suggestion above to start"))),
+                    messages.map((message) => (React.createElement("div", { key: message.id, className: "flex flex-col" },
+                        React.createElement("div", { className: `inline-block px-3 py-2 rounded-lg max-w-[85%] sm:max-w-xs text-xs sm:text-sm ${message.type === 'user'
+                                ? 'bg-blue-600 text-white ml-auto'
+                                : message.type === 'ai'
+                                    ? 'bg-gray-200 text-gray-800'
+                                    : 'bg-yellow-100 text-yellow-800 text-xs'}`, "data-testid": `chat-message-${message.type}` }, message.text),
+                        React.createElement("div", { className: "text-xs text-gray-400 mt-1 px-1" }, typeof window !== 'undefined' ? new Date(message.timestamp).toLocaleTimeString() : '')))),
+                    React.createElement("div", { ref: messagesEndRef })),
+                React.createElement("form", { onSubmit: handleSend, className: "p-3 sm:p-4 border-t border-gray-200" },
+                    React.createElement("div", { className: "flex space-x-2" },
+                        React.createElement("input", { ref: inputRef, type: "text", value: inputValue, onChange: (e) => setInputValue(e.target.value), placeholder: "Try: toggle notifications", className: "flex-1 px-3 py-2 text-xs sm:text-sm border border-gray-300 rounded-lg focus:ring-2 focus:ring-blue-500 focus:border-transparent text-gray-800", "data-testid": ChatNames.input }),
+                        React.createElement("button", { type: "submit", disabled: !inputValue.trim(), className: "px-3 py-2 bg-blue-600 text-white rounded-lg hover:bg-blue-700 disabled:bg-gray-300 disabled:cursor-not-allowed transition-colors text-xs sm:text-sm font-medium", "data-testid": ChatNames.sendButton }, "Execute")),
+                    React.createElement("div", { className: "mt-2 text-xs text-gray-500 hidden sm:block" },
+                        React.createElement("strong", null, "Demo:"),
+                        " Commands execute @Tool methods and update widgets above")))),
+            React.createElement("button", { onClick: handleToggle, className: "absolute bottom-0 right-0 w-12 h-12 sm:w-14 sm:h-14 bg-blue-600 hover:bg-blue-700 text-white rounded-full shadow-lg transition-all duration-200 flex items-center justify-center", "data-testid": ChatNames.bubble, title: isExpanded ? 'Minimize chat' : 'Open AI chat' }, isExpanded ? (React.createElement("svg", { className: "w-5 h-5 sm:w-6 sm:h-6", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24" },
+                React.createElement("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M19 9l-7 7-7-7" }))) : (React.createElement("svg", { className: "w-5 h-5 sm:w-6 sm:h-6", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24" },
+                React.createElement("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M8 12h.01M12 12h.01M16 12h.01M21 12c0 4.418-4.03 8-9 8a9.863 9.863 0 01-4.255-.949L3 20l1.395-3.72C3.512 15.042 3 13.574 3 12c0-4.418 4.03-8 9-8s9 3.582 9 8z" })))),
+            hasUnread && (React.createElement("div", { className: "absolute -top-1 -right-1 w-4 h-4 sm:w-5 sm:h-5 bg-red-500 rounded-full flex items-center justify-center animate-pulse", "data-testid": "unread-indicator" },
+                React.createElement("span", { className: "text-xs text-white font-bold" }, unreadCount > 9 ? '9+' : unreadCount))))));
+};
+//# sourceMappingURL=ChatBubble.js.map