chat 4.13.2 → 4.13.4

package/docs/adapters/discord.mdx

@@ -14,6 +14,8 @@ pnpm add @chat-adapter/discord
 
 ## Usage
 
+The adapter auto-detects `DISCORD_BOT_TOKEN`, `DISCORD_PUBLIC_KEY`, `DISCORD_APPLICATION_ID`, and `DISCORD_MENTION_ROLE_IDS` from environment variables:
+
 ```typescript title="lib/bot.ts" lineNumbers
 import { Chat } from "chat";
 import { createDiscordAdapter } from "@chat-adapter/discord";
@@ -21,12 +23,7 @@ import { createDiscordAdapter } from "@chat-adapter/discord";
 const bot = new Chat({
   userName: "mybot",
   adapters: {
-    discord: createDiscordAdapter({
-      botToken: process.env.DISCORD_BOT_TOKEN!,
-      publicKey: process.env.DISCORD_PUBLIC_KEY!,
-      applicationId: process.env.DISCORD_APPLICATION_ID!,
-      mentionRoleIds: process.env.DISCORD_MENTION_ROLE_IDS?.split(","),
-    }),
+    discord: createDiscordAdapter(),
   },
 });
 
@@ -143,23 +140,25 @@ By default, only direct user mentions (`@BotName`) trigger `onNewMention` handle
 
 ```typescript title="lib/bot.ts" lineNumbers
 createDiscordAdapter({
-  botToken: process.env.DISCORD_BOT_TOKEN!,
-  publicKey: process.env.DISCORD_PUBLIC_KEY!,
-  applicationId: process.env.DISCORD_APPLICATION_ID!,
   mentionRoleIds: ["1457473602180878604"],
 });
 ```
 
-Or set `DISCORD_MENTION_ROLE_IDS` as a comma-separated string.
+Or set `DISCORD_MENTION_ROLE_IDS` as a comma-separated string in your environment variables.
 
 ## Configuration
 
+All options are auto-detected from environment variables when not provided.
+
 | Option | Required | Description |
 |--------|----------|-------------|
-| `botToken` | Yes | Discord bot token |
-| `publicKey` | Yes | Application public key (for webhook signature verification) |
-| `applicationId` | Yes | Discord application ID |
-| `mentionRoleIds` | No | Array of role IDs that trigger mention handlers |
+| `botToken` | No* | Discord bot token. Auto-detected from `DISCORD_BOT_TOKEN` |
+| `publicKey` | No* | Application public key. Auto-detected from `DISCORD_PUBLIC_KEY` |
+| `applicationId` | No* | Discord application ID. Auto-detected from `DISCORD_APPLICATION_ID` |
+| `mentionRoleIds` | No | Array of role IDs that trigger mention handlers. Auto-detected from `DISCORD_MENTION_ROLE_IDS` (comma-separated) |
+| `logger` | No | Logger instance (defaults to `ConsoleLogger("info")`) |
+
+*`botToken`, `publicKey`, and `applicationId` are required — either via config or env vars.
 
 ## Environment variables
 

package/docs/adapters/gchat.mdx

@@ -14,6 +14,8 @@ pnpm add @chat-adapter/gchat
 
 ## Usage
 
+The adapter auto-detects credentials from `GOOGLE_CHAT_CREDENTIALS` or `GOOGLE_CHAT_USE_ADC` environment variables:
+
 ```typescript title="lib/bot.ts" lineNumbers
 import { Chat } from "chat";
 import { createGoogleChatAdapter } from "@chat-adapter/gchat";
@@ -21,9 +23,7 @@ import { createGoogleChatAdapter } from "@chat-adapter/gchat";
 const bot = new Chat({
   userName: "mybot",
   adapters: {
-    gchat: createGoogleChatAdapter({
-      credentials: JSON.parse(process.env.GOOGLE_CHAT_CREDENTIALS!),
-    }),
+    gchat: createGoogleChatAdapter(),
   },
 });
 
@@ -94,12 +94,13 @@ By default, Google Chat only sends webhooks for @mentions. To receive all messag
 
 ```typescript title="lib/bot.ts" lineNumbers
 createGoogleChatAdapter({
-  credentials: JSON.parse(process.env.GOOGLE_CHAT_CREDENTIALS!),
   pubsubTopic: process.env.GOOGLE_CHAT_PUBSUB_TOPIC,
   impersonateUser: process.env.GOOGLE_CHAT_IMPERSONATE_USER,
 });
 ```
 
+`GOOGLE_CHAT_PUBSUB_TOPIC` and `GOOGLE_CHAT_IMPERSONATE_USER` are also auto-detected from env vars, so you can omit them from config if the env vars are set.
+
 ### 1. Create Pub/Sub topic
 
 1. Go to **Pub/Sub** then **Topics**
@@ -156,14 +157,18 @@ Set `GOOGLE_CHAT_IMPERSONATE_USER` to an admin user email in your domain (e.g.,
 
 ## Configuration
 
+All options are auto-detected from environment variables when not provided.
+
 | Option | Required | Description |
 |--------|----------|-------------|
-| `credentials` | Yes* | Service account credentials JSON |
-| `useADC` | No | Use Application Default Credentials instead |
-| `pubsubTopic` | No | Pub/Sub topic for Workspace Events |
-| `impersonateUser` | No | User email for domain-wide delegation |
-
-*Either `credentials` or `useADC: true` is required.
+| `credentials` | No* | Service account credentials JSON. Auto-detected from `GOOGLE_CHAT_CREDENTIALS` |
+| `useApplicationDefaultCredentials` | No | Use Application Default Credentials. Auto-detected from `GOOGLE_CHAT_USE_ADC` |
+| `pubsubTopic` | No | Pub/Sub topic for Workspace Events. Auto-detected from `GOOGLE_CHAT_PUBSUB_TOPIC` |
+| `impersonateUser` | No | User email for domain-wide delegation. Auto-detected from `GOOGLE_CHAT_IMPERSONATE_USER` |
+| `auth` | No | Custom auth object (advanced) |
+| `logger` | No | Logger instance (defaults to `ConsoleLogger("info")`) |
+
+*Either `credentials`, `GOOGLE_CHAT_CREDENTIALS` env var, `useApplicationDefaultCredentials`, or `GOOGLE_CHAT_USE_ADC=true` is required.
 
 ## Environment variables
 

package/docs/adapters/github.mdx

@@ -16,6 +16,8 @@ pnpm add @chat-adapter/github
 
 ## Usage
 
+The adapter auto-detects credentials from `GITHUB_TOKEN` (or `GITHUB_APP_ID`/`GITHUB_PRIVATE_KEY`), `GITHUB_WEBHOOK_SECRET`, and `GITHUB_BOT_USERNAME` environment variables:
+
 ```typescript title="lib/bot.ts" lineNumbers
 import { Chat } from "chat";
 import { createGitHubAdapter } from "@chat-adapter/github";
@@ -23,11 +25,7 @@ import { createGitHubAdapter } from "@chat-adapter/github";
 const bot = new Chat({
   userName: "my-bot",
   adapters: {
-    github: createGitHubAdapter({
-      token: process.env.GITHUB_TOKEN!,
-      webhookSecret: process.env.GITHUB_WEBHOOK_SECRET!,
-      userName: "my-bot",
-    }),
+    github: createGitHubAdapter(),
   },
 });
 
@@ -49,8 +47,6 @@ Best for personal projects, testing, or single-repo bots.
 ```typescript title="lib/bot.ts" lineNumbers
 createGitHubAdapter({
   token: process.env.GITHUB_TOKEN!,
-  webhookSecret: process.env.GITHUB_WEBHOOK_SECRET!,
-  userName: "my-bot",
 });
 ```
 
@@ -88,8 +84,6 @@ createGitHubAdapter({
   appId: process.env.GITHUB_APP_ID!,
   privateKey: process.env.GITHUB_PRIVATE_KEY!,
   installationId: parseInt(process.env.GITHUB_INSTALLATION_ID!),
-  webhookSecret: process.env.GITHUB_WEBHOOK_SECRET!,
-  userName: "my-bot[bot]",
 });
 ```
 
@@ -99,8 +93,6 @@ createGitHubAdapter({
 createGitHubAdapter({
   appId: process.env.GITHUB_APP_ID!,
   privateKey: process.env.GITHUB_PRIVATE_KEY!,
-  webhookSecret: process.env.GITHUB_WEBHOOK_SECRET!,
-  userName: "my-bot[bot]",
 });
 ```
 
@@ -146,17 +138,22 @@ Supports GitHub's reaction emoji:
 
 ## Configuration
 
+All options are auto-detected from environment variables when not provided.
+
 | Option | Required | Description |
 |--------|----------|-------------|
-| `token` | Yes* | Personal Access Token with `repo` scope |
-| `appId` | Yes* | GitHub App ID |
-| `privateKey` | For Apps | GitHub App private key (PEM format) |
-| `installationId` | No | Installation ID (omit for multi-tenant) |
-| `webhookSecret` | Yes | Webhook secret for signature verification |
-| `userName` | Yes | Bot username for @mention detection |
+| `token` | No* | Personal Access Token. Auto-detected from `GITHUB_TOKEN` |
+| `appId` | No* | GitHub App ID. Auto-detected from `GITHUB_APP_ID` |
+| `privateKey` | No | GitHub App private key (PEM). Auto-detected from `GITHUB_PRIVATE_KEY` |
+| `installationId` | No | Installation ID (omit for multi-tenant). Auto-detected from `GITHUB_INSTALLATION_ID` |
+| `webhookSecret` | No** | Webhook secret. Auto-detected from `GITHUB_WEBHOOK_SECRET` |
+| `userName` | No | Bot username for @mention detection. Auto-detected from `GITHUB_BOT_USERNAME` (default: `"github-bot"`) |
 | `botUserId` | No | Bot's numeric user ID (auto-detected if not provided) |
+| `logger` | No | Logger instance (defaults to `ConsoleLogger("info")`) |
+
+*Either `token`/`GITHUB_TOKEN` or `appId`+`privateKey`/`GITHUB_APP_ID`+`GITHUB_PRIVATE_KEY` is required.
 
-*Either `token` or `appId`/`privateKey` is required.
+**`webhookSecret` is required — either via config or `GITHUB_WEBHOOK_SECRET` env var.
 
 ## Environment variables
 

package/docs/adapters/index.mdx

@@ -93,11 +93,11 @@ import { createRedisState } from "@chat-adapter/state-redis";
 const bot = new Chat({
   userName: "mybot",
   adapters: {
-    slack: createSlackAdapter({ /* ... */ }),
-    teams: createTeamsAdapter({ /* ... */ }),
-    gchat: createGoogleChatAdapter({ /* ... */ }),
+    slack: createSlackAdapter(),
+    teams: createTeamsAdapter(),
+    gchat: createGoogleChatAdapter(),
   },
-  state: createRedisState({ url: process.env.REDIS_URL! }),
+  state: createRedisState(),
 });
 
 // This handler fires for mentions on any platform
@@ -107,4 +107,6 @@ bot.onNewMention(async (thread) => {
 });
 ```
 
+Each adapter auto-detects credentials from environment variables, so you only need to pass config when overriding defaults.
+
 Each adapter creates a webhook handler accessible via `bot.webhooks.slack`, `bot.webhooks.teams`, etc.

package/docs/adapters/linear.mdx

@@ -16,6 +16,8 @@ pnpm add @chat-adapter/linear
 
 ## Usage
 
+The adapter auto-detects credentials from `LINEAR_API_KEY` (or `LINEAR_CLIENT_ID`/`LINEAR_CLIENT_SECRET`), `LINEAR_WEBHOOK_SECRET`, and `LINEAR_BOT_USERNAME` environment variables:
+
 ```typescript title="lib/bot.ts" lineNumbers
 import { Chat } from "chat";
 import { createLinearAdapter } from "@chat-adapter/linear";
@@ -23,11 +25,7 @@ import { createLinearAdapter } from "@chat-adapter/linear";
 const bot = new Chat({
   userName: "my-bot",
   adapters: {
-    linear: createLinearAdapter({
-      apiKey: process.env.LINEAR_API_KEY!,
-      webhookSecret: process.env.LINEAR_WEBHOOK_SECRET!,
-      userName: "my-bot",
-    }),
+    linear: createLinearAdapter(),
   },
 });
 
@@ -51,8 +49,6 @@ Best for personal projects, testing, or single-workspace bots. Actions are attri
 ```typescript title="lib/bot.ts" lineNumbers
 createLinearAdapter({
   apiKey: process.env.LINEAR_API_KEY!,
-  webhookSecret: process.env.LINEAR_WEBHOOK_SECRET!,
-  userName: "my-bot",
 });
 ```
 
@@ -69,8 +65,6 @@ The bot gets its own identity in Linear. The adapter handles token management in
 createLinearAdapter({
   clientId: process.env.LINEAR_CLIENT_ID!,
   clientSecret: process.env.LINEAR_CLIENT_SECRET!,
-  webhookSecret: process.env.LINEAR_WEBHOOK_SECRET!,
-  userName: "my-bot",
 });
 ```
 
@@ -138,16 +132,21 @@ When a user writes a comment, the bot replies within the same comment thread.
 
 ## Configuration
 
+All options are auto-detected from environment variables when not provided.
+
 | Option | Required | Description |
 |--------|----------|-------------|
-| `apiKey` | Yes* | Personal API key |
-| `clientId` | Yes* | OAuth app client ID |
-| `clientSecret` | Yes* | OAuth app client secret |
-| `accessToken` | Yes* | Pre-obtained OAuth access token |
-| `webhookSecret` | Yes | Webhook signing secret for verification |
-| `userName` | Yes | Bot display name for @mention detection |
-
-*One of `apiKey`, `clientId`/`clientSecret`, or `accessToken` is required.
+| `apiKey` | No* | Personal API key. Auto-detected from `LINEAR_API_KEY` |
+| `clientId` | No* | OAuth app client ID. Auto-detected from `LINEAR_CLIENT_ID` |
+| `clientSecret` | No* | OAuth app client secret. Auto-detected from `LINEAR_CLIENT_SECRET` |
+| `accessToken` | No* | Pre-obtained OAuth access token. Auto-detected from `LINEAR_ACCESS_TOKEN` |
+| `webhookSecret` | No** | Webhook signing secret. Auto-detected from `LINEAR_WEBHOOK_SECRET` |
+| `userName` | No | Bot display name. Auto-detected from `LINEAR_BOT_USERNAME` (default: `"linear-bot"`) |
+| `logger` | No | Logger instance (defaults to `ConsoleLogger("info")`) |
+
+*One of `apiKey`, `clientId`/`clientSecret`, or `accessToken` is required (via config or env vars).
+
+**`webhookSecret` is required — either via config or `LINEAR_WEBHOOK_SECRET` env var.
 
 ## Environment variables
 

package/docs/adapters/slack.mdx

@@ -14,7 +14,7 @@ pnpm add @chat-adapter/slack
 
 ## Single-workspace mode
 
-For bots deployed to a single Slack workspace:
+For bots deployed to a single Slack workspace. The adapter auto-detects `SLACK_BOT_TOKEN` and `SLACK_SIGNING_SECRET` from environment variables:
 
 ```typescript title="lib/bot.ts" lineNumbers
 import { Chat } from "chat";
@@ -23,10 +23,7 @@ import { createSlackAdapter } from "@chat-adapter/slack";
 const bot = new Chat({
   userName: "mybot",
   adapters: {
-    slack: createSlackAdapter({
-      botToken: process.env.SLACK_BOT_TOKEN!,
-      signingSecret: process.env.SLACK_SIGNING_SECRET!,
-    }),
+    slack: createSlackAdapter(),
   },
 });
 
@@ -39,21 +36,21 @@ bot.onNewMention(async (thread, message) => {
 
 For apps installed across multiple Slack workspaces via OAuth, omit `botToken` and provide OAuth credentials instead. The adapter resolves tokens dynamically from your state adapter using the `team_id` from incoming webhooks.
 
+When you pass any auth-related config (like `clientId`), the adapter won't fall back to env vars for other auth fields, preventing accidental mixing of auth modes.
+
 ```typescript title="lib/bot.ts" lineNumbers
 import { createSlackAdapter } from "@chat-adapter/slack";
 import { createRedisState } from "@chat-adapter/state-redis";
 
 const slackAdapter = createSlackAdapter({
-  signingSecret: process.env.SLACK_SIGNING_SECRET!,
   clientId: process.env.SLACK_CLIENT_ID!,
   clientSecret: process.env.SLACK_CLIENT_SECRET!,
-  encryptionKey: process.env.SLACK_ENCRYPTION_KEY,
 });
 
 const bot = new Chat({
   userName: "mybot",
   adapters: { slack: slackAdapter },
-  state: createRedisState({ url: process.env.REDIS_URL! }),
+  state: createRedisState(),
 });
 ```
 
@@ -181,13 +178,18 @@ After creating the app, go to **Basic Information** → **App Credentials** and
 
 ## Configuration
 
+All options are auto-detected from environment variables when not provided. You can call `createSlackAdapter()` with no arguments if the env vars are set.
+
 | Option | Required | Description |
 |--------|----------|-------------|
-| `botToken` | No | Bot token (`xoxb-...`). Required for single-workspace, omit for multi-workspace |
-| `signingSecret` | Yes | Signing secret for webhook verification |
-| `clientId` | No | App client ID (required for multi-workspace OAuth) |
-| `clientSecret` | No | App client secret (required for multi-workspace OAuth) |
-| `encryptionKey` | No | Base64-encoded 32-byte AES-256-GCM key for encrypting stored tokens |
+| `botToken` | No | Bot token (`xoxb-...`). Auto-detected from `SLACK_BOT_TOKEN` |
+| `signingSecret` | No* | Signing secret for webhook verification. Auto-detected from `SLACK_SIGNING_SECRET` |
+| `clientId` | No | App client ID for multi-workspace OAuth. Auto-detected from `SLACK_CLIENT_ID` |
+| `clientSecret` | No | App client secret for multi-workspace OAuth. Auto-detected from `SLACK_CLIENT_SECRET` |
+| `encryptionKey` | No | AES-256-GCM key for encrypting stored tokens. Auto-detected from `SLACK_ENCRYPTION_KEY` |
+| `logger` | No | Logger instance (defaults to `ConsoleLogger("info")`) |
+
+*`signingSecret` is required — either via config or `SLACK_SIGNING_SECRET` env var.
 
 ## Environment variables
 

package/docs/adapters/teams.mdx

@@ -14,6 +14,8 @@ pnpm add @chat-adapter/teams
 
 ## Usage
 
+The adapter auto-detects `TEAMS_APP_ID`, `TEAMS_APP_PASSWORD`, and `TEAMS_APP_TENANT_ID` from environment variables:
+
 ```typescript title="lib/bot.ts" lineNumbers
 import { Chat } from "chat";
 import { createTeamsAdapter } from "@chat-adapter/teams";
@@ -22,10 +24,7 @@ const bot = new Chat({
   userName: "mybot",
   adapters: {
     teams: createTeamsAdapter({
-      appId: process.env.TEAMS_APP_ID!,
-      appPassword: process.env.TEAMS_APP_PASSWORD!,
       appType: "SingleTenant",
-      appTenantId: process.env.TEAMS_APP_TENANT_ID!,
     }),
   },
 });
@@ -136,12 +135,17 @@ Create icon files (32x32 `outline.png` and 192x192 `color.png`), then zip all th
 
 ## Configuration
 
+All options are auto-detected from environment variables when not provided.
+
 | Option | Required | Description |
 |--------|----------|-------------|
-| `appId` | Yes | Azure Bot App ID |
-| `appPassword` | Yes | Azure Bot App Password |
+| `appId` | No* | Azure Bot App ID. Auto-detected from `TEAMS_APP_ID` |
+| `appPassword` | No* | Azure Bot App Password. Auto-detected from `TEAMS_APP_PASSWORD` |
 | `appType` | No | `"MultiTenant"` or `"SingleTenant"` (default: `"MultiTenant"`) |
-| `appTenantId` | For SingleTenant | Azure AD Tenant ID |
+| `appTenantId` | For SingleTenant | Azure AD Tenant ID. Auto-detected from `TEAMS_APP_TENANT_ID` |
+| `logger` | No | Logger instance (defaults to `ConsoleLogger("info")`) |
+
+*`appId` and `appPassword` are required — either via config or env vars.
 
 ## Environment variables
 

package/docs/api/chat.mdx

@@ -31,8 +31,9 @@ const bot = new Chat(config);
       type: 'StateAdapter',
     },
     logger: {
-      description: 'Logger instance or log level.',
+      description: 'Logger instance or log level. Defaults to ConsoleLogger("info") if omitted.',
       type: 'Logger | "debug" | "info" | "warn" | "error" | "silent"',
+      default: 'ConsoleLogger("info")',
     },
     streamingUpdateIntervalMs: {
       description: 'Throttle interval for fallback streaming (post + edit) in milliseconds.',

package/docs/api/thread.mdx

@@ -160,6 +160,33 @@ Get a platform-specific @-mention string for a user.
 await thread.post(`Hey ${thread.mentionUser(userId)}, check this out!`);
 ```
 
+## Serialization
+
+Threads can be serialized for workflow engines and external systems. The serialized thread includes the current message if one is available.
+
+```typescript
+// Serialize
+const json = thread.toJSON();
+
+// Pass to a workflow
+await workflow.start("my-workflow", {
+  thread: thread.toJSON(),
+});
+```
+
+The serialized format includes the thread ID, channel ID, adapter name, DM status, and the current message (if present).
+
+### Deserialization
+
+Use `bot.reviver()` as a `JSON.parse` reviver to automatically restore `Thread` and `Message` objects from serialized payloads:
+
+```typescript
+const data = JSON.parse(payload, bot.reviver());
+await data.thread.post("Hello from workflow!");
+```
+
+Under the hood, the reviver calls `ThreadImpl.fromJSON()` and `Message.fromJSON()` for any serialized objects it encounters.
+
 ## SentMessage
 
 Returned by `thread.post()`. Extends `Message` with mutation methods.

package/docs/guides/code-review-hono.mdx

@@ -150,15 +150,9 @@ const octokit = new Octokit({ auth: process.env.GITHUB_TOKEN });
 export const bot = new Chat({
   userName: process.env.BOT_USERNAME!,
   adapters: {
-    github: createGitHubAdapter({
-      token: process.env.GITHUB_TOKEN!,
-      webhookSecret: process.env.GITHUB_WEBHOOK_SECRET!,
-      userName: process.env.BOT_USERNAME!,
-    }),
+    github: createGitHubAdapter(),
   },
-  state: createRedisState({
-    url: process.env.REDIS_URL!,
-  }),
+  state: createRedisState(),
 });
 
 bot.onNewMention(async (thread, message) => {

package/docs/guides/discord-nuxt.mdx

@@ -69,29 +69,18 @@ ANTHROPIC_API_KEY=your_anthropic_api_key
 Create `server/lib/bot.ts` with a `Chat` instance configured with the Discord adapter. This bot uses AI SDK to answer support questions:
 
 ```typescript title="server/lib/bot.tsx" lineNumbers
-import { Chat, ConsoleLogger, Card, CardText as Text, Actions, Button, Divider } from "chat";
+import { Chat, Card, CardText as Text, Actions, Button, Divider } from "chat";
 import { createDiscordAdapter } from "@chat-adapter/discord";
 import { createRedisState } from "@chat-adapter/state-redis";
 import { generateText } from "ai";
 import { anthropic } from "@ai-sdk/anthropic";
 
-const logger = new ConsoleLogger();
-
 export const bot = new Chat({
   userName: "support-bot",
   adapters: {
-    discord: createDiscordAdapter({
-      botToken: process.env.DISCORD_BOT_TOKEN!,
-      publicKey: process.env.DISCORD_PUBLIC_KEY!,
-      applicationId: process.env.DISCORD_APPLICATION_ID!,
-      logger,
-    }),
+    discord: createDiscordAdapter(),
   },
-  state: createRedisState({
-    url: process.env.REDIS_URL!,
-    logger,
-  }),
-  logger,
+  state: createRedisState(),
 });
 
 bot.onNewMention(async (thread) => {

package/docs/guides/slack-nextjs.mdx

@@ -109,17 +109,9 @@ import { createRedisState } from "@chat-adapter/state-redis";
 export const bot = new Chat({
   userName: "mybot",
   adapters: {
-    slack: createSlackAdapter({
-      botToken: process.env.SLACK_BOT_TOKEN!,
-      signingSecret: process.env.SLACK_SIGNING_SECRET!,
-      logger: new ConsoleLogger(),
-    }),
+    slack: createSlackAdapter(),
   },
-  state: createRedisState({
-    url: process.env.REDIS_URL!,
-    logger: new ConsoleLogger(),
-  }),
-  logger: new ConsoleLogger(),
+  state: createRedisState(),
 });
 
 // Respond when someone @mentions the bot
@@ -134,6 +126,8 @@ bot.onSubscribedMessage(async (thread, message) => {
 });
 ```
 
+The adapter auto-detects `SLACK_BOT_TOKEN` and `SLACK_SIGNING_SECRET` from your environment, and `createRedisState()` reads `REDIS_URL` automatically.
+
 `onNewMention` fires when a user @mentions your bot. Calling `thread.subscribe()` tells the SDK to track that thread, so subsequent messages trigger `onSubscribedMessage`.
 
 ## Create the webhook route
@@ -186,17 +180,9 @@ import { createRedisState } from "@chat-adapter/state-redis";
 export const bot = new Chat({
   userName: "mybot",
   adapters: {
-    slack: createSlackAdapter({
-      botToken: process.env.SLACK_BOT_TOKEN!,
-      signingSecret: process.env.SLACK_SIGNING_SECRET!,
-      logger: new ConsoleLogger(),
-    }),
+    slack: createSlackAdapter(),
   },
-  state: createRedisState({
-    url: process.env.REDIS_URL!,
-    logger: new ConsoleLogger(),
-  }),
-  logger: new ConsoleLogger(),
+  state: createRedisState(),
 });
 
 bot.onNewMention(async (thread) => {

package/docs/index.mdx

@@ -34,17 +34,9 @@ import { createRedisState } from "@chat-adapter/state-redis";
 const bot = new Chat({
   userName: "mybot",
   adapters: {
-    slack: createSlackAdapter({
-      botToken: process.env.SLACK_BOT_TOKEN!,
-      signingSecret: process.env.SLACK_SIGNING_SECRET!,
-      logger: new ConsoleLogger(),
-    }),
+    slack: createSlackAdapter(),
   },
-  state: createRedisState({
-    url: process.env.REDIS_URL!,
-    logger: new ConsoleLogger(),
-  }),
-  logger: new ConsoleLogger(),
+  state: createRedisState(),
 });
 
 bot.onNewMention(async (thread) => {
@@ -53,6 +45,8 @@ bot.onNewMention(async (thread) => {
 });
 ```
 
+Each adapter factory auto-detects credentials from environment variables (`SLACK_BOT_TOKEN`, `SLACK_SIGNING_SECRET`, `REDIS_URL`, etc.), so you can get started with zero config. Pass explicit values to override.
+
 ## Supported platforms
 
 | Platform | Package | Mentions | Reactions | Cards | Modals | Streaming | DMs |

package/docs/state/redis.mdx

@@ -16,6 +16,8 @@ pnpm add @chat-adapter/state-redis
 
 ## Usage
 
+`createRedisState()` auto-detects the `REDIS_URL` environment variable, so you can call it with no arguments:
+
 ```typescript title="lib/bot.ts" lineNumbers
 import { Chat } from "chat";
 import { createRedisState } from "@chat-adapter/state-redis";
@@ -23,12 +25,16 @@ import { createRedisState } from "@chat-adapter/state-redis";
 const bot = new Chat({
   userName: "mybot",
   adapters: { /* ... */ },
-  state: createRedisState({
-    url: process.env.REDIS_URL!,
-  }),
+  state: createRedisState(),
 });
 ```
 
+To provide a URL explicitly:
+
+```typescript title="lib/bot.ts"
+const state = createRedisState({ url: "redis://localhost:6379" });
+```
+
 ### Using an existing client
 
 If you already have a connected Redis client, pass it directly:
@@ -57,11 +63,12 @@ const state = createRedisState({
 
 | Option | Required | Description |
 |--------|----------|-------------|
-| `url` | Yes* | Redis connection URL |
+| `url` | No* | Redis connection URL (auto-detected from `REDIS_URL`) |
 | `client` | No | Existing `redis` client instance |
 | `keyPrefix` | No | Prefix for all keys (default: `"chat-sdk"`) |
+| `logger` | No | Logger instance (defaults to `ConsoleLogger("info")`) |
 
-*Either `url` or `client` is required.
+*Either `url`, `REDIS_URL` env var, or `client` is required.
 
 ## Environment variables
 

package/docs/usage.mdx

@@ -309,16 +309,21 @@ You typically don't need to construct these yourself — they're provided by the
 
 ## Logging
 
-Configure logging when creating the `Chat` instance:
+The `logger` option is optional — if omitted, Chat SDK uses `ConsoleLogger("info")` by default. Each adapter also creates its own child logger automatically.
 
 ```typescript title="lib/bot.ts" lineNumbers
-// Use a built-in log level
+// Use defaults (ConsoleLogger at "info" level)
+const bot = new Chat({
+  // ...
+});
+
+// Or set a specific log level
 const bot = new Chat({
   // ...
   logger: "debug", // "debug" | "info" | "warn" | "error" | "silent"
 });
 
-// Or use ConsoleLogger for child loggers
+// Or use a custom ConsoleLogger for child loggers
 import { ConsoleLogger } from "chat";
 
 const logger = new ConsoleLogger("info");
@@ -328,11 +333,10 @@ const bot = new Chat({
 });
 ```
 
-Pass child loggers to adapters for prefixed log output:
+You can pass child loggers to adapters for prefixed log output, but adapters create their own child loggers by default:
 
 ```typescript title="lib/bot.ts"
 createSlackAdapter({
-  // ...
-  logger: logger.child("slack"),
+  logger: logger.child("slack"), // optional — auto-created if omitted
 });
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chat",
-  "version": "4.13.2",
+  "version": "4.13.4",
   "description": "Unified chat abstraction for Slack, Teams, Google Chat, and Discord",
   "type": "module",
   "main": "./dist/index.js",