pubblue 0.4.11 → 0.4.12

package/dist/{chunk-HAIOMGND.js → chunk-UW7JILRJ.js}

@@ -1,3 +1,6 @@
+import {
+  TunnelApiError
+} from "./chunk-7NFHPJ76.js";
 import {
   CHANNELS,
   CONTROL_CHANNEL,
@@ -55,8 +58,9 @@ function generateOffer(peer, timeoutMs) {
 
 // src/lib/tunnel-daemon-shared.ts
 var OFFER_TIMEOUT_MS = 1e4;
-var SIGNAL_POLL_WAITING_MS = 500;
-var SIGNAL_POLL_CONNECTED_MS = 2e3;
+var SIGNAL_POLL_WAITING_MS = 5e3;
+var SIGNAL_POLL_CONNECTED_MS = 15e3;
+var LOCAL_CANDIDATE_FLUSH_MS = 2e3;
 var RECOVERY_DELAY_MS = 1e3;
 var WRITE_ACK_TIMEOUT_MS = 5e3;
 var NOT_CONNECTED_WRITE_ERROR = "No browser connected. Ask the user to open the tunnel URL first, then retry.";
@@ -69,6 +73,14 @@ function shouldRecoverForBrowserAnswerChange(params) {
   if (!incomingBrowserAnswer) return false;
   return incomingBrowserAnswer !== lastAppliedBrowserAnswer;
 }
+function getSignalPollDelayMs(params) {
+  const baseDelay = params.remoteDescriptionApplied ? SIGNAL_POLL_CONNECTED_MS : SIGNAL_POLL_WAITING_MS;
+  if (params.retryAfterSeconds === void 0) return baseDelay;
+  if (!Number.isFinite(params.retryAfterSeconds) || params.retryAfterSeconds <= 0) {
+    return baseDelay;
+  }
+  return Math.max(baseDelay, Math.ceil(params.retryAfterSeconds * 1e3));
+}
 
 // src/lib/tunnel-daemon.ts
 async function startDaemon(config) {
@@ -321,7 +333,7 @@ async function startDaemon(config) {
       await apiClient.signal(tunnelId, { candidates: newOnes }).catch((error) => {
         debugLog("failed to publish local ICE candidates", error);
       });
-    }, 500);
+    }, LOCAL_CANDIDATE_FLUSH_MS);
     localCandidateStopTimer = setTimeout(() => {
       clearLocalCandidateTimers();
     }, 3e4);
@@ -441,12 +453,16 @@ async function startDaemon(config) {
   }
   async function runPollingLoop() {
     if (stopped) return;
+    let retryAfterSeconds;
     try {
       await pollSignalingOnce();
     } catch (error) {
+      if (error instanceof TunnelApiError && error.status === 429) {
+        retryAfterSeconds = error.retryAfterSeconds;
+      }
       markError("signaling poll failed", error);
     }
-    scheduleNextPoll(remoteDescriptionApplied ? SIGNAL_POLL_CONNECTED_MS : SIGNAL_POLL_WAITING_MS);
+    scheduleNextPoll(getSignalPollDelayMs({ remoteDescriptionApplied, retryAfterSeconds }));
   }
   async function runNegotiationCycle() {
     if (!peer) throw new Error("PeerConnection not initialized");
@@ -656,5 +672,6 @@ async function startDaemon(config) {
 export {
   getTunnelWriteReadinessError,
   shouldRecoverForBrowserAnswerChange,
+  getSignalPollDelayMs,
   startDaemon
 };

package/dist/index.js

@@ -111,6 +111,11 @@ function getConfig(homeDir) {
     bridge: saved.bridge
   };
 }
+function getTelegramMiniAppUrl(type, id) {
+  const saved = loadConfig();
+  if (!saved?.telegram?.botUsername) return null;
+  return `https://t.me/${saved.telegram.botUsername}?startapp=${type === "pub" ? "p" : "t"}_${id}`;
+}
 
 // src/commands/shared.ts
 import * as fs2 from "fs";
@@ -278,7 +283,21 @@ function parsePositiveInteger(raw, key) {
   }
   return parsed;
 }
-function applyBridgeSet(bridge, key, value) {
+var SUPPORTED_KEYS = [
+  "bridge.mode",
+  "openclaw.path",
+  "openclaw.sessionId",
+  "openclaw.threadId",
+  "openclaw.canvasReminderEvery",
+  "openclaw.deliver",
+  "openclaw.deliverChannel",
+  "openclaw.replyTo",
+  "openclaw.deliverTimeoutMs",
+  "openclaw.attachmentDir",
+  "openclaw.attachmentMaxBytes",
+  "telegram.botToken"
+];
+function applyConfigSet(bridge, telegram, key, value) {
   switch (key) {
     case "bridge.mode":
       bridge.mode = parseBridgeModeValue(value);
@@ -292,6 +311,9 @@ function applyBridgeSet(bridge, key, value) {
     case "openclaw.threadId":
       bridge.threadId = value;
       return;
+    case "openclaw.canvasReminderEvery":
+      bridge.canvasReminderEvery = parsePositiveInteger(value, key);
+      return;
     case "openclaw.deliver":
       bridge.deliver = parseBooleanValue(value, key);
       return;
@@ -310,26 +332,20 @@ function applyBridgeSet(bridge, key, value) {
     case "openclaw.attachmentMaxBytes":
       bridge.attachmentMaxBytes = parsePositiveInteger(value, key);
       return;
+    case "telegram.botToken":
+      telegram.botToken = value;
+      return;
     default:
       throw new Error(
         [
           `Unknown config key: ${key}`,
           "Supported keys:",
-          "  bridge.mode",
-          "  openclaw.path",
-          "  openclaw.sessionId",
-          "  openclaw.threadId",
-          "  openclaw.deliver",
-          "  openclaw.deliverChannel",
-          "  openclaw.replyTo",
-          "  openclaw.deliverTimeoutMs",
-          "  openclaw.attachmentDir",
-          "  openclaw.attachmentMaxBytes"
+          ...SUPPORTED_KEYS.map((k) => `  ${k}`)
         ].join("\n")
       );
   }
 }
-function applyBridgeUnset(bridge, key) {
+function applyConfigUnset(bridge, telegram, key) {
   switch (key) {
     case "bridge.mode":
       delete bridge.mode;
@@ -343,6 +359,9 @@ function applyBridgeUnset(bridge, key) {
     case "openclaw.threadId":
       delete bridge.threadId;
       return;
+    case "openclaw.canvasReminderEvery":
+      delete bridge.canvasReminderEvery;
+      return;
     case "openclaw.deliver":
       delete bridge.deliver;
       return;
@@ -361,16 +380,45 @@ function applyBridgeUnset(bridge, key) {
     case "openclaw.attachmentMaxBytes":
       delete bridge.attachmentMaxBytes;
       return;
+    case "telegram.botToken":
+      delete telegram.botToken;
+      delete telegram.botUsername;
+      delete telegram.hasMainWebApp;
+      return;
     default:
       throw new Error(`Unknown config key for --unset: ${key}`);
   }
 }
-function hasBridgeValues(bridge) {
-  return Object.values(bridge).some((value) => value !== void 0);
+function hasValues(obj) {
+  return Object.values(obj).some((value) => value !== void 0);
+}
+function maskSecret(value) {
+  if (value.length <= 8) return "********";
+  return `${value.slice(0, 4)}...${value.slice(-4)}`;
+}
+async function telegramGetMe(token) {
+  const resp = await fetch(`https://api.telegram.org/bot${token}/getMe`);
+  const data = await resp.json();
+  if (!data.ok || !data.result?.username) {
+    throw new Error(data.description ?? "Invalid bot token");
+  }
+  return {
+    username: data.result.username,
+    hasMainWebApp: data.result.has_main_web_app === true
+  };
 }
-function maskApiKey(apiKey) {
-  if (apiKey.length <= 8) return "********";
-  return `${apiKey.slice(0, 4)}...${apiKey.slice(-4)}`;
+async function telegramSetMenuButton(token, url) {
+  const resp = await fetch(`https://api.telegram.org/bot${token}/setChatMenuButton`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({
+      menu_button: { type: "web_app", text: "Open", web_app: { url } }
+    })
+  });
+  const data = await resp.json();
+  if (!data.ok) {
+    throw new Error(data.description ?? "setChatMenuButton failed");
+  }
 }
 function printConfigSummary(saved) {
   if (!saved) {
@@ -378,34 +426,50 @@ function printConfigSummary(saved) {
     return;
   }
   console.log("Saved config:");
-  console.log(`  apiKey: ${maskApiKey(saved.apiKey)}`);
-  if (!saved.bridge || !hasBridgeValues(saved.bridge)) {
+  console.log(`  apiKey: ${maskSecret(saved.apiKey)}`);
+  if (saved.bridge && hasValues(saved.bridge)) {
+    console.log(`  bridge.mode: ${saved.bridge.mode ?? "(unset)"}`);
+    if (saved.bridge.openclawPath) console.log(`  openclaw.path: ${saved.bridge.openclawPath}`);
+    if (saved.bridge.sessionId) console.log(`  openclaw.sessionId: ${saved.bridge.sessionId}`);
+    if (saved.bridge.threadId) console.log(`  openclaw.threadId: ${saved.bridge.threadId}`);
+    if (saved.bridge.canvasReminderEvery !== void 0)
+      console.log(`  openclaw.canvasReminderEvery: ${saved.bridge.canvasReminderEvery}`);
+    if (saved.bridge.deliver !== void 0)
+      console.log(`  openclaw.deliver: ${saved.bridge.deliver ? "true" : "false"}`);
+    if (saved.bridge.deliverChannel)
+      console.log(`  openclaw.deliverChannel: ${saved.bridge.deliverChannel}`);
+    if (saved.bridge.replyTo) console.log(`  openclaw.replyTo: ${saved.bridge.replyTo}`);
+    if (saved.bridge.deliverTimeoutMs !== void 0)
+      console.log(`  openclaw.deliverTimeoutMs: ${saved.bridge.deliverTimeoutMs}`);
+    if (saved.bridge.attachmentDir)
+      console.log(`  openclaw.attachmentDir: ${saved.bridge.attachmentDir}`);
+    if (saved.bridge.attachmentMaxBytes !== void 0)
+      console.log(`  openclaw.attachmentMaxBytes: ${saved.bridge.attachmentMaxBytes}`);
+  } else {
     console.log("  bridge: none");
-    return;
   }
-  console.log(`  bridge.mode: ${saved.bridge.mode ?? "(unset)"}`);
-  if (saved.bridge.openclawPath) console.log(`  openclaw.path: ${saved.bridge.openclawPath}`);
-  if (saved.bridge.sessionId) console.log(`  openclaw.sessionId: ${saved.bridge.sessionId}`);
-  if (saved.bridge.threadId) console.log(`  openclaw.threadId: ${saved.bridge.threadId}`);
-  if (saved.bridge.deliver !== void 0)
-    console.log(`  openclaw.deliver: ${saved.bridge.deliver ? "true" : "false"}`);
-  if (saved.bridge.deliverChannel)
-    console.log(`  openclaw.deliverChannel: ${saved.bridge.deliverChannel}`);
-  if (saved.bridge.replyTo) console.log(`  openclaw.replyTo: ${saved.bridge.replyTo}`);
-  if (saved.bridge.deliverTimeoutMs !== void 0)
-    console.log(`  openclaw.deliverTimeoutMs: ${saved.bridge.deliverTimeoutMs}`);
-  if (saved.bridge.attachmentDir)
-    console.log(`  openclaw.attachmentDir: ${saved.bridge.attachmentDir}`);
-  if (saved.bridge.attachmentMaxBytes !== void 0)
-    console.log(`  openclaw.attachmentMaxBytes: ${saved.bridge.attachmentMaxBytes}`);
+  if (saved.telegram?.botToken && saved.telegram.botUsername) {
+    console.log(`  telegram.botToken: ${maskSecret(saved.telegram.botToken)}`);
+    console.log(`  telegram.botUsername: @${saved.telegram.botUsername}`);
+    if (!saved.telegram.hasMainWebApp) {
+      console.log("    INFO: Register Mini App in @BotFather for deep links to open in Telegram");
+    }
+  } else if (saved.telegram?.botToken) {
+    console.log(`  telegram.botToken: ${maskSecret(saved.telegram.botToken)}`);
+    console.log("  telegram.botUsername: (not resolved)");
+  } else {
+    console.log("  telegram: not configured");
+    console.log("    INFO: Set telegram.botToken to enable Telegram Mini App links");
+    console.log("    Example: pubblue configure --set telegram.botToken=<BOT_TOKEN>");
+  }
 }
 function registerConfigureCommand(program2) {
   program2.command("configure").description("Configure the CLI with your API key").option("--api-key <key>", "Your API key (less secure: appears in shell history)").option("--api-key-stdin", "Read API key from stdin").option(
     "--set <key=value>",
-    "Set advanced config (repeatable). Example: --set openclaw.sessionId=<id>",
+    "Set config key (repeatable). Example: --set telegram.botToken=<token>",
     collectValues,
     []
-  ).option("--unset <key>", "Unset advanced config key (repeatable)", collectValues, []).option("--show", "Show saved configuration").action(
+  ).option("--unset <key>", "Unset config key (repeatable)", collectValues, []).option("--show", "Show saved configuration").action(
     async (opts) => {
       const saved = loadConfig();
       const hasApiUpdate = Boolean(opts.apiKey || opts.apiKeyStdin);
@@ -431,16 +495,35 @@ function registerConfigureCommand(program2) {
         }
       }
       const nextBridge = { ...saved?.bridge ?? {} };
+      const nextTelegram = { ...saved?.telegram ?? {} };
+      let telegramTokenChanged = false;
       for (const entry of opts.set) {
         const { key, value } = parseSetInput(entry);
-        applyBridgeSet(nextBridge, key, value);
+        applyConfigSet(nextBridge, nextTelegram, key, value);
+        if (key === "telegram.botToken") telegramTokenChanged = true;
       }
       for (const key of opts.unset) {
-        applyBridgeUnset(nextBridge, key.trim());
+        applyConfigUnset(nextBridge, nextTelegram, key.trim());
+      }
+      if (telegramTokenChanged && nextTelegram.botToken) {
+        console.log("Verifying Telegram bot token...");
+        const bot = await telegramGetMe(nextTelegram.botToken);
+        nextTelegram.botUsername = bot.username;
+        nextTelegram.hasMainWebApp = bot.hasMainWebApp;
+        console.log(`  Bot: @${bot.username}`);
+        await telegramSetMenuButton(nextTelegram.botToken, "https://pub.blue");
+        console.log("  Menu button set to https://pub.blue");
+        if (!bot.hasMainWebApp) {
+          console.log("");
+          console.log("  INFO: For deep links to open inside Telegram, register the Mini App:");
+          console.log("    @BotFather \u2192 /mybots \u2192 your bot \u2192 Bot Settings \u2192 Configure Mini App");
+          console.log("    Set Web App URL to: https://pub.blue");
+        }
       }
       const nextConfig = {
         apiKey,
-        bridge: hasBridgeValues(nextBridge) ? nextBridge : void 0
+        bridge: hasValues(nextBridge) ? nextBridge : void 0,
+        telegram: hasValues(nextTelegram) ? nextTelegram : void 0
       };
       saveConfig(nextConfig);
       console.log("Configuration saved.");
@@ -479,6 +562,8 @@ function registerPublicationCommands(program2) {
         expiresIn: opts.expires
       });
       console.log(`Created: ${result.url}`);
+      const tmaUrl = getTelegramMiniAppUrl("pub", result.slug);
+      if (tmaUrl) console.log(`Telegram: ${tmaUrl}`);
       if (result.expiresAt) {
         console.log(`  Expires: ${new Date(result.expiresAt).toISOString()}`);
       }
@@ -643,6 +728,9 @@ function buildBridgeProcessEnv(bridgeConfig) {
   setIfMissing("OPENCLAW_PATH", bridgeConfig.openclawPath);
   setIfMissing("OPENCLAW_SESSION_ID", bridgeConfig.sessionId);
   setIfMissing("OPENCLAW_THREAD_ID", bridgeConfig.threadId);
+  if (bridgeConfig.canvasReminderEvery !== void 0) {
+    setIfMissing("OPENCLAW_CANVAS_REMINDER_EVERY", bridgeConfig.canvasReminderEvery);
+  }
   if (bridgeConfig.deliver !== void 0) {
     setIfMissing("OPENCLAW_DELIVER", bridgeConfig.deliver ? "1" : "0");
   }
@@ -1292,7 +1380,7 @@ import * as path5 from "path";
 // package.json
 var package_default = {
   name: "pubblue",
-  version: "0.4.11",
+  version: "0.4.12",
   description: "CLI tool for publishing static content via pub.blue",
   type: "module",
   bin: {
@@ -1434,8 +1522,10 @@ function registerTunnelStartCommand(tunnel) {
             "Foreground mode disables managed bridge process. Use background mode for --bridge openclaw."
           );
         }
-        const { startDaemon } = await import("./tunnel-daemon-7B2QUHK5.js");
+        const { startDaemon } = await import("./tunnel-daemon-RKWEA5BV.js");
         console.log(`Tunnel started: ${target.url}`);
+        const fgTma = getTelegramMiniAppUrl("tunnel", target.tunnelId);
+        if (fgTma) console.log(`Telegram: ${fgTma}`);
         console.log(`Tunnel ID: ${target.tunnelId}`);
         console.log(`Expires: ${new Date(target.expiresAt).toISOString()}`);
         if (target.mode === "existing") console.log("Mode: attached existing tunnel");
@@ -1530,6 +1620,8 @@ function registerTunnelStartCommand(tunnel) {
             }
           }
           console.log(`Tunnel started: ${target.url}`);
+          const runTma = getTelegramMiniAppUrl("tunnel", target.tunnelId);
+          if (runTma) console.log(`Telegram: ${runTma}`);
           console.log(`Tunnel ID: ${target.tunnelId}`);
           console.log(`Expires: ${new Date(target.expiresAt).toISOString()}`);
           console.log("Daemon already running for this tunnel.");
@@ -1630,6 +1722,8 @@ function registerTunnelStartCommand(tunnel) {
         }
       }
       console.log(`Tunnel started: ${target.url}`);
+      const tma = getTelegramMiniAppUrl("tunnel", target.tunnelId);
+      if (tma) console.log(`Telegram: ${tma}`);
       console.log(`Tunnel ID: ${target.tunnelId}`);
       console.log(`Expires: ${new Date(target.expiresAt).toISOString()}`);
       if (target.mode === "existing") console.log("Mode: attached existing tunnel");

package/dist/tunnel-bridge-entry.js

@@ -34,6 +34,7 @@ var MONITORED_ATTACHMENT_CHANNELS = /* @__PURE__ */ new Set([
   CHANNELS.MEDIA
 ]);
 var DEFAULT_ATTACHMENT_MAX_BYTES = 25 * 1024 * 1024;
+var DEFAULT_CANVAS_REMINDER_EVERY = 10;
 var MAX_SEEN_IDS = 1e4;
 function sleep(ms) {
   return new Promise((resolve) => {
@@ -58,6 +59,11 @@ function resolveAttachmentMaxBytes() {
   if (!Number.isFinite(raw) || raw <= 0) return DEFAULT_ATTACHMENT_MAX_BYTES;
   return raw;
 }
+function resolveCanvasReminderEvery() {
+  const raw = Number.parseInt(process.env.OPENCLAW_CANVAS_REMINDER_EVERY || "", 10);
+  if (!Number.isFinite(raw) || raw <= 0) return DEFAULT_CANVAS_REMINDER_EVERY;
+  return raw;
+}
 function inferExtensionFromMime(mime) {
   const normalized = mime.split(";")[0]?.trim().toLowerCase();
   if (!normalized) return ".bin";
@@ -123,8 +129,24 @@ function stageAttachment(params) {
     streamStatus: params.streamStatus
   };
 }
-function buildInboundPrompt(tunnelId2, userText) {
+function buildCanvasPolicyReminderBlock() {
+  return [
+    "[Canvas policy reminder: do not reply to this reminder block]",
+    "- Prefer canvas-first responses for substantive output.",
+    "- Use chat only for short clarifications, confirmations, or blockers.",
+    "- Keep chat replies concise.",
+    ""
+  ].join("\n");
+}
+function shouldIncludeCanvasPolicyReminder(forwardedMessageCount, reminderEvery) {
+  if (!Number.isFinite(reminderEvery) || reminderEvery <= 0) return false;
+  if (forwardedMessageCount <= 0) return false;
+  return forwardedMessageCount % reminderEvery === 0;
+}
+function buildInboundPrompt(tunnelId2, userText, includeCanvasReminder) {
+  const policyReminder = includeCanvasReminder ? buildCanvasPolicyReminderBlock() : "";
   return [
+    policyReminder,
     `[Pubblue Tunnel ${tunnelId2}] Incoming user message:`,
     "",
     userText,
@@ -132,10 +154,12 @@ function buildInboundPrompt(tunnelId2, userText) {
     "---",
     `Reply with: pubblue tunnel write --tunnel ${tunnelId2} "<your reply>"`,
     `Canvas update: pubblue tunnel write --tunnel ${tunnelId2} -c canvas -f /path/to/file.html`
-  ].join("\n");
+  ].filter(Boolean).join("\n");
 }
-function buildAttachmentPrompt(tunnelId2, staged) {
+function buildAttachmentPrompt(tunnelId2, staged, includeCanvasReminder) {
+  const policyReminder = includeCanvasReminder ? buildCanvasPolicyReminderBlock() : "";
   return [
+    policyReminder,
     `[Pubblue Tunnel ${tunnelId2}] Incoming user attachment:`,
     `- channel: ${staged.channel}`,
     `- type: attachment`,
@@ -336,7 +360,11 @@ async function handleAttachmentEntry(params) {
   const { entry, activeStreams } = params;
   const { channel, msg } = entry;
   const stageAndDeliver = async (staged2) => {
-    const attachmentPrompt = buildAttachmentPrompt(params.tunnelId, staged2);
+    const attachmentPrompt = buildAttachmentPrompt(
+      params.tunnelId,
+      staged2,
+      params.includeCanvasReminder
+    );
     await deliverMessageToOpenClaw({
       openclawPath: params.openclawPath,
       sessionId: params.sessionId,
@@ -345,6 +373,7 @@ async function handleAttachmentEntry(params) {
   };
   if (msg.type === "stream-start") {
     const existing = activeStreams.get(channel);
+    let deliveredInterrupted = false;
     if (existing && existing.bytes > 0) {
       const interruptedBytes = Buffer.concat(existing.chunks);
       const stagedInterrupted = stageAttachment({
@@ -359,6 +388,7 @@ async function handleAttachmentEntry(params) {
         bytes: interruptedBytes
       });
       await stageAndDeliver(stagedInterrupted);
+      deliveredInterrupted = true;
     }
     activeStreams.set(channel, {
       bytes: 0,
@@ -367,15 +397,15 @@ async function handleAttachmentEntry(params) {
       mime: typeof msg.meta?.mime === "string" ? msg.meta.mime : void 0,
       streamId: msg.id
     });
-    return;
+    return deliveredInterrupted;
   }
   if (msg.type === "stream-end") {
     const stream2 = activeStreams.get(channel);
-    if (!stream2) return;
+    if (!stream2) return false;
     const requestedStreamId = typeof msg.meta?.streamId === "string" ? msg.meta.streamId : void 0;
-    if (requestedStreamId && requestedStreamId !== stream2.streamId) return;
+    if (requestedStreamId && requestedStreamId !== stream2.streamId) return false;
     activeStreams.delete(channel);
-    if (stream2.bytes === 0) return;
+    if (stream2.bytes === 0) return false;
     const bytes = Buffer.concat(stream2.chunks);
     const staged2 = stageAttachment({
       attachmentRoot: params.attachmentRoot,
@@ -389,14 +419,14 @@ async function handleAttachmentEntry(params) {
       bytes
     });
     await stageAndDeliver(staged2);
-    return;
+    return true;
   }
   if (msg.type === "stream-data") {
-    if (typeof msg.data !== "string" || msg.data.length === 0) return;
+    if (typeof msg.data !== "string" || msg.data.length === 0) return false;
     const stream2 = activeStreams.get(channel);
-    if (!stream2) return;
+    if (!stream2) return false;
     const requestedStreamId = readStreamIdFromMeta(msg.meta);
-    if (requestedStreamId && requestedStreamId !== stream2.streamId) return;
+    if (requestedStreamId && requestedStreamId !== stream2.streamId) return false;
     const chunk = decodeBinaryPayload(msg.data, `${channel}/${msg.id}`);
     const nextBytes = stream2.bytes + chunk.length;
     if (nextBytes > params.attachmentMaxBytes) {
@@ -407,16 +437,16 @@ async function handleAttachmentEntry(params) {
     }
     stream2.bytes = nextBytes;
     stream2.chunks.push(chunk);
-    return;
+    return false;
   }
   if (msg.type !== "binary" || typeof msg.data !== "string") {
-    return;
+    return false;
   }
   const payload = decodeBinaryPayload(msg.data, `${channel}/${msg.id}`);
   const stream = activeStreams.get(channel);
   if (stream) {
     const requestedStreamId = readStreamIdFromMeta(msg.meta);
-    if (requestedStreamId && requestedStreamId !== stream.streamId) return;
+    if (requestedStreamId && requestedStreamId !== stream.streamId) return false;
     const nextBytes = stream.bytes + payload.length;
     if (nextBytes > params.attachmentMaxBytes) {
       activeStreams.delete(channel);
@@ -426,7 +456,7 @@ async function handleAttachmentEntry(params) {
     }
     stream.bytes = nextBytes;
     stream.chunks.push(payload);
-    return;
+    return false;
   }
   if (payload.length > params.attachmentMaxBytes) {
     throw new Error(
@@ -444,6 +474,7 @@ async function handleAttachmentEntry(params) {
     bytes: payload
   });
   await stageAndDeliver(staged);
+  return true;
 }
 async function startOpenClawBridge(params) {
   const startedAt = Date.now();
@@ -514,6 +545,8 @@ async function startOpenClawBridge(params) {
     });
     const seenIds = /* @__PURE__ */ new Set();
     const activeStreams = /* @__PURE__ */ new Map();
+    const canvasReminderEvery = resolveCanvasReminderEvery();
+    let forwardedMessageCount = 0;
     let consecutiveReadFailures = 0;
     while (!shuttingDown) {
       let messages = [];
@@ -542,7 +575,7 @@ async function startOpenClawBridge(params) {
         continue;
       }
       if (messages.length === 0) {
-        await sleep(400);
+        await sleep(500);
         continue;
       }
       for (const rawEntry of messages) {
@@ -555,25 +588,34 @@ async function startOpenClawBridge(params) {
           seenIds.clear();
         }
         try {
+          const includeCanvasReminder = shouldIncludeCanvasPolicyReminder(
+            forwardedMessageCount + 1,
+            canvasReminderEvery
+          );
           const chat = readTextChatMessage(entry);
           if (chat) {
             await deliverMessageToOpenClaw({
               openclawPath,
               sessionId,
-              text: buildInboundPrompt(params.tunnelId, chat)
+              text: buildInboundPrompt(params.tunnelId, chat, includeCanvasReminder)
             });
+            forwardedMessageCount += 1;
             continue;
           }
           if (!MONITORED_ATTACHMENT_CHANNELS.has(entry.channel)) continue;
-          await handleAttachmentEntry({
+          const deliveredAttachment = await handleAttachmentEntry({
             activeStreams,
             attachmentMaxBytes,
             attachmentRoot,
             entry,
+            includeCanvasReminder,
             openclawPath,
             sessionId,
             tunnelId: params.tunnelId
           });
+          if (deliveredAttachment) {
+            forwardedMessageCount += 1;
+          }
         } catch (error) {
           const message = error instanceof Error ? error.message : String(error);
           console.error(`[pubblue bridge ${params.tunnelId}] ${message}`);

package/dist/{tunnel-daemon-7B2QUHK5.js → tunnel-daemon-RKWEA5BV.js}

@@ -1,10 +1,13 @@
 import {
+  getSignalPollDelayMs,
   getTunnelWriteReadinessError,
   shouldRecoverForBrowserAnswerChange,
   startDaemon
-} from "./chunk-HAIOMGND.js";
+} from "./chunk-UW7JILRJ.js";
+import "./chunk-7NFHPJ76.js";
 import "./chunk-4YTJ2WKF.js";
 export {
+  getSignalPollDelayMs,
   getTunnelWriteReadinessError,
   shouldRecoverForBrowserAnswerChange,
   startDaemon

package/dist/tunnel-daemon-entry.js

@@ -1,9 +1,9 @@
+import {
+  startDaemon
+} from "./chunk-UW7JILRJ.js";
 import {
   TunnelApiClient
 } from "./chunk-7NFHPJ76.js";
-import {
-  startDaemon
-} from "./chunk-HAIOMGND.js";
 import "./chunk-4YTJ2WKF.js";
 
 // src/tunnel-daemon-entry.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pubblue",
-  "version": "0.4.11",
+  "version": "0.4.12",
   "description": "CLI tool for publishing static content via pub.blue",
   "type": "module",
   "bin": {