specmem-hardwicksoftware 3.5.99

package/dist/mcp/tools/teamComms.d.ts

@@ -0,0 +1,444 @@
+/**
+ * Team Communication MCP Tools (PostgreSQL-backed)
+ *
+ * REPLACES HTTP-BASED TEAM_MEMBER COMMUNICATION with MCP tool-based communication.
+ * All inter-team-member communication MUST go through these MCP tools.
+ *
+ * This is the Slack-like communication system for team members (formerly team members).
+ * Messages are stored in PostgreSQL with channel/threading support.
+ *
+ * Tools:
+ * - send_team_message: Send messages to team channel (replaces HTTP POST)
+ * - read_team_messages: Read messages from team channels (replaces HTTP GET)
+ * - claim_task: Claim a task/file to work on
+ * - release_task: Release a claimed task
+ * - get_team_status: Show what everyone is working on
+ * - request_help: Broadcast help request to team
+ * - respond_to_help: Respond to help requests
+ * - broadcast_to_team: Broadcast status/progress to all
+ *
+ * Database tables:
+ * - team_channels: Slack-like channels (by task_id or project)
+ * - team_messages: Messages with threading support
+ * - task_claims: Active file/task claims
+ * - help_requests: Open help requests
+ *
+ * @author hardwicksoftwareservices
+ */
+import { MCPTool } from '../toolRegistry.js';
+import pg from 'pg';
+type TeamMessageType = 'status' | 'question' | 'update' | 'broadcast' | 'help_request' | 'help_response';
+type MessagePriority = 'low' | 'normal' | 'high' | 'urgent';
+/**
+ * Get the session start timestamp.
+ * Returns the time when initTeamCommsDB was called for this session.
+ * If not initialized, returns epoch (includes all messages).
+ */
+export declare function getSessionStartTime(): Date;
+/**
+ * Reset session start time (useful for testing or explicit session restart).
+ * Call this before deploying new agents to ensure they start fresh.
+ */
+export declare function resetSessionStartTime(): void;
+/**
+ * Initialize the team communications database schema
+ * Creates tables for channels, messages, claims, and help requests
+ *
+ * CRITICAL: Sets search_path to project schema FIRST to avoid polluting public schema!
+ * This ensures all tables are created in the correct project-isolated schema.
+ */
+export declare function initTeamCommsDB(pool: pg.Pool): Promise<void>;
+interface SendTeamMessageInput {
+    message: string;
+    type?: TeamMessageType;
+    priority?: MessagePriority;
+    channel?: string;
+    task_id?: string;
+    project_id?: string;
+    thread_id?: string;
+    sender_name?: string;
+}
+interface SendTeamMessageOutput {
+    [key: string]: any;
+}
+export declare class SendTeamMessage implements MCPTool<SendTeamMessageInput, SendTeamMessageOutput> {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            message: {
+                type: string;
+                description: string;
+            };
+            type: {
+                type: string;
+                enum: string[];
+                description: string;
+                default: string;
+            };
+            priority: {
+                type: string;
+                enum: string[];
+                description: string;
+                default: string;
+            };
+            channel: {
+                type: string;
+                enum: string[];
+                description: string;
+                default: string;
+            };
+            task_id: {
+                type: string;
+                description: string;
+            };
+            project_id: {
+                type: string;
+                description: string;
+            };
+            thread_id: {
+                type: string;
+                description: string;
+            };
+            sender_name: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    execute(params: SendTeamMessageInput): Promise<SendTeamMessageOutput>;
+}
+interface ReadTeamMessagesInput {
+    limit?: number;
+    since?: string;
+    channel?: string;
+    task_id?: string;
+    project_id?: string;
+    mentions_only?: boolean;
+    unread_only?: boolean;
+    include_broadcasts?: boolean;
+    include_main?: boolean;
+    include_swarms?: boolean;
+    compress?: boolean;
+}
+interface ReadTeamMessagesOutput {
+    [key: string]: any;
+}
+export declare class ReadTeamMessages implements MCPTool<ReadTeamMessagesInput, ReadTeamMessagesOutput> {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            limit: {
+                type: string;
+                description: string;
+                default: number;
+            };
+            since: {
+                type: string;
+                description: string;
+            };
+            task_id: {
+                type: string;
+                description: string;
+            };
+            project_id: {
+                type: string;
+                description: string;
+            };
+            mentions_only: {
+                type: string;
+                description: string;
+                default: boolean;
+            };
+            unread_only: {
+                type: string;
+                description: string;
+                default: boolean;
+            };
+            include_broadcasts: {
+                type: string;
+                description: string;
+                default: boolean;
+            };
+            include_swarms: {
+                type: string;
+                description: string;
+                default: boolean;
+            };
+            channel: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            compress: {
+                type: string;
+                description: string;
+                default: boolean;
+            };
+        };
+        required: any[];
+    };
+    execute(params: ReadTeamMessagesInput): Promise<ReadTeamMessagesOutput>;
+}
+interface BroadcastToTeamInput {
+    message: string;
+    broadcast_type?: 'status' | 'progress' | 'announcement';
+    priority?: MessagePriority;
+    metadata?: Record<string, unknown>;
+    /** If true, broadcast to ALL projects (use sparingly for system-wide announcements) */
+    cross_project?: boolean;
+}
+interface BroadcastToTeamOutput {
+    content?: Array<{
+        type: string;
+        text: string;
+    }>;
+    _REMINDER?: string;
+    success?: boolean;
+    messageId?: string;
+    timestamp?: string;
+    channel?: string;
+}
+export declare class BroadcastToTeam implements MCPTool<BroadcastToTeamInput, BroadcastToTeamOutput> {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            message: {
+                type: string;
+                description: string;
+            };
+            broadcast_type: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            priority: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            metadata: {
+                type: string;
+                description: string;
+            };
+            cross_project: {
+                type: string;
+                description: string;
+                default: boolean;
+            };
+        };
+        required: string[];
+    };
+    execute(params: BroadcastToTeamInput): Promise<BroadcastToTeamOutput>;
+}
+interface ClaimTaskInput {
+    description: string;
+    files?: string[];
+}
+interface ClaimTaskOutput {
+    _REMINDER?: string;
+    success: boolean;
+    claimId: string;
+    description: string;
+    files: string[];
+    timestamp: string;
+    warnings: string[];
+}
+export declare class ClaimTask implements MCPTool<ClaimTaskInput, ClaimTaskOutput> {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            description: {
+                type: string;
+                description: string;
+            };
+            files: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    execute(params: ClaimTaskInput): Promise<ClaimTaskOutput>;
+}
+interface ReleaseTaskInput {
+    claimId: string;
+    files?: string[];
+}
+interface ReleaseTaskOutput {
+    _REMINDER?: string;
+    success: boolean;
+    releasedClaims: string[];
+    message: string;
+}
+export declare class ReleaseTask implements MCPTool<ReleaseTaskInput, ReleaseTaskOutput> {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            claimId: {
+                type: string;
+                description: string;
+            };
+            files: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    execute(params: ReleaseTaskInput): Promise<ReleaseTaskOutput>;
+}
+interface GetTeamStatusInput {
+}
+interface GetTeamStatusOutput {
+    [key: string]: any;
+}
+export declare class GetTeamStatus implements MCPTool<GetTeamStatusInput, GetTeamStatusOutput> {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {};
+        required: any[];
+    };
+    execute(_params: GetTeamStatusInput): Promise<GetTeamStatusOutput>;
+}
+interface RequestHelpInput {
+    question: string;
+    context?: string;
+    skills_needed?: string[];
+}
+interface RequestHelpOutput {
+    _REMINDER?: string;
+    success: boolean;
+    requestId: string;
+    timestamp: string;
+    message: string;
+}
+export declare class RequestHelp implements MCPTool<RequestHelpInput, RequestHelpOutput> {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            question: {
+                type: string;
+                description: string;
+            };
+            context: {
+                type: string;
+                description: string;
+            };
+            skills_needed: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    execute(params: RequestHelpInput): Promise<RequestHelpOutput>;
+}
+interface RespondToHelpInput {
+    requestId: string;
+    response: string;
+}
+interface RespondToHelpOutput {
+    _REMINDER?: string;
+    success: boolean;
+    responseId: string;
+    requestId: string;
+    timestamp: string;
+    message: string;
+}
+export declare class RespondToHelp implements MCPTool<RespondToHelpInput, RespondToHelpOutput> {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            requestId: {
+                type: string;
+                description: string;
+            };
+            response: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    execute(params: RespondToHelpInput): Promise<RespondToHelpOutput>;
+}
+interface ClearTeamMessagesInput {
+    confirm: boolean;
+    older_than_minutes?: number;
+    clear_claims?: boolean;
+    clear_help_requests?: boolean;
+}
+interface ClearTeamMessagesOutput {
+    _REMINDER?: string;
+    success: boolean;
+    messagesDeleted: number;
+    claimsCleared: number;
+    helpRequestsCleared: number;
+    message: string;
+}
+export declare class ClearTeamMessages implements MCPTool<ClearTeamMessagesInput, ClearTeamMessagesOutput> {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            confirm: {
+                type: string;
+                description: string;
+            };
+            older_than_minutes: {
+                type: string;
+                description: string;
+            };
+            clear_claims: {
+                type: string;
+                description: string;
+                default: boolean;
+            };
+            clear_help_requests: {
+                type: string;
+                description: string;
+                default: boolean;
+            };
+        };
+        required: string[];
+    };
+    execute(params: ClearTeamMessagesInput): Promise<ClearTeamMessagesOutput>;
+}
+export declare const teamCommTools: (typeof BroadcastToTeam | typeof ClaimTask | typeof ReleaseTask | typeof GetTeamStatus | typeof RequestHelp | typeof RespondToHelp | typeof ClearTeamMessages)[];
+/**
+ * Create instances of all team communication tools
+ */
+export declare function createTeamCommTools(): MCPTool[];
+/**
+ * Initialize team comms with database pool and return tools
+ */
+export declare function createTeamCommToolsWithDB(pool: pg.Pool): Promise<MCPTool[]>;
+export {};
+//# sourceMappingURL=teamComms.d.ts.map

package/dist/mcp/tools/teamComms.d.ts.map

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