anima-core 1.3.0 → 1.5.0

data/lib/tools/subagent_prompts.rb

@@ -6,39 +6,37 @@ module Tools
   module SubagentPrompts
     # Prepended to every sub-agent's stored prompt after nickname assignment.
     # Establishes identity before any other instruction.
-    IDENTITY_TEMPLATE = "You are @%s, a sub-agent of the primary agent."
+    IDENTITY_TEMPLATE = "You are %s, a sub-agent of the primary agent."
 
     COMMUNICATION_INSTRUCTION = "Your messages reach the parent automatically. " \
       "Ask if you need clarification — the parent can reply."
 
-    # Framing message inserted as the sub-agent's first user message.
-    # This is the "brake" between inherited parent context and the sub-agent's
-    # own task — without it, the model continues the parent's trajectory.
-    FORK_FRAMING_MESSAGE = "You were spawned to help with a single task. " \
-      "The messages above are the parent agent's context — background for your work, " \
-      "but the parent's goals are not yours. " \
-      "Your sole task is described in your Goal."
-
     private
 
-    # Creates the sub-agent's Goal from the task description and inserts
-    # the framing message as the first user message.
+    # Creates the sub-agent's Goal from the task description, inserts the
+    # task as the first user message, and pins it to the Goal so it survives
+    # viewport eviction for as long as the Goal is active.
     #
     # @param child [Session] the newly created child session
-    # @param task [String] the task description to pin as the sole Goal
+    # @param task [String] the task description
     # @return [void]
-    def pin_goal_and_frame(child, task)
-      child.goals.create!(description: task)
-      child.create_user_message(FORK_FRAMING_MESSAGE)
+    def create_goal_with_pinned_task(child, task)
+      goal = child.goals.create!(description: task)
+      message = child.create_user_message(task)
+      pin = PinnedMessage.create!(
+        message: message,
+        display_text: task.truncate(PinnedMessage::MAX_DISPLAY_TEXT_LENGTH)
+      )
+      GoalPinnedMessage.create!(goal: goal, pinned_message: pin)
     end
 
-    # Runs the analytical brain synchronously to assign a nickname,
+    # Runs Melete synchronously to assign a nickname,
     # then prepends identity context to the stored prompt.
     # Falls back to a sequential "agent-N" name on any failure.
     # Identity injection runs in +ensure+ so it applies to both
-    # brain-assigned and fallback nicknames.
-    def assign_nickname_via_brain(child)
-      AnalyticalBrain::Runner.new(child).call
+    # Melete-assigned and fallback nicknames.
+    def assign_nickname_via_melete(child)
+      Melete::Runner.new(child).call
       child.reload
     rescue => error
       Rails.logger.warn("Sub-agent nickname assignment failed: #{error.message}")

data/lib/tools/think.rb

@@ -5,7 +5,7 @@ module Tools
   # pause between tool calls where the agent can organize thoughts, plan
   # next steps, or make decisions without interrupting the user.
   #
-  # Think events bridge the gap between the analytical brain (subconscious
+  # Think events bridge the gap between Melete (subconscious
   # background processing) and speech (user-facing messages). Without this
   # tool, reasoning leaks into tool arguments as comments.
   #

data/lib/tools/{remember.rb → view_messages.rb}

@@ -1,21 +1,21 @@
 # frozen_string_literal: true
 
 module Tools
-  # Fractal-resolution zoom into message history. Returns a window centered
-  # on a target message with full detail at the center and compressed context
-  # at the edges — sharp fovea, blurry periphery.
+  # Fractal-resolution window into long-term memory. Given a message_id,
+  # returns the surrounding conversation with full detail at the center
+  # and compressed snapshots at the edges — sharp fovea, blurry periphery.
   #
   # Output structure:
   #   [Previous snapshots — compressed context before]
   #   [Messages N-M — full detail, tool_responses compressed to checkmarks]
   #   [Following snapshots — compressed context after]
   #
-  # The agent discovers target messages via FTS5 search results embedded in
-  # viewport recall snippets. This tool drills down into the full context.
+  # Aoide discovers target message IDs via {SearchMessages} and drills
+  # down here to recover the full context around any moment.
   #
   # @example
-  #   remember(message_id: 42)
-  class Remember < Base
+  #   view_messages(message_id: 42)
+  class ViewMessages < Base
     # Messages around the target to include at full resolution.
     # ±10 messages provides sharp foveal detail while keeping output readable.
     CONTEXT_WINDOW = 20
@@ -26,9 +26,9 @@ module Tools
       "system_message" => "System"
     }.freeze
 
-    def self.tool_name = "remember"
+    def self.tool_name = "view_messages"
 
-    def self.description = "Recall the full conversation around a past message."
+    def self.description = "View the full conversation around a message in long-term memory. Pass a message_id — typically one returned by search_messages — to see the surrounding exchange with compressed snapshots at the edges."
 
     def self.input_schema
       {
@@ -112,7 +112,7 @@ module Tools
     # @return [Array<Message>] chronologically ordered
     def fetch_center_messages(target, target_session)
       half = CONTEXT_WINDOW / 2
-      scope = target_session.messages.context_messages
+      scope = target_session.messages
       target_id = target.id
 
       before = scope.where("id <= ?", target_id).reorder(id: :desc).limit(half + 1).to_a.reverse

data/lib/tools/write.rb

@@ -19,6 +19,8 @@ module Tools
 
     def self.description = "Write file."
 
+    def self.prompt_snippet = "Create or overwrite a whole file."
+
     def self.input_schema
       {
         type: "object",