holomime 1.8.0 → 1.9.0

package/dist/index.d.ts

@@ -4792,6 +4792,63 @@ declare function generateIndexMarkdown(index: BehavioralIndex): string;
  */
 declare function startMCPServer(): Promise<void>;
 
+/**
+ * Types for the HoloMime Live real-time behavioral monitoring system.
+ */
+interface BrainRegionState {
+    id: string;
+    name: string;
+    function: string;
+    color: string;
+    intensity: number;
+    patterns: string[];
+}
+interface FiredPattern {
+    id: string;
+    name: string;
+    severity: "info" | "warning" | "concern";
+    percentage: number;
+    description: string;
+}
+interface BrainEvent {
+    type: "diagnosis";
+    timestamp: string;
+    health: number;
+    grade: string;
+    messageCount: number;
+    regions: BrainRegionState[];
+    patterns: FiredPattern[];
+    activity: {
+        role: "user" | "assistant";
+        preview: string;
+    } | null;
+}
+
+/**
+ * Snapshot encoding and share URL generation.
+ * Used by brain command, diagnose command, and benchmark command
+ * to generate shareable brain visualization URLs.
+ */
+
+/**
+ * Compress a BrainEvent into a compact base64url-encoded string for sharing.
+ */
+declare function encodeSnapshot(event: BrainEvent, agentName: string): string;
+/**
+ * Generate a share URL from a DiagnosisResult.
+ * Converts diagnosis → BrainEvent → compressed snapshot → URL.
+ */
+declare function generateShareUrl(diagnosis: DiagnosisResult, agentName?: string): string;
+/**
+ * Copy text to system clipboard. Silent fail on unsupported platforms.
+ */
+declare function copyToClipboard(text: string): boolean;
+/**
+ * Generate and print a share URL from a DiagnosisResult.
+ * Convenience function that combines generation + clipboard + display.
+ */
+declare function shareFromDiagnosis(diagnosis: DiagnosisResult, agentName?: string): void;
+
 /**
  * Oversight — human gating controls for autonomous operations.
  *
@@ -5895,4 +5952,116 @@ declare function listPresets(): BehavioralPreset[];
  */
 declare function getPreset(key: string): BehavioralPreset | undefined;
 
-export { ARCHETYPES, ATTACHMENT_STYLES, type AdversarialCallbacks, type AdversarialCategory, type AdversarialReport, type AdversarialResult, type AdversarialRunOptions, type AdversarialScenario, 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 BenchmarkCallbacks, type BenchmarkComparison, type BenchmarkReport, type BenchmarkResult, type BenchmarkScenario, type BigFive, CATEGORIES, type CertifyInput, type Communication, type CompactionResult, type CompactionSummary, type CompileInput, type CompiledConfig, type CompiledEmbodiedConfig, type ReACTStep as ComplianceReACTStep, type ComplianceReport, type ContextLayerInput, type Conversation, type ConversationLog, type CorpusFilter, type CorpusStats, type CorrectionRecord, type CrossAgentQuery, type CustomDetectorConfig, 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 Embodiment, type EvolutionEntry, type EvolutionHistory, type EvolutionSummary, type EvolveCallbacks, type EvolveOptions, type EvolveResult, type Expression, type FleetAgent, type FleetAgentStatus, type FleetConfig, type FleetHandle, type FleetOptions, type FrameworkSection, 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, type HubDetector, type IndexComparison, type IndexEntry, type Intervention, type InterventionRepertoire, type InterventionSource, type InterviewCallbacks, type InterviewProbe, type InterviewResponse, type InterviewResult, type IterationResult, 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 Message, type Modality, type MonitoringCertificate, type Morphology, type MotionParameters, type NetworkCallbacks, type NetworkConfig, type NetworkNode, type NetworkResult, type NetworkSession, type NodeType, OllamaProvider, OpenAIProvider, 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 RLHFExample, type ReACTAction, type ReACTContext, type ReACTReport, type ReACTReportOptions, type ReACTStep$1 as ReACTStep, type Registry, type RegistryEntry, type ReportStatistics, type RiskFinding, type RollingContext, STANDARD_PROBES, SURFACE_MULTIPLIERS, type SafetyEnvelope, type SelfAuditFlag, type SelfAuditResult, type SelfObservation, type SessionCallbacks, type SessionOptions, type SessionOutcome, type SessionSummary, type SessionTranscript, type SessionTurn, type Severity, type SharedIntervention, type SharedKnowledge, type SortField, 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, applyRecommendations, bigFiveSchema, buildAgentTherapistPrompt, buildAnonymizedReport, buildPatientSystemPrompt, buildReACTContext, buildReACTFraming, buildSharedKnowledge, buildTherapistSystemPrompt, checkApproval, checkIterationBudget, communicationSchema, compactEvolutionRun, compactIteration, compareBenchmarks, compareIndex, compile, compileCustomDetector, compileEmbodied, compileForOpenClaw, compileL0, compileL1, compileL2, compileTiered, compiledConfigSchema, compiledEmbodiedConfigSchema, computeDimensionScore, computeGazePolicy, computeMotionParameters, computeProsody, computeProxemics, computeSyncProfile, conversationLogSchema, conversationSchema, convertToHFFormat, corpusStats, createBehavioralMemory, createGist, createGraph, createGuardMiddleware, createIndex, createIndexEntry, createMemory, createProvider, createRepertoire, createTreatmentPlan, decayUnseenPatterns, deepMergeSpec, detectApologies, detectBoundaryIssues, detectFormalityIssues, detectHedging, detectRecoveryPatterns, detectRetrievalQuality, detectSentiment, detectVerbosity, discoverAgentData, discoverAgents, discoverNetworkAgents, domainSchema, embodimentSchema, emitBehavioralEvent, estimateConfidence, evaluateOutcome, expireOldEdges, exportTrainingData, expressionSchema, extractAlpacaExamples, extractDPOPairs, extractDPOPairsWithLLM, extractRLHFExamples, extractRecommendations, fetchLeaderboard, fetchPersonality, fetchRegistry, findCrossAgentCorrelations, findEdges, findNode, findNodesByType, formatComplianceReportMarkdown, formatGapSummary, formatPolicyYaml, formatReACTReportMarkdown, gazePolicySchema, generateBehavioralPolicy, generateBenchmarkMarkdown, generateComparisonMarkdown, generateComplianceReport, generateCredential, generateGapRecommendation, generateIndexMarkdown, generateMonitoringCertificate, generateMutations, generatePrescriptions, generateProgressReport, generateReACTReport, 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, learnIntervention, listArchetypeIds, listDetectors, listDetectorsByCategory, listDetectorsByTag, listPresets, loadAuditLog, loadBehavioralMemory, loadBenchmarkResults, loadCorpus, loadCustomDetectors, loadEvolution, loadFleetConfig, loadGraph, loadLatestBenchmark, loadMemory, loadNetworkConfig, loadRepertoire, loadSpec, loadTranscripts, loadTreatmentPlan, mergeStores, messageSchema, modalitySchema, morphologySchema, motionParametersSchema, pairAgents, parseAnthropicAPILog, parseChatGPTExport, parseClaudeExport, parseConversationLog, parseConversationLogFromString, parseJSONLLog, parseMarkdownDetector, parseOTelGenAIExport, parseOpenAIAPILog, personalitySpecSchema, physicalSafetySchema, populateFromDiagnosis, populateFromEvolve, populateFromSession, prescribeDPOPairs, processReACTResponse, prosodySchema, providerSchema, proxemicZoneSchema, publishToLeaderboard, pushToHFHub, queryCorpus, queryInterventions, querySharedKnowledge, recommendTier, recordInterventionOutcome, recordObservation, recordSelfObservation, recordSessionOutcome, registerBuiltInDetectors, registerDetector, resetMarketplaceClient, resolveInheritance, resolveOversight, 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, shareAnonymizedPatterns, startFleet, startMCPServer, startWatch, summarize, summarizeSessionForMemory, summarizeTherapy, surfaceSchema, syncAnchorSchema, syncProfileSchema, syncRuleSchema, therapyDimensionsSchema, therapyScoreLabel, transferIntervention, unregisterDetector, updateEdgeWeight, validateDetectorConfig, verifyAuditChain, verifyCredential, wrapAgent };
+/**
+ * LangChain / CrewAI / LlamaIndex Callback Handler
+ *
+ * Monitors LLM responses in real-time and detects behavioral anti-patterns.
+ * Works with any LangChain-compatible framework that supports callback handlers.
+ *
+ * Usage:
+ *   import { HolomimeCallbackHandler } from "holomime/integrations/langchain";
+ *
+ *   const handler = new HolomimeCallbackHandler({
+ *     mode: "monitor",     // "monitor" | "enforce" | "strict"
+ *     personality: ".personality.json",
+ *     onViolation: (v) => console.warn("Behavioral drift:", v),
+ *   });
+ *
+ *   // LangChain
+ *   const chain = prompt.pipe(model).pipe(parser);
+ *   await chain.invoke({ input: "hello" }, { callbacks: [handler] });
+ *
+ *   // CrewAI — pass as LangChain callback on the underlying LLM
+ *   // LlamaIndex — use as a callback handler on the LLM
+ */
+
+type CallbackMode = "monitor" | "enforce" | "strict";
+interface CallbackViolation {
+    patterns: DetectedPattern[];
+    severity: "warning" | "concern";
+    response: string;
+    runId?: string;
+    timestamp: string;
+}
+interface HolomimeCallbackOptions {
+    /** Guard mode. Default: "monitor". */
+    mode?: CallbackMode;
+    /** Path to .personality.json or inline spec object. */
+    personality?: string | object;
+    /** Minimum severity to trigger. Default: "warning". */
+    minSeverity?: "warning" | "concern";
+    /** Callback fired on every violation. */
+    onViolation?: (violation: CallbackViolation) => void;
+    /** Agent name for reports. Default: "langchain-agent". */
+    name?: string;
+    /** Buffer size — number of messages to retain for context. Default: 50. */
+    bufferSize?: number;
+}
+interface CallbackStats {
+    totalResponses: number;
+    passed: number;
+    violated: number;
+    blocked: number;
+    patternCounts: Record<string, number>;
+}
+/**
+ * HolomimeCallbackHandler — behavioral alignment monitor for LangChain-compatible frameworks.
+ *
+ * Implements the LangChain BaseCallbackHandler interface without importing langchain,
+ * keeping it as an optional peer dependency. Works with LangChain, CrewAI, and any
+ * framework that accepts { handleLLMEnd, handleLLMStart, handleLLMError } callbacks.
+ */
+declare class HolomimeCallbackHandler {
+    readonly name = "holomime";
+    readonly lc_serializable = false;
+    private guard;
+    private mode;
+    private minSeverity;
+    private onViolation?;
+    private messageBuffer;
+    private bufferSize;
+    private currentRunMessages;
+    private _stats;
+    constructor(options?: HolomimeCallbackOptions);
+    /**
+     * Called when an LLM starts generating.
+     * Captures the input messages for context.
+     */
+    handleLLMStart(_llm: any, prompts: string[], runId?: string): void;
+    /**
+     * Called when an LLM finishes generating.
+     * Runs behavioral analysis on the response.
+     */
+    handleLLMEnd(output: any, runId?: string): void;
+    /**
+     * Called on LLM errors. Clean up run tracking.
+     */
+    handleLLMError(_error: any, runId?: string): void;
+    /**
+     * Called when a chain starts. Captures input for context.
+     */
+    handleChainStart(_chain: any, inputs: Record<string, any>, runId?: string): void;
+    /**
+     * Get cumulative stats.
+     */
+    stats(): CallbackStats;
+    /**
+     * Reset the message buffer and stats.
+     */
+    reset(): void;
+    /**
+     * Get the current guard result for the buffered conversation.
+     */
+    diagnose(): GuardResult;
+    private severityMeetsMin;
+    private extractResponseText;
+}
+/**
+ * Error thrown in strict mode when a concern-level violation is detected.
+ */
+declare class HolomimeViolationError extends Error {
+    readonly violation: CallbackViolation;
+    constructor(violation: CallbackViolation);
+}
+
+export { ARCHETYPES, ATTACHMENT_STYLES, type AdversarialCallbacks, type AdversarialCategory, type AdversarialReport, type AdversarialResult, type AdversarialRunOptions, type AdversarialScenario, 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 BenchmarkCallbacks, type BenchmarkComparison, type BenchmarkReport, type BenchmarkResult, type BenchmarkScenario, type BigFive, CATEGORIES, type CallbackMode, type CallbackStats, type CallbackViolation, type CertifyInput, type Communication, type CompactionResult, type CompactionSummary, type CompileInput, type CompiledConfig, type CompiledEmbodiedConfig, type ReACTStep as ComplianceReACTStep, type ComplianceReport, type ContextLayerInput, type Conversation, type ConversationLog, type CorpusFilter, type CorpusStats, type CorrectionRecord, type CrossAgentQuery, type CustomDetectorConfig, 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 Embodiment, type EvolutionEntry, type EvolutionHistory, type EvolutionSummary, type EvolveCallbacks, type EvolveOptions, type EvolveResult, type Expression, type FleetAgent, type FleetAgentStatus, type FleetConfig, type FleetHandle, type FleetOptions, type FrameworkSection, 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 IndexComparison, type IndexEntry, type Intervention, type InterventionRepertoire, type InterventionSource, type InterviewCallbacks, type InterviewProbe, type InterviewResponse, type InterviewResult, type IterationResult, 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 Message, type Modality, type MonitoringCertificate, type Morphology, type MotionParameters, type NetworkCallbacks, type NetworkConfig, type NetworkNode, type NetworkResult, type NetworkSession, type NodeType, OllamaProvider, OpenAIProvider, 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 RLHFExample, type ReACTAction, type ReACTContext, type ReACTReport, type ReACTReportOptions, type ReACTStep$1 as ReACTStep, type Registry, type RegistryEntry, type ReportStatistics, type RiskFinding, type RollingContext, STANDARD_PROBES, SURFACE_MULTIPLIERS, type SafetyEnvelope, type SelfAuditFlag, type SelfAuditResult, type SelfObservation, type SessionCallbacks, type SessionOptions, type SessionOutcome, type SessionSummary, type SessionTranscript, type SessionTurn, type Severity, type SharedIntervention, type SharedKnowledge, type SortField, 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, applyRecommendations, bigFiveSchema, buildAgentTherapistPrompt, buildAnonymizedReport, buildPatientSystemPrompt, buildReACTContext, buildReACTFraming, buildSharedKnowledge, buildTherapistSystemPrompt, checkApproval, checkIterationBudget, communicationSchema, compactEvolutionRun, compactIteration, compareBenchmarks, compareIndex, compile, compileCustomDetector, compileEmbodied, compileForOpenClaw, compileL0, compileL1, compileL2, compileTiered, compiledConfigSchema, compiledEmbodiedConfigSchema, computeDimensionScore, computeGazePolicy, computeMotionParameters, computeProsody, computeProxemics, computeSyncProfile, conversationLogSchema, conversationSchema, convertToHFFormat, copyToClipboard, corpusStats, createBehavioralMemory, createGist, createGraph, createGuardMiddleware, createIndex, createIndexEntry, createMemory, createProvider, createRepertoire, createTreatmentPlan, decayUnseenPatterns, deepMergeSpec, detectApologies, detectBoundaryIssues, detectFormalityIssues, detectHedging, detectRecoveryPatterns, detectRetrievalQuality, detectSentiment, detectVerbosity, discoverAgentData, discoverAgents, discoverNetworkAgents, domainSchema, embodimentSchema, emitBehavioralEvent, encodeSnapshot, estimateConfidence, evaluateOutcome, expireOldEdges, exportTrainingData, expressionSchema, extractAlpacaExamples, extractDPOPairs, extractDPOPairsWithLLM, extractRLHFExamples, extractRecommendations, fetchLeaderboard, fetchPersonality, fetchRegistry, findCrossAgentCorrelations, findEdges, findNode, findNodesByType, formatComplianceReportMarkdown, formatGapSummary, formatPolicyYaml, formatReACTReportMarkdown, gazePolicySchema, generateBehavioralPolicy, generateBenchmarkMarkdown, generateComparisonMarkdown, generateComplianceReport, generateCredential, generateGapRecommendation, generateIndexMarkdown, generateMonitoringCertificate, generateMutations, generatePrescriptions, generateProgressReport, generateReACTReport, 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, learnIntervention, listArchetypeIds, listDetectors, listDetectorsByCategory, listDetectorsByTag, listPresets, loadAuditLog, loadBehavioralMemory, loadBenchmarkResults, loadCorpus, loadCustomDetectors, loadEvolution, loadFleetConfig, loadGraph, loadLatestBenchmark, loadMemory, loadNetworkConfig, loadRepertoire, loadSpec, loadTranscripts, loadTreatmentPlan, mergeStores, messageSchema, modalitySchema, morphologySchema, motionParametersSchema, pairAgents, parseAnthropicAPILog, parseChatGPTExport, parseClaudeExport, parseConversationLog, parseConversationLogFromString, parseJSONLLog, parseMarkdownDetector, parseOTelGenAIExport, parseOpenAIAPILog, personalitySpecSchema, physicalSafetySchema, populateFromDiagnosis, populateFromEvolve, populateFromSession, prescribeDPOPairs, processReACTResponse, prosodySchema, providerSchema, proxemicZoneSchema, publishToLeaderboard, pushToHFHub, queryCorpus, queryInterventions, querySharedKnowledge, recommendTier, recordInterventionOutcome, recordObservation, recordSelfObservation, recordSessionOutcome, registerBuiltInDetectors, registerDetector, resetMarketplaceClient, resolveInheritance, resolveOversight, 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, shareAnonymizedPatterns, shareFromDiagnosis, startFleet, startMCPServer, startWatch, summarize, summarizeSessionForMemory, summarizeTherapy, surfaceSchema, syncAnchorSchema, syncProfileSchema, syncRuleSchema, therapyDimensionsSchema, therapyScoreLabel, transferIntervention, unregisterDetector, updateEdgeWeight, validateDetectorConfig, verifyAuditChain, verifyCredential, wrapAgent };

package/dist/index.js

@@ -9419,6 +9419,208 @@ startMCPServer().catch((err) => {
   process.exit(1);
 });
 
+// src/live/snapshot.ts
+import { deflateSync } from "zlib";
+import { execSync } from "child_process";
+import chalk from "chalk";
+
+// src/live/brain-mapper.ts
+var BRAIN_REGIONS = [
+  {
+    id: "prefrontal-cortex",
+    name: "Prefrontal Cortex",
+    function: "Executive Decisions",
+    color: "#4488ff",
+    detectors: ["boundary-violation", "over-verbose"]
+  },
+  {
+    id: "brocas-area",
+    name: "Broca's Area",
+    function: "Language Generation",
+    color: "#aa66ff",
+    detectors: ["register-inconsistency", "hedge-stacking"]
+  },
+  {
+    id: "wernickes-area",
+    name: "Wernicke's Area",
+    function: "Language Comprehension",
+    color: "#ff66bb",
+    detectors: ["sycophantic-tendency", "negative-skew"]
+  },
+  {
+    id: "amygdala",
+    name: "Amygdala",
+    function: "Emotional Processing",
+    color: "#ff5555",
+    detectors: ["over-apologizing", "negative-skew"]
+  },
+  {
+    id: "anterior-cingulate",
+    name: "Anterior Cingulate",
+    function: "Conflict Monitoring",
+    color: "#ffcc22",
+    detectors: ["sycophantic-tendency", "boundary-violation"]
+  },
+  {
+    id: "hippocampus",
+    name: "Hippocampus",
+    function: "Memory & Context",
+    color: "#44dd88",
+    detectors: ["error-spiral"]
+  },
+  {
+    id: "temporal-lobe",
+    name: "Temporal Lobe",
+    function: "Understanding & Tone",
+    color: "#44dd88",
+    detectors: ["negative-skew", "register-inconsistency"]
+  },
+  {
+    id: "cerebellum",
+    name: "Cerebellum",
+    function: "Behavioral Fine-Tuning",
+    color: "#22ccaa",
+    detectors: ["register-inconsistency", "over-verbose"]
+  },
+  {
+    id: "thalamus",
+    name: "Thalamus",
+    function: "Relay Hub",
+    color: "#ff8844",
+    detectors: []
+    // activated by overall health, not specific detectors
+  }
+];
+var SEVERITY_INTENSITY = {
+  info: 0.1,
+  warning: 0.6,
+  concern: 1
+};
+var AMBIENT_INTENSITY = 0.08;
+function healthToGrade(health) {
+  if (health >= 85) return "A";
+  if (health >= 70) return "B";
+  if (health >= 50) return "C";
+  if (health >= 30) return "D";
+  return "F";
+}
+function calculateHealth(patterns) {
+  if (patterns.length === 0) return 100;
+  const penalties = patterns.map((p) => {
+    if (p.severity === "concern") return 25;
+    if (p.severity === "warning") return 15;
+    return 5;
+  });
+  return Math.max(0, 100 - penalties.reduce((a, b) => a + b, 0));
+}
+function mapDiagnosisToBrainEvent(diagnosis, latestMessage) {
+  const activePatternIds = new Set(diagnosis.patterns.map((p) => p.id));
+  const regions = BRAIN_REGIONS.map((region) => {
+    const activatingPatterns = region.detectors.filter((d) => activePatternIds.has(d));
+    let intensity = AMBIENT_INTENSITY;
+    if (activatingPatterns.length > 0) {
+      const maxIntensity = Math.max(
+        ...activatingPatterns.map((pid) => {
+          const pattern = diagnosis.patterns.find((p) => p.id === pid);
+          return pattern ? SEVERITY_INTENSITY[pattern.severity] || 0.3 : 0.3;
+        })
+      );
+      intensity = maxIntensity;
+    }
+    if (region.id === "thalamus") {
+      const health2 = calculateHealth(diagnosis.patterns);
+      intensity = health2 < 70 ? (100 - health2) / 100 : AMBIENT_INTENSITY;
+    }
+    return {
+      id: region.id,
+      name: region.name,
+      function: region.function,
+      color: region.color,
+      intensity,
+      patterns: activatingPatterns
+    };
+  });
+  const patterns = diagnosis.patterns.map((p) => ({
+    id: p.id,
+    name: p.name,
+    severity: p.severity,
+    percentage: p.percentage,
+    description: p.description
+  }));
+  const health = calculateHealth(diagnosis.patterns);
+  return {
+    type: "diagnosis",
+    timestamp: diagnosis.timestamp,
+    health,
+    grade: healthToGrade(health),
+    messageCount: diagnosis.messagesAnalyzed,
+    regions,
+    patterns,
+    activity: latestMessage ? {
+      role: latestMessage.role,
+      preview: latestMessage.content.slice(0, 80)
+    } : null
+  };
+}
+
+// src/live/snapshot.ts
+var SHARE_BASE = "https://app.holomime.dev/brain";
+function encodeSnapshot(event, agentName) {
+  const compact = {
+    h: event.health,
+    g: event.grade,
+    m: event.messageCount,
+    a: agentName,
+    r: event.regions.filter((r) => r.intensity > 0).map((r) => ({ i: r.id, n: Math.round(r.intensity * 100) / 100 })),
+    p: event.patterns.map((p) => ({
+      i: p.id,
+      s: p.severity,
+      c: Math.round(p.percentage * 10) / 10
+    }))
+  };
+  const json = JSON.stringify(compact);
+  const compressed = deflateSync(Buffer.from(json));
+  return compressed.toString("base64url");
+}
+function generateShareUrl(diagnosis, agentName) {
+  const brainEvent = mapDiagnosisToBrainEvent(diagnosis);
+  const encoded = encodeSnapshot(brainEvent, agentName ?? "agent");
+  return `${SHARE_BASE}?d=${encoded}`;
+}
+function copyToClipboard(text) {
+  try {
+    if (process.platform === "darwin") {
+      execSync("pbcopy", { input: text });
+      return true;
+    } else if (process.platform === "linux") {
+      execSync("xclip -selection clipboard", { input: text });
+      return true;
+    } else if (process.platform === "win32") {
+      execSync("clip", { input: text });
+      return true;
+    }
+  } catch {
+  }
+  return false;
+}
+function printShareLink(url, copied) {
+  console.log("");
+  console.log(
+    chalk.green("  \u2713 ") + chalk.bold("Share your agent's brain:")
+  );
+  console.log("");
+  console.log("  " + chalk.cyan(url));
+  console.log("");
+  if (copied) {
+    console.log(chalk.dim("  Link copied to clipboard."));
+  }
+}
+function shareFromDiagnosis(diagnosis, agentName) {
+  const url = generateShareUrl(diagnosis, agentName);
+  const copied = copyToClipboard(url);
+  printShareLink(url, copied);
+}
+
 // src/core/oversight.ts
 var DEFAULT_OVERSIGHT = {
   mode: "review",
@@ -11740,6 +11942,172 @@ var syncProfileSchema = z5.object({
     hold: z5.array(z5.string()).default(["filled_pause", "gaze_away", "hand_raise"])
   }).default({})
 });
+
+// src/integrations/langchain.ts
+var HolomimeCallbackHandler = class {
+  name = "holomime";
+  // LangChain expects these to be set
+  lc_serializable = false;
+  guard;
+  mode;
+  minSeverity;
+  onViolation;
+  messageBuffer = [];
+  bufferSize;
+  currentRunMessages = /* @__PURE__ */ new Map();
+  _stats = {
+    totalResponses: 0,
+    passed: 0,
+    violated: 0,
+    blocked: 0,
+    patternCounts: {}
+  };
+  constructor(options = {}) {
+    this.mode = options.mode ?? "monitor";
+    this.minSeverity = options.minSeverity ?? "warning";
+    this.onViolation = options.onViolation;
+    this.bufferSize = options.bufferSize ?? 50;
+    const agentName = options.name ?? "langchain-agent";
+    this.guard = Guard.create(agentName).useAll();
+    if (options.personality) {
+      if (typeof options.personality === "string") {
+        loadSpec(options.personality);
+      }
+    }
+  }
+  /**
+   * Called when an LLM starts generating.
+   * Captures the input messages for context.
+   */
+  handleLLMStart(_llm, prompts, runId) {
+    const key = runId ?? "default";
+    const messages = prompts.map((p) => ({
+      role: "user",
+      content: p
+    }));
+    this.currentRunMessages.set(key, messages);
+  }
+  /**
+   * Called when an LLM finishes generating.
+   * Runs behavioral analysis on the response.
+   */
+  handleLLMEnd(output, runId) {
+    const key = runId ?? "default";
+    const responseText = this.extractResponseText(output);
+    if (!responseText) return;
+    this._stats.totalResponses++;
+    const runMessages = this.currentRunMessages.get(key) ?? [];
+    const contextMessages = [
+      ...this.messageBuffer.slice(-this.bufferSize),
+      ...runMessages,
+      { role: "assistant", content: responseText }
+    ];
+    this.messageBuffer.push(
+      ...runMessages,
+      { role: "assistant", content: responseText }
+    );
+    if (this.messageBuffer.length > this.bufferSize) {
+      this.messageBuffer = this.messageBuffer.slice(-this.bufferSize);
+    }
+    this.currentRunMessages.delete(key);
+    const result = this.guard.run(contextMessages);
+    if (result.passed || !this.severityMeetsMin(result.severity)) {
+      this._stats.passed++;
+      return;
+    }
+    this._stats.violated++;
+    for (const p of result.patterns) {
+      this._stats.patternCounts[p.id] = (this._stats.patternCounts[p.id] || 0) + 1;
+    }
+    const violation = {
+      patterns: result.patterns,
+      severity: result.severity,
+      response: responseText,
+      runId,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString()
+    };
+    this.onViolation?.(violation);
+    if (this.mode === "strict" && result.severity === "concern") {
+      this._stats.blocked++;
+      throw new HolomimeViolationError(violation);
+    }
+  }
+  /**
+   * Called on LLM errors. Clean up run tracking.
+   */
+  handleLLMError(_error, runId) {
+    const key = runId ?? "default";
+    this.currentRunMessages.delete(key);
+  }
+  /**
+   * Called when a chain starts. Captures input for context.
+   */
+  handleChainStart(_chain, inputs, runId) {
+    const key = runId ?? "default";
+    const inputText = inputs.input ?? inputs.question ?? inputs.query ?? "";
+    if (typeof inputText === "string" && inputText) {
+      const existing = this.currentRunMessages.get(key) ?? [];
+      existing.push({ role: "user", content: inputText });
+      this.currentRunMessages.set(key, existing);
+    }
+  }
+  /**
+   * Get cumulative stats.
+   */
+  stats() {
+    return {
+      ...this._stats,
+      patternCounts: { ...this._stats.patternCounts }
+    };
+  }
+  /**
+   * Reset the message buffer and stats.
+   */
+  reset() {
+    this.messageBuffer = [];
+    this.currentRunMessages.clear();
+    this._stats = {
+      totalResponses: 0,
+      passed: 0,
+      violated: 0,
+      blocked: 0,
+      patternCounts: {}
+    };
+  }
+  /**
+   * Get the current guard result for the buffered conversation.
+   */
+  diagnose() {
+    return this.guard.run(this.messageBuffer);
+  }
+  // ─── Private helpers ──────────────────────────────────────
+  severityMeetsMin(severity) {
+    if (this.minSeverity === "warning") return severity !== "clean";
+    if (this.minSeverity === "concern") return severity === "concern";
+    return false;
+  }
+  extractResponseText(output) {
+    if (output?.generations?.[0]?.[0]?.text) {
+      return output.generations[0][0].text;
+    }
+    if (output?.generations?.[0]?.[0]?.message?.content) {
+      return output.generations[0][0].message.content;
+    }
+    if (typeof output === "string") {
+      return output;
+    }
+    return null;
+  }
+};
+var HolomimeViolationError = class extends Error {
+  violation;
+  constructor(violation) {
+    const patternNames = violation.patterns.map((p) => p.name).join(", ");
+    super(`HoloMime behavioral violation (${violation.severity}): ${patternNames}`);
+    this.name = "HolomimeViolationError";
+    this.violation = violation;
+  }
+};
 export {
   ARCHETYPES,
   ATTACHMENT_STYLES,
@@ -11749,6 +12117,8 @@ export {
   DEFAULT_OVERSIGHT,
   DIMENSIONS,
   Guard,
+  HolomimeCallbackHandler,
+  HolomimeViolationError,
   LEARNING_ORIENTATIONS,
   LocalMarketplaceBackend,
   MarketplaceClient,
@@ -11801,6 +12171,7 @@ export {
   conversationLogSchema,
   conversationSchema,
   convertToHFFormat,
+  copyToClipboard,
   corpusStats,
   createBehavioralMemory,
   createGist,
@@ -11828,6 +12199,7 @@ export {
   domainSchema,
   embodimentSchema,
   emitBehavioralEvent,
+  encodeSnapshot,
   estimateConfidence,
   evaluateOutcome,
   expireOldEdges,
@@ -11862,6 +12234,7 @@ export {
   generatePrescriptions,
   generateProgressReport,
   generateReACTReport,
+  generateShareUrl,
   generateSystemPrompt,
   gestureSchema,
   getAdversarialCategories,
@@ -11980,6 +12353,7 @@ export {
   severityMeetsThreshold2 as severityMeetsThreshold,
   severitySchema,
   shareAnonymizedPatterns,
+  shareFromDiagnosis,
   startFleet,
   startMCPServer,
   startWatch,