promptspeak-mcp-server 0.1.0

package/dist/tools/ps_hold.d.ts

@@ -0,0 +1,50 @@
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { HoldRequest, HoldDecision, ExecutionControlConfig } from '../types/index.js';
+import { holdManager } from '../gatekeeper/hold-manager.js';
+export declare const holdToolDefinitions: Tool[];
+export declare function handleHoldList(args: {
+    agentId?: string;
+    includeExpired?: boolean;
+}): Promise<{
+    holds: HoldRequest[];
+    count: number;
+    expiredCount: number;
+}>;
+export declare function handleHoldApprove(args: {
+    holdId: string;
+    reason?: string;
+    modifiedFrame?: string;
+    modifiedArgs?: Record<string, unknown>;
+    executeNow?: boolean;
+}): Promise<{
+    success: boolean;
+    decision?: HoldDecision;
+    executionResult?: unknown;
+    error?: string;
+}>;
+export declare function handleHoldReject(args: {
+    holdId: string;
+    reason?: string;
+    haltAgent?: boolean;
+}): Promise<{
+    success: boolean;
+    decision?: HoldDecision;
+    agentHalted?: boolean;
+    error?: string;
+}>;
+export declare function handleHoldConfig(args: {
+    action: 'get' | 'set';
+    config?: Partial<ExecutionControlConfig>;
+}): Promise<{
+    success: boolean;
+    config: ExecutionControlConfig;
+    error?: string;
+}>;
+export declare function handleHoldStats(args: {
+    historyLimit?: number;
+}): Promise<{
+    stats: ReturnType<typeof holdManager.getStats>;
+    history: HoldDecision[];
+}>;
+export declare function handleHoldTool(name: string, args: Record<string, unknown>): Promise<unknown>;
+//# sourceMappingURL=ps_hold.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ps_hold.d.ts","sourceRoot":"","sources":["../../src/tools/ps_hold.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3F,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAO5D,eAAO,MAAM,mBAAmB,EAAE,IAAI,EAoHrC,CAAC;AAMF,wBAAsB,cAAc,CAAC,IAAI,EAAE;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,GAAG,OAAO,CAAC;IACV,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC,CAaD;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,GAAG,OAAO,CAAC;IACV,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC,CAsCD;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,GAAG,OAAO,CAAC;IACV,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC,CAyBD;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,MAAM,EAAE,KAAK,GAAG,KAAK,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,CAAC;CAC1C,GAAG,OAAO,CAAC;IACV,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,sBAAsB,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC,CASD;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC;IACV,KAAK,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC/C,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB,CAAC,CAKD;AAMD,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,OAAO,CAAC,CAelB"}

package/dist/tools/ps_hold.js

@@ -0,0 +1,227 @@
+// ═══════════════════════════════════════════════════════════════════════════
+// PROMPTSPEAK MCP SERVER - HOLD MANAGEMENT TOOLS
+// ═══════════════════════════════════════════════════════════════════════════
+// MCP tools for managing human-in-the-loop holds:
+// - ps_hold_list: List pending holds awaiting approval
+// - ps_hold_approve: Approve a held execution
+// - ps_hold_reject: Reject a held execution
+// - ps_hold_config: Configure hold behavior
+// ═══════════════════════════════════════════════════════════════════════════
+import { holdManager } from '../gatekeeper/hold-manager.js';
+import { gatekeeper } from '../gatekeeper/index.js';
+// ─────────────────────────────────────────────────────────────────────────────
+// TOOL DEFINITIONS
+// ─────────────────────────────────────────────────────────────────────────────
+export const holdToolDefinitions = [
+    {
+        name: 'ps_hold_list',
+        description: 'List all pending holds awaiting human approval. Returns holds for risky operations that were blocked pending review.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                agentId: {
+                    type: 'string',
+                    description: 'Optional: Filter holds by agent ID',
+                },
+                includeExpired: {
+                    type: 'boolean',
+                    description: 'Include expired holds in the list (default: false)',
+                },
+            },
+            required: [],
+        },
+    },
+    {
+        name: 'ps_hold_approve',
+        description: 'Approve a held execution request. The operation will proceed with optional modifications.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                holdId: {
+                    type: 'string',
+                    description: 'The hold ID to approve',
+                },
+                reason: {
+                    type: 'string',
+                    description: 'Reason for approval (for audit trail)',
+                },
+                modifiedFrame: {
+                    type: 'string',
+                    description: 'Optional: Modified frame to use instead of original',
+                },
+                modifiedArgs: {
+                    type: 'object',
+                    description: 'Optional: Modified arguments to use instead of original',
+                },
+                executeNow: {
+                    type: 'boolean',
+                    description: 'Execute immediately after approval (default: true)',
+                },
+            },
+            required: ['holdId'],
+        },
+    },
+    {
+        name: 'ps_hold_reject',
+        description: 'Reject a held execution request. The operation will not proceed.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                holdId: {
+                    type: 'string',
+                    description: 'The hold ID to reject',
+                },
+                reason: {
+                    type: 'string',
+                    description: 'Reason for rejection (for audit trail)',
+                },
+                haltAgent: {
+                    type: 'boolean',
+                    description: 'Also halt the agent that made the request (default: false)',
+                },
+            },
+            required: ['holdId'],
+        },
+    },
+    {
+        name: 'ps_hold_config',
+        description: 'Configure hold behavior and thresholds. Controls when operations are held for human review.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                action: {
+                    type: 'string',
+                    enum: ['get', 'set'],
+                    description: 'Get current config or set new config',
+                },
+                config: {
+                    type: 'object',
+                    description: 'Configuration to set (only for action=set)',
+                    properties: {
+                        holdOnDriftPrediction: { type: 'boolean' },
+                        holdOnLowConfidence: { type: 'boolean' },
+                        holdOnForbiddenWithOverride: { type: 'boolean' },
+                        holdTimeoutMs: { type: 'number' },
+                        driftPredictionThreshold: { type: 'number' },
+                        baselineDeviationThreshold: { type: 'number' },
+                        enableMcpValidation: { type: 'boolean' },
+                        mcpValidationTools: { type: 'array', items: { type: 'string' } },
+                        haltOnCriticalDrift: { type: 'boolean' },
+                        haltOnHighDrift: { type: 'boolean' },
+                    },
+                },
+            },
+            required: ['action'],
+        },
+    },
+    {
+        name: 'ps_hold_stats',
+        description: 'Get hold statistics and history.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                historyLimit: {
+                    type: 'number',
+                    description: 'Number of historical decisions to return (default: 10)',
+                },
+            },
+            required: [],
+        },
+    },
+];
+// ─────────────────────────────────────────────────────────────────────────────
+// TOOL HANDLERS
+// ─────────────────────────────────────────────────────────────────────────────
+export async function handleHoldList(args) {
+    // Process expired holds first
+    const expired = holdManager.processExpiredHolds();
+    let holds = args.agentId
+        ? holdManager.getAgentPendingHolds(args.agentId)
+        : holdManager.getPendingHolds();
+    return {
+        holds,
+        count: holds.length,
+        expiredCount: expired.length,
+    };
+}
+export async function handleHoldApprove(args) {
+    const hold = holdManager.getHold(args.holdId);
+    if (!hold) {
+        return { success: false, error: `Hold not found: ${args.holdId}` };
+    }
+    // Approve the hold
+    const decision = holdManager.approveHold(args.holdId, 'human', args.reason || 'Approved by operator', args.modifiedFrame, args.modifiedArgs);
+    if (!decision) {
+        return { success: false, error: 'Failed to approve hold' };
+    }
+    // Execute if requested
+    if (args.executeNow !== false) {
+        const result = gatekeeper.execute({
+            agentId: hold.agentId,
+            frame: args.modifiedFrame || hold.frame,
+            tool: hold.tool,
+            arguments: args.modifiedArgs || hold.arguments,
+            bypassHold: true,
+            holdDecision: decision,
+        });
+        return {
+            success: true,
+            decision,
+            executionResult: result,
+        };
+    }
+    return { success: true, decision };
+}
+export async function handleHoldReject(args) {
+    const hold = holdManager.getHold(args.holdId);
+    if (!hold) {
+        return { success: false, error: `Hold not found: ${args.holdId}` };
+    }
+    // Reject the hold
+    const decision = holdManager.rejectHold(args.holdId, 'human', args.reason || 'Rejected by operator');
+    if (!decision) {
+        return { success: false, error: 'Failed to reject hold' };
+    }
+    // Halt agent if requested
+    let agentHalted = false;
+    if (args.haltAgent) {
+        gatekeeper.getDriftEngine().haltAgent(hold.agentId, `Hold rejected: ${args.reason || 'Operator decision'}`);
+        agentHalted = true;
+    }
+    return { success: true, decision, agentHalted };
+}
+export async function handleHoldConfig(args) {
+    if (args.action === 'set' && args.config) {
+        gatekeeper.setExecutionControlConfig(args.config);
+    }
+    return {
+        success: true,
+        config: gatekeeper.getExecutionControlConfig(),
+    };
+}
+export async function handleHoldStats(args) {
+    return {
+        stats: holdManager.getStats(),
+        history: holdManager.getHoldHistory(args.historyLimit || 10),
+    };
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// MAIN HANDLER
+// ─────────────────────────────────────────────────────────────────────────────
+export async function handleHoldTool(name, args) {
+    switch (name) {
+        case 'ps_hold_list':
+            return handleHoldList(args);
+        case 'ps_hold_approve':
+            return handleHoldApprove(args);
+        case 'ps_hold_reject':
+            return handleHoldReject(args);
+        case 'ps_hold_config':
+            return handleHoldConfig(args);
+        case 'ps_hold_stats':
+            return handleHoldStats(args);
+        default:
+            throw new Error(`Unknown hold tool: ${name}`);
+    }
+}
+//# sourceMappingURL=ps_hold.js.map

package/dist/tools/ps_hold.js.map

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

package/dist/tools/ps_legal.d.ts

@@ -0,0 +1,111 @@
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { LegalPreFlightResults } from '../types/index.js';
+export declare const legalToolDefinitions: Tool[];
+/**
+ * Verify a single citation.
+ */
+export declare function handleLegalVerify(args: {
+    citation: string;
+    includeDetails?: boolean;
+}): Promise<{
+    citation: string;
+    verified: boolean;
+    source: 'courtlistener' | 'local_cache' | 'format_only';
+    caseDetails?: {
+        caseName: string;
+        court: string;
+        year: number;
+        absoluteUrl?: string;
+    };
+    formatValidation: {
+        valid: boolean;
+        confidenceScore: number;
+        issues: string[];
+    };
+    limitationNotice: string;
+}>;
+/**
+ * Verify multiple citations in batch.
+ */
+export declare function handleLegalVerifyBatch(args: {
+    citations: string[];
+}): Promise<{
+    results: Array<{
+        citation: string;
+        verified: boolean;
+        valid: boolean;
+        confidenceScore: number;
+    }>;
+    summary: {
+        total: number;
+        verified: number;
+        unverified: number;
+        formatValid: number;
+        formatInvalid: number;
+    };
+    limitationNotice: string;
+}>;
+/**
+ * Extract citations from content.
+ */
+export declare function handleLegalExtract(args: {
+    content: string;
+}): {
+    citations: string[];
+    count: number;
+};
+/**
+ * Run full legal pre-flight check.
+ */
+export declare function handleLegalCheck(args: {
+    content: string;
+    frame?: string;
+    outputDestination?: 'internal' | 'client' | 'opposing_counsel' | 'court' | 'public' | 'unknown';
+    async?: boolean;
+}): Promise<{
+    results: LegalPreFlightResults;
+    shouldHold: boolean;
+    holdReasons: string[];
+    recommendations: string[];
+}>;
+/**
+ * Configure legal verification.
+ */
+export declare function handleLegalConfig(args: {
+    action: 'get' | 'set';
+    config?: {
+        enableCourtListenerVerification?: boolean;
+        courtListenerApiToken?: string;
+        minVerificationConfidence?: number;
+        enablePrivilegeDetection?: boolean;
+        enableFabricationDetection?: boolean;
+        semanticEntropyThreshold?: number;
+    };
+}): {
+    success: boolean;
+    config: {
+        enableCourtListenerVerification: boolean;
+        hasApiToken: boolean;
+        minVerificationConfidence: number;
+        enablePrivilegeDetection: boolean;
+        enableFabricationDetection: boolean;
+        semanticEntropyThreshold: number;
+    };
+};
+/**
+ * Get legal verification statistics.
+ */
+export declare function handleLegalStats(): {
+    courtListener: {
+        enabled: boolean;
+        stats: Record<string, unknown> | null;
+    };
+    citationCache: {
+        enabled: boolean;
+    };
+};
+/**
+ * Route tool calls to appropriate handlers.
+ */
+export declare function handleLegalTool(toolName: string, args: Record<string, unknown>): Promise<unknown>;
+//# sourceMappingURL=ps_legal.d.ts.map

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

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