Can I connect my agent to my existing Gmail or Outlook?

// Register your OAuth client (one-time setup)
const client = await commune.oauth.registerClient({
  name: 'My AI Assistant',
  redirectUri: 'https://your-app.com/oauth/callback',
});

// Save these — you'll need them
console.log(client.client_id);
console.log(client.client_secret);

# Register your OAuth client (one-time setup)
oauth_client = client.oauth.register_client(
    name="My AI Assistant",
    redirect_uri="https://your-app.com/oauth/callback",
)

# Save these
print(oauth_client.client_id)
print(oauth_client.client_secret)

// Generate the authorization URL
const authUrl = commune.oauth.getAuthorizationUrl({
  clientId: CLIENT_ID,
  provider: 'gmail',  // or 'outlook', 'imap'
  scopes: ['email.read', 'email.send', 'email.sync'],
  redirectUri: 'https://your-app.com/oauth/callback',
  state: 'random-csrf-token',
});

// Redirect the user to authUrl
// They'll sign in to Gmail/Outlook and grant access

# Generate the authorization URL
auth_url = client.oauth.get_authorization_url(
    client_id=CLIENT_ID,
    provider="gmail",  # or "outlook", "imap"
    scopes=["email.read", "email.send", "email.sync"],
    redirect_uri="https://your-app.com/oauth/callback",
    state="random-csrf-token",
)

# Redirect the user to auth_url

app.get('/oauth/callback', async (req, res) => {
  const { code, state } = req.query;

  // Exchange the code for tokens
  const connection = await commune.oauth.exchangeCode({
    clientId: CLIENT_ID,
    clientSecret: CLIENT_SECRET,
    code: code as string,
    redirectUri: 'https://your-app.com/oauth/callback',
  });

  // connection contains:
  // - connection_id: unique ID for this email connection
  // - email: the connected email address
  // - provider: 'gmail', 'outlook', etc.
  // - access_token: for Commune API calls on this connection

  // Store the connection_id — your agent uses this to interact with the mailbox
  await db.connections.insert({
    userId: getCurrentUser(req),
    connectionId: connection.connection_id,
    email: connection.email,
    provider: connection.provider,
  });

  res.redirect('/dashboard?connected=true');
});

@app.get("/oauth/callback")
def oauth_callback():
    code = request.args.get("code")
    state = request.args.get("state")

    # Exchange the code for tokens
    connection = client.oauth.exchange_code(
        client_id=CLIENT_ID,
        client_secret=CLIENT_SECRET,
        code=code,
        redirect_uri="https://your-app.com/oauth/callback",
    )

    # Store the connection
    db.connections.insert_one({
        "user_id": get_current_user(),
        "connection_id": connection.connection_id,
        "email": connection.email,
        "provider": connection.provider,
    })

    return redirect("/dashboard?connected=true")

// Read emails from the connected account
const messages = await commune.messages.list({
  connectionId: connection.connection_id,
  limit: 20,
});

// Send as the connected email address
await commune.messages.send({
  connectionId: connection.connection_id,
  to: 'client@example.com',
  subject: 'Meeting follow-up',
  html: '<p>Thanks for the call. Here are the next steps...</p>',
});

// Set up webhook for new inbound emails
await commune.connections.setWebhook(connection.connection_id, {
  endpoint: 'https://your-server.com/webhook/email',
  events: ['inbound'],
});

# Read emails from the connected account
messages = client.messages.list(
    connection_id=connection.connection_id,
    limit=20,
)

# Send as the connected email address
client.messages.send(
    connection_id=connection.connection_id,
    to="client@example.com",
    subject="Meeting follow-up",
    html="<p>Thanks for the call. Here are the next steps...</p>",
)

# Set up webhook for new inbound emails
client.connections.set_webhook(
    connection.connection_id,
    endpoint="https://your-server.com/webhook/email",
    events=["inbound"],
)