@4via6/relay 1.0.0 → 1.1.1

package/README.md

@@ -1,10 +1,16 @@
 # Relay
 
+[![npm version](https://img.shields.io/npm/v/@4via6/relay)](https://www.npmjs.com/package/@4via6/relay)
+[![npm downloads](https://img.shields.io/npm/dm/@4via6/relay)](https://www.npmjs.com/package/@4via6/relay)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+
 Telegram bot for managing AI coding agents remotely. Supports [OpenCode](https://github.com/opencode-ai/opencode), [Claude Code](https://docs.anthropic.com/en/docs/agents-and-tools/claude-code/overview), and [OpenAI Codex](https://github.com/openai/codex).
 
 ## Features
 
-- **Multi-provider** -- switch between OpenCode, Claude Code, and Codex with a single env var
+- **Multi-provider** -- switch between OpenCode, Claude Code, and Codex
+- **Interactive setup** -- `relay onboard` wizard for first-time configuration
+- **Structured logging** -- pino-based JSON logging with configurable levels
 - **Text, voice, photo, and file input** -- send messages in any format
 - **File output** -- receive screenshots, generated files, and artifacts as Telegram attachments (OpenCode)
 - **Streaming responses** -- progressive message editing for real-time output
@@ -13,7 +19,7 @@ Telegram bot for managing AI coding agents remotely. Supports [OpenCode](https:/
 - **MCP servers** -- add, remove, and monitor MCP servers at runtime (OpenCode, Claude)
 - **Shell access** -- run commands on the coding agent's machine
 - **Voice transcription** -- Groq, OpenAI, or AssemblyAI speech-to-text
-- **Custom system prompts** -- load from file, hot-reload on change
+- **Custom system prompts** -- load from `.relay/SKILL.md`, hot-reload on change
 - **File operations** -- read, find, search, and browse project files (all providers)
 - **Code diffs** -- view git diffs from sessions (all providers)
 - **State persistence** -- sessions, model selection, and MCP configs survive restarts
@@ -25,7 +31,7 @@ Telegram bot for managing AI coding agents remotely. Supports [OpenCode](https:/
 | Guide | Description |
 |-------|-------------|
 | [Getting Started](docs/getting-started.md) | Installation, prerequisites, first steps |
-| [Configuration](docs/configuration.md) | All environment variables and options |
+| [Configuration](docs/configuration.md) | All config options and CLI flags |
 | [Providers](docs/providers.md) | Detailed setup for each provider |
 | [Commands](docs/commands.md) | Full command reference with examples |
 | [Features](docs/features.md) | Streaming, file attachments, voice, MCP, models |
@@ -36,33 +42,26 @@ Telegram bot for managing AI coding agents remotely. Supports [OpenCode](https:/
 ### From npm
 
 ```bash
-npm install -g relay
+npm install -g @4via6/relay
+relay onboard
 ```
 
-Then create a `.env` file in your working directory (see [Configuration](docs/configuration.md)):
-
-```bash
-curl -O https://raw.githubusercontent.com/Harsh-2002/relay/main/.env.example
-# Edit .env with your BOT_TOKEN, ALLOWED_USER_ID, and provider config
-relay
-```
+The setup wizard will ask for your bot token, user ID, and provider config, then save everything to `.relay/config.json`.
 
 ### From source
 
 ```bash
-git clone https://github.com/Harsh-2002/relay.git
-cd relay
+git clone https://github.com/Harsh-2002/Relay.git
+cd Relay
 npm install
 npm run build
-cp .env.example .env
-# Edit .env with your BOT_TOKEN, ALLOWED_USER_ID, and provider config
-npm start
+npm start -- onboard
 ```
 
 ### With npx (no install)
 
 ```bash
-npx relay
+npx @4via6/relay onboard
 ```
 
 ### Prerequisites
@@ -71,40 +70,92 @@ npx relay
 - A Telegram bot token (from [@BotFather](https://t.me/BotFather))
 - Provider credentials (see below)
 
+## Running
+
+### Foreground (default)
+
+```bash
+relay
+```
+
+Close the terminal and the bot stops.
+
+### Background (daemon)
+
+```bash
+relay start                  # Start as background daemon
+relay status                 # Show PID, uptime, memory
+relay logs                   # Tail logs (Ctrl+C to exit)
+relay restart                # Restart the daemon
+relay stop                   # Stop the daemon
+```
+
+The daemon uses [pm2](https://pm2.keymetrics.io/) under the hood (auto-installed on first `relay start`). CLI flags are forwarded — e.g. `relay start --provider=claude` works as expected.
+
+### Updating
+
+```bash
+relay update
+```
+
+Detects how Relay was installed (npm global or git source) and updates accordingly. If the daemon is running, it's automatically restarted after the update.
+
+**Upgrading from v1.0.x** (before `relay update` existed):
+
+```bash
+# npm
+npm install -g @4via6/relay@latest
+
+# From source
+git pull && npm install && npm run build
+```
+
+## Configuration
+
+Config is stored in `.relay/config.json`. Use the setup wizard or CLI flags:
+
+```bash
+relay onboard                    # Interactive wizard
+relay --bot-token=xxx --allowed-user-id=123 --provider=opencode  # CLI flags
+```
+
+### CLI flags
+
+| Flag | Description |
+|------|-------------|
+| `--help` | Show help |
+| `--version` | Show version |
+| `--bot-token` | Telegram bot token |
+| `--allowed-user-id` | Telegram user ID |
+| `--provider` | Provider: `opencode`, `claude`, `codex` |
+| `--bot-mode` | `polling` or `webhook` |
+| `--streaming-enabled` | `true` or `false` |
+| `--log-level` | `debug`, `info`, `warn`, `error` |
+| `--data-dir` | Data directory (default: `.relay/`) |
+| `--system-prompt-file` | Custom system prompt file |
+
+
 ## Providers
 
-Set `PROVIDER` in `.env` to select your coding agent backend.
+| Provider | Requirement |
+|----------|-------------|
+| [OpenCode](https://github.com/opencode-ai/opencode) | included |
+| [Claude Code](https://docs.anthropic.com/en/docs/agents-and-tools/claude-code/overview) | must be installed separately |
+| [OpenAI Codex](https://github.com/openai/codex) | must be installed separately |
 
-| Provider | `PROVIDER=` | Required env vars | Install |
-|----------|-------------|-------------------|---------|
-| OpenCode | `opencode` | `OPENCODE_MODE` | included |
-| Claude Code | `claude` | `ANTHROPIC_API_KEY` | `npm install @anthropic-ai/claude-code` |
-| OpenAI Codex | `codex` | `CODEX_API_KEY` or `OPENAI_API_KEY` | `npm install @openai/codex` |
+Each provider must be installed on the system where Relay runs. Relay calls the tool directly — how you install it (npm, pip, binary, etc.) is up to you.
 
 ### OpenCode
 
-```env
-PROVIDER=opencode
-OPENCODE_MODE=start           # "start" (spawn server) or "connect" (remote URL)
-OPENCODE_URL=http://localhost:4096
-```
+Select during `relay onboard` or pass `--provider=opencode`. Supports both `start` mode (spawns local server) and `connect` mode (remote URL).
 
 ### Claude Code
 
-```env
-PROVIDER=claude
-ANTHROPIC_API_KEY=sk-ant-...
-CLAUDE_MODEL=sonnet           # use /models to see all available
-CLAUDE_PERMISSION_MODE=acceptEdits
-```
+Select during `relay onboard` or pass `--provider=claude`. Claude Code must be installed and accessible. API key must be set in the environment where Claude Code runs.
 
 ### OpenAI Codex
 
-```env
-PROVIDER=codex
-CODEX_API_KEY=sk-...
-CODEX_MODEL=o3                # use /models to see all available
-```
+Select during `relay onboard` or pass `--provider=codex`. Codex must be installed and accessible. API key must be set in the environment where Codex runs.
 
 ## Commands
 
@@ -188,25 +239,24 @@ MCP servers extend the AI's capabilities with additional tools (browsers, databa
 
 ## Voice / STT
 
-Configure one or more speech-to-text providers for voice message support. The cheapest available provider is auto-selected.
-
-```env
-GROQ_API_KEY=...          # Groq Whisper (fastest, free tier)
-OPENAI_API_KEY=...        # OpenAI Whisper
-ASSEMBLYAI_API_KEY=...    # AssemblyAI
-```
+Configure speech-to-text providers during `relay onboard` or pass API keys via CLI flags. The cheapest available provider is auto-selected.
 
 ## System Prompt
 
-The bot loads a system prompt from `skill.md` in the project root (or the path set in `SYSTEM_PROMPT_FILE`). If the file doesn't exist, a default prompt is used. The file is watched for changes and reloaded automatically. Use `/system reload` to force a reload.
+The bot loads a system prompt from `.relay/SKILL.md` (or `./SKILL.md` in cwd for backward compatibility, or a custom path via `--system-prompt-file`). If no file exists, a default prompt is used. The file is watched for changes and reloaded automatically. Use `/system reload` to force a reload.
 
 ## Architecture
 
 ```
 src/
+  config/
+    schema.ts      -- Config type definitions
+    loader.ts      -- Config resolution (CLI > file > env > defaults)
+    setup.ts       -- Interactive setup wizard
+    index.ts       -- Config singleton
   providers/
     types.ts       -- Provider interface, capabilities, MCP/model types
-    index.ts       -- Provider factory (selects based on PROVIDER env var)
+    index.ts       -- Provider factory
     opencode.ts    -- OpenCode SDK provider
     claude.ts      -- Claude Code / Agent SDK provider
     codex.ts       -- OpenAI Codex SDK provider
@@ -221,6 +271,7 @@ src/
     shell.ts       -- Shell and command execution
     mcp.ts         -- MCP server management
   utils/
+    logger.ts      -- Pino-based structured logging
     store.ts       -- JSON file-backed persistence (.relay/)
     stream.ts      -- Streaming response handler
     files.ts       -- Outbound file attachment handling

package/dist/auth.d.ts

@@ -1,3 +1,4 @@
 import type { Context, NextFunction } from "grammy";
+export declare function initAuth(userId: number): boolean;
 export declare function isAuthConfigured(): boolean;
 export declare function authMiddleware(ctx: Context, next: NextFunction): Promise<void>;

package/dist/auth.js

@@ -1,9 +1,12 @@
-// Parse ALLOWED_USER_ID — fail-secure: NaN means "block all"
-const raw = process.env.ALLOWED_USER_ID;
-const allowedUserId = raw ? Number(raw) : NaN;
+// Initialized by initAuth() from index.ts
+let allowedUserId = NaN;
 // Simple in-memory rate limiter: max requests per minute per user
 const RATE_LIMIT = 30;
 const rateBuckets = new Map();
+export function initAuth(userId) {
+    allowedUserId = userId;
+    return isAuthConfigured();
+}
 export function isAuthConfigured() {
     return !isNaN(allowedUserId) && allowedUserId > 0;
 }

package/dist/auth.js.map

@@ -1 +1 @@
-{"version":3,"file":"auth.js","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAEA,6DAA6D;AAC7D,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;AACxC,MAAM,aAAa,GAAG,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;AAE9C,kEAAkE;AAClE,MAAM,UAAU,GAAG,EAAE,CAAC;AACtB,MAAM,WAAW,GAAG,IAAI,GAAG,EAAoB,CAAC;AAEhD,MAAM,UAAU,gBAAgB;IAC9B,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,aAAa,GAAG,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,GAAY,EAAE,IAAkB;IACnE,wEAAwE;IACxE,IAAI,CAAC,gBAAgB,EAAE,EAAE,CAAC;QACxB,MAAM,GAAG,CAAC,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACtE,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;IAC5B,IAAI,MAAM,KAAK,aAAa,EAAE,CAAC;QAC7B,MAAM,GAAG,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;QACjC,OAAO;IACT,CAAC;IAED,gBAAgB;IAChB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,MAAM,MAAM,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;IAC/E,IAAI,MAAM,CAAC,MAAM,IAAI,UAAU,EAAE,CAAC;QAChC,MAAM,GAAG,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACtD,OAAO;IACT,CAAC;IACD,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACjB,WAAW,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEhC,MAAM,IAAI,EAAE,CAAC;AACf,CAAC"}
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAEA,0CAA0C;AAC1C,IAAI,aAAa,GAAG,GAAG,CAAC;AAExB,kEAAkE;AAClE,MAAM,UAAU,GAAG,EAAE,CAAC;AACtB,MAAM,WAAW,GAAG,IAAI,GAAG,EAAoB,CAAC;AAEhD,MAAM,UAAU,QAAQ,CAAC,MAAc;IACrC,aAAa,GAAG,MAAM,CAAC;IACvB,OAAO,gBAAgB,EAAE,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,aAAa,GAAG,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,GAAY,EAAE,IAAkB;IACnE,wEAAwE;IACxE,IAAI,CAAC,gBAAgB,EAAE,EAAE,CAAC;QACxB,MAAM,GAAG,CAAC,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACtE,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;IAC5B,IAAI,MAAM,KAAK,aAAa,EAAE,CAAC;QAC7B,MAAM,GAAG,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;QACjC,OAAO;IACT,CAAC;IAED,gBAAgB;IAChB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,MAAM,MAAM,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;IAC/E,IAAI,MAAM,CAAC,MAAM,IAAI,UAAU,EAAE,CAAC;QAChC,MAAM,GAAG,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACtD,OAAO;IACT,CAAC;IACD,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACjB,WAAW,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEhC,MAAM,IAAI,EAAE,CAAC;AACf,CAAC"}

package/dist/bot.js

@@ -1,13 +1,14 @@
 import { Bot } from "grammy";
 import { authMiddleware } from "./auth.js";
 import { registerCommands } from "./commands/index.js";
+import { botLogger } from "./utils/logger.js";
 export function createBot(token) {
     const bot = new Bot(token);
     bot.use(authMiddleware);
     registerCommands(bot);
     bot.catch((err) => {
         const e = err.error;
-        console.error("Bot error:", e instanceof Error ? e.message : String(e));
+        botLogger.error({ err: e instanceof Error ? e.message : String(e) }, "Bot error");
     });
     return bot;
 }

package/dist/bot.js.map

@@ -1 +1 @@
-{"version":3,"file":"bot.js","sourceRoot":"","sources":["../src/bot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAC7B,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEvD,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;IAE3B,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IACxB,gBAAgB,CAAC,GAAG,CAAC,CAAC;IAEtB,GAAG,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QAChB,MAAM,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC;QACpB,OAAO,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;IAEH,OAAO,GAAG,CAAC;AACb,CAAC"}
+{"version":3,"file":"bot.js","sourceRoot":"","sources":["../src/bot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAC7B,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;IAE3B,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IACxB,gBAAgB,CAAC,GAAG,CAAC,CAAC;IAEtB,GAAG,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QAChB,MAAM,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC;QACpB,SAAS,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC;IACpF,CAAC,CAAC,CAAC;IAEH,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/cli.d.ts

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-import "./index.js";
+export {};

package/dist/cli.js

@@ -1,3 +1,112 @@
 #!/usr/bin/env node
-import "./index.js";
+import { readFileSync } from "fs";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+import { loadConfig, setConfig } from "./config/index.js";
+import { runSetupWizard } from "./config/setup.js";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+function printVersion() {
+    try {
+        const pkg = JSON.parse(readFileSync(join(__dirname, "..", "package.json"), "utf-8"));
+        console.log(`relay v${pkg.version}`);
+    }
+    catch {
+        console.log("relay (unknown version)");
+    }
+}
+function printHelp() {
+    console.log(`
+  relay — Telegram bot for AI coding agents
+
+  Usage:
+    relay                       Start the bot (foreground)
+    relay onboard               Interactive configuration wizard
+    relay start                 Start the bot as a background daemon
+    relay stop                  Stop the background daemon
+    relay restart               Restart the background daemon
+    relay logs                  Tail daemon logs (Ctrl+C to exit)
+    relay status                Show daemon status
+    relay update                Update Relay to the latest version
+    relay --help                Show this help message
+    relay --version             Show version
+
+  Options:
+    --bot-token <token>         Telegram bot token
+    --allowed-user-id <id>      Telegram user ID
+    --provider <name>           Provider: opencode, claude, codex
+    --bot-mode <mode>           Bot mode: polling, webhook
+    --streaming-enabled <bool>  Enable streaming responses
+    --log-level <level>         Log level: debug, info, warn, error
+    --data-dir <path>           Data directory (default: .relay/)
+    --system-prompt-file <path> System prompt file path
+
+  Config is loaded from: .relay/config.json
+  Run 'relay onboard' to create or update config interactively.
+
+  Documentation: https://github.com/Harsh-2002/Relay
+`);
+}
+const DAEMON_COMMANDS = new Set(["start", "stop", "restart", "logs", "status", "update"]);
+async function main() {
+    const args = process.argv.slice(2);
+    const subcommand = args[0];
+    // Route daemon subcommands before loading config
+    if (subcommand && DAEMON_COMMANDS.has(subcommand)) {
+        const daemon = await import("./daemon.js");
+        switch (subcommand) {
+            case "start":
+                daemon.daemonStart();
+                break;
+            case "stop":
+                daemon.daemonStop();
+                break;
+            case "restart":
+                daemon.daemonRestart();
+                break;
+            case "logs":
+                daemon.daemonLogs();
+                break;
+            case "status":
+                daemon.daemonStatus();
+                break;
+            case "update": {
+                const { update } = await import("./update.js");
+                update();
+                break;
+            }
+        }
+        return;
+    }
+    // Check for 'onboard' subcommand before parsing flags
+    const isOnboard = subcommand === "onboard";
+    const result = loadConfig();
+    if (result.showVersion) {
+        printVersion();
+        process.exit(0);
+    }
+    if (result.showHelp) {
+        printHelp();
+        process.exit(0);
+    }
+    if (isOnboard || result.needsSetup) {
+        if (result.needsSetup && !isOnboard) {
+            console.log("\n  No config found. Starting setup wizard...\n");
+        }
+        const config = await runSetupWizard(result.config.dataDir);
+        setConfig(config);
+        // If this was an explicit 'onboard' command, exit after saving
+        if (isOnboard) {
+            process.exit(0);
+        }
+    }
+    else {
+        setConfig(result.config);
+    }
+    // Now start the bot
+    await import("./index.js");
+}
+main().catch((err) => {
+    console.error("Fatal:", err?.message ?? err);
+    process.exit(1);
+});
 //# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,YAAY,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/commands/admin.js

@@ -1,4 +1,4 @@
-import { InputFile } from "grammy";
+import { InputFile, InlineKeyboard } from "grammy";
 import { getProvider, getProviderName } from "../providers/index.js";
 import { setSelectedModel, getSelectedModel } from "../session.js";
 import { chunkMessage } from "../utils/chunker.js";
@@ -7,6 +7,76 @@ import { isStreamingEnabled } from "../utils/stream.js";
 import { getSystemPrompt, reloadSystemPrompt, isUsingCustomPrompt } from "../utils/system-prompt.js";
 import { formatCatchError } from "../utils/errors.js";
 import { escapeHtml } from "../utils/html.js";
+const MODELS_PER_PAGE = 8;
+function buildModelKeyboard(models, page, selectedModel) {
+    // Group by provider
+    const grouped = new Map();
+    for (const m of models) {
+        const list = grouped.get(m.provider) ?? [];
+        list.push(m);
+        grouped.set(m.provider, list);
+    }
+    // Flatten into display order with provider headers
+    const items = [];
+    const allItems = [];
+    for (const [provId, provModels] of grouped) {
+        allItems.push({ type: "header", provider: provId });
+        for (const m of provModels) {
+            allItems.push({ type: "model", model: m });
+        }
+    }
+    // Count total model items (excluding headers) for pagination
+    const modelItems = allItems.filter(i => i.type === "model");
+    const totalPages = Math.max(1, Math.ceil(modelItems.length / MODELS_PER_PAGE));
+    const safePage = Math.max(0, Math.min(page, totalPages - 1));
+    // Get the slice of models for this page
+    const pageModels = modelItems.slice(safePage * MODELS_PER_PAGE, (safePage + 1) * MODELS_PER_PAGE);
+    const pageModelIds = new Set(pageModels.map(i => i.type === "model" ? i.model.id : ""));
+    // Build keyboard
+    const kb = new InlineKeyboard();
+    let headerText = `<b>Available Models</b>  (${modelItems.length})`;
+    if (totalPages > 1)
+        headerText += `  —  page ${safePage + 1}/${totalPages}`;
+    // Figure out which providers appear on this page
+    const pageProviders = new Set();
+    for (const item of pageModels) {
+        if (item.type === "model")
+            pageProviders.add(item.model.provider);
+    }
+    let lastProvider = "";
+    for (const item of pageModels) {
+        if (item.type !== "model")
+            continue;
+        const m = item.model;
+        // Add provider header row if new provider
+        if (m.provider !== lastProvider) {
+            kb.row().text(`— ${m.provider} —`, "mdl_noop");
+            lastProvider = m.provider;
+        }
+        const isActive = selectedModel?.providerID === m.provider && selectedModel?.modelID === m.id;
+        const badges = [];
+        if (m.reasoning)
+            badges.push("reasoning");
+        if (m.attachment)
+            badges.push("vision");
+        const badgeStr = badges.length > 0 ? "  [" + badges.join(", ") + "]" : "";
+        const label = isActive ? `✓ ${m.name}${badgeStr}` : `${m.name}${badgeStr}`;
+        const callbackData = `mdl:${m.provider}/${m.id}`;
+        kb.row().text(label, callbackData);
+    }
+    // Pagination row
+    if (totalPages > 1) {
+        kb.row();
+        if (safePage > 0) {
+            kb.text("« Prev", `mdl_pg:${safePage - 1}`);
+        }
+        kb.text(`${safePage + 1}/${totalPages}`, "mdl_noop");
+        if (safePage < totalPages - 1) {
+            kb.text("Next »", `mdl_pg:${safePage + 1}`);
+        }
+    }
+    return { keyboard: kb, text: headerText };
+}
 export function registerAdminCommands(bot) {
     bot.command("health", async (ctx) => {
         try {
@@ -199,33 +269,8 @@ export function registerAdminCommands(bot) {
                     m.active = true;
                 }
             }
-            // Group by provider
-            const grouped = new Map();
-            for (const m of models) {
-                const list = grouped.get(m.provider) ?? [];
-                list.push(m);
-                grouped.set(m.provider, list);
-            }
-            let text = `<b>Available Models</b>\n`;
-            for (const [provId, provModels] of grouped) {
-                text += `\n<b>${escapeHtml(provId)}</b>\n`;
-                for (const m of provModels) {
-                    const badges = [];
-                    if (m.reasoning)
-                        badges.push("reasoning");
-                    if (m.attachment)
-                        badges.push("vision");
-                    if (m.active)
-                        badges.push("active");
-                    const badgeStr = badges.length > 0 ? "  " + badges.map(b => `[${b}]`).join(" ") : "";
-                    text += `  <code>${escapeHtml(m.id)}</code>${badgeStr}\n`;
-                }
-            }
-            text += `\n<i>Use /model provider/model to switch</i>`;
-            const chunks = chunkMessage(text);
-            for (const chunk of chunks) {
-                await ctx.reply(chunk, { parse_mode: "HTML" });
-            }
+            const { keyboard, text } = buildModelKeyboard(models, 0, selected);
+            await ctx.reply(text, { parse_mode: "HTML", reply_markup: keyboard });
         }
         catch (err) {
             await ctx.reply(formatCatchError(err, "listing models"), { parse_mode: "HTML" });
@@ -309,6 +354,66 @@ export function registerAdminCommands(bot) {
         }
         await ctx.reply(`Model set to <code>${providerID}/${modelID}</code>${capStr}`, { parse_mode: "HTML" });
     });
+    // --- Callback query handlers for model selection ---
+    bot.callbackQuery(/^mdl:(.+)$/, async (ctx) => {
+        try {
+            const data = ctx.match[1];
+            const slashIdx = data.indexOf("/");
+            if (slashIdx === -1) {
+                await ctx.answerCallbackQuery({ text: "Invalid model" });
+                return;
+            }
+            const providerID = data.slice(0, slashIdx);
+            const modelID = data.slice(slashIdx + 1);
+            setSelectedModel(providerID, modelID);
+            // Build capability string
+            let capStr = "";
+            try {
+                const provider = getProvider();
+                const models = await provider.listModels();
+                const match = models.find(m => m.id === modelID && m.provider === providerID);
+                if (match) {
+                    const caps = [];
+                    if (match.reasoning)
+                        caps.push("reasoning");
+                    if (match.attachment)
+                        caps.push("vision");
+                    capStr = caps.length > 0 ? `\n<b>Capabilities:</b>  ${caps.join(", ")}` : "";
+                }
+            }
+            catch {
+                // Ignore — capabilities are optional info
+            }
+            await ctx.editMessageText(`Model set to <code>${escapeHtml(providerID)}/${escapeHtml(modelID)}</code>${capStr}`, { parse_mode: "HTML" });
+            await ctx.answerCallbackQuery({ text: "Model selected!" });
+        }
+        catch (err) {
+            await ctx.answerCallbackQuery({ text: "Failed to set model" });
+        }
+    });
+    bot.callbackQuery(/^mdl_pg:(\d+)$/, async (ctx) => {
+        try {
+            const page = parseInt(ctx.match[1], 10);
+            const provider = getProvider();
+            const models = await provider.listModels();
+            const selected = getSelectedModel();
+            // Mark active
+            for (const m of models) {
+                if (selected && selected.providerID === m.provider && selected.modelID === m.id) {
+                    m.active = true;
+                }
+            }
+            const { keyboard, text } = buildModelKeyboard(models, page, selected);
+            await ctx.editMessageText(text, { parse_mode: "HTML", reply_markup: keyboard });
+            await ctx.answerCallbackQuery();
+        }
+        catch (err) {
+            await ctx.answerCallbackQuery({ text: "Failed to load page" });
+        }
+    });
+    bot.callbackQuery("mdl_noop", async (ctx) => {
+        await ctx.answerCallbackQuery();
+    });
     bot.command("system", async (ctx) => {
         const action = ctx.match?.trim();
         if (action === "reload") {
@@ -318,7 +423,7 @@ export function registerAdminCommands(bot) {
             return;
         }
         const prompt = getSystemPrompt();
-        const source = isUsingCustomPrompt() ? "Custom (skill.md)" : "Default (built-in)";
+        const source = isUsingCustomPrompt() ? "Custom (SKILL.md)" : "Default (built-in)";
         const escaped = escapeHtml(prompt.length > 500 ? prompt.slice(0, 500) + "\n\n...(truncated)" : prompt);
         await ctx.reply(`<b>System Prompt</b>\n` +
             `<b>Source:</b>  ${source}  |  <b>Length:</b>  ${prompt.length} chars\n\n` +