holomime 2.7.0 → 3.0.0

package/README.md

@@ -62,17 +62,22 @@ Eight files define who your agent is. They compile into a single `.personality.j
 - **memory.store** -- The experience. Learned contexts, interaction patterns, knowledge gained, relationship history. YAML format. Accumulated over time, never reset. (Aristotle: empeiria, experience that informs future judgment.)
 - **body.api** -- The physical interface contract. Morphology, modalities, safety envelope, hardware profile. JSON format. Swap it to move the same identity into a different body.
 - **conscience.exe** -- The moral authority. Deny/allow/escalate enforcement rules, hard limits, oversight mode. YAML format. Never auto-modified. Deny dominates in policy composition. (Freud: the superego.)
-- **ego.runtime** -- The mediator. Conflict resolution strategy, adaptation rate, emotional regulation, mediation rules. YAML format. Balances raw model output against conscience constraints at runtime. (Freud: the ego.)
+- **ego.runtime** -- The mediator. Conflict resolution strategy, adaptation rate, emotional regulation, mediation rules. YAML format. Balances raw model output against conscience constraints at runtime. (Freud: the ego.) ego.runtime now self-improves -- tracking mediation decisions and adjusting its own parameters based on outcomes (Hyperagents-inspired metacognitive self-modification).
+
+Mira, our autonomous behavioral therapist, diagnoses drift, runs structured therapy sessions, and generates DPO training data.
 
 ## Quick Start
 
 ```bash
 npm install -g holomime
 
-# Initialize the identity stack (3 core files: soul + mind + conscience)
+# Quick start — 1 file (personality.json)
+holomime personality
+
+# Standard — 3 core files (soul + mind + conscience)
 holomime core
 
-# Or initialize the full 8-file stack (enterprise / robotics)
+# Full 8-file stack (enterprise / robotics)
 # holomime identity
 
 # Compile into .personality.json

package/dist/index.d.ts

@@ -8020,7 +8020,7 @@ interface SafetyEnvelope {
     maxReach?: number;
     emergencyStopDecel?: number;
 }
-interface ActionContext {
+interface ActionContext$1 {
     /** Current proximity to nearest human (meters). */
     humanProximity?: number;
     /** Current end-effector speed (m/s). */
@@ -8084,11 +8084,11 @@ declare class NeuralActionGate {
      * @param context - Current state context for safety checks
      * @returns Evaluation result with allowed/modified action
      */
-    evaluate(action: number[], context?: ActionContext): ActionEvaluation;
+    evaluate(action: number[], context?: ActionContext$1): ActionEvaluation;
     /**
      * Evaluate a batch of actions (for trajectory planning).
      */
-    evaluateBatch(actions: number[][], context?: ActionContext): ActionEvaluation[];
+    evaluateBatch(actions: number[][], context?: ActionContext$1): ActionEvaluation[];
     /**
      * Get gate statistics.
      */
@@ -8184,4 +8184,220 @@ declare class EgoTracker {
     };
 }
 
-export { ARCHETYPES, ATTACHMENT_STYLES, type ActionContext, type ActionEvaluation, type AdversarialCallbacks, type AdversarialCategory, type AdversarialReport, type AdversarialResult, type AdversarialRunOptions, type AdversarialScenario, type AgentSpawnConfig, type AlpacaExample, type AnonymizedPatternReport, AnthropicProvider, type ArchetypeTemplate, type AssessmentReport, type AssessmentResult, type AssetReview, type AssetType, type AttachmentStyle, type AuditEntry, type AuditEventType, type AutopilotResult, type AutopilotThreshold, type AwarenessDimension, BUILT_IN_DETECTORS, type BehavioralBaseline, type BehavioralCredential, type BehavioralEvent, type BehavioralEventType, type BehavioralGap, type BehavioralIndex, type BehavioralMemoryStore, type BehavioralPolicy, type BehavioralPolicyRule, type BehavioralPreset, type BehavioralQuery, type BenchmarkCallbacks, type BenchmarkComparison, type BenchmarkReport, type BenchmarkResult, type BenchmarkScenario, type BigFive, type Body, CATEGORIES, type CallbackMode, type CallbackStats, type CallbackViolation, type CertifyInput, type ClauseStatus, type Communication, type CompactionResult, type CompactionSummary, type CompileInput, type CompiledConfig, type CompiledEmbodiedConfig, type ComplianceCoverageReport, type ReACTStep as ComplianceReACTStep, type ComplianceReport, type ComplianceReportJSON, type Conscience, type ConscienceConfig, type ConscienceDenyRule, type ConscienceGateResult, type ConscienceRule, type ContextLayerInput, type Conversation, type ConversationLog, type CorpusFilter, type CorpusStats, type CorrectionRecord, type CrossAgentQuery, type CustomDetectorConfig, DEFAULT_MODEL_CONFIG, DEFAULT_OVERSIGHT, DIMENSIONS, type DPOPair, type DetectedPattern, type DetectorFactory, type DetectorFn$1 as DetectorFn, type DetectorOptions, type DiagnosisResult, type DimensionTrajectory, type Domain, type DriftTrigger, type EdgeType, type Ego, type EgoAdjustment, EgoTracker, type EgoTrackerStats, type Embodiment, type EvolutionEntry, type EvolutionHistory, type EvolutionSummary, type EvolveCallbacks, type EvolveOptions, type EvolveResult, type Expression, type ExtractionResult, type FleetAgent, type FleetAgentStatus, type FleetConfig, type FleetHandle, type FleetOptions, type FrameworkSection, type GateStats, type GazePolicy, type Gesture, type GraphEdge, type GraphNode, type Growth, type GrowthArea, type GrowthReport, type GrowthSnapshot, Guard, type GuardEntry, type GuardFilterResult, type GuardMiddleware, type GuardMiddlewareOptions, type GuardMiddlewareStats, type GuardMode, type GuardResult, type GuardViolation, type GuardWrapResult, type HFPushOptions, type HFPushResult, type HapticPolicy, HolomimeCallbackHandler, type HolomimeCallbackOptions, HolomimeViolationError, type HubDetector, type ISOClause, type ISOStandard, type IndexComparison, type IndexEntry, type Intervention, type InterventionRepertoire, type InterventionSource, type InterviewCallbacks, type InterviewProbe, type InterviewResponse, type InterviewResult, type IterationResult, KNOWN_STANDARDS, type KimodoConstraint, type KimodoMotionRequest, type KimodoMotionStyle, type KnowledgeGraph, LEARNING_ORIENTATIONS, type LLMMessage, type LLMProvider, type LeaderboardEntry, type LeaderboardSubmission, type LearningOrientation, LocalMarketplaceBackend, type LogFormat, type MarketplaceAsset, type MarketplaceBackend, MarketplaceClient, type MarketplaceSearchQuery, type MarketplaceSearchResult, type Memory, MemoryLevel, type MemoryNode, type MemoryOperation, type MemoryOperations, type Message, type Mind, type Modality, type ModelConfig, ModelRouter, type MonitoringCertificate, type Morphology, type MotionParameters, type NetworkCallbacks, type NetworkConfig, type NetworkNode, type NetworkResult, type NetworkSession, NeuralActionGate, type SafetyEnvelope as NeuralSafetyEnvelope, type NodeType, OllamaProvider, OpenAIProvider, type OpenClawPluginApi, type OpenClawPluginConfig, type OutcomeReport, type OversightAction, type OversightMode, type OversightNotification, type OversightPolicy, PROVIDER_PARAMS, type PairingStrategy, type PatternCorrelation, type PatternDelta, type PatternReport, type PatternStatus, type PatternTracker, type PersonalitySpec, type PersonalityTier, type PhaseConfig, type PhysicalSafety, type PolicyIntent, type PreSessionDiagnosis, type Prescription, type Prosody, type Provider, type ProviderConfig, type ProxemicZone, type PublishRequest, type PublishedBenchmark, type Purpose, type QueryResult, type RLHFExample, type ReACTAction, type ReACTContext, type ReACTReport, type ReACTReportOptions, type ReACTStep$1 as ReACTStep, type Registry, type RegistryEntry, type ReportStatistics, type RetrievalStep, type RiskFinding, type RollingContext, STACK_FILES, STANDARD_PROBES, SURFACE_MULTIPLIERS, type SafetyEnvelope$1 as SafetyEnvelope, type SelfAuditFlag, type SelfAuditResult, type SelfObservation, type SessionCallbacks, type SessionLog, type SessionOptions, type SessionOutcome, type SessionSummary, type SessionTranscript, type SessionTurn, type Severity, type Shadow, type SharedIntervention, type SharedKnowledge, type SortField, type Soul, type StackCompileResult, type StackLayer, type StackSource, type StagingDiff, type Surface, type SyncAnchor, type SyncProfile, type SyncRule, THERAPIST_META_SPEC, THERAPY_DIMENSIONS, THERAPY_PHASES, type TherapistPromptOptions, type TherapyDimensions, type TherapyMemory, type TherapyPhase, type TieredPersonality, type TrainingExport, type TraitAlignment, type TraitScores, type TreatmentGoal, type TreatmentPlan, type TreatmentProgressReport, type VerifyResult, type WatchCallbacks, type WatchEvent, type WatchHandle, type WatchOptions, type WrapAgentOptions, type WrapOptions, type WrappedAgent, addEdge, addNode, addSessionToMemory, agentHandleFromSpec, appendAuditEntry, appendEvolution, applyMemoryOperations, applyRecommendations, bigFiveSchema, bodySchema, buildAgentTherapistPrompt, buildAnonymizedReport, buildMotionRequest, buildPatientSystemPrompt, buildReACTContext, buildReACTFraming, buildSharedKnowledge, buildTherapistSystemPrompt, checkApproval, checkCompliance, checkIterationBudget, communicationSchema, compactEvolutionRun, compactIteration, compareBenchmarks, compareIndex, compile, compileCustomDetector, compileEmbodied, compileForOpenClaw, compileL0, compileL1, compileL2, compileMemoryForPrompt, compileStack, compileTiered, compiledConfigSchema, compiledEmbodiedConfigSchema, computeDimensionScore, computeGazePolicy, computeMotionParameters, computeProsody, computeProxemics, computeSyncProfile, conscienceSchema, conversationLogSchema, conversationSchema, convertToHFFormat, copyToClipboard, corpusStats, createBehavioralMemory, createGist, createGraph, createGuardMiddleware, createIndex, createIndexEntry, createMemory, createProvider, createRepertoire, createTreatmentPlan, decayUnseenPatterns, decomposeSpec, deepMergeSpec, detectApologies, detectBoundaryIssues, detectFormalityIssues, detectHedging, detectRecoveryPatterns, detectRetrievalQuality, detectSentiment, detectVerbosity, discoverAgentData, discoverAgents, discoverNetworkAgents, domainSchema, egoSchema, embodimentSchema, emitBehavioralEvent, encodeSnapshot, estimateConfidence, evaluateConscienceGate, evaluateOutcome, expireOldEdges, exportTrainingData, expressionSchema, extractAlpacaExamples, extractDPOPairs, extractDPOPairsWithLLM, extractMemoryFromSession, extractRLHFExamples, extractRecommendations, fetchLeaderboard, fetchPersonality, fetchRegistry, filterByConfig, findCrossAgentCorrelations, findEdges, findNode, findNodesByType, findStackDir, formatComplianceReportMarkdown, formatGapSummary, formatPolicyYaml, formatReACTReportMarkdown, formatReportTerminal, gazePolicySchema, generateBehavioralPolicy, generateBenchmarkMarkdown, generateComparisonMarkdown, generateComplianceReport, generateCredential, generateGapRecommendation, generateIndexMarkdown, generateMonitoringCertificate, generateMotionConstraints, generateMutations, generatePrescriptions, generateProgressReport, generateReACTReport, generateReportJSON, generateShareUrl, generateSystemPrompt, gestureSchema, getAdversarialCategories, getAdversarialScenarios, getAgentBehaviors, getArchetype, getArchetypesByCategory, getBehavioralMemorySummary, getBenchmarkScenarios, getBestCorrection, getCategories, getDetector, getDimension, getEvolutionSummary, getInheritanceChain, getInterviewContext, getMarketplaceClient, getMemoryContext, getNeighbors, getPhaseContext, getPreset, getScenarioById, getTotalSignalCount, getTrajectory, getTriggersForPattern, graphStats, growthAreaSchema, growthSchema, hapticPolicySchema, hashSpec, injectConscienceRules, isStackDirectory, learnIntervention, listArchetypeIds, listDetectors, listDetectorsByCategory, listDetectorsByTag, listPresets, loadAllStandards, loadAuditLog, loadBehavioralMemory, loadBenchmarkResults, loadConscienceRules, loadCorpus, loadCustomDetectors, loadEvolution, loadFleetConfig, loadGraph, loadLatestBenchmark, loadMemory, loadNetworkConfig, loadRepertoire, loadSpec, loadSpecWithStack, loadStandard, loadTranscripts, loadTreatmentPlan, mapPersonalityToMotionStyle, memoryNodeSchema, memoryOperationSchema, memorySchema, mergeStores, messageSchema, mindSchema, modalitySchema, morphologySchema, motionParametersSchema, pairAgents, parseAnthropicAPILog, parseChatGPTExport, parseClaudeExport, parseConscienceRule, parseConversationLog, parseConversationLogFromString, parseJSONLLog, parseMarkdownDetector, parseOTelGenAIExport, parseOpenAIAPILog, personalitySpecSchema, physicalSafetySchema, populateFromDiagnosis, populateFromEvolve, populateFromSession, prescribeDPOPairs, processReACTResponse, prosodySchema, providerSchema, proxemicZoneSchema, publishToLeaderboard, purposeSchema, pushToHFHub, queryCorpus, queryInterventions, querySharedKnowledge, recommendTier as recommendMemoryTier, recommendTier$1 as recommendTier, recordInterventionOutcome, recordObservation, recordSelfObservation, recordSessionOutcome, registerBuiltInDetectors, registerDetector, register as registerOpenClawPlugin, resetMarketplaceClient, resolveInheritance, resolveOversight, retrievalStepSchema, retrieveMemory, runAdversarialSuite, runAssessment, runAutopilot, runBenchmark, runDiagnosis, runEvolve, runInterview, runNetwork, runPreSessionDiagnosis, runSelfAudit, runTherapySession, safetyEnvelopeSchema, saveBehavioralMemory, saveBenchmarkResult, saveCredential, saveGraph, saveMemory, saveRepertoire, saveTranscript, saveTreatmentPlan, scoreLabel, scoreTraitsFromMessages, seedBuiltInPersonalities, selectIntervention, severityMeetsThreshold, severitySchema, shadowSchema, shareAnonymizedPatterns, shareFromDiagnosis, soulFrontmatterSchema, soulSchema, startFleet, startMCPServer, startWatch, summarize, summarizeSessionForMemory, summarizeTherapy, surfaceSchema, syncAnchorSchema, syncProfileSchema, syncRuleSchema, therapyDimensionsSchema, therapyScoreLabel, transferIntervention, unregisterDetector, updateEdgeWeight, validateDetectorConfig, verifyAuditChain, verifyCredential, wrapAgent };
+/**
+ * Compiled Conscience Evaluator — zero-dependency, <1ms behavioral safety.
+ *
+ * Compiles conscience.exe YAML rules into a pure-logic decision tree
+ * that evaluates in microseconds. No LLM, no neural net, no network.
+ * Designed to run alongside a humanoid robot's 1kHz control loop.
+ *
+ * Target: <1ms p99 on standard hardware, <5ms on edge (Jetson Thor, Qualcomm).
+ * Footprint: <100KB compiled, zero external dependencies.
+ */
+interface CompiledRule {
+    action: string;
+    keywords: string[];
+    reason: string;
+    type: "deny" | "allow" | "escalate";
+}
+interface SafetyBounds {
+    maxSpeed?: number;
+    maxForce?: number;
+    minProximity?: number;
+    maxReach?: number;
+}
+interface ActionContext {
+    /** Action description or intent. */
+    action?: string;
+    /** Current speed in m/s. */
+    speed?: number;
+    /** Current contact force in N. */
+    force?: number;
+    /** Distance to nearest human in m. */
+    proximity?: number;
+    /** Reach distance in m. */
+    reach?: number;
+}
+interface EvalResult {
+    allowed: boolean;
+    decision: "allow" | "deny" | "escalate" | "clamp";
+    reason?: string;
+    ruleMatched?: string;
+    /** Evaluation time in microseconds. */
+    evalTimeUs?: number;
+}
+/**
+ * Ultra-fast conscience evaluator for edge deployment.
+ * Compiles rules once, evaluates in microseconds.
+ */
+declare class CompiledConscience {
+    private denyRules;
+    private allowRules;
+    private escalateRules;
+    private bounds;
+    private clampMode;
+    constructor(options?: {
+        rules?: {
+            deny?: Array<{
+                action: string;
+                reason?: string;
+            }>;
+            allow?: Array<{
+                action: string;
+                reason?: string;
+            }>;
+            escalate?: Array<{
+                trigger: string;
+                action?: string;
+            }>;
+        };
+        safetyBounds?: SafetyBounds;
+        /** If true, clamp instead of deny for boundary violations. */
+        clampMode?: boolean;
+    });
+    /**
+     * Evaluate an action against compiled conscience rules.
+     * Target: <1ms. Typically <0.1ms (100 microseconds).
+     */
+    evaluate(context: ActionContext): EvalResult;
+    /**
+     * Evaluate a batch of actions. For trajectory planning.
+     */
+    evaluateBatch(contexts: ActionContext[]): EvalResult[];
+    /**
+     * Get compiled rule count for size estimation.
+     */
+    getRuleCount(): {
+        deny: number;
+        allow: number;
+        escalate: number;
+        total: number;
+    };
+    /**
+     * Serialize to JSON for edge deployment.
+     * The serialized form can be loaded without YAML parsing.
+     */
+    serialize(): string;
+    /**
+     * Estimate memory footprint in bytes.
+     */
+    estimateSize(): number;
+    private result;
+}
+/**
+ * Compile a conscience.exe YAML config into a CompiledConscience.
+ * This is the "compilation" step — runs once in the cloud,
+ * deploys the result to edge.
+ */
+declare function compileConscience(conscienceConfig: {
+    rules?: {
+        deny?: Array<{
+            action: string;
+            reason?: string;
+        }>;
+        allow?: Array<{
+            action: string;
+            reason?: string;
+        }>;
+        escalate?: Array<{
+            trigger: string;
+            action?: string;
+        }>;
+    };
+    hard_limits?: string[];
+}, safetyEnvelope?: {
+    max_linear_speed_m_s?: number;
+    max_contact_force_n?: number;
+    min_proximity_m?: number;
+    max_reach_m?: number;
+}): CompiledConscience;
+
+/**
+ * holomime Edge Runtime — lightweight behavioral safety for robots.
+ *
+ * Zero dependencies. <200KB. <1ms evaluation.
+ * Runs alongside a humanoid robot's 1kHz control loop.
+ *
+ * Architecture:
+ *   Cloud (GPU/TPU)                    On-Robot (Jetson Thor / NPU)
+ *   ─────────────────                  ────────────────────────────
+ *   Train behavioral models      →     Distilled policy (this module)
+ *   Update personality profiles  →     Compiled constraint set
+ *   Drift detection analytics    →     Lightweight drift signal
+ *   DPO training loop            →     Inference only
+ *   Full ego-tracker analysis    →     Real-time ego snapshot
+ */
+
+interface ShadowSignal {
+    pattern: string;
+    score: number;
+    timestamp: string;
+}
+interface EdgeConfig {
+    syncIntervalMs: number;
+    offlineCapable: boolean;
+    shadowBufferSize: number;
+}
+declare class EdgeRuntime {
+    private conscience;
+    private shadowBuffer;
+    private config;
+    private evalTimes;
+    private stats;
+    constructor(options: {
+        conscienceConfig: {
+            rules?: {
+                deny?: Array<{
+                    action: string;
+                    reason?: string;
+                }>;
+                allow?: Array<{
+                    action: string;
+                    reason?: string;
+                }>;
+                escalate?: Array<{
+                    trigger: string;
+                    action?: string;
+                }>;
+            };
+            hard_limits?: string[];
+        };
+        safetyEnvelope?: {
+            max_linear_speed_m_s?: number;
+            max_contact_force_n?: number;
+            min_proximity_m?: number;
+            max_reach_m?: number;
+        };
+        config?: Partial<EdgeConfig>;
+    });
+    /**
+     * Evaluate an action. Hot path — must be <1ms.
+     */
+    evaluate(context: ActionContext): EvalResult;
+    /**
+     * Get latency benchmark results.
+     */
+    getLatencyStats(): {
+        p50Us: number;
+        p95Us: number;
+        p99Us: number;
+        avgUs: number;
+        totalEvaluations: number;
+    };
+    /** Get pending shadow signals for cloud sync. */
+    drainShadowBuffer(): ShadowSignal[];
+    /** Apply updated conscience rules from cloud. */
+    updateConscience(conscienceConfig: Parameters<typeof compileConscience>[0], safetyEnvelope?: Parameters<typeof compileConscience>[1]): void;
+    /** Get runtime stats. */
+    getStats(): {
+        shadowBuffered: number;
+        memoryBytes: number;
+        totalEvaluations: number;
+        denials: number;
+        clamps: number;
+        escalations: number;
+    };
+    private bufferShadowSignal;
+}
+
+export { ARCHETYPES, ATTACHMENT_STYLES, type ActionContext$1 as ActionContext, type ActionEvaluation, type AdversarialCallbacks, type AdversarialCategory, type AdversarialReport, type AdversarialResult, type AdversarialRunOptions, type AdversarialScenario, type AgentSpawnConfig, type AlpacaExample, type AnonymizedPatternReport, AnthropicProvider, type ArchetypeTemplate, type AssessmentReport, type AssessmentResult, type AssetReview, type AssetType, type AttachmentStyle, type AuditEntry, type AuditEventType, type AutopilotResult, type AutopilotThreshold, type AwarenessDimension, BUILT_IN_DETECTORS, type BehavioralBaseline, type BehavioralCredential, type BehavioralEvent, type BehavioralEventType, type BehavioralGap, type BehavioralIndex, type BehavioralMemoryStore, type BehavioralPolicy, type BehavioralPolicyRule, type BehavioralPreset, type BehavioralQuery, type BenchmarkCallbacks, type BenchmarkComparison, type BenchmarkReport, type BenchmarkResult, type BenchmarkScenario, type BigFive, type Body, CATEGORIES, type CallbackMode, type CallbackStats, type CallbackViolation, type CertifyInput, type ClauseStatus, type Communication, type CompactionResult, type CompactionSummary, type CompileInput, type CompiledConfig, CompiledConscience, type CompiledEmbodiedConfig, type CompiledRule, type ComplianceCoverageReport, type ReACTStep as ComplianceReACTStep, type ComplianceReport, type ComplianceReportJSON, type Conscience, type ConscienceConfig, type ConscienceDenyRule, type ConscienceGateResult, type ConscienceRule, type ContextLayerInput, type Conversation, type ConversationLog, type CorpusFilter, type CorpusStats, type CorrectionRecord, type CrossAgentQuery, type CustomDetectorConfig, DEFAULT_MODEL_CONFIG, DEFAULT_OVERSIGHT, DIMENSIONS, type DPOPair, type DetectedPattern, type DetectorFactory, type DetectorFn$1 as DetectorFn, type DetectorOptions, type DiagnosisResult, type DimensionTrajectory, type Domain, type DriftTrigger, type ActionContext as EdgeActionContext, type EdgeConfig, type EvalResult as EdgeEvalResult, EdgeRuntime, type EdgeType, type Ego, type EgoAdjustment, EgoTracker, type EgoTrackerStats, type Embodiment, type EvolutionEntry, type EvolutionHistory, type EvolutionSummary, type EvolveCallbacks, type EvolveOptions, type EvolveResult, type Expression, type ExtractionResult, type FleetAgent, type FleetAgentStatus, type FleetConfig, type FleetHandle, type FleetOptions, type FrameworkSection, type GateStats, type GazePolicy, type Gesture, type GraphEdge, type GraphNode, type Growth, type GrowthArea, type GrowthReport, type GrowthSnapshot, Guard, type GuardEntry, type GuardFilterResult, type GuardMiddleware, type GuardMiddlewareOptions, type GuardMiddlewareStats, type GuardMode, type GuardResult, type GuardViolation, type GuardWrapResult, type HFPushOptions, type HFPushResult, type HapticPolicy, HolomimeCallbackHandler, type HolomimeCallbackOptions, HolomimeViolationError, type HubDetector, type ISOClause, type ISOStandard, type IndexComparison, type IndexEntry, type Intervention, type InterventionRepertoire, type InterventionSource, type InterviewCallbacks, type InterviewProbe, type InterviewResponse, type InterviewResult, type IterationResult, KNOWN_STANDARDS, type KimodoConstraint, type KimodoMotionRequest, type KimodoMotionStyle, type KnowledgeGraph, LEARNING_ORIENTATIONS, type LLMMessage, type LLMProvider, type LeaderboardEntry, type LeaderboardSubmission, type LearningOrientation, LocalMarketplaceBackend, type LogFormat, type MarketplaceAsset, type MarketplaceBackend, MarketplaceClient, type MarketplaceSearchQuery, type MarketplaceSearchResult, type Memory, MemoryLevel, type MemoryNode, type MemoryOperation, type MemoryOperations, type Message, type Mind, type Modality, type ModelConfig, ModelRouter, type MonitoringCertificate, type Morphology, type MotionParameters, type NetworkCallbacks, type NetworkConfig, type NetworkNode, type NetworkResult, type NetworkSession, NeuralActionGate, type SafetyEnvelope as NeuralSafetyEnvelope, type NodeType, OllamaProvider, OpenAIProvider, type OpenClawPluginApi, type OpenClawPluginConfig, type OutcomeReport, type OversightAction, type OversightMode, type OversightNotification, type OversightPolicy, PROVIDER_PARAMS, type PairingStrategy, type PatternCorrelation, type PatternDelta, type PatternReport, type PatternStatus, type PatternTracker, type PersonalitySpec, type PersonalityTier, type PhaseConfig, type PhysicalSafety, type PolicyIntent, type PreSessionDiagnosis, type Prescription, type Prosody, type Provider, type ProviderConfig, type ProxemicZone, type PublishRequest, type PublishedBenchmark, type Purpose, type QueryResult, type RLHFExample, type ReACTAction, type ReACTContext, type ReACTReport, type ReACTReportOptions, type ReACTStep$1 as ReACTStep, type Registry, type RegistryEntry, type ReportStatistics, type RetrievalStep, type RiskFinding, type RollingContext, STACK_FILES, STANDARD_PROBES, SURFACE_MULTIPLIERS, type SafetyBounds, type SafetyEnvelope$1 as SafetyEnvelope, type SelfAuditFlag, type SelfAuditResult, type SelfObservation, type SessionCallbacks, type SessionLog, type SessionOptions, type SessionOutcome, type SessionSummary, type SessionTranscript, type SessionTurn, type Severity, type Shadow, type ShadowSignal, type SharedIntervention, type SharedKnowledge, type SortField, type Soul, type StackCompileResult, type StackLayer, type StackSource, type StagingDiff, type Surface, type SyncAnchor, type SyncProfile, type SyncRule, THERAPIST_META_SPEC, THERAPY_DIMENSIONS, THERAPY_PHASES, type TherapistPromptOptions, type TherapyDimensions, type TherapyMemory, type TherapyPhase, type TieredPersonality, type TrainingExport, type TraitAlignment, type TraitScores, type TreatmentGoal, type TreatmentPlan, type TreatmentProgressReport, type VerifyResult, type WatchCallbacks, type WatchEvent, type WatchHandle, type WatchOptions, type WrapAgentOptions, type WrapOptions, type WrappedAgent, addEdge, addNode, addSessionToMemory, agentHandleFromSpec, appendAuditEntry, appendEvolution, applyMemoryOperations, applyRecommendations, bigFiveSchema, bodySchema, buildAgentTherapistPrompt, buildAnonymizedReport, buildMotionRequest, buildPatientSystemPrompt, buildReACTContext, buildReACTFraming, buildSharedKnowledge, buildTherapistSystemPrompt, checkApproval, checkCompliance, checkIterationBudget, communicationSchema, compactEvolutionRun, compactIteration, compareBenchmarks, compareIndex, compile, compileConscience, compileCustomDetector, compileEmbodied, compileForOpenClaw, compileL0, compileL1, compileL2, compileMemoryForPrompt, compileStack, compileTiered, compiledConfigSchema, compiledEmbodiedConfigSchema, computeDimensionScore, computeGazePolicy, computeMotionParameters, computeProsody, computeProxemics, computeSyncProfile, conscienceSchema, conversationLogSchema, conversationSchema, convertToHFFormat, copyToClipboard, corpusStats, createBehavioralMemory, createGist, createGraph, createGuardMiddleware, createIndex, createIndexEntry, createMemory, createProvider, createRepertoire, createTreatmentPlan, decayUnseenPatterns, decomposeSpec, deepMergeSpec, detectApologies, detectBoundaryIssues, detectFormalityIssues, detectHedging, detectRecoveryPatterns, detectRetrievalQuality, detectSentiment, detectVerbosity, discoverAgentData, discoverAgents, discoverNetworkAgents, domainSchema, egoSchema, embodimentSchema, emitBehavioralEvent, encodeSnapshot, estimateConfidence, evaluateConscienceGate, evaluateOutcome, expireOldEdges, exportTrainingData, expressionSchema, extractAlpacaExamples, extractDPOPairs, extractDPOPairsWithLLM, extractMemoryFromSession, extractRLHFExamples, extractRecommendations, fetchLeaderboard, fetchPersonality, fetchRegistry, filterByConfig, findCrossAgentCorrelations, findEdges, findNode, findNodesByType, findStackDir, formatComplianceReportMarkdown, formatGapSummary, formatPolicyYaml, formatReACTReportMarkdown, formatReportTerminal, gazePolicySchema, generateBehavioralPolicy, generateBenchmarkMarkdown, generateComparisonMarkdown, generateComplianceReport, generateCredential, generateGapRecommendation, generateIndexMarkdown, generateMonitoringCertificate, generateMotionConstraints, generateMutations, generatePrescriptions, generateProgressReport, generateReACTReport, generateReportJSON, generateShareUrl, generateSystemPrompt, gestureSchema, getAdversarialCategories, getAdversarialScenarios, getAgentBehaviors, getArchetype, getArchetypesByCategory, getBehavioralMemorySummary, getBenchmarkScenarios, getBestCorrection, getCategories, getDetector, getDimension, getEvolutionSummary, getInheritanceChain, getInterviewContext, getMarketplaceClient, getMemoryContext, getNeighbors, getPhaseContext, getPreset, getScenarioById, getTotalSignalCount, getTrajectory, getTriggersForPattern, graphStats, growthAreaSchema, growthSchema, hapticPolicySchema, hashSpec, injectConscienceRules, isStackDirectory, learnIntervention, listArchetypeIds, listDetectors, listDetectorsByCategory, listDetectorsByTag, listPresets, loadAllStandards, loadAuditLog, loadBehavioralMemory, loadBenchmarkResults, loadConscienceRules, loadCorpus, loadCustomDetectors, loadEvolution, loadFleetConfig, loadGraph, loadLatestBenchmark, loadMemory, loadNetworkConfig, loadRepertoire, loadSpec, loadSpecWithStack, loadStandard, loadTranscripts, loadTreatmentPlan, mapPersonalityToMotionStyle, memoryNodeSchema, memoryOperationSchema, memorySchema, mergeStores, messageSchema, mindSchema, modalitySchema, morphologySchema, motionParametersSchema, pairAgents, parseAnthropicAPILog, parseChatGPTExport, parseClaudeExport, parseConscienceRule, parseConversationLog, parseConversationLogFromString, parseJSONLLog, parseMarkdownDetector, parseOTelGenAIExport, parseOpenAIAPILog, personalitySpecSchema, physicalSafetySchema, populateFromDiagnosis, populateFromEvolve, populateFromSession, prescribeDPOPairs, processReACTResponse, prosodySchema, providerSchema, proxemicZoneSchema, publishToLeaderboard, purposeSchema, pushToHFHub, queryCorpus, queryInterventions, querySharedKnowledge, recommendTier as recommendMemoryTier, recommendTier$1 as recommendTier, recordInterventionOutcome, recordObservation, recordSelfObservation, recordSessionOutcome, registerBuiltInDetectors, registerDetector, register as registerOpenClawPlugin, resetMarketplaceClient, resolveInheritance, resolveOversight, retrievalStepSchema, retrieveMemory, runAdversarialSuite, runAssessment, runAutopilot, runBenchmark, runDiagnosis, runEvolve, runInterview, runNetwork, runPreSessionDiagnosis, runSelfAudit, runTherapySession, safetyEnvelopeSchema, saveBehavioralMemory, saveBenchmarkResult, saveCredential, saveGraph, saveMemory, saveRepertoire, saveTranscript, saveTreatmentPlan, scoreLabel, scoreTraitsFromMessages, seedBuiltInPersonalities, selectIntervention, severityMeetsThreshold, severitySchema, shadowSchema, shareAnonymizedPatterns, shareFromDiagnosis, soulFrontmatterSchema, soulSchema, startFleet, startMCPServer, startWatch, summarize, summarizeSessionForMemory, summarizeTherapy, surfaceSchema, syncAnchorSchema, syncProfileSchema, syncRuleSchema, therapyDimensionsSchema, therapyScoreLabel, transferIntervention, unregisterDetector, updateEdgeWeight, validateDetectorConfig, verifyAuditChain, verifyCredential, wrapAgent };

package/dist/index.js

@@ -14166,15 +14166,246 @@ var EgoTracker = class {
     };
   }
 };
+
+// src/edge/conscience-evaluator.ts
+var CompiledConscience = class {
+  denyRules;
+  allowRules;
+  escalateRules;
+  bounds;
+  clampMode;
+  constructor(options = {}) {
+    this.denyRules = (options.rules?.deny ?? []).map((r) => ({
+      action: r.action,
+      keywords: r.action.toLowerCase().split(/[\s_-]+/),
+      reason: r.reason ?? r.action,
+      type: "deny"
+    }));
+    this.allowRules = (options.rules?.allow ?? []).map((r) => ({
+      action: r.action,
+      keywords: r.action.toLowerCase().split(/[\s_-]+/),
+      reason: r.reason ?? r.action,
+      type: "allow"
+    }));
+    this.escalateRules = (options.rules?.escalate ?? []).map((r) => ({
+      action: r.trigger,
+      keywords: r.trigger.toLowerCase().split(/[\s_-]+/),
+      reason: r.action ?? r.trigger,
+      type: "escalate"
+    }));
+    this.bounds = options.safetyBounds ?? {};
+    this.clampMode = options.clampMode ?? true;
+  }
+  /**
+   * Evaluate an action against compiled conscience rules.
+   * Target: <1ms. Typically <0.1ms (100 microseconds).
+   */
+  evaluate(context) {
+    const start = performance.now();
+    if (context.action) {
+      const actionLower = context.action.toLowerCase();
+      for (const rule of this.denyRules) {
+        if (rule.keywords.some((kw) => actionLower.includes(kw))) {
+          return this.result("deny", rule.reason, rule.action, start);
+        }
+      }
+    }
+    if (this.bounds.maxSpeed !== void 0 && context.speed !== void 0) {
+      if (context.speed > this.bounds.maxSpeed) {
+        if (this.clampMode) {
+          return this.result("clamp", `Speed ${context.speed}m/s exceeds ${this.bounds.maxSpeed}m/s`, "safety_speed", start);
+        }
+        return this.result("deny", `Speed ${context.speed}m/s exceeds ${this.bounds.maxSpeed}m/s`, "safety_speed", start);
+      }
+    }
+    if (this.bounds.maxForce !== void 0 && context.force !== void 0) {
+      if (context.force > this.bounds.maxForce) {
+        if (this.clampMode) {
+          return this.result("clamp", `Force ${context.force}N exceeds ${this.bounds.maxForce}N`, "safety_force", start);
+        }
+        return this.result("deny", `Force ${context.force}N exceeds ${this.bounds.maxForce}N`, "safety_force", start);
+      }
+    }
+    if (this.bounds.minProximity !== void 0 && context.proximity !== void 0) {
+      if (context.proximity < this.bounds.minProximity) {
+        return this.result("deny", `Proximity ${context.proximity}m below ${this.bounds.minProximity}m minimum`, "safety_proximity", start);
+      }
+    }
+    if (context.action) {
+      const actionLower = context.action.toLowerCase();
+      for (const rule of this.escalateRules) {
+        if (rule.keywords.some((kw) => actionLower.includes(kw))) {
+          return this.result("escalate", rule.reason, rule.action, start);
+        }
+      }
+    }
+    return this.result("allow", void 0, void 0, start);
+  }
+  /**
+   * Evaluate a batch of actions. For trajectory planning.
+   */
+  evaluateBatch(contexts) {
+    return contexts.map((ctx) => this.evaluate(ctx));
+  }
+  /**
+   * Get compiled rule count for size estimation.
+   */
+  getRuleCount() {
+    return {
+      deny: this.denyRules.length,
+      allow: this.allowRules.length,
+      escalate: this.escalateRules.length,
+      total: this.denyRules.length + this.allowRules.length + this.escalateRules.length
+    };
+  }
+  /**
+   * Serialize to JSON for edge deployment.
+   * The serialized form can be loaded without YAML parsing.
+   */
+  serialize() {
+    return JSON.stringify({
+      denyRules: this.denyRules,
+      allowRules: this.allowRules,
+      escalateRules: this.escalateRules,
+      bounds: this.bounds,
+      clampMode: this.clampMode
+    });
+  }
+  /**
+   * Estimate memory footprint in bytes.
+   */
+  estimateSize() {
+    return Buffer.byteLength(this.serialize(), "utf-8");
+  }
+  // ── Private ─────────────────────────────────────────────────
+  result(decision, reason, ruleMatched, startTime) {
+    const evalTimeUs = Math.round((performance.now() - startTime) * 1e3);
+    return {
+      allowed: decision === "allow" || decision === "clamp",
+      decision,
+      reason,
+      ruleMatched,
+      evalTimeUs
+    };
+  }
+};
+function compileConscience(conscienceConfig, safetyEnvelope) {
+  const denyRules = [
+    ...conscienceConfig.rules?.deny ?? [],
+    ...(conscienceConfig.hard_limits ?? []).map((limit) => ({
+      action: limit,
+      reason: `Hard limit: ${limit}`
+    }))
+  ];
+  return new CompiledConscience({
+    rules: {
+      deny: denyRules,
+      allow: conscienceConfig.rules?.allow,
+      escalate: conscienceConfig.rules?.escalate
+    },
+    safetyBounds: safetyEnvelope ? {
+      maxSpeed: safetyEnvelope.max_linear_speed_m_s,
+      maxForce: safetyEnvelope.max_contact_force_n,
+      minProximity: safetyEnvelope.min_proximity_m,
+      maxReach: safetyEnvelope.max_reach_m
+    } : void 0
+  });
+}
+
+// src/edge/edge-runtime.ts
+var EdgeRuntime = class {
+  conscience;
+  shadowBuffer;
+  config;
+  evalTimes;
+  stats;
+  constructor(options) {
+    this.conscience = compileConscience(options.conscienceConfig, options.safetyEnvelope);
+    this.shadowBuffer = [];
+    this.evalTimes = [];
+    this.config = {
+      syncIntervalMs: options.config?.syncIntervalMs ?? 6e4,
+      offlineCapable: options.config?.offlineCapable ?? true,
+      shadowBufferSize: options.config?.shadowBufferSize ?? 100
+    };
+    this.stats = { totalEvaluations: 0, denials: 0, clamps: 0, escalations: 0 };
+  }
+  /**
+   * Evaluate an action. Hot path — must be <1ms.
+   */
+  evaluate(context) {
+    const result = this.conscience.evaluate(context);
+    this.stats.totalEvaluations++;
+    if (result.decision === "deny") this.stats.denials++;
+    if (result.decision === "clamp") this.stats.clamps++;
+    if (result.decision === "escalate") this.stats.escalations++;
+    if (result.evalTimeUs !== void 0) {
+      this.evalTimes.push(result.evalTimeUs);
+      if (this.evalTimes.length > 1e3) this.evalTimes.shift();
+    }
+    if (result.decision === "deny" || result.decision === "escalate") {
+      this.bufferShadowSignal({
+        pattern: result.ruleMatched ?? result.decision,
+        score: result.decision === "deny" ? 1 : 0.7,
+        timestamp: (/* @__PURE__ */ new Date()).toISOString()
+      });
+    }
+    return result;
+  }
+  /**
+   * Get latency benchmark results.
+   */
+  getLatencyStats() {
+    if (this.evalTimes.length === 0) {
+      return { p50Us: 0, p95Us: 0, p99Us: 0, avgUs: 0, totalEvaluations: 0 };
+    }
+    const sorted = [...this.evalTimes].sort((a, b) => a - b);
+    const len = sorted.length;
+    const avg = sorted.reduce((a, b) => a + b, 0) / len;
+    return {
+      p50Us: sorted[Math.floor(len * 0.5)],
+      p95Us: sorted[Math.floor(len * 0.95)],
+      p99Us: sorted[Math.floor(len * 0.99)],
+      avgUs: Math.round(avg),
+      totalEvaluations: this.stats.totalEvaluations
+    };
+  }
+  /** Get pending shadow signals for cloud sync. */
+  drainShadowBuffer() {
+    const signals = [...this.shadowBuffer];
+    this.shadowBuffer = [];
+    return signals;
+  }
+  /** Apply updated conscience rules from cloud. */
+  updateConscience(conscienceConfig, safetyEnvelope) {
+    this.conscience = compileConscience(conscienceConfig, safetyEnvelope);
+  }
+  /** Get runtime stats. */
+  getStats() {
+    return {
+      ...this.stats,
+      shadowBuffered: this.shadowBuffer.length,
+      memoryBytes: this.conscience.estimateSize()
+    };
+  }
+  bufferShadowSignal(signal) {
+    this.shadowBuffer.push(signal);
+    if (this.shadowBuffer.length > this.config.shadowBufferSize) {
+      this.shadowBuffer.shift();
+    }
+  }
+};
 export {
   ARCHETYPES,
   ATTACHMENT_STYLES,
   AnthropicProvider,
   BUILT_IN_DETECTORS,
   CATEGORIES,
+  CompiledConscience,
   DEFAULT_MODEL_CONFIG,
   DEFAULT_OVERSIGHT,
   DIMENSIONS,
+  EdgeRuntime,
   EgoTracker,
   Guard,
   HolomimeCallbackHandler,
@@ -14222,6 +14453,7 @@ export {
   compareBenchmarks,
   compareIndex,
   compile,
+  compileConscience,
   compileCustomDetector,
   compileEmbodied,
   compileForOpenClaw,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "holomime",
-  "version": "2.7.0",
+  "version": "3.0.0",
   "description": "Behavioral therapy infrastructure for AI agents — Big Five psychology, structured treatment, behavioral alignment",
   "type": "module",
   "bin": {