api/services/batch-agent/README.md

Batch Agent Service

Owns: agent_runner, journey builder, filesystem_agent, integrations (Gmail, MS Graph).

Tables owned

• local_agent_configs
• cloud_agent_configs
• agent_run_logs

Endpoints

• GET /agents/catalog
• POST /agents/can-create
• POST /agents/trigger
• GET /agents/{id}/history

Redis channels

• Subscribe: batch:request:{user_id}
• Publish: ws:out:{user_id} (journey replies + tool calls)
• BRPOP: tool:result:{call_id} (30s timeout)
• SET+EX: journey:{user_id} (session state, TTL 1800s)

TODO

• Integrate Langfuse tracing (reuse services/chat/app/tracing.py pattern — trace_span(), get_langfuse_callback(), prompt management). Each batch agent run should create a trace with input/output, link prompts, and pass the LangChain CallbackHandler to LLM calls.