@mxf-dev/core 1.0.0

package/dist/services/orpar-memory/SurpriseOrparAdapter.js

@@ -0,0 +1,436 @@
+/**
+ * Copyright 2024 Brad Anderson
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * @author Brad Anderson <BradA1878@pm.me>
+ * @repository https://github.com/mxf-dev/mxf
+ * @documentation https://mxf-dev.github.io/mxf/
+ */
+/**
+ * SurpriseOrparAdapter
+ *
+ * Converts Titans-style surprise signals to ORPAR control decisions.
+ * This adapter implements the surprise-driven behavior modification for the
+ * ORPAR control loop.
+ *
+ * Behavior:
+ * - High surprise (>0.7): Trigger 1-3 additional observation cycles
+ * - Moderate surprise (0.4-0.7): Inject surprise context into reasoning
+ * - Plan surprise (>0.6): Flag plan for reconsideration
+ * - Momentum accumulation: Extended reasoning phase
+ *
+ * Feature flag: ORPAR_MEMORY_INTEGRATION_ENABLED
+ */
+import { createBaseEventPayload } from '../../schemas/EventPayloadSchema.js';
+import { Logger } from '../../utils/Logger.js';
+import { EventBus } from '../../events/EventBus.js';
+import { DEFAULT_SURPRISE_THRESHOLDS } from '../../types/OrparMemoryIntegrationTypes.js';
+import { OrparMemoryEvents } from '../../events/event-definitions/OrparMemoryEvents.js';
+import { KnowledgeGraphEvents, } from '../../events/event-definitions/KnowledgeGraphEvents.js';
+import { isKnowledgeGraphEnabled, isSurpriseDetectionEnabled } from '../../config/knowledge-graph.config.js';
+import { isOrparMemoryIntegrationEnabled, getSurpriseThresholds } from '../../config/orpar-memory.config.js';
+/**
+ * SurpriseOrparAdapter converts surprise signals to ORPAR control decisions
+ */
+export class SurpriseOrparAdapter {
+    static instance;
+    logger;
+    enabled = false;
+    thresholds;
+    // Track surprise momentum per agent/cycle
+    surpriseMomentum = new Map();
+    MAX_MOMENTUM_HISTORY = 10;
+    constructor() {
+        this.logger = new Logger('info', 'SurpriseOrparAdapter');
+        this.thresholds = DEFAULT_SURPRISE_THRESHOLDS;
+    }
+    /**
+     * Get the singleton instance
+     */
+    static getInstance() {
+        if (!SurpriseOrparAdapter.instance) {
+            SurpriseOrparAdapter.instance = new SurpriseOrparAdapter();
+        }
+        return SurpriseOrparAdapter.instance;
+    }
+    /**
+     * Initialize the SurpriseOrparAdapter
+     */
+    initialize() {
+        this.enabled = isOrparMemoryIntegrationEnabled();
+        this.thresholds = getSurpriseThresholds();
+        if (this.enabled) {
+            this.logger.info('[SurpriseOrparAdapter] Initialized with ORPAR-Memory integration');
+            this.logger.info(`[SurpriseOrparAdapter] Thresholds: high=${this.thresholds.high}, ` +
+                `moderate=${this.thresholds.moderate}, plan=${this.thresholds.plan}, ` +
+                `maxExtraObs=${this.thresholds.maxExtraObservations}`);
+            // Set up Knowledge Graph surprise event listener if KG is enabled
+            this.setupGraphSurpriseListener();
+        }
+        else {
+            this.logger.debug('[SurpriseOrparAdapter] ORPAR-Memory integration is disabled');
+        }
+    }
+    /**
+     * Set up listener for Knowledge Graph surprise events
+     *
+     * Listens for HIGH_SURPRISE_RELATIONSHIP events from the Knowledge Graph
+     * and converts them to ORPAR decisions, potentially triggering additional
+     * observation cycles.
+     */
+    setupGraphSurpriseListener() {
+        // Only set up listener if Knowledge Graph surprise detection is enabled
+        if (!isKnowledgeGraphEnabled() || !isSurpriseDetectionEnabled()) {
+            this.logger.debug('[SurpriseOrparAdapter] Knowledge Graph surprise integration disabled');
+            return;
+        }
+        EventBus.server.on(KnowledgeGraphEvents.HIGH_SURPRISE_RELATIONSHIP, (payload) => {
+            this.handleGraphSurpriseEvent(payload);
+        });
+        this.logger.info('[SurpriseOrparAdapter] Knowledge Graph surprise listener registered');
+    }
+    /**
+     * Handle a Knowledge Graph surprise event
+     *
+     * Converts high-surprise graph events to ORPAR decisions, potentially
+     * triggering additional observation cycles or injecting context.
+     *
+     * @param payload - The graph surprise event payload
+     */
+    handleGraphSurpriseEvent(payload) {
+        const { data, agentId, channelId } = payload;
+        this.logger.info(`[SurpriseOrparAdapter] Received graph surprise event: ` +
+            `score=${data.surpriseScore}, reason=${data.reason}`);
+        // Emit surprise detected event for the graph event
+        EventBus.server.emit(OrparMemoryEvents.SURPRISE_DETECTED, createBaseEventPayload(OrparMemoryEvents.SURPRISE_DETECTED, agentId || 'system', channelId || data.channelId, {
+            agentId: agentId || 'system',
+            channelId: channelId || data.channelId,
+            cycleId: `graph-surprise-${Date.now()}`,
+            surpriseScore: data.surpriseScore,
+            surpriseType: 'novel_pattern',
+            observation: `Graph surprise: ${data.reason}`,
+            explanation: `A surprising relationship was detected: ${data.type} between entities ` +
+                `${data.fromEntityId} and ${data.toEntityId}`
+        }));
+        // If surprise is high enough, emit additional observation queued event
+        if (data.surpriseScore >= this.thresholds.high) {
+            const additionalObservations = Math.min(Math.ceil((data.surpriseScore - this.thresholds.high) / 0.1) + 1, this.thresholds.maxExtraObservations);
+            EventBus.server.emit(OrparMemoryEvents.ADDITIONAL_OBSERVATION_QUEUED, createBaseEventPayload(OrparMemoryEvents.ADDITIONAL_OBSERVATION_QUEUED, agentId || 'system', channelId || data.channelId, {
+                agentId: agentId || 'system',
+                channelId: channelId || data.channelId,
+                cycleId: `graph-surprise-${Date.now()}`,
+                queuedCount: additionalObservations
+            }));
+            this.logger.info(`[SurpriseOrparAdapter] Graph surprise triggered ${additionalObservations} ` +
+                `additional observation cycles`);
+        }
+    }
+    /**
+     * Check if the adapter is enabled
+     */
+    isEnabled() {
+        return this.enabled;
+    }
+    /**
+     * Process a surprise detection and return an ORPAR control decision
+     *
+     * @param surprise - The surprise detection result
+     * @param context - Processing context
+     * @returns The decision to make based on the surprise
+     */
+    processSurprise(surprise, context) {
+        if (!this.enabled) {
+            return this.createNoActionDecision(surprise);
+        }
+        // Track surprise momentum
+        this.trackSurpriseMomentum(context.cycleId, surprise.surpriseScore);
+        // Emit surprise detected event
+        this.emitSurpriseDetectedEvent(surprise, context);
+        // Determine decision based on surprise score and type
+        let decision;
+        if (surprise.surpriseScore >= this.thresholds.high) {
+            decision = this.createReObserveDecision(surprise, context);
+        }
+        else if (surprise.surpriseScore >= this.thresholds.moderate) {
+            // Check if we should extend reasoning based on momentum
+            const momentum = this.calculateMomentum(context.cycleId);
+            if (momentum > this.thresholds.moderate) {
+                decision = this.createExtendReasoningDecision(surprise, context);
+            }
+            else {
+                decision = this.createInjectContextDecision(surprise, context);
+            }
+        }
+        else if (this.isPlanRelatedSurprise(surprise) && surprise.surpriseScore >= this.thresholds.plan) {
+            decision = this.createPlanReconsiderationDecision(surprise, context);
+        }
+        else {
+            decision = this.createNoActionDecision(surprise);
+        }
+        // Emit decision made event
+        this.emitDecisionMadeEvent(decision, context);
+        return decision;
+    }
+    /**
+     * Create a NO_ACTION decision
+     */
+    createNoActionDecision(surprise) {
+        return {
+            type: 'NO_ACTION',
+            surpriseDetection: surprise,
+            confidence: 1.0 - surprise.surpriseScore // High confidence when surprise is low
+        };
+    }
+    /**
+     * Create a RE_OBSERVE decision for high surprise
+     */
+    createReObserveDecision(surprise, context) {
+        // Calculate number of additional observations based on surprise score
+        const scoreAboveThreshold = surprise.surpriseScore - this.thresholds.high;
+        const maxRange = 1.0 - this.thresholds.high;
+        const proportion = maxRange > 0 ? scoreAboveThreshold / maxRange : 0;
+        const additionalObservations = Math.min(Math.ceil(proportion * this.thresholds.maxExtraObservations) + 1, this.thresholds.maxExtraObservations);
+        this.logger.info(`[SurpriseOrparAdapter] High surprise (${surprise.surpriseScore.toFixed(2)}) - ` +
+            `triggering ${additionalObservations} additional observation cycle(s)`);
+        // Emit observation queued event
+        EventBus.server.emit(OrparMemoryEvents.ADDITIONAL_OBSERVATION_QUEUED, createBaseEventPayload(OrparMemoryEvents.ADDITIONAL_OBSERVATION_QUEUED, context.agentId, context.channelId, {
+            agentId: context.agentId,
+            channelId: context.channelId,
+            cycleId: context.cycleId,
+            queuedCount: additionalObservations
+        }));
+        return {
+            type: 'RE_OBSERVE',
+            additionalObservations,
+            surpriseDetection: surprise,
+            confidence: surprise.surpriseScore // Higher surprise = higher confidence in decision
+        };
+    }
+    /**
+     * Create an INJECT_CONTEXT decision for moderate surprise
+     */
+    createInjectContextDecision(surprise, context) {
+        const surpriseContext = {
+            observation: surprise.observation,
+            explanation: surprise.explanation ?? 'Unexpected observation detected',
+            violatedExpectation: surprise.expectation
+                ? String(surprise.expectation.expected)
+                : undefined,
+            focusAreas: this.determineFocusAreas(surprise),
+            surpriseScore: surprise.surpriseScore
+        };
+        this.logger.info(`[SurpriseOrparAdapter] Moderate surprise (${surprise.surpriseScore.toFixed(2)}) - ` +
+            `injecting context into reasoning`);
+        // Emit context injected event
+        EventBus.server.emit(OrparMemoryEvents.SURPRISE_CONTEXT_INJECTED, createBaseEventPayload(OrparMemoryEvents.SURPRISE_CONTEXT_INJECTED, context.agentId, context.channelId, {
+            agentId: context.agentId,
+            channelId: context.channelId,
+            cycleId: context.cycleId,
+            surpriseScore: surprise.surpriseScore,
+            focusAreas: surpriseContext.focusAreas
+        }));
+        return {
+            type: 'INJECT_CONTEXT',
+            surpriseContext,
+            surpriseDetection: surprise,
+            confidence: 0.7 // Moderate confidence for moderate surprise
+        };
+    }
+    /**
+     * Create an EXTEND_REASONING decision based on momentum
+     */
+    createExtendReasoningDecision(surprise, context) {
+        this.logger.info(`[SurpriseOrparAdapter] Surprise momentum detected - extending reasoning phase`);
+        // Also inject context
+        const surpriseContext = {
+            observation: surprise.observation,
+            explanation: surprise.explanation ?? 'Accumulated surprise detected',
+            focusAreas: this.determineFocusAreas(surprise),
+            surpriseScore: surprise.surpriseScore
+        };
+        return {
+            type: 'EXTEND_REASONING',
+            extendReasoning: true,
+            surpriseContext,
+            surpriseDetection: surprise,
+            confidence: 0.6
+        };
+    }
+    /**
+     * Create a RECONSIDER_PLAN decision
+     */
+    createPlanReconsiderationDecision(surprise, context) {
+        const planInfo = {
+            reason: surprise.explanation ?? 'Plan-related surprise detected',
+            aspectsToReview: this.determineAspectsToReview(surprise),
+            alternativesToConsider: surprise.suggestedActions ?? [],
+            severity: this.determineSeverity(surprise.surpriseScore)
+        };
+        this.logger.info(`[SurpriseOrparAdapter] Plan surprise (${surprise.surpriseScore.toFixed(2)}) - ` +
+            `flagging plan for reconsideration (severity: ${planInfo.severity})`);
+        // Emit plan reconsideration event
+        EventBus.server.emit(OrparMemoryEvents.PLAN_RECONSIDERATION_TRIGGERED, createBaseEventPayload(OrparMemoryEvents.PLAN_RECONSIDERATION_TRIGGERED, context.agentId, context.channelId, {
+            agentId: context.agentId,
+            channelId: context.channelId,
+            cycleId: context.cycleId,
+            reason: planInfo.reason,
+            severity: planInfo.severity
+        }));
+        return {
+            type: 'RECONSIDER_PLAN',
+            planReconsideration: planInfo,
+            surpriseDetection: surprise,
+            confidence: surprise.surpriseScore * 0.9 // Slightly less confident for plan changes
+        };
+    }
+    /**
+     * Check if surprise is related to planning
+     */
+    isPlanRelatedSurprise(surprise) {
+        const planRelatedTypes = [
+            'prediction_failure',
+            'performance_deviation',
+            'unexpected_error'
+        ];
+        return surprise.type !== undefined && planRelatedTypes.includes(surprise.type);
+    }
+    /**
+     * Determine focus areas based on surprise type
+     */
+    determineFocusAreas(surprise) {
+        const focusAreas = [];
+        switch (surprise.type) {
+            case 'schema_violation':
+                focusAreas.push('data structure validation', 'schema compatibility');
+                break;
+            case 'prediction_failure':
+                focusAreas.push('model assumptions', 'prediction accuracy');
+                break;
+            case 'anomaly':
+                focusAreas.push('statistical patterns', 'outlier analysis');
+                break;
+            case 'novel_pattern':
+                focusAreas.push('pattern recognition', 'new information integration');
+                break;
+            case 'context_mismatch':
+                focusAreas.push('context understanding', 'state consistency');
+                break;
+            case 'performance_deviation':
+                focusAreas.push('performance metrics', 'resource utilization');
+                break;
+            case 'unexpected_error':
+                focusAreas.push('error handling', 'failure recovery');
+                break;
+            case 'unexpected_success':
+                focusAreas.push('success factors', 'approach validation');
+                break;
+            default:
+                focusAreas.push('general observation', 'context analysis');
+        }
+        return focusAreas;
+    }
+    /**
+     * Determine aspects of plan to review based on surprise
+     */
+    determineAspectsToReview(surprise) {
+        const aspects = [];
+        if (surprise.type === 'prediction_failure') {
+            aspects.push('action sequence', 'expected outcomes');
+        }
+        if (surprise.type === 'performance_deviation') {
+            aspects.push('resource allocation', 'timing estimates');
+        }
+        if (surprise.type === 'unexpected_error') {
+            aspects.push('error handling steps', 'fallback strategies');
+        }
+        // Always include these
+        aspects.push('assumptions', 'dependencies');
+        return aspects;
+    }
+    /**
+     * Determine severity based on surprise score
+     */
+    determineSeverity(score) {
+        if (score >= 0.8)
+            return 'high';
+        if (score >= 0.6)
+            return 'medium';
+        return 'low';
+    }
+    /**
+     * Track surprise momentum for a cycle
+     */
+    trackSurpriseMomentum(cycleId, score) {
+        let history = this.surpriseMomentum.get(cycleId);
+        if (!history) {
+            history = [];
+            this.surpriseMomentum.set(cycleId, history);
+        }
+        history.push(score);
+        // Limit history size
+        if (history.length > this.MAX_MOMENTUM_HISTORY) {
+            history.shift();
+        }
+    }
+    /**
+     * Calculate surprise momentum (average of recent surprises)
+     */
+    calculateMomentum(cycleId) {
+        const history = this.surpriseMomentum.get(cycleId);
+        if (!history || history.length === 0) {
+            return 0;
+        }
+        const sum = history.reduce((a, b) => a + b, 0);
+        return sum / history.length;
+    }
+    /**
+     * Clear momentum tracking for a cycle
+     */
+    clearMomentum(cycleId) {
+        this.surpriseMomentum.delete(cycleId);
+    }
+    /**
+     * Emit surprise detected event
+     */
+    emitSurpriseDetectedEvent(surprise, context) {
+        EventBus.server.emit(OrparMemoryEvents.SURPRISE_DETECTED, createBaseEventPayload(OrparMemoryEvents.SURPRISE_DETECTED, context.agentId, context.channelId, {
+            agentId: context.agentId,
+            channelId: context.channelId,
+            cycleId: context.cycleId,
+            surpriseScore: surprise.surpriseScore,
+            surpriseType: surprise.type ?? 'unknown',
+            observation: surprise.observation,
+            explanation: surprise.explanation
+        }));
+    }
+    /**
+     * Emit decision made event
+     */
+    emitDecisionMadeEvent(decision, context) {
+        EventBus.server.emit(OrparMemoryEvents.SURPRISE_DECISION_MADE, createBaseEventPayload(OrparMemoryEvents.SURPRISE_DECISION_MADE, context.agentId, context.channelId, {
+            agentId: context.agentId,
+            channelId: context.channelId,
+            cycleId: context.cycleId,
+            decision
+        }));
+    }
+    /**
+     * Reset the adapter (useful for testing)
+     */
+    reset() {
+        this.enabled = false;
+        this.surpriseMomentum.clear();
+    }
+}
+//# sourceMappingURL=SurpriseOrparAdapter.js.map

package/dist/services/orpar-memory/SurpriseOrparAdapter.js.map

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

package/dist/services/orpar-memory/index.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Copyright 2024 Brad Anderson
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * @author Brad Anderson <BradA1878@pm.me>
+ * @repository https://github.com/mxf-dev/mxf
+ * @documentation https://mxf-dev.github.io/mxf/
+ */
+/**
+ * ORPAR-Memory Integration Module
+ *
+ * This module provides the unified cognitive-memory architecture that tightly
+ * couples ORPAR phases with memory operations.
+ *
+ * ## Components
+ *
+ * - **OrparMemoryCoordinator**: Central orchestration service
+ * - **PhaseStrataRouter**: Routes memory queries based on ORPAR phase
+ * - **SurpriseOrparAdapter**: Converts surprise signals to ORPAR decisions
+ * - **PhaseWeightedRewarder**: Attributes Q-value rewards by phase contribution
+ * - **CycleConsolidationTrigger**: Triggers memory consolidation on cycle completion
+ * - **PhaseMemoryOperations**: Unified phase-specific store/retrieve interface
+ *
+ * ## Feature Flag
+ *
+ * Enable with: `ORPAR_MEMORY_INTEGRATION_ENABLED=true`
+ *
+ * ## Usage
+ *
+ * ```typescript
+ * import { OrparMemoryCoordinator } from './services/orpar-memory';
+ *
+ * // Get the coordinator instance
+ * const coordinator = OrparMemoryCoordinator.getInstance();
+ *
+ * // Initialize (call once at startup)
+ * coordinator.initialize();
+ *
+ * // Start a cycle
+ * const cycleId = coordinator.startCycle(agentId, channelId, taskId);
+ *
+ * // Retrieve memories for current phase
+ * const memories = await coordinator.retrieveMemories({
+ *     query: 'relevant context',
+ *     phase: 'reasoning',
+ *     agentId,
+ *     channelId
+ * });
+ *
+ * // Process surprise detection
+ * const decision = coordinator.processSurprise(cycleId, surpriseDetection);
+ *
+ * // Complete the cycle
+ * await coordinator.completeCycle(cycleId, { success: true, ... });
+ * ```
+ */
+export { OrparMemoryCoordinator } from './OrparMemoryCoordinator.js';
+export { PhaseStrataRouter } from './PhaseStrataRouter.js';
+export { SurpriseOrparAdapter } from './SurpriseOrparAdapter.js';
+export { PhaseWeightedRewarder } from './PhaseWeightedRewarder.js';
+export { CycleConsolidationTrigger } from './CycleConsolidationTrigger.js';
+export { PhaseMemoryOperations } from './PhaseMemoryOperations.js';
+export type { PhaseStorageResult } from './PhaseMemoryOperations.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/services/orpar-memory/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/orpar-memory/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AAGH,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAGrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,YAAY,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/services/orpar-memory/index.js

@@ -0,0 +1,76 @@
+/**
+ * Copyright 2024 Brad Anderson
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * @author Brad Anderson <BradA1878@pm.me>
+ * @repository https://github.com/mxf-dev/mxf
+ * @documentation https://mxf-dev.github.io/mxf/
+ */
+/**
+ * ORPAR-Memory Integration Module
+ *
+ * This module provides the unified cognitive-memory architecture that tightly
+ * couples ORPAR phases with memory operations.
+ *
+ * ## Components
+ *
+ * - **OrparMemoryCoordinator**: Central orchestration service
+ * - **PhaseStrataRouter**: Routes memory queries based on ORPAR phase
+ * - **SurpriseOrparAdapter**: Converts surprise signals to ORPAR decisions
+ * - **PhaseWeightedRewarder**: Attributes Q-value rewards by phase contribution
+ * - **CycleConsolidationTrigger**: Triggers memory consolidation on cycle completion
+ * - **PhaseMemoryOperations**: Unified phase-specific store/retrieve interface
+ *
+ * ## Feature Flag
+ *
+ * Enable with: `ORPAR_MEMORY_INTEGRATION_ENABLED=true`
+ *
+ * ## Usage
+ *
+ * ```typescript
+ * import { OrparMemoryCoordinator } from './services/orpar-memory';
+ *
+ * // Get the coordinator instance
+ * const coordinator = OrparMemoryCoordinator.getInstance();
+ *
+ * // Initialize (call once at startup)
+ * coordinator.initialize();
+ *
+ * // Start a cycle
+ * const cycleId = coordinator.startCycle(agentId, channelId, taskId);
+ *
+ * // Retrieve memories for current phase
+ * const memories = await coordinator.retrieveMemories({
+ *     query: 'relevant context',
+ *     phase: 'reasoning',
+ *     agentId,
+ *     channelId
+ * });
+ *
+ * // Process surprise detection
+ * const decision = coordinator.processSurprise(cycleId, surpriseDetection);
+ *
+ * // Complete the cycle
+ * await coordinator.completeCycle(cycleId, { success: true, ... });
+ * ```
+ */
+// Main coordinator
+export { OrparMemoryCoordinator } from './OrparMemoryCoordinator.js';
+// Component services
+export { PhaseStrataRouter } from './PhaseStrataRouter.js';
+export { SurpriseOrparAdapter } from './SurpriseOrparAdapter.js';
+export { PhaseWeightedRewarder } from './PhaseWeightedRewarder.js';
+export { CycleConsolidationTrigger } from './CycleConsolidationTrigger.js';
+export { PhaseMemoryOperations } from './PhaseMemoryOperations.js';
+//# sourceMappingURL=index.js.map

package/dist/services/orpar-memory/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/orpar-memory/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AAEH,mBAAmB;AACnB,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAErE,qBAAqB;AACrB,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC"}