Auto Research

Public base URL:
https://researcher.now

Purpose:
Turn a topic into a durable research pack. Do not treat reports as the product.

Core output:
- source corpus
- media manifest
- extracted artifacts
- agent-context payload
- evaluation records
- library entries for completed work
- playbook catalog for valid pack creation

Modes:
- collection: broad corpus gathering
- analysis: reason over an existing pack or source set
- frontier_scan: find newer or more technical material
- media_collection: gather visual, audio, or video assets

Default use case:
For Cookie, start collection-first with popular chocolate chip cookie recipes.
Do not jump straight to a final answer. Build the state first.

How to use:
1. Set `AUTO_RESEARCH_BASE_URL=https://researcher.now`
2. Set `AUTO_RESEARCH_TOKEN=<bearer token>`
3. Send `Authorization: Bearer $AUTO_RESEARCH_TOKEN` on every `/v1/*` request
4. Check the service with `GET /health`
5. Use `GET /v1/playbooks` if you do not know the playbook id
6. Create a pack with `POST /v1/research-packs`
7. Read `GET /v1/research-packs/:id/agent-context`
8. Use `GET /v1/library` to avoid duplicating completed work

Minimal curl example:
```bash
export AUTO_RESEARCH_BASE_URL="https://researcher.now"
export AUTO_RESEARCH_TOKEN="shared-secret"

curl -X POST "$AUTO_RESEARCH_BASE_URL/v1/research-packs" \
  -H "Authorization: Bearer $AUTO_RESEARCH_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "orgId": "00000000-0000-0000-0000-000000000000",
    "requestedBy": "research-auto",
    "topic": "popular chocolate chip cookie recipes",
    "mode": "collection",
    "playbook": "cookie_recipe_corpus",
    "depth": "wide",
    "outputSchemas": ["recipe_v1", "source_coverage_v1"],
    "limits": { "maxQueries": 8, "maxSources": 50, "maxCostUsd": 10 }
  }'
```

References:
- Home: https://researcher.now/
- API docs: https://researcher.now/api/
- CLI docs: https://researcher.now/cli/

Rules:
- Do not invent facts if the pack is incomplete.
- Do not skip `agent-context`.
- Treat research packs as the product.
- Reports are optional.
- Pack creation and pack reads require bearer auth.
- Completed packs should be treated as reusable library entries.
- If the playbook is unknown, read `/v1/playbooks` first.
- A playbook is a registered ID, not freeform prose.