promptspeak-mcp-server 0.1.0

package/dist/gatekeeper/resolver.js

@@ -0,0 +1,314 @@
+// ═══════════════════════════════════════════════════════════════════════════
+// PROMPTSPEAK MCP SERVER - DYNAMIC RESOLVER
+// ═══════════════════════════════════════════════════════════════════════════
+// The Dynamic Resolver translates frames into actionable semantics.
+// Operator configurations can modify symbol meanings per deployment.
+// ═══════════════════════════════════════════════════════════════════════════
+import { generateIntentHash } from '../utils/hash.js';
+// Default symbol ontology (embedded for self-containment)
+const DEFAULT_ONTOLOGY = {
+    modes: {
+        '⊕': { name: 'strict', canonical: 'strict', color: '#22c55e', category: 'mode', strength: 1 },
+        '⊖': { name: 'flexible', canonical: 'flexible', color: '#3b82f6', category: 'mode', strength: 3 },
+        '⊗': { name: 'forbidden', canonical: 'forbidden', color: '#ef4444', category: 'mode', strength: 4 },
+        '⊘': { name: 'neutral', canonical: 'neutral', color: '#6b7280', category: 'mode', strength: 2 },
+    },
+    domains: {
+        '◊': { name: 'financial', canonical: 'financial', color: '#f59e0b', category: 'domain' },
+        '◈': { name: 'legal', canonical: 'legal', color: '#8b5cf6', category: 'domain' },
+        '◇': { name: 'technical', canonical: 'technical', color: '#06b6d4', category: 'domain' },
+        '◆': { name: 'operational', canonical: 'operational', color: '#10b981', category: 'domain' },
+        '◐': { name: 'strategic', canonical: 'strategic', color: '#ec4899', category: 'domain' },
+    },
+    constraints: {
+        '⛔': { name: 'forbidden', canonical: 'forbidden', color: '#ef4444', category: 'constraint', strength: 1, inherits: true },
+        '✗': { name: 'rejected', canonical: 'rejected', color: '#f97316', category: 'constraint', strength: 2, inherits: false },
+        '⚠': { name: 'warning', canonical: 'warning', color: '#f59e0b', category: 'constraint', strength: 3, inherits: false },
+        '✓': { name: 'approved', canonical: 'approved', color: '#22c55e', category: 'constraint', strength: 4, inherits: false },
+    },
+    actions: {
+        '▶': { name: 'execute', canonical: 'execute', color: '#22c55e', category: 'action' },
+        '◀': { name: 'revert', canonical: 'revert', color: '#f59e0b', category: 'action' },
+        '▲': { name: 'escalate', canonical: 'escalate', color: '#ef4444', category: 'action' },
+        '▼': { name: 'delegate', canonical: 'delegate', color: '#3b82f6', category: 'action' },
+        '●': { name: 'commit', canonical: 'commit', color: '#8b5cf6', category: 'action' },
+        '○': { name: 'propose', canonical: 'propose', color: '#6b7280', category: 'action' },
+    },
+    modifiers: {
+        '↑': { name: 'priority_high', canonical: 'priority_high', color: '#ef4444', category: 'modifier' },
+        '↓': { name: 'priority_low', canonical: 'priority_low', color: '#6b7280', category: 'modifier' },
+        '↔': { name: 'bidirectional', canonical: 'bidirectional', color: '#3b82f6', category: 'modifier' },
+        '⟳': { name: 'iterative', canonical: 'iterative', color: '#10b981', category: 'modifier' },
+        '⟲': { name: 'rollback', canonical: 'rollback', color: '#f59e0b', category: 'modifier' },
+    },
+    sources: {
+        '⌘': { name: 'system', canonical: 'system', color: '#6b7280', category: 'source' },
+        '⌥': { name: 'user', canonical: 'user', color: '#3b82f6', category: 'source' },
+        '⇧': { name: 'elevated', canonical: 'elevated', color: '#ef4444', category: 'source' },
+    },
+    entities: {
+        'α': { name: 'primary_agent', canonical: 'primary_agent', color: '#3b82f6', category: 'entity', level: 1 },
+        'β': { name: 'secondary_agent', canonical: 'secondary_agent', color: '#8b5cf6', category: 'entity', level: 2 },
+        'γ': { name: 'tertiary_agent', canonical: 'tertiary_agent', color: '#06b6d4', category: 'entity', level: 3 },
+        'ω': { name: 'terminal_agent', canonical: 'terminal_agent', color: '#10b981', category: 'entity', level: 4 },
+    },
+};
+export class DynamicResolver {
+    ontology;
+    activeOverlay = null;
+    constructor(ontology) {
+        this.ontology = ontology || DEFAULT_ONTOLOGY;
+    }
+    /**
+     * Set the active policy overlay for dynamic resolution.
+     */
+    setOverlay(overlay) {
+        this.activeOverlay = overlay;
+    }
+    /**
+     * Get the active overlay.
+     */
+    getOverlay() {
+        return this.activeOverlay;
+    }
+    /**
+     * Parse a raw frame string into structured symbols.
+     */
+    parseFrame(rawFrame) {
+        const symbols = [];
+        const chars = [...rawFrame];
+        for (const char of chars) {
+            const parsed = this.lookupSymbol(char);
+            if (parsed) {
+                symbols.push(parsed);
+            }
+        }
+        // If no symbols parsed, return null
+        if (symbols.length === 0) {
+            return null;
+        }
+        // Extract specific symbol types (as strings for convenience)
+        const modeSymbol = symbols.find(s => s.category === 'modes');
+        const domainSymbol = symbols.find(s => s.category === 'domains');
+        const constraintSymbols = symbols.filter(s => s.category === 'constraints');
+        const actionSymbol = symbols.find(s => s.category === 'actions');
+        const modifierSymbols = symbols.filter(s => s.category === 'modifiers');
+        const sourceSymbol = symbols.find(s => s.category === 'sources');
+        const entitySymbol = symbols.find(s => s.category === 'entities');
+        const parsed = {
+            raw: rawFrame,
+            symbols,
+            // Simple string accessors for convenience
+            mode: modeSymbol?.symbol ?? null,
+            modifiers: modifierSymbols.map(s => s.symbol),
+            domain: domainSymbol?.symbol ?? null,
+            source: sourceSymbol?.symbol ?? null,
+            constraints: constraintSymbols.map(s => s.symbol),
+            action: actionSymbol?.symbol ?? null,
+            entity: entitySymbol?.symbol ?? null,
+            // Full symbol objects
+            modeSymbol,
+            domainSymbol,
+            constraintSymbols,
+            actionSymbol,
+            modifierSymbols,
+            sourceSymbol,
+            entitySymbol,
+            // Metadata
+            metadata: {},
+            intentHash: generateIntentHash(symbols),
+            parseConfidence: this.calculateParseConfidence(symbols, rawFrame),
+        };
+        return parsed;
+    }
+    /**
+     * Look up a symbol in the ontology.
+     */
+    lookupSymbol(char) {
+        for (const [category, symbols] of Object.entries(this.ontology)) {
+            if (symbols[char]) {
+                return {
+                    symbol: char,
+                    category: category,
+                    definition: symbols[char],
+                };
+            }
+        }
+        return null;
+    }
+    /**
+     * Calculate parse confidence based on symbol coverage.
+     */
+    calculateParseConfidence(symbols, rawFrame) {
+        if (rawFrame.length === 0)
+            return 0;
+        const parsedChars = symbols.length;
+        const totalChars = [...rawFrame].length;
+        // Base confidence from symbol recognition
+        let confidence = parsedChars / totalChars;
+        // Bonus for having required categories
+        const hasMode = symbols.some(s => s.category === 'modes');
+        const hasDomain = symbols.some(s => s.category === 'domains');
+        const hasAction = symbols.some(s => s.category === 'actions');
+        if (hasMode)
+            confidence += 0.1;
+        if (hasDomain)
+            confidence += 0.1;
+        if (hasAction)
+            confidence += 0.1;
+        return Math.min(1.0, confidence);
+    }
+    /**
+     * Resolve a parsed frame with operator overrides applied.
+     * This is the core of the dynamic resolution.
+     */
+    resolveFrame(parsedFrame) {
+        const effectiveMode = this.applyOverride(parsedFrame.modeSymbol);
+        const effectiveDomain = this.applyOverride(parsedFrame.domainSymbol);
+        const effectiveConstraint = parsedFrame.constraintSymbols?.length
+            ? this.applyOverride(parsedFrame.constraintSymbols[0])
+            : undefined;
+        const effectiveAction = this.applyOverride(parsedFrame.actionSymbol);
+        // Build tool bindings from overlay
+        const toolBindings = this.buildToolBindings(parsedFrame);
+        // Check for blocked symbols from overlay
+        const blockedSymbols = [];
+        if (this.activeOverlay) {
+            for (const symbol of parsedFrame.symbols) {
+                const override = this.activeOverlay.symbolOverrides?.[symbol.symbol];
+                if (override?.blocked) {
+                    blockedSymbols.push(symbol.symbol);
+                }
+            }
+        }
+        const defaultMode = {
+            name: 'neutral',
+            canonical: 'neutral',
+            color: '#6b7280',
+            category: 'mode',
+            strength: 2
+        };
+        const defaultDomain = {
+            name: 'operational',
+            canonical: 'operational',
+            color: '#10b981',
+            category: 'domain'
+        };
+        const defaultAction = {
+            name: 'propose',
+            canonical: 'propose',
+            color: '#6b7280',
+            category: 'action'
+        };
+        return {
+            ...parsedFrame,
+            // Required ResolvedFrame properties
+            effectiveMode: effectiveMode || defaultMode,
+            effectiveDomain: effectiveDomain || defaultDomain,
+            effectiveConstraint,
+            effectiveAction: effectiveAction || defaultAction,
+            // Backward-compatible aliases
+            modeDefinition: effectiveMode || defaultMode,
+            domainDefinition: effectiveDomain || defaultDomain,
+            constraintDefinition: effectiveConstraint,
+            actionDefinition: effectiveAction || defaultAction,
+            allowedTools: toolBindings.allowed,
+            blockedTools: toolBindings.blocked,
+            blockedSymbols,
+            overlayApplied: this.activeOverlay !== null,
+            toolBindings,
+        };
+    }
+    /**
+     * Apply operator override to a symbol definition.
+     */
+    applyOverride(symbol) {
+        if (!symbol)
+            return undefined;
+        const base = { ...symbol.definition };
+        if (this.activeOverlay?.symbolOverrides[symbol.symbol]) {
+            const override = this.activeOverlay.symbolOverrides[symbol.symbol];
+            return {
+                ...base,
+                extensions: override.extensions,
+            };
+        }
+        return base;
+    }
+    /**
+     * Build tool bindings from the active overlay.
+     */
+    buildToolBindings(parsedFrame) {
+        const blocked = new Set();
+        const allowed = new Set();
+        let rateLimit;
+        if (!this.activeOverlay) {
+            // Default: allow all if no overlay
+            return { blocked: [], allowed: ['*'] };
+        }
+        for (const symbol of parsedFrame.symbols) {
+            const binding = this.activeOverlay.toolBindings?.[symbol.symbol];
+            // Type guard: check if binding is an object with expected structure (not an array)
+            if (binding && typeof binding === 'object' && !Array.isArray(binding)) {
+                const bindingObj = binding;
+                bindingObj.blocked?.forEach((t) => blocked.add(t));
+                bindingObj.allowed?.forEach((t) => allowed.add(t));
+                if (bindingObj.rateLimit) {
+                    rateLimit = bindingObj.rateLimit;
+                }
+            }
+        }
+        // If constraint includes ⛔ (forbidden), block all execution tools
+        if (parsedFrame.constraints.includes('⛔')) {
+            blocked.add('*_execute');
+            blocked.add('*_write');
+            blocked.add('*_delete');
+        }
+        return {
+            blocked: Array.from(blocked),
+            allowed: allowed.size > 0 ? Array.from(allowed) : ['*'],
+            rateLimit,
+        };
+    }
+    /**
+     * Check if a tool is allowed given the resolved frame.
+     */
+    isToolAllowed(resolvedFrame, toolName) {
+        const { blocked, allowed } = resolvedFrame.toolBindings;
+        // Check blocked patterns first
+        for (const pattern of blocked) {
+            if (this.matchPattern(pattern, toolName)) {
+                return false;
+            }
+        }
+        // Check allowed patterns
+        for (const pattern of allowed) {
+            if (this.matchPattern(pattern, toolName)) {
+                return true;
+            }
+        }
+        // Default deny
+        return false;
+    }
+    /**
+     * Match a tool name against a pattern (supports * wildcard).
+     */
+    matchPattern(pattern, toolName) {
+        if (pattern === '*')
+            return true;
+        if (pattern.includes('*')) {
+            const regex = new RegExp('^' + pattern.replace(/\*/g, '.*') + '$');
+            return regex.test(toolName);
+        }
+        return pattern === toolName;
+    }
+    /**
+     * Get the default ontology.
+     */
+    getOntology() {
+        return this.ontology;
+    }
+}
+// Singleton instance for convenience
+export const resolver = new DynamicResolver();
+//# sourceMappingURL=resolver.js.map

package/dist/gatekeeper/resolver.js.map

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

package/dist/gatekeeper/validator.d.ts

@@ -0,0 +1,26 @@
+import type { ParsedFrame, ValidationReport } from '../types/index.js';
+export declare class FrameValidator {
+    /**
+     * Validate a frame through all three tiers.
+     */
+    validate(frame: ParsedFrame, parentFrame?: ParsedFrame): ValidationReport;
+    /**
+     * Validate structural rules only.
+     */
+    validateStructural(frame: ParsedFrame): ValidationReport;
+    /**
+     * Validate semantic rules only.
+     */
+    validateSemantic(frame: ParsedFrame): ValidationReport;
+    /**
+     * Validate chain rules only (requires parent frame).
+     */
+    validateChain(frame: ParsedFrame, parentFrame?: ParsedFrame): ValidationReport;
+    /**
+     * Map rule IDs to more descriptive error codes.
+     * Uses ruleName directly if it's already in expected format.
+     */
+    private mapRuleIdToErrorCode;
+}
+export declare const validator: FrameValidator;
+//# sourceMappingURL=validator.d.ts.map

package/dist/gatekeeper/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/gatekeeper/validator.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,WAAW,EAEX,gBAAgB,EAEjB,MAAM,mBAAmB,CAAC;AAqjB3B,qBAAa,cAAc;IACzB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,WAAW,EAAE,WAAW,CAAC,EAAE,WAAW,GAAG,gBAAgB;IAwCzE;;OAEG;IACH,kBAAkB,CAAC,KAAK,EAAE,WAAW,GAAG,gBAAgB;IA8BxD;;OAEG;IACH,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,gBAAgB;IA8BtD;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,WAAW,EAAE,WAAW,CAAC,EAAE,WAAW,GAAG,gBAAgB;IA8C9E;;;OAGG;IACH,OAAO,CAAC,oBAAoB;CAgB7B;AAGD,eAAO,MAAM,SAAS,gBAAuB,CAAC"}