@omiron33/omi-neuron-web 0.1.0

package/dist/database-B0vplyA4.d.cts

@@ -0,0 +1,41 @@
+import { PoolClient } from 'pg';
+
+interface DatabaseConfig {
+    connectionString?: string;
+    host?: string;
+    port?: number;
+    user?: string;
+    password?: string;
+    database?: string;
+    pool?: {
+        min: number;
+        max: number;
+        idleTimeoutMs: number;
+        connectionTimeoutMs: number;
+    };
+    ssl?: boolean | object;
+    slowQueryThresholdMs?: number;
+}
+interface PoolStats {
+    totalCount: number;
+    idleCount: number;
+    waitingCount: number;
+}
+declare class Database {
+    private pool;
+    private slowQueryThresholdMs?;
+    constructor(config: DatabaseConfig);
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    isConnected(): Promise<boolean>;
+    query<T>(sql: string, params?: unknown[]): Promise<T[]>;
+    queryOne<T>(sql: string, params?: unknown[]): Promise<T | null>;
+    execute(sql: string, params?: unknown[]): Promise<number>;
+    transaction<T>(fn: (client: PoolClient) => Promise<T>): Promise<T>;
+    tableExists(tableName: string): Promise<boolean>;
+    getPoolStats(): Promise<PoolStats>;
+    private buildConnectionString;
+    private logSlowQuery;
+}
+
+export { Database as D, type PoolStats as P, type DatabaseConfig as a };

package/dist/database-B0vplyA4.d.ts

@@ -0,0 +1,41 @@
+import { PoolClient } from 'pg';
+
+interface DatabaseConfig {
+    connectionString?: string;
+    host?: string;
+    port?: number;
+    user?: string;
+    password?: string;
+    database?: string;
+    pool?: {
+        min: number;
+        max: number;
+        idleTimeoutMs: number;
+        connectionTimeoutMs: number;
+    };
+    ssl?: boolean | object;
+    slowQueryThresholdMs?: number;
+}
+interface PoolStats {
+    totalCount: number;
+    idleCount: number;
+    waitingCount: number;
+}
+declare class Database {
+    private pool;
+    private slowQueryThresholdMs?;
+    constructor(config: DatabaseConfig);
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    isConnected(): Promise<boolean>;
+    query<T>(sql: string, params?: unknown[]): Promise<T[]>;
+    queryOne<T>(sql: string, params?: unknown[]): Promise<T | null>;
+    execute(sql: string, params?: unknown[]): Promise<number>;
+    transaction<T>(fn: (client: PoolClient) => Promise<T>): Promise<T>;
+    tableExists(tableName: string): Promise<boolean>;
+    getPoolStats(): Promise<PoolStats>;
+    private buildConnectionString;
+    private logSlowQuery;
+}
+
+export { Database as D, type PoolStats as P, type DatabaseConfig as a };

package/dist/edge-BzsYe2Ed.d.cts

@@ -0,0 +1,269 @@
+/**
+ * Node Types for omi-neuron-web
+ * Defines the core data structures for nodes in the neuron web graph
+ */
+/**
+ * Node tier - affects visual prominence and analysis priority
+ */
+type NodeTier = 'primary' | 'secondary' | 'tertiary' | 'insight';
+/**
+ * Analysis status for tracking node processing state
+ */
+type AnalysisStatus = 'pending' | 'processing' | 'complete' | 'failed';
+/**
+ * Base node interface - all nodes in the system extend this
+ * Kept minimal to allow maximum flexibility in consuming apps
+ */
+interface NeuronNodeBase {
+    /** UUID v4 identifier */
+    id: string;
+    /** URL-safe unique identifier */
+    slug: string;
+    /** Human-readable display name */
+    label: string;
+    /** Configurable node type per instance */
+    nodeType: string;
+    /** Category/grouping for visualization */
+    domain: string;
+    /** Creation timestamp */
+    createdAt: Date;
+    /** Last update timestamp */
+    updatedAt: Date;
+}
+/**
+ * Extended node with all optional analysis fields
+ */
+interface NeuronNode extends NeuronNodeBase {
+    /** AI-generated or manual summary */
+    summary?: string | null;
+    /** Longer form description */
+    description?: string | null;
+    /** Full content for analysis source */
+    content?: string | null;
+    metadata: Record<string, unknown>;
+    /** OpenAI embedding vector (1536 dimensions for ada-002) */
+    embedding?: number[] | null;
+    /** Model used for embedding generation */
+    embeddingModel?: string | null;
+    /** When embedding was generated */
+    embeddingGeneratedAt?: Date | null;
+    /** ID of the cluster this node belongs to */
+    clusterId?: string | null;
+    /** Similarity score to cluster centroid (0-1) */
+    clusterSimilarity?: number | null;
+    /** Total edge count */
+    connectionCount?: number;
+    /** Inbound edge count */
+    inboundCount?: number;
+    /** Outbound edge count */
+    outboundCount?: number;
+    /** Current analysis processing status */
+    analysisStatus?: AnalysisStatus;
+    /** Error message if analysis failed */
+    analysisError?: string | null;
+    /** Node importance tier */
+    tier?: NodeTier;
+    /** Visual priority (0-100), affects render order */
+    visualPriority?: number;
+    /** Manual position override [x, y, z] */
+    positionOverride?: [number, number, number] | null;
+}
+/**
+ * Input type for creating nodes - minimal required fields
+ */
+interface NeuronNodeCreate {
+    /** Auto-generated from label if not provided */
+    slug?: string;
+    /** Required: human-readable label */
+    label: string;
+    /** Defaults to config.defaultNodeType */
+    nodeType?: string;
+    /** Defaults to config.defaultDomain */
+    domain?: string;
+    /** Optional summary */
+    summary?: string;
+    /** Optional description */
+    description?: string;
+    /** Optional full content for analysis */
+    content?: string;
+    /** Optional metadata */
+    metadata?: Record<string, unknown>;
+    /** Optional tier */
+    tier?: NodeTier;
+}
+/**
+ * Input type for updating nodes
+ */
+interface NeuronNodeUpdate {
+    label?: string;
+    summary?: string;
+    description?: string;
+    content?: string;
+    metadata?: Record<string, unknown>;
+    domain?: string;
+    tier?: NodeTier;
+    positionOverride?: [number, number, number] | null;
+}
+/**
+ * Batch input for ingesting multiple nodes
+ */
+interface NeuronNodeBatchCreate {
+    nodes: NeuronNodeCreate[];
+    options?: {
+        /** Skip if slug exists */
+        skipDuplicates?: boolean;
+        /** Update existing on slug conflict */
+        updateOnConflict?: boolean;
+        /** Trigger analysis after insert */
+        autoAnalyze?: boolean;
+        /** Depth of analysis to trigger */
+        analysisDepth?: 'embeddings' | 'cluster' | 'full';
+    };
+}
+/**
+ * Visual node representation for Three.js rendering
+ */
+interface NeuronVisualNode {
+    id: string;
+    slug: string;
+    label: string;
+    domain: string;
+    tier?: NodeTier;
+    metadata: Record<string, unknown>;
+    /** Reference string (e.g., scripture reference, citation) */
+    ref?: string | null;
+    connectionCount: number;
+    /** Optional position override */
+    position?: [number, number, number];
+}
+
+/**
+ * Edge Types for omi-neuron-web
+ * Defines relationships between nodes in the graph
+ */
+/**
+ * Built-in relationship types - configurable but with sensible defaults
+ */
+type BuiltInRelationshipType = 'related_to' | 'derives_from' | 'contradicts' | 'supports' | 'references' | 'part_of' | 'leads_to' | 'similar_to';
+/**
+ * Relationship type - built-in or custom string
+ */
+type RelationshipType = BuiltInRelationshipType | string;
+/**
+ * Source of the edge - how it was created
+ */
+type EdgeSource = 'manual' | 'ai_inferred' | 'imported';
+/**
+ * Edge evidence - supporting data for relationship
+ */
+interface EdgeEvidence {
+    /** Type of evidence */
+    type: 'text' | 'url' | 'citation' | 'ai_inference';
+    /** Evidence content */
+    content: string;
+    /** Confidence score for AI inferences (0-1) */
+    confidence?: number;
+    /** Reference to external source */
+    sourceId?: string;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Complete edge definition
+ */
+interface NeuronEdge {
+    /** UUID v4 identifier */
+    id: string;
+    /** Source node ID */
+    fromNodeId: string;
+    /** Target node ID */
+    toNodeId: string;
+    /** Type of relationship */
+    relationshipType: RelationshipType;
+    /** Relationship strength (0-1), affects visual prominence */
+    strength: number;
+    /** Confidence level (0-1), how certain is this relationship */
+    confidence: number;
+    /** Array of evidence items */
+    evidence: EdgeEvidence[];
+    /** Optional display label */
+    label?: string | null;
+    /** Optional description */
+    description?: string | null;
+    /** Additional metadata */
+    metadata: Record<string, unknown>;
+    /** How this edge was created */
+    source: EdgeSource;
+    /** AI model used if inferred */
+    sourceModel?: string | null;
+    /** Creation timestamp */
+    createdAt: Date;
+    /** Last update timestamp */
+    updatedAt: Date;
+    /** If true, renders both directions */
+    bidirectional: boolean;
+}
+/**
+ * Input for creating edges
+ */
+interface NeuronEdgeCreate {
+    /** Source node ID */
+    fromNodeId: string;
+    /** Target node ID */
+    toNodeId: string;
+    /** Defaults to 'related_to' */
+    relationshipType?: RelationshipType;
+    /** Defaults to 0.5 */
+    strength?: number;
+    /** Defaults to 1.0 for manual edges */
+    confidence?: number;
+    /** Supporting evidence */
+    evidence?: EdgeEvidence[];
+    /** Display label */
+    label?: string;
+    /** Description */
+    description?: string;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+    /** Defaults to false */
+    bidirectional?: boolean;
+}
+/**
+ * Input for updating edges
+ */
+interface NeuronEdgeUpdate {
+    strength?: number;
+    confidence?: number;
+    relationshipType?: RelationshipType;
+    label?: string;
+    description?: string;
+    evidence?: EdgeEvidence[];
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Visual edge representation for Three.js rendering
+ */
+interface NeuronVisualEdge {
+    id: string;
+    /** Source node slug */
+    from: string;
+    /** Target node slug */
+    to: string;
+    relationshipType: string;
+    strength: number;
+    label?: string | null;
+}
+/**
+ * Inferred relationship result from AI analysis
+ */
+interface InferredRelationship {
+    fromNodeId: string;
+    toNodeId: string;
+    confidence: number;
+    /** AI explanation for the inference */
+    reasoning: string;
+    suggestedType: RelationshipType;
+    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, NeuronNodeCreate as d, NeuronNodeUpdate as e, NeuronEdgeCreate as f, NeuronEdgeUpdate as g, NodeTier as h, NeuronNodeBase as i, NeuronNodeBatchCreate as j, EdgeSource as k };

package/dist/edge-BzsYe2Ed.d.ts

@@ -0,0 +1,269 @@
+/**
+ * Node Types for omi-neuron-web
+ * Defines the core data structures for nodes in the neuron web graph
+ */
+/**
+ * Node tier - affects visual prominence and analysis priority
+ */
+type NodeTier = 'primary' | 'secondary' | 'tertiary' | 'insight';
+/**
+ * Analysis status for tracking node processing state
+ */
+type AnalysisStatus = 'pending' | 'processing' | 'complete' | 'failed';
+/**
+ * Base node interface - all nodes in the system extend this
+ * Kept minimal to allow maximum flexibility in consuming apps
+ */
+interface NeuronNodeBase {
+    /** UUID v4 identifier */
+    id: string;
+    /** URL-safe unique identifier */
+    slug: string;
+    /** Human-readable display name */
+    label: string;
+    /** Configurable node type per instance */
+    nodeType: string;
+    /** Category/grouping for visualization */
+    domain: string;
+    /** Creation timestamp */
+    createdAt: Date;
+    /** Last update timestamp */
+    updatedAt: Date;
+}
+/**
+ * Extended node with all optional analysis fields
+ */
+interface NeuronNode extends NeuronNodeBase {
+    /** AI-generated or manual summary */
+    summary?: string | null;
+    /** Longer form description */
+    description?: string | null;
+    /** Full content for analysis source */
+    content?: string | null;
+    metadata: Record<string, unknown>;
+    /** OpenAI embedding vector (1536 dimensions for ada-002) */
+    embedding?: number[] | null;
+    /** Model used for embedding generation */
+    embeddingModel?: string | null;
+    /** When embedding was generated */
+    embeddingGeneratedAt?: Date | null;
+    /** ID of the cluster this node belongs to */
+    clusterId?: string | null;
+    /** Similarity score to cluster centroid (0-1) */
+    clusterSimilarity?: number | null;
+    /** Total edge count */
+    connectionCount?: number;
+    /** Inbound edge count */
+    inboundCount?: number;
+    /** Outbound edge count */
+    outboundCount?: number;
+    /** Current analysis processing status */
+    analysisStatus?: AnalysisStatus;
+    /** Error message if analysis failed */
+    analysisError?: string | null;
+    /** Node importance tier */
+    tier?: NodeTier;
+    /** Visual priority (0-100), affects render order */
+    visualPriority?: number;
+    /** Manual position override [x, y, z] */
+    positionOverride?: [number, number, number] | null;
+}
+/**
+ * Input type for creating nodes - minimal required fields
+ */
+interface NeuronNodeCreate {
+    /** Auto-generated from label if not provided */
+    slug?: string;
+    /** Required: human-readable label */
+    label: string;
+    /** Defaults to config.defaultNodeType */
+    nodeType?: string;
+    /** Defaults to config.defaultDomain */
+    domain?: string;
+    /** Optional summary */
+    summary?: string;
+    /** Optional description */
+    description?: string;
+    /** Optional full content for analysis */
+    content?: string;
+    /** Optional metadata */
+    metadata?: Record<string, unknown>;
+    /** Optional tier */
+    tier?: NodeTier;
+}
+/**
+ * Input type for updating nodes
+ */
+interface NeuronNodeUpdate {
+    label?: string;
+    summary?: string;
+    description?: string;
+    content?: string;
+    metadata?: Record<string, unknown>;
+    domain?: string;
+    tier?: NodeTier;
+    positionOverride?: [number, number, number] | null;
+}
+/**
+ * Batch input for ingesting multiple nodes
+ */
+interface NeuronNodeBatchCreate {
+    nodes: NeuronNodeCreate[];
+    options?: {
+        /** Skip if slug exists */
+        skipDuplicates?: boolean;
+        /** Update existing on slug conflict */
+        updateOnConflict?: boolean;
+        /** Trigger analysis after insert */
+        autoAnalyze?: boolean;
+        /** Depth of analysis to trigger */
+        analysisDepth?: 'embeddings' | 'cluster' | 'full';
+    };
+}
+/**
+ * Visual node representation for Three.js rendering
+ */
+interface NeuronVisualNode {
+    id: string;
+    slug: string;
+    label: string;
+    domain: string;
+    tier?: NodeTier;
+    metadata: Record<string, unknown>;
+    /** Reference string (e.g., scripture reference, citation) */
+    ref?: string | null;
+    connectionCount: number;
+    /** Optional position override */
+    position?: [number, number, number];
+}
+
+/**
+ * Edge Types for omi-neuron-web
+ * Defines relationships between nodes in the graph
+ */
+/**
+ * Built-in relationship types - configurable but with sensible defaults
+ */
+type BuiltInRelationshipType = 'related_to' | 'derives_from' | 'contradicts' | 'supports' | 'references' | 'part_of' | 'leads_to' | 'similar_to';
+/**
+ * Relationship type - built-in or custom string
+ */
+type RelationshipType = BuiltInRelationshipType | string;
+/**
+ * Source of the edge - how it was created
+ */
+type EdgeSource = 'manual' | 'ai_inferred' | 'imported';
+/**
+ * Edge evidence - supporting data for relationship
+ */
+interface EdgeEvidence {
+    /** Type of evidence */
+    type: 'text' | 'url' | 'citation' | 'ai_inference';
+    /** Evidence content */
+    content: string;
+    /** Confidence score for AI inferences (0-1) */
+    confidence?: number;
+    /** Reference to external source */
+    sourceId?: string;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Complete edge definition
+ */
+interface NeuronEdge {
+    /** UUID v4 identifier */
+    id: string;
+    /** Source node ID */
+    fromNodeId: string;
+    /** Target node ID */
+    toNodeId: string;
+    /** Type of relationship */
+    relationshipType: RelationshipType;
+    /** Relationship strength (0-1), affects visual prominence */
+    strength: number;
+    /** Confidence level (0-1), how certain is this relationship */
+    confidence: number;
+    /** Array of evidence items */
+    evidence: EdgeEvidence[];
+    /** Optional display label */
+    label?: string | null;
+    /** Optional description */
+    description?: string | null;
+    /** Additional metadata */
+    metadata: Record<string, unknown>;
+    /** How this edge was created */
+    source: EdgeSource;
+    /** AI model used if inferred */
+    sourceModel?: string | null;
+    /** Creation timestamp */
+    createdAt: Date;
+    /** Last update timestamp */
+    updatedAt: Date;
+    /** If true, renders both directions */
+    bidirectional: boolean;
+}
+/**
+ * Input for creating edges
+ */
+interface NeuronEdgeCreate {
+    /** Source node ID */
+    fromNodeId: string;
+    /** Target node ID */
+    toNodeId: string;
+    /** Defaults to 'related_to' */
+    relationshipType?: RelationshipType;
+    /** Defaults to 0.5 */
+    strength?: number;
+    /** Defaults to 1.0 for manual edges */
+    confidence?: number;
+    /** Supporting evidence */
+    evidence?: EdgeEvidence[];
+    /** Display label */
+    label?: string;
+    /** Description */
+    description?: string;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+    /** Defaults to false */
+    bidirectional?: boolean;
+}
+/**
+ * Input for updating edges
+ */
+interface NeuronEdgeUpdate {
+    strength?: number;
+    confidence?: number;
+    relationshipType?: RelationshipType;
+    label?: string;
+    description?: string;
+    evidence?: EdgeEvidence[];
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Visual edge representation for Three.js rendering
+ */
+interface NeuronVisualEdge {
+    id: string;
+    /** Source node slug */
+    from: string;
+    /** Target node slug */
+    to: string;
+    relationshipType: string;
+    strength: number;
+    label?: string | null;
+}
+/**
+ * Inferred relationship result from AI analysis
+ */
+interface InferredRelationship {
+    fromNodeId: string;
+    toNodeId: string;
+    confidence: number;
+    /** AI explanation for the inference */
+    reasoning: string;
+    suggestedType: RelationshipType;
+    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, NeuronNodeCreate as d, NeuronNodeUpdate as e, NeuronEdgeCreate as f, NeuronEdgeUpdate as g, NodeTier as h, NeuronNodeBase as i, NeuronNodeBatchCreate as j, EdgeSource as k };