@omiron33/omi-neuron-web 0.1.0

package/dist/query-helpers-DvQTA2_Z.d.ts

@@ -0,0 +1,777 @@
+import { R as RelationshipType, E as EdgeEvidence, b as NeuronNode, d as NeuronNodeCreate, c as NeuronEdge, e as NeuronNodeUpdate, f as NeuronEdgeCreate, g as NeuronEdgeUpdate, N as NeuronVisualNode, a as NeuronVisualEdge } from './edge-BzsYe2Ed.js';
+
+/**
+ * Cluster Types for omi-neuron-web
+ * Defines groupings of similar nodes based on embeddings
+ */
+/**
+ * Cluster represents a grouping of similar nodes
+ */
+interface NeuronCluster {
+    /** UUID v4 identifier */
+    id: string;
+    /** AI-generated or manual label */
+    label: string;
+    /** Type of cluster (e.g., 'topic', 'narrative', 'entity') */
+    clusterType: string;
+    /** Average embedding of all members */
+    centroid: number[];
+    /** Number of nodes in cluster */
+    memberCount: number;
+    /** Average similarity of members to centroid (0-1) */
+    avgSimilarity: number;
+    /** How tightly grouped the cluster is (0-1) */
+    cohesion: number;
+    /** Optional description */
+    description?: string | null;
+    /** Extracted keywords */
+    keywords: string[];
+    /** Additional metadata */
+    metadata: Record<string, unknown>;
+    /** Creation timestamp */
+    createdAt: Date;
+    /** Last update timestamp */
+    updatedAt: Date;
+    /** Last time centroid was recomputed */
+    lastRecomputedAt?: Date | null;
+}
+/**
+ * Node-to-cluster membership
+ */
+interface ClusterMembership {
+    /** Node ID */
+    nodeId: string;
+    /** Cluster ID */
+    clusterId: string;
+    /** Similarity to cluster centroid (0-1) */
+    similarityScore: number;
+    /** Whether this is the primary cluster for this node */
+    isPrimary: boolean;
+    /** When the node was assigned to this cluster */
+    assignedAt: Date;
+}
+/**
+ * Input for creating clusters manually
+ */
+interface NeuronClusterCreate {
+    label: string;
+    clusterType?: string;
+    description?: string;
+    keywords?: string[];
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Input for updating clusters
+ */
+interface NeuronClusterUpdate {
+    label?: string;
+    description?: string;
+    keywords?: string[];
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Visual cluster representation
+ */
+interface NeuronVisualCluster {
+    id: string;
+    label: string;
+    nodeIds: string[];
+    color?: string;
+}
+/**
+ * Clustering algorithm options
+ */
+type ClusteringAlgorithm = 'kmeans' | 'dbscan' | 'hierarchical';
+/**
+ * Clustering configuration
+ */
+interface ClusteringConfig {
+    /** Algorithm to use */
+    algorithm: ClusteringAlgorithm;
+    /** Target number of clusters (for k-means) */
+    clusterCount?: number;
+    /** Minimum cluster size */
+    minClusterSize?: number;
+    /** Similarity threshold for cluster assignment */
+    similarityThreshold?: number;
+    /** Epsilon for DBSCAN */
+    epsilon?: number;
+    /** Min samples for DBSCAN */
+    minSamples?: number;
+}
+
+/**
+ * Analysis Types for omi-neuron-web
+ * Defines analysis jobs and pipeline operations
+ */
+
+/**
+ * Type of analysis run
+ */
+type AnalysisRunType = 'embedding' | 'clustering' | 'relationship_inference' | 'full_analysis';
+/**
+ * Status of an analysis job
+ */
+type AnalysisJobStatus = 'queued' | 'running' | 'completed' | 'failed' | 'cancelled';
+/**
+ * Analysis run record - tracks analysis jobs
+ */
+interface AnalysisRun {
+    /** UUID v4 identifier */
+    id: string;
+    /** Type of analysis being performed */
+    runType: AnalysisRunType;
+    inputParams: {
+        /** Specific node IDs or all if undefined */
+        nodeIds?: string[];
+        /** Force regenerate even if exists */
+        forceRecompute?: boolean;
+        /** Target cluster count for k-means */
+        clusterCount?: number;
+        /** Minimum confidence for relationships */
+        relationshipThreshold?: number;
+        /** Embedding model to use */
+        embeddingModel?: string;
+    };
+    results: {
+        nodesProcessed: number;
+        embeddingsGenerated: number;
+        clustersCreated: number;
+        relationshipsInferred: number;
+        errors: Array<{
+            nodeId: string;
+            error: string;
+        }>;
+    };
+    /** Current job status */
+    status: AnalysisJobStatus;
+    /** Progress percentage (0-100) */
+    progress: number;
+    /** When the job started */
+    startedAt?: Date | null;
+    /** When the job completed */
+    completedAt?: Date | null;
+    /** Duration in milliseconds */
+    durationMs?: number | null;
+    /** Error message if failed */
+    errorMessage?: string | null;
+    /** Error stack trace */
+    errorStack?: string | null;
+}
+/**
+ * Request to trigger analysis
+ */
+interface AnalysisRequest {
+    /** Type of analysis to perform */
+    action: 'embeddings' | 'cluster' | 'infer_relationships' | 'full';
+    /** Specific node IDs, or all if omitted */
+    nodeIds?: string[];
+    /** Options per action type */
+    options?: {
+        forceRecompute?: boolean;
+        embeddingModel?: string;
+        clusterCount?: number;
+        minClusterSize?: number;
+        reassignAll?: boolean;
+        relationshipThreshold?: number;
+        maxRelationshipsPerNode?: number;
+        includeExisting?: boolean;
+    };
+    /** Run asynchronously (default: true for large jobs) */
+    async?: boolean;
+    /** Webhook URL to notify on completion */
+    webhookUrl?: string;
+}
+/**
+ * Response from triggering analysis
+ */
+interface AnalysisResponse {
+    /** Job ID for tracking */
+    jobId: string;
+    /** Current status */
+    status: AnalysisJobStatus;
+    /** Estimated duration in seconds */
+    estimatedDuration?: number;
+    /** Results if sync and completed */
+    results?: AnalysisRun['results'];
+}
+/**
+ * Relationship inference result
+ */
+interface InferredRelationshipResult {
+    fromNodeId: string;
+    toNodeId: string;
+    confidence: number;
+    reasoning: string;
+    suggestedType: RelationshipType;
+    evidence: EdgeEvidence[];
+}
+/**
+ * Embedding generation result
+ */
+interface EmbeddingResult {
+    nodeId: string;
+    embedding: number[];
+    model: string;
+    tokenCount: number;
+}
+/**
+ * Clustering result
+ */
+interface ClusteringResult {
+    clusterId: string;
+    label: string;
+    nodeIds: string[];
+    centroid: number[];
+    avgSimilarity: number;
+}
+/**
+ * Analysis pipeline configuration
+ */
+interface AnalysisPipelineConfig {
+    embeddingModel: string;
+    embeddingDimensions: number;
+    embeddingBatchSize: number;
+    embeddingCacheTTL: number;
+    clusteringAlgorithm: 'kmeans' | 'dbscan' | 'hierarchical';
+    defaultClusterCount: number;
+    minClusterSize: number;
+    clusterSimilarityThreshold: number;
+    relationshipInferenceModel: string;
+    relationshipMinConfidence: number;
+    relationshipMaxPerNode: number;
+    openaiRateLimit: number;
+    maxConcurrentAnalysis: number;
+}
+
+/**
+ * Settings Types for omi-neuron-web
+ * Complete configuration schema for the library
+ */
+
+/**
+ * Embedding model options
+ */
+type EmbeddingModel = 'text-embedding-ada-002' | 'text-embedding-3-small' | 'text-embedding-3-large';
+/**
+ * Performance mode for visualization
+ */
+type PerformanceMode = 'auto' | 'normal' | 'degraded' | 'fallback';
+/**
+ * Node type configuration
+ */
+interface NodeTypeConfig {
+    /** Type identifier */
+    type: string;
+    /** Human-readable label */
+    label: string;
+    /** Optional description */
+    description?: string;
+    /** Default domain for this type */
+    defaultDomain: string;
+    /** Icon name or emoji */
+    icon?: string;
+    /** Color hex code */
+    color?: string;
+    /** Custom AI prompt for analyzing this type */
+    analysisPrompt?: string;
+}
+/**
+ * Domain configuration for visualization
+ */
+interface DomainConfig {
+    /** Domain key */
+    key: string;
+    /** Human-readable label */
+    label: string;
+    /** Color hex code */
+    color: string;
+    /** Optional description */
+    description?: string;
+}
+/**
+ * Relationship type configuration
+ */
+interface RelationshipTypeConfig {
+    /** Type identifier */
+    type: string;
+    /** Human-readable label */
+    label: string;
+    /** Optional description */
+    description?: string;
+    /** Whether this type is bidirectional */
+    bidirectional: boolean;
+    /** Optional color hex code */
+    color?: string;
+}
+/**
+ * Visualization settings - all API-modifiable
+ */
+interface VisualizationSettings {
+    /** Domain to color mapping */
+    domainColors: Record<string, string>;
+    /** Default color for unknown domains */
+    defaultDomainColor: string;
+    /** Default edge color */
+    edgeColor: string;
+    /** Active/highlighted edge color */
+    edgeActiveColor: string;
+    /** Scene background color */
+    backgroundColor: string;
+    /** Initial camera position [x, y, z] */
+    defaultCameraPosition: [number, number, number];
+    /** Initial camera target [x, y, z] */
+    defaultCameraTarget: [number, number, number];
+    /** Minimum zoom distance */
+    minZoomDistance: number;
+    /** Maximum zoom distance */
+    maxZoomDistance: number;
+    /** Enable starfield background */
+    enableStarfield: boolean;
+    /** Number of stars in starfield */
+    starfieldCount: number;
+    /** Distance at which labels appear */
+    labelDistance: number;
+    /** Maximum number of visible labels */
+    maxVisibleLabels: number;
+    /** Performance mode selection */
+    performanceMode: PerformanceMode;
+    /** Node count threshold for degraded mode */
+    nodeCountThreshold: number;
+    /** Maximum device pixel ratio */
+    pixelRatioCap: number;
+    /** Enable animations */
+    enableAnimations: boolean;
+    /** Focus tween duration in ms */
+    focusTweenDuration: number;
+    /** Filter transition duration in ms */
+    filterTransitionDuration: number;
+    /** Enable hover effects */
+    enableHover: boolean;
+    /** Enable click handling */
+    enableClick: boolean;
+    /** Enable double-click handling */
+    enableDoubleClick: boolean;
+    /** Enable panning */
+    enablePan: boolean;
+    /** Enable zooming */
+    enableZoom: boolean;
+    /** Enable rotation */
+    enableRotate: boolean;
+}
+/**
+ * Analysis settings
+ */
+interface AnalysisSettings {
+    /** OpenAI embedding model */
+    embeddingModel: EmbeddingModel;
+    /** Embedding dimensions (must match model) */
+    embeddingDimensions: number;
+    /** Batch size for API calls */
+    embeddingBatchSize: number;
+    /** Cache TTL in seconds */
+    embeddingCacheTTL: number;
+    /** Clustering algorithm */
+    clusteringAlgorithm: ClusteringAlgorithm;
+    /** Default number of clusters */
+    defaultClusterCount: number;
+    /** Minimum cluster size */
+    minClusterSize: number;
+    /** Similarity threshold for cluster assignment */
+    clusterSimilarityThreshold: number;
+    /** Model for relationship inference */
+    relationshipInferenceModel: string;
+    /** Minimum confidence to create relationship */
+    relationshipMinConfidence: number;
+    /** Maximum relationships per node */
+    relationshipMaxPerNode: number;
+    /** OpenAI requests per minute */
+    openaiRateLimit: number;
+    /** Maximum concurrent analysis jobs */
+    maxConcurrentAnalysis: number;
+}
+/**
+ * Instance settings
+ */
+interface InstanceSettings {
+    /** Human-readable instance name */
+    name: string;
+    /** Library version */
+    version: string;
+    /** Used for pg-{repoName} database naming */
+    repoName: string;
+}
+/**
+ * Database settings
+ */
+interface DatabaseSettings {
+    /** 'docker' for managed, 'external' for BYO */
+    mode: 'docker' | 'external';
+    /** Port to expose (Docker mode) */
+    port: number;
+    /** Container name override */
+    containerName?: string;
+    /** Docker image */
+    image?: string;
+    /** Database user */
+    user?: string;
+    /** Database password */
+    password?: string;
+    /** Database name */
+    database?: string;
+    /** Connection URL (external mode) */
+    url?: string;
+    /** Connection pool settings */
+    pool?: {
+        min: number;
+        max: number;
+        idleTimeoutMs: number;
+        connectionTimeoutMs: number;
+    };
+    /** Resource limits (Docker mode) */
+    resources?: {
+        memoryLimit: string;
+        cpuLimit?: string;
+    };
+}
+/**
+ * API settings
+ */
+interface ApiSettings {
+    /** Base path for API routes */
+    basePath: string;
+    /** Enable CORS */
+    enableCors: boolean;
+    /** Rate limiting configuration */
+    rateLimit?: {
+        windowMs: number;
+        max: number;
+    };
+}
+/**
+ * Logging settings
+ */
+interface LoggingSettings {
+    /** Log level */
+    level: 'debug' | 'info' | 'warn' | 'error';
+    /** Pretty print logs */
+    prettyPrint: boolean;
+}
+/**
+ * Complete settings schema - stored in database and repo config
+ */
+interface NeuronSettings {
+    /** Instance identification */
+    instance: InstanceSettings;
+    /** Visualization settings (API-modifiable) */
+    visualization: VisualizationSettings;
+    /** Analysis settings */
+    analysis: AnalysisSettings;
+    /** Node type configuration */
+    nodeTypes: NodeTypeConfig[];
+    /** Domain configuration */
+    domains: DomainConfig[];
+    /** Relationship type configuration */
+    relationshipTypes: RelationshipTypeConfig[];
+}
+/**
+ * Full configuration including non-runtime settings
+ */
+interface NeuronConfig extends NeuronSettings {
+    /** OpenAI configuration */
+    openai: {
+        apiKey: string;
+        organization?: string;
+        requestsPerMinute?: number;
+        maxRetries?: number;
+    };
+    /** Database configuration */
+    database: DatabaseSettings;
+    /** API configuration */
+    api: ApiSettings;
+    /** Logging configuration */
+    logging: LoggingSettings;
+}
+/**
+ * Partial settings for updates
+ */
+interface NeuronSettingsUpdate {
+    visualization?: Partial<VisualizationSettings>;
+    analysis?: Partial<AnalysisSettings>;
+    nodeTypes?: NodeTypeConfig[];
+    domains?: DomainConfig[];
+    relationshipTypes?: RelationshipTypeConfig[];
+}
+/**
+ * Default visualization settings
+ */
+declare const DEFAULT_VISUALIZATION_SETTINGS: VisualizationSettings;
+/**
+ * Default analysis settings
+ */
+declare const DEFAULT_ANALYSIS_SETTINGS: AnalysisSettings;
+
+/**
+ * API Types for omi-neuron-web
+ * Request and response types for all API endpoints
+ */
+
+interface PaginationParams {
+    page?: number;
+    limit?: number;
+}
+interface PaginationMeta {
+    page: number;
+    limit: number;
+    total: number;
+    totalPages: number;
+    hasNext: boolean;
+    hasPrev: boolean;
+}
+interface GraphFilters {
+    domains?: string[];
+    nodeTypes?: string[];
+    search?: string;
+}
+interface ListNodesParams extends PaginationParams {
+    nodeType?: string | string[];
+    domain?: string | string[];
+    clusterId?: string;
+    analysisStatus?: string;
+    search?: string;
+    sortBy?: 'createdAt' | 'updatedAt' | 'label' | 'connectionCount';
+    sortOrder?: 'asc' | 'desc';
+    includeEmbeddings?: boolean;
+    includeStats?: boolean;
+}
+interface ListNodesResponse {
+    nodes: NeuronNode[];
+    pagination: PaginationMeta;
+    meta: {
+        queryTime: number;
+        filters: Record<string, unknown>;
+    };
+}
+interface CreateNodesRequest {
+    nodes: NeuronNodeCreate[];
+    options?: {
+        skipDuplicates?: boolean;
+        updateOnConflict?: boolean;
+        autoAnalyze?: boolean;
+        analysisDepth?: 'embeddings' | 'cluster' | 'full';
+    };
+}
+interface CreateNodesResponse {
+    created: NeuronNode[];
+    skipped: Array<{
+        slug: string;
+        reason: string;
+    }>;
+    analysisJobId?: string;
+}
+interface GetNodeResponse {
+    node: NeuronNode;
+    edges: {
+        outbound: NeuronEdge[];
+        inbound: NeuronEdge[];
+    };
+    cluster?: NeuronCluster | null;
+    relatedNodes: NeuronNode[];
+}
+interface UpdateNodeRequest extends NeuronNodeUpdate {
+}
+interface DeleteNodeResponse {
+    deleted: boolean;
+    edgesRemoved: number;
+}
+interface ListEdgesParams extends PaginationParams {
+    fromNodeId?: string;
+    toNodeId?: string;
+    nodeId?: string;
+    relationshipType?: string | string[];
+    source?: 'manual' | 'ai_inferred' | 'imported';
+    minStrength?: number;
+    minConfidence?: number;
+}
+interface ListEdgesResponse {
+    edges: NeuronEdge[];
+    pagination: PaginationMeta;
+}
+interface CreateEdgesRequest {
+    edges: NeuronEdgeCreate[];
+}
+interface CreateEdgesResponse {
+    created: NeuronEdge[];
+    errors: Array<{
+        index: number;
+        error: string;
+    }>;
+}
+interface UpdateEdgeRequest extends NeuronEdgeUpdate {
+}
+interface DeleteEdgeResponse {
+    deleted: boolean;
+}
+interface GetGraphParams {
+    nodeTypes?: string[];
+    domains?: string[];
+    clusterIds?: string[];
+    nodeIds?: string[];
+    depth?: number;
+    minEdgeStrength?: number;
+    relationshipTypes?: string[];
+    maxNodes?: number;
+    includeOrphanNodes?: boolean;
+}
+interface GetGraphResponse {
+    nodes: NeuronVisualNode[];
+    edges: NeuronVisualEdge[];
+    clusters: NeuronVisualCluster[];
+    meta: {
+        totalNodes: number;
+        totalEdges: number;
+        truncated: boolean;
+        queryTime: number;
+    };
+}
+interface ExpandGraphRequest {
+    fromNodeIds: string[];
+    depth: number;
+    direction: 'outbound' | 'inbound' | 'both';
+    maxNodes?: number;
+}
+interface ExpandGraphResponse {
+    nodes: NeuronVisualNode[];
+    edges: NeuronVisualEdge[];
+}
+interface FindPathRequest {
+    fromNodeId: string;
+    toNodeId: string;
+    maxDepth?: number;
+    algorithm?: 'shortest' | 'all';
+}
+interface FindPathResponse {
+    paths: Array<{
+        nodes: string[];
+        edges: string[];
+        length: number;
+        totalStrength: number;
+    }>;
+}
+
+interface GetAnalysisJobResponse {
+    job: AnalysisRun;
+}
+interface CancelAnalysisResponse {
+    cancelled: boolean;
+}
+interface SemanticSearchRequest {
+    query: string;
+    nodeTypes?: string[];
+    domains?: string[];
+    limit?: number;
+    minSimilarity?: number;
+    includeExplanation?: boolean;
+}
+interface SemanticSearchOptions {
+    nodeTypes?: string[];
+    domains?: string[];
+    limit?: number;
+    minSimilarity?: number;
+    includeExplanation?: boolean;
+}
+interface SemanticSearchResponse {
+    results: Array<{
+        node: NeuronNode;
+        similarity: number;
+        explanation?: string;
+    }>;
+    queryEmbedding?: number[];
+    queryTime: number;
+}
+interface SearchResult {
+    node: NeuronNode;
+    similarity: number;
+    explanation?: string;
+}
+interface FindSimilarRequest {
+    nodeId: string;
+    limit?: number;
+    minSimilarity?: number;
+    excludeConnected?: boolean;
+}
+interface FindSimilarOptions {
+    limit?: number;
+    minSimilarity?: number;
+    excludeConnected?: boolean;
+}
+interface FindSimilarResponse {
+    results: Array<{
+        node: NeuronNode;
+        similarity: number;
+    }>;
+}
+interface GetSettingsResponse {
+    settings: NeuronSettings;
+    source: 'database' | 'config_file' | 'defaults';
+}
+interface UpdateSettingsRequest extends NeuronSettingsUpdate {
+}
+interface UpdateSettingsResponse {
+    settings: NeuronSettings;
+}
+interface ResetSettingsRequest {
+    sections?: Array<'visualization' | 'analysis' | 'nodeTypes' | 'domains' | 'relationshipTypes'>;
+}
+interface ResetSettingsResponse {
+    settings: NeuronSettings;
+}
+interface ApiErrorResponse {
+    error: string;
+    code: string;
+    details?: Record<string, unknown>;
+    statusCode: number;
+}
+interface HealthCheckResponse {
+    status: 'healthy' | 'degraded' | 'unhealthy';
+    version: string;
+    database: {
+        connected: boolean;
+        latencyMs?: number;
+    };
+    services: {
+        openai: boolean;
+        docker: boolean;
+    };
+}
+
+type WhereClause = Record<string, unknown>;
+interface SelectOptions {
+    limit?: number;
+    offset?: number;
+    orderBy?: string;
+    orderDirection?: 'asc' | 'desc';
+}
+declare const buildWhereClause: (where?: WhereClause, startIndex?: number) => {
+    clause: string;
+    values: unknown[];
+    nextIndex: number;
+};
+declare const buildInsert: (table: string, data: Record<string, unknown>) => {
+    sql: string;
+    values: unknown[];
+};
+declare const buildUpdate: (table: string, data: Record<string, unknown>, where: WhereClause) => {
+    sql: string;
+    values: unknown[];
+};
+declare const buildSelect: (table: string, columns: string[] | "*", where?: WhereClause, options?: SelectOptions) => {
+    sql: string;
+    values: unknown[];
+};
+declare const buildDelete: (table: string, where: WhereClause) => {
+    sql: string;
+    values: unknown[];
+};
+
+export { type ClusteringConfig as $, type AnalysisRun as A, type FindSimilarOptions as B, type CreateNodesRequest as C, type DeleteNodeResponse as D, type ExpandGraphRequest as E, type FindPathRequest as F, type GetGraphParams as G, type FindSimilarResponse as H, type GetSettingsResponse as I, type UpdateSettingsRequest as J, type UpdateSettingsResponse as K, type ListNodesParams as L, type ResetSettingsResponse as M, type NeuronConfig as N, type ApiErrorResponse as O, type PaginationParams as P, type HealthCheckResponse as Q, type ResetSettingsRequest as R, type SelectOptions as S, type ClusterMembership as T, type UpdateNodeRequest as U, type ClusteringAlgorithm as V, type WhereClause as W, type NeuronVisualCluster as X, type VisualizationSettings as Y, type NeuronClusterCreate as Z, type NeuronClusterUpdate as _, type NeuronCluster as a, type AnalysisRunType as a0, type AnalysisJobStatus as a1, type InferredRelationshipResult as a2, type EmbeddingResult as a3, type ClusteringResult as a4, type AnalysisPipelineConfig as a5, type EmbeddingModel as a6, type PerformanceMode as a7, type NodeTypeConfig as a8, type DomainConfig as a9, type RelationshipTypeConfig as aa, type AnalysisSettings as ab, type InstanceSettings as ac, type DatabaseSettings as ad, type ApiSettings as ae, type LoggingSettings as af, DEFAULT_VISUALIZATION_SETTINGS as ag, DEFAULT_ANALYSIS_SETTINGS as ah, buildWhereClause as ai, buildInsert as aj, buildUpdate as ak, buildSelect as al, buildDelete as am, type NeuronSettings as b, type NeuronSettingsUpdate as c, type GetGraphResponse as d, type ExpandGraphResponse as e, type FindPathResponse as f, type AnalysisRequest as g, type AnalysisResponse as h, type PaginationMeta as i, type GraphFilters as j, type ListNodesResponse as k, type CreateNodesResponse as l, type GetNodeResponse as m, type ListEdgesParams as n, type ListEdgesResponse as o, type CreateEdgesRequest as p, type CreateEdgesResponse as q, type UpdateEdgeRequest as r, type DeleteEdgeResponse as s, type GetAnalysisJobResponse as t, type CancelAnalysisResponse as u, type SemanticSearchRequest as v, type SemanticSearchOptions as w, type SemanticSearchResponse as x, type SearchResult as y, type FindSimilarRequest as z };