snow-flow 2.0.4 → 2.0.5

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

@@ -0,0 +1,179 @@
+/**
+ * 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[]>;
+    /**
+     * Create agent-specific namespaced key for memory isolation
+     * This prevents agents from overwriting each other's memory within the same session
+     */
+    private createNamespacedKey;
+    /**
+     * Parse namespaced key to extract original key and agent ID
+     */
+    private parseNamespacedKey;
+    /**
+     * Store shared context with agent isolation
+     */
+    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 with agent isolation support
+     */
+    getContext(session_id: string, context_key: string, requesting_agent?: 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