@inceptionstack/roundhouse 0.4.4 → 0.4.5

package/README.md

@@ -178,7 +178,7 @@ Without a config file, defaults are used with env vars (`TELEGRAM_BOT_TOKEN`, `B
 
 | Field | Description |
 |-------|-------------|
-| `agent.type` | Agent backend: `"pi"` (more coming) |
+| `agent.type` | Agent backend: `"pi"`, `"kiro"` |
 | `agent.cwd` | Working directory for the agent |
 | `agent.sessionDir` | Override session storage path |
 | `chat.botUsername` | Bot display name for Chat SDK |
@@ -492,7 +492,7 @@ No other changes needed — the gateway's unified handler covers all platforms.
 | `src/agents/base-adapter.ts` | Abstract base class — adapter interface contract |
 | `src/agents/registry.ts` | Agent type → factory registry |
 | `src/config.ts` | Shared config loading, defaults, env overrides |
-| `test/` | Unit tests (vitest, 75 passing) |
+| `test/` | Unit + integration tests (vitest, 311 passing) |
 
 ## CI/CD
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inceptionstack/roundhouse",
-  "version": "0.4.4",
+  "version": "0.4.5",
   "type": "module",
   "description": "Multi-platform chat gateway that routes messages through a configured AI agent",
   "license": "MIT",

package/pi/extensions/web-search.ts

@@ -1,5 +1,5 @@
 import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
-import { Type } from "typebox";
+import { Type } from "@sinclair/typebox";
 
 export default function (pi: ExtensionAPI) {
   pi.registerTool({
@@ -46,6 +46,13 @@ export default function (pi: ExtensionAPI) {
           }),
           signal: controller.signal,
         });
+      } catch (err: any) {
+        clearTimeout(timeout);
+        const msg = err.name === "AbortError" ? "Request timed out (30s)" : `Network error: ${err.message}`;
+        return {
+          content: [{ type: "text", text: msg }],
+          details: { query: params.query, error: err.name },
+        };
       } finally {
         clearTimeout(timeout);
       }

package/src/agents/kiro/kiro-adapter.ts

@@ -13,6 +13,7 @@
 import { homedir } from "node:os";
 import { resolve } from "node:path";
 import type { AgentAdapterFactory, AgentMessage, AgentResponse, AgentStreamEvent, AdapterInfo } from "../../types.js";
+import { ROUNDHOUSE_VERSION } from "../../config.js";
 import { BaseAdapter } from "../base-adapter.js";
 import { spawnKiroCli, shutdownProcess, getKiroCliVersion, type AcpProcess, type InitializeResult, type SessionNewResult } from "./acp/index.js";
 import { SessionStore, type SessionEntry } from "./session.js";
@@ -188,7 +189,7 @@ class KiroAdapter extends BaseAdapter {
 
     await this.mainProcess.client.call<InitializeResult>("initialize", {
       protocolVersion: "1.0",
-      clientInfo: { name: "roundhouse", version: "0.4.3" },
+      clientInfo: { name: "roundhouse", version: ROUNDHOUSE_VERSION },
     });
 
     if (!this.reaperInterval) {

package/src/cli/cli.ts

@@ -72,7 +72,12 @@ async function cmdStart() {
     return;
   }
 
-  // No systemd service — fall back to foreground
+  // No systemd service — fall back to foreground. Check config before launching.
+  if (!(await fileExists(CONFIG_PATH))) {
+    console.error("No config found. Run 'roundhouse setup --telegram' first.");
+    process.exit(1);
+  }
+
   console.log("No systemd service found. Running in foreground (use Ctrl+C to stop)...");
   if (process.platform !== "darwin") {
     console.log("  Tip: run 'roundhouse install' to set up the systemd daemon.\n");
@@ -83,6 +88,12 @@ async function cmdStart() {
 }
 
 async function cmdRun() {
+  // Guard: check config exists before launching gateway
+  if (!(await fileExists(CONFIG_PATH))) {
+    console.error("No config found. Run 'roundhouse setup --telegram' first.");
+    process.exit(1);
+  }
+
   process.env.ROUNDHOUSE_CONFIG = CONFIG_PATH;
 
   // Load .env file so secrets (TELEGRAM_BOT_TOKEN, etc.) are available

package/src/cli/setup.ts

@@ -443,7 +443,7 @@ async function stepValidateToken(opts: SetupOptions): Promise<BotInfo> {
 }
 
 async function stepStopGateway(): Promise<void> {
-  step("③", "Checking for running gateway...");
+  step("④", "Checking for running gateway...");
 
   if (platform() !== "linux") {
     ok("Not Linux — skipping service check");
@@ -464,7 +464,7 @@ async function stepStopGateway(): Promise<void> {
 }
 
 async function stepInstallPackages(opts: SetupOptions, agent: AgentDefinition): Promise<void> {
-  step("④", "Installing packages...");
+  step("⑤", "Installing packages...");
 
   // Roundhouse
   const rhInstalled = whichSync("roundhouse");
@@ -596,12 +596,12 @@ async function stepInstallPackages(opts: SetupOptions, agent: AgentDefinition):
 
 async function stepStoreSecrets(opts: SetupOptions, botInfo: BotInfo): Promise<void> {
   if (!opts.psst) {
-    step("⑥", "Storing secrets...");
+    step("⑧", "Storing secrets...");
     ok("Skipped (default — use --with-psst to enable)");
     return;
   }
 
-  step("⑥", "Storing secrets in psst...");
+  step("⑧", "Storing secrets in psst...");
 
   const secrets: [string, string][] = [
     ["TELEGRAM_BOT_TOKEN", opts.botToken],
@@ -640,7 +640,7 @@ async function stepStoreSecrets(opts: SetupOptions, botInfo: BotInfo): Promise<v
 // ── Bundle install ──────────────────────────────────────────────────
 
 async function stepInstallBundle(opts: SetupOptions): Promise<void> {
-  step("⑥b", "Installing bundle (skills + CLI tools)...");
+  step("⑥", "Installing bundle (skills + CLI tools)...");
 
   const bundleLog: ProvisionLog = {
     info: (msg) => log(`   ${msg}`),
@@ -657,7 +657,7 @@ async function stepConfigure(
   pairResult: PairResult | null,
   agent: AgentDefinition,
 ): Promise<void> {
-  step("⑦", "Configuring...");
+  step("⑨", "Configuring...");
 
   await mkdir(ROUNDHOUSE_DIR, { recursive: true });
 
@@ -766,7 +766,7 @@ async function stepConfigure(
 }
 
 async function stepPair(opts: SetupOptions, botInfo: BotInfo): Promise<PairResult | null> {
-  step("⑤", "Pairing with Telegram...");
+  step("⑦", "Pairing with Telegram...");
 
   // Skip if chat IDs already known
   if (opts.notifyChatIds.length > 0) {
@@ -822,13 +822,13 @@ async function stepPair(opts: SetupOptions, botInfo: BotInfo): Promise<PairResul
 }
 
 async function stepRegisterCommands(opts: SetupOptions): Promise<void> {
-  step("⑧", "Registering bot commands...");
+  step("⑩", "Registering bot commands...");
   await registerBotCommands(opts.botToken);
   ok(`${BOT_COMMANDS.length} commands registered with Telegram`);
 }
 
 async function stepInstallSystemd(opts: SetupOptions): Promise<void> {
-  step("⑨", "Installing systemd service...");
+  step("⑩b", "Installing systemd service...");
 
   if (!opts.systemd) {
     ok("Skipped (--no-systemd)");
@@ -873,7 +873,7 @@ async function stepInstallSystemd(opts: SetupOptions): Promise<void> {
 }
 
 async function stepPostflight(): Promise<void> {
-  step("⑩", "Postflight checks...");
+  step("⑪", "Postflight checks...");
 
   if (platform() === "linux") {
     if (isServiceActive()) {
@@ -894,6 +894,11 @@ async function stepPostflight(): Promise<void> {
   if (!whichSync("ffmpeg")) {
     warn("ffmpeg not found (install for voice support)");
   }
+
+  if (!process.env.TAVILY_API_KEY) {
+    warn("TAVILY_API_KEY not set — web search extension won't work");
+    log("    Get a free key at https://tavily.com and add to ~/.roundhouse/.env");
+  }
 }
 
 // ── BotFather Guide ──────────────────────────────────
@@ -951,11 +956,11 @@ async function runInteractiveTelegramSetup(opts: SetupOptions): Promise<void> {
     // Step 5: Install packages
     await stepInstallPackages(opts, agent);
 
-    // Step 5b: Install bundle (skills + CLI tools)
+    // Step 6: Install bundle (skills + CLI tools)
     await stepInstallBundle(opts);
 
-    // Step 6: Pair via Telegram
-    step("⑥", "Pairing with Telegram...");
+    // Step 7: Pair via Telegram
+    step("⑦", "Pairing with Telegram...");
     const nonce = createPairingNonce();
     const pairingLink = createPairingLink(botInfo.username, nonce);
     log(`\n  Open this link to pair:\n`);
@@ -964,6 +969,16 @@ async function runInteractiveTelegramSetup(opts: SetupOptions): Promise<void> {
     log(`  Or send /start ${nonce} to @${botInfo.username}`);
     log("");
 
+    // Auto-open the pairing link on macOS
+    if (process.platform === "darwin") {
+      try {
+        execFileSync("open", [pairingLink], { stdio: "ignore" });
+        log("  (Opened in Telegram — switch to the app to complete pairing)");
+      } catch { /* ignore if open fails */ }
+    }
+
+    log("  Waiting for you to tap the link in Telegram...");
+
     const pairResult = await pairTelegram(
       opts.botToken, botInfo.username, opts.users,
       300_000, log, { nonce, showLink: false },
@@ -977,17 +992,17 @@ async function runInteractiveTelegramSetup(opts: SetupOptions): Promise<void> {
       }
     }
 
-    // Step 7: Store secrets
+    // Step 8: Store secrets
     await stepStoreSecrets(opts, botInfo);
 
-    // Step 8: Write config
+    // Step 9: Write config
     await stepConfigure(opts, botInfo, pairResult, agent);
 
-    // Step 9: Register commands + install service
+    // Step 10: Register commands + install service
     await stepRegisterCommands(opts);
     await stepInstallSystemd(opts);
 
-    // Step 10: Verify
+    // Step 11: Verify
     await stepPostflight();
 
     // Done!

package/src/config.ts

@@ -8,8 +8,21 @@
 import { homedir } from "node:os";
 import { resolve } from "node:path";
 import { readFile, access } from "node:fs/promises";
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
 import type { GatewayConfig } from "./types";
 
+// ── Version ──────────────────────────────────────────
+
+const __configDir = dirname(fileURLToPath(import.meta.url));
+
+/** Roundhouse package version (read from package.json at startup) */
+export const ROUNDHOUSE_VERSION: string = (() => {
+  try { return JSON.parse(readFileSync(join(__configDir, "..", "package.json"), "utf8")).version; }
+  catch { return "unknown"; }
+})();
+
 // ── Path constants ───────────────────────────────────
 
 /** New canonical config root */

package/src/gateway.ts

@@ -13,7 +13,7 @@ import { isTelegramThread, postTelegramHtml, handleTelegramHtmlStream } from "./
 import { SttService, enrichAttachmentsWithTranscripts, DEFAULT_STT_CONFIG } from "./voice/stt-service";
 import { sendTelegramToMany } from "./notify/telegram";
 import { runDoctor, formatDoctorTelegram, createDoctorContext } from "./cli/doctor/runner";
-import { ROUNDHOUSE_DIR } from "./config";
+import { ROUNDHOUSE_DIR, ROUNDHOUSE_VERSION } from "./config";
 import { CronSchedulerService } from "./cron/scheduler";
 import { isBuiltinJob } from "./cron/helpers";
 import { formatSchedule, formatRunCounts, jobEnabledIcon } from "./cron/format";
@@ -65,10 +65,6 @@ import { join, dirname, basename } from "node:path";
 import { fileURLToPath } from "node:url";
 
 const __gatewayDir = dirname(fileURLToPath(import.meta.url));
-const ROUNDHOUSE_VERSION: string = (() => {
-  try { return JSON.parse(readFileSync(join(__gatewayDir, "..", "package.json"), "utf8")).version; }
-  catch { return "unknown"; }
-})();
 
 function telegramChatIdFromThreadId(threadId: unknown): number | null {
   if (typeof threadId !== "string") return null;