verbalcoding 0.2.3 → 0.2.4

package/app-node/discord_text.test.mjs

@@ -8,6 +8,20 @@ test('splitDiscordMessage chunks long text for Discord', () => {
   assert.deepEqual(chunks.map(c => c.length), [1900, 1900, 201]);
 });
 
+test('sendDiscordText returns false without fetching when transcript channel id is missing', async () => {
+  const warnings = [];
+  let fetched = false;
+  const delivered = await sendDiscordText({
+    channelId: '',
+    text: 'restart complete',
+    client: { channels: { fetch: async () => { fetched = true; } } },
+    warn: (...args) => warnings.push(args.join(' ')),
+  });
+  assert.equal(delivered, false);
+  assert.equal(fetched, false);
+  assert.match(warnings.join('\n'), /missing transcript channel id/);
+});
+
 test('sendDiscordText returns false when target is not text based', async () => {
   const warnings = [];
   const delivered = await sendDiscordText({

package/app-node/main.mjs

@@ -166,7 +166,7 @@ const settings = {
   token: process.env.DISCORD_BOT_TOKEN || process.env.DISCORD_TOKEN,
   allowedUsers: new Set((process.env.DISCORD_ALLOWED_USERS || '').split(/[;,]/).map(s => s.trim()).filter(Boolean)),
   autoJoinVoiceChannels: (process.env.AUTO_JOIN_VOICE_CHANNELS || '일반,General,general').split(',').map(s => s.trim().toLowerCase()).filter(Boolean),
-  transcriptChannelId: (process.env.TRANSCRIPT_CHANNEL_ID || '123456789012345678').trim(),
+  transcriptChannelId: (process.env.TRANSCRIPT_CHANNEL_ID || '').trim(),
   whisperBin: process.env.WHISPER_CPP_BIN || 'whisper-cli',
   whisperModel: process.env.WHISPER_CPP_MODEL || path.join(ROOT, 'models', 'ggml-small-q5_1.bin'),
   whisperLanguage: process.env.WHISPER_CPP_LANGUAGE || process.env.STT_LANGUAGE || 'ko',
@@ -1402,26 +1402,32 @@ async function connectTo(channel) {
     selfDeaf: false,
     selfMute: false,
   });
-  connection.subscribe(player);
-  connection.on('error', e => warn('voice connection error', e?.stack || e));
-  connection.on('stateChange', async (oldState, newState) => {
+  const voiceConnection = connection;
+  voiceConnection.subscribe(player);
+  voiceConnection.on('error', e => warn('voice connection error', e?.stack || e));
+  voiceConnection.on('stateChange', async (oldState, newState) => {
     log('voice connection state', oldState.status, '->', newState.status);
+    if (connection !== voiceConnection) {
+      log('ignore stale voice connection state', oldState.status, '->', newState.status);
+      return;
+    }
     if (newState.status === VoiceConnectionStatus.Disconnected) {
       try {
         await Promise.race([
-          entersState(connection, VoiceConnectionStatus.Signalling, 5000),
-          entersState(connection, VoiceConnectionStatus.Connecting, 5000),
+          entersState(voiceConnection, VoiceConnectionStatus.Signalling, 5000),
+          entersState(voiceConnection, VoiceConnectionStatus.Connecting, 5000),
         ]);
       } catch (e) {
+        if (connection !== voiceConnection) return;
         warn('voice connection disconnected; reconnecting to channel', channel.guild.name, channel.name, e?.message || e);
-        try { connection?.destroy(); } catch {}
+        try { voiceConnection.destroy(); } catch {}
         connection = null;
         setTimeout(() => connectTo(channel).catch(err => warn('voice reconnect failed', err?.stack || err)), 1500);
       }
     }
   });
-  await entersState(connection, VoiceConnectionStatus.Ready, 30000);
-  connection.receiver.speaking.on('start', userId => subscribeUser(connection.receiver, userId));
+  await entersState(voiceConnection, VoiceConnectionStatus.Ready, 30000);
+  voiceConnection.receiver.speaking.on('start', userId => subscribeUser(voiceConnection.receiver, userId));
   log(`Listening in voice channel ${channel.guild.name} / ${channel.name}`);
 }
 

package/docs/CONFIGURATION.md

@@ -2,6 +2,12 @@
 
 ## Setup Wizard
 
+Discord bot/application setup is intentionally not re-explained from scratch here. Use these upstream guides for the Discord-side steps, then return to VerbalCoding setup:
+
+- Hermes Agent Discord messaging guide: <https://hermes-agent.nousresearch.com/docs/user-guide/messaging/discord>
+- Discord official bot overview: <https://docs.discord.com/developers/bots/overview>
+- Discord official quick start: <https://docs.discord.com/developers/quick-start/getting-started>
+
 ```bash
 ./scripts/install.sh
 ```

package/docs/FRESH_INSTALL.md

@@ -77,6 +77,14 @@ If your OS is unsupported, install these manually before rerunning:
 
 ## 3. Discord application setup
 
+Read the upstream Discord bot setup guides first if this is your first bot:
+
+- Hermes Agent Discord messaging guide: <https://hermes-agent.nousresearch.com/docs/user-guide/messaging/discord>
+- Discord official bot overview: <https://docs.discord.com/developers/bots/overview>
+- Discord official getting started guide: <https://docs.discord.com/developers/quick-start/getting-started>
+
+Those pages show how to create a Discord application, add a bot user, enable privileged intents, and invite it to a server. VerbalCoding uses the same Discord bot setup, then adds voice receive, STT, CLI-agent execution, and TTS playback on top.
+
 1. Create a Discord application and bot in the Discord Developer Portal.
 2. Enable the Message Content privileged intent.
 3. Copy the bot token into the installer prompt or `.env` as `DISCORD_BOT_TOKEN`.

package/docs/USAGE.md

@@ -43,6 +43,13 @@ The bot auto-joins the first configured channel name, defaulting to `일반,Gene
 
 ## Discord Commands
 
+Before wiring commands, set up the Discord application/bot using the upstream guides:
+
+- Hermes Agent Discord guide: <https://hermes-agent.nousresearch.com/docs/user-guide/messaging/discord>
+- Discord official bot docs: <https://docs.discord.com/developers/bots/overview>
+
+Then use `vc bot invite CLIENT_ID` to generate the VerbalCoding-specific invite URL with text and voice permissions.
+
 | Command | Purpose |
 |---|---|
 | `!ping` | Basic bot check |

package/docs/i18n/CONFIGURATION.ko.md

@@ -2,6 +2,12 @@
 
 ## 설정 마법사
 
+Discord 봇/애플리케이션 생성 절차는 여기에서 처음부터 반복 설명하지 않습니다. Discord 쪽 설정은 아래 상위 문서를 보고 진행한 뒤 VerbalCoding 설정으로 돌아오세요.
+
+- Hermes Agent Discord 메시징 가이드: <https://hermes-agent.nousresearch.com/docs/user-guide/messaging/discord>
+- Discord 공식 봇 개요: <https://docs.discord.com/developers/bots/overview>
+- Discord 공식 시작 가이드: <https://docs.discord.com/developers/quick-start/getting-started>
+
 npm으로 설치한 경우:
 
 ```bash

package/docs/i18n/FRESH_INSTALL.ko.md

@@ -77,6 +77,14 @@ OS가 지원되지 않으면 아래를 직접 설치한 뒤 다시 실행하세
 
 ## 3. Discord 애플리케이션 설정
 
+Discord 봇을 처음 만든다면 먼저 공식/상위 문서를 확인하세요.
+
+- Hermes Agent Discord 메시징 가이드: <https://hermes-agent.nousresearch.com/docs/user-guide/messaging/discord>
+- Discord 공식 봇 개요: <https://docs.discord.com/developers/bots/overview>
+- Discord 공식 시작 가이드: <https://docs.discord.com/developers/quick-start/getting-started>
+
+위 문서에는 Discord 애플리케이션 생성, bot user 추가, privileged intent 활성화, 서버 초대 방법이 설명되어 있습니다. VerbalCoding도 같은 Discord bot 설정을 사용하고, 그 위에 음성 수신, STT, CLI 에이전트 실행, TTS 재생을 얹습니다.
+
 1. Discord Developer Portal에서 애플리케이션과 봇을 만듭니다.
 2. Message Content privileged intent를 켭니다.
 3. 봇 토큰을 설치 프롬프트 또는 `.env`의 `DISCORD_BOT_TOKEN`에 넣습니다.

package/docs/i18n/USAGE.ko.md

@@ -51,6 +51,13 @@ VERBALCODING_INSTANCE_ENV=instances/my-project.env ./run.sh
 
 ## Discord 명령
 
+명령을 연결하기 전에 먼저 상위 문서대로 Discord 애플리케이션/봇을 설정하세요.
+
+- Hermes Agent Discord 가이드: <https://hermes-agent.nousresearch.com/docs/user-guide/messaging/discord>
+- Discord 공식 봇 문서: <https://docs.discord.com/developers/bots/overview>
+
+그 다음 `vc bot invite CLIENT_ID`를 사용하면 VerbalCoding에 필요한 텍스트/음성 권한이 포함된 초대 URL을 만들 수 있습니다.
+
 | 명령 | 용도 |
 |---|---|
 | `!ping` | 봇 연결 기본 확인 |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "verbalcoding",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "description": "Discord voice bridge for CLI coding agents.",
   "license": "MIT",
   "repository": {