@cilow/sdk 0.2.1 → 0.3.0

package/dist/types.d.mts

@@ -1,494 +0,0 @@
-/**
- * Cilow SDK TypeScript Type Definitions
- *
- * Comprehensive type definitions for the Cilow memory system.
- */
-/**
- * Memory tier classification based on access frequency and recency
- */
-type MemoryTier = 'hot' | 'warm' | 'cold';
-/**
- * Memory status for lifecycle management
- */
-type MemoryStatus = 'active' | 'archived' | 'deleted';
-/**
- * Core memory entity representing a stored piece of information
- */
-interface Memory {
-    /** Unique identifier for the memory */
-    id: string;
-    /** The content of the memory */
-    content: string;
-    /** Tags for categorization and filtering */
-    tags: string[];
-    /** User ID associated with this memory */
-    userId?: string;
-    /** Session ID for grouping related memories */
-    sessionId?: string;
-    /** Current tier classification */
-    tier: MemoryTier;
-    /** Memory status */
-    status: MemoryStatus;
-    /** Access count for prioritization */
-    accessCount: number;
-    /** Token count for the content */
-    tokenCount: number;
-    /** Embedding vector (if available) */
-    embedding?: number[];
-    /** Additional metadata */
-    metadata: Record<string, unknown>;
-    /** ISO timestamp of creation */
-    createdAt: string;
-    /** ISO timestamp of last update */
-    updatedAt: string;
-    /** ISO timestamp of last access */
-    lastAccessedAt: string;
-}
-/**
- * Minimal memory representation for list operations
- */
-interface MemorySummary {
-    id: string;
-    content: string;
-    tags: string[];
-    tier: MemoryTier;
-    createdAt: string;
-}
-/**
- * Options for creating a new memory
- */
-interface CreateMemoryOptions {
-    /** Tags to apply to the memory */
-    tags?: string[];
-    /** User ID to associate */
-    userId?: string;
-    /** Session ID for grouping */
-    sessionId?: string;
-    /** Additional metadata */
-    metadata?: Record<string, unknown>;
-    /** Force a specific tier */
-    tier?: MemoryTier;
-}
-/**
- * Options for updating a memory
- */
-interface UpdateMemoryOptions {
-    /** New content */
-    content?: string;
-    /** New tags (replaces existing) */
-    tags?: string[];
-    /** Updated metadata (merged with existing) */
-    metadata?: Record<string, unknown>;
-    /** Force tier change */
-    tier?: MemoryTier;
-}
-/**
- * Search result containing a memory and its relevance score
- */
-interface SearchResult {
-    /** The matching memory */
-    memory: Memory;
-    /** Relevance score (0.0 - 1.0) */
-    score: number;
-    /** Matched terms or phrases */
-    matchedTerms?: string[];
-    /** Highlighted content snippets */
-    highlights?: string[];
-}
-/**
- * Search query parameters
- */
-interface SearchQuery {
-    /** The search text */
-    text: string;
-    /** Maximum number of results */
-    limit?: number;
-    /** Minimum relevance score threshold (0.0 - 1.0) */
-    minRelevance?: number;
-    /** Filter by tags (AND logic) */
-    tags?: string[];
-    /** Filter by user ID */
-    userId?: string;
-    /** Filter by session ID */
-    sessionId?: string;
-    /** Filter by tier */
-    tier?: MemoryTier;
-    /** Filter by date range - start */
-    createdAfter?: string;
-    /** Filter by date range - end */
-    createdBefore?: string;
-    /** Include archived memories */
-    includeArchived?: boolean;
-    /** Search mode */
-    mode?: 'semantic' | 'keyword' | 'hybrid';
-}
-/**
- * Advanced search options for complex queries
- */
-interface AdvancedSearchOptions extends SearchQuery {
-    /** Boost recent memories */
-    recencyBoost?: number;
-    /** Boost frequently accessed memories */
-    frequencyBoost?: number;
-    /** Required tags (must have all) */
-    requiredTags?: string[];
-    /** Excluded tags (must not have any) */
-    excludedTags?: string[];
-    /** Metadata filters */
-    metadataFilters?: Record<string, unknown>;
-    /** Custom reranking function name */
-    reranker?: string;
-}
-/**
- * Node in the memory knowledge graph
- */
-interface GraphNode {
-    /** Unique node identifier */
-    id: string;
-    /** Node type/label */
-    type: string;
-    /** Display name */
-    name: string;
-    /** Node properties */
-    properties: Record<string, unknown>;
-    /** Associated memory IDs */
-    memoryIds: string[];
-    /** Creation timestamp */
-    createdAt: string;
-    /** Last update timestamp */
-    updatedAt: string;
-}
-/**
- * Edge connecting two nodes in the graph
- */
-interface GraphEdge {
-    /** Unique edge identifier */
-    id: string;
-    /** Source node ID */
-    sourceId: string;
-    /** Target node ID */
-    targetId: string;
-    /** Relationship type */
-    type: string;
-    /** Edge weight/strength */
-    weight: number;
-    /** Edge properties */
-    properties: Record<string, unknown>;
-    /** Creation timestamp */
-    createdAt: string;
-}
-/**
- * Subgraph result for graph traversal queries
- */
-interface GraphSubgraph {
-    /** Nodes in the subgraph */
-    nodes: GraphNode[];
-    /** Edges in the subgraph */
-    edges: GraphEdge[];
-    /** Central node ID (if applicable) */
-    centerId?: string;
-}
-/**
- * Options for graph traversal
- */
-interface GraphTraversalOptions {
-    /** Starting node ID */
-    startNodeId: string;
-    /** Maximum traversal depth */
-    maxDepth?: number;
-    /** Filter by relationship types */
-    relationshipTypes?: string[];
-    /** Maximum nodes to return */
-    limit?: number;
-    /** Traversal direction */
-    direction?: 'outbound' | 'inbound' | 'both';
-}
-/**
- * Memory system statistics
- */
-interface MemoryStats {
-    /** Total number of memories */
-    totalMemories: number;
-    /** Number of hot tier memories */
-    hotMemories: number;
-    /** Number of warm tier memories */
-    warmMemories: number;
-    /** Number of cold tier memories */
-    coldMemories: number;
-    /** Total token count across all memories */
-    totalTokens: number;
-    /** Average tokens per memory */
-    averageTokensPerMemory: number;
-    /** Number of unique users */
-    uniqueUsers: number;
-    /** Number of unique sessions */
-    uniqueSessions: number;
-    /** Total number of tags */
-    totalTags: number;
-    /** Storage size in bytes */
-    storageSizeBytes: number;
-    /** Stats generation timestamp */
-    generatedAt: string;
-}
-/**
- * Tag with usage count
- */
-interface TagCount {
-    /** Tag name */
-    tag: string;
-    /** Usage count */
-    count: number;
-}
-/**
- * User activity statistics
- */
-interface UserStats {
-    /** User ID */
-    userId: string;
-    /** Number of memories */
-    memoryCount: number;
-    /** Total tokens used */
-    totalTokens: number;
-    /** Number of sessions */
-    sessionCount: number;
-    /** First activity timestamp */
-    firstActivityAt: string;
-    /** Last activity timestamp */
-    lastActivityAt: string;
-}
-/**
- * Base event type
- */
-interface BaseEvent {
-    /** Event type identifier */
-    type: string;
-    /** Event timestamp */
-    timestamp: string;
-    /** Correlation ID for tracking */
-    correlationId?: string;
-}
-/**
- * Memory created event
- */
-interface MemoryCreatedEvent extends BaseEvent {
-    type: 'memory.created';
-    /** The created memory */
-    memory: Memory;
-}
-/**
- * Memory updated event
- */
-interface MemoryUpdatedEvent extends BaseEvent {
-    type: 'memory.updated';
-    /** The updated memory */
-    memory: Memory;
-    /** Changed fields */
-    changedFields: string[];
-}
-/**
- * Memory deleted event
- */
-interface MemoryDeletedEvent extends BaseEvent {
-    type: 'memory.deleted';
-    /** Deleted memory ID */
-    memoryId: string;
-}
-/**
- * Memory tier changed event
- */
-interface MemoryTierChangedEvent extends BaseEvent {
-    type: 'memory.tier_changed';
-    /** Memory ID */
-    memoryId: string;
-    /** Previous tier */
-    previousTier: MemoryTier;
-    /** New tier */
-    newTier: MemoryTier;
-}
-/**
- * Graph node created event
- */
-interface GraphNodeCreatedEvent extends BaseEvent {
-    type: 'graph.node_created';
-    /** The created node */
-    node: GraphNode;
-}
-/**
- * Graph edge created event
- */
-interface GraphEdgeCreatedEvent extends BaseEvent {
-    type: 'graph.edge_created';
-    /** The created edge */
-    edge: GraphEdge;
-}
-/**
- * Connection status event
- */
-interface ConnectionStatusEvent extends BaseEvent {
-    type: 'connection.status';
-    /** Connection status */
-    status: 'connected' | 'disconnected' | 'reconnecting';
-    /** Reason for status change */
-    reason?: string;
-}
-/**
- * Union type of all events
- */
-type CilowEvent = MemoryCreatedEvent | MemoryUpdatedEvent | MemoryDeletedEvent | MemoryTierChangedEvent | GraphNodeCreatedEvent | GraphEdgeCreatedEvent | ConnectionStatusEvent;
-/**
- * Pagination parameters
- */
-interface PaginationParams {
-    /** Number of items per page */
-    limit?: number;
-    /** Offset for pagination */
-    offset?: number;
-    /** Cursor for cursor-based pagination */
-    cursor?: string;
-}
-/**
- * Paginated response wrapper
- */
-interface PaginatedResponse<T> {
-    /** Items in this page */
-    items: T[];
-    /** Total count of items */
-    total: number;
-    /** Current offset */
-    offset: number;
-    /** Items per page */
-    limit: number;
-    /** Cursor for next page */
-    nextCursor?: string;
-    /** Whether there are more items */
-    hasMore: boolean;
-}
-/**
- * API error response
- */
-interface ApiError {
-    /** Error code */
-    code: string;
-    /** Human-readable error message */
-    message: string;
-    /** Additional error details */
-    details?: Record<string, unknown>;
-    /** Request ID for debugging */
-    requestId?: string;
-}
-/**
- * Health check response
- */
-interface HealthCheck {
-    /** Service status */
-    status: 'healthy' | 'degraded' | 'unhealthy';
-    /** Service version */
-    version: string;
-    /** Uptime in seconds */
-    uptimeSeconds: number;
-    /** Component statuses */
-    components: {
-        name: string;
-        status: 'healthy' | 'degraded' | 'unhealthy';
-        latencyMs?: number;
-    }[];
-}
-/**
- * Client configuration options
- */
-interface CilowConfig {
-    /** Base URL of the Cilow API */
-    apiUrl: string;
-    /** API key for authentication */
-    apiKey: string;
-    /** Request timeout in milliseconds */
-    timeout?: number;
-    /** Number of retry attempts for failed requests */
-    retries?: number;
-    /** Custom headers to include in requests */
-    headers?: Record<string, string>;
-    /** Enable debug logging */
-    debug?: boolean;
-}
-/**
- * WebSocket configuration options
- */
-interface WebSocketConfig {
-    /** WebSocket URL (defaults to apiUrl with ws:// protocol) */
-    wsUrl?: string;
-    /** Reconnection attempts */
-    reconnectAttempts?: number;
-    /** Reconnection delay in milliseconds */
-    reconnectDelay?: number;
-    /** Heartbeat interval in milliseconds */
-    heartbeatInterval?: number;
-    /** Message queue size for offline buffering */
-    messageQueueSize?: number;
-}
-/**
- * Combined configuration for full client
- */
-interface FullCilowConfig extends CilowConfig, WebSocketConfig {
-    /** Default user ID for all operations */
-    defaultUserId?: string;
-    /** Default session ID */
-    defaultSessionId?: string;
-    /** Default tags to apply */
-    defaultTags?: string[];
-}
-/**
- * Context result for AI integrations
- */
-interface ContextResult {
-    /** Formatted context string */
-    context: string;
-    /** Number of memories used */
-    memoriesUsed: number;
-    /** Estimated token count */
-    estimatedTokens: number;
-    /** Memory IDs included */
-    memoryIds: string[];
-    /** Search scores */
-    scores: number[];
-}
-/**
- * Conversation turn for storing dialogues
- */
-interface ConversationTurn {
-    /** User's message */
-    userMessage: string;
-    /** Assistant's response */
-    assistantResponse: string;
-    /** Session ID */
-    sessionId?: string;
-    /** Additional metadata */
-    metadata?: Record<string, unknown>;
-}
-/**
- * Batch operation result
- */
-interface BatchResult<T> {
-    /** Successful operations */
-    succeeded: T[];
-    /** Failed operations with errors */
-    failed: {
-        item: T;
-        error: string;
-    }[];
-    /** Total operations attempted */
-    total: number;
-}
-/**
- * Check if an event is a memory event
- */
-declare function isMemoryEvent(event: CilowEvent): event is MemoryCreatedEvent | MemoryUpdatedEvent | MemoryDeletedEvent;
-/**
- * Check if an event is a graph event
- */
-declare function isGraphEvent(event: CilowEvent): event is GraphNodeCreatedEvent | GraphEdgeCreatedEvent;
-/**
- * Check if an object is an API error
- */
-declare function isApiError(obj: unknown): obj is ApiError;
-
-export { type AdvancedSearchOptions, type ApiError, type BaseEvent, type BatchResult, type CilowConfig, type CilowEvent, type ConnectionStatusEvent, type ContextResult, type ConversationTurn, type CreateMemoryOptions, type FullCilowConfig, type GraphEdge, type GraphEdgeCreatedEvent, type GraphNode, type GraphNodeCreatedEvent, type GraphSubgraph, type GraphTraversalOptions, type HealthCheck, type Memory, type MemoryCreatedEvent, type MemoryDeletedEvent, type MemoryStats, type MemoryStatus, type MemorySummary, type MemoryTier, type MemoryTierChangedEvent, type MemoryUpdatedEvent, type PaginatedResponse, type PaginationParams, type SearchQuery, type SearchResult, type TagCount, type UpdateMemoryOptions, type UserStats, type WebSocketConfig, isApiError, isGraphEvent, isMemoryEvent };

package/dist/types.mjs

@@ -1,14 +0,0 @@
-// src/types.ts
-function isMemoryEvent(event) {
-  return event.type.startsWith("memory.");
-}
-function isGraphEvent(event) {
-  return event.type.startsWith("graph.");
-}
-function isApiError(obj) {
-  return typeof obj === "object" && obj !== null && "code" in obj && "message" in obj;
-}
-
-export { isApiError, isGraphEvent, isMemoryEvent };
-//# sourceMappingURL=types.mjs.map
-//# sourceMappingURL=types.mjs.map

package/dist/types.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/types.ts"],"names":[],"mappings":";AAkjBO,SAAS,cAAc,KAAA,EAA0F;AACtH,EAAA,OAAO,KAAA,CAAM,IAAA,CAAK,UAAA,CAAW,SAAS,CAAA;AACxC;AAKO,SAAS,aAAa,KAAA,EAA2E;AACtG,EAAA,OAAO,KAAA,CAAM,IAAA,CAAK,UAAA,CAAW,QAAQ,CAAA;AACvC;AAKO,SAAS,WAAW,GAAA,EAA+B;AACxD,EAAA,OACE,OAAO,GAAA,KAAQ,QAAA,IACf,QAAQ,IAAA,IACR,MAAA,IAAU,OACV,SAAA,IAAa,GAAA;AAEjB","file":"types.mjs","sourcesContent":["/**\n * Cilow SDK TypeScript Type Definitions\n *\n * Comprehensive type definitions for the Cilow memory system.\n */\n\n// =============================================================================\n// Core Memory Types\n// =============================================================================\n\n/**\n * Memory tier classification based on access frequency and recency\n */\nexport type MemoryTier = 'hot' | 'warm' | 'cold';\n\n/**\n * Memory status for lifecycle management\n */\nexport type MemoryStatus = 'active' | 'archived' | 'deleted';\n\n/**\n * Core memory entity representing a stored piece of information\n */\nexport interface Memory {\n  /** Unique identifier for the memory */\n  id: string;\n  /** The content of the memory */\n  content: string;\n  /** Tags for categorization and filtering */\n  tags: string[];\n  /** User ID associated with this memory */\n  userId?: string;\n  /** Session ID for grouping related memories */\n  sessionId?: string;\n  /** Current tier classification */\n  tier: MemoryTier;\n  /** Memory status */\n  status: MemoryStatus;\n  /** Access count for prioritization */\n  accessCount: number;\n  /** Token count for the content */\n  tokenCount: number;\n  /** Embedding vector (if available) */\n  embedding?: number[];\n  /** Additional metadata */\n  metadata: Record<string, unknown>;\n  /** ISO timestamp of creation */\n  createdAt: string;\n  /** ISO timestamp of last update */\n  updatedAt: string;\n  /** ISO timestamp of last access */\n  lastAccessedAt: string;\n}\n\n/**\n * Minimal memory representation for list operations\n */\nexport interface MemorySummary {\n  id: string;\n  content: string;\n  tags: string[];\n  tier: MemoryTier;\n  createdAt: string;\n}\n\n/**\n * Options for creating a new memory\n */\nexport interface CreateMemoryOptions {\n  /** Tags to apply to the memory */\n  tags?: string[];\n  /** User ID to associate */\n  userId?: string;\n  /** Session ID for grouping */\n  sessionId?: string;\n  /** Additional metadata */\n  metadata?: Record<string, unknown>;\n  /** Force a specific tier */\n  tier?: MemoryTier;\n}\n\n/**\n * Options for updating a memory\n */\nexport interface UpdateMemoryOptions {\n  /** New content */\n  content?: string;\n  /** New tags (replaces existing) */\n  tags?: string[];\n  /** Updated metadata (merged with existing) */\n  metadata?: Record<string, unknown>;\n  /** Force tier change */\n  tier?: MemoryTier;\n}\n\n// =============================================================================\n// Search Types\n// =============================================================================\n\n/**\n * Search result containing a memory and its relevance score\n */\nexport interface SearchResult {\n  /** The matching memory */\n  memory: Memory;\n  /** Relevance score (0.0 - 1.0) */\n  score: number;\n  /** Matched terms or phrases */\n  matchedTerms?: string[];\n  /** Highlighted content snippets */\n  highlights?: string[];\n}\n\n/**\n * Search query parameters\n */\nexport interface SearchQuery {\n  /** The search text */\n  text: string;\n  /** Maximum number of results */\n  limit?: number;\n  /** Minimum relevance score threshold (0.0 - 1.0) */\n  minRelevance?: number;\n  /** Filter by tags (AND logic) */\n  tags?: string[];\n  /** Filter by user ID */\n  userId?: string;\n  /** Filter by session ID */\n  sessionId?: string;\n  /** Filter by tier */\n  tier?: MemoryTier;\n  /** Filter by date range - start */\n  createdAfter?: string;\n  /** Filter by date range - end */\n  createdBefore?: string;\n  /** Include archived memories */\n  includeArchived?: boolean;\n  /** Search mode */\n  mode?: 'semantic' | 'keyword' | 'hybrid';\n}\n\n/**\n * Advanced search options for complex queries\n */\nexport interface AdvancedSearchOptions extends SearchQuery {\n  /** Boost recent memories */\n  recencyBoost?: number;\n  /** Boost frequently accessed memories */\n  frequencyBoost?: number;\n  /** Required tags (must have all) */\n  requiredTags?: string[];\n  /** Excluded tags (must not have any) */\n  excludedTags?: string[];\n  /** Metadata filters */\n  metadataFilters?: Record<string, unknown>;\n  /** Custom reranking function name */\n  reranker?: string;\n}\n\n// =============================================================================\n// Graph Types\n// =============================================================================\n\n/**\n * Node in the memory knowledge graph\n */\nexport interface GraphNode {\n  /** Unique node identifier */\n  id: string;\n  /** Node type/label */\n  type: string;\n  /** Display name */\n  name: string;\n  /** Node properties */\n  properties: Record<string, unknown>;\n  /** Associated memory IDs */\n  memoryIds: string[];\n  /** Creation timestamp */\n  createdAt: string;\n  /** Last update timestamp */\n  updatedAt: string;\n}\n\n/**\n * Edge connecting two nodes in the graph\n */\nexport interface GraphEdge {\n  /** Unique edge identifier */\n  id: string;\n  /** Source node ID */\n  sourceId: string;\n  /** Target node ID */\n  targetId: string;\n  /** Relationship type */\n  type: string;\n  /** Edge weight/strength */\n  weight: number;\n  /** Edge properties */\n  properties: Record<string, unknown>;\n  /** Creation timestamp */\n  createdAt: string;\n}\n\n/**\n * Subgraph result for graph traversal queries\n */\nexport interface GraphSubgraph {\n  /** Nodes in the subgraph */\n  nodes: GraphNode[];\n  /** Edges in the subgraph */\n  edges: GraphEdge[];\n  /** Central node ID (if applicable) */\n  centerId?: string;\n}\n\n/**\n * Options for graph traversal\n */\nexport interface GraphTraversalOptions {\n  /** Starting node ID */\n  startNodeId: string;\n  /** Maximum traversal depth */\n  maxDepth?: number;\n  /** Filter by relationship types */\n  relationshipTypes?: string[];\n  /** Maximum nodes to return */\n  limit?: number;\n  /** Traversal direction */\n  direction?: 'outbound' | 'inbound' | 'both';\n}\n\n// =============================================================================\n// Statistics Types\n// =============================================================================\n\n/**\n * Memory system statistics\n */\nexport interface MemoryStats {\n  /** Total number of memories */\n  totalMemories: number;\n  /** Number of hot tier memories */\n  hotMemories: number;\n  /** Number of warm tier memories */\n  warmMemories: number;\n  /** Number of cold tier memories */\n  coldMemories: number;\n  /** Total token count across all memories */\n  totalTokens: number;\n  /** Average tokens per memory */\n  averageTokensPerMemory: number;\n  /** Number of unique users */\n  uniqueUsers: number;\n  /** Number of unique sessions */\n  uniqueSessions: number;\n  /** Total number of tags */\n  totalTags: number;\n  /** Storage size in bytes */\n  storageSizeBytes: number;\n  /** Stats generation timestamp */\n  generatedAt: string;\n}\n\n/**\n * Tag with usage count\n */\nexport interface TagCount {\n  /** Tag name */\n  tag: string;\n  /** Usage count */\n  count: number;\n}\n\n/**\n * User activity statistics\n */\nexport interface UserStats {\n  /** User ID */\n  userId: string;\n  /** Number of memories */\n  memoryCount: number;\n  /** Total tokens used */\n  totalTokens: number;\n  /** Number of sessions */\n  sessionCount: number;\n  /** First activity timestamp */\n  firstActivityAt: string;\n  /** Last activity timestamp */\n  lastActivityAt: string;\n}\n\n// =============================================================================\n// Event Types (WebSocket)\n// =============================================================================\n\n/**\n * Base event type\n */\nexport interface BaseEvent {\n  /** Event type identifier */\n  type: string;\n  /** Event timestamp */\n  timestamp: string;\n  /** Correlation ID for tracking */\n  correlationId?: string;\n}\n\n/**\n * Memory created event\n */\nexport interface MemoryCreatedEvent extends BaseEvent {\n  type: 'memory.created';\n  /** The created memory */\n  memory: Memory;\n}\n\n/**\n * Memory updated event\n */\nexport interface MemoryUpdatedEvent extends BaseEvent {\n  type: 'memory.updated';\n  /** The updated memory */\n  memory: Memory;\n  /** Changed fields */\n  changedFields: string[];\n}\n\n/**\n * Memory deleted event\n */\nexport interface MemoryDeletedEvent extends BaseEvent {\n  type: 'memory.deleted';\n  /** Deleted memory ID */\n  memoryId: string;\n}\n\n/**\n * Memory tier changed event\n */\nexport interface MemoryTierChangedEvent extends BaseEvent {\n  type: 'memory.tier_changed';\n  /** Memory ID */\n  memoryId: string;\n  /** Previous tier */\n  previousTier: MemoryTier;\n  /** New tier */\n  newTier: MemoryTier;\n}\n\n/**\n * Graph node created event\n */\nexport interface GraphNodeCreatedEvent extends BaseEvent {\n  type: 'graph.node_created';\n  /** The created node */\n  node: GraphNode;\n}\n\n/**\n * Graph edge created event\n */\nexport interface GraphEdgeCreatedEvent extends BaseEvent {\n  type: 'graph.edge_created';\n  /** The created edge */\n  edge: GraphEdge;\n}\n\n/**\n * Connection status event\n */\nexport interface ConnectionStatusEvent extends BaseEvent {\n  type: 'connection.status';\n  /** Connection status */\n  status: 'connected' | 'disconnected' | 'reconnecting';\n  /** Reason for status change */\n  reason?: string;\n}\n\n/**\n * Union type of all events\n */\nexport type CilowEvent =\n  | MemoryCreatedEvent\n  | MemoryUpdatedEvent\n  | MemoryDeletedEvent\n  | MemoryTierChangedEvent\n  | GraphNodeCreatedEvent\n  | GraphEdgeCreatedEvent\n  | ConnectionStatusEvent;\n\n// =============================================================================\n// API Request/Response Types\n// =============================================================================\n\n/**\n * Pagination parameters\n */\nexport interface PaginationParams {\n  /** Number of items per page */\n  limit?: number;\n  /** Offset for pagination */\n  offset?: number;\n  /** Cursor for cursor-based pagination */\n  cursor?: string;\n}\n\n/**\n * Paginated response wrapper\n */\nexport interface PaginatedResponse<T> {\n  /** Items in this page */\n  items: T[];\n  /** Total count of items */\n  total: number;\n  /** Current offset */\n  offset: number;\n  /** Items per page */\n  limit: number;\n  /** Cursor for next page */\n  nextCursor?: string;\n  /** Whether there are more items */\n  hasMore: boolean;\n}\n\n/**\n * API error response\n */\nexport interface ApiError {\n  /** Error code */\n  code: string;\n  /** Human-readable error message */\n  message: string;\n  /** Additional error details */\n  details?: Record<string, unknown>;\n  /** Request ID for debugging */\n  requestId?: string;\n}\n\n/**\n * Health check response\n */\nexport interface HealthCheck {\n  /** Service status */\n  status: 'healthy' | 'degraded' | 'unhealthy';\n  /** Service version */\n  version: string;\n  /** Uptime in seconds */\n  uptimeSeconds: number;\n  /** Component statuses */\n  components: {\n    name: string;\n    status: 'healthy' | 'degraded' | 'unhealthy';\n    latencyMs?: number;\n  }[];\n}\n\n// =============================================================================\n// Client Configuration Types\n// =============================================================================\n\n/**\n * Client configuration options\n */\nexport interface CilowConfig {\n  /** Base URL of the Cilow API */\n  apiUrl: string;\n  /** API key for authentication */\n  apiKey: string;\n  /** Request timeout in milliseconds */\n  timeout?: number;\n  /** Number of retry attempts for failed requests */\n  retries?: number;\n  /** Custom headers to include in requests */\n  headers?: Record<string, string>;\n  /** Enable debug logging */\n  debug?: boolean;\n}\n\n/**\n * WebSocket configuration options\n */\nexport interface WebSocketConfig {\n  /** WebSocket URL (defaults to apiUrl with ws:// protocol) */\n  wsUrl?: string;\n  /** Reconnection attempts */\n  reconnectAttempts?: number;\n  /** Reconnection delay in milliseconds */\n  reconnectDelay?: number;\n  /** Heartbeat interval in milliseconds */\n  heartbeatInterval?: number;\n  /** Message queue size for offline buffering */\n  messageQueueSize?: number;\n}\n\n/**\n * Combined configuration for full client\n */\nexport interface FullCilowConfig extends CilowConfig, WebSocketConfig {\n  /** Default user ID for all operations */\n  defaultUserId?: string;\n  /** Default session ID */\n  defaultSessionId?: string;\n  /** Default tags to apply */\n  defaultTags?: string[];\n}\n\n// =============================================================================\n// Framework Integration Types\n// =============================================================================\n\n/**\n * Context result for AI integrations\n */\nexport interface ContextResult {\n  /** Formatted context string */\n  context: string;\n  /** Number of memories used */\n  memoriesUsed: number;\n  /** Estimated token count */\n  estimatedTokens: number;\n  /** Memory IDs included */\n  memoryIds: string[];\n  /** Search scores */\n  scores: number[];\n}\n\n/**\n * Conversation turn for storing dialogues\n */\nexport interface ConversationTurn {\n  /** User's message */\n  userMessage: string;\n  /** Assistant's response */\n  assistantResponse: string;\n  /** Session ID */\n  sessionId?: string;\n  /** Additional metadata */\n  metadata?: Record<string, unknown>;\n}\n\n/**\n * Batch operation result\n */\nexport interface BatchResult<T> {\n  /** Successful operations */\n  succeeded: T[];\n  /** Failed operations with errors */\n  failed: {\n    item: T;\n    error: string;\n  }[];\n  /** Total operations attempted */\n  total: number;\n}\n\n// =============================================================================\n// Type Guards\n// =============================================================================\n\n/**\n * Check if an event is a memory event\n */\nexport function isMemoryEvent(event: CilowEvent): event is MemoryCreatedEvent | MemoryUpdatedEvent | MemoryDeletedEvent {\n  return event.type.startsWith('memory.');\n}\n\n/**\n * Check if an event is a graph event\n */\nexport function isGraphEvent(event: CilowEvent): event is GraphNodeCreatedEvent | GraphEdgeCreatedEvent {\n  return event.type.startsWith('graph.');\n}\n\n/**\n * Check if an object is an API error\n */\nexport function isApiError(obj: unknown): obj is ApiError {\n  return (\n    typeof obj === 'object' &&\n    obj !== null &&\n    'code' in obj &&\n    'message' in obj\n  );\n}\n"]}

package/dist/websocket.d.mts

@@ -1,160 +0,0 @@
-import { CilowConfig, WebSocketConfig, CilowEvent, MemoryCreatedEvent, MemoryUpdatedEvent, MemoryDeletedEvent, MemoryTierChangedEvent, GraphNodeCreatedEvent, GraphEdgeCreatedEvent, ConnectionStatusEvent } from './types.mjs';
-
-/**
- * Cilow WebSocket Client
- *
- * Real-time connection for memory updates, graph changes, and event streaming.
- */
-
-/**
- * WebSocket connection states
- */
-type ConnectionState = 'disconnected' | 'connecting' | 'connected' | 'reconnecting';
-/**
- * Event listener type
- */
-type EventListener<T extends CilowEvent = CilowEvent> = (event: T) => void;
-/**
- * Subscription filter options
- */
-interface SubscriptionFilter {
-    /** Filter by user ID */
-    userId?: string;
-    /** Filter by session ID */
-    sessionId?: string;
-    /** Filter by tags */
-    tags?: string[];
-    /** Filter by event types */
-    eventTypes?: string[];
-}
-/**
- * CilowWebSocket - Real-time WebSocket client for Cilow
- *
- * @example
- * ```typescript
- * const ws = new CilowWebSocket({
- *   apiUrl: 'https://api.cilow.ai',
- *   apiKey: 'your-key'
- * });
- *
- * // Subscribe to memory events
- * ws.on('memory.created', (event) => {
- *   console.log('New memory:', event.memory);
- * });
- *
- * // Connect
- * await ws.connect();
- *
- * // Subscribe to specific user's events
- * ws.subscribe({ userId: 'user-123' });
- * ```
- */
-declare class CilowWebSocket {
-    private ws;
-    private readonly wsUrl;
-    private readonly apiKey;
-    private readonly reconnectAttempts;
-    private readonly reconnectDelay;
-    private readonly heartbeatInterval;
-    private readonly messageQueueSize;
-    private state;
-    private reconnectCount;
-    private heartbeatTimer;
-    private reconnectTimer;
-    private messageQueue;
-    private subscriptions;
-    private listeners;
-    private allListeners;
-    constructor(config: CilowConfig & WebSocketConfig);
-    /**
-     * Get current connection state
-     */
-    get connectionState(): ConnectionState;
-    /**
-     * Check if connected
-     */
-    get isConnected(): boolean;
-    /**
-     * Connect to the WebSocket server
-     */
-    connect(): Promise<void>;
-    /**
-     * Disconnect from the WebSocket server
-     */
-    disconnect(): void;
-    /**
-     * Subscribe to events with optional filter
-     */
-    subscribe(filter?: SubscriptionFilter): void;
-    /**
-     * Unsubscribe from events
-     */
-    unsubscribe(filter?: SubscriptionFilter): void;
-    /**
-     * Add event listener for specific event type
-     */
-    on<T extends CilowEvent>(eventType: T['type'], listener: EventListener<T>): () => void;
-    /**
-     * Add listener for all events
-     */
-    onAny(listener: EventListener): () => void;
-    /**
-     * Remove event listener
-     */
-    off<T extends CilowEvent>(eventType: T['type'], listener: EventListener<T>): void;
-    /**
-     * Remove all listeners for an event type
-     */
-    offAll(eventType?: string): void;
-    /**
-     * Listen for memory created events
-     */
-    onMemoryCreated(listener: EventListener<MemoryCreatedEvent>): () => void;
-    /**
-     * Listen for memory updated events
-     */
-    onMemoryUpdated(listener: EventListener<MemoryUpdatedEvent>): () => void;
-    /**
-     * Listen for memory deleted events
-     */
-    onMemoryDeleted(listener: EventListener<MemoryDeletedEvent>): () => void;
-    /**
-     * Listen for memory tier changed events
-     */
-    onMemoryTierChanged(listener: EventListener<MemoryTierChangedEvent>): () => void;
-    /**
-     * Listen for graph node created events
-     */
-    onGraphNodeCreated(listener: EventListener<GraphNodeCreatedEvent>): () => void;
-    /**
-     * Listen for graph edge created events
-     */
-    onGraphEdgeCreated(listener: EventListener<GraphEdgeCreatedEvent>): () => void;
-    /**
-     * Listen for connection status changes
-     */
-    onConnectionStatus(listener: EventListener<ConnectionStatusEvent>): () => void;
-    /**
-     * Wait for specific event (one-time)
-     */
-    once<T extends CilowEvent>(eventType: T['type'], timeout?: number): Promise<T>;
-    private send;
-    private sendSubscription;
-    private resubscribe;
-    private flushMessageQueue;
-    private handleMessage;
-    private handleClose;
-    private handleError;
-    private scheduleReconnect;
-    private clearReconnectTimer;
-    private startHeartbeat;
-    private stopHeartbeat;
-    private emit;
-    private emitStatusEvent;
-}
-/**
- * Create a WebSocket client instance (convenience function)
- */
-declare function createWebSocket(config: CilowConfig & WebSocketConfig): CilowWebSocket;
-
-export { CilowWebSocket, type ConnectionState, type EventListener, type SubscriptionFilter, createWebSocket };