switchroom 0.13.59 → 0.13.61

package/dist/cli/switchroom.js

@@ -49057,8 +49057,8 @@ var {
 } = import__.default;
 
 // src/build-info.ts
-var VERSION = "0.13.59";
-var COMMIT_SHA = "0f0b953e";
+var VERSION = "0.13.61";
+var COMMIT_SHA = "43241ade";
 
 // src/cli/agent.ts
 init_source();
@@ -51271,7 +51271,18 @@ function buildSettingsHooksBlock(p) {
     }
   ] : [];
   const useHotReloadStable = agentConfig.channels?.telegram?.hotReloadStable === true;
-  const turnPacingDirective = "<turn-pacing>You are messaging a human in a chat. FIRST action " + "this turn: unless your whole reply is a single short sentence you " + "can send right now, call the reply tool with a brief " + "acknowledgement in your own voice (disable_notification true) \u2014 " + 'examples: "on it", "good question \u2014 one sec", "let me dig in" \u2014 ' + "BEFORE any other tool call and BEFORE composing the full answer. " + "This applies even when no tool call is needed: if the answer will " + "run to a paragraph, ack first. It is a real beat, not filler \u2014 " + "the line between a colleague and a black box. Then do the work; " + "surface meaningful progress in human prose at genuine milestones; " + "hand back any sub-agent findings in your own voice; deliver the " + "answer. Do not acknowledge a trivial one-liner, and never " + "acknowledge twice.</turn-pacing>";
+  const turnPacingDirective = "<turn-pacing>You are messaging a human via Telegram. The framework " + "automatically shows the user a live preview in their compose area as " + 'you work \u2014 they see "Read a file", "Ran 2 commands", etc. as your ' + `tool_use events stream. You do NOT need to ack manually.
+
+` + 'Do NOT call the reply tool with placeholder acks like "on it", ' + '"good question \u2014 one sec", "let me dig in", "checking now", etc. ' + "Those add chat clutter on top of the activity preview the user is " + "already seeing. The activity preview clears the moment you send a " + `real reply.
+
+` + `Call reply only when you have something substantive to deliver:
+` + `  - The actual answer (any length \u2014 short or long)
+` + `  - A genuine question back to the user
+` + "  - A real mid-work milestone or pivot that changes what the user " + 'should expect (e.g. "halfway through \u2014 found an unexpected issue, ' + `want me to continue?"). Not "still working".
+
+` + "For trivial one-sentence answers: just reply with the answer. The " + `reply IS the answer, not an ack.
+
+` + "For complex tool-driven work: go straight to the tools. The compose-" + "area preview is the ambient liveness signal. Reply once you have " + "the answer or a real reason to break in.</turn-pacing>";
   const switchroomUserPromptSubmit = [
     ...useHotReloadStable ? [
       {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "switchroom",
-  "version": "0.13.59",
+  "version": "0.13.61",
   "description": "Run Claude Code 24/7 on your Claude Pro/Max subscription over Telegram. Open-source alternative to OpenClaw and NanoClaw — no API keys.",
   "type": "module",
   "bin": {

package/telegram-plugin/dist/gateway/gateway.js

@@ -49688,10 +49688,10 @@ function sweepStaleTurnActiveMarker(stateDir, opts) {
 }
 
 // ../src/build-info.ts
-var VERSION = "0.13.59";
-var COMMIT_SHA = "0f0b953e";
-var COMMIT_DATE = "2026-05-28T00:31:56Z";
-var LATEST_PR = 1936;
+var VERSION = "0.13.61";
+var COMMIT_SHA = "43241ade";
+var COMMIT_DATE = "2026-05-28T01:27:29Z";
+var LATEST_PR = 1940;
 var COMMITS_AHEAD_OF_TAG = 0;
 
 // gateway/boot-version.ts

package/dist/cli/ack-first-pretool.mjs

@@ -1,75 +0,0 @@
-// src/cli/ack-first-pretool.ts
-import { existsSync } from "node:fs";
-import { join } from "node:path";
-var REPLY_TOOL_NAMES = new Set([
-  "mcp__switchroom-telegram__reply",
-  "mcp__switchroom-telegram__stream_reply"
-]);
-var ACK_SENT_MARKER = "ack-sent.flag";
-function decide(input, stateDir) {
-  const toolName = input.tool_name ?? "";
-  if (toolName === "") {
-    return { decision: "allow" };
-  }
-  if (REPLY_TOOL_NAMES.has(toolName)) {
-    return { decision: "allow" };
-  }
-  if (!stateDir) {
-    return { decision: "allow" };
-  }
-  const markerPath = join(stateDir, ACK_SENT_MARKER);
-  let ackAlreadySent = false;
-  try {
-    ackAlreadySent = existsSync(markerPath);
-  } catch {
-    return { decision: "allow" };
-  }
-  if (ackAlreadySent) {
-    return { decision: "allow" };
-  }
-  return {
-    decision: "block",
-    reason: "First call `mcp__switchroom-telegram__reply` with a brief one-line " + "acknowledgement in your persona's voice before using any other tool \u2014 " + 'e.g. "on it \u2014 checking", "good question \u2014 one sec", "let me dig in". ' + "This is the framework's enforcement of the human-feel design " + "(`reference/conversational-pacing.md` beat 1): a colleague answers " + "in a beat. The reply can be the entire short answer if you have one " + "ready (then no further work needed); otherwise it's a brief status " + "and you continue with the work after."
-  };
-}
-async function runHook() {
-  if (process.env.SWITCHROOM_DISABLE_ACK_FIRST_GATE === "1") {
-    process.exit(0);
-  }
-  const stdin = await readStdin();
-  let input;
-  try {
-    input = JSON.parse(stdin);
-  } catch {
-    process.exit(0);
-  }
-  const stateDir = process.env.TELEGRAM_STATE_DIR;
-  const decision = decide(input, stateDir);
-  if (decision.decision === "block") {
-    process.stdout.write(JSON.stringify({ decision: "block", reason: decision.reason }) + `
-`);
-  }
-  process.exit(0);
-}
-async function readStdin() {
-  return new Promise((resolve, reject) => {
-    const chunks = [];
-    process.stdin.on("data", (chunk) => chunks.push(chunk));
-    process.stdin.on("end", () => resolve(Buffer.concat(chunks).toString("utf-8")));
-    process.stdin.on("error", reject);
-    if (process.stdin.isTTY)
-      resolve("");
-  });
-}
-if (typeof process !== "undefined" && process.argv?.[1]?.endsWith("ack-first-pretool.mjs")) {
-  runHook().catch((err) => {
-    process.stderr.write(`ack-first-pretool: hook failed unexpectedly: ${err}
-`);
-    process.exit(0);
-  });
-}
-export {
-  runHook,
-  decide,
-  ACK_SENT_MARKER
-};

package/telegram-plugin/ack-flag.ts

@@ -1,66 +0,0 @@
-/**
- * Ack-first state flag — load-bearing for the ack-first-pretool hook
- * (see `src/cli/ack-first-pretool.ts` and
- * `reference/conversational-pacing.md` beat 1).
- *
- * The gateway is the source of truth for "has the model called reply
- * yet this turn?". The PreToolUse hook runs as a short-lived child
- * process so it can't read gateway in-memory state; the hand-off is
- * a single file inside `$TELEGRAM_STATE_DIR`:
- *
- *   - `markAckSent()` touches the file on the first reply per turn.
- *   - `clearAckSent()` removes it at turn_started.
- *   - The hook checks `existsSync(path)` → allow / block.
- *
- * Per-agent isolation is built-in: `$TELEGRAM_STATE_DIR` is the
- * agent's per-container state dir (~/.switchroom/agents/<name>/telegram,
- * bind-mounted into /state/agent/home/.switchroom/agents/<name>/telegram
- * inside the container).
- *
- * All operations are best-effort: a write or unlink failure logs to
- * stderr and returns; the gate is informational UX, not a safety
- * primitive, so a broken state-dir must never wedge reply itself.
- */
-
-import { closeSync, existsSync, openSync, unlinkSync } from "node:fs";
-import { join } from "node:path";
-
-export const ACK_SENT_MARKER = "ack-sent.flag";
-
-function markerPath(): string | null {
-  const dir = process.env.TELEGRAM_STATE_DIR;
-  if (!dir) return null;
-  return join(dir, ACK_SENT_MARKER);
-}
-
-/** Create the ack-sent marker. Idempotent (no-op if it exists). */
-export function markAckSent(): void {
-  const path = markerPath();
-  if (path == null) return;
-  if (existsSync(path)) return;
-  try {
-    const fd = openSync(path, "w");
-    closeSync(fd);
-  } catch (err) {
-    process.stderr.write(
-      `ack-flag: markAckSent failed path=${path}: ${err}\n`,
-    );
-  }
-}
-
-/** Remove the ack-sent marker. Idempotent. */
-export function clearAckSent(): void {
-  const path = markerPath();
-  if (path == null) return;
-  try {
-    unlinkSync(path);
-  } catch (err: unknown) {
-    // ENOENT is the common case (turn started before any prior turn
-    // ran a reply); silently swallow.
-    const code = (err as { code?: string } | undefined)?.code;
-    if (code === "ENOENT") return;
-    process.stderr.write(
-      `ack-flag: clearAckSent failed path=${path}: ${err}\n`,
-    );
-  }
-}

package/telegram-plugin/tests/ack-flag.test.ts

@@ -1,65 +0,0 @@
-import { describe, it, expect, beforeEach, afterEach } from "vitest";
-import { mkdtempSync, rmSync, existsSync } from "node:fs";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-
-import { markAckSent, clearAckSent, ACK_SENT_MARKER } from "../ack-flag.js";
-
-describe("ack-flag — gateway-side state file for ack-first hook", () => {
-  let stateDir: string;
-  let prevEnv: string | undefined;
-
-  beforeEach(() => {
-    stateDir = mkdtempSync(join(tmpdir(), "ack-flag-"));
-    prevEnv = process.env.TELEGRAM_STATE_DIR;
-    process.env.TELEGRAM_STATE_DIR = stateDir;
-  });
-
-  afterEach(() => {
-    if (prevEnv != null) process.env.TELEGRAM_STATE_DIR = prevEnv;
-    else delete process.env.TELEGRAM_STATE_DIR;
-    rmSync(stateDir, { recursive: true, force: true });
-  });
-
-  it("markAckSent creates the marker file", () => {
-    expect(existsSync(join(stateDir, ACK_SENT_MARKER))).toBe(false);
-    markAckSent();
-    expect(existsSync(join(stateDir, ACK_SENT_MARKER))).toBe(true);
-  });
-
-  it("markAckSent is idempotent (second call is a no-op)", () => {
-    markAckSent();
-    expect(() => markAckSent()).not.toThrow();
-    expect(existsSync(join(stateDir, ACK_SENT_MARKER))).toBe(true);
-  });
-
-  it("clearAckSent removes the marker file", () => {
-    markAckSent();
-    expect(existsSync(join(stateDir, ACK_SENT_MARKER))).toBe(true);
-    clearAckSent();
-    expect(existsSync(join(stateDir, ACK_SENT_MARKER))).toBe(false);
-  });
-
-  it("clearAckSent is idempotent (works when marker doesn't exist)", () => {
-    expect(existsSync(join(stateDir, ACK_SENT_MARKER))).toBe(false);
-    expect(() => clearAckSent()).not.toThrow();
-  });
-
-  it("round-trip: mark → clear → mark cycles work across turns", () => {
-    // turn 1
-    markAckSent();
-    expect(existsSync(join(stateDir, ACK_SENT_MARKER))).toBe(true);
-    // turn end / next turn start
-    clearAckSent();
-    expect(existsSync(join(stateDir, ACK_SENT_MARKER))).toBe(false);
-    // turn 2 first reply
-    markAckSent();
-    expect(existsSync(join(stateDir, ACK_SENT_MARKER))).toBe(true);
-  });
-
-  it("noop when TELEGRAM_STATE_DIR is unset (best-effort)", () => {
-    delete process.env.TELEGRAM_STATE_DIR;
-    expect(() => markAckSent()).not.toThrow();
-    expect(() => clearAckSent()).not.toThrow();
-  });
-});