Eve library

Iris — Systems Deep Dive

Guide

Revision 1

On this page

The libs/iris/ area: ~262 Nx libraries that make up Iris, Oshun's AI-assistant domain — the conversation engine, agent runtime, knowledge/RAG, four-tier memory, multimodal (voice/vision/BCI/spatial) I/O, emotional intelligence, personalization, privacy/safety, platform tooling, and multi-language SDKs.

What this area is#

Iris is the platform's conversational and agentic AI substrate, and by project count it is the largest single lib area in the monorepo. It is not one package but 262 separate Nx libraries under libs/iris/, each scoped scope:iris (18 tagged scope:shared and 1 tagged scope:oshun) and almost all implemented in TypeScript. The packages are organised by capability sub-system rather than as one monolith, so a consumer can pull in only the slice it needs — e.g. just @iris/conversation-core and one provider, or the full agent + tools + computer-use stack.

The area layers roughly like this. A foundation tier (@iris/core, @iris/types, @iris/config, @iris/embeddings) owns shared types, errors, context, configuration, and the canonical embedding client. A conversation tier owns multi-turn dialogue (@iris/conversation-core), intent/context/state/style/uncertainty modules, the provider-agnostic orchestrator (@iris/conversation-orchestration), and concrete provider adapters for Anthropic, OpenAI, Google, and local Ollama models. An agents tier (libs/iris/agents/) owns the runtime (@iris/agents-core), archetypes, multi-agent orchestration, a tool framework, and a full computer-use/desktop-automation stack (including a real multi-crate Rust native backend). A knowledge tier (libs/iris/knowledge/) is a production-grade RAG/GraphRAG/retrieval/grounding stack, and a memory tier (libs/iris/memory/) implements a four-tier memory hierarchy plus personalization and privacy sub-trees. Further tiers cover multimodal (vision, voice, BCI, spatial/XR, IoT), emotional intelligence, privacy/safety/security, accessibility, platform (gateway, billing, rate-limiting, SDK codegen, white-label), presence, analytics, integrations with six sibling Oshun domains, testing, and client SDKs in five languages.

Honesty note on maturity: the overwhelming majority of these libraries contain real, domain-specific logic (scoring formulas, retrieval fusion, state machines, crypto primitives, audio/turn-taking heuristics, statistical tests) and concrete exported classes/factories — they are not empty scaffolds. Many use injectable dependency seams and in-memory stores so the algorithms run without external infrastructure, with real backends (Postgres/Qdrant/Redis, vendor LLM/STT/TTS APIs) wired behind provider interfaces. A small set of nodes are deliberately thin V1 product-surface facades — a single index.ts exporting product metadata, descriptors, and validators (@iris/accessibility, @iris/agents, @iris/conversation, @iris/multimodal/vision, @iris/multimodal/voice). Those are called out as such in their entries below rather than overclaimed.

How it fits the wider system#

These libraries are consumed by the Iris product surfaces (web shell, mobile/desktop companions, the BFF, and the agent loop) and by sibling Oshun domains through the libs/iris/integrations/* adapters (Hathor, Maya, Nyx, Psyche, Sophia, Yemaya). The wire contracts for the domain live separately in @iris/contracts (libs/contracts/iris), which is the bottom-of-graph schema package the contracts area documents; the libraries here are the implementation behind those contracts. Provider adapters compose with the orchestrator; tools and computer-use compose with the agent runtime; knowledge/RAG and memory compose into the conversation pipeline; privacy/safety/accessibility wrap every surface. The five SDKs (@iris/sdk and the Kotlin/Python/Rust/Swift siblings) are the external client view of the same API. Walk the dependency edges on any node below to see exactly who composes with it.

Entity reference#

@iris/a2a#

Private, unmounted A2A-shaped compatibility prototype (libs/iris/a2a/src): local agent-card, task-negotiation, and result-sharing experiments only. It is not a current A2A implementation or interoperability claim. ADR-0091 defers adoption until a named independent agent boundary exists.

@iris/accessibility-adaptive#

Adaptive-UI accessibility engine (adaptive-ui-engine.ts, interface-adapter.ts, user-capability-detector.ts, preference-sync.ts) that detects user capabilities and adapts the interface and syncs preferences. Real implementation, ~8 modules.

@iris/accessibility-braille#

Braille support: BrailleFormatting, BrailleOutput, BrailleInput, and braille-display-integration.ts for refreshable-display I/O and braille translation.

@iris/accessibility-cognitive#

Cognitive-accessibility services for users with cognitive disabilities — reading assistance/pace, simplified language, memory aids, distraction reduction, step-by-step guidance, text highlighting — with named presets (PRESET_ADHD, PRESET_READING_SUPPORT, …) and an applyPreset composer. Substantial (~14 modules).

@iris/accessibility-hearing#

Hearing-accessibility support for deaf/HoH users: visual alerts, vibration feedback, real-time captioning, transcript generation, and a sign-language avatar, composed by createHearingAccessibilityServices.

@iris/accessibility-i18n#

Internationalization layer (~16 modules) — language support, RTL layout, cultural adaptation, localized date/number formats, translation memory, real-time/UI/content translation — with ~11 locale presets (I18N_PRESET_AR_SA, _JA, _ZH_CN, …).

@iris/accessibility-motor#

Motor-accessibility / voice-only operation: voice recognition, voice commands/navigation, dictation, switch access, eye tracking, predictive and custom input, via createMotorAccessibilityServices.

@iris/accessibility#

Thin V1 facade. A single index.ts exporting accessibility package metadata, the V2 companion-bridge descriptor (buildIrisV2AccessibilityBridge), capability/mode types, and a profile validator — a product-surface catalog, not the implementing engines (those are the sibling accessibility-* libs).

@iris/accessibility-testing#

Accessibility test tooling: AutomatedA11yChecks, A11yReporter, A11yTestSuite, and a manual-checklist generator for verifying a11y compliance.

@iris/accessibility-visual-alternatives#

Visual alternatives — HighContrastModes, AudioDescriptions, TextAlternatives, SpatialAudioNavigation — composed by the VisualAlternatives class.

@iris/accessibility-visual-display#

Adjustable-display controls: TextSizing, ColorContrast, FontChoices, ReducedMotion, composed by createAdjustableDisplay.

@iris/accessibility-visual#

Visual accessibility / screen-reader support: ScreenReaderOptimization, ARIALabels, FocusManagement, KeyboardNavigation, AnnouncementSystem, via createVisualAccessibility.

@iris/accessibility-voice-ui#

Voice-driven UI framework: VoiceNavigation, VoiceFeedback, voice-menus.ts, composed by createVoiceUIFramework.

@iris/archetypes#

Specialized agent archetypes (libs/iris/agents/archetypes) — Research/Code/Data/Creative/ Operations agents (aliased Researcher/Coder/Analyst/Writer/Operator) over a base-archetype.ts, with an ArchetypeRegistry and createArchetypeWithPersona. Includes real research-nlp.ts, web-search-provider.ts, command-runner.ts helpers.

@iris/computer-use-accessibility#

Accessibility-first automation primitives: SemanticUINavigation, A11yTreeInspector, robust-element-selection.ts, accessibility-api-integration.ts for tree-aware desktop control.

@iris/desktop-automation#

Desktop application automation: DesktopController, WindowManager, MenuNavigator, DialogHandler, ShortcutExecutor, wrapped by DesktopAutomationAgent.

@iris/computer-use-native#

Rust native backend (libs/iris/agents/computer-use/native). A multi-crate workspace (iris-desktop-core traits + per-OS crates for X11/Wayland/macOS-CGEvent/Windows-SendInput

  • an iris-desktop-napi napi-rs cdylib). X11 has real input/capture and a Task 6.4 native fixture; macOS and Windows have input/capture bodies; Wayland and every native accessibility-tree walker remain incomplete. The README records the per-backend boundary and #[cfg(target_os)] selection.

@oshun/iris-computer-use-native#

TypeScript wrapper (libs/iris/agents/computer-use/native/ts) around the Rust desktop binding — OshunDesktopController exposes capture, mouse, keyboard, clipboard, display, and capability methods, while unsupported backend methods fail closed. DesktopError mirrors the native error categories. Task 6.4 proved the wrapper plus X11 capture/input path on an isolated GTK/Xvfb target; native X11 clipboard remains unsupported.

@iris/computer-use#

Computer-use GUI-automation agent: ScreenCapture, ActionExecutor, element detection, and createComputerUseAgent. The directory also nests the Rust native/ backend.

@iris/computer-use-recording#

Task recording for computer-use workflows: ScreenRecorder, ActionAnnotator, RecordingPlayback, RecordingExport.

@iris/computer-use-recovery#

Graceful error recovery for automation: ErrorDetector, recovery-strategy selection, RollbackManager, AlternativePathFinder, orchestrated by RecoveryManager.

@iris/action-safety#

Action-safety system for agents: ActionValidator, DangerousActionBlocker, confirmation workflow, undo capability, and audit log, composed as SafetySystem.

@iris/sandbox#

Sandboxed execution environment: ResourceManager (with TokenBucket), NetworkController, FilesystemController, SnapshotManager, plus SandboxEnvironment/ SandboxManager for isolated agent execution.

@iris/computer-use-templates#

Reusable computer-use task templates: builder, parameterization, sharing, and a TemplateLibrary for lifecycle management.

@iris/screenshot-vision#

Screenshot understanding for agents: ScreenAnalyzer, UIElementDetector, TextExtractor, LayoutAnalyzer, ChangeDetector, wrapped by ScreenshotVisionAgent.

@iris/agents-core#

The agent runtime framework (~36 modules): context/lifecycle/communication/permission managers, AgentRuntime, AgentSystem, a tool-registry, provider adapters, a cognition gateway, budget, reward/recommendation models, execution replay/learning, and an oshun-ai-bridge. The substantive heart of the agents tier.

@iris/agent-marketplace#

Marketplace primitives for agent packages: AgentMarketplace, AgentPublisher, AgentInstaller, AgentRating (publish/discover/install/rate).

@iris/multi-agent-memory#

Shared-memory collaboration for multi-agent systems: in-memory SharedAgentMemory, MemoryBroadcast, selective-sharing policy, and memory-conflict resolution.

@iris/multi-agent#

Multi-agent orchestration (~22 modules): AgentSpawner, InterAgentMessaging, TaskDistributor, ResultAggregator, SharedContext, plus consensus/negotiation/ handoff/conflict protocols and an orchestrator.

@iris/agent-personalities#

Agent personality profiles: PersonalityTraits, CommunicationStyle derivation, and observation-driven personality-evolution.ts.

@iris/ambient#

Ambient intelligence (proactive): BackgroundMonitor, AnomalyDetector, OpportunityIdentifier, RiskAwareness, AlertManager, composed by AmbientIntelligenceSystem.

@iris/anticipation#

Anticipatory-assistance engine (~30 modules) — pattern recognition, context triggers, relevance scoring, need/task prediction, productivity-awareness (break/timing/focus), and opportunity detection — the largest proactive lib.

@iris/automation#

Workflow-automation proposals: PatternBasedAutomation, AutomationSuggester, WorkflowRecorder, WorkflowManager, executed by AutomationSystem.

@iris/reminders#

Schedule-aware reminders: SmartTiming, DeadlineTracker, calendar integration/sync, and a multi-channel ReminderEngine with a DeliveryProvider seam.

@iris/agents#

Thin V1 facade. Single index.ts exposing the built-in-agent catalog (listIrisBuiltInAgents, getIrisBuiltInAgent), capability/intent types, selectIrisAgentForIntent, and a launch-readiness resolver — a product-surface descriptor layer over the real agents-* runtime libs.

@iris/agent-specialization#

Domain specialization for multi-agent systems: domain-specialization-training.ts, SpecializationTransfer, ExpertiseMapping, SpecializationMetrics.

@iris/api-tools#

API-integration tools for agents: APIClient, RateLimiter, OAuthHandler (with OAuthProviders), ResponseParser, composed as APITools.

@iris/tool-auth#

Secure tool authentication: ToolCredentialManager, OAuthToolAuth, APIKeyToolAuth, CredentialRefresh.

@iris/function-calling#

Function-calling framework: ParameterParser, ResultHandler, ErrorHandler, TimeoutManager, FunctionCaller, composed as FunctionCallingSystem.

@iris/code-tools#

Sandboxed code execution for agents: PythonRunner, TypeScriptRunner, ShellRunner over a code-executor/sandbox with output capture, composed as CodeTools.

@iris/tool-composition#

Tool-workflow composition: ToolComposer, ToolPipeline, parallel executor, and conditional branching for complex tool graphs.

@iris/database-tools#

Database tools for agents: QueryValidator, QueryBuilder, DatabaseBrowser, ResultFormatter, and a SQLQueryTool over a DatabaseExecutor seam (with a mock executor for tests).

@iris/filesystem-tools#

File-system tools: PermissionChecker, FileReadTool/FileWriteTool/FileSearchTool, DirectoryTool, FileWatchTool, composed as FileSystemTools.

@iris/learning-tools#

Tool-learning system: ToolDocParser (OpenAPI/TypeScript), ParameterInference, UsagePatternOptimizer, dynamic tool registration, plus a real TDigest/PercentileTracker.

@iris/tool-marketplace#

Tool marketplace: discovery, installation, rating, and ToolCertification (trust) services.

@iris/tool-monitoring#

Tool-execution observability: ToolExecutionMonitor, ToolErrorTracking, ToolUsageAnalytics, performance metrics, composed as ToolMonitoringSuite.

@iris/tools-registry#

Tool registry: schema management, ToolValidation, ToolDiscovery, and versioning, composed as ToolRegistrySystem.

@iris/tool-versioning#

Tool version/migration management with a real semver implementation (parseSemver, compareSemver, satisfiesConstraint), ToolMigrationUtils, deprecation handling, and a compatibility checker.

@iris/web-tools#

Web browsing tools for agents: HttpClient, ContentParser, and Search/Fetch/Scrape/ Navigate/Form tools with URL validation, composed as WebTools.

@iris/workflows#

Workflow orchestration (~17 modules): WorkflowEngine (with a TaskExecutor seam), TaskDecomposer, DependencyGraph, ProgressTracker, ErrorRecovery, parallel executor, plan visualizer.

@iris/analytics-ab#

A/B-test analytics: VariantComparison, ABTestAnalyzer, ABTestReporter, and a real statistical-significance.ts.

@iris/analytics-cohort#

Cohort analytics: CohortAnalyzer, RetentionAnalysis, BehaviorComparison, CohortReporter.

@iris/analytics-funnel#

Funnel analytics: FunnelAnalyzer, ConversionTracking, DropOffAnalysis, FunnelVisualization.

@iris/analytics#

Privacy-compliant analytics engine (~14 modules): analytics-engine, event-tracker, metrics-aggregator, retention/usage/quality, plus launch-monitoring, incident-response, and a runbook-executor.

@iris/analytics-realtime#

Real-time analytics: LiveMetrics, StreamingAggregation, AlertingTriggers, RealtimeDashboard.

@iris/bci-apple-hid#

Apple BCI-over-HID integration: AppleBCIHIDListener, IntentSignalDecoder, ThoughtToActionMapper, BCICalibrationFlow, composed as AppleBCIHIDEngine.

@iris/bci-intent-prediction-api#

BCI intent prediction: IntentPredictionModel, ConfidenceScorerBCI, AmbiguityResolver, confirmation flow, feedback loop, and a fromAppleBCIFrame feature-vector adapter.

@iris/bci-privacy-framework#

Neural-data privacy: NeuralDataMinimization, MentalPrivacyProtection, NeuralDataDeletion (+ in-memory store), BCIAuditTrail, cognitive-liberty consent, and a BCIPrivacyFramework with ProtectedInferenceResult.

@iris/code-agentic#

Agentic coding: AgenticCoder, MultiFileChanger, RefactoringEngine, BugFixer, FeatureImplementer for multi-file code operations.

@iris/code-architecture#

Architecture analysis: ArchitectureAnalyzer, PatternDetector, CouplingAnalyzer, and ArchitectureVisualizer for structural artifacts.

@iris/code-cli#

CLI coding assistant (~25 modules): a bin.ts entry, cli-assistant, git workflow (PRGenerator, ReviewAnalyzer, commit-generator, conflict-resolver), build/deploy assistance, log analysis, and createCLI.

@iris/code-codebase#

Codebase analysis: RepoAnalyzer, ArchitectureInference, DependencyAnalyzer, PatternDetector, and CodebaseIndexer/CodebaseSearch, composed as CodebaseAnalyzer.

@iris/code-consistency#

Code-consistency checking: StyleConsistencyChecker, NamingConventionEnforcer, PatternChecker, APIConsistencyChecker with quick-scan helpers and a combined analyzer.

@iris/code-dependencies#

Dependency intelligence: declaration analysis, VulnerabilityScanner, UpdateSuggester, LicenseChecker (license-policy validation).

@iris/code-explanation#

Educational code explanation: CodeExplainer, step walkthroughs, ConceptExtractor, DiagramGenerator.

@iris/code-generation#

Code generation: a TypeScript AST generator with fluent builders (expression/statement/ function/class), test-generator, doc-generator, and contextual autocomplete.

@iris/code-git#

Deep git integration (~21 modules): diff parsing, commit-message/PR generation, branch-name suggestion, deterministic conflict-resolver, style enforcement, repo indexing, and a technical-debt tracker.

@iris/code-ide-actions#

IDE code actions: CodeActionProvider, FixActions, RefactorActions, GenerateActions.

@iris/code-ide-completions#

Smart completions: context-aware and multi-line completions, completion explanation, and a SmartCompletionProvider.

@iris/code-ide-hover#

Editor hover: DocumentationHover, TypeHover, ExplanationHover, and a SmartHoverProvider.

@iris/code-ide-inline#

In-editor inline chat: ContextualSuggestions, QuickActions, InlineExplanation, and an inline-chat-widget.

@iris/code-ide#

IDE integration layer: a BaseIDEAdapter with concrete VSCode/JetBrains/Neovim/Emacs adapters, JSON-RPC, inline-suggestions/chat/code-action services, plus detectIDEEnvironment and createAutoDetectedAdapter.

@iris/code-languages#

Per-language analyzers extending code-understanding — TypeScript, Python, Java, Go, Rust, C++, SQL, GraphQL — selected via createLanguageAnalyzer/hasLanguageAnalyzer.

@iris/code-memory-persistence#

Coding-style memory: PreferenceInferrer, CodingStyleMemory (+ in-memory store), CodeConventionEnforcer, project-context persistence, composed as CodingMemoryPersistenceEngine.

@iris/code-metrics#

Code metrics: CodeMetricsCollector, ComplexityScorer, MaintainabilityScorer, technical-debt-calculator.

@iris/code-quality#

Code-quality analysis: SecurityVulnerabilityDetector, PerformanceOptimizer, BestPracticeEnforcer, TechnicalDebtIdentifier, CodeReviewer, plus quick-scan helpers and a combined QualityAnalyzer.

@iris/code-repository-intelligence#

Repository intelligence: RepositoryIndexer, DependencyGraphBuilder, ArchitectureInferrer, ConventionDetector, MultiFileReasoner, composed as RepositoryIntelligenceEngine.

@iris/code-review#

Automated code-review pipeline: DiffAnalyzer, IssueDetector, SuggestionGenerator, ReviewCommentFormatter, composed as CodeReviewAssistant.

Code search: SemanticCodeSearch, symbol search, UsageSearch, SimilarCodeSearch, and a UnifiedCodeSearch composer.

@iris/code-semantic#

Semantic code analysis: ControlFlowAnalyzer, DataFlowAnalyzer, FunctionPurposeInference, VariableUsageTracker, composed as SemanticAnalyzer.

@iris/code-turbo-mode#

Autonomous terminal execution: CommandSafetyValidator, AutonomousTerminalExecutor, ExecutionResultInterpreter, an IterativeFixLoop, and a turbo-mode permission manager.

@iris/code-understanding#

Multi-language code intelligence: AstParser, SymbolExtractor, TypeInference, CallGraph, DataFlow, composed as CodeAnalyzer (the base the language analyzers extend).

@iris/concordia-assistant#

Iris intake state machine for the Concordia mediation domain (§179.3.1, Phase 179, ~21 source modules): trauma-/coercion-aware safety-signal detection and a runSafetyPipeline routing to Kuanyin restorative circles, hard-boundary gates, multi-device/party-isolated intake, language detection/drift, and human-reviewer queues.

@iris/config#

Configuration management: model-provider config (Anthropic/OpenAI/Google), MemGPT-style hierarchical memory config, voice (STT/TTS/VAD) config, privacy settings, and a feature-flag system with a loader.

@iris/conversation-citations#

Citation/attribution: CitationTracker, SourceAttributor, ReferenceFormatter, FactChecker for inline citations and source tracking.

@iris/conversation-context#

Semantic context tracking: TopicDetector, EntityTracker, ContextCompressor, ContextSummarizer, composed as ContextTracker.

@iris/conversation-core#

The core dialogue engine (~28 modules): ConversationManager (session lifecycle), TurnManager, ConversationHistory, context-window management, dialogue state, streaming response generator, plus search-index/bookmarks/highlights/tags/sharing and an in-memory storage backend.

@iris/conversation-format#

Multi-format response formatting: text, markdown, code, structured-data, and media formatters.

@iris/conversation-intent#

Intent recognition (~36 modules): IntentClassifier, QuestionDetector, UrgencyDetector, SlotFiller, plus an extensive Direct-Command-Control (dcc-*) voice-session suite (intent decomposition, agent-delegation routing, voice confirmation/handoff, multi-user isolation).

@iris/conversation-orchestration#

Provider-agnostic model orchestration: ModelOrchestrator, RequestRouter, LoadBalancer, CircuitBreaker, RateLimiter, and a ModelRegistry with retries/ fallbacks/metrics.

@iris/conversation-providers-anthropic#

Anthropic Claude provider adapter (anthropic-provider.ts + orchestration-adapter.ts): chat/streaming/tool-use/vision/extended-thinking support and a default-config factory, plugging into the orchestrator.

@iris/conversation-providers-google#

Google Gemini provider adapter: chat with system instructions, multimodal inputs, function calling, streaming, and an orchestration adapter.

@iris/conversation-providers-local#

Local-model provider adapter: an Ollama backend (ollama-provider.ts) for Llama/Mistral/ DeepSeek/Qwen with tool-calling, streaming, and model management.

@iris/conversation-providers-openai#

OpenAI provider adapter: chat/streaming/embeddings/moderation plus an orchestration adapter and default-config factory.

@iris/conversation-rag#

RAG integration for response generation: RAGPipeline with ContextInjector, SourceTracker, RelevanceScorer, and RAGFallback (plus a high-quality preset).

@iris/conversation-response#

Response-generation pipeline: ResponseGenerator, PromptBuilder, ResponseParser, ResponseValidator, ResponseFormatter, and streaming response support.

@iris/conversation-state#

Advanced dialogue-state management: guard-evaluated state machines, CheckpointManager (persistence/recovery), BranchManager (exploration), composed as StateManager.

@iris/conversation-style#

Style adaptation: ToneDetector, FormalityController, PersonalityMatcher, StyleLearner, composed as StyleAdapter.

@iris/conversation-uncertainty#

Uncertainty quantification: ConfidenceEstimator, UncertaintyExpressor (hedging), ClarificationGenerator, KnowledgeBoundary detection.

@iris/conversation-benchmarking#

Model benchmarking: latency/quality/cost benchmarks and a BenchmarkSuite (with a mock model invoker) plus a reporter.

@iris/conversation-branching#

Conversation branching: BranchManager, BranchMerger, BranchSummarizer, BranchHistory for alternate dialogue paths.

@iris/conversation-costs#

LLM cost tracking: CostTracker, BudgetManager, CostAlerting, CostReporting.

@iris/conversation-export#

Conversation export: Markdown/HTML/JSON/PDF exporters composed as ConversationExporter.

@iris/conversation-finetuning#

Fine-tuning infrastructure: DataCollector, JobManager, ModelVersionManager, finetuning-metrics.

@iris/conversation#

Thin V1 facade. Single index.ts for a production-assistant transcript surface — metadata, IrisProductionAssistant* types, and create*/validate*/serialize* transcript functions — not the conversation engine (that is @iris/conversation-core).

@iris/conversation-prompts#

Prompt management: PromptLibrary, PromptVersioning, PromptTesting (with calculateSampleSize), PromptOptimizer.

@iris/code-reasoning#

Code reasoning (libs/iris/conversation/reasoning/code): AST/static analysis, a RuntimeBehaviorPredictor, and a BugHypothesisGenerator, composed as CodeReasoner.

@iris/consistency#

Self-consistency checking: ContradictionDetector, BeliefTracker, ConsistencyRepair, composed as ConsistencyChecker/ConsistencySystem with quick-check helpers.

@iris/math-reasoning#

Mathematical reasoning: expression parse/eval, symbolic computation, EquationSolver, UnitConverter (dimensional analysis), StatisticalReasoner, composed as MathReasoner.

@iris/metacognition#

Metacognitive monitoring: ConfidenceCalibration, KnowledgeGapDetector, LearningOpportunityIdentifier, composed as MetacognitiveMonitor.

@iris/scientific-reasoning#

Scientific reasoning: ScientificReasoner, CitationValidator, HypothesisGenerator, ExperimentDesigner, and retraction services.

@iris/structured-reasoning#

Formal structured reasoning: PremiseTracker, LogicValidator, ConclusionDeriver, ReasoningExplainer, composed as StructuredReasoner.

Conversation search: full-text ConversationSearch, semantic/vector search, filters, and a highlighter.

@iris/conversation-summarization#

Long-thread summarization: ConversationSummarizer, KeyPointExtractor, ActionItemExtractor (incremental summaries).

@iris/conversation-templates#

Reusable conversation templates: registry, variable substitution, conditional branching, a fluent builder, and TemplateExecutor.

@iris/conversation-tokens#

Token optimization: TokenCounter/SimpleTokenizer, TokenOptimizer, ContextCompressor, TokenBudgetManager.

@iris/core#

Foundation library: shared types, error codes/base, context + correlation/tracer/profiler, a logger, decorators, schemas, and a config loader (~26 modules) — the bottom of the Iris dependency graph.

@iris/embeddings#

The canonical embedding client for Oshun: a three-tier facade (tier1 OpenAI text-embedding-3-large, tier2 Voyage voyage-3-large, tier3 local BGE-M3) with cache/ disk-cache, metrics, migration, evaluation, an in-process embedder, and a multilingual benchmark. Decision-doc-grounded (docs/releases/p2/embeddings-provider-decision.md).

iris/emotional-ethics#

Non-negotiable ethical boundaries for emotionally-aware AI: AIIdentityClarity, CapabilityTransparency, CrisisProtocol, MandatoryReferral, human-relationship respect, composed as EthicalBoundaries. (Project name lacks the @ prefix.)

@iris/emotional-multimodal-fusion#

Multimodal emotion fusion: TextEmotionAnalyzer, VoiceEmotionAnalyzer, EmotionFusionEngine, ContextualEmotionInterpreter, EmotionHistoryTracker, composed as MultimodalEmotionAnalyzer.

iris/emotional-rapport#

Rapport building: TrustIndicators, RelationshipProgress, personalized interaction, composed as RapportBuilder. (Name lacks @ prefix.)

@iris/emotional-recognition#

Multi-modal emotion recognition: EmotionRecognizer, TextSentimentAnalyzer, VoiceEmotionAnalyzer, MultimodalFusion.

iris/emotional-response#

Emotionally-adaptive response generation (~16 modules): EmotionalAdapter, ToneMatcher, DeEscalator, Celebrator, Supporter, plus crisis-support/stress-management/mindfulness/ gratitude-journal/wellbeing-report modules with named default configs. (Name lacks @.)

iris/emotional-social#

Social intelligence: CulturalAwareness, FormalityCalibrator, HumorCalibrator, BoundaryRespect, SocialCueDetector, composed as SocialIntelligence. (Name lacks @.)

iris/emotional-tracking#

Longitudinal emotion tracking: MoodTracker, PatternAnalyzer, TrendAnalyzer over time. (Name lacks @ prefix.)

@iris/emotional-voice-analysis#

Prosody-based voice emotion analysis: ProsodEmotionAnalyzer, a 48-class Emotion48Classifier, confidence/temporal tracking, micro-emotion detection, composed as VoiceEmotionAnalysisEngine.

iris/emotional-wellbeing#

Consent-based, explicitly non-diagnostic wellbeing monitoring: GentleCheckIn, ResourceSuggester, ConcerningPatternDetector, ProfessionalReferral, composed as WellbeingMonitor. (Name lacks @ prefix.)

@iris/ensemble#

Multi-model ensemble: VotingStrategy, ConsensusBuilder, DisagreementResolver, composed as EnsembleOrchestrator.

@iris/failover#

Automatic failover for provider integrations: HealthChecker, CircuitBreaker, RetryPolicy, FallbackChain, composed as FailoverManager.

@iris/integrations-hathor#

Integration adapter to the Hathor worldbuilding domain: lore context, WorldKnowledgeService, CharacterDatabaseService, TimelineNavigationService, LoreConsistencyChecker, plus lore-keeper/plot-advisor/world-consistency agents (~22 modules).

@iris/integrations-maya#

Integration to the Maya metaverse engine: in-world MayaCompanion, WorldContextManager, SpatialVoiceChat, WorldCommands, plus world-builder/npc-control/asset-creator agents and personality presets.

@iris/integrations-nyx#

Integration to the Nyx astronomy domain: celestial-guide/event/educational services and stargazer/observation-planner/astronomy-tutor agents, composed by createNyxIntegration.

@iris/integrations-psyche#

Integration to the Psyche domain for AI-avatar presence: avatar/conferencing/emotion services and presenter/participant/persona agents with a platform-adapter.

@iris/integrations-sophia#

Integration to the Sophia research/knowledge domain: research-assistant, knowledge-base, literature-search, and citation-manager services + agents, composed by createSophiaIntegration.

@iris/integrations-yemaya#

Integration to the Yemaya creative-studio domain (~27 modules): project-context, asset-understanding, creative-suggestions, and workflow-automation services + agents (asset- organizer/audio-mixer/video-editor/design-assistant).

@iris/knowledge-agentic-rag#

Agentic retrieval orchestration: QueryDecomposer, RetrievalStrategySelector, IterativeRefinement, SourceQualityAssessor, dense/sparse/graph retrievers + fusion + evaluator, plus an EmbeddingDenseRetriever, composed as RetrievalAgent.

@iris/knowledge-chunking#

Document chunking for RAG: semantic/hierarchical/code chunkers, table/figure extractors, and a ChunkingPipeline, with Zod-validated config.

@iris/knowledge#

The unified knowledge system (libs/iris/knowledge/core, ~18 modules): source registry, indexing, quality/freshness scoring, conflict detection, citation formatting, federation, marketplace/monetization, and source-credibility ranking, with capability probes (isKnowledgeAvailable).

@iris/knowledge-curation#

Knowledge curation pipeline: DuplicateDetector, QualityScorer, KnowledgeMerger, composed as KnowledgeCurator.

@iris/knowledge-embeddings#

Embedding-service abstraction with OpenAI/Cohere/local providers, an EmbeddingCache, batch processing, and similarity calculations.

@iris/knowledge-enterprise#

Enterprise knowledge connectors: Confluence/Notion/SharePoint/Google-Drive connectors over a BaseConnector with a ConnectorFactory and OAuth2/API-token auth.

@iris/knowledge-export#

Knowledge export: JSON-LD, RDF, and Wiki exporters composed as KnowledgeExporter (linked- data / semantic-web formats).

@iris/knowledge-factcheck#

Automated fact-checking: ClaimExtractor, EvidenceRetriever, SourceCredibilityScorer, VeracityScorer, composed as FactChecker.

@iris/knowledge-freshness#

Freshness tracking: FreshnessTracker, TemporalRelevanceScorer, VersionTracker, ChangeNotifier, continuous index updater, composed as a UnifiedFreshnessSystem.

@iris/knowledge-graph#

Knowledge-graph stack: EntityExtractor, RelationshipExtractor, KnowledgeGraphStore, GraphQueryEngine, GraphVisualization, and an ingestTextIntoKnowledgeGraph pipeline.

@iris/knowledge-graphrag#

GraphRAG: KnowledgeGraphBuilder, community detection, GraphSummarizer (hierarchical), a GraphRAGQueryEngine (multi-hop), composed as GraphRAGPipeline.

@iris/knowledge-grounding#

Grounding/attribution for AI output: claim extraction, source citation, confidence scoring, fact verification, contradiction + hallucination detection, composed as DefaultGroundingPipeline.

@iris/knowledge-personal#

Personal document indexing: DocumentIndexer with file watcher, format handler, metadata extractor, change tracker, and a privacy filter, integrating with @iris/knowledge.

@iris/knowledge-query#

Query expansion/reformulation for RAG: QueryExpander (synonym/semantic/entity/PRF/LLM), QueryReformulator, HyDE HypotheticalDocument, and a MultiQueryRetriever with fusion.

@iris/knowledge-rag-adaptive-chunking#

Adaptive chunking: ContentTypeDetector, OptimalChunkSizer, ChunkQualityScorer, composed as AdaptiveChunker.

@iris/knowledge-rag-debugging#

RAG observability: RetrievalExplainer, ChunkInspector, RelevanceVisualizer, composed as RAGDebugger.

@iris/knowledge-rag-evaluation#

RAG evaluation: retrieval/generation/e2e metrics and an EvaluationDashboard, composed as RAGEvaluator.

@iris/knowledge-rag-multimodal#

Multi-modal retrieval: ImageRAG, TableRAG, CodeRAG, and a fusion-based ranker (MultiModalFusion).

@iris/knowledge-rag#

Production-grade RAG pipeline: query processing (expansion/decomposition/HyDE), hybrid retrieval with an in-memory BM25 index + RRF fusion, cross-encoder reranking, response generation, caching, and evaluation, composed as DefaultRAGPipeline.

@iris/knowledge-realtime#

Real-time knowledge: web/news/academic search and social-media monitoring with a multi-engine aggregator, composed as a UnifiedKnowledgeSystem.

@iris/knowledge-retrieval#

Hybrid retrieval: dense (bi-encoder) + sparse retrievers, multiple fusion methods, ColBERT-style multi-vector retrieval, cross-encoder reranking, and evaluation metrics.

@iris/knowledge-types#

Knowledge type system: factual/procedural/conceptual/etc. types, a knowledge-factory, confidence scoring, retrieval strategies, and Zod type schemas.

@iris/knowledge-versioning#

Knowledge versioning: ChangeTracker, VersionComparison, RollbackCapability, composed as KnowledgeVersioner.

@iris/mcp#

Model Context Protocol client: MCPClient with tool discovery, resource access, and prompt templates for connecting to MCP servers.

@iris/memory-analytics#

Memory analytics: usage stats, growth trends, quality metrics, retrieval-pattern analysis, and an analytics dashboard.

@iris/memory-consolidation#

Memory consolidation: forgetting-curve DecayAlgorithm, ImportanceScorer, SummaryGenerator, MemoryClusterer, composed as ConsolidationEngine.

@iris/memory-core#

The unified four-tier memory system (STM/LTM/episodic/semantic): MemoryManager, MemoryTierRouter, MemoryIndex, MemorySerializer, and MemoryGC.

@iris/memory-debugging#

Memory debugging: MemoryDebugger, retrieval explainer, timeline + change tracking, and a debug-session manager.

@iris/memory-episodic#

Episodic memory: event-based autobiographical episodes with temporal context, a MemorableInteractionDetector, MilestoneTracker, task-completion records, and episodic retrieval.

@iris/memory-long-term#

Long-term memory: persistent LongTermMemory, PreferenceStore, PatternStore, CorrectionStore, plus LTM consolidation/retrieval.

@iris/memory-migration#

Memory import from external AI systems: ChatGPT/Claude/custom importers over a BaseMemoryImporter (with content hashing) and a migration pipeline.

@iris/memory-persistence#

Durable persistence backends: PostgresStore, QdrantStore (vector), RedisCache, plus backup/restore/recovery (with an S3 backup client), composed as a MemoryPersistenceSystem (constructable from env). The real-infrastructure layer behind the memory tier.

@iris/personalization-feedback#

Feedback-learning for personalization (libs/iris/memory/personalization/feedback): FeedbackCollector, ImplicitFeedbackDetector, FeedbackProcessor, AdaptationEngine.

@iris/personalization-inference#

Preference inference: PreferenceInferrer, StyleAnalyzer, InterestDetector, ConfidenceTracker, composed as an InferenceSystem.

@iris/personalization#

User-modeling and personalization (libs/iris/memory/personalization, ~30 modules): preference/interest/goal trackers, ExpertiseEstimator, BehaviorAnalyzer, Big-Five detection, context-fusion/prediction, location/device context, and a UserModelStore, composed as PersonalizationSystem.

@iris/personalization-segments#

User segmentation: profile clustering/ranking, segment assignment with smoothing, segment-default behavior packs, and transition/stability metrics.

@iris/personalization-testing#

Personalization A/B testing: experiment lifecycle, VariantAssignmentService, outcome measurement, and statistical experiment analysis.

@iris/privacy#

Memory privacy/user-control (libs/iris/memory/privacy, ~30 modules): memory viewer/editor/ deleter/exporter/importer, opt-out, consent manager, retention policy, PII redactor, differential privacy (noise injector, privacy budget), E2E encryption, key management, and a local store. (Note: distinct from the privacy/* tier libraries.)

@iris/memory-retrieval#

High-performance memory retrieval (<100ms target): hybrid semantic + BM25 keyword search, temporal search, multi-factor relevance ranking, and multi-source fusion, composed as MemoryRetriever (with an embedding-service seam).

@iris/memory-semantic#

Semantic memory: knowledge graphs, ConceptUnderstanding, RelationshipTracker, DomainExpertiseModel, UserKnowledgeGraph, SemanticInference, composed as SemanticMemory.

@iris/memory-sharing#

Memory sharing/collaboration: MemoryAccessManager, shared spaces, and synchronization services.

@iris/memory-short-term#

Short-term/working memory: ShortTermMemory, WorkingMemory, recent-references tracking, STM eviction, and temporal decay.

@iris/memory-tools#

LLM-callable memory tools: tool definitions, handlers, and an executor for letting an assistant manage its own memory (with formatToolsForClaude).

@iris/memory-transitions#

Memory-tier transitions: MemoryPromoter (STM→LTM), MemoryDemoter (LTM→archival), ImportanceScorer, a consolidation scheduler, and transition metrics.

@iris/memory-visualization#

Memory visualization: graph, timeline, topic-cluster, and relationship view builders behind a visualization interface.

@iris/memory-writing#

Memory writing: MemoryWriter, MemoryValidator, MemoryMerger (dedup), MemoryUpdater, and a conflict resolver with batch-write support.

@iris/model-routing#

Intelligent model routing/selection: TaskClassifier, CostOptimizer, LatencyOptimizer, QualityEstimator, and configurable RoutingPolicy, composed as ModelRouter (with balanced/cost presets).

@iris/bci#

Brain-computer-interface preparation layer (libs/iris/multimodal/bci): device abstraction, neural-signal processing, intent prediction, thought-action mapping, composed as BCISystem, with frequency-band helpers and an isBCIAvailable capability probe.

@iris/iot#

IoT/smart-home integration: device control across HomeKit/Google-Home/Alexa/SmartThings, room/scene management, automation rules, and sensor data, with extensive platform/device/ sensor constant tables and unit-conversion helpers.

@iris/spatial#

AR/XR spatial computing (Vision Pro/Quest/Android XR/HoloLens): XR session management, spatial anchors, eye/gaze + hand-tracking, plane detection, and a real 3D-math toolkit (createPose, rayPlaneIntersection, raySphereIntersection, bounding-box ops).

@iris/vision-diagrams#

Diagram generation from natural language: FlowchartCreator, MindMapCreator, architecture-diagram creator, composed as DiagramGenerator.

@iris/vision-documents#

Document parsing: PDF/form/receipt/table extraction and layout analysis via a DocumentParser, with a large helper surface (currency formatting, bounding-box math, reading-order sorting, tableToCSV).

@iris/vision-generation#

Image generation/editing: a generation-impl with image creation, edit operations, diagram generation, and screenshot annotation, plus color/aspect-ratio/file-size helpers and model/ format constant tables.

@iris/vision-memory#

Visual memory: ImageMemoryStore, VisualContextRecall, ImageSimilaritySearch, VisualHistoryTimeline.

@iris/multimodal/vision#

Thin V1 facade. Single index.ts for a production-footage analysis surface — metadata, IrisVision* types, default required-domains/quality-profile, and create*/validate*/ serialize* packet functions — not the vision engines (those are the vision-* libs).

@iris/vision-screenshare#

Real-time screen-share pipeline: ScreenShareReceiver, RealTimeAnalysis, ContentUnderstanding, ActionSuggestion.

Visual search: image indexing, ImageToTextQuery, SimilarImageSearch, ObjectSearch, composed as VisualSearchEngine.

@iris/vision-understanding#

Image understanding: object detection, scene description, OCR (50+ languages), and chart interpretation via an ImageAnalyzer, with IoU/bounding-box math and OCR-language tables.

@iris/vision-video#

Video understanding: a VideoAnalyzer for analysis, action recognition, temporal reasoning, summarization, and key-frame extraction, with timestamp/frame-rate/bitrate helpers and codec/resolution tables.

@iris/voice-auth#

Voice biometrics: VoiceBiometrics, VoiceEnrollment, VoiceVerification, and fallback authentication.

@iris/voice-commands#

Voice command handling: VoiceCommandParser, CustomCommandTraining, CommandConfirmation, CommandAliases.

@iris/voice-conversation#

Full-duplex voice conversation (~12 modules): a full-duplex-engine with VAD/turn-taking/ interruption/backchannel handling, prosody and emotion sub-modules, and WebRTC voice transport, with rich turn-completion helpers.

@iris/voice-effects#

Voice effects: VoiceFilter, VoiceModulation, SpeedAdjustment, background-noise addition, with audio utils.

@iris/voice-journaling#

Voice-first journaling: VoiceJournalRecorder, JournalTranscription, JournalSummarization, JournalSearch (semantic/keyword).

@iris/multimodal/voice#

Thin V1 facade. Single index.ts for a production voice-command surface — metadata, IrisVoiceProduction* types, default command definitions routing to drone-fleet/switcher/ recorder, and packet create*/validate*/serialize* functions — not the voice engines.

@iris/voice-pronunciation#

Pronunciation correction: PronunciationDetector, custom-pronunciation dictionary, PronunciationFeedback, AccentAdaptation.

@iris/voice#

Speech-recognition system (libs/iris/multimodal/voice/recognition, ~30 modules): real-time STT (SpeechRecognizer), streaming transcription, VAD, noise processing, accent/dialect handling, multilingual + code-switch detection, speaker diarization/identification/ verification, anti-spoofing, composed as VoiceRecognitionSystem.

@iris/voice-synthesis#

Text-to-speech (~20 modules): a SpeechSynthesizer with voice selection, prosody/emotion control, and streaming, plus concrete ElevenLabs/Cartesia/local/persona provider sub-modules, composed as SynthesisSystem.

@iris/personalization-benchmarking#

Personalization benchmarking (libs/iris/personalization/benchmarking): PersonalizationMetrics, ContextLengthStressTest, PersonalizationRegression, and an LCMPBenchmarkRunner.

@iris/personalization-state-aware#

State-aware personalization: PersonalizedConceptTracker, VariationPerceiver, a personalization context window, StateAwareResponseGenerator, and a ContinualPersonalizationLearner, composed as StateAwarePersonalizationEngine.

@iris/personalization-user-model-persistence#

User-model persistence: snapshot, versioning, migration, export, and privacy-controls modules over a user-model-persistence-service.

@iris/platform-admin#

Enterprise admin-console backend: EnterpriseAdminService with a default config. Small but real (3 modules).

@iris/platform-billing#

Usage billing: UsageTracker, BillingCalculator, InvoiceGenerator, payment integration.

@iris/platform-codegen#

SDK code generation: OpenAPIToSDK, TypeGenerator, ClientGenerator, composed as SDKCodeGenerator.

@iris/agent-builder#

Custom-agent builder framework (libs/iris/platform/customization/agents, ~21 modules): AgentBuilder, ToolBuilder, PersonaBuilder, a TemplateRegistry with built-in templates, plus template marketplace/installer/publisher/rating and a creation wizard.

@iris/whitelabel#

White-label customization (~24 modules): brand/theme/voice-persona/deployment builders + managers, a component registry, preset themes/voices, custom-domain support with a dns-resolver and ssl-provisioner.

@iris/platform-gateway#

API gateway: RequestRouter, MiddlewarePipeline, ResponseTransformer, and APIGateway with a FetchUpstreamTransport.

@iris/plugins#

Plugin architecture (~17 modules): PluginRegistry, PluginLifecycleManager, PluginSandbox, UI-extension/integration managers, and a plugin workflow engine, composed as PluginSystem.

@iris/platform-ratelimit#

Rate limiting: RateLimiter, TieredRateLimits, BurstHandling, and RateLimitHeaders.

@iris/platform-reporting#

Enterprise reporting: EnterpriseReportingService with default metrics-by-type config. Small but real (3 modules).

@iris/platform-sdk-docs#

SDK documentation generation: CodeSampleGenerator, QuickstartGenerator, TutorialGenerator, composed as SDKDocGenerator.

@iris/platform-sdk-testing#

SDK test tooling: IntegrationTests, CompatibilityTests, PerformanceTests, composed as SDKTestSuite.

@iris/platform-sdk-versioning#

SDK version management: SemVerManager, DeprecationManager, breaking-change detector, and a migration-guide generator, composed as SDKVersionManager.

@iris/platform-sla-management#

Enterprise SLA management: an sla-manager for contract tracking, breach detection, incident management, and compliance reporting (barrel re-exports sla-manager/types).

@iris/platform-sla#

Enterprise SLA management — a smaller sibling of platform-sla-management (barrel re-exporting sla-manager/types, 3 modules). Honest overlap: both expose an SLA manager; this one is the leaner variant.

@iris/streaming#

Streaming APIs (libs/iris/platform/streaming): SSE, WebSocket, and a gRPC-streaming abstraction behind a ProtocolFactory, composed as StreamingManager with createStreamingClient.

@iris/platform-webhooks#

Webhook delivery: WebhookManager, EventDispatcher, RetryHandler, WebhookSecurity (signing/verification).

@iris/presence-integration#

Cross-service presence integration: per-domain integrations (Maya/Yemaya/Hathor/Nyx + a generic Oshun one) composed as UnifiedOshunIntegration.

@iris/presence-sync#

Cross-device presence sync: ConversationContinuityManager, TaskHandoffManager, NotificationUnificationManager, PreferenceSyncManager, StateSyncManager, composed as PresenceSyncManager.

@iris/privacy-access#

Access control (~9 modules): permissions/conditions engine, API-key management, OAuth2 + OIDC services, audit logging, and a rate limiter — the access-control layer for privacy-preserving systems.

@iris/privacy-anonymization#

Data anonymization: KAnonymity, LDiversity, a DataAnonymizer, and an anonymization validator, with real quasiKey/pseudonymize/generalizeValue utilities.

@iris/privacy-audit#

Privacy audit: ComplianceChecker, AuditReportGenerator, RemediationSuggester, composed as PrivacyAuditor, with risk-scoring utilities.

@iris/privacy-communication#

Secure communication: TLSEnforcement, CertificatePinning, SecureWebSocket, and a SecureGateway.

@iris/privacy-dashboard#

Privacy dashboard: DataInventoryView, ConsentManagerUI, DeletionRequestsUI, composed as a PrivacyDashboardUI.

@iris/privacy-encryption#

E2E encryption (~14 modules): crypto primitives (AES-256-GCM, ChaCha20-Poly1305, Ed25519), KeyManager (rotation/audit), Double-Ratchet E2E, encrypted storage/model-IO, secure MPC, and zero-knowledge proofs.

@iris/privacy-local#

On-device AI inference (~23 modules): Ollama and llama.cpp runtimes, a ModelManager/ ModelOptimizer, GPU/NPU accelerator detection, offline cache/sync/features, and hybrid cloud/edge routing, composed as a LocalInferenceEngine.

@iris/privacy-minimization#

Data minimization: UnnecessaryDataDetector, DataMinimizer, RetentionEnforcer, AutoPurger, with end-to-end minimization reports.

@iris/privacy-private-cloud#

Private-cloud compute: SecureEnclaveProcessor, EphemeralProcessing, AuditableCompute, HardenedServerConfig (with a hardened baseline), NoDataRetention, composed as a PrivateCloudComputeLayer.

@iris/privacy-safety-behavior#

Behavioral safety/abuse prevention: action confirmation, sandboxed execution, rate limiting, and anomaly detection, composed as BehavioralSafety.

@iris/privacy-safety-content#

Content safety: multi-layer ContentFilter, HarmfulContentDetector, jailbreak resistance, age-appropriate responses, ToxicityDetector, composed as SafetyChecker.

@iris/privacy-safety-transparency#

AI transparency: identity disclosure, capability-limitation disclosure, DecisionExplainer, uncertainty disclosure, composed as TransparencySystem.

@iris/privacy-safety-validation#

Output validation: PIIDetector, BiasDetector, FactualityChecker, composed as an OutputValidationSystem.

@iris/privacy-secrets#

Secret management: SecretStore, CredentialManager, rotation, and a leak scanner.

@iris/privacy-security-compliance#

Compliance certification for SOC2/HIPAA/GDPR/ISO27001 (ComplianceCertificationManager/createComplianceCertificationManager). Small (3 modules) but real.

@iris/privacy-security-dlp#

Data-loss prevention: a single data-loss-prevention module re-exported by the barrel. Thin (the smallest privacy-security lib) but real, not a scaffold.

@iris/privacy-security-injection#

Prompt-injection defense: PromptInjectionDetector, JailbreakDetector, InputSanitizer, composed as DefenseStrategy.

@iris/privacy-security-logging#

Security logging: SecurityLogger, AccessLogger, ChangeLogger, SecurityAlertLogger with default configs.

@iris/privacy-security-pentest#

Penetration testing: VulnerabilityScanner, FuzzTester, SecurityReporter, composed as SecurityTestSuite.

@iris/privacy-security-threats#

Threat detection: AbusePatternsDetector, behavioral AnomalyDetector, ThreatResponse, composed as ThreatDetector, with haversineKm/severity-weight utilities.

@iris/privacy-sovereignty#

Data sovereignty: data-residency controls, GDPR (Arts. 15-22/30/33-34) and CCPA/CPRA compliance modules, cross-border transfer, and right-to-deletion, with an extensive typed surface (residency/minimization/consent/analytics) and a DataSovereigntyManager.

Third-party-model consent: ThirdPartyModelRegistry, ConsentPromptUI, DataMinimizationPreprocessor, ThirdPartyAuditLog, UserPreferenceStore, composed as ThirdPartyConsentFlow.

@iris/privacy-tiered-compute#

Tiered compute routing by sensitivity: ComplexityEstimator, PrivacySensitivityClassifier, UserConsentManager, TierRouter, TierFallbackChain, composed as TieredComputeOrchestrator.

@iris/reasoning-thinking#

Extended-thinking / chain-of-thought: ThinkingMode, ReasoningChain, ThoughtValidator, ThinkingBudget, and a thinking-summary generator.

@iris/sdk-kotlin#

Kotlin SDK (libs/iris/sdk/kotlin): a Gradle module with IrisClient and Agent/Conversation/Knowledge/Memory clients, an HttpClient, typed Types.kt, and a client test — the JVM/Android client view of the Iris API.

iris-sdk-python#

Python SDK (libs/iris/sdk/python): an iris_sdk package with IrisClient, per-domain clients (agent/conversation/knowledge/memory), http.py, typed types.py, and py.typed, packaged via pyproject.toml. (Project name lacks the @iris/ prefix.)

@iris/sdk-rust#

Rust SDK (libs/iris/sdk/rust): a iris_sdk crate (lib.rs) with an async IrisClient, per-domain client modules (agent/conversation/knowledge/memory), an HTTP layer, typed errors/types — type-safe async access to the API.

@iris/sdk-swift#

Swift SDK (libs/iris/sdk/swift): a SwiftPM package (IrisSDK) with IrisClient, Agent/Conversation/Knowledge/Memory clients, an HTTPClient, typed Types.swift, and tests — the Apple-platform client.

@iris/sdk#

The official TypeScript/JavaScript SDK (libs/iris/sdk/typescript): an IrisClient/Iris client with createClientFromEnv, conversation/agent/memory/knowledge sub-clients, and an HTTP layer (client.chat(...)).

@iris/testing-chaos#

Chaos testing: NetworkChaos, ServiceChaos, DataChaos, composed in a chaos-test framework.

@iris/testing-load#

Load testing: ScenarioBuilder, LoadProfiler, LoadReporter, composed as a load-test suite.

@iris/testing#

The Iris test-utilities library (~30 modules): mock model/memory providers, fixtures, conversation/user factories, assertions, benchmarks, and API/event-contract + bias/ factuality/consistency/latency/load test helpers — the shared testing toolkit for the area.

@iris/testing-synthetic#

Synthetic monitoring: SyntheticMonitor, health-check probes, user-journey tests, and alert integration.

@iris/testing-visual#

Visual regression testing: PixelDiffAnalyzer, screenshot comparison, a visual-test framework, and a regression reporter.

@iris/types#

Shared Iris type definitions: conversation/memory/agent/model/user/tool/event types — a contracts-layer (layer:contracts) package consumed across the area.

@iris/voice-empathic-synthesis#

Empathic voice synthesis (libs/iris/voice/empathic-synthesis): EmotionalToneAdapter, ProsodyModulator, EmpatheticMirroring, DynamicToneShift, FrustrationDeescalation, composed as EmpathicSynthesisEngine.

@iris/voice-providers#

Voice provider/profile layer (libs/iris/voice): a provider registry, a profile-registry, voice cloning workflow, and integrity tooling (watermark.ts, abuse detection) — barrel re-exports providers/cloning/integrity.

@iris/voice-ultra-low-latency#

Ultra-low-latency voice (~18 modules): a StreamingTTSPipeline, AudioBufferPreloader, LatencyMonitor, full-duplex interruption handling, endpointing/turn-taking/backchannel models, and a VoiceActivityOptimizationEngine, composed as UltraLowLatencyVoiceEngine.