@claude-flow/shared 3.0.0-alpha.1

package/dist/core/interfaces/event.interface.d.ts

@@ -0,0 +1,224 @@
+/**
+ * V3 Event Interfaces
+ * Domain-Driven Design - Event Sourcing Pattern (ADR-007)
+ */
+/**
+ * Event priority levels
+ */
+export type EventPriority = 'critical' | 'high' | 'normal' | 'low';
+/**
+ * Core event structure
+ */
+export interface IEvent<T = unknown> {
+    readonly id: string;
+    readonly type: string;
+    readonly timestamp: Date;
+    readonly source: string;
+    payload: T;
+    priority?: EventPriority;
+    correlationId?: string;
+    causationId?: string;
+    metadata?: {
+        version?: number;
+        userId?: string;
+        sessionId?: string;
+        [key: string]: unknown;
+    };
+}
+/**
+ * Event creation parameters
+ */
+export interface IEventCreate<T = unknown> {
+    type: string;
+    payload: T;
+    source?: string;
+    priority?: EventPriority;
+    correlationId?: string;
+    causationId?: string;
+    metadata?: IEvent['metadata'];
+}
+/**
+ * Event handler function type
+ */
+export type IEventHandler<T = unknown> = (event: IEvent<T>) => void | Promise<void>;
+/**
+ * Event filter for subscriptions
+ */
+export interface IEventFilter {
+    types?: string[];
+    sources?: string[];
+    priority?: EventPriority[];
+    correlationId?: string;
+}
+/**
+ * Event subscription handle
+ */
+export interface IEventSubscription {
+    readonly id: string;
+    readonly filter: IEventFilter;
+    /**
+     * Unsubscribe from events
+     */
+    unsubscribe(): void;
+    /**
+     * Pause subscription
+     */
+    pause(): void;
+    /**
+     * Resume subscription
+     */
+    resume(): void;
+    /**
+     * Check if subscription is active
+     */
+    isActive(): boolean;
+}
+/**
+ * Event bus interface for pub/sub communication
+ */
+export interface IEventBus {
+    /**
+     * Emit an event to all subscribers
+     */
+    emit<T = unknown>(type: string, payload: T, options?: Partial<IEventCreate<T>>): void;
+    /**
+     * Emit an event and wait for all handlers
+     */
+    emitAsync<T = unknown>(type: string, payload: T, options?: Partial<IEventCreate<T>>): Promise<void>;
+    /**
+     * Subscribe to events matching a type pattern
+     */
+    on<T = unknown>(type: string, handler: IEventHandler<T>): IEventSubscription;
+    /**
+     * Subscribe to events with filter
+     */
+    subscribe<T = unknown>(filter: IEventFilter, handler: IEventHandler<T>): IEventSubscription;
+    /**
+     * Subscribe to a single event occurrence
+     */
+    once<T = unknown>(type: string, handler: IEventHandler<T>): IEventSubscription;
+    /**
+     * Remove a specific handler
+     */
+    off(type: string, handler: IEventHandler): void;
+    /**
+     * Remove all handlers for a type
+     */
+    removeAllListeners(type?: string): void;
+    /**
+     * Get count of listeners for a type
+     */
+    listenerCount(type: string): number;
+    /**
+     * Get all event types with active listeners
+     */
+    eventNames(): string[];
+}
+/**
+ * System event types enumeration
+ */
+export declare const SystemEventTypes: {
+    readonly SYSTEM_READY: "system:ready";
+    readonly SYSTEM_SHUTDOWN: "system:shutdown";
+    readonly SYSTEM_ERROR: "system:error";
+    readonly SYSTEM_HEALTHCHECK: "system:healthcheck";
+    readonly AGENT_SPAWNED: "agent:spawned";
+    readonly AGENT_TERMINATED: "agent:terminated";
+    readonly AGENT_ERROR: "agent:error";
+    readonly AGENT_IDLE: "agent:idle";
+    readonly AGENT_BUSY: "agent:busy";
+    readonly AGENT_HEALTH_CHANGED: "agent:health:changed";
+    readonly TASK_CREATED: "task:created";
+    readonly TASK_ASSIGNED: "task:assigned";
+    readonly TASK_STARTED: "task:started";
+    readonly TASK_COMPLETED: "task:completed";
+    readonly TASK_FAILED: "task:failed";
+    readonly TASK_CANCELLED: "task:cancelled";
+    readonly TASK_TIMEOUT: "task:timeout";
+    readonly TASK_RETRY: "task:retry";
+    readonly SESSION_CREATED: "session:created";
+    readonly SESSION_RESTORED: "session:restored";
+    readonly SESSION_TERMINATED: "session:terminated";
+    readonly SESSION_PERSISTED: "session:persisted";
+    readonly MEMORY_STORED: "memory:stored";
+    readonly MEMORY_RETRIEVED: "memory:retrieved";
+    readonly MEMORY_CLEARED: "memory:cleared";
+    readonly COORDINATION_STARTED: "coordination:started";
+    readonly COORDINATION_COMPLETED: "coordination:completed";
+    readonly DEADLOCK_DETECTED: "coordination:deadlock";
+    readonly METRICS_COLLECTED: "metrics:collected";
+};
+export type SystemEventType = typeof SystemEventTypes[keyof typeof SystemEventTypes];
+/**
+ * Event store interface for event sourcing
+ */
+export interface IEventStore {
+    /**
+     * Append an event to the store
+     */
+    append(event: IEvent): Promise<void>;
+    /**
+     * Get events by aggregate ID
+     */
+    getByAggregateId(aggregateId: string, fromVersion?: number): Promise<IEvent[]>;
+    /**
+     * Get events by type
+     */
+    getByType(type: string, options?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<IEvent[]>;
+    /**
+     * Get events in time range
+     */
+    getByTimeRange(start: Date, end: Date): Promise<IEvent[]>;
+    /**
+     * Get events by correlation ID
+     */
+    getByCorrelationId(correlationId: string): Promise<IEvent[]>;
+    /**
+     * Get all events (paginated)
+     */
+    getAll(options?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<IEvent[]>;
+    /**
+     * Get event count
+     */
+    count(filter?: IEventFilter): Promise<number>;
+    /**
+     * Clear old events
+     */
+    prune(olderThan: Date): Promise<number>;
+}
+/**
+ * Event coordinator for routing and orchestration
+ */
+export interface IEventCoordinator {
+    /**
+     * Initialize the coordinator
+     */
+    initialize(): Promise<void>;
+    /**
+     * Shutdown the coordinator
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Route an event to appropriate handlers
+     */
+    route(event: IEvent): Promise<void>;
+    /**
+     * Register a handler for event routing
+     */
+    registerHandler(type: string, handler: IEventHandler): void;
+    /**
+     * Unregister a handler
+     */
+    unregisterHandler(type: string, handler: IEventHandler): void;
+    /**
+     * Get event bus instance
+     */
+    getEventBus(): IEventBus;
+}
+//# sourceMappingURL=event.interface.d.ts.map

package/dist/core/interfaces/event.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.interface.d.ts","sourceRoot":"","sources":["../../../src/core/interfaces/event.interface.ts"],"names":[],"mappings":"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"}

package/dist/core/interfaces/event.interface.js

@@ -0,0 +1,46 @@
+/**
+ * V3 Event Interfaces
+ * Domain-Driven Design - Event Sourcing Pattern (ADR-007)
+ */
+/**
+ * System event types enumeration
+ */
+export const SystemEventTypes = {
+    // System lifecycle
+    SYSTEM_READY: 'system:ready',
+    SYSTEM_SHUTDOWN: 'system:shutdown',
+    SYSTEM_ERROR: 'system:error',
+    SYSTEM_HEALTHCHECK: 'system:healthcheck',
+    // Agent lifecycle
+    AGENT_SPAWNED: 'agent:spawned',
+    AGENT_TERMINATED: 'agent:terminated',
+    AGENT_ERROR: 'agent:error',
+    AGENT_IDLE: 'agent:idle',
+    AGENT_BUSY: 'agent:busy',
+    AGENT_HEALTH_CHANGED: 'agent:health:changed',
+    // Task lifecycle
+    TASK_CREATED: 'task:created',
+    TASK_ASSIGNED: 'task:assigned',
+    TASK_STARTED: 'task:started',
+    TASK_COMPLETED: 'task:completed',
+    TASK_FAILED: 'task:failed',
+    TASK_CANCELLED: 'task:cancelled',
+    TASK_TIMEOUT: 'task:timeout',
+    TASK_RETRY: 'task:retry',
+    // Session lifecycle
+    SESSION_CREATED: 'session:created',
+    SESSION_RESTORED: 'session:restored',
+    SESSION_TERMINATED: 'session:terminated',
+    SESSION_PERSISTED: 'session:persisted',
+    // Memory events
+    MEMORY_STORED: 'memory:stored',
+    MEMORY_RETRIEVED: 'memory:retrieved',
+    MEMORY_CLEARED: 'memory:cleared',
+    // Coordination events
+    COORDINATION_STARTED: 'coordination:started',
+    COORDINATION_COMPLETED: 'coordination:completed',
+    DEADLOCK_DETECTED: 'coordination:deadlock',
+    // Metrics events
+    METRICS_COLLECTED: 'metrics:collected',
+};
+//# sourceMappingURL=event.interface.js.map

package/dist/core/interfaces/event.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.interface.js","sourceRoot":"","sources":["../../../src/core/interfaces/event.interface.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAuIH;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,mBAAmB;IACnB,YAAY,EAAE,cAAc;IAC5B,eAAe,EAAE,iBAAiB;IAClC,YAAY,EAAE,cAAc;IAC5B,kBAAkB,EAAE,oBAAoB;IAExC,kBAAkB;IAClB,aAAa,EAAE,eAAe;IAC9B,gBAAgB,EAAE,kBAAkB;IACpC,WAAW,EAAE,aAAa;IAC1B,UAAU,EAAE,YAAY;IACxB,UAAU,EAAE,YAAY;IACxB,oBAAoB,EAAE,sBAAsB;IAE5C,iBAAiB;IACjB,YAAY,EAAE,cAAc;IAC5B,aAAa,EAAE,eAAe;IAC9B,YAAY,EAAE,cAAc;IAC5B,cAAc,EAAE,gBAAgB;IAChC,WAAW,EAAE,aAAa;IAC1B,cAAc,EAAE,gBAAgB;IAChC,YAAY,EAAE,cAAc;IAC5B,UAAU,EAAE,YAAY;IAExB,oBAAoB;IACpB,eAAe,EAAE,iBAAiB;IAClC,gBAAgB,EAAE,kBAAkB;IACpC,kBAAkB,EAAE,oBAAoB;IACxC,iBAAiB,EAAE,mBAAmB;IAEtC,gBAAgB;IAChB,aAAa,EAAE,eAAe;IAC9B,gBAAgB,EAAE,kBAAkB;IACpC,cAAc,EAAE,gBAAgB;IAEhC,sBAAsB;IACtB,oBAAoB,EAAE,sBAAsB;IAC5C,sBAAsB,EAAE,wBAAwB;IAChD,iBAAiB,EAAE,uBAAuB;IAE1C,iBAAiB;IACjB,iBAAiB,EAAE,mBAAmB;CAC9B,CAAC"}

package/dist/core/interfaces/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * V3 Core Interfaces - Public API
+ * Domain-Driven Design with Clean Architecture
+ */
+export * from './task.interface.js';
+export * from './agent.interface.js';
+export * from './event.interface.js';
+export * from './memory.interface.js';
+export * from './coordinator.interface.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/interfaces/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/interfaces/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,cAAc,qBAAqB,CAAC;AAGpC,cAAc,sBAAsB,CAAC;AAGrC,cAAc,sBAAsB,CAAC;AAGrC,cAAc,uBAAuB,CAAC;AAGtC,cAAc,4BAA4B,CAAC"}

package/dist/core/interfaces/index.js

@@ -0,0 +1,15 @@
+/**
+ * V3 Core Interfaces - Public API
+ * Domain-Driven Design with Clean Architecture
+ */
+// Task interfaces
+export * from './task.interface.js';
+// Agent interfaces
+export * from './agent.interface.js';
+// Event interfaces
+export * from './event.interface.js';
+// Memory interfaces
+export * from './memory.interface.js';
+// Coordinator interfaces
+export * from './coordinator.interface.js';
+//# sourceMappingURL=index.js.map

package/dist/core/interfaces/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/interfaces/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,kBAAkB;AAClB,cAAc,qBAAqB,CAAC;AAEpC,mBAAmB;AACnB,cAAc,sBAAsB,CAAC;AAErC,mBAAmB;AACnB,cAAc,sBAAsB,CAAC;AAErC,oBAAoB;AACpB,cAAc,uBAAuB,CAAC;AAEtC,yBAAyB;AACzB,cAAc,4BAA4B,CAAC"}

package/dist/core/interfaces/memory.interface.d.ts

@@ -0,0 +1,298 @@
+/**
+ * V3 Memory Interfaces
+ * Domain-Driven Design - Memory Management Bounded Context
+ * Aligned with ADR-006 (Unified Memory Service) and ADR-009 (Hybrid Memory Backend)
+ */
+/**
+ * Memory entry types
+ */
+export type MemoryType = 'session' | 'persistent' | 'vector' | 'cache' | 'pattern';
+/**
+ * Memory entry structure
+ */
+export interface IMemoryEntry {
+    readonly id: string;
+    readonly key: string;
+    readonly type: MemoryType;
+    readonly createdAt: Date;
+    value: unknown;
+    updatedAt: Date;
+    expiresAt?: Date;
+    metadata?: {
+        source?: string;
+        agentId?: string;
+        sessionId?: string;
+        version?: number;
+        tags?: string[];
+        embedding?: number[];
+        [key: string]: unknown;
+    };
+}
+/**
+ * Memory entry creation parameters
+ */
+export interface IMemoryEntryCreate {
+    key: string;
+    value: unknown;
+    type?: MemoryType;
+    expiresAt?: Date;
+    ttlMs?: number;
+    metadata?: IMemoryEntry['metadata'];
+}
+/**
+ * Vector search parameters
+ */
+export interface IVectorSearchParams {
+    embedding: number[];
+    k?: number;
+    threshold?: number;
+    filter?: {
+        type?: MemoryType;
+        tags?: string[];
+        agentId?: string;
+    };
+}
+/**
+ * Vector search result
+ */
+export interface IVectorSearchResult {
+    entry: IMemoryEntry;
+    score: number;
+    distance: number;
+}
+/**
+ * Memory backend interface for storage operations
+ */
+export interface IMemoryBackend {
+    /**
+     * Initialize the backend
+     */
+    initialize(): Promise<void>;
+    /**
+     * Shutdown the backend
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Store a memory entry
+     */
+    store(entry: IMemoryEntryCreate): Promise<IMemoryEntry>;
+    /**
+     * Retrieve a memory entry by key
+     */
+    retrieve(key: string): Promise<IMemoryEntry | undefined>;
+    /**
+     * Retrieve by ID
+     */
+    retrieveById(id: string): Promise<IMemoryEntry | undefined>;
+    /**
+     * Update a memory entry
+     */
+    update(key: string, value: unknown, metadata?: Partial<IMemoryEntry['metadata']>): Promise<IMemoryEntry | undefined>;
+    /**
+     * Delete a memory entry
+     */
+    delete(key: string): Promise<boolean>;
+    /**
+     * Check if a key exists
+     */
+    exists(key: string): Promise<boolean>;
+    /**
+     * List all keys matching a pattern
+     */
+    keys(pattern?: string): Promise<string[]>;
+    /**
+     * Get all entries matching filter
+     */
+    list(filter?: {
+        type?: MemoryType;
+        tags?: string[];
+    }): Promise<IMemoryEntry[]>;
+    /**
+     * Clear all entries
+     */
+    clear(): Promise<void>;
+    /**
+     * Get entry count
+     */
+    count(): Promise<number>;
+    /**
+     * Prune expired entries
+     */
+    prune(): Promise<number>;
+    /**
+     * Get health status
+     */
+    getHealthStatus(): Promise<{
+        healthy: boolean;
+        error?: string;
+        metrics?: Record<string, number>;
+    }>;
+}
+/**
+ * Vector memory backend for similarity search
+ */
+export interface IVectorMemoryBackend extends IMemoryBackend {
+    /**
+     * Store with embedding
+     */
+    storeVector(entry: IMemoryEntryCreate & {
+        embedding: number[];
+    }): Promise<IMemoryEntry>;
+    /**
+     * Search by vector similarity
+     */
+    search(params: IVectorSearchParams): Promise<IVectorSearchResult[]>;
+    /**
+     * Update embedding for an entry
+     */
+    updateEmbedding(key: string, embedding: number[]): Promise<boolean>;
+    /**
+     * Build or rebuild index
+     */
+    buildIndex(): Promise<void>;
+    /**
+     * Get index statistics
+     */
+    getIndexStats(): Promise<{
+        vectorCount: number;
+        dimensions: number;
+        indexType: string;
+        memoryUsageMb: number;
+    }>;
+}
+/**
+ * Memory bank for agent-specific storage
+ */
+export interface IMemoryBank {
+    readonly id: string;
+    readonly agentId: string;
+    readonly createdAt: Date;
+    /**
+     * Store in bank
+     */
+    store(key: string, value: unknown, options?: Partial<IMemoryEntryCreate>): Promise<IMemoryEntry>;
+    /**
+     * Retrieve from bank
+     */
+    retrieve(key: string): Promise<IMemoryEntry | undefined>;
+    /**
+     * Delete from bank
+     */
+    delete(key: string): Promise<boolean>;
+    /**
+     * List all entries in bank
+     */
+    list(): Promise<IMemoryEntry[]>;
+    /**
+     * Clear all entries in bank
+     */
+    clear(): Promise<void>;
+    /**
+     * Get bank size
+     */
+    size(): Promise<number>;
+    /**
+     * Close the bank
+     */
+    close(): Promise<void>;
+}
+/**
+ * Memory manager interface
+ */
+export interface IMemoryManager {
+    /**
+     * Initialize the manager
+     */
+    initialize(): Promise<void>;
+    /**
+     * Shutdown the manager
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Create a memory bank for an agent
+     */
+    createBank(agentId: string): Promise<string>;
+    /**
+     * Get a memory bank
+     */
+    getBank(bankId: string): IMemoryBank | undefined;
+    /**
+     * Close a memory bank
+     */
+    closeBank(bankId: string): Promise<void>;
+    /**
+     * Store in global memory
+     */
+    store(entry: IMemoryEntryCreate): Promise<IMemoryEntry>;
+    /**
+     * Retrieve from global memory
+     */
+    retrieve(key: string): Promise<IMemoryEntry | undefined>;
+    /**
+     * Search vectors (if vector backend available)
+     */
+    searchVectors?(params: IVectorSearchParams): Promise<IVectorSearchResult[]>;
+    /**
+     * Perform maintenance
+     */
+    performMaintenance(): Promise<void>;
+    /**
+     * Get health status
+     */
+    getHealthStatus(): Promise<{
+        healthy: boolean;
+        error?: string;
+        metrics?: Record<string, number>;
+    }>;
+    /**
+     * Get memory usage statistics
+     */
+    getStats(): Promise<{
+        totalEntries: number;
+        memoryUsageMb: number;
+        banksCount: number;
+        cacheHitRate?: number;
+    }>;
+}
+/**
+ * Pattern storage for ReasoningBank integration
+ */
+export interface IPatternStorage {
+    /**
+     * Store a learned pattern
+     */
+    storePattern(pattern: {
+        sessionId: string;
+        task: string;
+        input: string;
+        output: string;
+        reward: number;
+        success: boolean;
+        critique?: string;
+        tokensUsed?: number;
+        latencyMs?: number;
+    }): Promise<void>;
+    /**
+     * Search for similar patterns
+     */
+    searchPatterns(params: {
+        task: string;
+        k?: number;
+        minReward?: number;
+        onlyFailures?: boolean;
+    }): Promise<Array<{
+        task: string;
+        reward: number;
+        critique: string;
+        output: string;
+    }>>;
+    /**
+     * Get pattern statistics
+     */
+    getPatternStats(): Promise<{
+        totalPatterns: number;
+        avgReward: number;
+        successRate: number;
+    }>;
+}
+//# sourceMappingURL=memory.interface.d.ts.map

package/dist/core/interfaces/memory.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.interface.d.ts","sourceRoot":"","sources":["../../../src/core/interfaces/memory.interface.ts"],"names":[],"mappings":"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"}

package/dist/core/interfaces/memory.interface.js

@@ -0,0 +1,7 @@
+/**
+ * V3 Memory Interfaces
+ * Domain-Driven Design - Memory Management Bounded Context
+ * Aligned with ADR-006 (Unified Memory Service) and ADR-009 (Hybrid Memory Backend)
+ */
+export {};
+//# sourceMappingURL=memory.interface.js.map

package/dist/core/interfaces/memory.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.interface.js","sourceRoot":"","sources":["../../../src/core/interfaces/memory.interface.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}