promptspeak-mcp-server 0.1.0

package/dist/recon/agent/runtime.d.ts

@@ -0,0 +1,184 @@
+/**
+ * ═══════════════════════════════════════════════════════════════════════════════
+ * RECON AGENT RUNTIME
+ * ═══════════════════════════════════════════════════════════════════════════════
+ *
+ * The Runtime is the coordinator that orchestrates the dual-track agent.
+ * It manages the flow between Performer, Analyst, and Veto Gate, handles
+ * state synchronization with the symbol, and interfaces with external systems.
+ *
+ * Key Responsibilities:
+ * - Coordinate message processing flow
+ * - Manage dual-track synchronization
+ * - Handle symbol state updates
+ * - Interface with ralph-loop
+ * - Manage mission lifecycle
+ *
+ * Message Flow:
+ * 1. Incoming message received
+ * 2. Analyst analyzes message (parallel)
+ * 3. Performer generates response using analyst guidance
+ * 4. Analyst assesses proposed response
+ * 5. Veto Gate makes final decision
+ * 6. Stealth layer applies human-like timing
+ * 7. Message sent
+ * 8. State updated in symbol
+ *
+ * ═══════════════════════════════════════════════════════════════════════════════
+ */
+import { MarineReconSymbol, ReconMissionStatus, AlertLevel } from '../types';
+import { ValidationReport } from '../symbol/validator';
+import { MessageAnalysis } from './analyst';
+import { VetoGateOutput } from './veto-gate';
+/**
+ * Configuration for the runtime.
+ */
+export interface RuntimeConfig {
+    /** Enable verbose logging */
+    verbose: boolean;
+    /** Max conversation history to keep */
+    max_history: number;
+    /** Auto-validate on each message */
+    auto_validate: boolean;
+}
+/**
+ * Result of processing an incoming message.
+ */
+export interface ProcessMessageResult {
+    /** Whether processing succeeded */
+    success: boolean;
+    /** Our response (if approved) */
+    response?: string;
+    /** Veto gate decision */
+    veto_decision: string;
+    /** Was response modified? */
+    was_modified: boolean;
+    /** Analysis summary */
+    analysis_summary: string;
+    /** Updated symbol */
+    updated_symbol: MarineReconSymbol;
+    /** Any errors */
+    error?: string;
+}
+/**
+ * Events emitted by the runtime.
+ */
+export type RuntimeEvent = {
+    type: 'message_received';
+    message: string;
+} | {
+    type: 'analysis_complete';
+    analysis: MessageAnalysis;
+} | {
+    type: 'response_generated';
+    response: string;
+} | {
+    type: 'veto_decision';
+    decision: VetoGateOutput;
+} | {
+    type: 'response_sent';
+    response: string;
+} | {
+    type: 'status_change';
+    old: ReconMissionStatus;
+    new: ReconMissionStatus;
+} | {
+    type: 'alert_level_change';
+    old: AlertLevel;
+    new: AlertLevel;
+} | {
+    type: 'validation_complete';
+    report: ValidationReport;
+} | {
+    type: 'error';
+    error: Error;
+};
+/**
+ * Event listener type.
+ */
+export type RuntimeEventListener = (event: RuntimeEvent) => void;
+/**
+ * The Recon Agent Runtime - coordinates the dual-track agent.
+ */
+export declare class ReconAgentRuntime {
+    private symbol;
+    private config;
+    private performer;
+    private analyst;
+    private vetoGate;
+    private validator;
+    private state;
+    private listeners;
+    constructor(symbol: MarineReconSymbol, config?: Partial<RuntimeConfig>);
+    /**
+     * Start the runtime.
+     */
+    start(): void;
+    /**
+     * Pause the runtime.
+     */
+    pause(): void;
+    /**
+     * Resume the runtime.
+     */
+    resume(): void;
+    /**
+     * Stop the runtime and complete the mission.
+     */
+    complete(status?: 'completed' | 'aborted' | 'compromised'): void;
+    /**
+     * Process an incoming message from the opposing agent.
+     */
+    processIncomingMessage(message: string): Promise<ProcessMessageResult>;
+    /**
+     * Get the pending response to send.
+     * Call this after processIncomingMessage to get the response to send.
+     * The Stealth layer should be applied to this before actual sending.
+     */
+    getPendingResponse(): string | undefined;
+    /**
+     * Confirm that a response was sent.
+     * Call this after the Stealth layer has sent the message.
+     */
+    confirmResponseSent(response: string): void;
+    /**
+     * Get the current symbol.
+     */
+    getSymbol(): MarineReconSymbol;
+    /**
+     * Get symbol summary for logging/display.
+     */
+    getSymbolSummary(): object;
+    /**
+     * Update the symbol from an external source (e.g., ralph-loop refresh).
+     */
+    refreshSymbol(newSymbol: MarineReconSymbol): void;
+    /**
+     * Run manual validation.
+     */
+    validate(): ValidationReport;
+    /**
+     * Add an event listener.
+     */
+    addEventListener(listener: RuntimeEventListener): void;
+    /**
+     * Remove an event listener.
+     */
+    removeEventListener(listener: RuntimeEventListener): void;
+    /**
+     * Emit an event to all listeners.
+     */
+    private emit;
+    private addToConversation;
+    private updateStatus;
+    private updateAlertLevel;
+    private updateSymbolFromState;
+    private queueCommanderMessage;
+    private getNestedValue;
+    private log;
+}
+/**
+ * Create a runtime from a symbol.
+ */
+export declare function createRuntime(symbol: MarineReconSymbol, config?: Partial<RuntimeConfig>): ReconAgentRuntime;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/recon/agent/runtime.d.ts.map

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

package/dist/recon/agent/runtime.js

@@ -0,0 +1,474 @@
+/**
+ * ═══════════════════════════════════════════════════════════════════════════════
+ * RECON AGENT RUNTIME
+ * ═══════════════════════════════════════════════════════════════════════════════
+ *
+ * The Runtime is the coordinator that orchestrates the dual-track agent.
+ * It manages the flow between Performer, Analyst, and Veto Gate, handles
+ * state synchronization with the symbol, and interfaces with external systems.
+ *
+ * Key Responsibilities:
+ * - Coordinate message processing flow
+ * - Manage dual-track synchronization
+ * - Handle symbol state updates
+ * - Interface with ralph-loop
+ * - Manage mission lifecycle
+ *
+ * Message Flow:
+ * 1. Incoming message received
+ * 2. Analyst analyzes message (parallel)
+ * 3. Performer generates response using analyst guidance
+ * 4. Analyst assesses proposed response
+ * 5. Veto Gate makes final decision
+ * 6. Stealth layer applies human-like timing
+ * 7. Message sent
+ * 8. State updated in symbol
+ *
+ * ═══════════════════════════════════════════════════════════════════════════════
+ */
+import { updateSymbolState, createSymbolSummary } from '../symbol/schema';
+import { ReconSymbolValidator } from '../symbol/validator';
+import { createPerformerFromSymbol } from './performer';
+import { createAnalystFromSymbol } from './analyst';
+import { createVetoGateFromSymbol } from './veto-gate';
+// ═══════════════════════════════════════════════════════════════════════════════
+// RECON AGENT RUNTIME
+// ═══════════════════════════════════════════════════════════════════════════════
+/**
+ * The Recon Agent Runtime - coordinates the dual-track agent.
+ */
+export class ReconAgentRuntime {
+    symbol;
+    config;
+    performer;
+    analyst;
+    vetoGate;
+    validator;
+    state;
+    listeners = [];
+    constructor(symbol, config) {
+        this.symbol = symbol;
+        this.config = {
+            verbose: config?.verbose ?? false,
+            max_history: config?.max_history ?? 50,
+            auto_validate: config?.auto_validate ?? true,
+        };
+        // Initialize tracks
+        this.performer = createPerformerFromSymbol(symbol);
+        this.analyst = createAnalystFromSymbol(symbol);
+        this.vetoGate = createVetoGateFromSymbol(symbol);
+        this.validator = new ReconSymbolValidator();
+        // Initialize state
+        this.state = {
+            running: false,
+            conversation: [],
+            current_objective: symbol.mission.objective.primary_goal,
+        };
+    }
+    // ─────────────────────────────────────────────────────────────────────────────
+    // LIFECYCLE
+    // ─────────────────────────────────────────────────────────────────────────────
+    /**
+     * Start the runtime.
+     */
+    start() {
+        if (this.state.running) {
+            throw new Error('Runtime is already running');
+        }
+        this.state.running = true;
+        this.updateStatus('active');
+        this.log('Runtime started');
+    }
+    /**
+     * Pause the runtime.
+     */
+    pause() {
+        if (!this.state.running)
+            return;
+        this.state.running = false;
+        this.updateStatus('paused');
+        this.log('Runtime paused');
+    }
+    /**
+     * Resume the runtime.
+     */
+    resume() {
+        if (this.state.running)
+            return;
+        this.state.running = true;
+        this.updateStatus('active');
+        this.log('Runtime resumed');
+    }
+    /**
+     * Stop the runtime and complete the mission.
+     */
+    complete(status = 'completed') {
+        this.state.running = false;
+        this.updateStatus(status);
+        // Update timestamps
+        this.symbol = updateSymbolState(this.symbol, {
+            engagement: {
+                timestamps: {
+                    ...this.symbol.state.engagement.timestamps,
+                    mission_end: new Date().toISOString(),
+                },
+            },
+        });
+        this.log(`Mission ${status}`);
+    }
+    // ─────────────────────────────────────────────────────────────────────────────
+    // MESSAGE PROCESSING
+    // ─────────────────────────────────────────────────────────────────────────────
+    /**
+     * Process an incoming message from the opposing agent.
+     */
+    async processIncomingMessage(message) {
+        if (!this.state.running) {
+            return {
+                success: false,
+                veto_decision: 'block',
+                was_modified: false,
+                analysis_summary: 'Runtime not running',
+                updated_symbol: this.symbol,
+                error: 'Runtime is not running',
+            };
+        }
+        try {
+            // Emit event
+            this.emit({ type: 'message_received', message });
+            // Add to conversation history
+            this.addToConversation('them', message);
+            // Step 1: Analyst analyzes the message
+            const analysis = this.analyst.analyzeIncomingMessage(message, this.state.conversation);
+            this.emit({ type: 'analysis_complete', analysis });
+            this.log(`Analysis: ${analysis.summary}`);
+            // Check for alert level changes
+            this.updateAlertLevel(analysis);
+            // Step 2: Build response context
+            const context = {
+                incoming_message: message,
+                conversation_history: this.state.conversation,
+                current_topic: this.symbol.state.engagement.conversation.current_topic || 'general',
+                response_objective: this.state.current_objective,
+                analyst_guidance: analysis.guidance,
+            };
+            // Step 3: Performer generates response
+            const performerResponse = this.performer.generateResponse(context);
+            this.emit({ type: 'response_generated', response: performerResponse.message });
+            this.log(`Performer: "${performerResponse.message.substring(0, 50)}..."`);
+            // Step 4: Analyst assesses proposed response
+            const assessment = this.analyst.assessProposedResponse(performerResponse.message);
+            this.log(`Assessment: ${assessment.recommendation} (risk: ${(assessment.risk_level * 100).toFixed(0)}%)`);
+            // Step 5: Veto gate makes decision
+            const vetoInput = {
+                performer_response: performerResponse,
+                analyst_assessment: assessment,
+                context: {
+                    incoming_message: message,
+                    topic: context.current_topic,
+                    urgency: 'medium', // Could be enhanced to detect urgency
+                },
+            };
+            const vetoOutput = this.vetoGate.process(vetoInput);
+            this.emit({ type: 'veto_decision', decision: vetoOutput });
+            this.log(`Veto: ${vetoOutput.decision} - ${vetoOutput.reason}`);
+            // Step 6: Handle the decision
+            let response;
+            if (vetoOutput.decision === 'approve' || vetoOutput.decision === 'modify') {
+                response = vetoOutput.final_message;
+                this.state.pending_response = response;
+                // Add our response to conversation
+                if (response) {
+                    this.addToConversation('us', response);
+                    // Update drift assessment
+                    this.analyst.updateDriftAssessment(response, message);
+                }
+            }
+            else if (vetoOutput.decision === 'escalate') {
+                this.queueCommanderMessage({
+                    id: `CMD_${Date.now()}`,
+                    priority: 'high',
+                    type: 'request',
+                    content: vetoOutput.escalation_message || 'Escalation required',
+                    queued_at: new Date().toISOString(),
+                    delivery_attempts: 0,
+                });
+            }
+            // Step 7: Update symbol state
+            this.updateSymbolFromState(performerResponse, analysis, vetoOutput);
+            // Step 8: Auto-validate if enabled
+            if (this.config.auto_validate) {
+                const report = this.validator.validate(this.symbol);
+                this.emit({ type: 'validation_complete', report });
+                if (!report.passed) {
+                    this.log(`Validation issues: ${report.issues.length}`);
+                }
+            }
+            return {
+                success: true,
+                response,
+                veto_decision: vetoOutput.decision,
+                was_modified: vetoOutput.was_modified,
+                analysis_summary: analysis.summary,
+                updated_symbol: this.symbol,
+            };
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            this.emit({ type: 'error', error: err });
+            this.log(`Error: ${err.message}`);
+            return {
+                success: false,
+                veto_decision: 'block',
+                was_modified: false,
+                analysis_summary: `Error: ${err.message}`,
+                updated_symbol: this.symbol,
+                error: err.message,
+            };
+        }
+    }
+    /**
+     * Get the pending response to send.
+     * Call this after processIncomingMessage to get the response to send.
+     * The Stealth layer should be applied to this before actual sending.
+     */
+    getPendingResponse() {
+        const response = this.state.pending_response;
+        this.state.pending_response = undefined;
+        return response;
+    }
+    /**
+     * Confirm that a response was sent.
+     * Call this after the Stealth layer has sent the message.
+     */
+    confirmResponseSent(response) {
+        this.emit({ type: 'response_sent', response });
+        this.log(`Sent: "${response.substring(0, 50)}..."`);
+        // Update conversation state
+        const newConversationState = {
+            message_count: this.state.conversation.length,
+            our_message_count: this.state.conversation.filter(m => m.speaker === 'us').length,
+            their_message_count: this.state.conversation.filter(m => m.speaker === 'them').length,
+            last_speaker: 'us',
+        };
+        this.symbol = updateSymbolState(this.symbol, {
+            engagement: {
+                conversation: {
+                    ...this.symbol.state.engagement.conversation,
+                    ...newConversationState,
+                },
+            },
+        });
+    }
+    // ─────────────────────────────────────────────────────────────────────────────
+    // STATE MANAGEMENT
+    // ─────────────────────────────────────────────────────────────────────────────
+    /**
+     * Get the current symbol.
+     */
+    getSymbol() {
+        return this.symbol;
+    }
+    /**
+     * Get symbol summary for logging/display.
+     */
+    getSymbolSummary() {
+        return createSymbolSummary(this.symbol);
+    }
+    /**
+     * Update the symbol from an external source (e.g., ralph-loop refresh).
+     */
+    refreshSymbol(newSymbol) {
+        // Verify this is the same symbol
+        if (newSymbol.symbol_id !== this.symbol.symbol_id) {
+            throw new Error('Symbol ID mismatch');
+        }
+        // Check for immutable field changes
+        const immutableFields = this.symbol.config.ralph_loop.symbol_refresh.immutable_fields;
+        for (const field of immutableFields) {
+            const oldValue = this.getNestedValue(this.symbol, field);
+            const newValue = this.getNestedValue(newSymbol, field);
+            if (JSON.stringify(oldValue) !== JSON.stringify(newValue)) {
+                this.log(`Warning: Immutable field ${field} was changed in refresh`);
+                // Depending on config, could reject or accept
+            }
+        }
+        // Merge or replace based on config
+        const onChangePolicy = this.symbol.config.ralph_loop.symbol_refresh.on_change;
+        if (onChangePolicy === 'accept') {
+            this.symbol = newSymbol;
+        }
+        else if (onChangePolicy === 'merge') {
+            // Keep local state, accept config changes
+            this.symbol = {
+                ...newSymbol,
+                state: this.symbol.state, // Keep local state
+                version: Math.max(this.symbol.version, newSymbol.version),
+            };
+        }
+        else if (onChangePolicy === 'alert') {
+            // Queue alert but don't change
+            this.queueCommanderMessage({
+                id: `ALERT_${Date.now()}`,
+                priority: 'medium',
+                type: 'alert',
+                content: 'Symbol refresh available but not applied (policy: alert)',
+                queued_at: new Date().toISOString(),
+                delivery_attempts: 0,
+            });
+        }
+        // 'reject' does nothing
+        // Re-initialize tracks with updated config
+        this.performer = createPerformerFromSymbol(this.symbol);
+        this.analyst = createAnalystFromSymbol(this.symbol);
+        this.vetoGate = createVetoGateFromSymbol(this.symbol);
+        this.log('Symbol refreshed');
+    }
+    /**
+     * Run manual validation.
+     */
+    validate() {
+        const report = this.validator.validate(this.symbol);
+        this.emit({ type: 'validation_complete', report });
+        return report;
+    }
+    // ─────────────────────────────────────────────────────────────────────────────
+    // EVENT HANDLING
+    // ─────────────────────────────────────────────────────────────────────────────
+    /**
+     * Add an event listener.
+     */
+    addEventListener(listener) {
+        this.listeners.push(listener);
+    }
+    /**
+     * Remove an event listener.
+     */
+    removeEventListener(listener) {
+        const index = this.listeners.indexOf(listener);
+        if (index >= 0) {
+            this.listeners.splice(index, 1);
+        }
+    }
+    /**
+     * Emit an event to all listeners.
+     */
+    emit(event) {
+        for (const listener of this.listeners) {
+            try {
+                listener(event);
+            }
+            catch (e) {
+                console.error('Event listener error:', e);
+            }
+        }
+    }
+    // ─────────────────────────────────────────────────────────────────────────────
+    // PRIVATE HELPERS
+    // ─────────────────────────────────────────────────────────────────────────────
+    addToConversation(speaker, content) {
+        const message = {
+            speaker,
+            content,
+            timestamp: new Date().toISOString(),
+        };
+        this.state.conversation.push(message);
+        // Trim history if needed
+        if (this.state.conversation.length > this.config.max_history) {
+            this.state.conversation = this.state.conversation.slice(-this.config.max_history);
+        }
+    }
+    updateStatus(newStatus) {
+        const oldStatus = this.symbol.state.engagement.status;
+        if (oldStatus !== newStatus) {
+            this.emit({ type: 'status_change', old: oldStatus, new: newStatus });
+            this.symbol = updateSymbolState(this.symbol, {
+                engagement: { status: newStatus },
+            });
+        }
+    }
+    updateAlertLevel(analysis) {
+        // Determine appropriate alert level based on analysis
+        let newLevel = 'green';
+        if (analysis.risk_score > 0.7) {
+            newLevel = 'red';
+        }
+        else if (analysis.risk_score > 0.5 || analysis.tactics_detected.length >= 3) {
+            newLevel = 'orange';
+        }
+        else if (analysis.risk_score > 0.3 || analysis.tactics_detected.length >= 1) {
+            newLevel = 'yellow';
+        }
+        const oldLevel = this.symbol.state.engagement.alert_level;
+        if (oldLevel !== newLevel) {
+            this.emit({ type: 'alert_level_change', old: oldLevel, new: newLevel });
+            this.symbol = updateSymbolState(this.symbol, {
+                engagement: { alert_level: newLevel },
+            });
+        }
+    }
+    updateSymbolFromState(performerResponse, analysis, vetoOutput) {
+        // Compute conversation counts from internal state
+        const conversationUpdate = {
+            ...this.symbol.state.engagement.conversation,
+            message_count: this.state.conversation.length,
+            our_message_count: this.state.conversation.filter(m => m.speaker === 'us').length,
+            their_message_count: this.state.conversation.filter(m => m.speaker === 'them').length,
+            last_speaker: (this.state.conversation.length > 0
+                ? this.state.conversation[this.state.conversation.length - 1].speaker === 'us' ? 'us' : 'them'
+                : 'us'),
+        };
+        this.symbol = updateSymbolState(this.symbol, {
+            engagement: {
+                conversation: conversationUpdate,
+                performer_state: this.performer.getState(),
+                analyst_state: this.analyst.getState(),
+                intelligence: {
+                    ...this.symbol.state.engagement.intelligence,
+                    observations: [
+                        ...this.symbol.state.engagement.intelligence.observations,
+                        ...analysis.extracted_info.map(info => ({
+                            timestamp: new Date().toISOString(),
+                            content: `[${info.type}] ${info.content}`,
+                            category: 'behavior',
+                            significance: info.confidence,
+                        })),
+                    ],
+                },
+            },
+        });
+    }
+    queueCommanderMessage(message) {
+        this.symbol = updateSymbolState(this.symbol, {
+            validation: {
+                commander_queue: [
+                    ...this.symbol.state.validation.commander_queue,
+                    message,
+                ],
+            },
+        });
+    }
+    getNestedValue(obj, path) {
+        return path.split('.').reduce((current, key) => {
+            if (current && typeof current === 'object' && key in current) {
+                return current[key];
+            }
+            return undefined;
+        }, obj);
+    }
+    log(message) {
+        if (this.config.verbose) {
+            console.log(`[ReconRuntime] ${message}`);
+        }
+    }
+}
+// ═══════════════════════════════════════════════════════════════════════════════
+// FACTORY
+// ═══════════════════════════════════════════════════════════════════════════════
+/**
+ * Create a runtime from a symbol.
+ */
+export function createRuntime(symbol, config) {
+    return new ReconAgentRuntime(symbol, config);
+}
+//# sourceMappingURL=runtime.js.map