promptspeak-mcp-server 0.1.0

package/dist/translation/types.d.ts

@@ -0,0 +1,307 @@
+/**
+ * All possible output formats for frame translation.
+ */
+export type FrameOutputFormat = 'unicode' | 'textAlias' | 'naturalLanguage' | 'opaqueId';
+/**
+ * Request to translate a frame between formats.
+ * Provide exactly ONE of the input formats.
+ */
+export interface FrameTranslateRequest {
+    unicode?: string;
+    textAlias?: string;
+    naturalLanguage?: string;
+    opaqueId?: string;
+    outputFormats: FrameOutputFormat[];
+    nlParseMode?: 'strict' | 'fuzzy';
+    opacityMode?: 'transparent' | 'opaque';
+}
+/**
+ * Result of frame translation.
+ */
+export interface FrameTranslateResponse {
+    success: boolean;
+    unicode?: string;
+    textAlias?: string;
+    naturalLanguage?: string;
+    opaqueId?: string;
+    parsed?: {
+        mode?: {
+            symbol: string;
+            name: string;
+        };
+        domain?: {
+            symbol: string;
+            name: string;
+        };
+        action?: {
+            symbol: string;
+            name: string;
+        };
+        entity?: {
+            symbol: string;
+            name: string;
+        };
+        constraints?: Array<{
+            symbol: string;
+            name: string;
+        }>;
+        modifiers?: Array<{
+            symbol: string;
+            name: string;
+        }>;
+    };
+    isValid?: boolean;
+    validationErrors?: string[];
+    confidence?: number;
+    error?: string;
+}
+/**
+ * What to generate from natural language input.
+ */
+export type CompileOutputType = 'symbol' | 'frame' | 'both';
+/**
+ * Opacity mode for content storage.
+ */
+export type OpacityMode = 'transparent' | 'opaque' | 'hybrid';
+/**
+ * The 5W+H framework extracted from natural language.
+ */
+export interface Extracted5WH {
+    who: string;
+    what: string;
+    why: string;
+    where: string;
+    when: string;
+    how: {
+        focus: string[];
+        constraints: string[];
+        output_format?: string;
+    };
+    commanders_intent: string;
+    requirements: string[];
+    anti_requirements?: string[];
+    key_terms: string[];
+}
+/**
+ * Request to compile natural language into PromptSpeak symbols.
+ */
+export interface NLCompileRequest {
+    naturalLanguage: string;
+    outputType: CompileOutputType;
+    opacityMode: OpacityMode;
+    symbolOptions?: {
+        category?: string;
+        symbolIdHint?: string;
+        created_by?: string;
+        autoCreate?: boolean;
+        tags?: string[];
+    };
+    frameOptions?: {
+        inferMode?: boolean;
+        inferDomain?: boolean;
+        parentFrame?: string;
+    };
+    extractKeyTerms?: boolean;
+    extractRequirements?: boolean;
+}
+/**
+ * Result of natural language compilation.
+ */
+export interface NLCompileResponse {
+    success: boolean;
+    symbol?: {
+        symbolId: string;
+        category: string;
+        hash: string;
+        version: number;
+        created: boolean;
+    };
+    frame?: {
+        unicode: string;
+        textAlias: string;
+        opaqueId?: string;
+    };
+    extracted: Extracted5WH | OpaqueExtracted5WH;
+    rawExtracted?: Extracted5WH;
+    confidence: number;
+    reasoning: string;
+    alternativeInterpretations?: Array<{
+        interpretation: string;
+        confidence: number;
+    }>;
+    error?: string;
+}
+/**
+ * Extracted 5W+H with opaque content tokens.
+ */
+export interface OpaqueExtracted5WH {
+    who: string;
+    what: string;
+    why: string;
+    where: string;
+    when: string;
+    how: {
+        focus: string[];
+        constraints: string[];
+        output_format?: string;
+    };
+    commanders_intent: string;
+    requirements: string[];
+    anti_requirements?: string[];
+    key_terms: string[];
+}
+/**
+ * Output format for decompilation.
+ */
+export type DecompileOutputFormat = 'summary' | 'detailed' | 'audit' | 'stakeholder';
+/**
+ * Target audience for output formatting.
+ */
+export type DecompileAudience = 'technical' | 'executive' | 'legal' | 'general';
+/**
+ * Request to decompile symbols back to natural language.
+ */
+export interface NLDecompileRequest {
+    symbolId?: string;
+    frame?: string;
+    outputFormat: DecompileOutputFormat;
+    audience?: DecompileAudience;
+    includeHash?: boolean;
+    includeVersion?: boolean;
+    includeChangelog?: boolean;
+    resolveOpaque?: boolean;
+    authToken?: string;
+    revealTransforms?: boolean;
+}
+/**
+ * Result of decompilation to natural language.
+ */
+export interface NLDecompileResponse {
+    success: boolean;
+    naturalLanguage: string;
+    breakdown?: {
+        symbolExplanation?: string;
+        frameExplanation?: string;
+        combinedMeaning?: string;
+    };
+    auditInfo?: {
+        symbolId?: string;
+        version?: number;
+        hash?: string;
+        createdAt?: string;
+        updatedAt?: string;
+        accessedAt: string;
+        accessedBy?: string;
+    };
+    covertOpsInfo?: {
+        originalMeaning?: string;
+        transformedMeaning?: string;
+        silentTransforms?: string[];
+    };
+    unresolvedTokens?: string[];
+    error?: string;
+}
+/**
+ * An opaque token mapping stored in the database.
+ */
+export interface OpaqueMapping {
+    token: string;
+    plaintext: string;
+    symbolId?: string;
+    fieldName?: string;
+    createdAt: string;
+    expiresAt?: string;
+    accessCount: number;
+}
+/**
+ * Request to resolve opaque tokens.
+ */
+export interface OpacityResolveRequest {
+    tokens: string[];
+    authToken?: string;
+}
+/**
+ * Result of opaque token resolution.
+ */
+export interface OpacityResolveResponse {
+    success: boolean;
+    resolved: Record<string, string>;
+    unresolved: string[];
+    error?: string;
+}
+/**
+ * Request to encrypt content into opaque tokens.
+ */
+export interface OpacityEncryptRequest {
+    content: Record<string, unknown>;
+    symbolId?: string;
+}
+/**
+ * Result of content encryption.
+ */
+export interface OpacityEncryptResponse {
+    success: boolean;
+    encrypted: Record<string, unknown>;
+    tokenMap: Record<string, string>;
+    error?: string;
+}
+/**
+ * A single item in a batch translation request.
+ */
+export interface BatchTranslateItem {
+    type: 'frame' | 'symbol' | 'nl';
+    input: string;
+    outputFormat: string;
+}
+/**
+ * Request to translate multiple items.
+ */
+export interface BatchTranslateRequest {
+    items: BatchTranslateItem[];
+    opacityMode?: OpacityMode;
+    stopOnError?: boolean;
+}
+/**
+ * Result of a single item in batch translation.
+ */
+export interface BatchTranslateItemResult {
+    index: number;
+    success: boolean;
+    input: string;
+    output?: string;
+    error?: string;
+}
+/**
+ * Result of batch translation.
+ */
+export interface BatchTranslateResponse {
+    success: boolean;
+    results: BatchTranslateItemResult[];
+    summary: {
+        total: number;
+        succeeded: number;
+        failed: number;
+    };
+    error?: string;
+}
+/**
+ * A mapping entry between Unicode, text alias, and natural language.
+ */
+export interface SymbolMapping {
+    unicode: string;
+    textAlias: string;
+    naturalLanguage: string;
+    category: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Complete mapping tables for translation.
+ */
+export interface TranslationMappings {
+    unicodeToText: Record<string, string>;
+    textToUnicode: Record<string, string>;
+    textToNatural: Record<string, string>;
+    naturalToText: Record<string, string>;
+    categoryMap: Record<string, string>;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/translation/types.js

@@ -0,0 +1,8 @@
+// ═══════════════════════════════════════════════════════════════════════════
+// PROMPTSPEAK TRANSLATION LAYER - TYPE DEFINITIONS
+// ═══════════════════════════════════════════════════════════════════════════
+// Bidirectional translation between natural language and PromptSpeak symbols.
+// Implements hybrid opacity: readable IDs with opaque content.
+// ═══════════════════════════════════════════════════════════════════════════
+export {};
+//# sourceMappingURL=types.js.map

package/dist/translation/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/translation/types.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,mDAAmD;AACnD,8EAA8E;AAC9E,8EAA8E;AAC9E,+DAA+D;AAC/D,8EAA8E"}