Stateless Agent Memory Engine (SAME)

Instructions

Implementation Reference

• eval/memoryagentbench/run_bench.py:163-212 (handler)

  The `same_search` function is the handler that executes the tool logic for searching within the SAME vault. Note that in this codebase, the tool is referred to as 'same search' and implemented by invoking a CLI binary.

  def same_search(vault_dir: str, query: str, top_k: int = SEARCH_TOP_K) -> list[str]:
      """
      Run `same search` and return the top-k result texts.
      Returns a list of result strings.
      """
      try:
          result = subprocess.run(
              [SAME_BIN, "search", "--json", "--top-k", str(top_k), query],
              cwd=vault_dir,
              capture_output=True,
              text=True,
              timeout=QUESTION_TIMEOUT,
          )
      except subprocess.TimeoutExpired:
          log(f"    TIMEOUT: same search for '{query[:50]}...'")
          return []
  
      if result.returncode != 0:
          return []
  
      # Parse JSON output
      try:
          data = json.loads(result.stdout)
      except json.JSONDecodeError:
          # Fallback: return raw stdout lines
          return [line.strip() for line in result.stdout.strip().split("\n") if line.strip()]
  
      # Extract text from results — adapt to SAME's JSON format
      texts = []
      if isinstance(data, list):
          for item in data:
              if isinstance(item, dict):
                  # SAME uses "snippet" for retrieved text
                  text = item.get("snippet") or item.get("content") or item.get("text") or item.get("body") or ""
                  if text:
                      texts.append(text)
              elif isinstance(item, str):
                  texts.append(item)
      elif isinstance(data, dict):
          # Might be wrapped in a results key
          results = data.get("results") or data.get("matches") or data.get("notes") or []
          for item in results:
              if isinstance(item, dict):
                  text = item.get("snippet") or item.get("content") or item.get("text") or item.get("body") or ""
                  if text:
                      texts.append(text)
              elif isinstance(item, str):
                  texts.append(item)
  
      return texts[:top_k]