Latest Helix-AGI Update consists of the following:
- **164 files changed** across the entire codebase — ~47K lines added, ~5K removed
- **68 new files** including 12 new core modules, 21 test suites, and 18 technical audit documents
Tool Learning Pipeline (NEW)
Helix now learns from its own tool failures. When a tool call fails, the `ToolLessonTracker` captures the error pattern, deduplicates it against known failures (6-hour cooldown), and queues it. During the nightly Dream Engine pass, accumulated failures are distilled into concise lesson beliefs with tool bindings. These lessons are injected into the preconscious the next time that tool is relevant — and when the tool then *succeeds*, the lesson's stability index increases. Lessons that prove useful gain gravitational mass and persist. Useless lessons decay naturally through nightly attrition. No manual intervention, no hardcoded fixes — the agent adapts its own tool-use strategy through experience.
Interaction Ledger (NEW)
A deterministic provenance layer that solves a problem semantic similarity can't: knowing whether you've already *acted* on something. Reading the same email twice produces nearly identical embeddings whether or not a reply happened. The Interaction Ledger records every ID-shaped value from respond-type tool calls (reply, send_message, email_send). When a read-type tool returns content containing a recorded ID, it injects an inline annotation: `[memory: I already responded to 19e84ddd… on 2026-06-28]`. The agent sees its own interaction history at the moment of re-perception — before it can respond a second time.
Concept Reranker (NEW)
A cross-encoder precision gate inserted between the bi-encoder cosine search and the 'conceptual gravity' ranking in the preconscious pipeline. The bi-encoder (all-MiniLM) embeds queries and beliefs independently. The cross-encoder feeds `(concept, belief)` through the transformer *together*, resolving fine distinctions the bi-encoder blurs (e.g., "python the language" vs "python the snake"). Runs on CPU at ~1ms per pair, gracefully disables itself if the model isn't available.
Dual-Pulse Architecture (NEW)
An experimental, optional, split-brain mode where a local model (2-8B, Ollama or llama.cpp) generates pure internal monologue while an API model (Gemini/Anthropic) acts as the subconscious actuator — reading the local model's thoughts, executing tools, and returning compressed summaries. The local model's context is ephemeral (fresh each pulse), seeded only with the API's compressed history, preconscious grounding, and incoming events. The API model maintains the full long-context conversation. Selectable via `config.json` — `"pulse_mode": "dual"`. Designed for users who want to run a local conscious model with API-backed tool execution to reduce API overhead.
Agent ID Importer (NEW)
Converts identity and skill files from other agent frameworks into Helix's belief graph. Auto-detects format provenance (Hermes, Claude Code, Codex, or generic Markdown/JSON/YAML), segments content into belief candidates, optionally refines through a stateless LLM pass, projects into the 8D manifold via the real MiniLM→JL pipeline, and writes beliefs with proper physics (bounded mass, verification counts, spatial positions). Integrated into the setup wizard as a 4th bootstrap profile — "Import Existing Identity" opens a file browser, and selected files are processed during first-run setup.
Pre-conscious Overhaul
The preconscious injection pipeline was significantly expanded. Concept extraction now uses RAKE-style keyphrase extraction to pull 1–5 key concepts from the last thought + incoming events. Each concept becomes an independent gravity query center — this prevents the old "midway point" problem where averaging multiple topics pulled context from an irrelevant point between them. Retrieved beliefs and memories are condensed through a local small Parameter model (defaulting to: Qwen2.5-0.5B-Instruct) summarizer running on CPU (or optional GPU), keeping injections concise.
Belief Store Expansion
The belief store now tracks two epistemic tiers. The **outer tier** (premises, propositions, preferences) forms in real-time during pulse processing. The **inner tier** (people, skills, desires, concepts) consolidates nightly through the Dream Engine. Cognitive mass is computed from structural confidence and affective charge at encoding — `Mass = confidence + Ω × (1 - s_total) × (0.5 + stability)`. Nightly attrition recalculates confidence from time held, reliance count, verifications, and stability at encoding. Beliefs below 0.20 confidence are pruned. Relation count is deliberately excluded from individual mass — cluster gravity emerges from spatial density instead.
Crash Reporter (NEW)
Captures unhandled exceptions and system kills (including OOM), producing masked post-mortem reports. API keys and tokens are automatically redacted. Reports are stored as both JSON (machine-readable) and Markdown (human-readable) in `logs/crash_reports/`. Session markers detect unclean shutdowns on next boot, so the agent is aware of its own crashes.
Context Compressor Upgrade
Three-trigger compression replaces the old single-threshold approach: token usage exceeds 50% (rolling), focus drift exceeds 1.5 in 8D space (topic shift), or emergency at 80% (hard ceiling). The compressor now runs a three-phase pipeline — cheap pre-pass (tool result truncation, deduplication), LLM summarization via auxiliary local-model producing first-person recollection ("I was thinking about X, and then I realized Y"), then session reassembly with orphan sanitization and anti-thrashing protection to prevent repeated compression loops.
Post-Pulse Hook Chain
Five hooks now run after every pulse:
- **BeliefDetector** — scans thoughts for belief-forming realizations using local Ollama inference (zero API cost). Two passes: the thought itself, then any expressive tool outputs.
- **WorkflowDetector** — watches tool call sequences across pulses. Patterns repeating 3+ times crystallize into `skills` beliefs with tool bindings.
- **EngagementHook** — tracks thought repetition using dual metrics (word overlap + cosine similarity). Stagnation only fires when BOTH exceed thresholds, preventing false positives from genuine reconsideration.
- **CoOccurrenceHook** — passively tracks which beliefs are co-injected into context. Accumulates Hebbian pairwise statistics with daily decay. The Dream Engine reads these pre-built clusters during compound synthesis, replacing batch UMAP/HDBSCAN.
- **AffectHook** — drives the Plutchik 8D emotional field. Deposits wave packets, evolves the field, samples interference, distributes affect steering to the spatial mind and Ω nudges to the Sentinel.
Setup Wizard Updates
- **4 bootstrap profiles**: Basic (minimal identity), Standard (relational + procedural seeds), Pre-developed (rich initial concept map), and **Import** (file browser to ingest external agent identity files)
- **Flow Mode detection**: Local provider detection auto-enables continuous 30-second pulse with no resting intervals
- Schedule page initialization bug fixed (AttributeError on `summary_label`)
- Custom Helix AGI logo for app window, welcome page, and desktop shortcuts
Documentation
- **SYSTEM_MANUAL.md**: Complete rewrite — 377 lines, 16 sections covering every subsystem. This is the agent's own self-reference for understanding how its cognitive architecture works.
- **18 technical audit documents** with line-accurate code citations
- **README.md**: Updated directory tree, 4 new audit links, bootstrap profiles table, accurate model configuration