snow-flow 1.1.76 → 1.1.78

package/dist/memory/memory-client.js

@@ -0,0 +1,325 @@
+"use strict";
+/**
+ * Snow-Flow Memory Client
+ * Simple API for agents to interact with the memory system
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryClient = void 0;
+const logger_js_1 = require("../utils/logger.js");
+const swarm_memory_js_1 = require("./swarm-memory.js");
+const memory_operations_js_1 = require("./memory-operations.js");
+/**
+ * Singleton instance management
+ */
+let memoryInstance = null;
+let operationsInstance = null;
+class MemoryClient {
+    constructor(config = {}) {
+        this.logger = new logger_js_1.Logger('MemoryClient');
+        // Use singleton instances for memory and operations
+        if (!memoryInstance) {
+            memoryInstance = new swarm_memory_js_1.SwarmMemory(config);
+        }
+        if (!operationsInstance) {
+            operationsInstance = new memory_operations_js_1.MemoryOperations(memoryInstance);
+        }
+        this.memory = memoryInstance;
+        this.operations = operationsInstance;
+        // Set session and agent context
+        this.sessionId = config.sessionId || this.generateSessionId();
+        this.agentId = config.agentId || 'anonymous';
+        this.agentType = config.agentType || 'unknown';
+        this.logger.info('Memory client initialized', {
+            sessionId: this.sessionId,
+            agentId: this.agentId,
+            agentType: this.agentType
+        });
+    }
+    // ==================== Simple Context Storage ====================
+    /**
+     * Store data in shared context
+     */
+    async store(options) {
+        await this.operations.setContext(this.sessionId, options.key, options.value, this.agentId, options.expires, options.permissions);
+    }
+    /**
+     * Retrieve data from shared context
+     */
+    async retrieve(options) {
+        const context = await this.operations.getContext(this.sessionId, options.key);
+        if (!context) {
+            return options.defaultValue !== undefined ? options.defaultValue : null;
+        }
+        return context.context_value;
+    }
+    /**
+     * Get all context for current session
+     */
+    async getSessionData() {
+        const contexts = await this.operations.getSessionContext(this.sessionId);
+        const data = {};
+        for (const context of contexts) {
+            data[context.context_key] = context.context_value;
+        }
+        return data;
+    }
+    // ==================== Agent Coordination ====================
+    /**
+     * Register current agent
+     */
+    async register(assignedTasks = []) {
+        await this.operations.registerAgent(this.sessionId, this.agentId, this.agentType, assignedTasks);
+    }
+    /**
+     * Update agent progress
+     */
+    async updateProgress(percentage, currentTool) {
+        await this.operations.updateAgentStatus(this.sessionId, this.agentId, {
+            status: 'active',
+            progress_percentage: percentage,
+            current_tool: currentTool
+        });
+    }
+    /**
+     * Mark agent as completed
+     */
+    async complete() {
+        await this.operations.updateAgentStatus(this.sessionId, this.agentId, {
+            status: 'completed',
+            progress_percentage: 100
+        });
+    }
+    /**
+     * Report agent error
+     */
+    async reportError(error) {
+        await this.operations.updateAgentStatus(this.sessionId, this.agentId, {
+            status: 'failed',
+            error_state: error
+        });
+    }
+    /**
+     * Check if agent should wait for dependencies
+     */
+    async checkDependencies() {
+        const satisfied = await this.operations.checkDependenciesSatisfied(this.sessionId, this.agentId);
+        if (!satisfied) {
+            await this.operations.updateAgentStatus(this.sessionId, this.agentId, {
+                status: 'blocked'
+            });
+        }
+        return satisfied;
+    }
+    // ==================== Artifact Management ====================
+    /**
+     * Store ServiceNow artifact information
+     */
+    async storeArtifact(artifact) {
+        await this.operations.storeArtifact({
+            sys_id: artifact.sys_id,
+            artifact_type: artifact.type,
+            name: artifact.name,
+            description: artifact.description,
+            created_by_agent: this.agentId,
+            session_id: this.sessionId,
+            deployment_status: artifact.status || 'created',
+            update_set_id: artifact.update_set_id,
+            dependencies: artifact.dependencies ? JSON.stringify(artifact.dependencies) : undefined,
+            metadata: artifact.metadata ? JSON.stringify(artifact.metadata) : undefined
+        });
+    }
+    /**
+     * Update artifact status
+     */
+    async updateArtifactStatus(sys_id, status) {
+        await this.operations.updateArtifactStatus(sys_id, status);
+    }
+    /**
+     * Find artifacts created in current session
+     */
+    async findSessionArtifacts(type) {
+        const artifacts = await this.operations.searchArtifacts({
+            session_id: this.sessionId,
+            artifact_type: type
+        });
+        return artifacts.map(a => ({
+            sys_id: a.sys_id,
+            type: a.artifact_type,
+            name: a.name,
+            description: a.description,
+            status: a.deployment_status,
+            update_set_id: a.update_set_id,
+            dependencies: a.dependencies ? JSON.parse(a.dependencies) : undefined,
+            metadata: a.metadata ? JSON.parse(a.metadata) : undefined
+        }));
+    }
+    // ==================== Agent Communication ====================
+    /**
+     * Send handoff to another agent
+     */
+    async handoff(handoff) {
+        await this.operations.sendMessage(this.sessionId, this.agentId, handoff.to_agent, 'handoff', handoff.data, handoff.artifact_reference);
+    }
+    /**
+     * Check for incoming handoffs
+     */
+    async checkHandoffs() {
+        const messages = await this.operations.getUnprocessedMessages(this.agentId, this.sessionId);
+        const handoffs = messages.filter(m => m.message_type === 'handoff');
+        const results = handoffs.map(h => ({
+            from: h.from_agent,
+            data: typeof h.content === 'string' ? JSON.parse(h.content) : h.content,
+            artifact_reference: h.artifact_reference
+        }));
+        // Mark messages as processed
+        for (const handoff of handoffs) {
+            await this.operations.markMessageProcessed(handoff.id);
+        }
+        return results;
+    }
+    /**
+     * Send status update
+     */
+    async sendStatus(status, details) {
+        await this.operations.sendMessage(this.sessionId, this.agentId, 'queen', // Always send status to Queen
+        'status_update', { status, details });
+    }
+    /**
+     * Report dependency ready
+     */
+    async reportDependencyReady(dependent_agent, artifact_reference) {
+        await this.operations.sendMessage(this.sessionId, this.agentId, dependent_agent, 'dependency_ready', { ready: true }, artifact_reference);
+        // Also update dependency status
+        await this.operations.satisfyDependency(this.sessionId, dependent_agent, this.agentId);
+    }
+    // ==================== Performance Tracking ====================
+    /**
+     * Start tracking an operation
+     */
+    trackOperation(operation) {
+        const tracking = this.operations.startPerformanceTracking(this.sessionId, this.agentId, operation);
+        return {
+            complete: async (success, error, metadata) => {
+                await this.operations.completePerformanceTracking(tracking, this.sessionId, this.agentId, operation, success, error, metadata);
+            }
+        };
+    }
+    /**
+     * Get average performance for an operation
+     */
+    async getPerformanceStats(operation) {
+        const stats = await this.operations.getAveragePerformance(operation, this.sessionId);
+        if (!stats)
+            return null;
+        return {
+            avgDuration: stats.avg_duration_ms,
+            successRate: stats.success_rate,
+            totalOperations: stats.total_operations
+        };
+    }
+    // ==================== Deployment Tracking ====================
+    /**
+     * Record successful deployment
+     */
+    async recordDeployment(artifact_sys_id, type, success = true, error) {
+        await this.operations.recordDeployment(this.sessionId, artifact_sys_id, type, this.agentId, success, error, type === 'create' || type === 'update' // Rollback available for create/update
+        );
+    }
+    /**
+     * Get deployment history for an artifact
+     */
+    async getDeploymentHistory(artifact_sys_id) {
+        const history = await this.operations.getDeploymentHistory(artifact_sys_id);
+        return history.map(h => ({
+            type: h.deployment_type,
+            success: h.success,
+            time: new Date(h.deployment_time),
+            agent: h.agent_id,
+            error: h.error_details
+        }));
+    }
+    // ==================== Session Management ====================
+    /**
+     * Get current session ID
+     */
+    getSessionId() {
+        return this.sessionId;
+    }
+    /**
+     * Get current agent ID
+     */
+    getAgentId() {
+        return this.agentId;
+    }
+    /**
+     * Get complete session state
+     */
+    async getSessionState() {
+        return this.operations.getSessionState(this.sessionId);
+    }
+    /**
+     * Clean up current session
+     */
+    async cleanup() {
+        await this.operations.cleanupSession(this.sessionId);
+    }
+    // ==================== Analytics ====================
+    /**
+     * Get memory statistics
+     */
+    getStats() {
+        return this.memory.getStats();
+    }
+    /**
+     * Run memory cleanup
+     */
+    async runCleanup() {
+        this.memory.cleanup();
+    }
+    // ==================== Raw Access ====================
+    /**
+     * Get direct access to operations (for advanced use cases)
+     */
+    getOperations() {
+        return this.operations;
+    }
+    /**
+     * Get direct access to database (for custom queries)
+     */
+    getDatabase() {
+        return this.memory;
+    }
+    // ==================== Static Methods ====================
+    /**
+     * Create a memory client for an agent
+     */
+    static forAgent(agentId, agentType, sessionId) {
+        return new MemoryClient({
+            agentId,
+            agentType,
+            sessionId
+        });
+    }
+    /**
+     * Create a memory client for a session
+     */
+    static forSession(sessionId) {
+        return new MemoryClient({ sessionId });
+    }
+    /**
+     * Close all connections (call when shutting down)
+     */
+    static shutdown() {
+        if (memoryInstance) {
+            memoryInstance.close();
+            memoryInstance = null;
+            operationsInstance = null;
+        }
+    }
+    // ==================== Private Methods ====================
+    generateSessionId() {
+        return `session_${Date.now()}_${Math.random().toString(36).substring(2, 9)}`;
+    }
+}
+exports.MemoryClient = MemoryClient;
+//# sourceMappingURL=memory-client.js.map

package/dist/memory/memory-client.js.map

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

package/dist/memory/memory-operations.d.ts

@@ -0,0 +1,170 @@
+/**
+ * Snow-Flow Memory Operations
+ * High-level operations for agent coordination and data management
+ */
+import { SwarmMemory, AgentCoordination, ServiceNowArtifactRecord, AgentMessage, SharedContext, DeploymentHistory, AgentDependency, PerformanceMetric } from './swarm-memory.js';
+export interface AgentCoordinationUpdate {
+    status?: AgentCoordination['status'];
+    progress_percentage?: number;
+    current_tool?: string;
+    error_state?: string;
+    assigned_tasks?: string;
+}
+export interface ArtifactSearchOptions {
+    session_id?: string;
+    artifact_type?: ServiceNowArtifactRecord['artifact_type'];
+    deployment_status?: ServiceNowArtifactRecord['deployment_status'];
+    created_by_agent?: string;
+    limit?: number;
+}
+export interface MessageSearchOptions {
+    session_id?: string;
+    to_agent?: string;
+    from_agent?: string;
+    message_type?: AgentMessage['message_type'];
+    processed?: boolean;
+    limit?: number;
+}
+export interface PerformanceQuery {
+    session_id?: string;
+    agent_id?: string;
+    operation_name?: string;
+    success?: boolean;
+    start_time?: Date;
+    end_time?: Date;
+    limit?: number;
+}
+export declare class MemoryOperations {
+    private memory;
+    private logger;
+    constructor(memory: SwarmMemory);
+    /**
+     * Register a new agent in the coordination system
+     */
+    registerAgent(session_id: string, agent_id: string, agent_type: string, assigned_tasks?: string[]): Promise<void>;
+    /**
+     * Update agent status and progress
+     */
+    updateAgentStatus(session_id: string, agent_id: string, updates: AgentCoordinationUpdate): Promise<void>;
+    /**
+     * Get all active agents for a session
+     */
+    getActiveAgents(session_id: string): Promise<AgentCoordination[]>;
+    /**
+     * Get agent coordination status
+     */
+    getAgentStatus(session_id: string, agent_id: string): Promise<AgentCoordination | null>;
+    /**
+     * Store a ServiceNow artifact
+     */
+    storeArtifact(artifact: Omit<ServiceNowArtifactRecord, 'created_at' | 'updated_at'>): Promise<void>;
+    /**
+     * Update artifact deployment status
+     */
+    updateArtifactStatus(sys_id: string, deployment_status: ServiceNowArtifactRecord['deployment_status']): Promise<void>;
+    /**
+     * Search for artifacts
+     */
+    searchArtifacts(options?: ArtifactSearchOptions): Promise<ServiceNowArtifactRecord[]>;
+    /**
+     * Get artifact by sys_id
+     */
+    getArtifact(sys_id: string): Promise<ServiceNowArtifactRecord | null>;
+    /**
+     * Send a message between agents
+     */
+    sendMessage(session_id: string, from_agent: string, to_agent: string, message_type: AgentMessage['message_type'], content: any, artifact_reference?: string): Promise<string>;
+    /**
+     * Get unprocessed messages for an agent
+     */
+    getUnprocessedMessages(to_agent: string, session_id?: string): Promise<AgentMessage[]>;
+    /**
+     * Mark message as processed
+     */
+    markMessageProcessed(message_id: string): Promise<void>;
+    /**
+     * Search messages
+     */
+    searchMessages(options?: MessageSearchOptions): Promise<AgentMessage[]>;
+    /**
+     * Store shared context
+     */
+    setContext(session_id: string, context_key: string, context_value: any, created_by_agent: string, expires_at?: Date, access_permissions?: string[]): Promise<void>;
+    /**
+     * Get shared context
+     */
+    getContext(session_id: string, context_key: string): Promise<SharedContext | null>;
+    /**
+     * Get all context for a session
+     */
+    getSessionContext(session_id: string): Promise<SharedContext[]>;
+    /**
+     * Record deployment event
+     */
+    recordDeployment(session_id: string, artifact_sys_id: string, deployment_type: DeploymentHistory['deployment_type'], agent_id: string, success: boolean, error_details?: string, rollback_available?: boolean): Promise<string>;
+    /**
+     * Get deployment history for an artifact
+     */
+    getDeploymentHistory(artifact_sys_id: string): Promise<DeploymentHistory[]>;
+    /**
+     * Get latest deployment for an artifact
+     */
+    getLatestDeployment(artifact_sys_id: string): Promise<DeploymentHistory | null>;
+    /**
+     * Add agent dependency
+     */
+    addDependency(session_id: string, agent_id: string, depends_on_agent: string, dependency_type: AgentDependency['dependency_type'], artifact_reference?: string): Promise<void>;
+    /**
+     * Mark dependency as satisfied
+     */
+    satisfyDependency(session_id: string, agent_id: string, depends_on_agent: string): Promise<void>;
+    /**
+     * Get pending dependencies for an agent
+     */
+    getPendingDependencies(session_id: string, agent_id: string): Promise<AgentDependency[]>;
+    /**
+     * Check if all dependencies are satisfied
+     */
+    checkDependenciesSatisfied(session_id: string, agent_id: string): Promise<boolean>;
+    /**
+     * Start performance tracking
+     */
+    startPerformanceTracking(session_id: string, agent_id: string, operation_name: string): {
+        id: string;
+        startTime: number;
+    };
+    /**
+     * Complete performance tracking
+     */
+    completePerformanceTracking(tracking: {
+        id: string;
+        startTime: number;
+    }, session_id: string, agent_id: string, operation_name: string, success: boolean, error_message?: string, metadata?: any): Promise<void>;
+    /**
+     * Query performance metrics
+     */
+    queryPerformanceMetrics(query?: PerformanceQuery): Promise<PerformanceMetric[]>;
+    /**
+     * Get average performance for an operation
+     */
+    getAveragePerformance(operation_name: string, session_id?: string): Promise<{
+        avg_duration_ms: number;
+        success_rate: number;
+        total_operations: number;
+    } | null>;
+    /**
+     * Get complete session state
+     */
+    getSessionState(session_id: string): Promise<{
+        agents: AgentCoordination[];
+        artifacts: ServiceNowArtifactRecord[];
+        pendingMessages: number;
+        activeContext: SharedContext[];
+        performanceSummary: any;
+    }>;
+    /**
+     * Clean up session data
+     */
+    cleanupSession(session_id: string): Promise<void>;
+}
+//# sourceMappingURL=memory-operations.d.ts.map

package/dist/memory/memory-operations.d.ts.map

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