@emblemvault/hustle-react 1.0.0

package/dist/index.d.cts

@@ -0,0 +1,229 @@
+export { HustleProvider, useHustle } from './providers/index.cjs';
+export { HustleChat, HustleChatProps, MarkdownContent } from './components/index.cjs';
+export { A as Attachment, C as ChatMessage, b as ChatOptions, d as ChatResponse, H as HustleConfig, h as HustleContextValue, i as HustleProviderProps, M as Model, c as StreamChunk, g as StreamEndEvent, S as StreamOptions, T as ToolCall, f as ToolEndEvent, a as ToolResult, e as ToolStartEvent } from './hustle-S48t4lTZ.cjs';
+import { S as StoredPlugin, H as HustlePlugin, a as HydratedPlugin } from './plugin-BUg7vMxe.cjs';
+export { C as ClientToolDefinition, E as ErrorContext, d as HustleRequest, J as JSONSchema, b as JSONSchemaProperty, e as PluginHooks, P as ProcessedResponse, f as SerializedHooks, c as SerializedToolDefinition, T as ToolExecutor } from './plugin-BUg7vMxe.cjs';
+export { UsePluginsReturn, usePlugins } from './hooks/index.cjs';
+export { AvailablePlugin, availablePlugins, getAvailablePlugin, migrateFunPlugin, predictionMarketPlugin } from './plugins/index.cjs';
+import 'react/jsx-runtime';
+import 'hustle-incognito';
+
+/**
+ * Plugin Registry
+ *
+ * Manages plugin storage and state in localStorage.
+ *
+ * Storage model:
+ * - Installed plugins are GLOBAL (hustle-plugins) - install once, available everywhere
+ * - Enabled/disabled state is INSTANCE-SCOPED (hustle-plugin-state-{instanceId})
+ *
+ * Executor functions are serialized as strings (executorCode) and
+ * reconstituted at runtime via new Function().
+ *
+ * SECURITY TODO: Add signature verification before executing stored code.
+ * Plugins should be signed by trusted publishers and verified before
+ * any eval/Function execution occurs.
+ */
+
+type PluginChangeCallback = (plugins: StoredPlugin[]) => void;
+/**
+ * Hydrate a stored plugin - reconstitute executors from executorCode
+ *
+ * FIXME: Add signature verification before execution
+ */
+declare function hydratePlugin(stored: StoredPlugin): HydratedPlugin;
+/**
+ * Plugin Registry class
+ *
+ * Manages plugin persistence with:
+ * - Global plugin installations (with serialized executorCode)
+ * - Instance-scoped enabled/disabled state
+ */
+declare class PluginRegistry {
+    private listeners;
+    /**
+     * Get listeners for a specific instance
+     */
+    private getListeners;
+    /**
+     * Load installed plugins (global)
+     */
+    private loadInstalledPlugins;
+    /**
+     * Save installed plugins (global)
+     * Serializes executors as executorCode strings
+     */
+    private saveInstalledPlugins;
+    /**
+     * Load enabled state for an instance
+     */
+    private loadEnabledState;
+    /**
+     * Save enabled state for an instance
+     */
+    private saveEnabledState;
+    /**
+     * Load plugins with instance-specific enabled state
+     * Combines global plugin list with per-instance enabled state
+     */
+    loadFromStorage(instanceId?: string): StoredPlugin[];
+    /**
+     * Register a new plugin (global - available to all instances)
+     * Serializes executors as executorCode for persistence
+     *
+     * @param plugin The plugin to install
+     * @param enabled Initial enabled state for this instance (default: true)
+     * @param instanceId Instance to set initial enabled state for
+     */
+    register(plugin: HustlePlugin, enabled?: boolean, instanceId?: string): void;
+    /**
+     * Unregister a plugin (global - removes from all instances)
+     */
+    unregister(pluginName: string, instanceId?: string): void;
+    /**
+     * Enable or disable a plugin (instance-scoped)
+     */
+    setEnabled(pluginName: string, enabled: boolean, instanceId?: string): void;
+    /**
+     * Check if a plugin is installed (global)
+     */
+    isRegistered(pluginName: string): boolean;
+    /**
+     * Get a specific plugin with instance-specific enabled state
+     */
+    getPlugin(pluginName: string, instanceId?: string): StoredPlugin | undefined;
+    /**
+     * Get all enabled plugins for an instance (hydrated with executors)
+     */
+    getEnabledPlugins(instanceId?: string): HydratedPlugin[];
+    /**
+     * Subscribe to plugin changes for a specific instance
+     */
+    onChange(callback: PluginChangeCallback, instanceId?: string): () => void;
+    /**
+     * Notify all listeners for a specific instance
+     */
+    private notifyListeners;
+    /**
+     * Clear enabled state for an instance (plugins remain installed globally)
+     */
+    clear(instanceId?: string): void;
+    /**
+     * Clear all installed plugins globally
+     */
+    clearAll(): void;
+}
+declare const pluginRegistry: PluginRegistry;
+
+/**
+ * Format file size for display
+ * @example formatFileSize(1024) => '1 KB'
+ */
+declare function formatFileSize(bytes: number): string;
+/**
+ * Create a debounced function
+ */
+declare function debounce<T extends (...args: unknown[]) => unknown>(fn: T, delay: number): (...args: Parameters<T>) => void;
+/**
+ * Storage keys for persistence
+ */
+declare const STORAGE_KEYS: {
+    readonly AUTH_SESSION: "emblem_auth_session";
+    readonly HUSTLE_SETTINGS: "hustle_settings";
+    readonly CHAT_HISTORY: "hustle_chat_history";
+    readonly PLUGINS: "hustle-plugins";
+};
+/**
+ * Default configuration values
+ */
+declare const DEFAULTS: {
+    readonly HUSTLE_API_URL: "https://agenthustle.ai";
+    readonly EMBLEM_API_URL: "https://api.emblemvault.ai";
+    readonly EMBLEM_MODAL_URL: "https://emblemvault.ai/connect";
+};
+
+declare const tokens: {
+    colors: {
+        bgPrimary: string;
+        bgSecondary: string;
+        bgTertiary: string;
+        bgHover: string;
+        bgOverlay: string;
+        borderPrimary: string;
+        borderSecondary: string;
+        borderHover: string;
+        textPrimary: string;
+        textSecondary: string;
+        textTertiary: string;
+        textInverse: string;
+        accentPrimary: string;
+        accentPrimaryHover: string;
+        accentPrimaryBg: string;
+        accentSuccess: string;
+        accentSuccessHover: string;
+        accentSuccessBg: string;
+        accentWarning: string;
+        accentWarningBg: string;
+        accentError: string;
+        accentErrorHover: string;
+        accentErrorBg: string;
+        msgUser: string;
+        msgAssistant: string;
+    };
+    typography: {
+        fontFamily: string;
+        fontFamilyMono: string;
+        fontSizeXs: string;
+        fontSizeSm: string;
+        fontSizeMd: string;
+        fontSizeLg: string;
+        fontSizeXl: string;
+        fontWeightNormal: number;
+        fontWeightMedium: number;
+        fontWeightSemibold: number;
+        lineHeightTight: number;
+        lineHeightNormal: number;
+        lineHeightRelaxed: number;
+    };
+    spacing: {
+        xs: string;
+        sm: string;
+        md: string;
+        lg: string;
+        xl: string;
+        xxl: string;
+    };
+    radius: {
+        sm: string;
+        md: string;
+        lg: string;
+        xl: string;
+        pill: string;
+        full: string;
+    };
+    shadows: {
+        sm: string;
+        md: string;
+        lg: string;
+        xl: string;
+    };
+    glows: {
+        primary: string;
+        success: string;
+        error: string;
+        ambient: string;
+    };
+    transitions: {
+        fast: string;
+        normal: string;
+        slow: string;
+    };
+    zIndex: {
+        dropdown: number;
+        modal: number;
+        fullscreen: number;
+        modalOverFullscreen: number;
+    };
+};
+
+export { DEFAULTS, HustlePlugin, HydratedPlugin, STORAGE_KEYS, StoredPlugin, debounce, formatFileSize, hydratePlugin, pluginRegistry, tokens };

package/dist/index.d.ts

@@ -0,0 +1,229 @@
+export { HustleProvider, useHustle } from './providers/index.js';
+export { HustleChat, HustleChatProps, MarkdownContent } from './components/index.js';
+export { A as Attachment, C as ChatMessage, b as ChatOptions, d as ChatResponse, H as HustleConfig, h as HustleContextValue, i as HustleProviderProps, M as Model, c as StreamChunk, g as StreamEndEvent, S as StreamOptions, T as ToolCall, f as ToolEndEvent, a as ToolResult, e as ToolStartEvent } from './hustle-S48t4lTZ.js';
+import { S as StoredPlugin, H as HustlePlugin, a as HydratedPlugin } from './plugin-BUg7vMxe.js';
+export { C as ClientToolDefinition, E as ErrorContext, d as HustleRequest, J as JSONSchema, b as JSONSchemaProperty, e as PluginHooks, P as ProcessedResponse, f as SerializedHooks, c as SerializedToolDefinition, T as ToolExecutor } from './plugin-BUg7vMxe.js';
+export { UsePluginsReturn, usePlugins } from './hooks/index.js';
+export { AvailablePlugin, availablePlugins, getAvailablePlugin, migrateFunPlugin, predictionMarketPlugin } from './plugins/index.js';
+import 'react/jsx-runtime';
+import 'hustle-incognito';
+
+/**
+ * Plugin Registry
+ *
+ * Manages plugin storage and state in localStorage.
+ *
+ * Storage model:
+ * - Installed plugins are GLOBAL (hustle-plugins) - install once, available everywhere
+ * - Enabled/disabled state is INSTANCE-SCOPED (hustle-plugin-state-{instanceId})
+ *
+ * Executor functions are serialized as strings (executorCode) and
+ * reconstituted at runtime via new Function().
+ *
+ * SECURITY TODO: Add signature verification before executing stored code.
+ * Plugins should be signed by trusted publishers and verified before
+ * any eval/Function execution occurs.
+ */
+
+type PluginChangeCallback = (plugins: StoredPlugin[]) => void;
+/**
+ * Hydrate a stored plugin - reconstitute executors from executorCode
+ *
+ * FIXME: Add signature verification before execution
+ */
+declare function hydratePlugin(stored: StoredPlugin): HydratedPlugin;
+/**
+ * Plugin Registry class
+ *
+ * Manages plugin persistence with:
+ * - Global plugin installations (with serialized executorCode)
+ * - Instance-scoped enabled/disabled state
+ */
+declare class PluginRegistry {
+    private listeners;
+    /**
+     * Get listeners for a specific instance
+     */
+    private getListeners;
+    /**
+     * Load installed plugins (global)
+     */
+    private loadInstalledPlugins;
+    /**
+     * Save installed plugins (global)
+     * Serializes executors as executorCode strings
+     */
+    private saveInstalledPlugins;
+    /**
+     * Load enabled state for an instance
+     */
+    private loadEnabledState;
+    /**
+     * Save enabled state for an instance
+     */
+    private saveEnabledState;
+    /**
+     * Load plugins with instance-specific enabled state
+     * Combines global plugin list with per-instance enabled state
+     */
+    loadFromStorage(instanceId?: string): StoredPlugin[];
+    /**
+     * Register a new plugin (global - available to all instances)
+     * Serializes executors as executorCode for persistence
+     *
+     * @param plugin The plugin to install
+     * @param enabled Initial enabled state for this instance (default: true)
+     * @param instanceId Instance to set initial enabled state for
+     */
+    register(plugin: HustlePlugin, enabled?: boolean, instanceId?: string): void;
+    /**
+     * Unregister a plugin (global - removes from all instances)
+     */
+    unregister(pluginName: string, instanceId?: string): void;
+    /**
+     * Enable or disable a plugin (instance-scoped)
+     */
+    setEnabled(pluginName: string, enabled: boolean, instanceId?: string): void;
+    /**
+     * Check if a plugin is installed (global)
+     */
+    isRegistered(pluginName: string): boolean;
+    /**
+     * Get a specific plugin with instance-specific enabled state
+     */
+    getPlugin(pluginName: string, instanceId?: string): StoredPlugin | undefined;
+    /**
+     * Get all enabled plugins for an instance (hydrated with executors)
+     */
+    getEnabledPlugins(instanceId?: string): HydratedPlugin[];
+    /**
+     * Subscribe to plugin changes for a specific instance
+     */
+    onChange(callback: PluginChangeCallback, instanceId?: string): () => void;
+    /**
+     * Notify all listeners for a specific instance
+     */
+    private notifyListeners;
+    /**
+     * Clear enabled state for an instance (plugins remain installed globally)
+     */
+    clear(instanceId?: string): void;
+    /**
+     * Clear all installed plugins globally
+     */
+    clearAll(): void;
+}
+declare const pluginRegistry: PluginRegistry;
+
+/**
+ * Format file size for display
+ * @example formatFileSize(1024) => '1 KB'
+ */
+declare function formatFileSize(bytes: number): string;
+/**
+ * Create a debounced function
+ */
+declare function debounce<T extends (...args: unknown[]) => unknown>(fn: T, delay: number): (...args: Parameters<T>) => void;
+/**
+ * Storage keys for persistence
+ */
+declare const STORAGE_KEYS: {
+    readonly AUTH_SESSION: "emblem_auth_session";
+    readonly HUSTLE_SETTINGS: "hustle_settings";
+    readonly CHAT_HISTORY: "hustle_chat_history";
+    readonly PLUGINS: "hustle-plugins";
+};
+/**
+ * Default configuration values
+ */
+declare const DEFAULTS: {
+    readonly HUSTLE_API_URL: "https://agenthustle.ai";
+    readonly EMBLEM_API_URL: "https://api.emblemvault.ai";
+    readonly EMBLEM_MODAL_URL: "https://emblemvault.ai/connect";
+};
+
+declare const tokens: {
+    colors: {
+        bgPrimary: string;
+        bgSecondary: string;
+        bgTertiary: string;
+        bgHover: string;
+        bgOverlay: string;
+        borderPrimary: string;
+        borderSecondary: string;
+        borderHover: string;
+        textPrimary: string;
+        textSecondary: string;
+        textTertiary: string;
+        textInverse: string;
+        accentPrimary: string;
+        accentPrimaryHover: string;
+        accentPrimaryBg: string;
+        accentSuccess: string;
+        accentSuccessHover: string;
+        accentSuccessBg: string;
+        accentWarning: string;
+        accentWarningBg: string;
+        accentError: string;
+        accentErrorHover: string;
+        accentErrorBg: string;
+        msgUser: string;
+        msgAssistant: string;
+    };
+    typography: {
+        fontFamily: string;
+        fontFamilyMono: string;
+        fontSizeXs: string;
+        fontSizeSm: string;
+        fontSizeMd: string;
+        fontSizeLg: string;
+        fontSizeXl: string;
+        fontWeightNormal: number;
+        fontWeightMedium: number;
+        fontWeightSemibold: number;
+        lineHeightTight: number;
+        lineHeightNormal: number;
+        lineHeightRelaxed: number;
+    };
+    spacing: {
+        xs: string;
+        sm: string;
+        md: string;
+        lg: string;
+        xl: string;
+        xxl: string;
+    };
+    radius: {
+        sm: string;
+        md: string;
+        lg: string;
+        xl: string;
+        pill: string;
+        full: string;
+    };
+    shadows: {
+        sm: string;
+        md: string;
+        lg: string;
+        xl: string;
+    };
+    glows: {
+        primary: string;
+        success: string;
+        error: string;
+        ambient: string;
+    };
+    transitions: {
+        fast: string;
+        normal: string;
+        slow: string;
+    };
+    zIndex: {
+        dropdown: number;
+        modal: number;
+        fullscreen: number;
+        modalOverFullscreen: number;
+    };
+};
+
+export { DEFAULTS, HustlePlugin, HydratedPlugin, STORAGE_KEYS, StoredPlugin, debounce, formatFileSize, hydratePlugin, pluginRegistry, tokens };