promptspeak-mcp-server 0.1.0

package/dist/translation/index.js

@@ -0,0 +1,397 @@
+// ═══════════════════════════════════════════════════════════════════════════
+// PROMPTSPEAK TRANSLATION LAYER - INDEX & TOOL HANDLERS
+// ═══════════════════════════════════════════════════════════════════════════
+// Main entry point for the translation layer.
+// Exports all translation components and MCP tool handlers.
+// ═══════════════════════════════════════════════════════════════════════════
+// Re-export all types
+export * from './types.js';
+// Re-export mappings
+export { SYMBOL_MAPPINGS, UNICODE_TO_TEXT, TEXT_TO_UNICODE, UNICODE_TO_NATURAL, TEXT_TO_NATURAL, UNICODE_TO_CATEGORY, TEXT_TO_CATEGORY, TRANSLATION_MAPPINGS, getMappingsByCategory, detectMode, detectDomain, detectAction, detectEntity, MODE_NL_PATTERNS, DOMAIN_NL_PATTERNS, ACTION_NL_PATTERNS, ENTITY_NL_PATTERNS, } from './mappings.js';
+// Re-export frame translator
+export { FrameTranslator, frameTranslator, translateFrame, unicodeToText, textToUnicode, unicodeToNatural, naturalToUnicode, } from './frame-translator.js';
+// Re-export LLM extractor
+export { LLMExtractor, llmExtractor, extract5WH, extractWithRules, } from './llm-extractor.js';
+// Re-export NL compiler
+export { NLCompiler, nlCompiler, compileNL, } from './compiler.js';
+// Re-export NL decompiler
+export { NLDecompiler, nlDecompiler, decompileNL, } from './decompiler.js';
+// Re-export opacity layer
+export { OpacityLayer, opacityLayer, encrypt, decrypt, resolveTokens, applyOpacity, removeOpacity, } from './opacity-layer.js';
+import { frameTranslator } from './frame-translator.js';
+import { nlCompiler } from './compiler.js';
+import { nlDecompiler } from './decompiler.js';
+import { opacityLayer } from './opacity-layer.js';
+/**
+ * Tool definition for ps_frame_translate.
+ */
+export const PS_FRAME_TRANSLATE_TOOL = {
+    name: 'ps_frame_translate',
+    description: `Translate PromptSpeak frames between formats:
+- Unicode symbols (⊕◊▶β)
+- Text aliases (strict.financial.execute.secondary)
+- Natural language ("strict mode, financial domain, execute action")
+- Opaque IDs (::34920)
+
+Provide exactly ONE input format and specify which output formats you want.`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            unicode: {
+                type: 'string',
+                description: 'Unicode frame input (e.g., "⊕◊▶β")',
+            },
+            textAlias: {
+                type: 'string',
+                description: 'Text alias input (e.g., "strict.financial.execute.secondary")',
+            },
+            naturalLanguage: {
+                type: 'string',
+                description: 'Natural language input (e.g., "strict mode, financial domain")',
+            },
+            opaqueId: {
+                type: 'string',
+                description: 'Opaque ID input (e.g., "::34920")',
+            },
+            outputFormats: {
+                type: 'array',
+                items: {
+                    type: 'string',
+                    enum: ['unicode', 'textAlias', 'naturalLanguage', 'opaqueId'],
+                },
+                description: 'Output formats to generate',
+                default: ['unicode', 'textAlias', 'naturalLanguage'],
+            },
+            nlParseMode: {
+                type: 'string',
+                enum: ['strict', 'fuzzy'],
+                description: 'How strictly to parse natural language (default: fuzzy)',
+                default: 'fuzzy',
+            },
+            opacityMode: {
+                type: 'string',
+                enum: ['transparent', 'opaque'],
+                description: 'Whether to generate opaque IDs',
+                default: 'transparent',
+            },
+        },
+        required: ['outputFormats'],
+    },
+};
+/**
+ * Tool definition for ps_nl_compile.
+ * Compiles natural language into PromptSpeak symbols and frames using LLM-powered extraction.
+ */
+export const PS_NL_COMPILE_TOOL = {
+    name: 'ps_nl_compile',
+    description: `Compile natural language task descriptions into PromptSpeak symbols and frames.
+
+Uses LLM-powered 5W+H extraction to intelligently parse:
+- WHO: Target audience or stakeholder
+- WHAT: The core task being performed
+- WHY: Purpose or motivation
+- WHERE: Scope or boundaries
+- WHEN: Time context
+- HOW: Focus areas, constraints, output format
+
+Returns a symbol ID (e.g., Ξ.NVDA.Q3FY25) and/or frame (e.g., strict.financial.execute.secondary).
+Content can be wrapped in opaque tokens (::34920) for security.`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            naturalLanguage: {
+                type: 'string',
+                description: 'The natural language task description to compile',
+            },
+            outputType: {
+                type: 'string',
+                enum: ['symbol', 'frame', 'both'],
+                description: 'What to generate: symbol ID, frame, or both (default: both)',
+                default: 'both',
+            },
+            opacityMode: {
+                type: 'string',
+                enum: ['transparent', 'opaque', 'hybrid'],
+                description: 'Content visibility: transparent (visible), opaque (::tokens), or hybrid (visible ID, opaque content). Default: transparent',
+                default: 'transparent',
+            },
+            symbolIdHint: {
+                type: 'string',
+                description: 'Optional hint for symbol ID generation (e.g., "NVDA" for NVIDIA)',
+            },
+            autoCreate: {
+                type: 'boolean',
+                description: 'Whether to actually create the symbol in the registry (default: false)',
+                default: false,
+            },
+            extractKeyTerms: {
+                type: 'boolean',
+                description: 'Extract specific terms, numbers, and names that must appear in output (default: true)',
+                default: true,
+            },
+            extractRequirements: {
+                type: 'boolean',
+                description: 'Extract explicit MUST/MUST NOT requirements (default: true)',
+                default: true,
+            },
+        },
+        required: ['naturalLanguage'],
+    },
+};
+/**
+ * Tool definition for ps_nl_decompile.
+ * Converts PromptSpeak symbols and frames back to human-readable natural language.
+ */
+export const PS_NL_DECOMPILE_TOOL = {
+    name: 'ps_nl_decompile',
+    description: `Convert PromptSpeak symbols and frames back to human-readable natural language.
+
+Supports multiple output formats for different audiences:
+- summary: Brief overview (1-3 sentences)
+- detailed: Full breakdown with sections
+- audit: Formal record with hash, version, timestamps
+- stakeholder: Non-technical explanation for executives
+
+Provide a symbol ID (e.g., Ξ.NVDA.Q3FY25) and/or frame (e.g., ⊕◊▶β) to explain.`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            symbolId: {
+                type: 'string',
+                description: 'Symbol ID to explain (e.g., "Ξ.NVDA.Q3FY25")',
+            },
+            frame: {
+                type: 'string',
+                description: 'Frame to explain - Unicode (e.g., "⊕◊▶β") or text alias (e.g., "strict.financial.execute")',
+            },
+            outputFormat: {
+                type: 'string',
+                enum: ['summary', 'detailed', 'audit', 'stakeholder'],
+                description: 'Output format (default: summary)',
+                default: 'summary',
+            },
+            audience: {
+                type: 'string',
+                enum: ['technical', 'executive', 'legal', 'general'],
+                description: 'Target audience - affects language and detail level (default: general)',
+                default: 'general',
+            },
+            includeHash: {
+                type: 'boolean',
+                description: 'Include content hash in output (default: false)',
+                default: false,
+            },
+            includeVersion: {
+                type: 'boolean',
+                description: 'Include version number in output (default: false)',
+                default: false,
+            },
+            resolveOpaque: {
+                type: 'boolean',
+                description: 'Resolve opaque tokens (::12345) to plain text - requires authToken (default: false)',
+                default: false,
+            },
+            authToken: {
+                type: 'string',
+                description: 'Authorization token for resolving opaque content',
+            },
+        },
+        required: [],
+    },
+};
+/**
+ * Tool definition for ps_opacity_resolve.
+ * Resolves opaque tokens back to plaintext (requires authorization).
+ */
+export const PS_OPACITY_RESOLVE_TOOL = {
+    name: 'ps_opacity_resolve',
+    description: `Resolve opaque tokens (::12345) back to their original plaintext values.
+
+Opaque tokens are used to protect sensitive content in PromptSpeak symbols.
+This tool decrypts them for authorized users.
+
+Example tokens: ::10001, ::10002, ::10003`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            tokens: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Array of opaque tokens to resolve (e.g., ["::10001", "::10002"])',
+            },
+            authToken: {
+                type: 'string',
+                description: 'Authorization token (currently optional, will be required in production)',
+            },
+        },
+        required: ['tokens'],
+    },
+};
+/**
+ * Tool definition for ps_opacity_stats.
+ * Get statistics about the opacity layer.
+ */
+export const PS_OPACITY_STATS_TOOL = {
+    name: 'ps_opacity_stats',
+    description: `Get statistics about the opacity layer including token counts and access patterns.`,
+    inputSchema: {
+        type: 'object',
+        properties: {},
+        required: [],
+    },
+};
+/**
+ * All translation tool definitions for registration in server.ts.
+ */
+export const translationToolDefinitions = [
+    PS_FRAME_TRANSLATE_TOOL,
+    PS_NL_COMPILE_TOOL,
+    PS_NL_DECOMPILE_TOOL,
+    PS_OPACITY_RESOLVE_TOOL,
+    PS_OPACITY_STATS_TOOL,
+    // Future tools will be added here:
+    // PS_TRANSLATE_BATCH_TOOL,
+];
+// ─────────────────────────────────────────────────────────────────────────────
+// MCP TOOL HANDLERS
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Handle ps_frame_translate tool call.
+ */
+export function handleFrameTranslate(args) {
+    const outputFormats = args.outputFormats || ['unicode', 'textAlias', 'naturalLanguage'];
+    const request = {
+        unicode: args.unicode,
+        textAlias: args.textAlias,
+        naturalLanguage: args.naturalLanguage,
+        opaqueId: args.opaqueId,
+        outputFormats: outputFormats,
+        nlParseMode: args.nlParseMode || 'fuzzy',
+        opacityMode: args.opacityMode || 'transparent',
+    };
+    const result = frameTranslator.translate(request);
+    // Convert to plain object for MCP response
+    return { ...result };
+}
+/**
+ * Handle ps_nl_compile tool call.
+ * Compiles natural language into PromptSpeak symbols and frames.
+ */
+export async function handleNLCompile(args) {
+    const naturalLanguage = args.naturalLanguage;
+    if (!naturalLanguage) {
+        return {
+            success: false,
+            error: 'naturalLanguage is required',
+        };
+    }
+    const request = {
+        naturalLanguage,
+        outputType: args.outputType || 'both',
+        opacityMode: args.opacityMode || 'transparent',
+        symbolOptions: args.symbolIdHint ? {
+            symbolIdHint: args.symbolIdHint,
+            autoCreate: args.autoCreate,
+        } : undefined,
+        extractKeyTerms: args.extractKeyTerms !== false,
+        extractRequirements: args.extractRequirements !== false,
+    };
+    const result = await nlCompiler.compile(request);
+    // Convert to plain object for MCP response
+    return { ...result };
+}
+/**
+ * Handle ps_nl_decompile tool call.
+ * Converts symbols and frames back to human-readable natural language.
+ */
+export async function handleNLDecompile(args) {
+    const symbolId = args.symbolId;
+    const frame = args.frame;
+    if (!symbolId && !frame) {
+        return {
+            success: false,
+            error: 'Either symbolId or frame must be provided',
+        };
+    }
+    const request = {
+        symbolId,
+        frame,
+        outputFormat: args.outputFormat || 'summary',
+        audience: args.audience || 'general',
+        includeHash: args.includeHash,
+        includeVersion: args.includeVersion,
+        resolveOpaque: args.resolveOpaque,
+        authToken: args.authToken,
+    };
+    const result = await nlDecompiler.decompile(request);
+    // Convert to plain object for MCP response
+    return { ...result };
+}
+/**
+ * Handle ps_opacity_resolve tool call.
+ * Resolves opaque tokens back to plaintext.
+ */
+export async function handleOpacityResolve(args) {
+    const tokens = args.tokens;
+    if (!tokens || !Array.isArray(tokens)) {
+        return {
+            success: false,
+            error: 'tokens must be an array of strings',
+            resolved: {},
+            unresolved: [],
+        };
+    }
+    const request = {
+        tokens,
+        authToken: args.authToken,
+    };
+    const result = await opacityLayer.resolve(request);
+    // Convert to plain object for MCP response
+    return { ...result };
+}
+/**
+ * Handle ps_opacity_stats tool call.
+ * Returns statistics about the opacity layer.
+ */
+export async function handleOpacityStats() {
+    try {
+        const stats = await opacityLayer.getStats();
+        return {
+            success: true,
+            ...stats,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+/**
+ * Main handler for all translation tools.
+ * Routes to the appropriate handler based on tool name.
+ */
+export async function handleTranslationTool(toolName, args) {
+    switch (toolName) {
+        case 'ps_frame_translate':
+            return handleFrameTranslate(args);
+        case 'ps_nl_compile':
+            return handleNLCompile(args);
+        case 'ps_nl_decompile':
+            return handleNLDecompile(args);
+        case 'ps_opacity_resolve':
+            return handleOpacityResolve(args);
+        case 'ps_opacity_stats':
+            return handleOpacityStats();
+        // Future handlers:
+        // case 'ps_translate_batch':
+        //   return handleTranslateBatch(args);
+        default:
+            return {
+                success: false,
+                error: `Unknown translation tool: ${toolName}`,
+            };
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/translation/index.js.map

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

package/dist/translation/llm-extractor.d.ts

@@ -0,0 +1,56 @@
+import type { Extracted5WH } from './types.js';
+export interface LLMExtractionResult {
+    success: boolean;
+    extracted?: Extracted5WH;
+    inferredMode?: string;
+    inferredDomain?: string;
+    inferredAction?: string;
+    suggestedSymbolId?: string;
+    confidence: number;
+    error?: string;
+    tokensUsed?: {
+        input: number;
+        output: number;
+    };
+}
+export interface LLMExtractorOptions {
+    apiKey?: string;
+    model?: string;
+    maxTokens?: number;
+    temperature?: number;
+}
+export declare class LLMExtractor {
+    private client;
+    private model;
+    private maxTokens;
+    private temperature;
+    constructor(options?: LLMExtractorOptions);
+    /**
+     * Check if the extractor is configured with an API key.
+     */
+    isConfigured(): boolean;
+    /**
+     * Extract 5W+H framework from natural language using Claude.
+     */
+    extract5WH(naturalLanguage: string): Promise<LLMExtractionResult>;
+    /**
+     * Suggest a symbol ID based on extracted content.
+     */
+    suggestSymbolId(naturalLanguage: string, extracted: Extracted5WH): Promise<string | null>;
+    /**
+     * Full extraction: 5W+H + symbol ID suggestion.
+     */
+    fullExtraction(naturalLanguage: string): Promise<LLMExtractionResult>;
+}
+/**
+ * Rule-based fallback extraction when LLM is not available.
+ * Less accurate but works without API key.
+ */
+export declare function extractWithRules(naturalLanguage: string): Extracted5WH;
+export declare const llmExtractor: LLMExtractor;
+/**
+ * Extract 5W+H from natural language.
+ * Uses LLM if available, falls back to rules otherwise.
+ */
+export declare function extract5WH(naturalLanguage: string, useLLM?: boolean): Promise<LLMExtractionResult>;
+//# sourceMappingURL=llm-extractor.d.ts.map

package/dist/translation/llm-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-extractor.d.ts","sourceRoot":"","sources":["../../src/translation/llm-extractor.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AA+E/C,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,YAAY,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE;QACX,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,WAAW,CAAS;gBAEhB,OAAO,GAAE,mBAAwB;IAY7C;;OAEG;IACH,YAAY,IAAI,OAAO;IAIvB;;OAEG;IACG,UAAU,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA0FvE;;OAEG;IACG,eAAe,CACnB,eAAe,EAAE,MAAM,EACvB,SAAS,EAAE,YAAY,GACtB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAwCzB;;OAEG;IACG,cAAc,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAY5E;AAMD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,eAAe,EAAE,MAAM,GAAG,YAAY,CAkEtE;AAMD,eAAO,MAAM,YAAY,cAAqB,CAAC;AAM/C;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,eAAe,EAAE,MAAM,EACvB,MAAM,GAAE,OAAc,GACrB,OAAO,CAAC,mBAAmB,CAAC,CAY9B"}