promptspeak-mcp-server 0.1.0

package/dist/translation/compiler.js

@@ -0,0 +1,281 @@
+// ═══════════════════════════════════════════════════════════════════════════
+// PROMPTSPEAK TRANSLATION LAYER - NATURAL LANGUAGE COMPILER
+// ═══════════════════════════════════════════════════════════════════════════
+// Compiles natural language task descriptions into PromptSpeak symbols and frames.
+// Uses LLM-powered 5W+H extraction with optional opacity wrapping.
+// ═══════════════════════════════════════════════════════════════════════════
+import { extract5WH, extractWithRules } from './llm-extractor.js';
+import { frameTranslator } from './frame-translator.js';
+import { TEXT_TO_UNICODE, detectMode, detectDomain, detectAction, detectEntity } from './mappings.js';
+import { opacityLayer } from './opacity-layer.js';
+// ─────────────────────────────────────────────────────────────────────────────
+// NATURAL LANGUAGE COMPILER
+// ─────────────────────────────────────────────────────────────────────────────
+export class NLCompiler {
+    /**
+     * Compile natural language into PromptSpeak symbol and/or frame.
+     */
+    async compile(request) {
+        try {
+            // Step 1: Extract 5W+H using LLM (or rules fallback)
+            const extractionResult = await extract5WH(request.naturalLanguage, true);
+            if (!extractionResult.success || !extractionResult.extracted) {
+                return {
+                    success: false,
+                    extracted: extractWithRules(request.naturalLanguage),
+                    confidence: 0.3,
+                    reasoning: 'Extraction failed, using rule-based fallback',
+                    error: extractionResult.error,
+                };
+            }
+            const { extracted } = extractionResult;
+            // Step 2: Infer frame from NL cues and LLM suggestions
+            let frame;
+            if (request.outputType === 'frame' || request.outputType === 'both') {
+                frame = this.inferFrame(request, extractionResult);
+            }
+            // Step 3: Generate symbol ID if requested
+            let symbol;
+            if (request.outputType === 'symbol' || request.outputType === 'both') {
+                symbol = await this.generateSymbol(request, extractionResult);
+            }
+            // Step 4: Apply opacity if needed
+            let finalExtracted = extracted;
+            let rawExtracted;
+            if (request.opacityMode === 'opaque' || request.opacityMode === 'hybrid') {
+                rawExtracted = extracted;
+                finalExtracted = await opacityLayer.applyOpacity(extracted, symbol?.symbolId);
+            }
+            // Step 5: Build response
+            return {
+                success: true,
+                symbol,
+                frame,
+                extracted: finalExtracted,
+                rawExtracted: request.opacityMode !== 'transparent' ? rawExtracted : undefined,
+                confidence: extractionResult.confidence,
+                reasoning: this.buildReasoning(extractionResult, frame),
+                alternativeInterpretations: this.generateAlternatives(request.naturalLanguage, extractionResult),
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                extracted: extractWithRules(request.naturalLanguage),
+                confidence: 0,
+                reasoning: 'Compilation failed',
+                error: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+    /**
+     * Infer frame from natural language and LLM extraction.
+     */
+    inferFrame(request, extraction) {
+        const nl = request.naturalLanguage;
+        const parts = [];
+        // Determine mode
+        let modeAlias = 'neutral';
+        if (extraction.inferredMode) {
+            modeAlias = extraction.inferredMode;
+        }
+        else if (request.frameOptions?.inferMode !== false) {
+            const detected = detectMode(nl);
+            if (detected)
+                modeAlias = detected.textAlias;
+        }
+        const modeSymbol = TEXT_TO_UNICODE[modeAlias];
+        if (modeSymbol)
+            parts.push(modeSymbol);
+        // Determine domain
+        let domainAlias = 'general';
+        if (extraction.inferredDomain) {
+            domainAlias = extraction.inferredDomain;
+        }
+        else if (request.frameOptions?.inferDomain !== false) {
+            const detected = detectDomain(nl);
+            if (detected)
+                domainAlias = detected.textAlias;
+        }
+        // Map 'general' to a valid domain
+        if (domainAlias === 'general')
+            domainAlias = 'operational';
+        const domainSymbol = TEXT_TO_UNICODE[domainAlias];
+        if (domainSymbol)
+            parts.push(domainSymbol);
+        // Determine action
+        let actionAlias = 'execute';
+        if (extraction.inferredAction) {
+            actionAlias = extraction.inferredAction;
+        }
+        else {
+            const detected = detectAction(nl);
+            if (detected)
+                actionAlias = detected.textAlias;
+        }
+        const actionSymbol = TEXT_TO_UNICODE[actionAlias];
+        if (actionSymbol)
+            parts.push(actionSymbol);
+        // Determine entity (default to secondary for delegated tasks)
+        let entityAlias = 'secondary';
+        const detected = detectEntity(nl);
+        if (detected)
+            entityAlias = detected.textAlias;
+        const entitySymbol = TEXT_TO_UNICODE[entityAlias];
+        if (entitySymbol)
+            parts.push(entitySymbol);
+        const unicode = parts.join('');
+        const textAlias = [modeAlias, domainAlias, actionAlias, entityAlias]
+            .filter(Boolean)
+            .join('.');
+        return {
+            unicode,
+            textAlias,
+            opaqueId: request.opacityMode === 'opaque'
+                ? frameTranslator.getOrCreateOpaqueId(unicode)
+                : undefined,
+        };
+    }
+    /**
+     * Generate symbol ID and metadata.
+     */
+    async generateSymbol(request, extraction) {
+        // Use LLM-suggested ID or generate from context
+        let symbolId = extraction.suggestedSymbolId;
+        if (!symbolId && extraction.extracted) {
+            symbolId = this.generateSymbolId(extraction.extracted, request.symbolOptions);
+        }
+        if (!symbolId) {
+            symbolId = `Ξ.T.TASK_${Date.now()}`;
+        }
+        // Determine category from ID
+        const parts = symbolId.split('.');
+        const categoryCode = parts[1] || 'T';
+        const categoryMap = {
+            'C': 'COMPANY',
+            'P': 'PERSON',
+            'E': 'EVENT',
+            'S': 'SECTOR',
+            'T': 'TASK',
+            'K': 'KNOWLEDGE',
+            'Q': 'QUERY',
+        };
+        const category = categoryMap[categoryCode] || 'TASK';
+        // Generate hash from content
+        const content = JSON.stringify(extraction.extracted);
+        const hash = this.simpleHash(content);
+        return {
+            symbolId,
+            category,
+            hash,
+            version: 1,
+            created: false, // Would be true if we actually saved to registry
+        };
+    }
+    /**
+     * Generate a symbol ID from extracted content.
+     */
+    generateSymbolId(extracted, options) {
+        // Use hint if provided
+        if (options?.symbolIdHint) {
+            return options.symbolIdHint;
+        }
+        // Try to extract company ticker from where/what
+        const tickerMatch = (extracted.where + ' ' + extracted.what).match(/\b([A-Z]{2,5})\b/);
+        if (tickerMatch) {
+            const ticker = tickerMatch[1];
+            const timeContext = extracted.when.replace(/\s+/g, '').toUpperCase() || '';
+            return `Ξ.C.${ticker}${timeContext ? '.' + timeContext : ''}`;
+        }
+        // Default to task-based ID
+        const slug = extracted.what
+            .slice(0, 30)
+            .toUpperCase()
+            .replace(/[^A-Z0-9]+/g, '_')
+            .replace(/_+$/, '');
+        return `Ξ.T.${slug || 'TASK'}`;
+    }
+    /**
+     * Build reasoning explanation.
+     */
+    buildReasoning(extraction, frame) {
+        const parts = [];
+        if (extraction.inferredMode) {
+            parts.push(`Mode "${extraction.inferredMode}" detected from language patterns`);
+        }
+        if (extraction.inferredDomain) {
+            parts.push(`Domain "${extraction.inferredDomain}" inferred from context`);
+        }
+        if (extraction.inferredAction) {
+            parts.push(`Action "${extraction.inferredAction}" determined from task type`);
+        }
+        if (extraction.suggestedSymbolId) {
+            parts.push(`Symbol ID "${extraction.suggestedSymbolId}" suggested based on entity identification`);
+        }
+        if (parts.length === 0) {
+            parts.push('Extracted using default inference rules');
+        }
+        return parts.join('. ') + '.';
+    }
+    /**
+     * Generate alternative interpretations if confidence is low.
+     */
+    generateAlternatives(naturalLanguage, extraction) {
+        if (extraction.confidence >= 0.8) {
+            return undefined; // High confidence, no alternatives needed
+        }
+        const alternatives = [];
+        // Suggest different modes
+        if (!extraction.inferredMode || extraction.inferredMode === 'neutral') {
+            if (/\b(should|could|might)\b/i.test(naturalLanguage)) {
+                alternatives.push({
+                    interpretation: 'Could be interpreted as flexible mode (allows interpretation)',
+                    confidence: 0.4,
+                });
+            }
+        }
+        // Suggest different domains
+        if (extraction.inferredDomain === 'financial' && /\blegal\b/i.test(naturalLanguage)) {
+            alternatives.push({
+                interpretation: 'Legal domain detected but financial context stronger',
+                confidence: 0.3,
+            });
+        }
+        return alternatives.length > 0 ? alternatives : undefined;
+    }
+    /**
+     * Simple hash function for content.
+     */
+    simpleHash(content) {
+        let hash = 0;
+        for (let i = 0; i < content.length; i++) {
+            const char = content.charCodeAt(i);
+            hash = ((hash << 5) - hash) + char;
+            hash = hash & hash;
+        }
+        return Math.abs(hash).toString(16).padStart(8, '0').slice(0, 16);
+    }
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// SINGLETON INSTANCE
+// ─────────────────────────────────────────────────────────────────────────────
+export const nlCompiler = new NLCompiler();
+// ─────────────────────────────────────────────────────────────────────────────
+// CONVENIENCE FUNCTION
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Compile natural language to PromptSpeak symbols and frames.
+ */
+export async function compileNL(naturalLanguage, options) {
+    const request = {
+        naturalLanguage,
+        outputType: options?.outputType || 'both',
+        opacityMode: options?.opacityMode || 'transparent',
+        symbolOptions: options?.symbolOptions,
+        frameOptions: options?.frameOptions,
+        extractKeyTerms: options?.extractKeyTerms ?? true,
+        extractRequirements: options?.extractRequirements ?? true,
+    };
+    return nlCompiler.compile(request);
+}
+//# sourceMappingURL=compiler.js.map

package/dist/translation/compiler.js.map

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

package/dist/translation/decompiler.d.ts

@@ -0,0 +1,29 @@
+import type { NLDecompileRequest, NLDecompileResponse } from './types.js';
+export declare class NLDecompiler {
+    /**
+     * Decompile a symbol and/or frame to natural language.
+     */
+    decompile(request: NLDecompileRequest): Promise<NLDecompileResponse>;
+    /**
+     * Generate output based on format and audience.
+     */
+    private generateOutput;
+    /**
+     * Generate combined meaning from symbol and frame.
+     */
+    private generateCombinedMeaning;
+    /**
+     * Get text alias from Unicode frame or return as-is if already text.
+     */
+    private getTextAlias;
+    /**
+     * Simple hash for audit purposes.
+     */
+    private simpleHash;
+}
+export declare const nlDecompiler: NLDecompiler;
+/**
+ * Decompile a symbol and/or frame to natural language.
+ */
+export declare function decompileNL(symbolId?: string, frame?: string, options?: Partial<NLDecompileRequest>): Promise<NLDecompileResponse>;
+//# sourceMappingURL=decompiler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"decompiler.d.ts","sourceRoot":"","sources":["../../src/translation/decompiler.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EAIpB,MAAM,YAAY,CAAC;AAsUpB,qBAAa,YAAY;IACvB;;OAEG;IACG,SAAS,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAmE1E;;OAEG;IACH,OAAO,CAAC,cAAc;IA+CtB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IA6B/B;;OAEG;IACH,OAAO,CAAC,YAAY;IAOpB;;OAEG;IACH,OAAO,CAAC,UAAU;CASnB;AAcD,eAAO,MAAM,YAAY,cAAqB,CAAC;AAM/C;;GAEG;AACH,wBAAsB,WAAW,CAC/B,QAAQ,CAAC,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GACpC,OAAO,CAAC,mBAAmB,CAAC,CAc9B"}