aether-react 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,159 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import React from 'react';
+import { Aether, MemoryEvent, RetrievalOptions, RetrievalType, MemoryStats } from 'aether-core';
+
+interface AetherContextValue {
+    aether: Aether | null;
+    events: MemoryEvent[];
+    loading: boolean;
+    error: Error | null;
+    add: (content: string, context?: Record<string, unknown>) => Promise<MemoryEvent | null>;
+    retrieve: (query: string, options?: RetrievalOptions) => Promise<MemoryEvent[]>;
+    refresh: () => Promise<void>;
+    clearEvents: () => void;
+}
+interface AetherProviderProps {
+    aether: Aether;
+    children: React.ReactNode;
+    /** Initial actor to load history for */
+    initialActor?: string;
+    /** Auto-subscribe to new events */
+    autoSubscribe?: boolean;
+}
+declare function AetherProvider({ aether, children, initialActor, autoSubscribe, }: AetherProviderProps): react_jsx_runtime.JSX.Element;
+declare function useAether(): AetherContextValue;
+
+interface WebSocketMessage {
+    type: string;
+    data?: unknown;
+}
+interface UseMemoryStreamOptions {
+    /** Auto-connect on mount */
+    autoConnect?: boolean;
+    /** Reconnect on disconnect */
+    autoReconnect?: boolean;
+    /** Max reconnect attempts */
+    maxReconnectAttempts?: number;
+    /** Reconnect delay in ms */
+    reconnectDelay?: number;
+}
+interface UseMemoryStreamReturn {
+    events: MemoryEvent[];
+    connected: boolean;
+    error: Error | null;
+    connect: () => void;
+    disconnect: () => void;
+    send: (message: WebSocketMessage) => void;
+    clearEvents: () => void;
+}
+declare function useMemoryStream(serverUrl: string, options?: UseMemoryStreamOptions): UseMemoryStreamReturn;
+
+interface MemoryGraphViewProps {
+    events: MemoryEvent[];
+    width?: number;
+    height?: number;
+    onNodeClick?: (event: MemoryEvent) => void;
+    highlightActor?: string;
+    showRelations?: boolean;
+    className?: string;
+}
+declare function MemoryGraphView({ events, width, height, onNodeClick, highlightActor, showRelations, className, }: MemoryGraphViewProps): react_jsx_runtime.JSX.Element;
+
+interface TimelineViewProps {
+    events: MemoryEvent[];
+    onEventClick?: (event: MemoryEvent) => void;
+    selectedEventId?: string;
+    showContext?: boolean;
+    groupBy?: 'none' | 'day' | 'actor';
+    maxHeight?: string | number;
+    className?: string;
+}
+declare function TimelineView({ events, onEventClick, selectedEventId, showContext, groupBy, maxHeight, className, }: TimelineViewProps): react_jsx_runtime.JSX.Element;
+
+interface ClusterMapProps {
+    events: MemoryEvent[];
+    width?: number;
+    height?: number;
+    onEventClick?: (event: MemoryEvent) => void;
+    colorBy?: 'actor' | 'action';
+    className?: string;
+}
+/**
+ * ClusterMap visualizes events in a 2D space based on their embeddings.
+ * Note: Full t-SNE/UMAP implementation requires additional dependencies.
+ * This is a simplified version that uses a basic layout.
+ */
+declare function ClusterMap({ events, width, height, onEventClick, colorBy, className, }: ClusterMapProps): react_jsx_runtime.JSX.Element;
+
+interface MemoryExplorerProps {
+    events: MemoryEvent[];
+    onEventClick?: (event: MemoryEvent) => void;
+    defaultView?: 'timeline' | 'graph' | 'cluster';
+    showViewSwitcher?: boolean;
+    className?: string;
+}
+declare function MemoryExplorer({ events, onEventClick, defaultView, showViewSwitcher, className, }: MemoryExplorerProps): react_jsx_runtime.JSX.Element;
+
+interface MemoryCardProps {
+    event: MemoryEvent;
+    onClick?: (event: MemoryEvent) => void;
+    selected?: boolean;
+    showContext?: boolean;
+    className?: string;
+}
+declare function MemoryCard({ event, onClick, selected, showContext, className, }: MemoryCardProps): react_jsx_runtime.JSX.Element;
+
+interface AddMemoryFormProps {
+    onAdd: (content: string, actor: string, context?: Record<string, unknown>) => Promise<void>;
+    loading?: boolean;
+    defaultActor?: string;
+    placeholder?: string;
+    className?: string;
+}
+declare function AddMemoryForm({ onAdd, loading, defaultActor, placeholder, className, }: AddMemoryFormProps): react_jsx_runtime.JSX.Element;
+
+interface SearchBarProps {
+    onSearch: (query: string, options: SearchOptions) => Promise<void>;
+    loading?: boolean;
+    placeholder?: string;
+    className?: string;
+}
+interface SearchOptions {
+    retrievalType: RetrievalType;
+    limit: number;
+    actor?: string;
+}
+declare function SearchBar({ onSearch, loading, placeholder, className, }: SearchBarProps): react_jsx_runtime.JSX.Element;
+
+interface StatsPanelProps {
+    stats: MemoryStats | null;
+    loading?: boolean;
+    className?: string;
+}
+declare function StatsPanel({ stats, loading, className }: StatsPanelProps): react_jsx_runtime.JSX.Element;
+
+interface ActorSelectorProps {
+    actors: string[];
+    selectedActor: string | null;
+    onSelect: (actor: string | null) => void;
+    loading?: boolean;
+    className?: string;
+}
+declare function ActorSelector({ actors, selectedActor, onSelect, loading, className, }: ActorSelectorProps): react_jsx_runtime.JSX.Element;
+
+interface ConnectionStatusProps {
+    connected: boolean;
+    error?: Error | null;
+    onReconnect?: () => void;
+    className?: string;
+}
+declare function ConnectionStatus({ connected, error, onReconnect, className, }: ConnectionStatusProps): react_jsx_runtime.JSX.Element;
+
+interface DashboardProps {
+    aether: Aether;
+    title?: string;
+    className?: string;
+}
+declare function Dashboard({ aether, title, className }: DashboardProps): react_jsx_runtime.JSX.Element;
+
+export { ActorSelector, type ActorSelectorProps, AddMemoryForm, type AddMemoryFormProps, AetherProvider, ClusterMap, type ClusterMapProps, ConnectionStatus, type ConnectionStatusProps, Dashboard, type DashboardProps, MemoryCard, type MemoryCardProps, MemoryExplorer, type MemoryExplorerProps, MemoryGraphView, type MemoryGraphViewProps, SearchBar, type SearchBarProps, type SearchOptions, StatsPanel, type StatsPanelProps, TimelineView, type TimelineViewProps, useAether, useMemoryStream };