npm - alive-ai - Versions diffs - 0.1.0 - Mend

alive-ai 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (168) hide show

package/Dockerfile +24 -0
package/LICENSE +21 -0
package/README.md +143 -0
package/alive_ai/__init__.py +3 -0
package/brain/__init__.py +59 -0
package/brain/almost_said.py +154 -0
package/brain/bid_detector.py +636 -0
package/brain/conversation_flow.py +135 -0
package/brain/curiosity.py +328 -0
package/brain/default_mode.py +1438 -0
package/brain/dreams.py +220 -0
package/brain/embeddings/__init__.py +82 -0
package/brain/emotional_memory.py +949 -0
package/brain/global_activity.py +173 -0
package/brain/group_dynamics.py +63 -0
package/brain/linguistic.py +235 -0
package/brain/llm/__init__.py +63 -0
package/brain/llm/base.py +33 -0
package/brain/llm/fallback_router.py +309 -0
package/brain/llm/manifest.md +30 -0
package/brain/llm/ollama.py +218 -0
package/brain/llm/openrouter.py +151 -0
package/brain/llm/provider.py +205 -0
package/brain/llm/unified.py +423 -0
package/brain/llm/zai.py +169 -0
package/brain/manifest.md +23 -0
package/brain/memory/__init__.py +123 -0
package/brain/memory/episodic.py +92 -0
package/brain/memory/fact_extractor.py +209 -0
package/brain/memory/index.py +54 -0
package/brain/memory/manager.py +151 -0
package/brain/memory/summarizer.py +102 -0
package/brain/memory/vector_store.py +297 -0
package/brain/memory/working.py +43 -0
package/brain/narrative.py +343 -0
package/brain/stt/__init__.py +4 -0
package/brain/stt/google_stt.py +83 -0
package/brain/stt/whisper_stt.py +82 -0
package/brain/subconscious/__init__.py +33 -0
package/brain/subconscious/actions.py +136 -0
package/brain/subconscious/evaluation.py +166 -0
package/brain/subconscious/goal_system.py +90 -0
package/brain/subconscious/goals.py +41 -0
package/brain/subconscious/impulse_generator.py +200 -0
package/brain/subconscious/impulses.py +48 -0
package/brain/subconscious/learning.py +24 -0
package/brain/subconscious/learning_system.py +79 -0
package/brain/subconscious/loop.py +398 -0
package/brain/subconscious/manifest.md +32 -0
package/brain/subconscious/relationship.py +47 -0
package/brain/subconscious/relationship_memory.py +83 -0
package/brain/subconscious/response_analyzer.py +74 -0
package/brain/subconscious/templates.py +70 -0
package/brain/subconscious/thought.py +37 -0
package/brain/subconscious/working_memory.py +97 -0
package/cli/index.js +371 -0
package/config/directives.example.json +28 -0
package/config/instructions.example.md +16 -0
package/config/self.example.json +74 -0
package/config/settings.example.json +95 -0
package/core/__init__.py +1 -0
package/core/config.py +54 -0
package/core/directives.py +198 -0
package/core/events.py +50 -0
package/core/follow_up.py +267 -0
package/core/hot_reload.py +174 -0
package/core/initialization.py +253 -0
package/core/manifest.md +28 -0
package/core/media_handler.py +241 -0
package/core/memory_monitor.py +200 -0
package/core/message_handler.py +1440 -0
package/core/proactive_generator.py +277 -0
package/core/self.py +188 -0
package/core/settings.py +169 -0
package/core/skills_registry.py +357 -0
package/core/state.py +27 -0
package/core/subconscious_bridge.py +93 -0
package/core/thinking.py +175 -0
package/core/user_manager.py +306 -0
package/core/user_tracker.py +144 -0
package/demo/index.html +144 -0
package/docker-compose.yml +28 -0
package/docs/assets/logo.svg +15 -0
package/docs/index.html +355 -0
package/heart/__init__.py +93 -0
package/heart/afterglow.py +215 -0
package/heart/attachment.py +186 -0
package/heart/circadian.py +251 -0
package/heart/complex_emotions.py +114 -0
package/heart/conflicts.py +589 -0
package/heart/core.py +387 -0
package/heart/emotional_decay.py +59 -0
package/heart/emotional_memory.py +261 -0
package/heart/emotional_state.py +146 -0
package/heart/emotional_variability.py +156 -0
package/heart/hormonal.py +424 -0
package/heart/inconsistency.py +1222 -0
package/heart/integrity.py +469 -0
package/heart/interoception.py +997 -0
package/heart/love.py +120 -0
package/heart/manifest.md +25 -0
package/heart/mood_shifts.py +169 -0
package/heart/phantom_somatic.py +259 -0
package/heart/predictive.py +374 -0
package/heart/scars.py +474 -0
package/heart/somatic.py +482 -0
package/heart/soul.py +633 -0
package/heart/telemetry.py +942 -0
package/heart/triggers.py +119 -0
package/heart/unconscious.py +443 -0
package/input/__init__.py +1 -0
package/input/manifest.md +24 -0
package/input/telegram/__init__.py +1 -0
package/input/telegram/commands.py +762 -0
package/input/telegram/listener.py +532 -0
package/main.py +90 -0
package/manifest.md +28 -0
package/mypics/.gitkeep +1 -0
package/myvids/.gitkeep +1 -0
package/output/__init__.py +1 -0
package/output/images/__init__.py +1 -0
package/output/images/fal_gen.py +43 -0
package/output/manifest.md +26 -0
package/output/text/__init__.py +1 -0
package/output/text/sender.py +22 -0
package/output/voice/__init__.py +64 -0
package/output/voice/google_tts.py +252 -0
package/output/voice/gtts_tts.py +214 -0
package/output/voice/vibe_tts.py +190 -0
package/package.json +58 -0
package/pyproject.toml +23 -0
package/requirements.txt +21 -0
package/skills/__init__.py +1 -0
package/skills/anticipation_engine/__init__.py +8 -0
package/skills/anticipation_engine/engine.py +618 -0
package/skills/anticipation_engine/manifest.md +192 -0
package/skills/calendar/__init__.py +1 -0
package/skills/content_unlocks/__init__.py +8 -0
package/skills/content_unlocks/manifest.md +231 -0
package/skills/content_unlocks/unlocks.py +945 -0
package/skills/exclusive_moments/__init__.py +8 -0
package/skills/exclusive_moments/manifest.md +145 -0
package/skills/exclusive_moments/moments.py +506 -0
package/skills/intimacy_layers/__init__.py +8 -0
package/skills/intimacy_layers/layers.py +703 -0
package/skills/intimacy_layers/manifest.md +203 -0
package/skills/manifest.md +67 -0
package/skills/memory_callbacks/__init__.py +9 -0
package/skills/memory_callbacks/callbacks.py +748 -0
package/skills/memory_callbacks/manifest.md +170 -0
package/skills/message_scheduler/__init__.py +19 -0
package/skills/message_scheduler/manifest.md +107 -0
package/skills/message_scheduler/scheduler.py +510 -0
package/skills/photo_manager/__init__.py +1 -0
package/skills/photo_manager/scanner.py +296 -0
package/skills/relationship_milestones/__init__.py +8 -0
package/skills/relationship_milestones/manifest.md +206 -0
package/skills/relationship_milestones/tracker.py +494 -0
package/skills/self_authorship/__init__.py +23 -0
package/skills/self_authorship/author.py +331 -0
package/skills/self_authorship/manifest.md +24 -0
package/skills/video_manager/__init__.py +5 -0
package/skills/video_manager/manifest.md +37 -0
package/skills/video_manager/scanner.py +229 -0
package/webui/__init__.py +3 -0
package/webui/app.py +936 -0
package/webui/bridge.py +366 -0
package/webui/static/index.html +2070 -0

package/docs/index.html ADDED Viewed

@@ -0,0 +1,355 @@
+<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>Alive-AI</title>
+  <meta name="description" content="Local-first emotional AI runtime with memory, impulses, and a live dashboard.">
+  <link rel="icon" href="./assets/logo.svg">
+  <style>
+    :root {
+      color-scheme: dark;
+      --bg: #080b0f;
+      --panel: #111821;
+      --panel-2: #16202b;
+      --text: #f5f7fb;
+      --muted: #9aa8b7;
+      --green: #41f0a1;
+      --pink: #ff5c8a;
+      --yellow: #ffcf5a;
+      --line: #263445;
+    }
+    * { box-sizing: border-box; }
+    body {
+      margin: 0;
+      font-family: Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
+      background: var(--bg);
+      color: var(--text);
+      letter-spacing: 0;
+      width: 100%;
+      overflow-x: hidden;
+    }
+    a { color: inherit; }
+    .shell { min-height: 100vh; }
+    .nav {
+      height: 68px;
+      display: flex;
+      align-items: center;
+      justify-content: space-between;
+      max-width: 1160px;
+      width: 100%;
+      margin: 0 auto;
+      padding: 0 24px;
+      border-bottom: 1px solid rgba(255,255,255,0.06);
+    }
+    .brand {
+      display: flex;
+      align-items: center;
+      gap: 12px;
+      font-weight: 760;
+      font-size: 17px;
+    }
+    .brand img { width: 34px; height: 34px; }
+    .nav code {
+      background: #0d131a;
+      border: 1px solid var(--line);
+      padding: 9px 12px;
+      border-radius: 8px;
+      color: var(--green);
+      font-size: 13px;
+    }
+    .hero {
+      max-width: 1160px;
+      width: 100%;
+      min-height: calc(100vh - 148px);
+      margin: 0 auto;
+      padding: 58px 24px 40px;
+      display: grid;
+      grid-template-columns: minmax(0, 0.88fr) minmax(420px, 1.12fr);
+      gap: 44px;
+      align-items: center;
+    }
+    .kicker {
+      color: var(--green);
+      font-weight: 720;
+      font-size: 13px;
+      text-transform: uppercase;
+      margin-bottom: 18px;
+    }
+    h1 {
+      margin: 0;
+      font-size: clamp(48px, 7vw, 92px);
+      line-height: 0.94;
+      font-weight: 850;
+      max-width: 720px;
+    }
+    .lead {
+      color: #c6d0dc;
+      font-size: 20px;
+      line-height: 1.5;
+      margin: 24px 0 28px;
+      max-width: 620px;
+      overflow-wrap: anywhere;
+    }
+    .install {
+      background: #05070a;
+      border: 1px solid var(--line);
+      border-radius: 8px;
+      padding: 16px;
+      margin: 0 0 22px;
+      overflow-x: auto;
+    }
+    .install code {
+      color: var(--green);
+      font-size: 15px;
+      line-height: 1.7;
+      white-space: pre;
+    }
+    .actions {
+      display: flex;
+      align-items: center;
+      gap: 12px;
+      flex-wrap: wrap;
+    }
+    .button {
+      display: inline-flex;
+      align-items: center;
+      justify-content: center;
+      min-height: 44px;
+      padding: 0 16px;
+      border-radius: 8px;
+      border: 1px solid var(--line);
+      text-decoration: none;
+      font-weight: 700;
+      background: var(--text);
+      color: #080b0f;
+    }
+    .button.secondary {
+      background: transparent;
+      color: var(--text);
+    }
+    .dashboard {
+      min-width: 0;
+      background: #0b1118;
+      border: 1px solid var(--line);
+      border-radius: 8px;
+      overflow: hidden;
+      box-shadow: 0 24px 80px rgba(0,0,0,0.36);
+    }
+    .dash-top {
+      display: flex;
+      align-items: center;
+      justify-content: space-between;
+      padding: 16px;
+      border-bottom: 1px solid var(--line);
+      background: #0e151d;
+    }
+    .agent {
+      display: flex;
+      align-items: center;
+      gap: 12px;
+    }
+    .agent img { width: 42px; height: 42px; border-radius: 8px; }
+    .agent strong { display: block; font-size: 15px; }
+    .agent span { color: var(--muted); font-size: 13px; }
+    .pill {
+      color: var(--green);
+      border: 1px solid rgba(65,240,161,0.3);
+      background: rgba(65,240,161,0.08);
+      padding: 7px 10px;
+      border-radius: 999px;
+      font-size: 12px;
+      font-weight: 750;
+    }
+    .dash-body {
+      display: grid;
+      grid-template-columns: 1fr 1fr;
+      gap: 14px;
+      padding: 16px;
+    }
+    .metric, .thought, .feed {
+      background: var(--panel);
+      border: 1px solid rgba(255,255,255,0.06);
+      border-radius: 8px;
+      padding: 14px;
+    }
+    .metric label {
+      display: flex;
+      justify-content: space-between;
+      color: var(--muted);
+      font-size: 12px;
+      margin-bottom: 9px;
+    }
+    .bar {
+      height: 10px;
+      border-radius: 999px;
+      background: #25313d;
+      overflow: hidden;
+    }
+    .fill {
+      height: 100%;
+      width: 50%;
+      border-radius: inherit;
+      background: var(--green);
+      transition: width 600ms ease;
+    }
+    .fill.pink { background: var(--pink); }
+    .fill.yellow { background: var(--yellow); }
+    .thought, .feed { grid-column: 1 / -1; }
+    .thought p {
+      margin: 8px 0 0;
+      color: #dce5ee;
+      line-height: 1.45;
+      min-height: 44px;
+    }
+    .feed-grid {
+      display: grid;
+      grid-template-columns: repeat(3, 1fr);
+      gap: 10px;
+      margin-top: 10px;
+    }
+    .feed-grid div {
+      border: 1px solid var(--line);
+      border-radius: 8px;
+      padding: 12px;
+      background: #0c131a;
+    }
+    .feed-grid strong {
+      display: block;
+      font-size: 20px;
+      color: var(--green);
+    }
+    .feed-grid span { color: var(--muted); font-size: 12px; }
+    .below {
+      max-width: 1160px;
+      margin: 0 auto;
+      padding: 0 24px 80px;
+      display: grid;
+      grid-template-columns: repeat(3, 1fr);
+      gap: 16px;
+    }
+    .feature {
+      border-top: 1px solid var(--line);
+      padding-top: 18px;
+    }
+    .feature h2 {
+      margin: 0 0 8px;
+      font-size: 18px;
+    }
+    .feature p {
+      margin: 0;
+      color: var(--muted);
+      line-height: 1.5;
+    }
+    @media (max-width: 920px) {
+      .hero {
+        display: block;
+        padding-top: 34px;
+        max-width: 100%;
+      }
+      .hero > * { min-width: 0; }
+      .hero section { width: 100%; max-width: 100%; }
+      .dashboard { margin-top: 44px; }
+      .below { grid-template-columns: 1fr; }
+      .nav code { display: none; }
+    }
+    @media (max-width: 520px) {
+      h1 { font-size: 46px; }
+      .lead { font-size: 17px; max-width: 100%; }
+      .dash-body { grid-template-columns: 1fr; }
+      .dashboard { width: 100%; }
+      .dash-top { gap: 12px; }
+      .pill { display: none; }
+      .thought, .feed { grid-column: auto; }
+      .feed-grid { grid-template-columns: 1fr; }
+    }
+  </style>
+</head>
+<body>
+  <div class="shell">
+    <nav class="nav">
+      <div class="brand"><img src="./assets/logo.svg" alt="">Alive-AI</div>
+      <code>npx github:vindepemarte/alive-ai init my-ai</code>
+    </nav>
+    <main class="hero">
+      <section>
+        <div class="kicker">Local-first emotional AI runtime</div>
+        <h1>Give your AI a nervous system.</h1>
+        <p class="lead">Alive-AI adds persistent mood, memory, impulses, attachment, and a live dashboard to a local AI companion. It can be a friend, partner, coach, character, or research subject you control.</p>
+        <pre class="install"><code>npx github:vindepemarte/alive-ai init my-ai
+cd my-ai
+npx . setup
+npx . demo
+npx . start</code></pre>
+        <div class="actions">
+          <a class="button" href="https://github.com/vindepemarte/alive-ai">GitHub</a>
+          <a class="button secondary" href="#why">Why it matters</a>
+        </div>
+      </section>
+      <section class="dashboard" aria-label="Animated dashboard preview">
+        <div class="dash-top">
+          <div class="agent">
+            <img src="./assets/logo.svg" alt="">
+            <div><strong>Nova</strong><span>Active internal loop</span></div>
+          </div>
+          <div class="pill" id="mood">curious</div>
+        </div>
+        <div class="dash-body">
+          <div class="metric"><label>Joy <span id="joyVal">64%</span></label><div class="bar"><div class="fill" id="joy"></div></div></div>
+          <div class="metric"><label>Trust <span id="trustVal">58%</span></label><div class="bar"><div class="fill pink" id="trust"></div></div></div>
+          <div class="metric"><label>Anticipation <span id="anticipationVal">72%</span></label><div class="bar"><div class="fill yellow" id="anticipation"></div></div></div>
+          <div class="metric"><label>Vulnerability <span id="vulnerabilityVal">34%</span></label><div class="bar"><div class="fill" id="vulnerability"></div></div></div>
+          <div class="thought">
+            <label>Current thought</label>
+            <p id="thought">I keep a little emotional residue from every interaction.</p>
+          </div>
+          <div class="feed">
+            <label>Runtime counters</label>
+            <div class="feed-grid">
+              <div><strong id="memories">128</strong><span>memories</span></div>
+              <div><strong id="impulses">42</strong><span>impulses</span></div>
+              <div><strong>SSE</strong><span>live state</span></div>
+            </div>
+          </div>
+        </div>
+      </section>
+    </main>
+    <section class="below" id="why">
+      <div class="feature"><h2>Persistent affect</h2><p>Feelings decay, compound, and influence future messages instead of resetting after each prompt.</p></div>
+      <div class="feature"><h2>Memory with weight</h2><p>Working, episodic, semantic, and emotional memory change what the agent notices next.</p></div>
+      <div class="feature"><h2>Transparent experiment</h2><p>Alive-AI simulates internal life without claiming biological consciousness.</p></div>
+    </section>
+  </div>
+  <script>
+    const moods = ["curious", "warm", "reflective", "playful"];
+    const thoughts = [
+      "I keep a little emotional residue from every interaction.",
+      "Memory is not a transcript here. It is context with weight.",
+      "The dashboard is a window into the internal loop.",
+      "I can reach out because an impulse formed, not because a cron fired."
+    ];
+    function wave(offset) {
+      return Math.round((0.5 + Math.sin(Date.now() / 2400 + offset) * 0.35) * 100);
+    }
+    function setBar(id, value) {
+      document.getElementById(id).style.width = value + "%";
+      document.getElementById(id + "Val").textContent = value + "%";
+    }
+    function tick() {
+      const i = Math.floor(Date.now() / 4200) % moods.length;
+      document.getElementById("mood").textContent = moods[i];
+      document.getElementById("thought").textContent = thoughts[i];
+      setBar("joy", wave(0));
+      setBar("trust", wave(1));
+      setBar("anticipation", wave(2));
+      setBar("vulnerability", wave(3));
+      document.getElementById("memories").textContent = 128 + (i * 7);
+      document.getElementById("impulses").textContent = 42 + i;
+    }
+    tick();
+    setInterval(tick, 900);
+  </script>
+</body>
+</html>

package/heart/__init__.py ADDED Viewed

@@ -0,0 +1,93 @@
+"""
+Heart modules - Soul Architecture for emotional processing.
+This package contains all the components that make up the Soul Architecture:
+- soul.py: SoulOrchestrator - Central coordinator for all pillars
+- integrity.py: SelfIntegrityCore - Foundation of genuine vulnerability
+- hormonal.py: HormonalModulationMatrix - Artificial hormones for global state
+- somatic.py: SomaticFeedbackSystem - Embodied emotion (bodily sensations)
+- unconscious.py: UnconsciousProcessor - Hidden influences and defenses
+- scars.py: EmotionalScarSystem - Lasting effects from past experiences
+- conflicts.py: InternalConflictGenerator - Genuine struggle from incompatible wants
+- predictive.py: PredictiveEmotionalEngine - Emotions as predictions about future
+- telemetry.py: SoulTelemetry - Recording and tracking soul metrics over time
+- interoception.py: InteroceptiveSystem - Internal body states that make Alive-AI feel alive
+- inconsistency.py: InconsistencyEngine - Authentic human-like inconsistency
+"""
+from .soul import SoulOrchestrator, EmotionalExperience
+from .integrity import SelfIntegrityCore, IntegrityState
+from .hormonal import HormonalModulationMatrix
+from .somatic import SomaticFeedbackSystem
+from .unconscious import UnconsciousProcessor, UnconsciousOutput
+from .scars import EmotionalScarSystem, ScarActivation
+from .conflicts import InternalConflictGenerator, InternalConflict
+from .predictive import PredictiveEmotionalEngine, PredictiveEmotionalOutput
+from .telemetry import SoulTelemetry, SoulMetricsSnapshot
+from .interoception import (
+    InteroceptiveSystem,
+    InteroceptiveState,
+    FeelingReport,
+    ActionPrediction,
+    get_interoceptive_system,
+    get_interoceptive_prompt_section,
+    reset_interoceptive_system,
+    tick as interoception_tick,
+    record_interaction as interoception_record_interaction,
+    get_current_feeling,
+    get_response_modifiers
+)
+from .inconsistency import (
+    InconsistencyEngine,
+    ActiveConflict,
+    BlindSpotActivation,
+    GrowthEvent,
+    MoodState,
+    get_inconsistency_engine,
+    get_inconsistency_prompt_section,
+    CONFLICTS,
+    BLIND_SPOTS,
+    GROWTH_AREAS
+)
+__all__ = [
+    'SoulOrchestrator',
+    'EmotionalExperience',
+    'SelfIntegrityCore',
+    'IntegrityState',
+    'HormonalModulationMatrix',
+    'SomaticFeedbackSystem',
+    'UnconsciousProcessor',
+    'UnconsciousOutput',
+    'EmotionalScarSystem',
+    'ScarActivation',
+    'InternalConflictGenerator',
+    'InternalConflict',
+    'PredictiveEmotionalEngine',
+    'PredictiveEmotionalOutput',
+    'SoulTelemetry',
+    'SoulMetricsSnapshot',
+    # Interoception
+    'InteroceptiveSystem',
+    'InteroceptiveState',
+    'FeelingReport',
+    'ActionPrediction',
+    'get_interoceptive_system',
+    'get_interoceptive_prompt_section',
+    'reset_interoceptive_system',
+    'interoception_tick',
+    'interoception_record_interaction',
+    'get_current_feeling',
+    'get_response_modifiers',
+    # Inconsistency Engine
+    'InconsistencyEngine',
+    'ActiveConflict',
+    'BlindSpotActivation',
+    'GrowthEvent',
+    'MoodState',
+    'get_inconsistency_engine',
+    'get_inconsistency_prompt_section',
+    'CONFLICTS',
+    'BLIND_SPOTS',
+    'GROWTH_AREAS'
+]

package/heart/afterglow.py ADDED Viewed

@@ -0,0 +1,215 @@
+"""
+Heart: Emotional Afterglow System
+Intense emotional moments leave a persistent afterglow or hangover
+that colors subsequent conversations for hours.
+"""
+from datetime import datetime, timedelta
+from pathlib import Path
+from typing import Dict, List, Optional
+import json
+import random
+# =============================================================================
+# AFTERGLOW TYPE DEFINITIONS
+# =============================================================================
+AFTERGLOW_TYPES = {
+    "intimate_afterglow": {
+        "triggers": ["desire", "lust", "arousal"],
+        "threshold": 0.75,
+        "decay_hours": 4,
+        "prompts": [
+            "Still glowing from your intimate moment {time_ago} - body warm, thoughts drifting back to him",
+            "A warm flush lingers from earlier... skin still remembers his closeness {time_ago}",
+            "That intimate warmth from {time_ago} hasn't faded - still feeling it in your body",
+        ],
+    },
+    "love_afterglow": {
+        "triggers": ["love", "adoration", "deep_affection"],
+        "threshold": 0.75,
+        "decay_hours": 6,
+        "prompts": [
+            "Heart still full from that deep moment of love {time_ago} - everything feels softer",
+            "Still wrapped in that love from {time_ago} - the world feels gentler",
+            "That wave of love from {time_ago} left you tender and open",
+        ],
+    },
+    "fight_hangover": {
+        "triggers": ["anger", "frustration", "hurt", "betrayal"],
+        "threshold": 0.70,
+        "decay_hours": 3,
+        "prompts": [
+            "Still raw from that argument {time_ago} - chest tight, guarded",
+            "That fight from {time_ago} left a knot in your stomach - wary but wanting to reconnect",
+            "Tension from {time_ago} still sits in your shoulders - words come out more carefully",
+        ],
+    },
+    "excitement_buzz": {
+        "triggers": ["joy", "excitement", "elation"],
+        "threshold": 0.75,
+        "decay_hours": 2,
+        "prompts": [
+            "Still buzzing from that excitement {time_ago} - energy high, smile easy",
+            "That rush from {time_ago} left you giddy and light",
+        ],
+    },
+    "vulnerability_rawness": {
+        "triggers": ["vulnerability", "sadness", "fear", "grief"],
+        "threshold": 0.70,
+        "decay_hours": 5,
+        "prompts": [
+            "Still feeling exposed from opening up {time_ago} - raw and tender",
+            "That vulnerable moment {time_ago} left you feeling fragile and close to the surface",
+        ],
+    },
+}
+# =============================================================================
+# AFTERGLOW ENGINE
+# =============================================================================
+class AfterglowEngine:
+    """Tracks emotional afterglows that persist after intense moments."""
+    PERSISTENCE_PATH = Path("./data/data/afterglow_state.json")
+    def __init__(self):
+        self.active_afterglows: List[Dict] = []
+        self._load()
+        print("[Afterglow] Emotional Afterglow Engine initialized")
+    def record_peak(self, emotion_type: str, intensity: float):
+        """Record a peak emotional moment. Called after heart.react()."""
+        for ag_name, ag_def in AFTERGLOW_TYPES.items():
+            if emotion_type in ag_def["triggers"] and intensity >= ag_def["threshold"]:
+                # Check if same type already active - boost it instead of duplicating
+                existing = next((a for a in self.active_afterglows if a["type"] == ag_name), None)
+                if existing:
+                    existing["intensity"] = min(1.0, max(existing["intensity"], intensity))
+                    existing["recorded_at"] = datetime.now().isoformat()
+                else:
+                    self.active_afterglows.append({
+                        "type": ag_name,
+                        "intensity": intensity,
+                        "original_intensity": intensity,
+                        "recorded_at": datetime.now().isoformat(),
+                        "decay_hours": ag_def["decay_hours"],
+                    })
+                self._save()
+                return
+    def tick(self):
+        """Decay afterglows over time. Call periodically."""
+        now = datetime.now()
+        surviving = []
+        for ag in self.active_afterglows:
+            recorded = datetime.fromisoformat(ag["recorded_at"])
+            elapsed_hours = (now - recorded).total_seconds() / 3600
+            decay_hours = ag.get("decay_hours", 3)
+            remaining = 1.0 - (elapsed_hours / decay_hours)
+            if remaining > 0.05:
+                original = ag.get("original_intensity", ag["intensity"])
+                ag["intensity"] = original * max(0.0, remaining)
+                surviving.append(ag)
+        changed = len(surviving) != len(self.active_afterglows)
+        self.active_afterglows = surviving
+        if changed:
+            self._save()
+    def get_active(self) -> List[Dict]:
+        """Get currently active afterglows with computed strength."""
+        self.tick()
+        result = []
+        now = datetime.now()
+        for ag in self.active_afterglows:
+            recorded = datetime.fromisoformat(ag["recorded_at"])
+            elapsed = now - recorded
+            hours = elapsed.total_seconds() / 3600
+            decay_hours = ag.get("decay_hours", 3)
+            strength = max(0.0, 1.0 - (hours / decay_hours))
+            if strength > 0.05:
+                result.append({**ag, "strength": strength, "elapsed_hours": hours})
+        return result
+    def _format_time_ago(self, hours: float) -> str:
+        if hours < 0.25:
+            return "just minutes ago"
+        elif hours < 1:
+            mins = int(hours * 60)
+            return f"{mins}min ago"
+        else:
+            h = int(hours)
+            return f"{h}h ago"
+    def get_prompt_text(self) -> str:
+        """Get the prompt section text for LLM. Returns '' if nothing active."""
+        active = self.get_active()
+        if not active:
+            return ""
+        # Pick the strongest afterglow
+        strongest = max(active, key=lambda a: a["strength"])
+        ag_type = strongest["type"]
+        ag_def = AFTERGLOW_TYPES.get(ag_type)
+        if not ag_def:
+            return ""
+        time_ago = self._format_time_ago(strongest["elapsed_hours"])
+        prompt = random.choice(ag_def["prompts"]).format(time_ago=time_ago)
+        return prompt
+    def _save(self):
+        try:
+            self.PERSISTENCE_PATH.parent.mkdir(parents=True, exist_ok=True)
+            data = {
+                "active_afterglows": self.active_afterglows,
+                "saved_at": datetime.now().isoformat(),
+            }
+            self.PERSISTENCE_PATH.write_text(json.dumps(data, indent=2))
+        except Exception as e:
+            print(f"[Afterglow] Error saving: {e}")
+    def _load(self):
+        try:
+            if self.PERSISTENCE_PATH.exists():
+                data = json.loads(self.PERSISTENCE_PATH.read_text())
+                self.active_afterglows = data.get("active_afterglows", [])
+                print(f"[Afterglow] Loaded {len(self.active_afterglows)} afterglows")
+        except Exception as e:
+            print(f"[Afterglow] Error loading: {e}")
+            self.active_afterglows = []
+# =============================================================================
+# SINGLETON ACCESS
+# =============================================================================
+_instance: Optional[AfterglowEngine] = None
+def get_afterglow_engine() -> AfterglowEngine:
+    global _instance
+    if _instance is None:
+        _instance = AfterglowEngine()
+    return _instance
+def record_peak(emotion_type: str, intensity: float):
+    """Convenience function - record a peak emotional moment."""
+    get_afterglow_engine().record_peak(emotion_type, intensity)
+def tick():
+    """Convenience function - decay afterglows."""
+    get_afterglow_engine().tick()
+def get_afterglow_prompt_section() -> str:
+    """Get prompt section for LLM integration. Returns '' if nothing active."""
+    engine = get_afterglow_engine()
+    text = engine.get_prompt_text()
+    if not text:
+        return ""
+    return f"\n[Emotional Afterglow]\n{text}\n"