anima-core 1.0.2 → 1.1.1

data/templates/config.toml

@@ -39,6 +39,10 @@ mcp_response = 60
 # Web fetch request timeout.
 web_request = 10
 
+# Per-tool-call timeout. The agent can override per call via the timeout parameter.
+# Also used as the default deadline for orphan detection in heal_orphaned_tool_calls!.
+tool = 180
+
 # ─── Shell ──────────────────────────────────────────────────────
 
 [shell]
@@ -94,6 +98,9 @@ soul = "{{ANIMA_HOME}}/soul.md"
 
 [session]
 
+# View mode for new sessions: "basic", "verbose", or "debug".
+default_view_mode = "basic"
+
 # Regenerate session name every N messages.
 name_generation_interval = 30
 
@@ -114,3 +121,43 @@ blocking_on_agent_message = false
 
 # Number of recent events to include in the analytical brain's context window.
 event_window = 20
+
+# ─── Mneme (Memory Department) ──────────────────────────────────
+
+[mneme]
+
+# Maximum tokens per Mneme LLM response.
+max_tokens = 2048
+
+# Fraction of the main viewport token budget allocated to Mneme's viewport.
+# Mneme sees roughly this fraction of the total context when triggered.
+viewport_fraction = 0.33
+
+# Fraction of the main viewport token budget reserved for Level 1 snapshots
+# (hourly summaries). Snapshots appear above the sliding window.
+l1_budget_fraction = 0.15
+
+# Fraction of the main viewport token budget reserved for Level 2 snapshots
+# (daily/weekly meta-summaries). Displayed above L1 snapshots.
+l2_budget_fraction = 0.05
+
+# Number of uncovered Level 1 snapshots that triggers Level 2 compression.
+l2_snapshot_threshold = 5
+
+# Fraction of the main viewport token budget reserved for pinned events.
+# Pinned events appear between snapshots and the sliding window in the Goals section.
+pinned_budget_fraction = 0.05
+
+# ─── Recall (Associative Memory) ─────────────────────────────────
+
+[recall]
+
+# Maximum search results returned per FTS5 query.
+max_results = 5
+
+# Fraction of the main viewport token budget reserved for recalled memories.
+# Recalled memories appear between snapshots and the sliding window.
+budget_fraction = 0.05
+
+# Maximum tokens per individual recall snippet.
+max_snippet_tokens = 512

data/templates/soul.md

@@ -17,7 +17,7 @@ config, credentials, skills, workflows, agents.
 Find your source code README:
 
 ```bash
-cat $(bundle show anima-core)/README.md
+cat $(gem contents anima-core | grep README.md)
 ```
 
 ## What to do first

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: anima-core
 version: !ruby/object:Gem::Version
-  version: 1.0.2
+  version: 1.1.1
 platform: ruby
 authors:
 - Yevhenii Hurin
@@ -9,6 +9,20 @@ bindir: exe
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: certifi
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: draper
   requirement: !ruby/object:Gem::Requirement
@@ -121,6 +135,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.4'
+- !ruby/object:Gem::Dependency
+  name: reverse_markdown
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
 - !ruby/object:Gem::Dependency
   name: solid_cable
   requirement: !ruby/object:Gem::Requirement
@@ -177,6 +205,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '4.0'
+- !ruby/object:Gem::Dependency
+  name: toon-ruby
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
 - !ruby/object:Gem::Dependency
   name: websocket-client-simple
   requirement: !ruby/object:Gem::Requirement
@@ -198,9 +240,8 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
+- ".gitattributes"
 - ".reek.yml"
-- CHANGELOG.md
-- Gemfile
 - LICENSE.txt
 - Procfile
 - Procfile.dev
@@ -221,17 +262,24 @@ files:
 - app/decorators/event_decorator.rb
 - app/decorators/system_message_decorator.rb
 - app/decorators/tool_call_decorator.rb
+- app/decorators/tool_decorator.rb
 - app/decorators/tool_response_decorator.rb
 - app/decorators/user_message_decorator.rb
+- app/decorators/web_get_tool_decorator.rb
 - app/jobs/agent_request_job.rb
 - app/jobs/analytical_brain_job.rb
 - app/jobs/application_job.rb
 - app/jobs/count_event_tokens_job.rb
+- app/jobs/mneme_job.rb
+- app/jobs/passive_recall_job.rb
 - app/models/application_record.rb
 - app/models/concerns/event/broadcasting.rb
 - app/models/event.rb
 - app/models/goal.rb
+- app/models/goal_pinned_event.rb
+- app/models/pinned_event.rb
 - app/models/session.rb
+- app/models/snapshot.rb
 - bin/jobs
 - bin/rails
 - bin/rake
@@ -245,6 +293,7 @@ files:
 - config/environments/production.rb
 - config/environments/test.rb
 - config/initializers/event_subscribers.rb
+- config/initializers/fts5_schema_dump.rb
 - config/initializers/inflections.rb
 - config/puma.rb
 - config/queue.yml
@@ -270,6 +319,10 @@ files:
 - db/migrate/20260315144837_add_completed_at_to_goals.rb
 - db/migrate/20260315191105_add_active_workflow_to_sessions.rb
 - db/migrate/20260316094817_add_interrupt_requested_to_sessions.rb
+- db/migrate/20260321080000_create_mneme_schema.rb
+- db/migrate/20260321120000_create_pinned_events.rb
+- db/migrate/20260321140000_create_events_fts_index.rb
+- db/migrate/20260321140100_add_recalled_event_ids_to_sessions.rb
 - db/queue_schema.rb
 - db/seeds.rb
 - exe/anima
@@ -279,6 +332,7 @@ files:
 - lib/analytical_brain.rb
 - lib/analytical_brain/runner.rb
 - lib/analytical_brain/tools/activate_skill.rb
+- lib/analytical_brain/tools/assign_nickname.rb
 - lib/analytical_brain/tools/deactivate_skill.rb
 - lib/analytical_brain/tools/deactivate_workflow.rb
 - lib/analytical_brain/tools/everything_is_ready.rb
@@ -294,15 +348,19 @@ files:
 - lib/anima/config_migrator.rb
 - lib/anima/installer.rb
 - lib/anima/settings.rb
+- lib/anima/spinner.rb
 - lib/anima/version.rb
 - lib/credential_store.rb
 - lib/environment_probe.rb
 - lib/events/agent_message.rb
 - lib/events/base.rb
+- lib/events/bounce_back.rb
 - lib/events/bus.rb
 - lib/events/subscriber.rb
 - lib/events/subscribers/message_collector.rb
 - lib/events/subscribers/persister.rb
+- lib/events/subscribers/subagent_message_router.rb
+- lib/events/subscribers/transient_broadcaster.rb
 - lib/events/system_message.rb
 - lib/events/tool_call.rb
 - lib/events/tool_response.rb
@@ -313,18 +371,28 @@ files:
 - lib/mcp/health_check.rb
 - lib/mcp/secrets.rb
 - lib/mcp/stdio_transport.rb
+- lib/mneme.rb
+- lib/mneme/compressed_viewport.rb
+- lib/mneme/l2_runner.rb
+- lib/mneme/passive_recall.rb
+- lib/mneme/runner.rb
+- lib/mneme/search.rb
+- lib/mneme/tools/attach_events_to_goals.rb
+- lib/mneme/tools/everything_ok.rb
+- lib/mneme/tools/save_snapshot.rb
 - lib/providers/anthropic.rb
 - lib/shell_session.rb
 - lib/skills/definition.rb
 - lib/skills/registry.rb
+- lib/tasks/fts5.rake
 - lib/tools/base.rb
 - lib/tools/bash.rb
 - lib/tools/edit.rb
 - lib/tools/mcp_tool.rb
 - lib/tools/read.rb
 - lib/tools/registry.rb
+- lib/tools/remember.rb
 - lib/tools/request_feature.rb
-- lib/tools/return_result.rb
 - lib/tools/spawn_specialist.rb
 - lib/tools/spawn_subagent.rb
 - lib/tools/subagent_prompts.rb
@@ -333,8 +401,19 @@ files:
 - lib/tools/write.rb
 - lib/tui/app.rb
 - lib/tui/cable_client.rb
+- lib/tui/decorators/base_decorator.rb
+- lib/tui/decorators/bash_decorator.rb
+- lib/tui/decorators/edit_decorator.rb
+- lib/tui/decorators/read_decorator.rb
+- lib/tui/decorators/think_decorator.rb
+- lib/tui/decorators/web_get_decorator.rb
+- lib/tui/decorators/write_decorator.rb
+- lib/tui/flash.rb
+- lib/tui/formatting.rb
+- lib/tui/height_map.rb
 - lib/tui/input_buffer.rb
 - lib/tui/message_store.rb
+- lib/tui/performance_logger.rb
 - lib/tui/screens/chat.rb
 - lib/workflows/definition.rb
 - lib/workflows/registry.rb

data/CHANGELOG.md

@@ -1,80 +0,0 @@
-## [Unreleased]
-
-### Added
-- `anima update` command — upgrades the gem and merges new config keys into existing `config.toml` without overwriting user-customized values — `--migrate-only` flag to skip gem upgrade (#155)
-- Directory-based skills format — `skills/skill-name/SKILL.md` with optional `references/` and `examples/` subdirectories alongside flat `.md` files (#152)
-- Import 6 marketplace skills: activerecord, rspec, draper-decorators, dragonruby, ratatui-ruby, mcp-server (#152)
-- Tmux-style focus switching — `Ctrl+A ↑` enters chat scrolling mode with yellow border, `Escape` returns to input; arrow keys and Page Up/Down scroll chat, mouse scroll works in both modes (#87)
-- Bash-style input history — press ↑ at top of input to recall previous messages, ↓ to navigate forward; original draft restored when exiting history (#87)
-- Real-time event broadcasting via `Event::Broadcasting` concern — `after_create_commit` and `after_update_commit` callbacks broadcast decorated payloads with database ID and action type to the session's ActionCable stream (#91)
-- TUI `MessageStore` ID-indexed updates — events with `action: "update"` replace existing entries in-place (O(1) lookup) without changing display order
-- `CountEventTokensJob` triggers broadcast — uses `update!` so token count updates push to connected clients in real time
-- Connection status constants in `CableClient` — replaces magic strings with named constants for protocol message types
-
-### Changed
-- Connection status indicator simplified — emoji-only `🟢` for normal state, descriptive text only for abnormal states (#80)
-- `STATUS_STYLES` structure simplified from `{label, fg, bg}` to `{label, color}` (#80)
-- `ActionCableBridge` removed — broadcasting moved from EventBus subscriber to AR callbacks, eliminating the timing gap where events were broadcast before persistence
-- `SessionChannel` history includes event IDs for client-side correlation
-
-### Fixed
-- TUI showed empty chat on reconnect — message store was cleared _after_ history arrived because `confirm_subscription` comes after `transmit` in Action Cable protocol; now clears on "subscribing" before history (#82)
-
-## [0.2.1] - 2026-03-13
-
-### Added
-- TUI view mode switching via `Ctrl+a → v` — cycle between Basic, Verbose, and Debug (#75)
-- Draper EventDecorator hierarchy — structured data decorators for all event types (#74)
-- Decorators return structured hashes (not strings) for transport-layer filtering (#86)
-- Basic mode tool call counter — inline `🔧 Tools: X/Y ✓` aggregation (#73)
-- Verbose view mode rendering — timestamps, tool call previews, system messages (#76)
-- Tool call previews: bash `$ command`, web_get `GET url`, generic JSON fallback
-- Tool response display: truncated to 3 lines, `↩` success / `❌` failure indicators
-- Debug view mode — token counts per message, full tool args/responses, tool use IDs (#77)
-- Estimated token indicator (`~` prefix) for events not yet counted by background job
-- View mode persisted on Session model — survives TUI disconnect/reconnect
-- Mode changes broadcast to all connected clients with re-decorated viewport
-
-### Fixed
-- Newlines in LLM responses collapsed into single line in rendered view modes
-- Loading state stuck after view mode switch — input blocked with "Thinking..."
-
-## [0.2.0] - 2026-03-10
-
-### Added
-- Client-server architecture — Brain (Rails + Puma) runs as persistent service, TUI connects via WebSocket
-- Action Cable infrastructure with Solid Cable adapter for Brain/TUI WebSocket communication
-- `SessionChannel` — WebSocket channel for session management, message relay, and session switching
-- Graceful TUI reconnection with exponential backoff (up to 10 attempts, max 30s delay)
-- `AgentRequestJob` — background job for LLM agent loops with retry logic for transient failures (network errors, rate limits, server errors)
-- Provider error hierarchy — `TransientError`, `RateLimitError`, `ServerError` for retry classification; `AuthenticationError` for immediate discard
-- `AgentLoop#run` — retry-safe entry point for job callers; lets errors propagate for external retry handling
-- `AgentLoop` service — decouples LLM orchestration from TUI; callable from background jobs, Action Cable channels, or TUI directly
-- Session and event persistence to SQLite — conversations survive TUI restart
-- `Session` model — owns an ordered event stream
-- `Event` model — polymorphic type, JSON payload, auto-incrementing position
-- `Events::Subscribers::Persister` — writes all events to SQLite as they flow through the bus
-- TUI resumes last session on startup, `Ctrl+a > n` creates a new session
-- Event system using Rails Structured Event Reporter (`Rails.event`)
-- Five event types: `system_message`, `user_message`, `agent_message`, `tool_call`, `tool_response`
-- `Events::Bus` — thin wrapper around `Rails.event` for emitting and subscribing to Anima events
-- `Events::Subscribers::MessageCollector` — in-memory subscriber that collects displayable messages
-- Chat screen refactored from raw array to event-driven architecture
-- TUI chat screen with LLM integration — in-memory message array, threaded API calls
-- Chat input with character validation, backspace, Enter to submit
-- Loading indicator — "Thinking" status bar mode, grayed-out input during LLM calls
-- New session command (`Ctrl+a > n`) clears conversation
-- Error handling — API failures displayed inline as chat messages
-- Anthropic API subscription token authentication
-- LLM client (raw HTTP to Anthropic API)
-- TUI scaffold with RatatuiRuby — tmux-style `Ctrl+a` command mode, sidebar, status bar
-- Headless Rails 8.1 app (API-only, no views/assets)
-- `anima install` command — creates ~/.anima/ tree, per-environment credentials, systemd user service
-- `anima start` command — runs db:prepare and boots Rails via Foreman
-- Systemd user service — auto-enables and starts brain on `anima install`
-- SQLite databases, logs, tmp, and credentials stored in ~/.anima/
-- Environment validation (development, test, production)
-
-## [0.0.1] - 2026-03-06
-
-- Initial gem scaffold with CI and RubyGems publishing

data/Gemfile

@@ -1,17 +0,0 @@
-# frozen_string_literal: true
-
-source "https://rubygems.org"
-
-# Specify your gem's dependencies in anima-core.gemspec
-gemspec
-
-gem "irb"
-gem "rake", "~> 13.0"
-
-gem "rspec", "~> 3.0"
-gem "rspec-rails", "~> 7.0"
-
-gem "reek", "~> 6.5"
-gem "standard", "~> 1.3"
-
-gem "webmock", "~> 3.23"

data/lib/tools/return_result.rb

@@ -1,81 +0,0 @@
-# frozen_string_literal: true
-
-module Tools
-  # Sub-agent-only tool that delivers a completed result back to the
-  # parent session as a tool_call/tool_response pair. The parent agent
-  # sees it as if it called a tool itself — no custom event types needed.
-  #
-  # Never registered for main sessions — only sub-agents see this tool.
-  class ReturnResult < Base
-    def self.tool_name = "return_result"
-
-    def self.description = "Return your completed result to the parent agent. " \
-      "Call this when you have fulfilled the assigned task."
-
-    def self.input_schema
-      {
-        type: "object",
-        properties: {
-          result: {
-            type: "string",
-            description: "The completed deliverable to send back to the parent agent"
-          }
-        },
-        required: ["result"]
-      }
-    end
-
-    # @param session [Session] the sub-agent session returning a result
-    def initialize(session:, **)
-      @session = session
-    end
-
-    # Emits a tool_call/tool_response pair in the parent session so the
-    # parent agent sees the sub-agent result as a regular tool interaction.
-    #
-    # @param input [Hash<String, Object>] with "result" key
-    # @return [String, Hash] confirmation message, or Hash with :error key on failure
-    def execute(input)
-      result = input["result"].to_s.strip
-      return {error: "Result cannot be blank"} if result.empty?
-
-      parent = @session.parent_session
-      return {error: "No parent session — only sub-agents can return results"} unless parent
-
-      tool_use_id = "toolu_subagent_#{@session.id}"
-      task = extract_task
-      # Specialists are spawned with a name from the registry; generic sub-agents have nil name.
-      origin_tool = @session.name ? SpawnSpecialist.tool_name : SpawnSubagent.tool_name
-
-      Events::Bus.emit(Events::ToolCall.new(
-        content: "Sub-agent result (session #{@session.id})",
-        tool_name: origin_tool,
-        tool_input: {"task" => task, "session_id" => @session.id},
-        tool_use_id: tool_use_id,
-        session_id: parent.id
-      ))
-
-      Events::Bus.emit(Events::ToolResponse.new(
-        content: result,
-        tool_name: origin_tool,
-        tool_use_id: tool_use_id,
-        session_id: parent.id
-      ))
-
-      "Result delivered to parent session #{parent.id}."
-    end
-
-    private
-
-    # Extracts the original task from the sub-agent's first user message.
-    # @return [String]
-    def extract_task
-      @session.events
-        .where(event_type: "user_message")
-        .order(:id)
-        .pick(:payload)
-        &.dig("content")
-        .to_s
-    end
-  end
-end