Add local agent interface and manuals

Author: jeong87

.env.example

@@ -52,6 +52,7 @@ GOOGLE_OAUTH_CONNECTED_EMAIL=
 # Optional override. Empty => auto uses current local UI callback URL.
 GOOGLE_OAUTH_REDIRECT_URI=
 SETUP_WIZARD_COMPLETED=false
+AGENT_API_TOKEN=
 SEND_NOW_COOLDOWN_SECONDS=300
 SENT_HISTORY_DAYS=14
 
@@ -60,6 +61,13 @@ ENABLE_LLM_AGENT=true
 GEMINI_API_KEY=
 ENABLE_GEMINI_ADVANCED_REASONING=true
 GEMINI_MODEL=gemini-3.1-pro
+
+# Optional OPENAI-compatible backend (LM Studio, vLLM, Ollama OpenAI bridge, etc.)
+ENABLE_OPENAI_COMPAT_FALLBACK=false
+OPENAI_COMPAT_API_KEY=
+OPENAI_COMPAT_MODEL=
+OPENAI_COMPAT_API_BASE=
+
 OUTPUT_LANGUAGE=en
 
 # Optional fallback LLM (used when Gemini fails)

README.md

@@ -38,6 +38,7 @@ Notes:
 ## Key Features
 - Personalized LLM relevance ranking using your active projects.
 - Search intents for recent updates, best-fit papers, and broader discovery.
+- Local agent interface with brokered credentials and JSON output.
 - Per-project mail cadence (`daily` / `every_3_days` / `weekly`) in Topic Editor.
 - Local inbox mode with browser popup scheduling on a running PC.
 - Configurable cadence: `daily`, `every_3_days`, `weekly`.
@@ -50,8 +51,10 @@ Notes:
 ## Quick Start
 - Beginner (English): [docs/manuals/MANUAL_FIRSTTIME_EN.md](docs/manuals/MANUAL_FIRSTTIME_EN.md)
 - Full operations (English): [docs/manuals/MANUAL_EN.md](docs/manuals/MANUAL_EN.md)
+- Agent/tool integration (English): [docs/manuals/MANUAL_AGENT_EN.md](docs/manuals/MANUAL_AGENT_EN.md)
 - Beginner (Korean): [docs/manuals/MANUAL_FIRSTTIME_KR.md](docs/manuals/MANUAL_FIRSTTIME_KR.md)
 - Full operations (Korean): [docs/manuals/MANUAL_KR.md](docs/manuals/MANUAL_KR.md)
+- Agent/tool integration (Korean): [docs/manuals/MANUAL_AGENT_KR.md](docs/manuals/MANUAL_AGENT_KR.md)
 
 ## Recommended First Path (Search-First, Local)
 Generate your first personalized search result before email or automation setup.
@@ -109,6 +112,18 @@ Main path for onboarding and preview-first setup:
 http://127.0.0.1:5050
 ```
 
+## Agent Mode
+Paper Morning can also be used as a local paper-search tool for research agents.
+
+Security model:
+- your agent gets `AGENT_API_TOKEN`
+- Paper Morning keeps `GEMINI_API_KEY` or local backend credentials in `.env` / keyring
+- the agent never needs to see raw provider keys
+
+Interfaces:
+- Local HTTP JSON endpoint: `POST /api/agent/search`
+- CLI JSON mode: `python app/paper_digest_app.py --agent-search ...`
+
 ## Build Distribution Files
 ### Windows
 ```powershell