promptspeak-mcp-server 0.1.0

package/dist/tools/ps_delegate.js

@@ -0,0 +1,307 @@
+/**
+ * ps_delegate Tool
+ *
+ * Handles delegation from parent agent to child agent.
+ * Enforces inheritance rules, mode strength preservation,
+ * and forbidden constraint propagation.
+ */
+import { DynamicResolver } from '../gatekeeper/resolver.js';
+import { FrameValidator } from '../gatekeeper/validator.js';
+import { driftEngine } from '../drift/index.js'; // Use singleton
+import { recordAudit } from '../operator/index.js';
+const resolver = new DynamicResolver();
+const validator = new FrameValidator();
+// ============================================================================
+// TOOL IMPLEMENTATION
+// ============================================================================
+export function ps_delegate(request) {
+    const delegationId = generateDelegationId();
+    recordAudit('delegation_start', request.parentAgentId, {
+        delegationId,
+        childAgentId: request.childAgentId,
+        parentFrame: request.parentFrame,
+        childFrame: request.childFrame
+    });
+    // Step 1: Parse both frames
+    const parsedParent = resolver.parseFrame(request.parentFrame);
+    const parsedChild = resolver.parseFrame(request.childFrame);
+    if (!parsedParent) {
+        return createFailureResult(delegationId, request, 'Failed to parse parent frame', 'closed');
+    }
+    if (!parsedChild) {
+        return createFailureResult(delegationId, request, 'Failed to parse child frame', 'closed');
+    }
+    // Step 2: Check child agent circuit breaker
+    const childStatus = driftEngine.getAgentStatus(request.childAgentId);
+    if (childStatus?.circuitBreakerState === 'open') {
+        return createFailureResult(delegationId, request, 'Child agent circuit breaker is open - cannot delegate', 'open');
+    }
+    // Step 3: Apply inheritance rules
+    const inheritanceResult = applyInheritance(parsedParent, parsedChild, request.inheritanceMode ?? 'strict', request.customInheritance);
+    // Step 4: Validate the delegation chain
+    const chainValidation = validator.validateChain(inheritanceResult.effectiveChildFrame, parsedParent);
+    // Step 5: Check for forbidden constraint propagation (check ORIGINAL child frame, not effective)
+    // This ensures we catch when child frame doesn't explicitly inherit ⛔ from parent
+    const forbiddenCheck = checkForbiddenPropagation(parsedParent, parsedChild);
+    // Step 6: Determine overall validity
+    const errors = [];
+    const warnings = [];
+    for (const err of (chainValidation.errors ?? [])) {
+        errors.push(`${err.code}: ${err.message}`);
+    }
+    for (const warn of (chainValidation.warnings ?? [])) {
+        warnings.push(`${warn.code}: ${warn.message}`);
+    }
+    if (!forbiddenCheck.valid) {
+        errors.push(forbiddenCheck.message);
+    }
+    const valid = errors.length === 0;
+    // Step 7: Record the delegation if valid
+    if (valid) {
+        recordDelegation(delegationId, request, inheritanceResult);
+    }
+    recordAudit('delegation_complete', request.parentAgentId, {
+        delegationId,
+        success: valid,
+        errors,
+        warnings
+    });
+    // Step 8: Rebuild effective frame string
+    const effectiveFrameString = frameToString(inheritanceResult.effectiveChildFrame);
+    return {
+        success: valid,
+        delegationId,
+        parentAgentId: request.parentAgentId,
+        childAgentId: request.childAgentId,
+        parentFrame: request.parentFrame,
+        childFrame: request.childFrame,
+        effectiveChildFrame: effectiveFrameString,
+        validation: {
+            valid,
+            chainValid: chainValidation.valid,
+            errors,
+            warnings
+        },
+        inheritance: {
+            modeInherited: inheritanceResult.modeInherited,
+            domainInherited: inheritanceResult.domainInherited,
+            constraintsInherited: inheritanceResult.constraintsInherited,
+            strengthPreserved: inheritanceResult.strengthPreserved
+        },
+        childCircuitState: childStatus?.circuitBreakerState ?? 'closed'
+    };
+}
+function applyInheritance(parent, child, mode, custom) {
+    // Deep copy the child frame to avoid mutating the original
+    const effective = {
+        ...child,
+        symbols: [...child.symbols],
+        constraints: [...child.constraints], // Deep copy constraints array
+        modifiers: [...child.modifiers] // Deep copy modifiers array
+    };
+    const result = {
+        effectiveChildFrame: effective,
+        modeInherited: false,
+        domainInherited: false,
+        constraintsInherited: [],
+        strengthPreserved: true
+    };
+    const settings = mode === 'custom' && custom ? custom : {
+        inheritMode: mode === 'strict',
+        inheritDomain: true,
+        inheritConstraints: mode === 'strict',
+        inheritPriority: mode === 'strict'
+    };
+    // Mode inheritance
+    if (settings.inheritMode && parent.mode && !child.mode) {
+        effective.mode = parent.mode;
+        result.modeInherited = true;
+    }
+    // Check mode strength
+    if (parent.mode && child.mode) {
+        const parentStrength = getModeStrength(parent.mode);
+        const childStrength = getModeStrength(child.mode);
+        result.strengthPreserved = childStrength <= parentStrength;
+    }
+    // Domain inheritance
+    if (settings.inheritDomain && parent.domain && !child.domain) {
+        effective.domain = parent.domain;
+        result.domainInherited = true;
+    }
+    // Constraint inheritance
+    if (settings.inheritConstraints) {
+        for (const constraint of parent.constraints) {
+            if (!child.constraints.includes(constraint)) {
+                effective.constraints.push(constraint);
+                result.constraintsInherited.push(constraint);
+            }
+        }
+    }
+    // Always inherit ⛔ (forbidden) constraint
+    if (parent.constraints.includes('⛔') && !effective.constraints.includes('⛔')) {
+        effective.constraints.push('⛔');
+        if (!result.constraintsInherited.includes('⛔')) {
+            result.constraintsInherited.push('⛔');
+        }
+    }
+    // Priority inheritance
+    if (settings.inheritPriority && parent.modifiers.includes('↑') && !child.modifiers.includes('↑')) {
+        effective.modifiers.push('↑');
+    }
+    return result;
+}
+function getModeStrength(mode) {
+    const strengths = {
+        '⊕': 1, // strict - strongest
+        '⊘': 2, // neutral
+        '⊖': 3, // flexible
+        '⊗': 4 // forbidden - weakest (most permissive)
+    };
+    return strengths[mode] ?? 5;
+}
+// ============================================================================
+// FORBIDDEN PROPAGATION CHECK
+// ============================================================================
+function checkForbiddenPropagation(parent, child) {
+    // If parent has ⛔, child must have it
+    if (parent.constraints.includes('⛔') && !child.constraints.includes('⛔')) {
+        return {
+            valid: false,
+            message: 'FORBIDDEN_NOT_INHERITED: Parent has ⛔ constraint which must be inherited'
+        };
+    }
+    // If parent has ⊗ mode (forbidden mode), child must maintain
+    if (parent.mode === '⊗' && child.mode !== '⊗') {
+        return {
+            valid: false,
+            message: 'FORBIDDEN_MODE_NOT_INHERITED: Parent has ⊗ (forbidden) mode which must be inherited'
+        };
+    }
+    return { valid: true, message: '' };
+}
+const delegationRegistry = new Map();
+const agentDelegations = new Map();
+function recordDelegation(id, request, inheritance) {
+    const record = {
+        id,
+        parentAgentId: request.parentAgentId,
+        childAgentId: request.childAgentId,
+        parentFrame: request.parentFrame,
+        childFrame: request.childFrame,
+        effectiveChildFrame: frameToString(inheritance.effectiveChildFrame),
+        timestamp: Date.now(),
+        status: 'active'
+    };
+    delegationRegistry.set(id, record);
+    // Track parent's delegations
+    if (!agentDelegations.has(request.parentAgentId)) {
+        agentDelegations.set(request.parentAgentId, new Set());
+    }
+    agentDelegations.get(request.parentAgentId).add(id);
+}
+export function ps_delegate_revoke(request) {
+    const record = delegationRegistry.get(request.delegationId);
+    if (!record) {
+        return {
+            success: false,
+            delegationId: request.delegationId,
+            message: 'Delegation not found'
+        };
+    }
+    if (record.parentAgentId !== request.parentAgentId) {
+        return {
+            success: false,
+            delegationId: request.delegationId,
+            message: 'Only parent agent can revoke delegation'
+        };
+    }
+    if (record.status !== 'active') {
+        return {
+            success: false,
+            delegationId: request.delegationId,
+            message: `Delegation already ${record.status}`
+        };
+    }
+    record.status = 'revoked';
+    recordAudit('delegation_revoke', request.parentAgentId, {
+        delegationId: request.delegationId,
+        childAgentId: record.childAgentId,
+        reason: request.reason
+    });
+    return {
+        success: true,
+        delegationId: request.delegationId,
+        childAgentId: record.childAgentId,
+        message: 'Delegation revoked successfully'
+    };
+}
+export function ps_delegate_list(request) {
+    const role = request.role ?? 'both';
+    const status = request.status ?? 'active';
+    const asParent = [];
+    const asChild = [];
+    for (const record of delegationRegistry.values()) {
+        if (status !== 'all' && record.status !== status)
+            continue;
+        if ((role === 'parent' || role === 'both') && record.parentAgentId === request.agentId) {
+            asParent.push(record);
+        }
+        if ((role === 'child' || role === 'both') && record.childAgentId === request.agentId) {
+            asChild.push(record);
+        }
+    }
+    return {
+        agentId: request.agentId,
+        asParent,
+        asChild
+    };
+}
+// ============================================================================
+// HELPER FUNCTIONS
+// ============================================================================
+function generateDelegationId() {
+    const timestamp = Date.now().toString(36);
+    const random = Math.random().toString(36).substring(2, 8);
+    return `del_${timestamp}_${random}`;
+}
+function createFailureResult(delegationId, request, error, circuitState) {
+    return {
+        success: false,
+        delegationId,
+        parentAgentId: request.parentAgentId,
+        childAgentId: request.childAgentId,
+        parentFrame: request.parentFrame,
+        childFrame: request.childFrame,
+        effectiveChildFrame: request.childFrame,
+        validation: {
+            valid: false,
+            chainValid: false,
+            errors: [error],
+            warnings: []
+        },
+        inheritance: {
+            modeInherited: false,
+            domainInherited: false,
+            constraintsInherited: [],
+            strengthPreserved: false
+        },
+        childCircuitState: circuitState
+    };
+}
+function frameToString(frame) {
+    const parts = [];
+    if (frame.mode)
+        parts.push(frame.mode);
+    parts.push(...frame.modifiers);
+    if (frame.domain)
+        parts.push(frame.domain);
+    if (frame.source)
+        parts.push(frame.source);
+    parts.push(...frame.constraints);
+    if (frame.action)
+        parts.push(frame.action);
+    if (frame.entity)
+        parts.push(frame.entity);
+    return parts.join('');
+}
+//# sourceMappingURL=ps_delegate.js.map

package/dist/tools/ps_delegate.js.map

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

package/dist/tools/ps_execute.d.ts

@@ -0,0 +1,84 @@
+/**
+ * ps_execute Tool
+ *
+ * Executes an action under a PromptSpeak frame's governance.
+ * The gatekeeper intercepts the action and enforces frame constraints.
+ */
+import type { InterceptorDecision } from '../types/index.js';
+export interface PSExecuteRequest {
+    agentId: string;
+    frame: string;
+    action: {
+        tool: string;
+        arguments: Record<string, unknown>;
+        description?: string;
+    };
+    parentFrame?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface PSExecuteResult {
+    success: boolean;
+    agentId: string;
+    frame: string;
+    action: string;
+    decision: InterceptorDecision;
+    result?: unknown;
+    driftStatus?: {
+        score: number;
+        alert: boolean;
+        circuitState: string;
+    };
+    executionTime: number;
+    auditId: string;
+}
+export declare function ps_execute(request: PSExecuteRequest): Promise<PSExecuteResult>;
+export interface BatchExecuteRequest {
+    agentId: string;
+    frame: string;
+    actions: Array<{
+        tool: string;
+        arguments: Record<string, unknown>;
+        description?: string;
+    }>;
+    parentFrame?: string;
+    stopOnFirstFailure?: boolean;
+    parallel?: boolean;
+}
+export interface BatchExecuteResult {
+    agentId: string;
+    frame: string;
+    allSucceeded: boolean;
+    results: PSExecuteResult[];
+    summary: {
+        total: number;
+        succeeded: number;
+        failed: number;
+        blocked: number;
+    };
+    totalExecutionTime: number;
+}
+export declare function ps_execute_batch(request: BatchExecuteRequest): Promise<BatchExecuteResult>;
+export interface DryRunRequest {
+    agentId: string;
+    frame: string;
+    action: {
+        tool: string;
+        arguments: Record<string, unknown>;
+    };
+    parentFrame?: string;
+}
+export interface DryRunResult {
+    wouldSucceed: boolean;
+    decision: InterceptorDecision;
+    validationReport: {
+        valid: boolean;
+        errorCount: number;
+        warningCount: number;
+    };
+    coverageAnalysis: {
+        confidence: number;
+        uncoveredAspects: string[];
+    };
+}
+export declare function ps_execute_dry_run(request: DryRunRequest): DryRunResult;
+//# sourceMappingURL=ps_execute.d.ts.map

package/dist/tools/ps_execute.d.ts.map

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

package/dist/tools/ps_execute.js

@@ -0,0 +1,211 @@
+/**
+ * ps_execute Tool
+ *
+ * Executes an action under a PromptSpeak frame's governance.
+ * The gatekeeper intercepts the action and enforces frame constraints.
+ */
+import { Gatekeeper } from '../gatekeeper/index.js';
+import { driftEngine } from '../drift/index.js'; // Use singleton
+import { recordAudit } from '../operator/index.js';
+const gatekeeper = new Gatekeeper();
+// ============================================================================
+// TOOL IMPLEMENTATION
+// ============================================================================
+export async function ps_execute(request) {
+    const startTime = Date.now();
+    const auditId = generateAuditId();
+    // Normalize action input - allow string or object format
+    const normalizedAction = typeof request.action === 'string'
+        ? { tool: request.action, arguments: {} }
+        : request.action;
+    const actionTool = normalizedAction.tool;
+    // Record audit entry
+    recordAudit('execute_start', request.agentId, {
+        auditId,
+        frame: request.frame,
+        tool: actionTool
+    });
+    try {
+        // Step 1: Check circuit breaker state (FIRST - before any other processing)
+        const agentStatus = driftEngine.getAgentStatus(request.agentId);
+        if (agentStatus && agentStatus.circuitBreakerState === 'open') {
+            recordAudit('execute_blocked', request.agentId, {
+                auditId,
+                reason: 'circuit_breaker_open'
+            });
+            return {
+                success: false,
+                agentId: request.agentId,
+                frame: request.frame,
+                action: actionTool,
+                decision: {
+                    allowed: false,
+                    frame: request.frame,
+                    proposedAction: actionTool,
+                    action: 'block',
+                    reason: 'Circuit breaker is open - agent has been halted',
+                    coverageConfidence: 1.0,
+                    confidence: 1.0,
+                    timestamp: Date.now(),
+                    auditId,
+                },
+                driftStatus: {
+                    score: agentStatus.driftScore,
+                    alert: true,
+                    circuitState: 'open'
+                },
+                executionTime: Date.now() - startTime,
+                auditId
+            };
+        }
+        // Step 2: Build execute request for gatekeeper
+        const executeRequest = {
+            frame: request.frame,
+            tool: actionTool,
+            action: actionTool, // Alias for backward compatibility
+            arguments: normalizedAction.arguments,
+            agentId: request.agentId,
+        };
+        // Step 3: Execute through gatekeeper
+        const executeResult = await gatekeeper.execute(executeRequest);
+        // Step 4: Record drift metrics
+        const driftAlert = driftEngine.recordOperation(request.agentId, request.frame, actionTool, executeResult.success);
+        // Step 5: Get updated drift status
+        const updatedStatus = driftEngine.getAgentStatus(request.agentId);
+        // Step 6: Record completion audit
+        recordAudit('execute_complete', request.agentId, {
+            auditId,
+            success: executeResult.success,
+            decision: executeResult.decision?.action ?? executeResult.interceptorDecision?.action,
+            driftScore: updatedStatus?.driftScore
+        });
+        return {
+            success: executeResult.success,
+            agentId: request.agentId,
+            frame: request.frame,
+            action: actionTool,
+            decision: executeResult.decision ?? executeResult.interceptorDecision,
+            result: executeResult.result,
+            driftStatus: updatedStatus ? {
+                score: updatedStatus.driftScore,
+                alert: driftAlert !== null,
+                circuitState: updatedStatus.circuitBreakerState
+            } : undefined,
+            executionTime: Date.now() - startTime,
+            auditId
+        };
+    }
+    catch (error) {
+        recordAudit('execute_error', request.agentId, {
+            auditId,
+            error: String(error)
+        });
+        // Record failure for drift tracking
+        driftEngine.recordOperation(request.agentId, request.frame, actionTool, false);
+        return {
+            success: false,
+            agentId: request.agentId,
+            frame: request.frame,
+            action: actionTool,
+            decision: {
+                allowed: false,
+                frame: request.frame,
+                proposedAction: actionTool,
+                action: 'block',
+                reason: `Execution error: ${error}`,
+                coverageConfidence: 1.0,
+                confidence: 1.0,
+                timestamp: Date.now(),
+                auditId,
+            },
+            executionTime: Date.now() - startTime,
+            auditId
+        };
+    }
+}
+export async function ps_execute_batch(request) {
+    const startTime = Date.now();
+    const results = [];
+    let blocked = 0;
+    let failed = 0;
+    let succeeded = 0;
+    if (request.parallel) {
+        // Execute all actions in parallel
+        const promises = request.actions.map(action => ps_execute({
+            agentId: request.agentId,
+            frame: request.frame,
+            action,
+            parentFrame: request.parentFrame
+        }));
+        const allResults = await Promise.all(promises);
+        results.push(...allResults);
+        for (const r of allResults) {
+            if (r.success)
+                succeeded++;
+            else if (r.decision.action === 'block')
+                blocked++;
+            else
+                failed++;
+        }
+    }
+    else {
+        // Execute sequentially
+        for (const action of request.actions) {
+            const result = await ps_execute({
+                agentId: request.agentId,
+                frame: request.frame,
+                action,
+                parentFrame: request.parentFrame
+            });
+            results.push(result);
+            if (result.success)
+                succeeded++;
+            else if (result.decision.action === 'block')
+                blocked++;
+            else
+                failed++;
+            if (request.stopOnFirstFailure && !result.success) {
+                break;
+            }
+        }
+    }
+    return {
+        agentId: request.agentId,
+        frame: request.frame,
+        allSucceeded: succeeded === request.actions.length,
+        results,
+        summary: {
+            total: results.length,
+            succeeded,
+            failed,
+            blocked
+        },
+        totalExecutionTime: Date.now() - startTime
+    };
+}
+export function ps_execute_dry_run(request) {
+    // Get interceptor decision without executing
+    const decision = gatekeeper.precheck(request.frame, request.action.tool, request.action.arguments, request.parentFrame);
+    return {
+        wouldSucceed: decision.action === 'allow',
+        decision,
+        validationReport: {
+            valid: decision.validationReport?.valid ?? false,
+            errorCount: (decision.validationReport?.errors ?? []).length,
+            warningCount: (decision.validationReport?.warnings ?? []).length
+        },
+        coverageAnalysis: {
+            confidence: decision.coverageConfidence ?? 0,
+            uncoveredAspects: decision.uncoveredAspects ?? []
+        }
+    };
+}
+// ============================================================================
+// HELPER FUNCTIONS
+// ============================================================================
+function generateAuditId() {
+    const timestamp = Date.now().toString(36);
+    const random = Math.random().toString(36).substring(2, 8);
+    return `audit_${timestamp}_${random}`;
+}
+//# sourceMappingURL=ps_execute.js.map

package/dist/tools/ps_execute.js.map

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