promptspeak-mcp-server 0.1.0

package/dist/translation/llm-extractor.js

@@ -0,0 +1,345 @@
+// ═══════════════════════════════════════════════════════════════════════════
+// PROMPTSPEAK TRANSLATION LAYER - LLM-POWERED EXTRACTOR
+// ═══════════════════════════════════════════════════════════════════════════
+// Uses Claude API to intelligently extract 5W+H framework from natural language.
+// This enables accurate compilation of complex task descriptions into symbols.
+// ═══════════════════════════════════════════════════════════════════════════
+class Anthropic {
+    constructor(_opts) {
+        // No-op: allows LLMExtractor to instantiate without crashing
+    }
+    messages = {
+        create: async (_opts) => {
+            throw new Error('@anthropic-ai/sdk has been removed. Reinstall the package to use LLM extraction.');
+        },
+    };
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// EXTRACTION PROMPT TEMPLATE
+// ─────────────────────────────────────────────────────────────────────────────
+const EXTRACTION_PROMPT = `You are a precise task analyzer. Extract the 5W+H framework from the given task description.
+
+TASK DESCRIPTION:
+"""
+{INPUT}
+"""
+
+Extract and respond with a JSON object containing:
+
+{
+  "who": "The target audience or stakeholder (who is this for?)",
+  "what": "What is being done or analyzed (the core task)",
+  "why": "The purpose or motivation (why is this needed?)",
+  "where": "The scope or boundaries (where does this apply?)",
+  "when": "Time context or constraints (when is this relevant?)",
+  "how": {
+    "focus": ["Key areas to emphasize"],
+    "constraints": ["Restrictions or guardrails"],
+    "output_format": "Expected output style if mentioned"
+  },
+  "commanders_intent": "The ultimate goal in one clear sentence",
+  "requirements": ["Explicit MUST requirements extracted from the text"],
+  "anti_requirements": ["Explicit MUST NOT requirements if any"],
+  "key_terms": ["Specific terms, numbers, or names that must appear in output"],
+  "inferred_mode": "strict|flexible|neutral (based on language like 'must', 'exactly', 'roughly')",
+  "inferred_domain": "financial|legal|technical|operational|strategic|general (based on context)",
+  "inferred_action": "execute|propose|delegate|escalate|commit (based on what's being asked)",
+  "confidence": 0.0-1.0
+}
+
+RULES:
+1. If a field cannot be determined, use a reasonable default or empty string/array
+2. For "requirements", extract explicit constraints like "must include X", "cite specific numbers"
+3. For "key_terms", extract specific values like "$30.8B", "Blackwell", "Q3 FY25"
+4. For "inferred_mode": use "strict" if words like "must", "exact", "specific" appear; "flexible" for "roughly", "approximately"
+5. For "inferred_domain": look for industry indicators (earnings→financial, court→legal, code→technical)
+6. Set "confidence" based on how clear and complete the task description is
+
+Respond ONLY with the JSON object, no other text.`;
+// ─────────────────────────────────────────────────────────────────────────────
+// SYMBOL ID GENERATION PROMPT
+// ─────────────────────────────────────────────────────────────────────────────
+const SYMBOL_ID_PROMPT = `Given this task description, suggest a PromptSpeak symbol ID.
+
+TASK DESCRIPTION:
+"""
+{INPUT}
+"""
+
+EXTRACTED CONTEXT:
+- What: {WHAT}
+- Where: {WHERE}
+- When: {WHEN}
+
+Symbol ID format: Ξ.CATEGORY.IDENTIFIER[.CONTEXT]
+
+Categories:
+- C = Company (e.g., Ξ.C.NVDA.Q3FY25)
+- P = Person (e.g., Ξ.P.JENSEN_HUANG)
+- E = Event (e.g., Ξ.E.EARNINGS_CALL.2024Q3)
+- S = Sector (e.g., Ξ.S.SEMICONDUCTORS)
+- T = Task (e.g., Ξ.T.PORTFOLIO_REVIEW)
+- K = Knowledge (e.g., Ξ.K.BLACKWELL_ARCHITECTURE)
+- Q = Query (e.g., Ξ.Q.REVENUE_ANALYSIS)
+
+Respond with ONLY the symbol ID (e.g., "Ξ.C.NVDA.Q3FY25"), nothing else.`;
+export class LLMExtractor {
+    client = null;
+    model;
+    maxTokens;
+    temperature;
+    constructor(options = {}) {
+        this.model = options.model || 'claude-sonnet-4-20250514';
+        this.maxTokens = options.maxTokens || 1024;
+        this.temperature = options.temperature || 0.1; // Low temperature for consistent extraction
+        // Initialize client if API key is available
+        const apiKey = options.apiKey || process.env.ANTHROPIC_API_KEY;
+        if (apiKey) {
+            this.client = new Anthropic({ apiKey });
+        }
+    }
+    /**
+     * Check if the extractor is configured with an API key.
+     */
+    isConfigured() {
+        return this.client !== null;
+    }
+    /**
+     * Extract 5W+H framework from natural language using Claude.
+     */
+    async extract5WH(naturalLanguage) {
+        if (!this.client) {
+            return {
+                success: false,
+                confidence: 0,
+                error: 'LLM extractor not configured. Set ANTHROPIC_API_KEY environment variable.',
+            };
+        }
+        try {
+            const prompt = EXTRACTION_PROMPT.replace('{INPUT}', naturalLanguage);
+            const response = await this.client.messages.create({
+                model: this.model,
+                max_tokens: this.maxTokens,
+                temperature: this.temperature,
+                messages: [{
+                        role: 'user',
+                        content: prompt,
+                    }],
+            });
+            // Extract text content
+            const textContent = response.content.find(c => c.type === 'text');
+            if (!textContent || textContent.type !== 'text') {
+                return {
+                    success: false,
+                    confidence: 0,
+                    error: 'No text response from LLM',
+                };
+            }
+            // Parse JSON response
+            const rawJson = textContent.text.trim();
+            let parsed;
+            try {
+                // Handle potential markdown code blocks
+                const jsonMatch = rawJson.match(/```(?:json)?\s*([\s\S]*?)```/) || [null, rawJson];
+                parsed = JSON.parse(jsonMatch[1] || rawJson);
+            }
+            catch (parseError) {
+                return {
+                    success: false,
+                    confidence: 0,
+                    error: `Failed to parse LLM response as JSON: ${parseError}`,
+                };
+            }
+            // Build Extracted5WH from parsed response
+            // Extract 'how' object with proper typing
+            const howObj = parsed.how;
+            const extracted = {
+                who: String(parsed.who || ''),
+                what: String(parsed.what || ''),
+                why: String(parsed.why || ''),
+                where: String(parsed.where || ''),
+                when: String(parsed.when || ''),
+                how: {
+                    focus: Array.isArray(howObj?.focus) ? howObj.focus.map(String) : [],
+                    constraints: Array.isArray(howObj?.constraints) ? howObj.constraints.map(String) : [],
+                    output_format: howObj?.output_format,
+                },
+                commanders_intent: String(parsed.commanders_intent || ''),
+                requirements: Array.isArray(parsed.requirements) ? parsed.requirements.map(String) : [],
+                anti_requirements: Array.isArray(parsed.anti_requirements) ? parsed.anti_requirements.map(String) : undefined,
+                key_terms: Array.isArray(parsed.key_terms) ? parsed.key_terms.map(String) : [],
+            };
+            return {
+                success: true,
+                extracted,
+                inferredMode: parsed.inferred_mode,
+                inferredDomain: parsed.inferred_domain,
+                inferredAction: parsed.inferred_action,
+                confidence: typeof parsed.confidence === 'number' ? parsed.confidence : 0.7,
+                tokensUsed: {
+                    input: response.usage?.input_tokens || 0,
+                    output: response.usage?.output_tokens || 0,
+                },
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                confidence: 0,
+                error: `LLM extraction failed: ${error instanceof Error ? error.message : String(error)}`,
+            };
+        }
+    }
+    /**
+     * Suggest a symbol ID based on extracted content.
+     */
+    async suggestSymbolId(naturalLanguage, extracted) {
+        if (!this.client) {
+            return null;
+        }
+        try {
+            const prompt = SYMBOL_ID_PROMPT
+                .replace('{INPUT}', naturalLanguage)
+                .replace('{WHAT}', extracted.what)
+                .replace('{WHERE}', extracted.where)
+                .replace('{WHEN}', extracted.when);
+            const response = await this.client.messages.create({
+                model: this.model,
+                max_tokens: 100,
+                temperature: 0.1,
+                messages: [{
+                        role: 'user',
+                        content: prompt,
+                    }],
+            });
+            const textContent = response.content.find(c => c.type === 'text');
+            if (!textContent || textContent.type !== 'text') {
+                return null;
+            }
+            const symbolId = textContent.text.trim();
+            // Validate format
+            if (symbolId.startsWith('Ξ.') && symbolId.split('.').length >= 3) {
+                return symbolId;
+            }
+            return null;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Full extraction: 5W+H + symbol ID suggestion.
+     */
+    async fullExtraction(naturalLanguage) {
+        const result = await this.extract5WH(naturalLanguage);
+        if (result.success && result.extracted) {
+            const symbolId = await this.suggestSymbolId(naturalLanguage, result.extracted);
+            if (symbolId) {
+                result.suggestedSymbolId = symbolId;
+            }
+        }
+        return result;
+    }
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// FALLBACK RULE-BASED EXTRACTION
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Rule-based fallback extraction when LLM is not available.
+ * Less accurate but works without API key.
+ */
+export function extractWithRules(naturalLanguage) {
+    const text = naturalLanguage.toLowerCase();
+    // Extract key terms (numbers, proper nouns, etc.)
+    const keyTerms = [];
+    const numberMatches = naturalLanguage.match(/\$[\d,.]+[BMK]?|\d+(?:\.\d+)?%|\d{4}Q\d|Q\d\s*(?:FY)?\d{2,4}/gi);
+    if (numberMatches) {
+        keyTerms.push(...numberMatches);
+    }
+    // Extract requirements (MUST statements)
+    const requirements = [];
+    const mustMatches = naturalLanguage.match(/(?:must|should|need to|required to)\s+[^.,]+/gi);
+    if (mustMatches) {
+        requirements.push(...mustMatches.map(m => m.trim()));
+    }
+    // Detect focus areas
+    const focus = [];
+    if (text.includes('revenue') || text.includes('earnings'))
+        focus.push('revenue');
+    if (text.includes('margin'))
+        focus.push('margins');
+    if (text.includes('growth'))
+        focus.push('growth');
+    if (text.includes('risk'))
+        focus.push('risks');
+    if (text.includes('guidance'))
+        focus.push('guidance');
+    // Detect constraints
+    const constraints = [];
+    if (text.includes('specific') || text.includes('exact'))
+        constraints.push('cite_specific_numbers');
+    if (text.includes('compare'))
+        constraints.push('include_comparisons');
+    if (text.includes('source') || text.includes('cite'))
+        constraints.push('cite_sources');
+    // Infer who from common patterns
+    let who = '';
+    if (text.includes('committee'))
+        who = 'Committee';
+    else if (text.includes('team'))
+        who = 'Team';
+    else if (text.includes('client'))
+        who = 'Client';
+    else if (text.includes('board'))
+        who = 'Board';
+    // Infer where from company/entity mentions
+    let where = '';
+    const companyMatch = naturalLanguage.match(/\b([A-Z]{2,5})\b/); // Ticker symbols
+    if (companyMatch) {
+        where = companyMatch[1];
+    }
+    // Infer when from time references
+    let when = '';
+    const timeMatch = naturalLanguage.match(/Q\d\s*(?:FY)?\s*\d{2,4}|\d{4}|(?:this|next|last)\s+(?:quarter|year|month)/i);
+    if (timeMatch) {
+        when = timeMatch[0];
+    }
+    return {
+        who,
+        what: naturalLanguage.slice(0, 100), // First 100 chars as summary
+        why: '',
+        where,
+        when,
+        how: {
+            focus,
+            constraints,
+        },
+        commanders_intent: naturalLanguage.slice(0, 150),
+        requirements,
+        key_terms: keyTerms,
+    };
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// SINGLETON INSTANCE
+// ─────────────────────────────────────────────────────────────────────────────
+export const llmExtractor = new LLMExtractor();
+// ─────────────────────────────────────────────────────────────────────────────
+// CONVENIENCE FUNCTIONS
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Extract 5W+H from natural language.
+ * Uses LLM if available, falls back to rules otherwise.
+ */
+export async function extract5WH(naturalLanguage, useLLM = true) {
+    if (useLLM && llmExtractor.isConfigured()) {
+        return llmExtractor.fullExtraction(naturalLanguage);
+    }
+    // Fallback to rule-based extraction
+    const extracted = extractWithRules(naturalLanguage);
+    return {
+        success: true,
+        extracted,
+        confidence: 0.4, // Lower confidence for rule-based
+    };
+}
+//# sourceMappingURL=llm-extractor.js.map

package/dist/translation/llm-extractor.js.map

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

package/dist/translation/mappings.d.ts

@@ -0,0 +1,91 @@
+import type { SymbolMapping, TranslationMappings } from './types.js';
+/**
+ * All symbol mappings with full metadata.
+ * This is the authoritative source for all translations.
+ */
+export declare const SYMBOL_MAPPINGS: SymbolMapping[];
+/**
+ * Unicode symbol to text alias mapping.
+ * e.g., '⊕' -> 'strict'
+ */
+export declare const UNICODE_TO_TEXT: Record<string, string>;
+/**
+ * Text alias to Unicode symbol mapping.
+ * e.g., 'strict' -> '⊕'
+ */
+export declare const TEXT_TO_UNICODE: Record<string, string>;
+/**
+ * Text alias to natural language mapping.
+ * e.g., 'strict' -> 'strict mode (exact compliance required)'
+ */
+export declare const TEXT_TO_NATURAL: Record<string, string>;
+/**
+ * Unicode symbol to natural language mapping.
+ * e.g., '⊕' -> 'strict mode (exact compliance required)'
+ */
+export declare const UNICODE_TO_NATURAL: Record<string, string>;
+/**
+ * Unicode symbol to category mapping.
+ * e.g., '⊕' -> 'mode'
+ */
+export declare const UNICODE_TO_CATEGORY: Record<string, string>;
+/**
+ * Text alias to category mapping.
+ * e.g., 'strict' -> 'mode'
+ */
+export declare const TEXT_TO_CATEGORY: Record<string, string>;
+/**
+ * Get all mappings for a specific category.
+ */
+export declare function getMappingsByCategory(category: string): SymbolMapping[];
+/**
+ * Complete translation mappings object for convenience.
+ */
+export declare const TRANSLATION_MAPPINGS: TranslationMappings;
+/**
+ * Patterns for detecting mode from natural language.
+ * Keys are text aliases, values are arrays of trigger patterns.
+ */
+export declare const MODE_NL_PATTERNS: Record<string, RegExp[]>;
+/**
+ * Patterns for detecting domain from natural language.
+ */
+export declare const DOMAIN_NL_PATTERNS: Record<string, RegExp[]>;
+/**
+ * Patterns for detecting action from natural language.
+ */
+export declare const ACTION_NL_PATTERNS: Record<string, RegExp[]>;
+/**
+ * Patterns for detecting entity level from natural language.
+ */
+export declare const ENTITY_NL_PATTERNS: Record<string, RegExp[]>;
+/**
+ * Detect mode from natural language text.
+ * Returns { textAlias, confidence } or null if not detected.
+ */
+export declare function detectMode(text: string): {
+    textAlias: string;
+    confidence: number;
+} | null;
+/**
+ * Detect domain from natural language text.
+ */
+export declare function detectDomain(text: string): {
+    textAlias: string;
+    confidence: number;
+} | null;
+/**
+ * Detect action from natural language text.
+ */
+export declare function detectAction(text: string): {
+    textAlias: string;
+    confidence: number;
+} | null;
+/**
+ * Detect entity level from natural language text.
+ */
+export declare function detectEntity(text: string): {
+    textAlias: string;
+    confidence: number;
+} | null;
+//# sourceMappingURL=mappings.d.ts.map

package/dist/translation/mappings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mappings.d.ts","sourceRoot":"","sources":["../../src/translation/mappings.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAMrE;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,aAAa,EAqP1C,CAAC;AAMF;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAElD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAElD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAElD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAErD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAEtD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAEnD,CAAC;AAEF;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,EAAE,CAEvE;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,mBAQlC,CAAC;AAMF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAiCrD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CA2DvD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CA8CvD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CA2BvD,CAAC;AAMF;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAazF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAa3F;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAkB3F;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAa3F"}