@friendlyrobot/discord-pi-agent 0.5.0 → 0.5.1

package/README.md

@@ -1,15 +1,15 @@
 # @friendlyrobot/discord-pi-agent
 
-Reusable Discord DM bridge for persistent pi agent sessions.
+Reusable Discord gateway bridge for persistent pi agent sessions — DM and forum channels.
 
 ## What it does
 
-- runs one long-lived pi agent session
-- resumes the latest session on restart
+- runs persistent pi agent sessions (one per DM, one per forum thread)
+- resumes sessions on restart via scoped session directories
 - loads project context from the target repo via pi resource loading
-- accepts DM messages from one allowed Discord user
-- serializes prompts through a FIFO queue
-- exposes built-in session commands
+- accepts DM messages and forum thread messages from allowed users
+- serializes prompts per-scope through FIFO queues
+- exposes built-in session commands (per-scope, including `!archive`)
 
 ## Built-in commands
 
@@ -19,8 +19,9 @@ Reusable Discord DM bridge for persistent pi agent sessions.
 - `!compact`
 - `!reload`
 - `!reset-session`
+- `!archive` (forum threads only — archives the thread and shuts down the session)
 
-Any other DM text is sent to the persistent agent session.
+Any other text is sent to the active session (DM or thread).
 
 ## Install
 
@@ -28,41 +29,33 @@ Any other DM text is sent to the persistent agent session.
 bun add @friendlyrobot/discord-pi-agent
 ```
 
-## Minimal usage
-
-```ts
-import { startDiscordPiBridge } from "@friendlyrobot/discord-pi-agent";
-
-const bridge = await startDiscordPiBridge({
-  discordBotToken: process.env.DISCORD_BOT_TOKEN!,
-  discordAllowedUserId: process.env.DISCORD_ALLOWED_USER_ID!,
-  cwd: process.cwd(),
-  modelProvider: "openrouter",
-  modelId: "anthropic/claude-3.5-haiku",
-});
-```
-
-## Usage with dotenv and time context
+## Usage
 
 ```ts
 import {
   buildTimeContextPrompt,
-  loadDiscordPiBridgeConfigFromEnv,
-  startDiscordPiBridge,
+  loadDiscordGatewayConfigFromEnv,
+  startDiscordGateway,
 } from "@friendlyrobot/discord-pi-agent";
 
-const config = loadDiscordPiBridgeConfigFromEnv({
+const config = loadDiscordGatewayConfigFromEnv({
+  cwd: process.cwd(),
   promptTransform: (input) => {
     return buildTimeContextPrompt(input, {
       timeZone: "Australia/Sydney",
       locale: "en-AU",
     });
   },
+  // Enable forum channel support (omit for DM-only)
+  discordAllowedForumChannelIds: ["1498563501780897832"],
 });
 
-await startDiscordPiBridge(config);
+await startDiscordGateway(config);
 ```
 
+Each forum post creates a scoped pi session in `sessions/thread-<id>/`.
+The initial post body becomes the first prompt. Sessions survive restarts.
+
 ## Config
 
 ### Required
@@ -81,9 +74,15 @@ await startDiscordPiBridge(config);
 - `startupMessage` default: `Bot is online and ready.`
 - `shutdownOnSignals` default: `true`
 
-## Env helper
+### Forum channel options
 
-`loadDiscordPiBridgeConfigFromEnv()` supports:
+- `discordAllowedForumChannelIds` — string array of forum channel IDs to respond in
+- `discordAllowedUserIds` — string array of allowed user IDs (defaults to `[discordAllowedUserId]`)
+- `sessionIdleTimeoutMs` — auto-shutdown idle thread sessions (null = never)
+
+## Env helpers
+
+`loadDiscordGatewayConfigFromEnv()` — the config loader:
 
 - `DISCORD_BOT_TOKEN`
 - `DISCORD_ALLOWED_USER_ID`
@@ -92,9 +91,11 @@ await startDiscordPiBridge(config);
 - `PI_MODEL_PROVIDER`
 - `PI_MODEL_ID`
 - `DISCORD_STARTUP_MESSAGE`
+- `DISCORD_FORUM_CHANNEL_IDS` — comma-separated forum channel IDs
+- `DISCORD_ALLOWED_USER_IDS` — comma-separated allowed user IDs
+- `DISCORD_SESSION_IDLE_TIMEOUT_MS` — idle timeout in ms
 
 If `PI_AGENT_CWD` is missing it falls back to `process.cwd()`.
-
 Set `DISCORD_STARTUP_MESSAGE=false` to disable the startup DM.
 
 ## Thinking Levels
@@ -112,7 +113,10 @@ bun run typecheck
 
 ## Notes
 
-- DM-only by design
-- single allowed user by design
-- the package does not register Discord slash commands
+- DM and forum threads supported via `startDiscordGateway`
+- Forum thread sessions are stored in `sessions/thread-<id>/` (one directory per thread)
+- Sessions survive restarts — `SessionManager.continueRecent()` resumes the latest `.jsonl`
+- Single Discord client with all intents (DM + Guild + MessageContent)
+- No mode flags — forum support activates when `discordAllowedForumChannelIds` is set
+- The package does not register Discord slash commands
 - pi resources are loaded from the configured `cwd` and `agentDir`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@friendlyrobot/discord-pi-agent",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "Reusable Discord gateway bridge for persistent pi agent sessions",
   "license": "MIT",
   "type": "module",
@@ -36,8 +36,8 @@
     "typecheck": "tsgo --noEmit -p tsconfig.json"
   },
   "dependencies": {
-    "@mariozechner/pi-ai": "^0.70.2",
-    "@mariozechner/pi-coding-agent": "^0.70.2",
+    "@mariozechner/pi-ai": "^0.70.5",
+    "@mariozechner/pi-coding-agent": "^0.70.5",
     "discord.js": "^14.26.3",
     "dotenv": "^17.4.2",
     "marked": "^18.0.2",
@@ -45,7 +45,7 @@
   },
   "devDependencies": {
     "@types/node": "^25.6.0",
-    "@typescript/native-preview": "^7.0.0-dev.20260424.2",
+    "@typescript/native-preview": "^7.0.0-dev.20260427.1",
     "@vitest/ui": "^4.1.5",
     "vitest": "^4.1.5"
   }