snow-flow 1.1.76 → 1.1.78

package/dist/mcp/shared/agent-context-provider.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Agent Context Provider for MCP Operations
+ * Provides agent context awareness and tracking for all MCP tools
+ */
+import { AgentContext } from './mcp-memory-manager.js';
+export interface MCPOperationContext {
+    session_id: string;
+    agent_id: string;
+    agent_type: string;
+    operation_name: string;
+    mcp_server: string;
+}
+export interface OperationResult<T = any> {
+    success: boolean;
+    data?: T;
+    error?: string;
+    duration_ms: number;
+    memory_updates?: Record<string, any>;
+}
+export declare class AgentContextProvider {
+    private memory;
+    private logger;
+    constructor();
+    /**
+     * Extract agent context from tool arguments or environment
+     */
+    extractAgentContext(args: any): AgentContext;
+    /**
+     * Execute an MCP operation with full agent context tracking
+     */
+    executeWithContext<T>(context: MCPOperationContext, operation: () => Promise<T>): Promise<OperationResult<T>>;
+    /**
+     * Report progress during long-running operations
+     */
+    reportProgress(context: AgentContext, progress: number, phase?: string): Promise<void>;
+    /**
+     * Notify other agents of handoff or completion
+     */
+    notifyHandoff(from_context: AgentContext, to_agent: string, artifact_info: {
+        type: string;
+        sys_id: string;
+        next_steps: string[];
+    }): Promise<void>;
+    /**
+     * Check for pending work from other agents
+     */
+    checkForHandoffs(context: AgentContext): Promise<any[]>;
+    /**
+     * Store artifact information with agent tracking
+     */
+    storeArtifact(context: AgentContext, artifact: {
+        sys_id: string;
+        type: string;
+        name: string;
+        description?: string;
+        config?: any;
+        update_set_id?: string;
+    }): Promise<void>;
+    /**
+     * Request Queen intervention for critical issues
+     */
+    requestQueenIntervention(context: AgentContext, issue: {
+        type: string;
+        priority: 'low' | 'medium' | 'high' | 'critical';
+        description: string;
+        attempted_solutions?: string[];
+    }): Promise<void>;
+    /**
+     * Get session artifacts created by all agents
+     */
+    getSessionArtifacts(session_id: string): Promise<any[]>;
+    /**
+     * Get current session context
+     */
+    getSessionContext(session_id: string): Promise<any>;
+}
+//# sourceMappingURL=agent-context-provider.d.ts.map

package/dist/mcp/shared/agent-context-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-context-provider.d.ts","sourceRoot":"","sources":["../../../src/mcp/shared/agent-context-provider.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAoB,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAGzE,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,GAAG;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACtC;AAED,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,MAAM,CAAS;;IAOvB;;OAEG;IACH,mBAAmB,CAAC,IAAI,EAAE,GAAG,GAAG,YAAY;IA2B5C;;OAEG;IACG,kBAAkB,CAAC,CAAC,EACxB,OAAO,EAAE,mBAAmB,EAC5B,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAC1B,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IAyE9B;;OAEG;IACG,cAAc,CAClB,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC;IA4BhB;;OAEG;IACG,aAAa,CACjB,YAAY,EAAE,YAAY,EAC1B,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE;QACb,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,EAAE,CAAC;KACtB,GACA,OAAO,CAAC,IAAI,CAAC;IAoChB;;OAEG;IACG,gBAAgB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAwB7D;;OAEG;IACG,aAAa,CACjB,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE;QACR,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,MAAM,CAAC,EAAE,GAAG,CAAC;QACb,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,GACA,OAAO,CAAC,IAAI,CAAC;IAiChB;;OAEG;IACG,wBAAwB,CAC5B,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;QACjD,WAAW,EAAE,MAAM,CAAC;QACpB,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;KAChC,GACA,OAAO,CAAC,IAAI,CAAC;IAiChB;;OAEG;IACG,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAS7D;;OAEG;IACG,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;CAQ1D"}

package/dist/mcp/shared/agent-context-provider.js

@@ -0,0 +1,292 @@
+"use strict";
+/**
+ * Agent Context Provider for MCP Operations
+ * Provides agent context awareness and tracking for all MCP tools
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentContextProvider = void 0;
+const mcp_memory_manager_js_1 = require("./mcp-memory-manager.js");
+const logger_js_1 = require("../../utils/logger.js");
+class AgentContextProvider {
+    constructor() {
+        this.memory = mcp_memory_manager_js_1.MCPMemoryManager.getInstance();
+        this.logger = new logger_js_1.Logger('AgentContextProvider');
+    }
+    /**
+     * Extract agent context from tool arguments or environment
+     */
+    extractAgentContext(args) {
+        // Check if agent context is provided in args
+        if (args.agent_context) {
+            return args.agent_context;
+        }
+        // Check for session_id and agent_id in args
+        if (args.session_id && args.agent_id) {
+            return {
+                session_id: args.session_id,
+                agent_id: args.agent_id,
+                agent_type: args.agent_type || 'unknown'
+            };
+        }
+        // Check environment variables (for backward compatibility)
+        const session_id = process.env.SNOW_FLOW_SESSION_ID || `session_${Date.now()}`;
+        const agent_id = process.env.SNOW_FLOW_AGENT_ID || `agent_${Date.now()}`;
+        const agent_type = process.env.SNOW_FLOW_AGENT_TYPE || 'mcp_direct';
+        return {
+            session_id,
+            agent_id,
+            agent_type
+        };
+    }
+    /**
+     * Execute an MCP operation with full agent context tracking
+     */
+    async executeWithContext(context, operation) {
+        const startTime = Date.now();
+        const { session_id, agent_id, operation_name } = context;
+        try {
+            // Update agent coordination - mark as active
+            await this.memory.updateAgentCoordination({
+                session_id,
+                agent_id,
+                agent_type: context.agent_type,
+                status: 'active',
+                current_tool: operation_name,
+                progress_percentage: 0
+            });
+            // Execute the operation
+            const result = await operation();
+            const duration = Date.now() - startTime;
+            // Track performance
+            await this.memory.trackPerformance({
+                session_id,
+                agent_id,
+                operation_name,
+                duration_ms: duration,
+                success: true
+            });
+            // Update progress
+            await this.memory.updateAgentCoordination({
+                session_id,
+                agent_id,
+                progress_percentage: 100,
+                current_tool: null
+            });
+            return {
+                success: true,
+                data: result,
+                duration_ms: duration
+            };
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            // Track failed operation
+            await this.memory.trackPerformance({
+                session_id,
+                agent_id,
+                operation_name,
+                duration_ms: duration,
+                success: false,
+                error_message: errorMessage
+            });
+            // Update agent status with error
+            await this.memory.updateAgentCoordination({
+                session_id,
+                agent_id,
+                status: 'blocked',
+                error_state: errorMessage,
+                current_tool: null
+            });
+            return {
+                success: false,
+                error: errorMessage,
+                duration_ms: duration
+            };
+        }
+    }
+    /**
+     * Report progress during long-running operations
+     */
+    async reportProgress(context, progress, phase) {
+        try {
+            await this.memory.updateAgentCoordination({
+                session_id: context.session_id,
+                agent_id: context.agent_id,
+                agent_type: context.agent_type,
+                progress_percentage: Math.min(100, Math.max(0, progress)),
+                current_tool: phase
+            });
+            // Optionally update shared context with detailed progress
+            if (phase) {
+                await this.memory.updateSharedContext({
+                    session_id: context.session_id,
+                    context_key: `${context.agent_id}_progress`,
+                    context_value: JSON.stringify({
+                        progress,
+                        phase,
+                        timestamp: new Date().toISOString()
+                    }),
+                    created_by_agent: context.agent_id
+                });
+            }
+        }
+        catch (error) {
+            this.logger.error('Failed to report progress', error);
+        }
+    }
+    /**
+     * Notify other agents of handoff or completion
+     */
+    async notifyHandoff(from_context, to_agent, artifact_info) {
+        try {
+            await this.memory.sendAgentMessage({
+                session_id: from_context.session_id,
+                from_agent: from_context.agent_id,
+                to_agent,
+                message_type: 'handoff',
+                content: JSON.stringify({
+                    artifact_type: artifact_info.type,
+                    artifact_sys_id: artifact_info.sys_id,
+                    next_steps: artifact_info.next_steps,
+                    handoff_time: new Date().toISOString()
+                }),
+                artifact_reference: artifact_info.sys_id
+            });
+            // Update shared context for the handoff
+            await this.memory.updateSharedContext({
+                session_id: from_context.session_id,
+                context_key: `${artifact_info.type}_ready_for_${to_agent}`,
+                context_value: JSON.stringify({
+                    sys_id: artifact_info.sys_id,
+                    ready: true,
+                    from_agent: from_context.agent_id,
+                    next_steps: artifact_info.next_steps
+                }),
+                created_by_agent: from_context.agent_id
+            });
+            this.logger.info(`Notified handoff from ${from_context.agent_id} to ${to_agent}`);
+        }
+        catch (error) {
+            this.logger.error('Failed to notify handoff', error);
+            throw error;
+        }
+    }
+    /**
+     * Check for pending work from other agents
+     */
+    async checkForHandoffs(context) {
+        try {
+            const messages = await this.memory.checkForMessages(context.agent_id, context.session_id);
+            const handoffs = messages
+                .filter(m => m.message_type === 'handoff')
+                .map(m => {
+                try {
+                    return JSON.parse(m.content);
+                }
+                catch {
+                    return m.content;
+                }
+            });
+            return handoffs;
+        }
+        catch (error) {
+            this.logger.error('Failed to check for handoffs', error);
+            return [];
+        }
+    }
+    /**
+     * Store artifact information with agent tracking
+     */
+    async storeArtifact(context, artifact) {
+        try {
+            await this.memory.storeArtifact({
+                sys_id: artifact.sys_id,
+                artifact_type: artifact.type,
+                name: artifact.name,
+                description: artifact.description,
+                created_by_agent: context.agent_id,
+                session_id: context.session_id,
+                deployment_status: 'created',
+                update_set_id: artifact.update_set_id,
+                metadata: artifact.config ? JSON.stringify(artifact.config) : undefined
+            });
+            // Update shared context
+            await this.memory.updateSharedContext({
+                session_id: context.session_id,
+                context_key: `${artifact.type}_${artifact.name}_created`,
+                context_value: JSON.stringify({
+                    sys_id: artifact.sys_id,
+                    created_by: context.agent_id,
+                    timestamp: new Date().toISOString()
+                }),
+                created_by_agent: context.agent_id
+            });
+            this.logger.info(`Stored artifact ${artifact.name} (${artifact.sys_id})`);
+        }
+        catch (error) {
+            this.logger.error('Failed to store artifact', error);
+            throw error;
+        }
+    }
+    /**
+     * Request Queen intervention for critical issues
+     */
+    async requestQueenIntervention(context, issue) {
+        try {
+            await this.memory.sendAgentMessage({
+                session_id: context.session_id,
+                from_agent: context.agent_id,
+                to_agent: 'queen_agent',
+                message_type: 'error',
+                content: JSON.stringify({
+                    issue_type: issue.type,
+                    priority: issue.priority,
+                    description: issue.description,
+                    attempted_solutions: issue.attempted_solutions || [],
+                    requesting_agent: context.agent_id,
+                    timestamp: new Date().toISOString()
+                })
+            });
+            // Update agent status to blocked
+            await this.memory.updateAgentCoordination({
+                session_id: context.session_id,
+                agent_id: context.agent_id,
+                agent_type: context.agent_type,
+                status: 'blocked',
+                error_state: issue.description
+            });
+            this.logger.warn(`Requested Queen intervention for ${issue.type}`);
+        }
+        catch (error) {
+            this.logger.error('Failed to request Queen intervention', error);
+            throw error;
+        }
+    }
+    /**
+     * Get session artifacts created by all agents
+     */
+    async getSessionArtifacts(session_id) {
+        try {
+            return await this.memory.getSessionArtifacts(session_id);
+        }
+        catch (error) {
+            this.logger.error('Failed to get session artifacts', error);
+            return [];
+        }
+    }
+    /**
+     * Get current session context
+     */
+    async getSessionContext(session_id) {
+        try {
+            return await this.memory.getSessionContext(session_id);
+        }
+        catch (error) {
+            this.logger.error('Failed to get session context', error);
+            return {};
+        }
+    }
+}
+exports.AgentContextProvider = AgentContextProvider;
+//# sourceMappingURL=agent-context-provider.js.map

package/dist/mcp/shared/agent-context-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-context-provider.js","sourceRoot":"","sources":["../../../src/mcp/shared/agent-context-provider.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,mEAAyE;AACzE,qDAA+C;AAkB/C,MAAa,oBAAoB;IAI/B;QACE,IAAI,CAAC,MAAM,GAAG,wCAAgB,CAAC,WAAW,EAAE,CAAC;QAC7C,IAAI,CAAC,MAAM,GAAG,IAAI,kBAAM,CAAC,sBAAsB,CAAC,CAAC;IACnD,CAAC;IAED;;OAEG;IACH,mBAAmB,CAAC,IAAS;QAC3B,6CAA6C;QAC7C,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,OAAO,IAAI,CAAC,aAAa,CAAC;QAC5B,CAAC;QAED,4CAA4C;QAC5C,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACrC,OAAO;gBACL,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,SAAS;aACzC,CAAC;QACJ,CAAC;QAED,2DAA2D;QAC3D,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,WAAW,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QAC/E,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,SAAS,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QACzE,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,YAAY,CAAC;QAEpE,OAAO;YACL,UAAU;YACV,QAAQ;YACR,UAAU;SACX,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,kBAAkB,CACtB,OAA4B,EAC5B,SAA2B;QAE3B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC;QAEzD,IAAI,CAAC;YACH,6CAA6C;YAC7C,MAAM,IAAI,CAAC,MAAM,CAAC,uBAAuB,CAAC;gBACxC,UAAU;gBACV,QAAQ;gBACR,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,MAAM,EAAE,QAAQ;gBAChB,YAAY,EAAE,cAAc;gBAC5B,mBAAmB,EAAE,CAAC;aACvB,CAAC,CAAC;YAEH,wBAAwB;YACxB,MAAM,MAAM,GAAG,MAAM,SAAS,EAAE,CAAC;YACjC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;YAExC,oBAAoB;YACpB,MAAM,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC;gBACjC,UAAU;gBACV,QAAQ;gBACR,cAAc;gBACd,WAAW,EAAE,QAAQ;gBACrB,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;YAEH,kBAAkB;YAClB,MAAM,IAAI,CAAC,MAAM,CAAC,uBAAuB,CAAC;gBACxC,UAAU;gBACV,QAAQ;gBACR,mBAAmB,EAAE,GAAG;gBACxB,YAAY,EAAE,IAAI;aACnB,CAAC,CAAC;YAEH,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE,MAAM;gBACZ,WAAW,EAAE,QAAQ;aACtB,CAAC;QAEJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;YACxC,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAE5E,yBAAyB;YACzB,MAAM,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC;gBACjC,UAAU;gBACV,QAAQ;gBACR,cAAc;gBACd,WAAW,EAAE,QAAQ;gBACrB,OAAO,EAAE,KAAK;gBACd,aAAa,EAAE,YAAY;aAC5B,CAAC,CAAC;YAEH,iCAAiC;YACjC,MAAM,IAAI,CAAC,MAAM,CAAC,uBAAuB,CAAC;gBACxC,UAAU;gBACV,QAAQ;gBACR,MAAM,EAAE,SAAS;gBACjB,WAAW,EAAE,YAAY;gBACzB,YAAY,EAAE,IAAI;aACnB,CAAC,CAAC;YAEH,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,YAAY;gBACnB,WAAW,EAAE,QAAQ;aACtB,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,cAAc,CAClB,OAAqB,EACrB,QAAgB,EAChB,KAAc;QAEd,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,MAAM,CAAC,uBAAuB,CAAC;gBACxC,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,mBAAmB,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;gBACzD,YAAY,EAAE,KAAK;aACpB,CAAC,CAAC;YAEH,0DAA0D;YAC1D,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC;oBACpC,UAAU,EAAE,OAAO,CAAC,UAAU;oBAC9B,WAAW,EAAE,GAAG,OAAO,CAAC,QAAQ,WAAW;oBAC3C,aAAa,EAAE,IAAI,CAAC,SAAS,CAAC;wBAC5B,QAAQ;wBACR,KAAK;wBACL,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;qBACpC,CAAC;oBACF,gBAAgB,EAAE,OAAO,CAAC,QAAQ;iBACnC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,2BAA2B,EAAE,KAAK,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CACjB,YAA0B,EAC1B,QAAgB,EAChB,aAIC;QAED,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC;gBACjC,UAAU,EAAE,YAAY,CAAC,UAAU;gBACnC,UAAU,EAAE,YAAY,CAAC,QAAQ;gBACjC,QAAQ;gBACR,YAAY,EAAE,SAAS;gBACvB,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC;oBACtB,aAAa,EAAE,aAAa,CAAC,IAAI;oBACjC,eAAe,EAAE,aAAa,CAAC,MAAM;oBACrC,UAAU,EAAE,aAAa,CAAC,UAAU;oBACpC,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;iBACvC,CAAC;gBACF,kBAAkB,EAAE,aAAa,CAAC,MAAM;aACzC,CAAC,CAAC;YAEH,wCAAwC;YACxC,MAAM,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC;gBACpC,UAAU,EAAE,YAAY,CAAC,UAAU;gBACnC,WAAW,EAAE,GAAG,aAAa,CAAC,IAAI,cAAc,QAAQ,EAAE;gBAC1D,aAAa,EAAE,IAAI,CAAC,SAAS,CAAC;oBAC5B,MAAM,EAAE,aAAa,CAAC,MAAM;oBAC5B,KAAK,EAAE,IAAI;oBACX,UAAU,EAAE,YAAY,CAAC,QAAQ;oBACjC,UAAU,EAAE,aAAa,CAAC,UAAU;iBACrC,CAAC;gBACF,gBAAgB,EAAE,YAAY,CAAC,QAAQ;aACxC,CAAC,CAAC;YAEH,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,yBAAyB,YAAY,CAAC,QAAQ,OAAO,QAAQ,EAAE,CAAC,CAAC;QACpF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,0BAA0B,EAAE,KAAK,CAAC,CAAC;YACrD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,gBAAgB,CAAC,OAAqB;QAC1C,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,gBAAgB,CACjD,OAAO,CAAC,QAAQ,EAChB,OAAO,CAAC,UAAU,CACnB,CAAC;YAEF,MAAM,QAAQ,GAAG,QAAQ;iBACtB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,KAAK,SAAS,CAAC;iBACzC,GAAG,CAAC,CAAC,CAAC,EAAE;gBACP,IAAI,CAAC;oBACH,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;gBAC/B,CAAC;gBAAC,MAAM,CAAC;oBACP,OAAO,CAAC,CAAC,OAAO,CAAC;gBACnB,CAAC;YACH,CAAC,CAAC,CAAC;YAEL,OAAO,QAAQ,CAAC;QAClB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,8BAA8B,EAAE,KAAK,CAAC,CAAC;YACzD,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CACjB,OAAqB,EACrB,QAOC;QAED,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC;gBAC9B,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,aAAa,EAAE,QAAQ,CAAC,IAAI;gBAC5B,IAAI,EAAE,QAAQ,CAAC,IAAI;gBACnB,WAAW,EAAE,QAAQ,CAAC,WAAW;gBACjC,gBAAgB,EAAE,OAAO,CAAC,QAAQ;gBAClC,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,iBAAiB,EAAE,SAAS;gBAC5B,aAAa,EAAE,QAAQ,CAAC,aAAa;gBACrC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS;aACxE,CAAC,CAAC;YAEH,wBAAwB;YACxB,MAAM,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC;gBACpC,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,WAAW,EAAE,GAAG,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,IAAI,UAAU;gBACxD,aAAa,EAAE,IAAI,CAAC,SAAS,CAAC;oBAC5B,MAAM,EAAE,QAAQ,CAAC,MAAM;oBACvB,UAAU,EAAE,OAAO,CAAC,QAAQ;oBAC5B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;iBACpC,CAAC;gBACF,gBAAgB,EAAE,OAAO,CAAC,QAAQ;aACnC,CAAC,CAAC;YAEH,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,mBAAmB,QAAQ,CAAC,IAAI,KAAK,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;QAC5E,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,0BAA0B,EAAE,KAAK,CAAC,CAAC;YACrD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,wBAAwB,CAC5B,OAAqB,EACrB,KAKC;QAED,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC;gBACjC,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,UAAU,EAAE,OAAO,CAAC,QAAQ;gBAC5B,QAAQ,EAAE,aAAa;gBACvB,YAAY,EAAE,OAAO;gBACrB,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC;oBACtB,UAAU,EAAE,KAAK,CAAC,IAAI;oBACtB,QAAQ,EAAE,KAAK,CAAC,QAAQ;oBACxB,WAAW,EAAE,KAAK,CAAC,WAAW;oBAC9B,mBAAmB,EAAE,KAAK,CAAC,mBAAmB,IAAI,EAAE;oBACpD,gBAAgB,EAAE,OAAO,CAAC,QAAQ;oBAClC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;iBACpC,CAAC;aACH,CAAC,CAAC;YAEH,iCAAiC;YACjC,MAAM,IAAI,CAAC,MAAM,CAAC,uBAAuB,CAAC;gBACxC,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,MAAM,EAAE,SAAS;gBACjB,WAAW,EAAE,KAAK,CAAC,WAAW;aAC/B,CAAC,CAAC;YAEH,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,oCAAoC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QACrE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,sCAAsC,EAAE,KAAK,CAAC,CAAC;YACjE,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,mBAAmB,CAAC,UAAkB;QAC1C,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,UAAU,CAAC,CAAC;QAC3D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,iCAAiC,EAAE,KAAK,CAAC,CAAC;YAC5D,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,iBAAiB,CAAC,UAAkB;QACxC,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;QACzD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,+BAA+B,EAAE,KAAK,CAAC,CAAC;YAC1D,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;CACF;AApVD,oDAoVC"}

package/dist/mcp/shared/base-mcp-server.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Base MCP Server with Agent Integration
+ * Provides common functionality for all MCP servers in the agent ecosystem
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { ServiceNowClient } from '../../utils/servicenow-client.js';
+import { ServiceNowOAuth } from '../../utils/snow-oauth.js';
+import { Logger } from '../../utils/logger.js';
+import { AgentContextProvider } from './agent-context-provider.js';
+import { MCPMemoryManager, AgentContext } from './mcp-memory-manager.js';
+export interface MCPToolResult {
+    content: Array<{
+        type: string;
+        text?: string;
+        data?: any;
+    }>;
+    metadata?: {
+        agent_id?: string;
+        session_id?: string;
+        duration_ms?: number;
+        artifacts_created?: string[];
+    };
+}
+export declare abstract class BaseMCPServer {
+    protected server: Server;
+    protected client: ServiceNowClient;
+    protected oauth: ServiceNowOAuth;
+    protected logger: Logger;
+    protected contextProvider: AgentContextProvider;
+    protected memory: MCPMemoryManager;
+    constructor(name: string, version?: string);
+    /**
+     * Execute a tool with agent context tracking
+     */
+    protected executeWithAgentContext<T>(toolName: string, args: any, operation: (context: AgentContext) => Promise<T>): Promise<MCPToolResult>;
+    /**
+     * Check authentication with proper error handling
+     */
+    protected checkAuthentication(): Promise<boolean>;
+    /**
+     * Create standard authentication error response
+     */
+    protected createAuthenticationError(): MCPToolResult;
+    /**
+     * Report progress during long operations
+     */
+    protected reportProgress(context: AgentContext, progress: number, phase: string): Promise<void>;
+    /**
+     * Store artifact with agent tracking
+     */
+    protected storeArtifact(context: AgentContext, artifact: {
+        sys_id: string;
+        type: string;
+        name: string;
+        description?: string;
+        config?: any;
+        update_set_id?: string;
+    }): Promise<void>;
+    /**
+     * Notify handoff to another agent
+     */
+    protected notifyHandoff(context: AgentContext, to_agent: string, artifact_info: {
+        type: string;
+        sys_id: string;
+        next_steps: string[];
+    }): Promise<void>;
+    /**
+     * Request Queen intervention for issues
+     */
+    protected requestQueenIntervention(context: AgentContext, issue: {
+        type: string;
+        priority: 'low' | 'medium' | 'high' | 'critical';
+        description: string;
+        attempted_solutions?: string[];
+    }): Promise<void>;
+    /**
+     * Get session context for coordination
+     */
+    protected getSessionContext(session_id: string): Promise<any>;
+    /**
+     * Create success response with metadata
+     */
+    protected createSuccessResponse(message: string, data?: any, metadata?: any): MCPToolResult;
+    /**
+     * Create error response with metadata
+     */
+    protected createErrorResponse(message: string, error?: any, metadata?: any): MCPToolResult;
+    /**
+     * Handle mock data removal - ensure real operations only
+     */
+    protected assertNoMockData(operation: string): void;
+    /**
+     * Start the MCP server
+     */
+    start(): Promise<void>;
+}
+//# sourceMappingURL=base-mcp-server.d.ts.map

package/dist/mcp/shared/base-mcp-server.d.ts.map

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