promptspeak-mcp-server 0.1.0

package/dist/tools/ps_calendar.js

@@ -0,0 +1,377 @@
+// ═══════════════════════════════════════════════════════════════════════════
+// PROMPTSPEAK MCP SERVER - LEGAL CALENDAR TOOLS
+// ═══════════════════════════════════════════════════════════════════════════
+// MCP tools for deadline extraction and calendar integration:
+// - ps_calendar_extract: Extract deadlines from legal documents
+// - ps_calendar_export: Export deadlines to iCal format
+// - ps_calendar_calculate: Calculate due dates from base dates
+//
+// ═══════════════════════════════════════════════════════════════════════════
+import { writeFileSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+import { createDeadlineExtractor, createICalGenerator, generateICalFromDeadlines, } from '../legal/index.js';
+// ─────────────────────────────────────────────────────────────────────────────
+// MODULE STATE
+// ─────────────────────────────────────────────────────────────────────────────
+let deadlineExtractor;
+let icalGenerator;
+function initializeIfNeeded() {
+    if (!deadlineExtractor) {
+        deadlineExtractor = createDeadlineExtractor();
+    }
+    if (!icalGenerator) {
+        icalGenerator = createICalGenerator();
+    }
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// TOOL DEFINITIONS
+// ─────────────────────────────────────────────────────────────────────────────
+export const calendarToolDefinitions = [
+    {
+        name: 'ps_calendar_extract',
+        description: `Extract legal deadlines from document content.
+
+Detects:
+- Explicit dates ("due by January 15, 2025")
+- Relative deadlines ("within 21 days of service")
+- FRCP rule references (Rule 12, 26, 33, 34, 56, etc.)
+- Hearing and trial dates
+
+Returns deadlines sorted by due date with priority levels.
+
+IMPORTANT: For relative deadlines, provide a baseDate (service/filing date) to calculate actual due dates.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                content: {
+                    type: 'string',
+                    description: 'The legal document content to extract deadlines from',
+                },
+                baseDate: {
+                    type: 'string',
+                    description: 'Base date for calculating relative deadlines (ISO format: YYYY-MM-DD). Usually the service date or filing date.',
+                },
+                matter: {
+                    type: 'string',
+                    description: 'Case/matter name to tag deadlines with',
+                },
+                court: {
+                    type: 'string',
+                    description: 'Court name',
+                },
+                caseNumber: {
+                    type: 'string',
+                    description: 'Case number',
+                },
+                courtRules: {
+                    type: 'string',
+                    enum: ['frcp', 'frap', 'california', 'texas', 'new_york', 'generic'],
+                    description: 'Court rules to use for deadline calculation (default: frcp)',
+                },
+            },
+            required: ['content'],
+        },
+    },
+    {
+        name: 'ps_calendar_export',
+        description: `Export extracted deadlines to iCal (.ics) format.
+
+The generated file can be imported into:
+- Apple Calendar
+- Google Calendar
+- Microsoft Outlook
+- Any iCal-compatible calendar app
+
+Events include appropriate reminders based on priority:
+- Critical: 1 week, 3 days, 1 day, 4 hours, 1 hour before
+- High: 3 days, 1 day, 4 hours before
+- Medium: 1 day, 2 hours before
+- Low: 1 day before`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                deadlines: {
+                    type: 'array',
+                    description: 'Array of deadlines to export (from ps_calendar_extract)',
+                    items: {
+                        type: 'object',
+                    },
+                },
+                filename: {
+                    type: 'string',
+                    description: 'Output filename (default: legal-deadlines.ics)',
+                },
+                calendarName: {
+                    type: 'string',
+                    description: 'Name for the calendar (default: Legal Deadlines)',
+                },
+                saveToFile: {
+                    type: 'boolean',
+                    description: 'Save to file in ~/Downloads (default: false, returns content)',
+                },
+            },
+            required: ['deadlines'],
+        },
+    },
+    {
+        name: 'ps_calendar_calculate',
+        description: `Calculate a due date from a base date and number of days.
+
+Supports different counting methods:
+- calendar: All days count
+- business: Excludes weekends
+- court: FRCP Rule 6(a) - excludes weekends/holidays for periods < 11 days
+
+Useful for manually calculating response deadlines.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                baseDate: {
+                    type: 'string',
+                    description: 'Starting date (ISO format: YYYY-MM-DD)',
+                },
+                days: {
+                    type: 'number',
+                    description: 'Number of days to add',
+                },
+                countingMethod: {
+                    type: 'string',
+                    enum: ['calendar', 'business', 'court'],
+                    description: 'How to count days (default: court)',
+                },
+                description: {
+                    type: 'string',
+                    description: 'Description of what this deadline is for',
+                },
+            },
+            required: ['baseDate', 'days'],
+        },
+    },
+    {
+        name: 'ps_calendar_frcp',
+        description: `Get FRCP deadline information for common rules.
+
+Returns the standard number of days and description for:
+- Rule 12 (Answer, Motion to Dismiss)
+- Rule 26 (Disclosures)
+- Rule 33 (Interrogatories)
+- Rule 34 (Document Requests)
+- Rule 36 (Admissions)
+- Rule 56 (Summary Judgment)
+- Rule 59 (New Trial)
+- Rule 60 (Relief from Judgment)`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                rule: {
+                    type: 'string',
+                    description: 'FRCP rule number (e.g., "12", "56")',
+                },
+                action: {
+                    type: 'string',
+                    description: 'Specific action (e.g., "answer", "response", "reply")',
+                },
+            },
+            required: ['rule'],
+        },
+    },
+];
+// ─────────────────────────────────────────────────────────────────────────────
+// HANDLER FUNCTIONS
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Extract deadlines from document content.
+ */
+export function handleCalendarExtract(args) {
+    initializeIfNeeded();
+    // Configure extractor
+    deadlineExtractor.setConfig({
+        defaultBaseDate: args.baseDate ? new Date(args.baseDate) : undefined,
+        matter: args.matter,
+        court: args.court,
+        caseNumber: args.caseNumber,
+        defaultCourtRules: args.courtRules ?? 'frcp',
+    });
+    // Extract deadlines
+    const result = deadlineExtractor.extract(args.content);
+    // Generate summary
+    const criticalCount = result.deadlines.filter(d => d.priority === 'critical').length;
+    const highCount = result.deadlines.filter(d => d.priority === 'high').length;
+    const estimatedCount = result.deadlines.filter(d => d.isEstimated).length;
+    let summary = `Found ${result.deadlines.length} deadline(s)`;
+    if (criticalCount > 0)
+        summary += ` (${criticalCount} critical)`;
+    if (highCount > 0)
+        summary += ` (${highCount} high priority)`;
+    if (estimatedCount > 0) {
+        summary += `\n⚠️ ${estimatedCount} deadline(s) have estimated dates - provide baseDate for accurate calculation`;
+    }
+    return {
+        ...result,
+        summary,
+    };
+}
+/**
+ * Export deadlines to iCal format.
+ */
+export function handleCalendarExport(args) {
+    initializeIfNeeded();
+    // Filter deadlines with due dates
+    const validDeadlines = args.deadlines.filter(d => d.dueDate);
+    if (validDeadlines.length === 0) {
+        return {
+            success: false,
+            eventCount: 0,
+            message: 'No deadlines with due dates to export. Provide baseDate when extracting to calculate due dates.',
+        };
+    }
+    // Configure generator
+    if (args.calendarName) {
+        icalGenerator.setConfig({ calendarName: args.calendarName });
+    }
+    // Generate iCal content
+    const icalContent = generateICalFromDeadlines(validDeadlines, {
+        calendarName: args.calendarName ?? 'Legal Deadlines',
+    });
+    // Save to file if requested
+    if (args.saveToFile) {
+        const filename = args.filename ?? 'legal-deadlines.ics';
+        const downloadsDir = join(homedir(), 'Downloads');
+        const filePath = join(downloadsDir, filename);
+        try {
+            writeFileSync(filePath, icalContent, 'utf-8');
+            return {
+                success: true,
+                filePath,
+                eventCount: validDeadlines.length,
+                message: `Saved ${validDeadlines.length} event(s) to ${filePath}. Double-click to import into your calendar.`,
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                content: icalContent,
+                eventCount: validDeadlines.length,
+                message: `Could not save to file: ${error}. iCal content returned in 'content' field.`,
+            };
+        }
+    }
+    return {
+        success: true,
+        content: icalContent,
+        eventCount: validDeadlines.length,
+        message: `Generated iCal with ${validDeadlines.length} event(s). Copy the 'content' field to a .ics file to import.`,
+    };
+}
+/**
+ * Calculate a due date from base date and days.
+ */
+export function handleCalendarCalculate(args) {
+    initializeIfNeeded();
+    const base = new Date(args.baseDate);
+    const method = args.countingMethod ?? 'court';
+    // Calculate due date
+    const dueDate = deadlineExtractor.calculateDueDate(base, args.days, method);
+    // Check for warnings
+    const warnings = [];
+    const dayOfWeek = dueDate.toLocaleDateString('en-US', { weekday: 'long' });
+    if (dayOfWeek === 'Saturday' || dayOfWeek === 'Sunday') {
+        warnings.push(`Due date falls on a ${dayOfWeek} - may extend to Monday`);
+    }
+    // Check if close to holiday
+    const dueDateStr = dueDate.toISOString().split('T')[0];
+    // (Holiday check would go here)
+    return {
+        baseDate: args.baseDate,
+        days: args.days,
+        countingMethod: method,
+        dueDate: dueDate.toISOString(),
+        dueDateFormatted: dueDate.toLocaleDateString('en-US', {
+            weekday: 'long',
+            year: 'numeric',
+            month: 'long',
+            day: 'numeric',
+        }),
+        dayOfWeek,
+        description: args.description,
+        warnings,
+    };
+}
+/**
+ * Get FRCP deadline information.
+ */
+export function handleCalendarFRCP(args) {
+    // FRCP deadline rules
+    const frcpRules = {
+        '12': [
+            { key: '12_answer', days: 21, type: 'response', description: 'Answer to complaint', countingMethod: 'court' },
+            { key: '12_motion', days: 21, type: 'response', description: 'Motion to dismiss', countingMethod: 'court' },
+            { key: '12_waiver', days: 60, type: 'response', description: 'Answer after waiver of service', countingMethod: 'calendar' },
+        ],
+        '26': [
+            { key: '26_disclosure', days: 14, type: 'disclosure', description: 'Initial disclosures after Rule 26(f) conference', countingMethod: 'court' },
+            { key: '26_expert', days: 90, type: 'disclosure', description: 'Expert disclosure (before trial)', countingMethod: 'calendar' },
+        ],
+        '33': [
+            { key: '33_response', days: 30, type: 'discovery', description: 'Response to interrogatories', countingMethod: 'calendar' },
+        ],
+        '34': [
+            { key: '34_response', days: 30, type: 'discovery', description: 'Response to document requests', countingMethod: 'calendar' },
+        ],
+        '36': [
+            { key: '36_response', days: 30, type: 'discovery', description: 'Response to requests for admission', countingMethod: 'calendar' },
+        ],
+        '56': [
+            { key: '56_response', days: 21, type: 'response', description: 'Opposition to summary judgment', countingMethod: 'court' },
+            { key: '56_reply', days: 14, type: 'reply', description: 'Reply in support of summary judgment', countingMethod: 'court' },
+        ],
+        '59': [
+            { key: '59_motion', days: 28, type: 'filing', description: 'Motion for new trial', countingMethod: 'calendar' },
+        ],
+        '60': [
+            { key: '60_motion', days: 365, type: 'filing', description: 'Motion for relief from judgment', countingMethod: 'calendar' },
+        ],
+    };
+    const ruleNum = args.rule.replace(/[^0-9]/g, '');
+    const deadlines = frcpRules[ruleNum] ?? [];
+    // Filter by action if specified
+    let filtered = deadlines;
+    if (args.action) {
+        const actionLower = args.action.toLowerCase();
+        filtered = deadlines.filter(d => d.description.toLowerCase().includes(actionLower) ||
+            d.type.includes(actionLower) ||
+            d.key.includes(actionLower));
+        if (filtered.length === 0) {
+            filtered = deadlines; // Return all if no match
+        }
+    }
+    const notes = [
+        'FRCP Rule 6(a): For periods < 11 days, exclude weekends and federal holidays.',
+        'For periods >= 11 days, count calendar days but extend if last day is weekend/holiday.',
+        'These are DEFAULT deadlines - always check court orders for modified deadlines.',
+    ];
+    return {
+        rule: `FRCP Rule ${ruleNum}`,
+        deadlines: filtered,
+        notes,
+    };
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// MAIN HANDLER
+// ─────────────────────────────────────────────────────────────────────────────
+export async function handleCalendarTool(toolName, args) {
+    switch (toolName) {
+        case 'ps_calendar_extract':
+            return handleCalendarExtract(args);
+        case 'ps_calendar_export':
+            return handleCalendarExport(args);
+        case 'ps_calendar_calculate':
+            return handleCalendarCalculate(args);
+        case 'ps_calendar_frcp':
+            return handleCalendarFRCP(args);
+        default:
+            throw new Error(`Unknown calendar tool: ${toolName}`);
+    }
+}
+//# sourceMappingURL=ps_calendar.js.map

package/dist/tools/ps_calendar.js.map

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

package/dist/tools/ps_delegate.d.ts

@@ -0,0 +1,83 @@
+/**
+ * ps_delegate Tool
+ *
+ * Handles delegation from parent agent to child agent.
+ * Enforces inheritance rules, mode strength preservation,
+ * and forbidden constraint propagation.
+ */
+export interface DelegateRequest {
+    parentAgentId: string;
+    childAgentId: string;
+    parentFrame: string;
+    childFrame: string;
+    task?: {
+        description: string;
+        constraints?: string[];
+        deadline?: number;
+    };
+    inheritanceMode?: 'strict' | 'relaxed' | 'custom';
+    customInheritance?: {
+        inheritMode: boolean;
+        inheritDomain: boolean;
+        inheritConstraints: boolean;
+        inheritPriority: boolean;
+    };
+}
+export interface DelegateResult {
+    success: boolean;
+    delegationId: string;
+    parentAgentId: string;
+    childAgentId: string;
+    parentFrame: string;
+    childFrame: string;
+    effectiveChildFrame: string;
+    validation: {
+        valid: boolean;
+        chainValid: boolean;
+        errors: string[];
+        warnings: string[];
+    };
+    inheritance: {
+        modeInherited: boolean;
+        domainInherited: boolean;
+        constraintsInherited: string[];
+        strengthPreserved: boolean;
+    };
+    childCircuitState: string;
+}
+export declare function ps_delegate(request: DelegateRequest): DelegateResult;
+interface DelegationRecord {
+    id: string;
+    parentAgentId: string;
+    childAgentId: string;
+    parentFrame: string;
+    childFrame: string;
+    effectiveChildFrame: string;
+    timestamp: number;
+    status: 'active' | 'completed' | 'revoked';
+}
+export interface RevokeRequest {
+    delegationId: string;
+    parentAgentId: string;
+    reason?: string;
+}
+export interface RevokeResult {
+    success: boolean;
+    delegationId: string;
+    childAgentId?: string;
+    message: string;
+}
+export declare function ps_delegate_revoke(request: RevokeRequest): RevokeResult;
+export interface ListDelegationsRequest {
+    agentId: string;
+    role?: 'parent' | 'child' | 'both';
+    status?: 'active' | 'completed' | 'revoked' | 'all';
+}
+export interface ListDelegationsResult {
+    agentId: string;
+    asParent: DelegationRecord[];
+    asChild: DelegationRecord[];
+}
+export declare function ps_delegate_list(request: ListDelegationsRequest): ListDelegationsResult;
+export {};
+//# sourceMappingURL=ps_delegate.d.ts.map

package/dist/tools/ps_delegate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ps_delegate.d.ts","sourceRoot":"","sources":["../../src/tools/ps_delegate.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAeH,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE;QACL,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;QACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,eAAe,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;IAClD,iBAAiB,CAAC,EAAE;QAClB,WAAW,EAAE,OAAO,CAAC;QACrB,aAAa,EAAE,OAAO,CAAC;QACvB,kBAAkB,EAAE,OAAO,CAAC;QAC5B,eAAe,EAAE,OAAO,CAAC;KAC1B,CAAC;CACH;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,UAAU,EAAE;QACV,KAAK,EAAE,OAAO,CAAC;QACf,UAAU,EAAE,OAAO,CAAC;QACpB,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;IACF,WAAW,EAAE;QACX,aAAa,EAAE,OAAO,CAAC;QACvB,eAAe,EAAE,OAAO,CAAC;QACzB,oBAAoB,EAAE,MAAM,EAAE,CAAC;QAC/B,iBAAiB,EAAE,OAAO,CAAC;KAC5B,CAAC;IACF,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAMD,wBAAgB,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,cAAc,CAmHpE;AAgID,UAAU,gBAAgB;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,QAAQ,GAAG,WAAW,GAAG,SAAS,CAAC;CAC5C;AAkCD,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,aAAa,GAAG,YAAY,CAyCvE;AAMD,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;IACnC,MAAM,CAAC,EAAE,QAAQ,GAAG,WAAW,GAAG,SAAS,GAAG,KAAK,CAAC;CACrD;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,OAAO,EAAE,gBAAgB,EAAE,CAAC;CAC7B;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,sBAAsB,GAAG,qBAAqB,CAuBvF"}