@omiron33/omi-neuron-web 0.2.21 → 0.2.23

package/dist/{edge-U2Qgwg-K.d.cts → cluster-CU_pBUcK.d.cts}

@@ -10,6 +10,11 @@ type NodeTier = 'primary' | 'secondary' | 'tertiary' | 'insight';
  * Analysis status for tracking node processing state
  */
 type AnalysisStatus = 'pending' | 'processing' | 'complete' | 'failed';
+/**
+ * Workflow status for color coding nodes in static/authored graphs
+ * Used for quest systems, kanban boards, pipelines, etc.
+ */
+type NodeStatus = 'default' | 'draft' | 'active' | 'complete' | 'blocked' | 'archived';
 /**
  * Base node interface - all nodes in the system extend this
  * Kept minimal to allow maximum flexibility in consuming apps
@@ -67,6 +72,8 @@ interface NeuronNode extends NeuronNodeBase {
     visualPriority?: number;
     /** Manual position override [x, y, z] */
     positionOverride?: [number, number, number] | null;
+    /** Workflow status for color coding */
+    status?: NodeStatus;
 }
 /**
  * Input type for creating nodes - minimal required fields
@@ -90,6 +97,8 @@ interface NeuronNodeCreate {
     metadata?: Record<string, unknown>;
     /** Optional tier */
     tier?: NodeTier;
+    /** Optional workflow status */
+    status?: NodeStatus;
 }
 /**
  * Input type for updating nodes
@@ -135,6 +144,8 @@ interface NeuronVisualNode {
     connectionCount: number;
     /** Optional position override */
     position?: [number, number, number];
+    /** Workflow status for color coding */
+    status?: NodeStatus;
 }
 
 /**
@@ -266,4 +277,115 @@ interface InferredRelationship {
     evidence: EdgeEvidence[];
 }
 
-export type { AnalysisStatus as A, BuiltInRelationshipType as B, EdgeEvidence as E, InferredRelationship as I, NeuronVisualNode as N, RelationshipType as R, NeuronVisualEdge as a, NeuronNode as b, NeuronEdge as c, NodeTier as d, NeuronNodeCreate as e, NeuronNodeUpdate as f, NeuronEdgeCreate as g, NeuronEdgeUpdate as h, NeuronNodeBase as i, NeuronNodeBatchCreate as j, EdgeSource as k };
+/**
+ * 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
+ * Used for static/authored clusters with explicit membership
+ */
+interface NeuronVisualCluster {
+    id: string;
+    label: string;
+    /** Explicit list of node IDs in this cluster */
+    nodeIds: string[];
+    /** Optional color override (CSS color string) */
+    color?: string;
+    /** Optional fixed center position for the cluster */
+    position?: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    /** Optional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * 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;
+}
+
+export type { AnalysisStatus as A, BuiltInRelationshipType as B, ClusteringAlgorithm as C, EdgeEvidence as E, InferredRelationship as I, NeuronVisualNode as N, RelationshipType as R, NeuronVisualEdge as a, NeuronVisualCluster as b, NeuronNode as c, NeuronEdge as d, NodeStatus as e, NodeTier as f, NeuronNodeCreate as g, NeuronCluster as h, NeuronNodeUpdate as i, NeuronEdgeCreate as j, NeuronEdgeUpdate as k, ClusterMembership as l, NeuronNodeBase as m, NeuronNodeBatchCreate as n, EdgeSource as o, NeuronClusterCreate as p, NeuronClusterUpdate as q, ClusteringConfig as r };

package/dist/{edge-U2Qgwg-K.d.ts → cluster-CU_pBUcK.d.ts}

@@ -10,6 +10,11 @@ type NodeTier = 'primary' | 'secondary' | 'tertiary' | 'insight';
  * Analysis status for tracking node processing state
  */
 type AnalysisStatus = 'pending' | 'processing' | 'complete' | 'failed';
+/**
+ * Workflow status for color coding nodes in static/authored graphs
+ * Used for quest systems, kanban boards, pipelines, etc.
+ */
+type NodeStatus = 'default' | 'draft' | 'active' | 'complete' | 'blocked' | 'archived';
 /**
  * Base node interface - all nodes in the system extend this
  * Kept minimal to allow maximum flexibility in consuming apps
@@ -67,6 +72,8 @@ interface NeuronNode extends NeuronNodeBase {
     visualPriority?: number;
     /** Manual position override [x, y, z] */
     positionOverride?: [number, number, number] | null;
+    /** Workflow status for color coding */
+    status?: NodeStatus;
 }
 /**
  * Input type for creating nodes - minimal required fields
@@ -90,6 +97,8 @@ interface NeuronNodeCreate {
     metadata?: Record<string, unknown>;
     /** Optional tier */
     tier?: NodeTier;
+    /** Optional workflow status */
+    status?: NodeStatus;
 }
 /**
  * Input type for updating nodes
@@ -135,6 +144,8 @@ interface NeuronVisualNode {
     connectionCount: number;
     /** Optional position override */
     position?: [number, number, number];
+    /** Workflow status for color coding */
+    status?: NodeStatus;
 }
 
 /**
@@ -266,4 +277,115 @@ interface InferredRelationship {
     evidence: EdgeEvidence[];
 }
 
-export type { AnalysisStatus as A, BuiltInRelationshipType as B, EdgeEvidence as E, InferredRelationship as I, NeuronVisualNode as N, RelationshipType as R, NeuronVisualEdge as a, NeuronNode as b, NeuronEdge as c, NodeTier as d, NeuronNodeCreate as e, NeuronNodeUpdate as f, NeuronEdgeCreate as g, NeuronEdgeUpdate as h, NeuronNodeBase as i, NeuronNodeBatchCreate as j, EdgeSource as k };
+/**
+ * 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
+ * Used for static/authored clusters with explicit membership
+ */
+interface NeuronVisualCluster {
+    id: string;
+    label: string;
+    /** Explicit list of node IDs in this cluster */
+    nodeIds: string[];
+    /** Optional color override (CSS color string) */
+    color?: string;
+    /** Optional fixed center position for the cluster */
+    position?: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    /** Optional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * 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;
+}
+
+export type { AnalysisStatus as A, BuiltInRelationshipType as B, ClusteringAlgorithm as C, EdgeEvidence as E, InferredRelationship as I, NeuronVisualNode as N, RelationshipType as R, NeuronVisualEdge as a, NeuronVisualCluster as b, NeuronNode as c, NeuronEdge as d, NodeStatus as e, NodeTier as f, NeuronNodeCreate as g, NeuronCluster as h, NeuronNodeUpdate as i, NeuronEdgeCreate as j, NeuronEdgeUpdate as k, ClusterMembership as l, NeuronNodeBase as m, NeuronNodeBatchCreate as n, EdgeSource as o, NeuronClusterCreate as p, NeuronClusterUpdate as q, ClusteringConfig as r };