@bitsbound/mcp-server 1.0.0

package/dist/types/Bitsbound_Kings_McpServer_Backend_Types.d.ts

@@ -0,0 +1,1542 @@
+export interface McpServerConfig {
+    readonly BITSBOUND_API_URL: string;
+    readonly BITSBOUND_API_KEY: string;
+}
+export declare const DEFAULT_API_URL = "https://bitsbound-saas-backend-mxb1.onrender.com";
+export interface StartUploadInput {
+    readonly fileName: string;
+    readonly totalChunks: number;
+    readonly fileSizeBytes?: number;
+}
+export interface StartUploadOutput {
+    readonly uploadId: string;
+    readonly fileName: string;
+    readonly totalChunks: number;
+    readonly expiresAt: string;
+}
+export interface UploadChunkInput {
+    readonly uploadId: string;
+    readonly chunkIndex: number;
+    readonly chunkData: string;
+}
+export interface UploadChunkOutput {
+    readonly uploadId: string;
+    readonly chunkIndex: number;
+    readonly chunksReceived: number;
+    readonly chunksRemaining: number;
+}
+export interface CompleteUploadInput {
+    readonly uploadId: string;
+}
+export interface CompleteUploadOutput {
+    readonly fileId: string;
+    readonly fileName: string;
+    readonly fileSizeBytes: number;
+    readonly expiresAt: string;
+}
+export interface UploadContractInput {
+    readonly docxBase64: string;
+    readonly fileName: string;
+}
+export interface UploadContractOutput {
+    readonly fileId: string;
+    readonly fileName: string;
+    readonly fileSizeBytes: number;
+    readonly expiresAt: string;
+}
+export interface AnalyzeContractInput {
+    readonly fileId?: string;
+    readonly filePath?: string;
+    readonly analysisDepth?: 'quick' | 'standard' | 'deep';
+    readonly perspective?: 'customer' | 'vendor' | 'neutral';
+}
+export interface GetAnalysisStatusInput {
+    readonly analysisId: string;
+}
+export interface AskSacInput {
+    readonly analysisId: string;
+    readonly question: string;
+    readonly includeClauseCitations?: boolean;
+}
+export interface GenerateRedlineInput {
+    readonly analysisId: string;
+    readonly aggressiveness?: 1 | 2 | 3 | 4 | 5;
+    readonly includeComments?: boolean;
+}
+export interface GenerateNegotiationEmailInput {
+    readonly analysisId: string;
+    readonly tone?: 'collaborative' | 'firm' | 'aggressive';
+    readonly recipientRole?: string;
+}
+export interface ExtractClauseInput {
+    readonly analysisId: string;
+    readonly clauseType: 'indemnification' | 'liability' | 'ip' | 'termination' | 'payment' | 'confidentiality' | 'data_privacy' | 'sla' | 'force_majeure' | 'assignment';
+}
+export interface ComparePlaybookInput {
+    readonly analysisId: string;
+    readonly playbookId: string;
+}
+/**
+ * InstantSwarmInput - Parallel redlining of entire contract across all 17 BUBSA sections
+ * D: Input for spawning parallel SAC sessions that independently analyze and redline each section
+ *
+ * TIR{ADVT}O Context:
+ * - T: User requests instant parallel redlining of entire contract
+ * - I: Analysis context + aggressiveness + party position
+ * - R: Spawns 17 parallel SAC sessions (one per BUBSA section), no lock contention
+ * - O: Merged redlined DOCX + per-section results
+ */
+export interface InstantSwarmInput {
+    readonly analysisId: string;
+    readonly aggressivenessLevel: 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10;
+    readonly partyPosition: 'customer' | 'vendor';
+    readonly ourPartyName?: string;
+    readonly counterpartyName?: string;
+    readonly targetSections?: string[];
+}
+/**
+ * QuickScanInput - Instant contract analysis (5-10 seconds)
+ * D: Input for immediate risk scan and classification without full pipeline
+ */
+export interface QuickScanInput {
+    readonly contractText: string;
+    readonly fileName?: string;
+    readonly perspective?: 'customer' | 'vendor' | 'neutral';
+}
+/**
+ * AskClauseInput - Instant clause Q&A without prior analysis
+ * D: Ask about specific clauses directly from contract text
+ */
+export interface AskClauseInput {
+    readonly contractText: string;
+    readonly question: string;
+    readonly clauseType?: 'indemnification' | 'liability' | 'ip' | 'termination' | 'payment' | 'confidentiality' | 'data_privacy' | 'sla' | 'force_majeure' | 'assignment' | 'any';
+}
+/**
+ * CheckDealbreakersInput - Quick playbook compliance check
+ * D: Fast check for must-have clauses and dealbreakers
+ */
+export interface CheckDealbreakersInput {
+    readonly contractText: string;
+    readonly playbookId?: string;
+}
+export interface AnalyzeContractOutput {
+    readonly analysisId: string;
+    readonly status: 'queued' | 'processing' | 'completed' | 'failed';
+    readonly estimatedTimeMinutes: number;
+    readonly initialRiskSummary?: string;
+}
+/**
+ * AnalysisStatusOutput - Status of running/completed analysis
+ * D: Reports progress through the 8-stage TCA pipeline:
+ *    1. Loading Context - Parsing deal context and contract structure
+ *    2. Extracting Data - Running 13 deterministic extraction scripts
+ *    3. Identifying Parties - AI identifying customer and vendor
+ *    4. Researching - Running 8 parallel research analyzers
+ *    5. AI Analysis - Running 18 parallel AI analyzers
+ *    6. Instant Swarm™ - Parallel redlining across all sections (if enabled)
+ *    7. Generating Email - Drafting negotiation email (if enabled)
+ *    8. Synthesizing Results - Generating recommendations and scores
+ */
+export interface AnalysisStatusOutput {
+    readonly analysisId: string;
+    readonly status: 'queued' | 'processing' | 'completed' | 'failed';
+    readonly progressPercent: number;
+    readonly currentPhase: string;
+    readonly phasesCompleted: string[];
+    readonly favorabilityScore?: number;
+    readonly topRisks?: string[];
+}
+export interface SacResponseOutput {
+    readonly response: string;
+    readonly clauseCitations?: ClauseCitation[];
+    readonly followUpSuggestions?: string[];
+}
+export interface ClauseCitation {
+    readonly sectionName: string;
+    readonly clauseText: string;
+    readonly pageNumber?: number;
+}
+export interface RedlineOutput {
+    readonly redlinedDocxBase64: string;
+    readonly downloadUrl: string;
+    readonly changesCount: number;
+    readonly changesSummary: string;
+}
+export interface NegotiationEmailOutput {
+    readonly subject: string;
+    readonly body: string;
+    readonly keyPoints: string[];
+}
+export interface ClauseExtractionOutput {
+    readonly clauseType: string;
+    readonly clauseText: string;
+    readonly riskLevel: 'low' | 'medium' | 'high' | 'critical';
+    readonly riskAnalysis: string;
+    readonly suggestedImprovements: string[];
+    readonly marketComparison?: string;
+}
+export interface PlaybookComparisonOutput {
+    readonly deviations: PlaybookDeviation[];
+    readonly complianceScore: number;
+    readonly requiredApprovals: string[];
+}
+export interface PlaybookDeviation {
+    readonly section: string;
+    readonly playbookRequirement: string;
+    readonly actualClause: string;
+    readonly severity: 'minor' | 'moderate' | 'major';
+    readonly recommendation: string;
+}
+/**
+ * InstantSwarmOutput - Results from parallel N-section redlining
+ * D: Contains merged document + per-section analysis results
+ *
+ * TIR{ADVT}O Context:
+ * - Output from parallel SAC swarm execution
+ * - N agents for N sections (dynamic, not fixed)
+ * - Each section analyzed independently, then merged
+ * - Real OOXML Track Changes applied to original document
+ */
+export interface InstantSwarmOutput {
+    readonly success: boolean;
+    readonly totalSections: number;
+    readonly completedSections: number;
+    readonly failedSections: number;
+    readonly redlinedDocumentBase64?: string;
+    readonly redlinedDocumentUrl?: string;
+    readonly sectionResults: InstantSwarmSectionResult[];
+    readonly totalRedlinesApplied: number;
+    readonly totalCommentsApplied: number;
+    readonly executionTimeMs: number;
+    readonly tokenUsage?: {
+        readonly inputTokens: number;
+        readonly outputTokens: number;
+    };
+}
+/**
+ * InstantSwarmSectionResult - Results for a single BUBSA section
+ * D: Individual section analysis from the swarm
+ */
+export interface InstantSwarmSectionResult {
+    readonly sectionId: string;
+    readonly sectionName: string;
+    readonly success: boolean;
+    readonly redlinesApplied: number;
+    readonly commentsApplied: number;
+    readonly keyChanges?: string[];
+    readonly error?: string;
+    readonly executionTimeMs: number;
+}
+/**
+ * QuickScanOutput - Instant analysis results (5-10 seconds)
+ * D: Immediate risk assessment without full pipeline
+ */
+export interface QuickScanOutput {
+    readonly contractType: string;
+    readonly parties: {
+        readonly customer: string;
+        readonly vendor: string;
+    };
+    readonly favorabilityEstimate: number;
+    readonly favorabilityLabel: 'Customer-Favorable' | 'Balanced' | 'Vendor-Favorable' | 'Heavily Vendor-Favorable';
+    readonly topConcerns: Array<{
+        readonly severity: 'critical' | 'high' | 'medium' | 'low';
+        readonly category: string;
+        readonly summary: string;
+    }>;
+    readonly keyTerms: {
+        readonly term?: string;
+        readonly paymentTerms?: string;
+        readonly liabilityCap?: string;
+        readonly terminationNotice?: string;
+        readonly governingLaw?: string;
+    };
+    readonly missingSections: string[];
+    readonly recommendation: string;
+}
+/**
+ * AskClauseOutput - Instant clause Q&A response
+ * D: Direct answer about specific clauses
+ */
+export interface AskClauseOutput {
+    readonly answer: string;
+    readonly clauseText?: string;
+    readonly clauseLocation?: string;
+    readonly riskAssessment?: {
+        readonly level: 'low' | 'medium' | 'high' | 'critical';
+        readonly explanation: string;
+    };
+    readonly suggestedFollowUp?: string[];
+}
+/**
+ * CheckDealbreakersOutput - Quick compliance check results
+ * D: Fast identification of dealbreakers and missing requirements
+ */
+export interface CheckDealbreakersOutput {
+    readonly passesInitialScreen: boolean;
+    readonly dealbreakers: Array<{
+        readonly issue: string;
+        readonly severity: 'blocker' | 'major' | 'minor';
+        readonly requirement: string;
+        readonly actual: string;
+    }>;
+    readonly missingRequirements: string[];
+    readonly approvalsNeeded: string[];
+    readonly recommendation: 'proceed' | 'negotiate' | 'escalate' | 'reject';
+}
+export interface BitsBoundApiResponse<T> {
+    readonly success: boolean;
+    readonly data?: T;
+    readonly error?: string;
+    readonly tokenUsage?: number;
+}
+export interface StartAnalysisResponse {
+    readonly analysisId: string;
+    readonly status: string;
+    readonly estimatedMinutes: number;
+}
+export interface AnalysisProgressResponse {
+    readonly analysisId: string;
+    readonly status: string;
+    readonly progress: number;
+    readonly phase: string;
+    readonly phasesCompleted: string[];
+    readonly results?: AnalysisResults;
+}
+export interface AnalysisResults {
+    readonly favorabilityScore: number;
+    readonly topRisks: RiskItem[];
+    readonly sections: SectionAnalysis[];
+    readonly negotiationPriorities: string[];
+}
+export interface RiskItem {
+    readonly section: string;
+    readonly risk: string;
+    readonly severity: 'low' | 'medium' | 'high' | 'critical';
+    readonly recommendation: string;
+}
+export interface SectionAnalysis {
+    readonly sectionName: string;
+    readonly favorability: number;
+    readonly issues: string[];
+    readonly suggestedChanges: string[];
+}
+export declare const TOOL_DEFINITIONS: {
+    readonly start_upload: {
+        readonly name: "start_upload";
+        readonly description: "Start a chunked file upload session. Call this FIRST before uploading chunks. Returns an uploadId to use with upload_chunk. This approach avoids timeout issues with large files in claude.ai.";
+        readonly inputSchema: {
+            readonly type: "object";
+            readonly properties: {
+                readonly fileName: {
+                    readonly type: "string";
+                    readonly description: "Original filename (e.g., \"Master_Services_Agreement.docx\")";
+                };
+                readonly totalChunks: {
+                    readonly type: "number";
+                    readonly description: "Total number of chunks you will upload. Calculate: Math.ceil(base64String.length / 50000)";
+                };
+                readonly fileSizeBytes: {
+                    readonly type: "number";
+                    readonly description: "Optional: Total file size in bytes for validation";
+                };
+            };
+            readonly required: readonly ["fileName", "totalChunks"];
+        };
+        readonly annotations: {
+            readonly readOnlyHint: false;
+            readonly destructiveHint: false;
+        };
+    };
+    readonly upload_chunk: {
+        readonly name: "upload_chunk";
+        readonly description: "Upload a single chunk of the file. Call this repeatedly for each chunk (0 to totalChunks-1). Each chunk should be ~50KB of base64 data to avoid timeout.";
+        readonly inputSchema: {
+            readonly type: "object";
+            readonly properties: {
+                readonly uploadId: {
+                    readonly type: "string";
+                    readonly description: "The uploadId returned from start_upload";
+                };
+                readonly chunkIndex: {
+                    readonly type: "number";
+                    readonly description: "Zero-based index of this chunk (0, 1, 2, ...)";
+                };
+                readonly chunkData: {
+                    readonly type: "string";
+                    readonly description: "Base64 data for this chunk. Max ~50KB per chunk to avoid timeout.";
+                };
+            };
+            readonly required: readonly ["uploadId", "chunkIndex", "chunkData"];
+        };
+        readonly annotations: {
+            readonly readOnlyHint: false;
+            readonly destructiveHint: false;
+        };
+    };
+    readonly complete_upload: {
+        readonly name: "complete_upload";
+        readonly description: "Complete a chunked upload after all chunks are uploaded. Returns a fileId to use with process_contract.";
+        readonly inputSchema: {
+            readonly type: "object";
+            readonly properties: {
+                readonly uploadId: {
+                    readonly type: "string";
+                    readonly description: "The uploadId from start_upload";
+                };
+            };
+            readonly required: readonly ["uploadId"];
+        };
+        readonly annotations: {
+            readonly readOnlyHint: false;
+            readonly destructiveHint: false;
+        };
+    };
+    readonly upload_contract: {
+        readonly name: "upload_contract";
+        readonly description: "⚠️ LEGACY - May timeout in claude.ai for large files. Use start_upload + upload_chunk + complete_upload instead. Uploads entire file at once.";
+        readonly inputSchema: {
+            readonly type: "object";
+            readonly properties: {
+                readonly docxBase64: {
+                    readonly type: "string";
+                    readonly description: "The contract document content as a base64-encoded string.";
+                };
+                readonly fileName: {
+                    readonly type: "string";
+                    readonly description: "Original filename of the document (e.g., \"Master_Services_Agreement.docx\").";
+                };
+            };
+            readonly required: readonly ["docxBase64", "fileName"];
+        };
+        readonly annotations: {
+            readonly readOnlyHint: false;
+            readonly destructiveHint: false;
+        };
+    };
+    readonly process_contract: {
+        readonly name: "process_contract";
+        readonly description: "Process a contract through the full 8-stage BitsBound pipeline. TWO MODES: (1) Claude Desktop: Pass filePath directly - server reads local file. (2) claude.ai: First upload via start_upload/upload_chunk/complete_upload, then pass fileId here.";
+        readonly inputSchema: {
+            readonly type: "object";
+            readonly properties: {
+                readonly filePath: {
+                    readonly type: "string";
+                    readonly description: "LOCAL FILE PATH (Claude Desktop only). Server reads file directly from disk. Example: \"/Users/rob/Documents/contract.docx\"";
+                };
+                readonly fileId: {
+                    readonly type: "string";
+                    readonly description: "FILE ID (claude.ai only). The fileId returned from complete_upload after chunked upload.";
+                };
+                readonly analysisDepth: {
+                    readonly type: "string";
+                    readonly enum: readonly ["quick", "standard", "deep"];
+                    readonly description: "Analysis depth: quick (~5 min), standard (~15 min), deep (~30 min). Default: standard";
+                };
+                readonly perspective: {
+                    readonly type: "string";
+                    readonly enum: readonly ["customer", "vendor", "neutral"];
+                    readonly description: "Analyze from customer (buyer), vendor (seller), or neutral perspective. Default: customer";
+                };
+            };
+            readonly required: readonly [];
+        };
+        readonly annotations: {
+            readonly readOnlyHint: false;
+            readonly destructiveHint: false;
+        };
+    };
+    readonly get_analysis_status: {
+        readonly name: "get_analysis_status";
+        readonly description: "Check the status of a running or completed contract analysis. Returns progress through the 8-stage pipeline (Context→Extraction→Parties→Research→Analysis→Swarm→Email→Synthesis), current phase name, and results when complete.";
+        readonly inputSchema: {
+            readonly type: "object";
+            readonly properties: {
+                readonly analysisId: {
+                    readonly type: "string";
+                    readonly description: "The processing ID returned from process_contract";
+                };
+            };
+            readonly required: readonly ["analysisId"];
+        };
+        readonly annotations: {
+            readonly readOnlyHint: true;
+        };
+    };
+    readonly ask_sac: {
+        readonly name: "ask_sac";
+        readonly description: "Ask the Supreme AI Co-Counsel (SAC) questions about an analyzed contract. SAC has full context of the contract and all analysis results. Great for clarifying risks, understanding clauses, or getting negotiation advice.";
+        readonly inputSchema: {
+            readonly type: "object";
+            readonly properties: {
+                readonly analysisId: {
+                    readonly type: "string";
+                    readonly description: "The analysis ID of a completed analysis";
+                };
+                readonly question: {
+                    readonly type: "string";
+                    readonly description: "Your question about the contract";
+                };
+                readonly includeClauseCitations: {
+                    readonly type: "boolean";
+                    readonly description: "Include specific clause citations in the response. Default: true";
+                };
+            };
+            readonly required: readonly ["analysisId", "question"];
+        };
+        readonly annotations: {
+            readonly readOnlyHint: true;
+        };
+    };
+    readonly generate_redline: {
+        readonly name: "generate_redline";
+        readonly description: "Generate a redlined Word document with real OOXML Track Changes (w:ins, w:del) applied directly to the original document. Returns the redlined DOCX as base64.";
+        readonly inputSchema: {
+            readonly type: "object";
+            readonly properties: {
+                readonly analysisId: {
+                    readonly type: "string";
+                    readonly description: "The analysis ID of a completed analysis";
+                };
+                readonly aggressiveness: {
+                    readonly type: "number";
+                    readonly enum: readonly [1, 2, 3, 4, 5];
+                    readonly description: "How aggressive the redlines should be (1=conservative, 5=aggressive). Default: 3";
+                };
+                readonly includeComments: {
+                    readonly type: "boolean";
+                    readonly description: "Include rationale comments in Word margins. Default: true";
+                };
+            };
+            readonly required: readonly ["analysisId"];
+        };
+        readonly annotations: {
+            readonly readOnlyHint: false;
+            readonly destructiveHint: false;
+        };
+    };
+    readonly generate_negotiation_email: {
+        readonly name: "generate_negotiation_email";
+        readonly description: "Generate a professional negotiation email to send to the counterparty, explaining requested changes and their rationale.";
+        readonly inputSchema: {
+            readonly type: "object";
+            readonly properties: {
+                readonly analysisId: {
+                    readonly type: "string";
+                    readonly description: "The analysis ID of a completed analysis";
+                };
+                readonly tone: {
+                    readonly type: "string";
+                    readonly enum: readonly ["collaborative", "firm", "aggressive"];
+                    readonly description: "Tone of the email. Default: collaborative";
+                };
+                readonly recipientRole: {
+                    readonly type: "string";
+                    readonly description: "Role of the recipient (e.g., \"General Counsel\", \"Sales Rep\", \"Procurement\"). Helps tailor the message.";
+                };
+            };
+            readonly required: readonly ["analysisId"];
+        };
+        readonly annotations: {
+            readonly readOnlyHint: false;
+            readonly destructiveHint: false;
+        };
+    };
+    readonly extract_clause: {
+        readonly name: "extract_clause";
+        readonly description: "Extract and analyze a specific clause type from an analyzed contract. Returns the clause text, risk analysis, and suggested improvements.";
+        readonly inputSchema: {
+            readonly type: "object";
+            readonly properties: {
+                readonly analysisId: {
+                    readonly type: "string";
+                    readonly description: "The analysis ID of a completed analysis";
+                };
+                readonly clauseType: {
+                    readonly type: "string";
+                    readonly enum: readonly ["indemnification", "liability", "ip", "termination", "payment", "confidentiality", "data_privacy", "sla", "force_majeure", "assignment"];
+                    readonly description: "The type of clause to extract";
+                };
+            };
+            readonly required: readonly ["analysisId", "clauseType"];
+        };
+        readonly annotations: {
+            readonly readOnlyHint: true;
+        };
+    };
+    readonly compare_playbook: {
+        readonly name: "compare_playbook";
+        readonly description: "Compare an analyzed contract against a company playbook to identify deviations from pre-approved positions and required approvals.";
+        readonly inputSchema: {
+            readonly type: "object";
+            readonly properties: {
+                readonly analysisId: {
+                    readonly type: "string";
+                    readonly description: "The analysis ID of a completed analysis";
+                };
+                readonly playbookId: {
+                    readonly type: "string";
+                    readonly description: "The ID of the playbook to compare against";
+                };
+            };
+            readonly required: readonly ["analysisId", "playbookId"];
+        };
+        readonly annotations: {
+            readonly readOnlyHint: true;
+        };
+    };
+    readonly instant_swarm: {
+        readonly name: "instant_swarm";
+        readonly description: "PARALLEL REDLINING of entire contract. Spawns N independent SAC agents for N sections simultaneously - maximum parallelization with no lock contention. Each agent (IP, Liability, Indemnification, Payment, Term, etc.) independently analyzes and redlines its section, then all branches merge into a single DOCX with real Track Changes. Returns merged document + per-section results. Requires a completed analysis (use process_contract first). This is the flagship feature - full attorney-quality redlines across the entire contract in parallel.";
+        readonly inputSchema: {
+            readonly type: "object";
+            readonly properties: {
+                readonly analysisId: {
+                    readonly type: "string";
+                    readonly description: "The analysis ID from a completed process_contract call. The analysis provides contract context for each section.";
+                };
+                readonly aggressivenessLevel: {
+                    readonly type: "number";
+                    readonly enum: readonly [1, 2, 3, 4, 5, 6, 7, 8, 9, 10];
+                    readonly description: "How aggressive the redlines should be (1=conservative, 10=very aggressive). Recommended: 5-7 for balanced approach.";
+                };
+                readonly partyPosition: {
+                    readonly type: "string";
+                    readonly enum: readonly ["customer", "vendor"];
+                    readonly description: "Which side are you on? \"customer\" = you are buying/receiving services. \"vendor\" = you are selling/providing services.";
+                };
+                readonly ourPartyName: {
+                    readonly type: "string";
+                    readonly description: "Your company name as it should appear in redlines (e.g., \"Acme Corp\").";
+                };
+                readonly counterpartyName: {
+                    readonly type: "string";
+                    readonly description: "The other party's name (e.g., \"Vendor Inc\").";
+                };
+                readonly targetSections: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                    readonly description: "Optional: specific BUBSA sections to analyze. If omitted, analyzes all 17 sections. Valid sections: parties, definitions, ip_license, payment, term_termination, confidentiality, data_privacy, reps_warranties, indemnification, liability, insurance, assignment, force_majeure, dispute_resolution, precedence, miscellaneous, sla";
+                };
+            };
+            readonly required: readonly ["analysisId", "aggressivenessLevel", "partyPosition"];
+        };
+        readonly annotations: {
+            readonly readOnlyHint: false;
+            readonly destructiveHint: false;
+        };
+    };
+    readonly quick_scan: {
+        readonly name: "quick_scan";
+        readonly description: "INSTANT contract analysis (5-10 seconds). Get immediate risk assessment, contract classification, top concerns, and key terms WITHOUT waiting for the full 15-30 minute analysis. Perfect for initial triage or quick questions. Use this FIRST before deciding if a full analysis is needed.";
+        readonly inputSchema: {
+            readonly type: "object";
+            readonly properties: {
+                readonly contractText: {
+                    readonly type: "string";
+                    readonly description: "The contract text (plain text or base64-encoded DOCX). For DOCX files, base64 encode the file contents.";
+                };
+                readonly fileName: {
+                    readonly type: "string";
+                    readonly description: "Optional filename for context (e.g., \"Acme_MSA_2024.docx\")";
+                };
+                readonly perspective: {
+                    readonly type: "string";
+                    readonly enum: readonly ["customer", "vendor", "neutral"];
+                    readonly description: "Analyze from customer (buyer), vendor (seller), or neutral perspective. Default: customer";
+                };
+            };
+            readonly required: readonly ["contractText"];
+        };
+        readonly annotations: {
+            readonly readOnlyHint: true;
+        };
+    };
+    readonly ask_clause: {
+        readonly name: "ask_clause";
+        readonly description: "INSTANT clause Q&A (2-5 seconds). Ask about specific clauses directly WITHOUT needing a prior analysis. Examples: \"What does the indemnification clause say?\", \"Is there a limitation of liability?\", \"What are the termination terms?\"";
+        readonly inputSchema: {
+            readonly type: "object";
+            readonly properties: {
+                readonly contractText: {
+                    readonly type: "string";
+                    readonly description: "The contract text (plain text or base64-encoded DOCX)";
+                };
+                readonly question: {
+                    readonly type: "string";
+                    readonly description: "Your question about the contract (e.g., \"What is the liability cap?\", \"Is there an auto-renewal clause?\")";
+                };
+                readonly clauseType: {
+                    readonly type: "string";
+                    readonly enum: readonly ["indemnification", "liability", "ip", "termination", "payment", "confidentiality", "data_privacy", "sla", "force_majeure", "assignment", "any"];
+                    readonly description: "Optional: Focus on a specific clause type, or \"any\" to search the whole contract. Default: any";
+                };
+            };
+            readonly required: readonly ["contractText", "question"];
+        };
+        readonly annotations: {
+            readonly readOnlyHint: true;
+        };
+    };
+    readonly check_dealbreakers: {
+        readonly name: "check_dealbreakers";
+        readonly description: "INSTANT dealbreaker check (3-5 seconds). Quick pass/fail screen against your playbook rules. Identifies blockers, missing required clauses, and who needs to approve. Use before spending time on full analysis.";
+        readonly inputSchema: {
+            readonly type: "object";
+            readonly properties: {
+                readonly contractText: {
+                    readonly type: "string";
+                    readonly description: "The contract text (plain text or base64-encoded DOCX)";
+                };
+                readonly playbookId: {
+                    readonly type: "string";
+                    readonly description: "Optional: Specific playbook to check against. If not provided, uses your default company playbook.";
+                };
+            };
+            readonly required: readonly ["contractText"];
+        };
+        readonly annotations: {
+            readonly readOnlyHint: true;
+        };
+    };
+};
+export type ToolName = keyof typeof TOOL_DEFINITIONS;
+export declare const RESOURCE_DEFINITIONS: {
+    readonly analysis: {
+        readonly uriTemplate: "bitsbound://analysis/{analysisId}";
+        readonly name: "Contract Analysis";
+        readonly description: "Full analysis results including all 17 analyzer outputs, risk scores, and recommendations";
+        readonly mimeType: "application/json";
+    };
+    readonly playbook: {
+        readonly uriTemplate: "bitsbound://playbook/{playbookId}";
+        readonly name: "Company Playbook";
+        readonly description: "Pre-approved clause library and negotiation rules";
+        readonly mimeType: "application/json";
+    };
+    readonly redline: {
+        readonly uriTemplate: "bitsbound://redline/{analysisId}";
+        readonly name: "Redlined Contract";
+        readonly description: "The redlined DOCX with Track Changes";
+        readonly mimeType: "application/vnd.openxmlformats-officedocument.wordprocessingml.document";
+    };
+};
+/**
+ * PROMPT_DEFINITIONS - MCP Prompts for guiding users through BitsBound workflows
+ * D: These appear in claude.ai's "Add from BitsBound" menu as actionable items
+ *
+ * TIR{ADVT}O Context:
+ * - T: User selects a prompt from the menu
+ * - I: Prompt template with optional arguments
+ * - R: Claude receives structured instructions to guide the workflow
+ * - O: User experiences a smooth, guided contract analysis flow
+ */
+export declare const PROMPT_DEFINITIONS: {
+    readonly process_contract: {
+        readonly name: "process_contract";
+        readonly description: "📄 Process Contract - Upload a DOCX and get partner-level redlines with Track Changes, risk analysis, and a negotiation email";
+        readonly arguments: readonly [];
+    };
+};
+export type PromptName = keyof typeof PROMPT_DEFINITIONS;
+/**
+ * PROMPT_MESSAGES - The actual prompt content sent to Claude when user selects a prompt
+ * D: These guide Claude to ask for the right inputs and call the right tools
+ * Note: MCP SDK requires content to be TextContent object with type: 'text' and text: string
+ */
+export declare const PROMPT_MESSAGES: Record<PromptName, {
+    role: 'user';
+    content: {
+        type: 'text';
+        text: string;
+    };
+}[]>;
+/**
+ * OpenAPI 3.1 specification for BitsBound Contract Analysis API.
+ * Used by ChatGPT Custom GPT Actions to call the BitsBound MCP API endpoints.
+ *
+ * TIR{ADVT}O Context:
+ * - Definition: Complete API schema enabling ChatGPT to understand and call BitsBound endpoints
+ * - Validation: JSON Schema validation for all request/response bodies
+ * - Output: JSON object conforming to OpenAPI 3.1 specification
+ */
+export declare const OPENAPI_SPEC: {
+    readonly openapi: "3.1.0";
+    readonly info: {
+        readonly title: "BitsBound Contract Analysis API";
+        readonly description: "AI-powered contract analysis for legal professionals. Analyze contracts, generate redlines with real Track Changes, get clause-by-clause risk analysis, and draft negotiation emails.";
+        readonly version: "1.0.0";
+        readonly contact: {
+            readonly name: "BitsBound Support";
+            readonly url: "https://bitsbound.com";
+            readonly email: "support@bitsbound.com";
+        };
+        readonly termsOfService: "https://bitsbound.com/terms";
+        readonly 'x-logo': {
+            readonly url: "https://bitsbound.com/favicon.svg";
+        };
+    };
+    readonly servers: readonly [{
+        readonly url: "https://bitsbound-saas-backend-mxb1.onrender.com";
+        readonly description: "Production server";
+    }];
+    readonly security: readonly [{
+        readonly ApiKeyAuth: readonly [];
+    }];
+    readonly paths: {
+        readonly '/api/v1/mcp/analyze': {
+            readonly post: {
+                readonly operationId: "analyzeContract";
+                readonly summary: "Upload and analyze a contract";
+                readonly description: "Upload a contract (DOCX or PDF) for comprehensive AI analysis through an 8-stage pipeline: (1) Context Loading, (2) Data Extraction with 13 scripts, (3) Party Identification, (4) Research with 8 parallel analyzers, (5) AI Analysis with 18+ parallel analyzers, (6) Instant Swarm™ parallel redlining (optional), (7) Email Generation (optional), (8) Synthesis. Returns an analysis ID to track progress.";
+                readonly tags: readonly ["Contract Analysis"];
+                readonly requestBody: {
+                    readonly required: true;
+                    readonly content: {
+                        readonly 'application/json': {
+                            readonly schema: {
+                                readonly type: "object";
+                                readonly required: readonly ["contract_content", "filename"];
+                                readonly properties: {
+                                    readonly contract_content: {
+                                        readonly type: "string";
+                                        readonly description: "Base64-encoded contract file (DOCX or PDF)";
+                                    };
+                                    readonly filename: {
+                                        readonly type: "string";
+                                        readonly description: "Original filename with extension (e.g., \"msa.docx\")";
+                                    };
+                                    readonly analysis_type: {
+                                        readonly type: "string";
+                                        readonly enum: readonly ["quick", "standard", "full"];
+                                        readonly default: "full";
+                                        readonly description: "Analysis depth: quick (~5 min), standard (~15 min), full (~30 min)";
+                                    };
+                                };
+                            };
+                        };
+                    };
+                };
+                readonly responses: {
+                    readonly '200': {
+                        readonly description: "Analysis started successfully";
+                        readonly content: {
+                            readonly 'application/json': {
+                                readonly schema: {
+                                    readonly type: "object";
+                                    readonly properties: {
+                                        readonly success: {
+                                            readonly type: "boolean";
+                                        };
+                                        readonly analysisId: {
+                                            readonly type: "string";
+                                            readonly description: "Unique identifier for tracking this analysis";
+                                        };
+                                        readonly status: {
+                                            readonly type: "string";
+                                            readonly enum: readonly ["queued", "processing"];
+                                        };
+                                        readonly estimatedTime: {
+                                            readonly type: "string";
+                                            readonly description: "Estimated completion time";
+                                        };
+                                        readonly message: {
+                                            readonly type: "string";
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                    readonly '400': {
+                        readonly description: "Invalid request - missing or malformed parameters";
+                    };
+                    readonly '401': {
+                        readonly description: "Invalid or missing API key";
+                    };
+                };
+            };
+        };
+        readonly '/api/v1/mcp/analysis/{analysisId}/status': {
+            readonly get: {
+                readonly operationId: "getAnalysisStatus";
+                readonly summary: "Check analysis progress";
+                readonly description: "Poll this endpoint to check the status of a running analysis through the 8-stage pipeline. Returns progress percentage, current phase (Loading Context → Extracting Data → Identifying Parties → Researching → AI Analysis → Instant Swarm™ → Generating Email → Synthesizing Results), and results when complete.";
+                readonly tags: readonly ["Contract Analysis"];
+                readonly parameters: readonly [{
+                    readonly name: "analysisId";
+                    readonly in: "path";
+                    readonly required: true;
+                    readonly schema: {
+                        readonly type: "string";
+                    };
+                    readonly description: "The analysis ID returned from analyzeContract";
+                }];
+                readonly responses: {
+                    readonly '200': {
+                        readonly description: "Analysis status retrieved";
+                        readonly content: {
+                            readonly 'application/json': {
+                                readonly schema: {
+                                    readonly type: "object";
+                                    readonly properties: {
+                                        readonly success: {
+                                            readonly type: "boolean";
+                                        };
+                                        readonly analysisId: {
+                                            readonly type: "string";
+                                        };
+                                        readonly status: {
+                                            readonly type: "string";
+                                            readonly enum: readonly ["queued", "processing", "completed", "failed"];
+                                        };
+                                        readonly progress: {
+                                            readonly type: "number";
+                                            readonly description: "Progress percentage (0-100)";
+                                        };
+                                        readonly currentPhase: {
+                                            readonly type: "string";
+                                            readonly description: "Current analysis phase from the 8-stage pipeline";
+                                        };
+                                        readonly phases: {
+                                            readonly type: "array";
+                                            readonly items: {
+                                                readonly type: "string";
+                                            };
+                                            readonly description: "Completed phases: phase1_context, phase2_extraction, phase3_parties, phase4_research, phase5_analysis, phase6_instantswarm, phase7_email, phase8_synthesis";
+                                        };
+                                        readonly createdAt: {
+                                            readonly type: "string";
+                                            readonly format: "date-time";
+                                        };
+                                        readonly completedAt: {
+                                            readonly type: "string";
+                                            readonly format: "date-time";
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                    readonly '404': {
+                        readonly description: "Analysis not found";
+                    };
+                };
+            };
+        };
+        readonly '/api/v1/mcp/analysis/{analysisId}/full': {
+            readonly get: {
+                readonly operationId: "getFullAnalysis";
+                readonly summary: "Get complete analysis results";
+                readonly description: "Retrieve the full analysis results including all section analyses, risks, favorability scores, and recommendations. Only available after analysis completes.";
+                readonly tags: readonly ["Contract Analysis"];
+                readonly parameters: readonly [{
+                    readonly name: "analysisId";
+                    readonly in: "path";
+                    readonly required: true;
+                    readonly schema: {
+                        readonly type: "string";
+                    };
+                }];
+                readonly responses: {
+                    readonly '200': {
+                        readonly description: "Full analysis results";
+                        readonly content: {
+                            readonly 'application/json': {
+                                readonly schema: {
+                                    readonly type: "object";
+                                    readonly properties: {
+                                        readonly success: {
+                                            readonly type: "boolean";
+                                        };
+                                        readonly analysisId: {
+                                            readonly type: "string";
+                                        };
+                                        readonly status: {
+                                            readonly type: "string";
+                                        };
+                                        readonly analysis: {
+                                            readonly type: "object";
+                                            readonly description: "Section-by-section analysis";
+                                        };
+                                        readonly risks: {
+                                            readonly type: "array";
+                                            readonly items: {
+                                                readonly type: "object";
+                                            };
+                                            readonly description: "Identified risks";
+                                        };
+                                        readonly favorability: {
+                                            readonly type: "object";
+                                            readonly description: "Favorability scores";
+                                        };
+                                        readonly recommendations: {
+                                            readonly type: "array";
+                                            readonly items: {
+                                                readonly type: "object";
+                                            };
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                    readonly '400': {
+                        readonly description: "Analysis not yet complete";
+                    };
+                    readonly '404': {
+                        readonly description: "Analysis not found";
+                    };
+                };
+            };
+        };
+        readonly '/api/v1/mcp/sac/chat': {
+            readonly post: {
+                readonly operationId: "askSac";
+                readonly summary: "Ask the Supreme AI Co-Counsel";
+                readonly description: "Ask questions about an analyzed contract. SAC (Supreme AI Co-Counsel) has full context of the contract and all analysis results. Great for clarifying risks, understanding clauses, or getting negotiation advice.";
+                readonly tags: readonly ["SAC Chat"];
+                readonly requestBody: {
+                    readonly required: true;
+                    readonly content: {
+                        readonly 'application/json': {
+                            readonly schema: {
+                                readonly type: "object";
+                                readonly required: readonly ["analysis_id", "question"];
+                                readonly properties: {
+                                    readonly analysis_id: {
+                                        readonly type: "string";
+                                        readonly description: "Analysis ID from a completed analysis";
+                                    };
+                                    readonly question: {
+                                        readonly type: "string";
+                                        readonly description: "Your question about the contract";
+                                    };
+                                    readonly context: {
+                                        readonly type: "string";
+                                        readonly description: "Optional additional context for the question";
+                                    };
+                                };
+                            };
+                        };
+                    };
+                };
+                readonly responses: {
+                    readonly '200': {
+                        readonly description: "SAC response";
+                        readonly content: {
+                            readonly 'application/json': {
+                                readonly schema: {
+                                    readonly type: "object";
+                                    readonly properties: {
+                                        readonly success: {
+                                            readonly type: "boolean";
+                                        };
+                                        readonly answer: {
+                                            readonly type: "string";
+                                            readonly description: "SAC response to your question";
+                                        };
+                                        readonly citations: {
+                                            readonly type: "array";
+                                            readonly items: {
+                                                readonly type: "string";
+                                            };
+                                            readonly description: "Relevant clause citations";
+                                        };
+                                        readonly confidence: {
+                                            readonly type: "number";
+                                            readonly description: "Confidence score (0-1)";
+                                        };
+                                        readonly analysisContext: {
+                                            readonly type: "object";
+                                            readonly description: "Summary of analysis context used";
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                    readonly '404': {
+                        readonly description: "Analysis not found";
+                    };
+                };
+            };
+        };
+        readonly '/api/v1/mcp/redline/generate': {
+            readonly post: {
+                readonly operationId: "generateRedline";
+                readonly summary: "Generate redlined document";
+                readonly description: "Generate a redlined Word document with real OOXML Track Changes (w:ins, w:del) applied directly to the original document. Returns a download URL for the redlined DOCX.";
+                readonly tags: readonly ["Document Generation"];
+                readonly requestBody: {
+                    readonly required: true;
+                    readonly content: {
+                        readonly 'application/json': {
+                            readonly schema: {
+                                readonly type: "object";
+                                readonly required: readonly ["analysis_id"];
+                                readonly properties: {
+                                    readonly analysis_id: {
+                                        readonly type: "string";
+                                    };
+                                    readonly include_comments: {
+                                        readonly type: "boolean";
+                                        readonly default: true;
+                                        readonly description: "Include rationale comments in margins";
+                                    };
+                                    readonly format: {
+                                        readonly type: "string";
+                                        readonly enum: readonly ["docx", "pdf"];
+                                        readonly default: "docx";
+                                    };
+                                };
+                            };
+                        };
+                    };
+                };
+                readonly responses: {
+                    readonly '200': {
+                        readonly description: "Redline generated successfully";
+                        readonly content: {
+                            readonly 'application/json': {
+                                readonly schema: {
+                                    readonly type: "object";
+                                    readonly properties: {
+                                        readonly success: {
+                                            readonly type: "boolean";
+                                        };
+                                        readonly analysisId: {
+                                            readonly type: "string";
+                                        };
+                                        readonly downloadUrl: {
+                                            readonly type: "string";
+                                            readonly format: "uri";
+                                            readonly description: "URL to download the redlined document";
+                                        };
+                                        readonly format: {
+                                            readonly type: "string";
+                                        };
+                                        readonly expiresAt: {
+                                            readonly type: "string";
+                                            readonly format: "date-time";
+                                            readonly description: "URL expiration time";
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                    readonly '404': {
+                        readonly description: "Analysis not found";
+                    };
+                };
+            };
+        };
+        readonly '/api/v1/mcp/email/generate': {
+            readonly post: {
+                readonly operationId: "generateNegotiationEmail";
+                readonly summary: "Generate negotiation email";
+                readonly description: "Generate a professional negotiation email to send to the counterparty, explaining requested changes and their rationale.";
+                readonly tags: readonly ["Document Generation"];
+                readonly requestBody: {
+                    readonly required: true;
+                    readonly content: {
+                        readonly 'application/json': {
+                            readonly schema: {
+                                readonly type: "object";
+                                readonly required: readonly ["analysis_id"];
+                                readonly properties: {
+                                    readonly analysis_id: {
+                                        readonly type: "string";
+                                    };
+                                    readonly tone: {
+                                        readonly type: "string";
+                                        readonly enum: readonly ["professional", "collaborative", "firm"];
+                                        readonly default: "professional";
+                                    };
+                                    readonly recipient_name: {
+                                        readonly type: "string";
+                                        readonly description: "Name of the recipient";
+                                    };
+                                    readonly sender_name: {
+                                        readonly type: "string";
+                                        readonly description: "Name of the sender";
+                                    };
+                                };
+                            };
+                        };
+                    };
+                };
+                readonly responses: {
+                    readonly '200': {
+                        readonly description: "Email draft generated";
+                        readonly content: {
+                            readonly 'application/json': {
+                                readonly schema: {
+                                    readonly type: "object";
+                                    readonly properties: {
+                                        readonly success: {
+                                            readonly type: "boolean";
+                                        };
+                                        readonly analysisId: {
+                                            readonly type: "string";
+                                        };
+                                        readonly email: {
+                                            readonly type: "object";
+                                            readonly properties: {
+                                                readonly subject: {
+                                                    readonly type: "string";
+                                                };
+                                                readonly body: {
+                                                    readonly type: "string";
+                                                };
+                                                readonly keyPoints: {
+                                                    readonly type: "array";
+                                                    readonly items: {
+                                                        readonly type: "string";
+                                                    };
+                                                };
+                                            };
+                                        };
+                                        readonly tone: {
+                                            readonly type: "string";
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                    readonly '404': {
+                        readonly description: "Analysis not found";
+                    };
+                };
+            };
+        };
+        readonly '/api/v1/mcp/analysis/{analysisId}/clause/{clauseType}': {
+            readonly get: {
+                readonly operationId: "extractClause";
+                readonly summary: "Extract and analyze specific clause";
+                readonly description: "Extract a specific clause type from an analyzed contract. Returns the clause text, risk analysis, and suggested improvements.";
+                readonly tags: readonly ["Clause Extraction"];
+                readonly parameters: readonly [{
+                    readonly name: "analysisId";
+                    readonly in: "path";
+                    readonly required: true;
+                    readonly schema: {
+                        readonly type: "string";
+                    };
+                }, {
+                    readonly name: "clauseType";
+                    readonly in: "path";
+                    readonly required: true;
+                    readonly schema: {
+                        readonly type: "string";
+                        readonly enum: readonly ["indemnification", "liability", "limitation_of_liability", "confidentiality", "ip", "intellectual_property", "termination", "term", "payment", "data_protection", "privacy", "warranty", "warranties", "force_majeure", "assignment", "insurance", "sla", "dpa"];
+                    };
+                    readonly description: "Type of clause to extract";
+                }];
+                readonly responses: {
+                    readonly '200': {
+                        readonly description: "Clause extracted successfully";
+                        readonly content: {
+                            readonly 'application/json': {
+                                readonly schema: {
+                                    readonly type: "object";
+                                    readonly properties: {
+                                        readonly success: {
+                                            readonly type: "boolean";
+                                        };
+                                        readonly analysisId: {
+                                            readonly type: "string";
+                                        };
+                                        readonly clauseType: {
+                                            readonly type: "string";
+                                        };
+                                        readonly clause: {
+                                            readonly type: "object";
+                                            readonly properties: {
+                                                readonly text: {
+                                                    readonly type: "string";
+                                                };
+                                                readonly analysis: {
+                                                    readonly type: "object";
+                                                };
+                                                readonly favorability: {
+                                                    readonly type: "object";
+                                                };
+                                                readonly risks: {
+                                                    readonly type: "array";
+                                                    readonly items: {
+                                                        readonly type: "object";
+                                                    };
+                                                };
+                                                readonly recommendations: {
+                                                    readonly type: "array";
+                                                    readonly items: {
+                                                        readonly type: "string";
+                                                    };
+                                                };
+                                            };
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                    readonly '404': {
+                        readonly description: "Analysis or clause not found";
+                    };
+                };
+            };
+        };
+        readonly '/api/v1/mcp/playbook/compare': {
+            readonly post: {
+                readonly operationId: "comparePlaybook";
+                readonly summary: "Compare against playbook";
+                readonly description: "Compare an analyzed contract against a company playbook to identify deviations from pre-approved positions.";
+                readonly tags: readonly ["Playbook"];
+                readonly requestBody: {
+                    readonly required: true;
+                    readonly content: {
+                        readonly 'application/json': {
+                            readonly schema: {
+                                readonly type: "object";
+                                readonly required: readonly ["analysis_id", "playbook_id"];
+                                readonly properties: {
+                                    readonly analysis_id: {
+                                        readonly type: "string";
+                                    };
+                                    readonly playbook_id: {
+                                        readonly type: "string";
+                                        readonly description: "ID of the playbook to compare against";
+                                    };
+                                };
+                            };
+                        };
+                    };
+                };
+                readonly responses: {
+                    readonly '200': {
+                        readonly description: "Playbook comparison results";
+                        readonly content: {
+                            readonly 'application/json': {
+                                readonly schema: {
+                                    readonly type: "object";
+                                    readonly properties: {
+                                        readonly success: {
+                                            readonly type: "boolean";
+                                        };
+                                        readonly analysisId: {
+                                            readonly type: "string";
+                                        };
+                                        readonly playbookId: {
+                                            readonly type: "string";
+                                        };
+                                        readonly playbookName: {
+                                            readonly type: "string";
+                                        };
+                                        readonly comparison: {
+                                            readonly type: "object";
+                                            readonly properties: {
+                                                readonly complianceScore: {
+                                                    readonly type: "number";
+                                                };
+                                                readonly deviations: {
+                                                    readonly type: "array";
+                                                    readonly items: {
+                                                        readonly type: "object";
+                                                    };
+                                                };
+                                                readonly totalRulesChecked: {
+                                                    readonly type: "integer";
+                                                };
+                                                readonly passedRules: {
+                                                    readonly type: "integer";
+                                                };
+                                                readonly failedRules: {
+                                                    readonly type: "integer";
+                                                };
+                                            };
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                    readonly '404': {
+                        readonly description: "Analysis or playbook not found";
+                    };
+                };
+            };
+        };
+        readonly '/api/v1/mcp/playbooks': {
+            readonly get: {
+                readonly operationId: "listPlaybooks";
+                readonly summary: "List available playbooks";
+                readonly description: "Get a list of all playbooks available for the authenticated user.";
+                readonly tags: readonly ["Playbook"];
+                readonly responses: {
+                    readonly '200': {
+                        readonly description: "List of playbooks";
+                        readonly content: {
+                            readonly 'application/json': {
+                                readonly schema: {
+                                    readonly type: "object";
+                                    readonly properties: {
+                                        readonly success: {
+                                            readonly type: "boolean";
+                                        };
+                                        readonly playbooks: {
+                                            readonly type: "array";
+                                            readonly items: {
+                                                readonly type: "object";
+                                                readonly properties: {
+                                                    readonly id: {
+                                                        readonly type: "string";
+                                                    };
+                                                    readonly name: {
+                                                        readonly type: "string";
+                                                    };
+                                                    readonly description: {
+                                                        readonly type: "string";
+                                                    };
+                                                    readonly createdAt: {
+                                                        readonly type: "string";
+                                                        readonly format: "date-time";
+                                                    };
+                                                };
+                                            };
+                                        };
+                                        readonly count: {
+                                            readonly type: "integer";
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        readonly '/api/v1/mcp/playbook/{playbookId}': {
+            readonly get: {
+                readonly operationId: "getPlaybook";
+                readonly summary: "Get playbook details";
+                readonly description: "Retrieve full details of a specific playbook including all rules and sections.";
+                readonly tags: readonly ["Playbook"];
+                readonly parameters: readonly [{
+                    readonly name: "playbookId";
+                    readonly in: "path";
+                    readonly required: true;
+                    readonly schema: {
+                        readonly type: "string";
+                    };
+                }];
+                readonly responses: {
+                    readonly '200': {
+                        readonly description: "Playbook details";
+                        readonly content: {
+                            readonly 'application/json': {
+                                readonly schema: {
+                                    readonly type: "object";
+                                    readonly properties: {
+                                        readonly success: {
+                                            readonly type: "boolean";
+                                        };
+                                        readonly playbook: {
+                                            readonly type: "object";
+                                            readonly properties: {
+                                                readonly id: {
+                                                    readonly type: "string";
+                                                };
+                                                readonly name: {
+                                                    readonly type: "string";
+                                                };
+                                                readonly description: {
+                                                    readonly type: "string";
+                                                };
+                                                readonly rules: {
+                                                    readonly type: "array";
+                                                    readonly items: {
+                                                        readonly type: "object";
+                                                    };
+                                                };
+                                                readonly sections: {
+                                                    readonly type: "array";
+                                                    readonly items: {
+                                                        readonly type: "object";
+                                                    };
+                                                };
+                                                readonly createdAt: {
+                                                    readonly type: "string";
+                                                    readonly format: "date-time";
+                                                };
+                                                readonly updatedAt: {
+                                                    readonly type: "string";
+                                                    readonly format: "date-time";
+                                                };
+                                            };
+                                        };
+                                    };
+                                };
+                            };
+                        };
+                    };
+                    readonly '404': {
+                        readonly description: "Playbook not found";
+                    };
+                };
+            };
+        };
+    };
+    readonly components: {
+        readonly securitySchemes: {
+            readonly ApiKeyAuth: {
+                readonly type: "apiKey";
+                readonly in: "header";
+                readonly name: "x-api-key";
+                readonly description: "BitsBound API key (format: sk_live_xxxxx). Get yours at https://account.bitsbound.com/api-keys";
+            };
+            readonly BearerAuth: {
+                readonly type: "http";
+                readonly scheme: "bearer";
+                readonly description: "Alternative: Authorization: Bearer sk_live_xxxxx";
+            };
+        };
+    };
+    readonly tags: readonly [{
+        readonly name: "Contract Analysis";
+        readonly description: "Upload contracts and retrieve analysis results";
+    }, {
+        readonly name: "SAC Chat";
+        readonly description: "Interactive Q&A with Supreme AI Co-Counsel";
+    }, {
+        readonly name: "Document Generation";
+        readonly description: "Generate redlined documents and negotiation emails";
+    }, {
+        readonly name: "Clause Extraction";
+        readonly description: "Extract and analyze specific contract clauses";
+    }, {
+        readonly name: "Playbook";
+        readonly description: "Company playbook management and comparison";
+    }];
+};
+/**
+ * Returns the OpenAPI spec as a JSON string, formatted for readability.
+ */
+export declare function getOpenApiSpecJson(): string;
+/**
+ * BitsBound MCP Server - Comprehensive Documentation
+ *
+ * This documentation is exported as a constant to comply with NNF (No New Files) policy.
+ * Access programmatically: `import { README_DOCUMENTATION } from './types/...Types.js'`
+ */
+export declare const README_DOCUMENTATION: "# BitsBound MCP Server\n\nAI-powered contract analysis for Claude, ChatGPT, and other AI platforms via the Model Context Protocol (MCP).\n\n## Overview\n\nBitsBound MCP Server enables AI assistants to analyze contracts, generate redlined documents with real Track Changes,\nand provide clause-by-clause risk analysis. It connects AI platforms to BitsBound's 8-Stage TCA Pipeline:\n\n1. **Loading Context** - Parsing deal context and contract structure\n2. **Extracting Data** - Running 13 deterministic extraction scripts\n3. **Identifying Parties** - AI identifying customer and vendor positions\n4. **Researching** - Running 8 parallel research analyzers\n5. **AI Analysis** - Running 18+ parallel AI analyzers (The Swarm)\n6. **Instant Swarm\u2122** - Parallel redlining across all sections (optional)\n7. **Generating Email** - Drafting negotiation email with redline summary (optional)\n8. **Synthesizing Results** - Generating final recommendations and scores\n\n## Quick Start\n\n### For Claude Desktop (MCP Protocol)\n\nAdd to your Claude Desktop configuration (`~/Library/Application Support/Claude/claude_desktop_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"bitsbound\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@bitsbound/mcp-server\"],\n      \"env\": {\n        \"BITSBOUND_API_KEY\": \"sk_live_your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\n### For ChatGPT (Custom GPT Actions)\n\n1. Create a new Custom GPT at https://chat.openai.com/gpts/editor\n2. Go to \"Configure\" \u2192 \"Create new action\"\n3. Import OpenAPI schema from: `https://bitsbound-saas-backend-mxb1.onrender.com/api/v1/mcp/openapi.json`\n4. Set Authentication: API Key, Header name: `x-api-key`\n5. Enter your BitsBound API key\n\n### For Other AI Platforms (REST API)\n\nUse the REST API directly with your API key:\n\n```bash\ncurl -X POST https://bitsbound-saas-backend-mxb1.onrender.com/api/v1/mcp/analyze \\\n  -H \"Content-Type: application/json\" \\\n  -H \"x-api-key: sk_live_your_api_key_here\" \\\n  -d '{\n    \"contract_content\": \"<base64-encoded-docx>\",\n    \"filename\": \"master-service-agreement.docx\",\n    \"analysis_type\": \"full\"\n  }'\n```\n\n## Getting Your API Key\n\n1. Sign up at https://account.bitsbound.com\n2. Subscribe to a plan (Starter: $25/mo, Professional: $125/mo, Team: $625/mo)\n3. Navigate to API Keys section\n4. Generate a new API key (format: `sk_live_xxxxx`)\n\n## Available Tools\n\n### process_contract\nUpload a contract (DOCX format, base64 encoded) for full 8-stage pipeline processing.\n\n**Parameters:**\n- `docxBase64` (required): Base64-encoded DOCX file\n- `fileName` (required): Original filename\n- `analysisDepth`: 'quick' (~5 min), 'standard' (~15 min), 'deep' (~30 min)\n- `perspective`: 'customer', 'vendor', or 'neutral'\n\n**Returns:** Analysis ID for tracking progress\n\n### get_analysis_status\nCheck the status of a running or completed analysis.\n\n**Parameters:**\n- `analysisId` (required): The analysis ID from process_contract\n\n**Returns:** Progress percentage, current phase, results when complete\n\n### ask_sac\nAsk the Supreme AI Co-Counsel questions about an analyzed contract.\n\n**Parameters:**\n- `analysisId` (required): Analysis ID of a completed analysis\n- `question` (required): Your question about the contract\n- `includeClauseCitations`: Include specific clause citations (default: true)\n\n**Returns:** AI response with clause citations and follow-up suggestions\n\n### generate_redline\nGenerate a redlined Word document with real OOXML Track Changes.\n\n**Parameters:**\n- `analysisId` (required): Analysis ID of a completed analysis\n- `aggressiveness`: 1-5 (1=conservative, 5=aggressive)\n- `includeComments`: Include rationale comments (default: true)\n\n**Returns:** Base64-encoded redlined DOCX with download URL\n\n### generate_negotiation_email\nGenerate a professional negotiation email to send to counterparty.\n\n**Parameters:**\n- `analysisId` (required): Analysis ID of a completed analysis\n- `tone`: 'collaborative', 'firm', or 'aggressive'\n- `recipientRole`: Role of the recipient (e.g., \"General Counsel\")\n\n**Returns:** Subject line, email body, and key points\n\n### extract_clause\nExtract and analyze a specific clause type from an analyzed contract.\n\n**Parameters:**\n- `analysisId` (required): Analysis ID of a completed analysis\n- `clauseType` (required): One of: 'indemnification', 'liability', 'ip', 'termination',\n  'payment', 'confidentiality', 'data_privacy', 'sla', 'force_majeure', 'assignment'\n\n**Returns:** Clause text, risk level, analysis, suggested improvements\n\n### compare_playbook\nCompare an analyzed contract against a company playbook.\n\n**Parameters:**\n- `analysisId` (required): Analysis ID of a completed analysis\n- `playbookId` (required): ID of the playbook to compare against\n\n**Returns:** Deviations, compliance score, required approvals\n\n## Example Workflow\n\n```\nUser: \"Analyze this Master Service Agreement and tell me the key risks\"\n\nClaude/ChatGPT:\n1. Calls process_contract with the uploaded DOCX (with Instant Swarm + Email enabled)\n2. Polls get_analysis_status to watch progress through 8 stages:\n   - Loading Context \u2192 Extracting Data \u2192 Identifying Parties \u2192 Researching\n   - AI Analysis \u2192 Instant Swarm\u2122 \u2192 Generating Email \u2192 Synthesizing Results\n3. Reads results showing favorability score (e.g., 42% - Vendor Favorable)\n4. Identifies top risks: unlimited liability, broad IP assignment, weak SLA\n5. User can ask follow-up questions via ask_sac (SAC has full contract context)\n6. Downloads the redlined DOCX with real Track Changes (from Instant Swarm\u2122)\n7. Reviews the auto-generated negotiation email (from Email Generator)\n```\n\n## Environment Variables\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| BITSBOUND_API_KEY | Yes | Your API key (sk_live_xxxxx) |\n| BITSBOUND_API_URL | No | API URL (default: production server) |\n\n## API Endpoints (REST)\n\nAll endpoints require `x-api-key` header or `Authorization: Bearer <key>` header.\n\n| Method | Endpoint | Description |\n|--------|----------|-------------|\n| POST | /api/v1/mcp/analyze | Start contract analysis |\n| GET | /api/v1/mcp/analysis/:id/status | Get analysis status |\n| GET | /api/v1/mcp/analysis/:id/full | Get full analysis results |\n| POST | /api/v1/mcp/sac/chat | Ask SAC questions |\n| POST | /api/v1/mcp/redline/generate | Generate redlined DOCX |\n| POST | /api/v1/mcp/email/generate | Generate negotiation email |\n| GET | /api/v1/mcp/analysis/:id/clause/:type | Extract specific clause |\n| POST | /api/v1/mcp/playbook/compare | Compare against playbook |\n| GET | /api/v1/mcp/playbook/:id | Get playbook details |\n| GET | /api/v1/mcp/playbooks | List available playbooks |\n| GET | /api/v1/mcp/openapi.json | OpenAPI specification (public) |\n\n## Pricing\n\nBitsBound uses token-based pricing. Analysis costs vary by depth:\n- Quick analysis: ~100K tokens (~$2.50)\n- Standard analysis: ~500K tokens (~$12.50)\n- Deep analysis: ~1M tokens (~$25.00)\n\nSubscription tiers include monthly token allocations:\n- Starter ($25/mo): 1M tokens\n- Professional ($125/mo): 5M tokens\n- Team ($625/mo): 25M tokens\n- Enterprise ($3,750/mo): 150M tokens\n\n## Legal Disclaimer\n\nBitsBound provides AI-assisted contract analysis tools for legal professionals. All outputs are\npreliminary drafts requiring attorney review and do not constitute legal advice. BitsBound is\nnot a law firm and does not provide legal advice.\n\n## Support\n\n- Website: https://bitsbound.com\n- Documentation: https://bitsbound.com/docs\n- API Keys: https://account.bitsbound.com/api-keys\n- Support: support@bitsbound.com\n\n## License\n\nMIT License - see package.json for details.\n\n---\n\nBuilt by Rob Taylor, Esq. - Corporate attorney and full-stack AI engineer.\n";
+/**
+ * Returns the README documentation for display or export.
+ */
+export declare function getReadmeDocumentation(): string;
+//# sourceMappingURL=Bitsbound_Kings_McpServer_Backend_Types.d.ts.map