feat(config): add PROJECTS_LIST_LIMIT for /projects list

Author: grinev

.env.example

@@ -36,6 +36,10 @@ OPENCODE_MODEL_ID=big-pickle
 # Bot Configuration (optional)
 # Maximum number of sessions shown in /sessions (default: 10)
 # SESSIONS_LIST_LIMIT=10
+
+# Maximum number of projects shown in /projects (default: 10)
+# PROJECTS_LIST_LIMIT=10
+
 # Bot locale: en or ru (default: en)
 # BOT_LOCALE=en
 
@@ -53,3 +57,12 @@ OPENCODE_MODEL_ID=big-pickle
 # Code File Settings (optional)
 # Maximum file size in KB to send as document (default: 100)
 # CODE_FILE_MAX_SIZE_KB=100
+
+# Speech-to-Text / Voice Recognition (optional)
+# Enable voice message transcription by setting a Whisper-compatible API URL.
+# Works with OpenAI, Groq, or any Whisper-compatible endpoint.
+# If STT_API_URL is not set, voice messages will get a "not configured" reply.
+# STT_API_URL=
+# STT_API_KEY=
+# STT_MODEL=
+# STT_LANGUAGE=

AGENTS.md

@@ -255,6 +255,7 @@ OPENCODE_MODEL_ID=big-pickle
 
 # Bot options (optional)
 # SESSIONS_LIST_LIMIT=10
+# PROJECTS_LIST_LIMIT=10
 # BOT_LOCALE=en    # en or ru
 
 # File output options (optional)
@@ -275,6 +276,7 @@ OPENCODE_MODEL_ID=big-pickle
 | `OPENCODE_SERVER_PASSWORD` | OpenCode auth password            | No       | empty                   |
 | `LOG_LEVEL`                | Logging level                     | No       | `info`                  |
 | `SESSIONS_LIST_LIMIT`      | Max sessions shown in `/sessions` | No       | `10`                    |
+| `PROJECTS_LIST_LIMIT`      | Max projects shown in `/projects` | No       | `10`                    |
 | `BOT_LOCALE`               | Bot locale (`en` or `ru`)         | No       | `en`                    |
 | `CODE_FILE_MAX_SIZE_KB`    | Max code file size to send        | No       | `100`                   |
 

README.md

@@ -137,6 +137,7 @@ When installed via npm, the configuration wizard handles the initial setup. The
 | `OPENCODE_MODEL_ID`             | Default model ID                                                                                             |   Yes    | `big-pickle`             |
 | `BOT_LOCALE`                    | Bot UI language (`en` or `ru`)                                                                               |    No    | `en`                     |
 | `SESSIONS_LIST_LIMIT`           | Max sessions shown in `/sessions`                                                                            |    No    | `10`                     |
+| `PROJECTS_LIST_LIMIT`           | Max projects shown in `/projects`                                                                            |    No    | `10`                     |
 | `SERVICE_MESSAGES_INTERVAL_SEC` | Service messages interval (thinking + tool calls); keep `>=2` to avoid Telegram rate limits, `0` = immediate |    No    | `5`                      |
 | `HIDE_THINKING_MESSAGES`        | Hide `💭 Thinking...` service messages                                                                       |    No    | `false`                  |
 | `HIDE_TOOL_CALL_MESSAGES`       | Hide tool-call service messages (`💻 bash ...`, `📖 read ...`, etc.)                                         |    No    | `false`                  |

src/bot/commands/projects.ts

@@ -15,9 +15,9 @@ import { createMainKeyboard } from "../utils/keyboard.js";
 import { ensureActiveInlineMenu, replyWithInlineMenu } from "../handlers/inline-menu.js";
 import { logger } from "../../utils/logger.js";
 import { t } from "../../i18n/index.js";
+import { config } from "../../config.js";
 
 const MAX_INLINE_BUTTON_LABEL_LENGTH = 64;
-const MAX_PROJECTS_TO_SHOW = 10;
 
 function formatProjectButtonLabel(label: string, isActive: boolean): string {
   const prefix = isActive ? "✅ " : "";
@@ -34,7 +34,7 @@ export async function projectsCommand(ctx: CommandContext<Context>) {
   try {
     await syncSessionDirectoryCache();
     const projects = await getProjects();
-    const projectsToShow = projects.slice(0, MAX_PROJECTS_TO_SHOW);
+    const projectsToShow = projects.slice(0, config.bot.projectsListLimit);
 
     if (projectsToShow.length === 0) {
       await ctx.reply(t("projects.empty"));

src/config.ts

@@ -106,6 +106,7 @@ export const config = {
   },
   bot: {
     sessionsListLimit: getOptionalPositiveIntEnvVar("SESSIONS_LIST_LIMIT", 10),
+    projectsListLimit: getOptionalPositiveIntEnvVar("PROJECTS_LIST_LIMIT", 10),
     locale: getOptionalLocaleEnvVar("BOT_LOCALE", "en"),
     serviceMessagesIntervalSec: getOptionalNonNegativeIntEnvVarFromKeys(
       ["SERVICE_MESSAGES_INTERVAL_SEC", "TOOL_MESSAGES_INTERVAL_SEC"],

tests/stt/client.test.ts

@@ -33,6 +33,7 @@ vi.mock("../../src/config.js", () => ({
     server: { logLevel: "error" },
     bot: {
       sessionsListLimit: 10,
+      projectsListLimit: 10,
       locale: "en",
       serviceMessagesIntervalSec: 5,
       hideThinkingMessages: false,