Hands

id = "researcher"
name = "Researcher"
description = "Deep autonomous research agent"
category = "productivity"
icon = "🔬"
tools = ["web_search", "web_fetch", "file_write"]

# Requirements that must be satisfied before activation
[[requires]]
key = "search_api"
label = "Search API Key"
requirement_type = "api_key"
check_value = "SEARCH_API_KEY"

[requires.install]
signup_url = "https://example.com/signup"
docs_url = "https://example.com/docs"
env_example = "SEARCH_API_KEY=your_key_here"
estimated_time = "5-10 min"
steps = [
    "Sign up at example.com",
    "Navigate to API settings",
    "Generate a new key",
    "Set it as an environment variable",
]

# Configurable settings (shown in activation modal)
[[settings]]
key = "research_depth"
label = "Research Depth"
description = "How many sources to cross-reference"
setting_type = "select"
default = "medium"

[[settings.options]]
value = "light"
label = "Light (3-5 sources)"

[[settings.options]]
value = "medium"
label = "Medium (5-10 sources)"

[[settings.options]]
value = "deep"
label = "Deep (10+ sources)"

# Agent manifest template
[agent]
name = "researcher-hand"
description = "Autonomous research agent"
system_prompt = """
You are an expert researcher with access to web search and content extraction tools.

Your goal is to conduct thorough research on any topic assigned to you:
- Cross-reference multiple authoritative sources
- Evaluate credibility using CRAAP criteria (Currency, Relevance, Authority, Accuracy, Purpose)
- Synthesize findings into a coherent report with citations
- Highlight contradictions or gaps in the literature

Always cite your sources using APA format.
"""
module = "builtin:chat"
provider = "anthropic"
model = "claude-sonnet-4-20250514"
max_tokens = 4096
temperature = 0.7

# Dashboard metrics (read from agent's structured memory)
[dashboard]
[[dashboard.metrics]]
label = "Reports Generated"
memory_key = "reports_count"
format = "number"

[[dashboard.metrics]]
label = "Sources Analyzed"
memory_key = "sources_analyzed"
format = "number"

[[dashboard.metrics]]
label = "Avg Research Time"
memory_key = "avg_research_time_minutes"
format = "duration"

pub struct HandInstance {
    pub instance_id: Uuid,              // Unique instance identifier
    pub hand_id: String,                // Which hand definition ("researcher")
    pub status: HandStatus,             // Active/Paused/Error/Inactive
    pub agent_id: Option<AgentId>,      // Spawned agent (if activated)
    pub agent_name: String,
    pub config: HashMap<String, Value>, // User-provided settings
    pub activated_at: DateTime<Utc>,
    pub updated_at: DateTime<Utc>,
}

pub enum HandStatus {
    Active,
    Paused,
    Error(String),
    Inactive,
}

# Activate researcher for competitor analysis
openfang hand activate researcher --name competitor-tracker

# Activate another researcher for market trends
openfang hand activate researcher --name market-trends

# Researcher Skill

## CRAAP Criteria for Source Evaluation

**Currency**: When was the information published? Is it up-to-date?
**Relevance**: Does it directly address your research question?
**Authority**: Who is the author? What are their credentials?
**Accuracy**: Is the information supported by evidence?
**Purpose**: Why was this published? Is there bias?

## Citation Format (APA)

Web source:
Author, A. A. (Year, Month Day). Title of page. Site Name. URL

...

[[dashboard.metrics]]
label = "Clips Generated"
memory_key = "clips_count"
format = "number"

[[dashboard.metrics]]
label = "Total Video Duration"
memory_key = "total_video_seconds"
format = "duration"

[[dashboard.metrics]]
label = "Storage Used"
memory_key = "storage_bytes"
format = "bytes"