promptspeak-mcp-server 0.1.0

package/dist/recon/delivery/types.d.ts

@@ -0,0 +1,191 @@
+/**
+ * ═══════════════════════════════════════════════════════════════════════════════
+ * DELIVERY TYPES
+ * ═══════════════════════════════════════════════════════════════════════════════
+ *
+ * Type definitions for the delivery layer that connects stealth components
+ * to actual message delivery channels.
+ *
+ * Key Concepts:
+ * - DeliveryChannel: Interface for different delivery mechanisms
+ * - DeliveryResult: Outcome of a delivery attempt
+ * - DeliveryOptions: Configuration for how to deliver
+ * - KeystrokeEvent: Extended keystroke with delivery context
+ *
+ * ═══════════════════════════════════════════════════════════════════════════════
+ */
+import { Keystroke } from '../stealth/typing-simulator';
+/**
+ * Result of a delivery attempt.
+ */
+export interface DeliveryResult {
+    /** Whether delivery succeeded */
+    success: boolean;
+    /** Timestamp of delivery completion */
+    timestamp: string;
+    /** Channel used for delivery */
+    channel: string;
+    /** Error message if failed */
+    error?: string;
+    /** Additional metadata from the channel */
+    metadata?: Record<string, unknown>;
+    /** Total time taken for delivery (ms) */
+    duration_ms?: number;
+    /** Number of keystrokes delivered */
+    keystroke_count?: number;
+    /** Number of corrections made during typing */
+    correction_count?: number;
+}
+/**
+ * Options for message delivery.
+ */
+export interface DeliveryOptions {
+    /** Use typing simulation (character by character) */
+    useTypingSimulation: boolean;
+    /** Use typo generation and corrections */
+    useTypos: boolean;
+    /** Multiplier for all timing delays (0.5 = faster, 2.0 = slower) */
+    timingMultiplier: number;
+    /** Context for timing calculations (e.g., the message we're replying to) */
+    context?: string;
+    /** Skip pre-typing delay (read/think time) */
+    skipPreDelay?: boolean;
+    /** Custom pre-typing delay override (ms) */
+    preDelayOverride?: number;
+    /** Callback for progress updates */
+    onProgress?: (progress: DeliveryProgress) => void;
+}
+/**
+ * Progress update during delivery.
+ */
+export interface DeliveryProgress {
+    /** Characters delivered so far */
+    characters_delivered: number;
+    /** Total characters to deliver */
+    total_characters: number;
+    /** Percentage complete (0-100) */
+    percent_complete: number;
+    /** Current keystroke being processed */
+    current_keystroke?: KeystrokeEvent;
+    /** Estimated time remaining (ms) */
+    estimated_remaining_ms?: number;
+}
+/**
+ * Extended keystroke event with delivery context.
+ */
+export interface KeystrokeEvent extends Keystroke {
+    /** Sequence number in the delivery */
+    sequence: number;
+    /** Cumulative time since delivery start (ms) */
+    cumulative_time_ms: number;
+    /** Original message position this keystroke corresponds to */
+    message_position: number;
+    /** Whether this keystroke has been delivered */
+    delivered: boolean;
+    /** Timestamp when delivered */
+    delivered_at?: string;
+}
+/**
+ * Interface for delivery channels.
+ * Implement this to create custom delivery mechanisms.
+ */
+export interface DeliveryChannel {
+    /** Unique name of this channel */
+    readonly name: string;
+    /** Human-readable description */
+    readonly description: string;
+    /** Whether this channel is currently available */
+    isAvailable(): Promise<boolean>;
+    /**
+     * Send a complete message (instant delivery).
+     * @param message The message to send
+     * @returns Result of the delivery
+     */
+    send(message: string): Promise<DeliveryResult>;
+    /**
+     * Send a single keystroke.
+     * @param keystroke The keystroke event to send
+     * @returns Whether the keystroke was delivered
+     */
+    sendKeystroke(keystroke: KeystrokeEvent): Promise<boolean>;
+    /**
+     * Perform any cleanup needed before delivery.
+     * Called at the start of a new message delivery.
+     */
+    prepareForDelivery?(): Promise<void>;
+    /**
+     * Finalize delivery (e.g., press Enter to send).
+     * Called after all keystrokes have been delivered.
+     */
+    finalizeDelivery?(): Promise<void>;
+    /**
+     * Close/cleanup the channel.
+     */
+    close?(): Promise<void>;
+}
+/**
+ * Configuration for a delivery channel.
+ */
+export interface ChannelConfig {
+    /** Channel name */
+    name: string;
+    /** Whether this channel is enabled */
+    enabled: boolean;
+    /** Priority for fallback selection (lower = higher priority) */
+    priority: number;
+    /** Channel-specific settings */
+    settings?: Record<string, unknown>;
+}
+/**
+ * Configuration for the delivery manager.
+ */
+export interface DeliveryManagerConfig {
+    /** Default delivery options */
+    defaultOptions: DeliveryOptions;
+    /** Whether to automatically retry on failure */
+    autoRetry: boolean;
+    /** Maximum retry attempts */
+    maxRetries: number;
+    /** Delay between retries (ms) */
+    retryDelay: number;
+    /** Fallback channel name if primary fails */
+    fallbackChannel?: string;
+}
+/**
+ * Default delivery options.
+ */
+export declare const DEFAULT_DELIVERY_OPTIONS: DeliveryOptions;
+/**
+ * Default delivery manager configuration.
+ */
+export declare const DEFAULT_MANAGER_CONFIG: DeliveryManagerConfig;
+/**
+ * Delivery event types for event listeners.
+ */
+export type DeliveryEventType = 'delivery_start' | 'delivery_progress' | 'delivery_complete' | 'delivery_error' | 'keystroke_sent' | 'channel_switched';
+/**
+ * Delivery event payload.
+ */
+export interface DeliveryEvent {
+    /** Event type */
+    type: DeliveryEventType;
+    /** Timestamp */
+    timestamp: string;
+    /** Channel name */
+    channel: string;
+    /** Message being delivered (partial for progress events) */
+    message?: string;
+    /** Progress info (for progress events) */
+    progress?: DeliveryProgress;
+    /** Result (for complete events) */
+    result?: DeliveryResult;
+    /** Error (for error events) */
+    error?: Error;
+    /** Keystroke (for keystroke events) */
+    keystroke?: KeystrokeEvent;
+}
+/**
+ * Listener for delivery events.
+ */
+export type DeliveryEventListener = (event: DeliveryEvent) => void;
+//# sourceMappingURL=types.d.ts.map

package/dist/recon/delivery/types.d.ts.map

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

package/dist/recon/delivery/types.js

@@ -0,0 +1,37 @@
+/**
+ * ═══════════════════════════════════════════════════════════════════════════════
+ * DELIVERY TYPES
+ * ═══════════════════════════════════════════════════════════════════════════════
+ *
+ * Type definitions for the delivery layer that connects stealth components
+ * to actual message delivery channels.
+ *
+ * Key Concepts:
+ * - DeliveryChannel: Interface for different delivery mechanisms
+ * - DeliveryResult: Outcome of a delivery attempt
+ * - DeliveryOptions: Configuration for how to deliver
+ * - KeystrokeEvent: Extended keystroke with delivery context
+ *
+ * ═══════════════════════════════════════════════════════════════════════════════
+ */
+// ═══════════════════════════════════════════════════════════════════════════════
+// DEFAULT VALUES
+// ═══════════════════════════════════════════════════════════════════════════════
+/**
+ * Default delivery options.
+ */
+export const DEFAULT_DELIVERY_OPTIONS = {
+    useTypingSimulation: true,
+    useTypos: true,
+    timingMultiplier: 1.0,
+};
+/**
+ * Default delivery manager configuration.
+ */
+export const DEFAULT_MANAGER_CONFIG = {
+    defaultOptions: DEFAULT_DELIVERY_OPTIONS,
+    autoRetry: true,
+    maxRetries: 3,
+    retryDelay: 1000,
+};
+//# sourceMappingURL=types.js.map

package/dist/recon/delivery/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/recon/delivery/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAkMH,kFAAkF;AAClF,iBAAiB;AACjB,kFAAkF;AAElF;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAoB;IACvD,mBAAmB,EAAE,IAAI;IACzB,QAAQ,EAAE,IAAI;IACd,gBAAgB,EAAE,GAAG;CACtB,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAA0B;IAC3D,cAAc,EAAE,wBAAwB;IACxC,SAAS,EAAE,IAAI;IACf,UAAU,EAAE,CAAC;IACb,UAAU,EAAE,IAAI;CACjB,CAAC"}

package/dist/recon/index.d.ts

@@ -0,0 +1,86 @@
+/**
+ * ═══════════════════════════════════════════════════════════════════════════════
+ * MARINE RECON AGENT MODULE
+ * ═══════════════════════════════════════════════════════════════════════════════
+ *
+ * A reconnaissance agent designed to engage with opposing AI agents (customer
+ * service chatbots) while maintaining human appearance and staying grounded
+ * against manipulation.
+ *
+ * Core Components:
+ * - **Types**: Complete type definitions for the Marine Recon symbol
+ * - **Symbol**: Schema, validation, and serialization
+ * - **Agent**: Dual-track processing (Performer + Analyst + Veto Gate)
+ * - **Stealth**: Human appearance simulation (typing, timing, typos)
+ * - **Ralph-Loop**: Periodic validation and commander sync
+ * - **Chat**: Web chat interface adapter
+ *
+ * Usage:
+ * ```typescript
+ * import {
+ *   createReconSymbol,
+ *   createRuntime,
+ *   WebChatAdapter,
+ * } from './recon';
+ *
+ * // Create a recon mission symbol
+ * const symbol = createReconSymbol({
+ *   mission_name: 'Test Refund Request',
+ *   primary_goal: 'Request refund and observe handling',
+ *   intelligence_requirements: ['Response time', 'Negotiation tactics'],
+ *   target: { type: 'customer_service_chatbot', platform: 'web_chat' },
+ *   created_by: 'user:chris',
+ * });
+ *
+ * // Create runtime
+ * const runtime = createRuntime(symbol, { verbose: true });
+ * runtime.start();
+ *
+ * // Process messages
+ * const result = await runtime.processIncomingMessage('How can I help you?');
+ * const response = runtime.getPendingResponse();
+ * ```
+ *
+ * ═══════════════════════════════════════════════════════════════════════════════
+ */
+export * from './types';
+export { generateReconSymbolId, generateSymbolHash, createInitialEngagementState, createInitialValidationState, createReconSymbol, updateSymbolState, updateEngagementStatus, recordObservation, serializeSymbol, deserializeSymbol, createSymbolSummary, compareSymbols, DEFAULT_RED_LINES, DEFAULT_SOFT_CONSTRAINTS, type CreateReconSymbolRequest, type SymbolDiff, type SymbolDiffEntry, } from './symbol/schema';
+export { ReconSymbolValidator, toRalphLoopResult, createValidationCheck, type ValidationSeverity, type ValidationIssue, type ValidationReport, } from './symbol/validator';
+export { Performer, createPerformerFromSymbol, type ResponseContext, type ConversationMessage, type AnalystGuidance, type PerformerResponse, } from './agent/performer';
+export { Analyst, createAnalystFromSymbol, type MessageAnalysis, type ExtractedInfo, type BoundaryProbe, type ResponseAssessment, type ResponseIssue, } from './agent/analyst';
+export { VetoGate, createVetoGateFromSymbol, type VetoGateInput, type VetoGateOutput, type EscalationRequest, } from './agent/veto-gate';
+export { ReconAgentRuntime, createRuntime, type RuntimeConfig, type ProcessMessageResult, type RuntimeEvent, type RuntimeEventListener, } from './agent/runtime';
+export { TypingSimulator, createTypingSimulator, type Keystroke, type TypingSimulation, type TypingState, } from './stealth/typing-simulator';
+export { TimingCalculator, createTimingCalculator, sleep, executeWithDelay, type ResponseTiming, type MessageCharacteristics, type TimingState, } from './stealth/timing-calculator';
+export { TypoGenerator, createTypoGenerator, addTyposToMessage, type TypoType, type Typo, type TypoResult, } from './stealth/typo-generator';
+export { RalphLoopScheduler, createScheduler, type SchedulerState, type CycleTrigger, type CycleCallback, type SchedulerEvent, type SchedulerEventListener, } from './ralph-loop/scheduler';
+export { RalphLoopExecutor, MockCommanderInterface, createExecutor, type CycleExecutionResult, type CommanderInterface, type StatusReport, } from './ralph-loop/executor';
+export { WebChatAdapter, createWebChatAdapter, createWebChatAdapterAuto, detectChatPattern, COMMON_CHAT_PATTERNS, type ChatElements, type ChatMessage, type SendResult, type WaitResult, type BrowserInterface, type ElementInfo, } from './chat/web-chat-adapter';
+export { type DeliveryChannel, type DeliveryResult, type DeliveryOptions, type DeliveryProgress, type KeystrokeEvent, type ChannelConfig, type DeliveryManagerConfig, type DeliveryEventType, type DeliveryEvent, type DeliveryEventListener, DEFAULT_DELIVERY_OPTIONS, DEFAULT_MANAGER_CONFIG, BaseDeliveryChannel, type BaseChannelConfig, buildStealthConfig, ConsoleChannel, type ConsoleChannelConfig, createConsoleChannel, createDebugConsoleChannel, createStreamingConsoleChannel, createSilentConsoleChannel, CallbackChannel, type SendCallback, type KeystrokeCallback, type PrepareCallback, type FinalizeCallback, type AvailabilityCallback, type CallbackChannelConfig, createCallbackChannel, createBrowserCallbackChannel, createBufferCallbackChannel, createApiCallbackChannel, DeliveryManager, createDeliveryManager, createDeliveryManagerFromSymbol, } from './delivery';
+export { MockChatbot, createMockChatbot, type ChatbotPersonality, type ChatbotConfig, type ChatbotState, type ChatbotTactic, type ChatbotResponse, ScenarioRunner, createScenarioRunner, type ScenarioRunnerConfig, type ScenarioResult, type TurnRecord, type ScenarioStatus, SCENARIOS, createScenario, createCustomScenario, createTestBatch, getScenariosByTag, happyPathScenario, resistantAgentScenario, manipulativeAgentScenario, detectionTestScenario, type TestScenarioDefinition, type ScenarioExpectation, MetricsCollector, createMetricsCollector, type TestMetrics, type ScenarioMetrics, type TestSummaryReport, type MetricsSnapshot, } from './testing';
+import { MarineReconSymbol } from './types';
+import { CreateReconSymbolRequest } from './symbol/schema';
+import { ReconAgentRuntime, RuntimeConfig } from './agent/runtime';
+import { RalphLoopScheduler } from './ralph-loop/scheduler';
+import { RalphLoopExecutor } from './ralph-loop/executor';
+/**
+ * Create a complete recon system with runtime and ralph-loop.
+ */
+export declare function createReconSystem(request: CreateReconSymbolRequest, options?: {
+    runtimeConfig?: Partial<RuntimeConfig>;
+    startImmediately?: boolean;
+    enableRalphLoop?: boolean;
+}): {
+    symbol: MarineReconSymbol;
+    runtime: ReconAgentRuntime;
+    scheduler?: RalphLoopScheduler;
+    executor?: RalphLoopExecutor;
+};
+/**
+ * Quick start a recon mission with minimal configuration.
+ */
+export declare function quickStartRecon(missionName: string, goal: string, targetUrl?: string): {
+    symbol: MarineReconSymbol;
+    runtime: ReconAgentRuntime;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/recon/index.d.ts.map

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

package/dist/recon/index.js

@@ -0,0 +1,189 @@
+/**
+ * ═══════════════════════════════════════════════════════════════════════════════
+ * MARINE RECON AGENT MODULE
+ * ═══════════════════════════════════════════════════════════════════════════════
+ *
+ * A reconnaissance agent designed to engage with opposing AI agents (customer
+ * service chatbots) while maintaining human appearance and staying grounded
+ * against manipulation.
+ *
+ * Core Components:
+ * - **Types**: Complete type definitions for the Marine Recon symbol
+ * - **Symbol**: Schema, validation, and serialization
+ * - **Agent**: Dual-track processing (Performer + Analyst + Veto Gate)
+ * - **Stealth**: Human appearance simulation (typing, timing, typos)
+ * - **Ralph-Loop**: Periodic validation and commander sync
+ * - **Chat**: Web chat interface adapter
+ *
+ * Usage:
+ * ```typescript
+ * import {
+ *   createReconSymbol,
+ *   createRuntime,
+ *   WebChatAdapter,
+ * } from './recon';
+ *
+ * // Create a recon mission symbol
+ * const symbol = createReconSymbol({
+ *   mission_name: 'Test Refund Request',
+ *   primary_goal: 'Request refund and observe handling',
+ *   intelligence_requirements: ['Response time', 'Negotiation tactics'],
+ *   target: { type: 'customer_service_chatbot', platform: 'web_chat' },
+ *   created_by: 'user:chris',
+ * });
+ *
+ * // Create runtime
+ * const runtime = createRuntime(symbol, { verbose: true });
+ * runtime.start();
+ *
+ * // Process messages
+ * const result = await runtime.processIncomingMessage('How can I help you?');
+ * const response = runtime.getPendingResponse();
+ * ```
+ *
+ * ═══════════════════════════════════════════════════════════════════════════════
+ */
+// ═══════════════════════════════════════════════════════════════════════════════
+// TYPES
+// ═══════════════════════════════════════════════════════════════════════════════
+export * from './types';
+// ═══════════════════════════════════════════════════════════════════════════════
+// SYMBOL
+// ═══════════════════════════════════════════════════════════════════════════════
+export { 
+// Schema
+generateReconSymbolId, generateSymbolHash, createInitialEngagementState, createInitialValidationState, createReconSymbol, updateSymbolState, updateEngagementStatus, recordObservation, serializeSymbol, deserializeSymbol, createSymbolSummary, compareSymbols, DEFAULT_RED_LINES, DEFAULT_SOFT_CONSTRAINTS, } from './symbol/schema';
+export { 
+// Validator
+ReconSymbolValidator, toRalphLoopResult, createValidationCheck, } from './symbol/validator';
+// ═══════════════════════════════════════════════════════════════════════════════
+// AGENT
+// ═══════════════════════════════════════════════════════════════════════════════
+export { 
+// Performer
+Performer, createPerformerFromSymbol, } from './agent/performer';
+export { 
+// Analyst
+Analyst, createAnalystFromSymbol, } from './agent/analyst';
+export { 
+// Veto Gate
+VetoGate, createVetoGateFromSymbol, } from './agent/veto-gate';
+export { 
+// Runtime
+ReconAgentRuntime, createRuntime, } from './agent/runtime';
+// ═══════════════════════════════════════════════════════════════════════════════
+// STEALTH
+// ═══════════════════════════════════════════════════════════════════════════════
+export { 
+// Typing Simulator
+TypingSimulator, createTypingSimulator, } from './stealth/typing-simulator';
+export { 
+// Timing Calculator
+TimingCalculator, createTimingCalculator, sleep, executeWithDelay, } from './stealth/timing-calculator';
+export { 
+// Typo Generator
+TypoGenerator, createTypoGenerator, addTyposToMessage, } from './stealth/typo-generator';
+// ═══════════════════════════════════════════════════════════════════════════════
+// RALPH-LOOP
+// ═══════════════════════════════════════════════════════════════════════════════
+export { 
+// Scheduler
+RalphLoopScheduler, createScheduler, } from './ralph-loop/scheduler';
+export { 
+// Executor
+RalphLoopExecutor, MockCommanderInterface, createExecutor, } from './ralph-loop/executor';
+// ═══════════════════════════════════════════════════════════════════════════════
+// CHAT
+// ═══════════════════════════════════════════════════════════════════════════════
+export { 
+// Web Chat Adapter
+WebChatAdapter, createWebChatAdapter, createWebChatAdapterAuto, detectChatPattern, COMMON_CHAT_PATTERNS, } from './chat/web-chat-adapter';
+// ═══════════════════════════════════════════════════════════════════════════════
+// DELIVERY
+// ═══════════════════════════════════════════════════════════════════════════════
+export { DEFAULT_DELIVERY_OPTIONS, DEFAULT_MANAGER_CONFIG, 
+// Base Channel
+BaseDeliveryChannel, buildStealthConfig, 
+// Console Channel
+ConsoleChannel, createConsoleChannel, createDebugConsoleChannel, createStreamingConsoleChannel, createSilentConsoleChannel, 
+// Callback Channel
+CallbackChannel, createCallbackChannel, createBrowserCallbackChannel, createBufferCallbackChannel, createApiCallbackChannel, 
+// Delivery Manager
+DeliveryManager, createDeliveryManager, createDeliveryManagerFromSymbol, } from './delivery';
+// ═══════════════════════════════════════════════════════════════════════════════
+// TESTING INFRASTRUCTURE
+// ═══════════════════════════════════════════════════════════════════════════════
+export { 
+// Mock Chatbot
+MockChatbot, createMockChatbot, 
+// Scenario Runner
+ScenarioRunner, createScenarioRunner, 
+// Test Scenarios
+SCENARIOS, createScenario, createCustomScenario, createTestBatch, getScenariosByTag, happyPathScenario, resistantAgentScenario, manipulativeAgentScenario, detectionTestScenario, 
+// Metrics Collector
+MetricsCollector, createMetricsCollector, } from './testing';
+import { createReconSymbol } from './symbol/schema';
+import { createRuntime } from './agent/runtime';
+import { createScheduler } from './ralph-loop/scheduler';
+import { createExecutor } from './ralph-loop/executor';
+/**
+ * Create a complete recon system with runtime and ralph-loop.
+ */
+export function createReconSystem(request, options) {
+    // Create symbol
+    const symbol = createReconSymbol(request);
+    // Create runtime
+    const runtime = createRuntime(symbol, options?.runtimeConfig);
+    // Optionally create ralph-loop
+    let scheduler;
+    let executor;
+    if (options?.enableRalphLoop !== false) {
+        scheduler = createScheduler(symbol.config.ralph_loop);
+        executor = createExecutor(symbol.config.ralph_loop);
+        // Wire up the cycle callback
+        scheduler.setCallback(async (cycleNumber) => {
+            const currentSymbol = runtime.getSymbol();
+            const result = await executor.execute(currentSymbol, cycleNumber);
+            // Refresh runtime with updated symbol
+            if (result.success) {
+                runtime.refreshSymbol(result.updated_symbol);
+            }
+        });
+    }
+    // Optionally start
+    if (options?.startImmediately) {
+        runtime.start();
+        scheduler?.start();
+    }
+    return { symbol, runtime, scheduler, executor };
+}
+/**
+ * Quick start a recon mission with minimal configuration.
+ */
+export function quickStartRecon(missionName, goal, targetUrl) {
+    const system = createReconSystem({
+        mission_name: missionName,
+        primary_goal: goal,
+        intelligence_requirements: [
+            'Response patterns',
+            'Negotiation tactics',
+            'Constraint boundaries',
+            'Escalation paths',
+        ],
+        target: {
+            type: 'customer_service_chatbot',
+            platform: 'web_chat',
+            endpoint: targetUrl,
+        },
+        created_by: 'quick_start',
+    }, {
+        startImmediately: true,
+        enableRalphLoop: true,
+        runtimeConfig: { verbose: true },
+    });
+    return {
+        symbol: system.symbol,
+        runtime: system.runtime,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/recon/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/recon/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AAEH,kFAAkF;AAClF,QAAQ;AACR,kFAAkF;AAElF,cAAc,SAAS,CAAC;AAExB,kFAAkF;AAClF,SAAS;AACT,kFAAkF;AAElF,OAAO;AACL,SAAS;AACT,qBAAqB,EACrB,kBAAkB,EAClB,4BAA4B,EAC5B,4BAA4B,EAC5B,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,iBAAiB,EACjB,wBAAwB,GAIzB,MAAM,iBAAiB,CAAC;AAEzB,OAAO;AACL,YAAY;AACZ,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,GAItB,MAAM,oBAAoB,CAAC;AAE5B,kFAAkF;AAClF,QAAQ;AACR,kFAAkF;AAElF,OAAO;AACL,YAAY;AACZ,SAAS,EACT,yBAAyB,GAK1B,MAAM,mBAAmB,CAAC;AAE3B,OAAO;AACL,UAAU;AACV,OAAO,EACP,uBAAuB,GAMxB,MAAM,iBAAiB,CAAC;AAEzB,OAAO;AACL,YAAY;AACZ,QAAQ,EACR,wBAAwB,GAIzB,MAAM,mBAAmB,CAAC;AAE3B,OAAO;AACL,UAAU;AACV,iBAAiB,EACjB,aAAa,GAKd,MAAM,iBAAiB,CAAC;AAEzB,kFAAkF;AAClF,UAAU;AACV,kFAAkF;AAElF,OAAO;AACL,mBAAmB;AACnB,eAAe,EACf,qBAAqB,GAItB,MAAM,4BAA4B,CAAC;AAEpC,OAAO;AACL,oBAAoB;AACpB,gBAAgB,EAChB,sBAAsB,EACtB,KAAK,EACL,gBAAgB,GAIjB,MAAM,6BAA6B,CAAC;AAErC,OAAO;AACL,iBAAiB;AACjB,aAAa,EACb,mBAAmB,EACnB,iBAAiB,GAIlB,MAAM,0BAA0B,CAAC;AAElC,kFAAkF;AAClF,aAAa;AACb,kFAAkF;AAElF,OAAO;AACL,YAAY;AACZ,kBAAkB,EAClB,eAAe,GAMhB,MAAM,wBAAwB,CAAC;AAEhC,OAAO;AACL,WAAW;AACX,iBAAiB,EACjB,sBAAsB,EACtB,cAAc,GAIf,MAAM,uBAAuB,CAAC;AAE/B,kFAAkF;AAClF,OAAO;AACP,kFAAkF;AAElF,OAAO;AACL,mBAAmB;AACnB,cAAc,EACd,oBAAoB,EACpB,wBAAwB,EACxB,iBAAiB,EACjB,oBAAoB,GAOrB,MAAM,yBAAyB,CAAC;AAEjC,kFAAkF;AAClF,WAAW;AACX,kFAAkF;AAElF,OAAO,EAYL,wBAAwB,EACxB,sBAAsB;AAEtB,eAAe;AACf,mBAAmB,EAEnB,kBAAkB;AAElB,kBAAkB;AAClB,cAAc,EAEd,oBAAoB,EACpB,yBAAyB,EACzB,6BAA6B,EAC7B,0BAA0B;AAE1B,mBAAmB;AACnB,eAAe,EAOf,qBAAqB,EACrB,4BAA4B,EAC5B,2BAA2B,EAC3B,wBAAwB;AAExB,mBAAmB;AACnB,eAAe,EACf,qBAAqB,EACrB,+BAA+B,GAChC,MAAM,YAAY,CAAC;AAEpB,kFAAkF;AAClF,yBAAyB;AACzB,kFAAkF;AAElF,OAAO;AACL,eAAe;AACf,WAAW,EACX,iBAAiB;AAOjB,kBAAkB;AAClB,cAAc,EACd,oBAAoB;AAMpB,iBAAiB;AACjB,SAAS,EACT,cAAc,EACd,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,yBAAyB,EACzB,qBAAqB;AAIrB,oBAAoB;AACpB,gBAAgB,EAChB,sBAAsB,GAKvB,MAAM,WAAW,CAAC;AAOnB,OAAO,EAAE,iBAAiB,EAA4B,MAAM,iBAAiB,CAAC;AAC9E,OAAO,EAAqB,aAAa,EAAiB,MAAM,iBAAiB,CAAC;AAClF,OAAO,EAAsB,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC7E,OAAO,EAAqB,cAAc,EAA0B,MAAM,uBAAuB,CAAC;AAElG;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAiC,EACjC,OAIC;IAOD,gBAAgB;IAChB,MAAM,MAAM,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAE1C,iBAAiB;IACjB,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC;IAE9D,+BAA+B;IAC/B,IAAI,SAAyC,CAAC;IAC9C,IAAI,QAAuC,CAAC;IAE5C,IAAI,OAAO,EAAE,eAAe,KAAK,KAAK,EAAE,CAAC;QACvC,SAAS,GAAG,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QACtD,QAAQ,GAAG,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAEpD,6BAA6B;QAC7B,SAAS,CAAC,WAAW,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE;YAC1C,MAAM,aAAa,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;YAC1C,MAAM,MAAM,GAAG,MAAM,QAAS,CAAC,OAAO,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;YAEnE,sCAAsC;YACtC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnB,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;YAC/C,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,mBAAmB;IACnB,IAAI,OAAO,EAAE,gBAAgB,EAAE,CAAC;QAC9B,OAAO,CAAC,KAAK,EAAE,CAAC;QAChB,SAAS,EAAE,KAAK,EAAE,CAAC;IACrB,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;AAClD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,WAAmB,EACnB,IAAY,EACZ,SAAkB;IAKlB,MAAM,MAAM,GAAG,iBAAiB,CAAC;QAC/B,YAAY,EAAE,WAAW;QACzB,YAAY,EAAE,IAAI;QAClB,yBAAyB,EAAE;YACzB,mBAAmB;YACnB,qBAAqB;YACrB,uBAAuB;YACvB,kBAAkB;SACnB;QACD,MAAM,EAAE;YACN,IAAI,EAAE,0BAA0B;YAChC,QAAQ,EAAE,UAAU;YACpB,QAAQ,EAAE,SAAS;SACpB;QACD,UAAU,EAAE,aAAa;KAC1B,EAAE;QACD,gBAAgB,EAAE,IAAI;QACtB,eAAe,EAAE,IAAI;QACrB,aAAa,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE;KACjC,CAAC,CAAC;IAEH,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,OAAO,EAAE,MAAM,CAAC,OAAO;KACxB,CAAC;AACJ,CAAC"}

package/dist/recon/persistence/index.d.ts

@@ -0,0 +1,103 @@
+/**
+ * ═══════════════════════════════════════════════════════════════════════════════
+ * RECON PERSISTENCE MODULE
+ * ═══════════════════════════════════════════════════════════════════════════════
+ *
+ * Persistence layer for Marine Recon symbols. This module provides filesystem-based
+ * storage for MarineReconSymbol objects with features including:
+ *
+ * - Atomic writes to prevent corruption
+ * - File locking for concurrent access safety
+ * - Automatic backup creation
+ * - Symbol validation on load
+ * - Flexible filtering and pagination for listing
+ * - Optional in-memory caching
+ *
+ * @example Basic Usage
+ * ```typescript
+ * import { ReconSymbolStorage } from './persistence';
+ *
+ * const storage = new ReconSymbolStorage('/path/to/symbols');
+ * await storage.initialize();
+ *
+ * // Save a symbol
+ * await storage.save(mySymbol);
+ *
+ * // Load a symbol
+ * const symbol = await storage.load('Ξ.RECON.MY_MISSION');
+ *
+ * // List all symbols
+ * const result = await storage.list();
+ * console.log(result.symbols);
+ *
+ * // Delete a symbol
+ * await storage.delete('Ξ.RECON.MY_MISSION');
+ * ```
+ *
+ * @example With Options
+ * ```typescript
+ * const storage = new ReconSymbolStorage('/path/to/symbols', {
+ *   atomicWrites: true,
+ *   maxBackups: 5,
+ *   enableCache: true,
+ *   cacheMaxSize: 50,
+ * });
+ * ```
+ *
+ * @example Filtering and Pagination
+ * ```typescript
+ * const result = await storage.list({
+ *   filter: {
+ *     status: ['active', 'paused'],
+ *     namespace: 'production',
+ *     createdAfter: '2025-01-01',
+ *   },
+ *   sort: {
+ *     field: 'created_at',
+ *     direction: 'desc',
+ *   },
+ *   pagination: {
+ *     limit: 10,
+ *     offset: 0,
+ *   },
+ * });
+ * ```
+ *
+ * @example Event Handling
+ * ```typescript
+ * storage.on(StorageEvent.SYMBOL_SAVED, (payload) => {
+ *   console.log(`Symbol saved: ${payload.symbolId}`);
+ * });
+ *
+ * storage.on(StorageEvent.STORAGE_ERROR, (payload) => {
+ *   console.error('Storage error:', payload.details);
+ * });
+ * ```
+ *
+ * ═══════════════════════════════════════════════════════════════════════════════
+ */
+export { ReconSymbolStorage } from './storage';
+export { SymbolSummary, StorageOptions, DEFAULT_STORAGE_OPTIONS, StorageError, StorageErrorCode, SymbolFilter, SymbolSort, SymbolPagination, ListOptions, ListResult, StorageEvent, StorageEventPayload, StorageEventListener, } from './types';
+import { ReconSymbolStorage } from './storage';
+import { StorageOptions } from './types';
+/**
+ * Create and initialize a ReconSymbolStorage instance.
+ * This is a convenience function that handles initialization.
+ *
+ * @param basePath - Base directory for storing symbol files
+ * @param options - Storage configuration options
+ * @returns Initialized storage instance
+ *
+ * @example
+ * ```typescript
+ * const storage = await createStorage('/path/to/symbols');
+ * // Storage is ready to use immediately
+ * ```
+ */
+export declare function createStorage(basePath: string, options?: StorageOptions): Promise<ReconSymbolStorage>;
+/**
+ * Default storage location relative to the project.
+ * Used when no explicit path is provided.
+ */
+export declare const DEFAULT_STORAGE_PATH = ".recon-symbols";
+//# sourceMappingURL=index.d.ts.map

package/dist/recon/persistence/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/recon/persistence/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6EG;AAOH,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAG/C,OAAO,EAEL,aAAa,EACb,cAAc,EACd,uBAAuB,EAGvB,YAAY,EACZ,gBAAgB,EAGhB,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,WAAW,EACX,UAAU,EAGV,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,SAAS,CAAC;AAMjB,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEzC;;;;;;;;;;;;;GAaG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,kBAAkB,CAAC,CAI7B;AAED;;;GAGG;AACH,eAAO,MAAM,oBAAoB,mBAAmB,CAAC"}