@supernal/interface 1.0.0

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

@@ -0,0 +1,59 @@
+/**
+ * Discoverable Tool Provider Interface
+ *
+ * Extends the base ToolProvider with classification and discovery capabilities.
+ * Provides methods for intelligent tool discovery and metadata management.
+ */
+interface ToolProvider {
+    name: string;
+    description?: string;
+    version?: string;
+}
+import { ClassifiedTool } from './ClassifiedTool';
+/**
+ * Tool provider with classification and discovery capabilities
+ */
+export interface DiscoverableToolProvider extends ToolProvider {
+    /**
+     * Get all classified tools available from this provider
+     * @returns Array of classified tool definitions
+     */
+    getAvailableTools(): ClassifiedTool[];
+    /**
+     * Get metadata about this tool provider
+     * @returns An object containing metadata
+     */
+    getMetadata(): Record<string, any>;
+    /**
+     * Check if a specific tool is enabled
+     * @param toolId The unique identifier of the tool
+     * @returns True if the tool is enabled
+     */
+    isToolEnabled(toolId: string): boolean;
+    /**
+     * Enable or disable a specific tool
+     * @param toolId The unique identifier of the tool
+     * @param enabled Whether the tool should be enabled
+     */
+    setToolEnabled(toolId: string, enabled: boolean): void;
+    /**
+     * Get the list of recently used tools
+     * @param limit Maximum number of tools to return
+     * @returns Array of recently used tool IDs
+     */
+    getRecentTools?(limit?: number): string[];
+    /**
+     * Get tools filtered by category
+     * @param category Tool category to filter by
+     * @returns Array of tools in the specified category
+     */
+    getToolsByCategory?(category: string): ClassifiedTool[];
+    /**
+     * Search tools by keywords or tags
+     * @param query Search query
+     * @returns Array of matching tools
+     */
+    searchTools?(query: string): ClassifiedTool[];
+}
+export {};
+//# sourceMappingURL=DiscoverableToolProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DiscoverableToolProvider.d.ts","sourceRoot":"","sources":["../../../../src/types/DiscoverableToolProvider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AACD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,wBAAyB,SAAQ,YAAY;IAC5D;;;OAGG;IACH,iBAAiB,IAAI,cAAc,EAAE,CAAC;IAEtC;;;OAGG;IACH,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAEnC;;;;OAIG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IAEvC;;;;OAIG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IAEvD;;;;OAIG;IACH,cAAc,CAAC,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAE1C;;;;OAIG;IACH,kBAAkB,CAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,EAAE,CAAC;IAExD;;;;OAIG;IACH,WAAW,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,EAAE,CAAC;CAC/C"}

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

@@ -0,0 +1,8 @@
+/**
+ * Discoverable Tool Provider Interface
+ *
+ * Extends the base ToolProvider with classification and discovery capabilities.
+ * Provides methods for intelligent tool discovery and metadata management.
+ */
+export {};
+//# sourceMappingURL=DiscoverableToolProvider.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DiscoverableToolProvider.js","sourceRoot":"","sources":["../../../../src/types/DiscoverableToolProvider.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

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

@@ -0,0 +1,75 @@
+/**
+ * Tool Exposure State Types (REQ-004)
+ *
+ * Production-quality types for state-dependent tool exposure detection.
+ */
+/**
+ * Represents the current exposure state of a tool in the UI
+ */
+export declare enum ExposureState {
+    /** Tool's DOM element does not exist in the document */
+    NOT_PRESENT = 0,
+    /** Tool exists in DOM but may not be visible (display:none, hidden, etc) */
+    PRESENT = 1,
+    /** Tool is visible (not hidden, has non-zero dimensions) */
+    VISIBLE = 2,
+    /** Tool is visible AND currently in viewport (IntersectionObserver) */
+    EXPOSED = 3,
+    /** Tool is exposed AND enabled (not disabled, not aria-disabled) */
+    INTERACTABLE = 4
+}
+/**
+ * State change event emitted by tools
+ */
+export interface ExposureStateChange {
+    /** Unique tool identifier */
+    toolId: string;
+    /** Previous state */
+    oldState: ExposureState;
+    /** New state */
+    newState: ExposureState;
+    /** Timestamp of state change */
+    timestamp: number;
+    /** Optional metadata about the state change */
+    metadata?: {
+        reason?: string;
+        element?: Element;
+        [key: string]: any;
+    };
+}
+/**
+ * Current state of a tool with metadata
+ */
+export interface ToolState {
+    /** Unique tool identifier */
+    toolId: string;
+    /** Current exposure state */
+    state: ExposureState;
+    /** DOM element (if present) */
+    element?: Element;
+    /** Last update timestamp */
+    lastUpdate: number;
+    /** Optional metadata */
+    metadata?: {
+        reason?: string;
+        path?: string;
+        context?: string;
+        [key: string]: any;
+    };
+}
+/**
+ * Observer callback for state changes
+ */
+export type ExposureStateObserver = (change: ExposureStateChange) => void;
+/**
+ * Options for waiting for a specific state
+ */
+export interface WaitForStateOptions {
+    /** Timeout in milliseconds (default: 5000) */
+    timeout?: number;
+    /** Poll interval in milliseconds (default: 100) */
+    pollInterval?: number;
+    /** Minimum state required (default: INTERACTABLE) */
+    minState?: ExposureState;
+}
+//# sourceMappingURL=ExposureState.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ExposureState.d.ts","sourceRoot":"","sources":["../../../../src/types/ExposureState.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,oBAAY,aAAa;IACvB,wDAAwD;IACxD,WAAW,IAAI;IAEf,4EAA4E;IAC5E,OAAO,IAAI;IAEX,4DAA4D;IAC5D,OAAO,IAAI;IAEX,uEAAuE;IACvE,OAAO,IAAI;IAEX,oEAAoE;IACpE,YAAY,IAAI;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC;IAEf,qBAAqB;IACrB,QAAQ,EAAE,aAAa,CAAC;IAExB,gBAAgB;IAChB,QAAQ,EAAE,aAAa,CAAC;IAExB,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAElB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE;QACT,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC;IAEf,6BAA6B;IAC7B,KAAK,EAAE,aAAa,CAAC;IAErB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;IAEnB,wBAAwB;IACxB,QAAQ,CAAC,EAAE;QACT,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,CAAC;AAE1E;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,mDAAmD;IACnD,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,aAAa,CAAC;CAC1B"}

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

@@ -0,0 +1,22 @@
+/**
+ * Tool Exposure State Types (REQ-004)
+ *
+ * Production-quality types for state-dependent tool exposure detection.
+ */
+/**
+ * Represents the current exposure state of a tool in the UI
+ */
+export var ExposureState;
+(function (ExposureState) {
+    /** Tool's DOM element does not exist in the document */
+    ExposureState[ExposureState["NOT_PRESENT"] = 0] = "NOT_PRESENT";
+    /** Tool exists in DOM but may not be visible (display:none, hidden, etc) */
+    ExposureState[ExposureState["PRESENT"] = 1] = "PRESENT";
+    /** Tool is visible (not hidden, has non-zero dimensions) */
+    ExposureState[ExposureState["VISIBLE"] = 2] = "VISIBLE";
+    /** Tool is visible AND currently in viewport (IntersectionObserver) */
+    ExposureState[ExposureState["EXPOSED"] = 3] = "EXPOSED";
+    /** Tool is exposed AND enabled (not disabled, not aria-disabled) */
+    ExposureState[ExposureState["INTERACTABLE"] = 4] = "INTERACTABLE";
+})(ExposureState || (ExposureState = {}));
+//# sourceMappingURL=ExposureState.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ExposureState.js","sourceRoot":"","sources":["../../../../src/types/ExposureState.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,CAAN,IAAY,aAeX;AAfD,WAAY,aAAa;IACvB,wDAAwD;IACxD,+DAAe,CAAA;IAEf,4EAA4E;IAC5E,uDAAW,CAAA;IAEX,4DAA4D;IAC5D,uDAAW,CAAA;IAEX,uEAAuE;IACvE,uDAAW,CAAA;IAEX,oEAAoE;IACpE,iEAAgB,CAAA;AAClB,CAAC,EAfW,aAAa,KAAb,aAAa,QAexB"}

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

@@ -0,0 +1,98 @@
+/**
+ * Navigation Graph Types (REQ-005)
+ *
+ * Production-quality types for context-aware tool discovery and navigation.
+ */
+/**
+ * Represents a context in the application (page, modal, tab, etc)
+ */
+export interface NavigationContext {
+    /** Unique context identifier (e.g., 'dashboard', 'settings', 'settings.profile') */
+    id: string;
+    /** Display name */
+    name: string;
+    /** Parent context (if nested) */
+    parent?: string;
+    /** Child contexts */
+    children: string[];
+    /** Tools available in this context */
+    tools: string[];
+    /** How to navigate TO this context from parent */
+    enterAction?: {
+        /** Tool to execute (e.g., 'nav-settings-button') */
+        toolId: string;
+        /** Parameters for the tool (if any) */
+        parameters?: Record<string, any>;
+    };
+    /** Optional metadata */
+    metadata?: {
+        path?: string;
+        url?: string;
+        component?: string;
+        [key: string]: any;
+    };
+}
+/**
+ * Edge in the navigation graph
+ */
+export interface NavigationEdge {
+    /** Source context */
+    from: string;
+    /** Target context */
+    to: string;
+    /** Tool that performs the navigation */
+    navigationTool: string;
+    /** Optional parameters */
+    parameters?: Record<string, any>;
+    /** Estimated cost/weight (for pathfinding) */
+    cost?: number;
+}
+/**
+ * Navigation path from A to B
+ */
+export interface NavigationPath {
+    /** Starting context */
+    from: string;
+    /** Ending context */
+    to: string;
+    /** Ordered list of steps */
+    steps: NavigationEdge[];
+    /** Total cost */
+    totalCost: number;
+    /** Estimated time (ms) */
+    estimatedTime: number;
+}
+/**
+ * Options for computing navigation paths
+ */
+export interface PathComputeOptions {
+    /** Maximum path length (default: 10) */
+    maxDepth?: number;
+    /** Prefer shorter paths vs. faster paths (default: true) */
+    preferShorterPaths?: boolean;
+    /** Avoid certain contexts */
+    avoidContexts?: string[];
+}
+/**
+ * Context detection strategy
+ */
+export type ContextDetectionStrategy = 'convention' | 'react-tree' | 'dom-observation' | 'manual';
+/**
+ * Context detection metadata
+ */
+export interface ContextDetection {
+    /** Which strategy was used */
+    strategy: ContextDetectionStrategy;
+    /** Detected context ID */
+    contextId: string;
+    /** Confidence level (0-1) */
+    confidence: number;
+    /** Additional metadata */
+    metadata?: {
+        filePath?: string;
+        componentName?: string;
+        domPath?: string;
+        [key: string]: any;
+    };
+}
+//# sourceMappingURL=NavigationGraph.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NavigationGraph.d.ts","sourceRoot":"","sources":["../../../../src/types/NavigationGraph.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,oFAAoF;IACpF,EAAE,EAAE,MAAM,CAAC;IAEX,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IAEb,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,qBAAqB;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;IAEnB,sCAAsC;IACtC,KAAK,EAAE,MAAM,EAAE,CAAC;IAEhB,kDAAkD;IAClD,WAAW,CAAC,EAAE;QACZ,oDAAoD;QACpD,MAAM,EAAE,MAAM,CAAC;QAEf,uCAAuC;QACvC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAClC,CAAC;IAEF,wBAAwB;IACxB,QAAQ,CAAC,EAAE;QACT,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IAEb,qBAAqB;IACrB,EAAE,EAAE,MAAM,CAAC;IAEX,wCAAwC;IACxC,cAAc,EAAE,MAAM,CAAC;IAEvB,0BAA0B;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAEjC,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IAEb,qBAAqB;IACrB,EAAE,EAAE,MAAM,CAAC;IAEX,4BAA4B;IAC5B,KAAK,EAAE,cAAc,EAAE,CAAC;IAExB,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAC;IAElB,0BAA0B;IAC1B,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,4DAA4D;IAC5D,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B,6BAA6B;IAC7B,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAChC,YAAY,GACZ,YAAY,GACZ,iBAAiB,GACjB,QAAQ,CAAC;AAEb;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,8BAA8B;IAC9B,QAAQ,EAAE,wBAAwB,CAAC;IAEnC,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAElB,6BAA6B;IAC7B,UAAU,EAAE,MAAM,CAAC;IAEnB,0BAA0B;IAC1B,QAAQ,CAAC,EAAE;QACT,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,CAAC;CACH"}

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

@@ -0,0 +1,7 @@
+/**
+ * Navigation Graph Types (REQ-005)
+ *
+ * Production-quality types for context-aware tool discovery and navigation.
+ */
+export {};
+//# sourceMappingURL=NavigationGraph.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NavigationGraph.js","sourceRoot":"","sources":["../../../../src/types/NavigationGraph.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

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

@@ -0,0 +1,45 @@
+/**
+ * Operation Type Classifications
+ *
+ * Defines the type of operation a function tool performs.
+ * Used for function tools (not UI components).
+ */
+export declare enum OperationType {
+    /**
+     * Reads data without side effects
+     */
+    READ = "read",
+    /**
+     * Modifies existing data
+     */
+    WRITE = "write",
+    /**
+     * Creates new data
+     */
+    CREATE = "create",
+    /**
+     * Removes data
+     */
+    DELETE = "delete",
+    /**
+     * Searches/queries data
+     */
+    SEARCH = "search",
+    /**
+     * Validates data
+     */
+    VALIDATE = "validate",
+    /**
+     * Transforms/processes data
+     */
+    TRANSFORM = "transform",
+    /**
+     * Navigates between contexts
+     */
+    NAVIGATE = "navigate",
+    /**
+     * Manages subscriptions/events
+     */
+    SUBSCRIBE = "subscribe"
+}
+//# sourceMappingURL=OperationType.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"OperationType.d.ts","sourceRoot":"","sources":["../../../../src/types/OperationType.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,oBAAY,aAAa;IACvB;;OAEG;IACH,IAAI,SAAS;IAEb;;OAEG;IACH,KAAK,UAAU;IAEf;;OAEG;IACH,MAAM,WAAW;IAEjB;;OAEG;IACH,MAAM,WAAW;IAEjB;;OAEG;IACH,MAAM,WAAW;IAEjB;;OAEG;IACH,QAAQ,aAAa;IAErB;;OAEG;IACH,SAAS,cAAc;IAEvB;;OAEG;IACH,QAAQ,aAAa;IAErB;;OAEG;IACH,SAAS,cAAc;CACxB"}

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

@@ -0,0 +1,46 @@
+/**
+ * Operation Type Classifications
+ *
+ * Defines the type of operation a function tool performs.
+ * Used for function tools (not UI components).
+ */
+export var OperationType;
+(function (OperationType) {
+    /**
+     * Reads data without side effects
+     */
+    OperationType["READ"] = "read";
+    /**
+     * Modifies existing data
+     */
+    OperationType["WRITE"] = "write";
+    /**
+     * Creates new data
+     */
+    OperationType["CREATE"] = "create";
+    /**
+     * Removes data
+     */
+    OperationType["DELETE"] = "delete";
+    /**
+     * Searches/queries data
+     */
+    OperationType["SEARCH"] = "search";
+    /**
+     * Validates data
+     */
+    OperationType["VALIDATE"] = "validate";
+    /**
+     * Transforms/processes data
+     */
+    OperationType["TRANSFORM"] = "transform";
+    /**
+     * Navigates between contexts
+     */
+    OperationType["NAVIGATE"] = "navigate";
+    /**
+     * Manages subscriptions/events
+     */
+    OperationType["SUBSCRIBE"] = "subscribe";
+})(OperationType || (OperationType = {}));
+//# sourceMappingURL=OperationType.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"OperationType.js","sourceRoot":"","sources":["../../../../src/types/OperationType.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAN,IAAY,aA6CX;AA7CD,WAAY,aAAa;IACvB;;OAEG;IACH,8BAAa,CAAA;IAEb;;OAEG;IACH,gCAAe,CAAA;IAEf;;OAEG;IACH,kCAAiB,CAAA;IAEjB;;OAEG;IACH,kCAAiB,CAAA;IAEjB;;OAEG;IACH,kCAAiB,CAAA;IAEjB;;OAEG;IACH,sCAAqB,CAAA;IAErB;;OAEG;IACH,wCAAuB,CAAA;IAEvB;;OAEG;IACH,sCAAqB,CAAA;IAErB;;OAEG;IACH,wCAAuB,CAAA;AACzB,CAAC,EA7CW,aAAa,KAAb,aAAa,QA6CxB"}

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

@@ -0,0 +1,35 @@
+/**
+ * State Manager Names
+ *
+ * Enum defining named StateManager instances for multi-context support.
+ * Each name represents an isolated state tree for specific use cases.
+ *
+ * @example
+ * ```typescript
+ * const coreState = StateManager.getInstance(StateManagers.SupernalCoreV1, adapter);
+ * const userState = StateManager.getInstance(StateManagers.UserSession, adapter);
+ * ```
+ */
+export declare enum StateManagers {
+    /**
+     * Core application state manager (v1)
+     * Used for fundamental system state
+     */
+    SupernalCoreV1 = "supernal_core_v1",
+    /**
+     * User session state manager
+     * Isolated user-specific data
+     */
+    UserSession = "user_session",
+    /**
+     * Testing state manager
+     * Used for test isolation
+     */
+    Testing = "testing",
+    /**
+     * Demo state manager
+     * For demo/example scenarios
+     */
+    Demo = "demo"
+}
+//# sourceMappingURL=StateManagers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"StateManagers.d.ts","sourceRoot":"","sources":["../../../../src/types/StateManagers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,oBAAY,aAAa;IACvB;;;OAGG;IACH,cAAc,qBAAqB;IAEnC;;;OAGG;IACH,WAAW,iBAAiB;IAE5B;;;OAGG;IACH,OAAO,YAAY;IAEnB;;;OAGG;IACH,IAAI,SAAS;CACd"}

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

@@ -0,0 +1,36 @@
+/**
+ * State Manager Names
+ *
+ * Enum defining named StateManager instances for multi-context support.
+ * Each name represents an isolated state tree for specific use cases.
+ *
+ * @example
+ * ```typescript
+ * const coreState = StateManager.getInstance(StateManagers.SupernalCoreV1, adapter);
+ * const userState = StateManager.getInstance(StateManagers.UserSession, adapter);
+ * ```
+ */
+export var StateManagers;
+(function (StateManagers) {
+    /**
+     * Core application state manager (v1)
+     * Used for fundamental system state
+     */
+    StateManagers["SupernalCoreV1"] = "supernal_core_v1";
+    /**
+     * User session state manager
+     * Isolated user-specific data
+     */
+    StateManagers["UserSession"] = "user_session";
+    /**
+     * Testing state manager
+     * Used for test isolation
+     */
+    StateManagers["Testing"] = "testing";
+    /**
+     * Demo state manager
+     * For demo/example scenarios
+     */
+    StateManagers["Demo"] = "demo";
+})(StateManagers || (StateManagers = {}));
+//# sourceMappingURL=StateManagers.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"StateManagers.js","sourceRoot":"","sources":["../../../../src/types/StateManagers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,CAAN,IAAY,aAwBX;AAxBD,WAAY,aAAa;IACvB;;;OAGG;IACH,oDAAmC,CAAA;IAEnC;;;OAGG;IACH,6CAA4B,CAAA;IAE5B;;;OAGG;IACH,oCAAmB,CAAA;IAEnB;;;OAGG;IACH,8BAAa,CAAA;AACf,CAAC,EAxBW,aAAa,KAAb,aAAa,QAwBxB"}

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

@@ -0,0 +1,162 @@
+/**
+ * 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.
+ */
+import { ToolPermissions } from './ToolPermissions';
+/**
+ * Category of tool functionality
+ */
+export declare enum ToolCategory {
+    CONTENT_CREATION = "content_creation",
+    CONTENT_RETRIEVAL = "content_retrieval",
+    DATA_MANIPULATION = "data_manipulation",
+    EXTERNAL_SERVICE = "external_service",
+    SYSTEM = "system",
+    USER_INTERACTION = "user_interaction",
+    MEMORY = "memory",
+    DATA = "data",
+    SEARCH = "search",
+    UTILITY = "utility",
+    TIME = "time",
+    DOM = "dom",
+    API = "api",
+    FILE = "file",
+    COMMUNICATION = "communication",
+    CONTEXT_APP = "context-app",
+    WORKFLOW = "workflow",
+    CHAT = "chat",
+    SETTINGS = "settings",
+    NAVIGATION = "navigation",
+    ONBOARDING = "onboarding"
+}
+/**
+ * Example of tool usage with input/output
+ */
+export interface ToolExample {
+    input: Record<string, any>;
+    output: Record<string, any>;
+    description?: string;
+}
+/**
+ * JSON Schema type (simplified for TypeScript)
+ */
+export type JSONSchema = {
+    type: string;
+    properties?: Record<string, any>;
+    required?: string[];
+    description?: string;
+    items?: any;
+    enum?: string[];
+    [key: string]: any;
+};
+/**
+ * Component storage interface for persisting state
+ */
+export interface ComponentStorage {
+    get<T>(key: string): Promise<T | null>;
+    set<T>(key: string, value: T): Promise<void>;
+    update<T>(key: string, value: T): Promise<void>;
+    delete(key: string): Promise<void>;
+    search(query: string): Promise<string[]>;
+    list(filter?: (key: string) => boolean): Promise<string[]>;
+    clear(): Promise<void>;
+    count(): Promise<number>;
+    keys(): Promise<string[]>;
+    values(): Promise<any[]>;
+    entries(): Promise<[string, any][]>;
+    size(): Promise<number>;
+    isEmpty(): Promise<boolean>;
+}
+/**
+ * Runtime options for tool invocation
+ * Provides callbacks and storage integration
+ */
+export interface ToolOptions {
+    onSuccess?: (result: any) => void;
+    onError?: (error: Error) => void;
+    onStart?: () => void;
+    onComplete?: () => void;
+    storage?: ComponentStorage;
+    validate?: (input: any) => boolean | Promise<boolean>;
+    onNavigate?: (path: string) => void;
+}
+/**
+ * Tool interface defining the structure of callable functions
+ */
+export interface Tool {
+    /**
+     * Unique identifier for the tool
+     */
+    id: string;
+    /**
+     * Name of the tool (must match regex ^[a-zA-Z0-9_-]{1,64}$)
+     */
+    name: string;
+    /**
+     * Detailed description (3-4 sentences minimum)
+     */
+    description: string;
+    /**
+     * Category for grouping related tools
+     */
+    category: ToolCategory;
+    /**
+     * JSON Schema defining expected parameters
+     */
+    inputSchema: JSONSchema;
+    /**
+     * JSON Schema defining return type
+     */
+    outputSchema: JSONSchema;
+    /**
+     * Tool's declared return format (markdown or json)
+     */
+    returnType?: 'markdown' | 'json';
+    /**
+     * Optional usage examples
+     */
+    examples?: ToolExample[];
+    /**
+     * Required permissions to use the tool
+     */
+    permissions: ToolPermissions;
+    /**
+     * Which platforms this tool supports
+     */
+    platformSupport: {
+        chrome: boolean;
+        web: boolean;
+        desktop: boolean;
+    };
+    /**
+     * Version of the tool
+     */
+    version?: string;
+    /**
+     * Whether the tool is currently enabled
+     */
+    enabled?: boolean;
+    /**
+     * Additional tool metadata
+     */
+    metadata?: Record<string, any>;
+    /**
+     * Component state classification (NEW)
+     * Discriminated union: 'ui-component' or 'function-tool'
+     */
+    componentKind?: 'ui-component' | 'function-tool';
+    /**
+     * HTML semantics (for UI components)
+     */
+    htmlTag?: string;
+    htmlType?: string;
+    htmlRole?: string;
+    /**
+     * Operation type (for function tools)
+     */
+    operationType?: string;
+}
+//# sourceMappingURL=Tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Tool.d.ts","sourceRoot":"","sources":["../../../../src/types/Tool.ts"],"names":[],"mappings":"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"}