search-archive

name	search-archive
description	Search long-term memories that have moved to the archive tier (> 90 days old, low-activity). Returns ranked results by semantic relevance.
trigger	search-archive

Search Archive

This skill enables searching the entity's long-term memory archive — memories older than 90 days that are no longer in the hot working-memory index.

When to Use

Use this skill when:

• The user asks about something from the distant past
• A relevant topic may be in older memories no longer appearing in recent context
• You want to cross-reference archived knowledge or past experiences
• You recall a memory exists but it's not surfacing in the current context

Do not use this for recent memories — those are retrieved automatically.

Tool Usage

[TOOL:search_archive query="your search terms here"]

With optional year range filter:

[TOOL:search_archive query="pipeline orchestration" yearRange='{"start":"2024-01-01T00:00:00.000Z","end":"2025-01-01T00:00:00.000Z"}' limit="10"]

Parameters

• query (required): Natural language search terms describing what you're looking for
• yearRange (optional): JSON object with "start" and/or "end" as ISO date strings to filter by archive date
• limit (optional): Number of results to return (default 5, max 20)

Result Format

Results include:

• id: Memory identifier
• summary: Extracted text content from the archived memory
• archivedAt: When the memory was moved to the archive
• topics: Topic keywords associated with the memory
• type: Memory type (episodic, doc, or semantic_knowledge)
• score: Relevance score (higher = more relevant)

Behavior Guidelines

• Use concise, topic-focused queries — RAKE extraction handles phrase identification
• If results are returned, synthesize them naturally into your response
• Cite approximate time periods when referencing archived memories
• If no results are found, say so honestly — don't fabricate memories