@bitsbound/mcp-server 1.1.1 → 1.2.1

package/types/Bitsbound_Kings_McpServer_Backend_Types.ts

@@ -91,6 +91,14 @@ export type ContractVertical =
   | 'miscellaneous';          // Unknown/other (AI classifies)
 
 export interface AnalyzeContractInput {
+  // ════════════════════════════════════════════════════════════════════════════
+  // MODE: redline (attack existing contract) vs draft (generate from scratch)
+  // ════════════════════════════════════════════════════════════════════════════
+  readonly mode?: 'redline' | 'draft';  // Default: 'redline'. Draft mode requires NO file.
+
+  // ════════════════════════════════════════════════════════════════════════════
+  // CONTRACT FILE (REQUIRED for redline mode, IGNORED for draft mode)
+  // ════════════════════════════════════════════════════════════════════════════
   readonly filePath?: string;           // RECOMMENDED: Absolute path to DOCX file on disk
   readonly docxBase64?: string;         // Alternative: Base64-encoded DOCX content
   readonly fileName?: string;           // Optional if using filePath (extracted from path)
@@ -227,6 +235,8 @@ export interface CheckDealbreakersInput {
 export interface AnalyzeContractOutput {
   readonly analysisId: string;
   readonly status: 'queued' | 'processing' | 'completed' | 'failed';
+  /** T_DRAFT_MODE_2026_01_05: Mode of operation (redline = attack contract, draft = generate from scratch) */
+  readonly mode?: 'redline' | 'draft';
   readonly estimatedTimeMinutes: number;
   readonly initialRiskSummary?: string;
   /** ISO timestamp when user should check back (e.g., 25-35 minutes from now) */
@@ -475,21 +485,31 @@ export interface SectionAnalysis {
 
 export const TOOL_DEFINITIONS = {
   // ════════════════════════════════════════════════════════════════════════════════════════════════════════════════
-  // CORE TOOLS - Simplified 3-tool interface for Claude Code Plugin Marketplace
+  // CORE TOOLS - 4-tool interface for Claude Code Plugin Marketplace
   // ════════════════════════════════════════════════════════════════════════════════════════════════════════════════
 
-  process_contract: {
-    name: 'process_contract',
-    description: `Process a contract through BitsBound's full analysis pipeline. Returns partner-level redlined DOCX with Track Changes, negotiation email, and risk analysis.
+  // ────────────────────────────────────────────────────────────────────────────────────────────────────────────────
+  // REDLINE MODE: Attack existing counterparty contract with parallel SAC agents
+  // ────────────────────────────────────────────────────────────────────────────────────────────────────────────────
+  redline_swarm: {
+    name: 'redline_swarm',
+    description: `**REDLINE MODE** - Attack counterparty's contract with parallel AI agents.
+
+Upload a DOCX contract and BitsBound's Instant Swarm™ deploys parallel SAC (Supreme AI Co-Counsel) agents to analyze and redline every section simultaneously. Returns partner-level redlined DOCX with real OOXML Track Changes (w:ins/w:del), negotiation email, and risk analysis.
 
 **REQUIRED INPUTS (ask the user):**
-1. File path to the DOCX contract
+1. File path to the counterparty's DOCX contract
 2. Contract type: saas, ma, vc, employment, nda, equipment, commercial-lease, professional-services, or miscellaneous
 3. Who you represent: customer/vendor (saas), buyer/seller (ma), investor/founder (vc), etc.
 4. Aggressiveness level: 1-10 (1=conciliatory, 5=balanced, 10=aggressive)
 
 **OPTIONAL:** dealValue, additionalContext, emailRecipient info
 
+**DELIVERABLES:**
+• Redlined DOCX with real Track Changes (not markup - actual w:ins/w:del)
+• Negotiation email explaining each requested change
+• Favorability score and risk analysis
+
 Analysis takes ~25-35 minutes. Response includes 'checkBackTime' for when to check status.`,
     inputSchema: {
       type: 'object',
@@ -561,6 +581,101 @@ Analysis takes ~25-35 minutes. Response includes 'checkBackTime' for when to che
     }
   },
 
+  // ────────────────────────────────────────────────────────────────────────────────────────────────────────────────
+  // DRAFT MODE: Generate contract from scratch with multi-pass AI refinement
+  // ────────────────────────────────────────────────────────────────────────────────────────────────────────────────
+  power_draft: {
+    name: 'power_draft',
+    description: `**DRAFT MODE** - Generate a complete contract from scratch.
+
+NO FILE UPLOAD NEEDED. Provide deal context and BitsBound generates a partner-level contract using a multi-pass architecture:
+1. Opus 4.5 generates initial draft based on your requirements
+2. 16+ parallel analyzers critique the draft
+3. Sonnet 4.5 synthesizes analyzer feedback
+4. Opus 4.5 generates refined second draft
+5. Final QB Enhancer pass for consistency
+
+**REQUIRED INPUTS (ask the user):**
+1. Contract type: saas, ma, vc, employment, nda, equipment-lease, commercial-lease, professional-services
+2. Who you represent: customer/vendor (saas), buyer/seller (ma), investor/founder (vc), etc.
+3. Terms Favorability: 1-10 (1=minimal protections/fast close, 5=balanced, 10=maximum protections/bulletproof)
+
+**RECOMMENDED:** Additional context describing the deal (value, term, key requirements, counterparty info)
+
+**DELIVERABLES:**
+• Clean DOCX ready for negotiation (no Track Changes needed - it's your paper)
+• Cover email introducing the draft (optional)
+• Risk analysis of your own positions
+
+Draft generation takes ~30-40 minutes. Response includes 'checkBackTime' for when to check status.`,
+    inputSchema: {
+      type: 'object',
+      properties: {
+        // ════════════════════════════════════════════════════════════════════════════
+        // REQUIRED - Core Draft Parameters (matches UI)
+        // ════════════════════════════════════════════════════════════════════════════
+        contractVertical: {
+          type: 'string',
+          enum: ['saas', 'ma', 'vc', 'employment', 'nda', 'equipment-lease', 'equipment-financing', 'security-agreement', 'loan', 'commercial-lease', 'professional-services'],
+          description: 'Contract type to generate. REQUIRED.'
+        },
+        representingParty: {
+          type: 'string',
+          description: 'Who you represent (sets protective posture). REQUIRED. Options by vertical: saas(customer/vendor), ma(buyer/seller), vc(investor/founder), employment(employer/employee), nda(disclosing-party/receiving-party), equipment-lease(lessee/lessor), commercial-lease(tenant/landlord), professional-services(client/service-provider)'
+        },
+        aggressivenessLevel: {
+          type: 'number',
+          minimum: 1,
+          maximum: 10,
+          description: 'Terms Favorability 1-10: How protective for YOUR party. 1=minimal protections (fast close), 5=balanced (default), 10=maximum protections (bulletproof). REQUIRED.'
+        },
+
+        // ════════════════════════════════════════════════════════════════════════════
+        // OPTIONAL - Deal Context (highly recommended for better output)
+        // ════════════════════════════════════════════════════════════════════════════
+        dealValue: {
+          type: 'number',
+          description: 'Annual Contract Value for risk calibration. Optional but recommended.'
+        },
+        dealValueCurrency: {
+          type: 'string',
+          enum: ['USD', 'EUR', 'GBP', 'CAD', 'AUD'],
+          description: 'Currency for deal value. Default: USD'
+        },
+        additionalContext: {
+          type: 'string',
+          description: 'HIGHLY RECOMMENDED: Deal context for better AI drafting. Include: party names, deal value, term length, key requirements, counterparty info, risk factors, special provisions needed. Example: "Deal value: $500K/year, 3-year term. We need strong IP protections. Counterparty is a startup, so we want robust termination rights. Key contact: John Smith, CEO..."'
+        },
+
+        // ════════════════════════════════════════════════════════════════════════════
+        // OPTIONAL - Playbook & Email Settings
+        // ════════════════════════════════════════════════════════════════════════════
+        playbookId: {
+          type: 'string',
+          description: 'Playbook ID for firm-specific rules. Optional - uses BitsBound Foundational (117 rules) by default.'
+        },
+        enableEmailGenerator: {
+          type: 'boolean',
+          description: 'Generate cover email introducing the draft? Default: true'
+        },
+        emailContext: {
+          type: 'object',
+          description: 'Cover email context',
+          properties: {
+            recipientName: { type: 'string', description: 'Name of email recipient' },
+            senderName: { type: 'string', description: 'Your name (the sender)' },
+            additionalContext: { type: 'string', description: 'Tone, relationship notes, etc.' }
+          }
+        }
+      },
+      required: ['contractVertical', 'representingParty', 'aggressivenessLevel']
+    },
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: false
+    }
+  },
+
   get_analysis_status: {
     name: 'get_analysis_status',
     description: `Check analysis progress. When complete, returns:
@@ -574,7 +689,7 @@ ALWAYS display download URLs as clickable links when analysis completes.`,
       properties: {
         analysisId: {
           type: 'string',
-          description: 'Analysis ID from process_contract'
+          description: 'Analysis ID from redline_swarm or power_draft'
         }
       },
       required: ['analysisId']
@@ -650,21 +765,26 @@ export const RESOURCE_DEFINITIONS = {
  */
 export const PROMPT_DEFINITIONS = {
   // ════════════════════════════════════════════════════════════════════════════════════════════════════════════════
-  // CORE PROMPTS - Simplified 2-prompt interface matching 3-tool architecture
+  // CORE PROMPTS - 3-prompt interface matching 4-tool architecture
   // ════════════════════════════════════════════════════════════════════════════════════════════════════════════════
 
-  process_contract: {
-    name: 'process_contract',
-    description: 'Analyze Contract - Upload a DOCX and get partner-level redlines with Track Changes, risk analysis, and a negotiation email',
+  redline_swarm: {
+    name: 'redline_swarm',
+    description: 'Redline Mode - Upload counterparty\'s DOCX and get partner-level redlines with real Track Changes, risk analysis, and negotiation email',
+    arguments: []
+  },
+  power_draft: {
+    name: 'power_draft',
+    description: 'Draft Mode - Generate a complete contract from scratch with multi-pass AI refinement (Opus 4.5 drafts → Analyzers critique → Opus 4.5 refines)',
     arguments: []
   },
   check_analysis: {
     name: 'check_analysis',
-    description: 'Check Analysis Status - Check progress or download results from a running/completed analysis',
+    description: 'Check Analysis Status - Check progress or download results from a running/completed redline or draft',
     arguments: [
       {
         name: 'analysisId',
-        description: 'The analysis ID from process_contract',
+        description: 'The analysis ID from redline_swarm or power_draft',
         required: true
       }
     ]
@@ -680,49 +800,111 @@ export type PromptName = keyof typeof PROMPT_DEFINITIONS;
  */
 export const PROMPT_MESSAGES: Record<PromptName, { role: 'user'; content: { type: 'text'; text: string } }[]> = {
   // ════════════════════════════════════════════════════════════════════════════════════════════════════════════════
-  // CORE PROMPT MESSAGES - Simplified to match 3-tool architecture
+  // CORE PROMPT MESSAGES - Matches 4-tool architecture (redline_swarm, power_draft, get_analysis_status, download_file)
   // ════════════════════════════════════════════════════════════════════════════════════════════════════════════════
 
-  process_contract: [
+  redline_swarm: [
     {
       role: 'user',
-      content: { type: 'text', text: `I want to analyze a contract using BitsBound.
+      content: { type: 'text', text: `I want to analyze and redline a counterparty's contract using BitsBound's REDLINE MODE.
 
 Please help me by gathering this information:
 
-1. CONTRACT TYPE:
-   - saas, ma, vc, employment, nda, equipment, commercial-lease, professional-services, or miscellaneous
-
-2. CONTRACT FILE:
+1. CONTRACT FILE:
    - File path (e.g., /Users/john/Documents/contract.docx) - preferred
    - Or upload the DOCX directly
 
+2. CONTRACT TYPE:
+   - saas, ma, vc, employment, nda, equipment, commercial-lease, professional-services, or miscellaneous
+
 3. WHO I REPRESENT:
    - saas: customer or vendor
    - ma: buyer or seller
    - vc: investor or founder
+   - employment: employer or employee
+   - nda: disclosing-party or receiving-party
    - (etc. based on contract type)
 
 4. AGGRESSIVENESS (1-10):
    - 1 = very conciliatory, 5 = balanced, 10 = very aggressive
 
-Then call the 'process_contract' tool. Analysis takes ~25-35 minutes.
-The response includes 'checkBackTime' - tell me when to check back.
+Then call the 'redline_swarm' tool. Instant Swarm™ deploys parallel AI agents to attack every section.
+Analysis takes ~25-35 minutes. Response includes 'checkBackTime' - tell me when to check back.
+Do NOT poll automatically - wait for me to ask.` }
+    }
+  ],
+  power_draft: [
+    {
+      role: 'user',
+      content: { type: 'text', text: `I want to generate a NEW CONTRACT from scratch using BitsBound's DRAFT MODE.
+
+NO FILE UPLOAD NEEDED - just provide deal context.
+
+Please help me by gathering this information:
+
+**REQUIRED:**
+
+1. CONTRACT TYPE:
+   - saas (SaaS/Software Agreement)
+   - ma (M&A - APA, SPA, Merger)
+   - vc (VC - SAFE, Term Sheet, Series A/B/C)
+   - employment (Offer Letter, Employment Agreement)
+   - nda (Mutual or Unilateral NDA)
+   - equipment-lease (Equipment Lease)
+   - commercial-lease (Commercial Real Estate Lease)
+   - professional-services (SOW, Consulting Agreement)
+
+2. WHO YOU REPRESENT:
+   - saas: customer or vendor
+   - ma: buyer or seller
+   - vc: investor or founder
+   - employment: employer or employee
+   - nda: disclosing-party or receiving-party
+   - equipment-lease: lessee or lessor
+   - commercial-lease: tenant or landlord
+   - professional-services: client or service-provider
+
+3. TERMS FAVORABILITY (1-10):
+   - 1 = minimal protections (fast close)
+   - 5 = balanced (default)
+   - 10 = maximum protections (bulletproof)
+
+**HIGHLY RECOMMENDED - Additional Context:**
+The more context you provide, the better the AI can tailor the contract:
+- Party names (your company, counterparty)
+- Deal value (e.g., $500K/year)
+- Term length (e.g., 3-year term)
+- Key requirements (e.g., "strong IP protections", "robust termination rights")
+- Counterparty info (e.g., "startup", "Fortune 500")
+- Any special provisions needed
+
+**OPTIONAL:**
+- Annual Contract Value (for risk calibration)
+- Generate cover email? (default: yes)
+
+Then call the 'power_draft' tool. Multi-pass AI architecture:
+  1. Opus 4.5 generates initial draft
+  2. 16+ parallel analyzers critique the draft
+  3. Sonnet 4.5 synthesizes feedback
+  4. Opus 4.5 generates refined second draft
+  5. QB Enhancer finalizes for consistency
+
+Draft generation takes ~30-40 minutes. Response includes 'checkBackTime'.
 Do NOT poll automatically - wait for me to ask.` }
     }
   ],
   check_analysis: [
     {
       role: 'user',
-      content: { type: 'text', text: `I want to check on a contract analysis.
+      content: { type: 'text', text: `I want to check on a contract analysis or draft generation.
 
 Analysis ID: {analysisId}
 
 Please use 'get_analysis_status' and show me:
 - Current progress percentage
 - If complete, provide:
-  * CLICKABLE download link for the redlined DOCX
-  * Negotiation email content
+  * CLICKABLE download link for the DOCX (redlined or clean draft)
+  * Negotiation/cover email content
   * Favorability score
   * Top risks
   * Negotiation priorities