caspian-connect-email

name	caspian-connect-email
description	Connect Caspian email for OpenCode: ensure credentials (sandbox or dashboard API key), write caspian.env, connect inbox, enable email in caspian.json. Use when the user wants to link email, set up the agent inbox, or runs /caspian:connect-email.
license	Apache-2.0
compatibility	opencode
metadata	{"alias":"caspian:ConnectEmail","channel":"caspian"}

Caspian connect email

Get a Caspian API key (sandbox or existing dashboard key), save it to ~/.config/opencode/caspian.env, connect an email inbox, and enable email in caspian.json channels.

When to use

• User asks to connect / set up Caspian email
• User runs /caspian:connect-email or /caspian-connect-email
• First-time OpenCode + Caspian setup

How

1. Call caspian_setup_credentials with mode=status.

2. If not configured, ask the user which path they want (do not invent keys):

   A — Instant sandbox (recommended for trying Caspian)
   No account. Call caspian_setup_credentials with mode=sandbox.
   Writes CASPIAN_API_KEY + CASPIAN_BASE_URL=https://api.trycaspianai.com to ~/.config/opencode/caspian.env (and project .env).

   B — Existing Caspian account
   Tell them to sign in at https://dashboard.trycaspianai.com/login , open a project, copy the API key, then call caspian_setup_credentials with mode=paste and apiKey=<their key>.

   If setup says RESTART REQUIRED, stop and tell them to quit + relaunch OpenCode, then run /caspian:connect-email again.

3. Call caspian_connections (optional) to show current links.

4. Call caspian_connect_email (optional displayName).

5. If the tool says RESTART REQUIRED, tell the user clearly:

   Restart OpenCode (quit and relaunch) so the plugin reloads caspian.json and admit includes email.

6. Do not invent connection ids or addresses. Report tool errors as-is.

Notes

• Secrets go in caspian.env / .env — never in caspian.json or chat logs when you can avoid it (the tool masks keys in its output).
• CLI (caspian init) is optional; sandbox mint and paste cover the same APIs.
• After restart, inbound email should create OpenCode sessions automatically.