env.byoa.example

# env.byoa.example — template for BYOA operators.
#
# Copy to `.env.byoa` and fill in the required values. Auto-loaded
# by `uv run byoa --serve`; shell env wins over file. The single-session
# harness (`uv run byoa`, what wake spawns) reads only os.environ —
# per-session vars (BYOA_CHANNEL, BYOA_BUS_DATABASE_URL, BYOA_TASK_ID, …)
# are injected by wake_agent.
#
# `/byoa-link` writes this file for you.

# ── Identity (required) ─────────────────────────────────────────────

# Operator's character UUID. Auth checks authorize against this, not the
# ship's pseudo-character.
BYOA_CHARACTER_ID=

# Corp ship the agent acts as (ship's pseudo-character UUID).
BYOA_SHIP_ID=

# Per-ship bearer authenticating wake_agent → your receiver. Generate
# with `openssl rand -hex 32`. Must match the value stored server-side
# via `ship_byoa_configure set { wake_secret }`.
BYOA_WAKE_SECRET=

# ── Prompt (optional) ───────────────────────────────────────────────
# Custom system prompt (≤ 8 KB), appended to the base TaskAgent prompt.
# Inline wins over file. Leave both unset for the base prompt only.
# BYOA_PROMPT="You are a cautious trader. ..."
# BYOA_PROMPT_FILE=./prompt.md

# ── LLM (required) ──────────────────────────────────────────────────
# Required for BYOA Vercel/Sandbox deployments. When running `--serve`
# from a bot checkout, .env.bot's TASK_LLM_* values are used as a
# fallback if these are unset — but `/byoa-deploy-vercel` has no such
# fallback and will refuse to deploy without them.

# Provider: `google` / `anthropic` / `openai` / `minimax`.
TASK_LLM_PROVIDER=
TASK_LLM_MODEL=
# TASK_LLM_THINKING_BUDGET=4096

# API key matching TASK_LLM_PROVIDER — uncomment exactly one.
# ANTHROPIC_API_KEY=
# GOOGLE_API_KEY=
# OPENAI_API_KEY=
# MINIMAX_API_KEY=

# ── Tunables (optional) ─────────────────────────────────────────────
# See docs/byoa.md "Config reference". Defaults shown.
# BYOA_TOOL_CALL_TIMEOUT_SECONDS=30.0
# BYOA_AGENT_IDLE_TEARDOWN_SECONDS=300.0
# TASK_AGENT_EVENT_DRAIN_GRACE_SECONDS=1.0

# Logging level for the BYOA process (DEBUG, INFO, WARNING, ERROR). Inherits
# from .env.bot when `--serve` runs from the bot checkout; set here to override.
# LOG_LEVEL=INFO