promptspeak-mcp-server 0.1.0

package/dist/recon/delivery/base-channel.d.ts

@@ -0,0 +1,130 @@
+/**
+ * ═══════════════════════════════════════════════════════════════════════════════
+ * BASE DELIVERY CHANNEL
+ * ═══════════════════════════════════════════════════════════════════════════════
+ *
+ * Abstract base class for delivery channels that integrates with the stealth layer.
+ * Provides common functionality for:
+ * - Applying typing simulation
+ * - Calculating human-like delays
+ * - Generating and handling typos
+ *
+ * Subclasses only need to implement the actual send mechanism.
+ *
+ * ═══════════════════════════════════════════════════════════════════════════════
+ */
+import { DeliveryChannel, DeliveryResult, DeliveryOptions, KeystrokeEvent, DeliveryProgress } from './types';
+import { TypingSimulator, TypingSimulation } from '../stealth/typing-simulator';
+import { TimingCalculator, ResponseTiming } from '../stealth/timing-calculator';
+import { TypoGenerator, TypoResult } from '../stealth/typo-generator';
+import { StealthConfig, TypingConfig, TimingConfig, ErrorConfig, BehavioralConfig } from '../types';
+/**
+ * Abstract base class for delivery channels with stealth integration.
+ */
+export declare abstract class BaseDeliveryChannel implements DeliveryChannel {
+    abstract readonly name: string;
+    abstract readonly description: string;
+    protected typingSimulator: TypingSimulator;
+    protected timingCalculator: TimingCalculator;
+    protected typoGenerator: TypoGenerator;
+    protected stealthConfig: StealthConfig;
+    constructor(stealthConfig?: StealthConfig);
+    /**
+     * Check if the channel is available.
+     * Override in subclasses that need availability checks.
+     */
+    isAvailable(): Promise<boolean>;
+    /**
+     * Send a message. Must be implemented by subclasses.
+     */
+    abstract send(message: string): Promise<DeliveryResult>;
+    /**
+     * Send a single keystroke. Must be implemented by subclasses.
+     */
+    abstract sendKeystroke(keystroke: KeystrokeEvent): Promise<boolean>;
+    /**
+     * Apply the stealth layer to generate keystroke events for a message.
+     *
+     * @param message The message to process
+     * @param options Delivery options
+     * @returns Async generator yielding keystroke events
+     */
+    applyStealthLayer(message: string, options?: DeliveryOptions): AsyncGenerator<KeystrokeEvent>;
+    /**
+     * Calculate the pre-typing delay for responding to a message.
+     *
+     * @param theirMessage The message we're responding to
+     * @param options Delivery options
+     * @returns Response timing information
+     */
+    calculateDelay(theirMessage: string, options?: DeliveryOptions): ResponseTiming;
+    /**
+     * Generate typos for a message.
+     *
+     * @param message The message to add typos to
+     * @returns Typo result with original, typo version, and corrections
+     */
+    generateTypos(message: string): TypoResult;
+    /**
+     * Create a delivery result.
+     */
+    protected createResult(success: boolean, options?: {
+        error?: string;
+        metadata?: Record<string, unknown>;
+        duration_ms?: number;
+        keystroke_count?: number;
+        correction_count?: number;
+    }): DeliveryResult;
+    /**
+     * Create an instant (no delay) typing simulation.
+     */
+    protected createInstantSimulation(message: string): TypingSimulation;
+    /**
+     * Sleep for specified duration.
+     */
+    protected sleep(ms: number): Promise<void>;
+    /**
+     * Create a progress update.
+     */
+    protected createProgress(delivered: number, total: number, currentKeystroke?: KeystrokeEvent, estimatedRemaining?: number): DeliveryProgress;
+    /**
+     * Get the current stealth configuration.
+     */
+    getStealthConfig(): StealthConfig;
+    /**
+     * Update the stealth configuration.
+     */
+    updateStealthConfig(config: Partial<StealthConfig>): void;
+    /**
+     * Get typing simulator state.
+     */
+    getTypingState(): import("..").TypingState;
+    /**
+     * Get timing calculator state.
+     */
+    getTimingState(): import("..").TimingState;
+    /**
+     * Reset all internal state.
+     */
+    resetState(): void;
+}
+/**
+ * Configuration for creating a base channel.
+ */
+export interface BaseChannelConfig {
+    /** Stealth configuration */
+    stealthConfig?: StealthConfig;
+    /** Typing configuration (overrides stealthConfig.typing) */
+    typingConfig?: TypingConfig;
+    /** Timing configuration (overrides stealthConfig.timing) */
+    timingConfig?: TimingConfig;
+    /** Error configuration (overrides stealthConfig.errors) */
+    errorConfig?: ErrorConfig;
+    /** Behavioral configuration (overrides stealthConfig.behavioral) */
+    behavioralConfig?: BehavioralConfig;
+}
+/**
+ * Build a stealth config from individual configs.
+ */
+export declare function buildStealthConfig(config: BaseChannelConfig): StealthConfig;
+//# sourceMappingURL=base-channel.d.ts.map

package/dist/recon/delivery/base-channel.d.ts.map

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

package/dist/recon/delivery/base-channel.js

@@ -0,0 +1,260 @@
+/**
+ * ═══════════════════════════════════════════════════════════════════════════════
+ * BASE DELIVERY CHANNEL
+ * ═══════════════════════════════════════════════════════════════════════════════
+ *
+ * Abstract base class for delivery channels that integrates with the stealth layer.
+ * Provides common functionality for:
+ * - Applying typing simulation
+ * - Calculating human-like delays
+ * - Generating and handling typos
+ *
+ * Subclasses only need to implement the actual send mechanism.
+ *
+ * ═══════════════════════════════════════════════════════════════════════════════
+ */
+import { DEFAULT_DELIVERY_OPTIONS, } from './types';
+import { createTypingSimulator, } from '../stealth/typing-simulator';
+import { createTimingCalculator, } from '../stealth/timing-calculator';
+import { createTypoGenerator, } from '../stealth/typo-generator';
+import { createDefaultStealthConfig, } from '../types';
+// ═══════════════════════════════════════════════════════════════════════════════
+// BASE CHANNEL
+// ═══════════════════════════════════════════════════════════════════════════════
+/**
+ * Abstract base class for delivery channels with stealth integration.
+ */
+export class BaseDeliveryChannel {
+    typingSimulator;
+    timingCalculator;
+    typoGenerator;
+    stealthConfig;
+    constructor(stealthConfig) {
+        this.stealthConfig = stealthConfig ?? createDefaultStealthConfig();
+        this.typingSimulator = createTypingSimulator(this.stealthConfig.typing, this.stealthConfig.behavioral);
+        this.timingCalculator = createTimingCalculator(this.stealthConfig.timing, this.stealthConfig.behavioral);
+        this.typoGenerator = createTypoGenerator(this.stealthConfig.errors);
+    }
+    /**
+     * Check if the channel is available.
+     * Override in subclasses that need availability checks.
+     */
+    async isAvailable() {
+        return true;
+    }
+    // ─────────────────────────────────────────────────────────────────────────────
+    // STEALTH LAYER INTEGRATION
+    // ─────────────────────────────────────────────────────────────────────────────
+    /**
+     * Apply the stealth layer to generate keystroke events for a message.
+     *
+     * @param message The message to process
+     * @param options Delivery options
+     * @returns Async generator yielding keystroke events
+     */
+    async *applyStealthLayer(message, options = DEFAULT_DELIVERY_OPTIONS) {
+        const startTime = Date.now();
+        let cumulativeTime = 0;
+        let sequence = 0;
+        let messagePosition = 0;
+        // Apply typos if enabled
+        let messageToType = message;
+        let typoResult = null;
+        const correctionPositions = [];
+        if (options.useTypos && this.stealthConfig.errors.typo_probability > 0) {
+            typoResult = this.typoGenerator.generateTypos(message);
+            correctionPositions.push(...typoResult.correction_positions);
+        }
+        // Generate typing simulation
+        let simulation;
+        if (options.useTypingSimulation) {
+            if (typoResult && correctionPositions.length > 0) {
+                simulation = this.typingSimulator.simulateTypingWithCorrections(message, correctionPositions);
+            }
+            else {
+                simulation = this.typingSimulator.simulateTyping(message);
+            }
+        }
+        else {
+            // No simulation - just create instant keystrokes
+            simulation = this.createInstantSimulation(message);
+        }
+        // Apply timing multiplier
+        const multiplier = options.timingMultiplier;
+        // Yield keystroke events
+        for (const keystroke of simulation.keystrokes) {
+            const adjustedDelay = Math.round(keystroke.delay_ms * multiplier);
+            cumulativeTime += adjustedDelay;
+            // Track message position
+            if (!keystroke.is_backspace && !keystroke.is_pause && keystroke.char) {
+                messagePosition++;
+            }
+            else if (keystroke.is_backspace && messagePosition > 0) {
+                messagePosition--;
+            }
+            const event = {
+                ...keystroke,
+                delay_ms: adjustedDelay,
+                sequence: sequence++,
+                cumulative_time_ms: cumulativeTime,
+                message_position: messagePosition,
+                delivered: false,
+            };
+            yield event;
+        }
+    }
+    /**
+     * Calculate the pre-typing delay for responding to a message.
+     *
+     * @param theirMessage The message we're responding to
+     * @param options Delivery options
+     * @returns Response timing information
+     */
+    calculateDelay(theirMessage, options = DEFAULT_DELIVERY_OPTIONS) {
+        if (options.skipPreDelay) {
+            return {
+                read_time_ms: 0,
+                think_time_ms: 0,
+                distraction_delay_ms: 0,
+                total_pre_typing_delay_ms: options.preDelayOverride ?? 0,
+                explanation: 'Pre-delay skipped',
+            };
+        }
+        if (options.preDelayOverride !== undefined) {
+            return {
+                read_time_ms: 0,
+                think_time_ms: 0,
+                distraction_delay_ms: 0,
+                total_pre_typing_delay_ms: options.preDelayOverride,
+                explanation: `Pre-delay override: ${options.preDelayOverride}ms`,
+            };
+        }
+        const timing = this.timingCalculator.calculateResponseTiming(theirMessage);
+        // Apply timing multiplier
+        const multiplier = options.timingMultiplier;
+        return {
+            ...timing,
+            read_time_ms: Math.round(timing.read_time_ms * multiplier),
+            think_time_ms: Math.round(timing.think_time_ms * multiplier),
+            distraction_delay_ms: Math.round(timing.distraction_delay_ms * multiplier),
+            total_pre_typing_delay_ms: Math.round(timing.total_pre_typing_delay_ms * multiplier),
+        };
+    }
+    /**
+     * Generate typos for a message.
+     *
+     * @param message The message to add typos to
+     * @returns Typo result with original, typo version, and corrections
+     */
+    generateTypos(message) {
+        return this.typoGenerator.generateTypos(message);
+    }
+    // ─────────────────────────────────────────────────────────────────────────────
+    // HELPER METHODS
+    // ─────────────────────────────────────────────────────────────────────────────
+    /**
+     * Create a delivery result.
+     */
+    createResult(success, options = {}) {
+        return {
+            success,
+            timestamp: new Date().toISOString(),
+            channel: this.name,
+            ...options,
+        };
+    }
+    /**
+     * Create an instant (no delay) typing simulation.
+     */
+    createInstantSimulation(message) {
+        const keystrokes = message.split('').map((char) => ({
+            char,
+            delay_ms: 0,
+            is_backspace: false,
+            is_pause: false,
+        }));
+        return {
+            message,
+            keystrokes,
+            total_duration_ms: 0,
+            effective_wpm: Infinity,
+            correction_count: 0,
+        };
+    }
+    /**
+     * Sleep for specified duration.
+     */
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+    /**
+     * Create a progress update.
+     */
+    createProgress(delivered, total, currentKeystroke, estimatedRemaining) {
+        return {
+            characters_delivered: delivered,
+            total_characters: total,
+            percent_complete: total > 0 ? Math.round((delivered / total) * 100) : 100,
+            current_keystroke: currentKeystroke,
+            estimated_remaining_ms: estimatedRemaining,
+        };
+    }
+    // ─────────────────────────────────────────────────────────────────────────────
+    // STATE ACCESS
+    // ─────────────────────────────────────────────────────────────────────────────
+    /**
+     * Get the current stealth configuration.
+     */
+    getStealthConfig() {
+        return { ...this.stealthConfig };
+    }
+    /**
+     * Update the stealth configuration.
+     */
+    updateStealthConfig(config) {
+        this.stealthConfig = { ...this.stealthConfig, ...config };
+        // Recreate components with new config
+        if (config.typing || config.behavioral) {
+            this.typingSimulator = createTypingSimulator(this.stealthConfig.typing, this.stealthConfig.behavioral);
+        }
+        if (config.timing || config.behavioral) {
+            this.timingCalculator = createTimingCalculator(this.stealthConfig.timing, this.stealthConfig.behavioral);
+        }
+        if (config.errors) {
+            this.typoGenerator = createTypoGenerator(this.stealthConfig.errors);
+        }
+    }
+    /**
+     * Get typing simulator state.
+     */
+    getTypingState() {
+        return this.typingSimulator.getState();
+    }
+    /**
+     * Get timing calculator state.
+     */
+    getTimingState() {
+        return this.timingCalculator.getState();
+    }
+    /**
+     * Reset all internal state.
+     */
+    resetState() {
+        this.typingSimulator.resetState();
+        this.timingCalculator.resetState();
+    }
+}
+/**
+ * Build a stealth config from individual configs.
+ */
+export function buildStealthConfig(config) {
+    const base = config.stealthConfig ?? createDefaultStealthConfig();
+    return {
+        ...base,
+        typing: config.typingConfig ?? base.typing,
+        timing: config.timingConfig ?? base.timing,
+        errors: config.errorConfig ?? base.errors,
+        behavioral: config.behavioralConfig ?? base.behavioral,
+    };
+}
+//# sourceMappingURL=base-channel.js.map

package/dist/recon/delivery/base-channel.js.map

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

package/dist/recon/delivery/callback-channel.d.ts

@@ -0,0 +1,156 @@
+/**
+ * ═══════════════════════════════════════════════════════════════════════════════
+ * CALLBACK DELIVERY CHANNEL
+ * ═══════════════════════════════════════════════════════════════════════════════
+ *
+ * A delivery channel that calls provided callback functions for message delivery.
+ * Designed for integration with external systems like browser automation,
+ * chat APIs, or custom message handlers.
+ *
+ * Features:
+ * - Customizable callbacks for send, keystroke, and finalize
+ * - Support for async callbacks
+ * - Error handling with optional retry
+ * - Progress tracking
+ *
+ * ═══════════════════════════════════════════════════════════════════════════════
+ */
+import { BaseDeliveryChannel, BaseChannelConfig } from './base-channel';
+import { DeliveryResult, KeystrokeEvent, DeliveryOptions } from './types';
+import { StealthConfig } from '../types';
+/**
+ * Callback for sending a complete message.
+ */
+export type SendCallback = (message: string) => Promise<boolean> | boolean;
+/**
+ * Callback for sending a single keystroke.
+ */
+export type KeystrokeCallback = (keystroke: KeystrokeEvent) => Promise<boolean> | boolean;
+/**
+ * Callback for preparing before delivery.
+ */
+export type PrepareCallback = () => Promise<void> | void;
+/**
+ * Callback for finalizing after delivery.
+ */
+export type FinalizeCallback = () => Promise<void> | void;
+/**
+ * Callback for checking availability.
+ */
+export type AvailabilityCallback = () => Promise<boolean> | boolean;
+/**
+ * Configuration for the callback channel.
+ */
+export interface CallbackChannelConfig extends BaseChannelConfig {
+    /** Channel name (default: 'callback') */
+    name?: string;
+    /** Channel description */
+    description?: string;
+    /** Callback for sending complete message (instant) */
+    onSend?: SendCallback;
+    /** Callback for sending individual keystrokes */
+    onKeystroke?: KeystrokeCallback;
+    /** Callback before starting delivery */
+    onPrepare?: PrepareCallback;
+    /** Callback after delivery completes */
+    onFinalize?: FinalizeCallback;
+    /** Callback to check availability */
+    onCheckAvailability?: AvailabilityCallback;
+    /** Whether to continue on keystroke failure */
+    continueOnKeystrokeFailure?: boolean;
+    /** Maximum keystroke failures before aborting */
+    maxKeystrokeFailures?: number;
+}
+/**
+ * Delivery channel that uses callbacks for message delivery.
+ */
+export declare class CallbackChannel extends BaseDeliveryChannel {
+    readonly name: string;
+    readonly description: string;
+    private onSend?;
+    private onKeystroke?;
+    private onPrepare?;
+    private onFinalize?;
+    private onCheckAvailability?;
+    private continueOnKeystrokeFailure;
+    private maxKeystrokeFailures;
+    constructor(config?: CallbackChannelConfig);
+    /**
+     * Check if the channel is available.
+     */
+    isAvailable(): Promise<boolean>;
+    /**
+     * Send a complete message using the send callback.
+     */
+    send(message: string): Promise<DeliveryResult>;
+    /**
+     * Send a single keystroke using the keystroke callback.
+     */
+    sendKeystroke(keystroke: KeystrokeEvent): Promise<boolean>;
+    /**
+     * Prepare for delivery.
+     */
+    prepareForDelivery(): Promise<void>;
+    /**
+     * Finalize the delivery.
+     */
+    finalizeDelivery(): Promise<void>;
+    /**
+     * Deliver a message with full stealth simulation.
+     */
+    deliverWithStealth(message: string, options?: DeliveryOptions): Promise<DeliveryResult>;
+    /**
+     * Set the send callback.
+     */
+    setSendCallback(callback: SendCallback): void;
+    /**
+     * Set the keystroke callback.
+     */
+    setKeystrokeCallback(callback: KeystrokeCallback): void;
+    /**
+     * Set the prepare callback.
+     */
+    setPrepareCallback(callback: PrepareCallback): void;
+    /**
+     * Set the finalize callback.
+     */
+    setFinalizeCallback(callback: FinalizeCallback): void;
+    /**
+     * Set the availability callback.
+     */
+    setAvailabilityCallback(callback: AvailabilityCallback): void;
+    /**
+     * Set failure handling options.
+     */
+    setFailureHandling(continueOnFailure: boolean, maxFailures: number): void;
+}
+/**
+ * Create a callback channel with the specified callbacks.
+ */
+export declare function createCallbackChannel(config: CallbackChannelConfig): CallbackChannel;
+/**
+ * Create a callback channel for browser automation.
+ *
+ * @param typeChar Function to type a character into the browser
+ * @param pressBackspace Function to press backspace
+ * @param pressEnter Function to press enter/send
+ * @param focusInput Function to focus the input element
+ * @param stealthConfig Optional stealth configuration
+ */
+export declare function createBrowserCallbackChannel(typeChar: (char: string) => Promise<void> | void, pressBackspace: () => Promise<void> | void, pressEnter: () => Promise<void> | void, focusInput?: () => Promise<void> | void, stealthConfig?: StealthConfig): CallbackChannel;
+/**
+ * Create a callback channel that collects keystrokes into a buffer.
+ * Useful for testing or capturing output without side effects.
+ */
+export declare function createBufferCallbackChannel(buffer?: {
+    text: string;
+    keystrokes: KeystrokeEvent[];
+}, stealthConfig?: StealthConfig): CallbackChannel;
+/**
+ * Create a callback channel that integrates with an API endpoint.
+ *
+ * @param sendToApi Function to send a message to the API
+ * @param stealthConfig Optional stealth configuration
+ */
+export declare function createApiCallbackChannel(sendToApi: (message: string) => Promise<boolean>, stealthConfig?: StealthConfig): CallbackChannel;
+//# sourceMappingURL=callback-channel.d.ts.map

package/dist/recon/delivery/callback-channel.d.ts.map

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