@vibedeckx/linux-x64 0.3.24 → 0.3.25

package/dist/bin.js

@@ -205488,9 +205488,18 @@ var SESSION_TOOLS_MCP_SERVER_NAME = "vibedeckx";
 var PROPOSE_SCHEDULE_TOOL = "propose_schedule";
 var CANONICAL_PROPOSE_SCHEDULE_TOOL = `mcp__${SESSION_TOOLS_MCP_SERVER_NAME}__${PROPOSE_SCHEDULE_TOOL}`;
 var PROPOSE_SCHEDULE_DESCRIPTION = [
-  "Propose a recurring scheduled check to the user. Call this when you tell the user that",
-  "something needs periodic follow-up observation \u2014 e.g. after a fix whose effect can only be",
-  "confirmed over time, or a flaky failure worth watching.",
+  "Propose a recurring scheduled check to the user. This is the only way to schedule work in this",
+  "environment. Call it in either situation:",
+  '- The user asks for something recurring \u2014 "every morning", "nightly", "hourly", "on a cron",',
+  '  "keep an eye on". Such a request IS this tool; it is not a programming task.',
+  "- You are telling the user that something needs periodic follow-up observation \u2014 e.g. after a",
+  "  fix whose effect can only be confirmed over time, or a flaky failure worth watching.",
+  "",
+  "Never satisfy a scheduling request by writing a crontab entry, systemd timer, launchd plist, CI",
+  "cron trigger, setInterval, or sleep loop: the platform owns execution, and anything you wire up",
+  "by hand is invisible to the user and does not survive this session. (Adding scheduling to the",
+  "user's OWN product \u2014 a cron block in their deployment config, a timer in their app \u2014 is still",
+  "ordinary coding work. This tool is for scheduling YOUR follow-up runs, not their features.)",
   "",
   "The proposal is shown to the user as a confirmation card; it does NOT create anything by",
   "itself and this call does not wait for the user. Say you have SUGGESTED a scheduled check",
@@ -205510,6 +205519,18 @@ var PROPOSE_SCHEDULE_DESCRIPTION = [
   "",
   "Project, execution target and branch are taken from this session \u2014 do not describe them here."
 ].join("\n");
+var SESSION_TOOLS_MCP_INSTRUCTIONS = [
+  `\`${PROPOSE_SCHEDULE_TOOL}\` is the only way to schedule work in this environment.`,
+  'When the user asks for anything recurring \u2014 nightly, hourly, every morning, on a cron, "keep',
+  'watching" \u2014 call it instead of writing a crontab entry, systemd timer, or setInterval loop.',
+  "Scheduling inside the user's own product remains ordinary coding work."
+].join("\n");
+var SESSION_TOOLS_SYSTEM_PROMPT_HINT = [
+  "Scheduling: when the user asks you to run something on a schedule (nightly, hourly, every",
+  `morning, on a cron, "keep watching"), call the \`${CANONICAL_PROPOSE_SCHEDULE_TOOL}\` tool. That`,
+  "is the only way to schedule work here \u2014 do not hand-roll a crontab entry, systemd timer, or",
+  "setInterval loop for it. Writing scheduling into the user's own project is still normal coding."
+].join(" ");
 var PROPOSE_SCHEDULE_INPUT_SCHEMA = {
   type: "object",
   properties: {
@@ -205849,7 +205870,7 @@ function withNpxFallback(nativeBinary, args) {
   }
   return { command: "npx", args: ["-y", CLAUDE_NPM_PACKAGE, ...args] };
 }
-function buildClaudeSessionSpawnConfig(nativeBinary, permissionMode, mcpConfigArg, model, allowedTools) {
+function buildClaudeSessionSpawnConfig(nativeBinary, permissionMode, mcpConfigArg, model, allowedTools, appendSystemPrompt) {
   const permissionFlag = permissionMode === "plan" ? "--permission-mode=plan" : "--dangerously-skip-permissions";
   const args = [
     ...STREAM_JSON_ARGS,
@@ -205873,6 +205894,9 @@ function buildClaudeSessionSpawnConfig(nativeBinary, permissionMode, mcpConfigAr
   if (allowedTools?.length) {
     args.push("--allowedTools", allowedTools.join(","));
   }
+  if (appendSystemPrompt?.trim()) {
+    args.push("--append-system-prompt", appendSystemPrompt.trim());
+  }
   return withNpxFallback(nativeBinary, args);
 }
 function buildClaudeStreamExecutorSpawn(nativeBinary) {
@@ -207084,7 +207108,8 @@ var ClaudeCodeProvider = class {
       permissionMode,
       Object.keys(mcpServers).length > 0 ? buildClaudeMcpConfigArg(mcpServers) : void 0,
       model,
-      sessionToolsMcp ? [CANONICAL_PROPOSE_SCHEDULE_TOOL] : void 0
+      sessionToolsMcp ? [CANONICAL_PROPOSE_SCHEDULE_TOOL] : void 0,
+      sessionToolsMcp ? SESSION_TOOLS_SYSTEM_PROMPT_HINT : void 0
     );
   }
   parseStdoutLine(line, _sessionId) {
@@ -233300,12 +233325,15 @@ function connectPersistentRemoteWs(sessionId, remoteInfo, cache2, reverseConnect
   const upstreamEpoch = requestedHistory?.historyEpoch ?? cachedHead?.historyEpoch ?? void 0;
   const upstreamAfter = requestedHistory?.afterEntryIndex ?? (upstreamEpoch !== void 0 ? cachedHead?.lastTurnEndEntryIndex ?? void 0 : void 0);
   const upstreamParams = new URLSearchParams();
-  if (upstreamEpoch !== void 0 && upstreamAfter !== void 0) {
+  if (hasCachedData && upstreamEpoch !== void 0 && upstreamAfter !== void 0) {
     upstreamParams.set("after", String(upstreamAfter));
     upstreamParams.set("epoch", String(upstreamEpoch));
   }
   const usesBoundedReplay = upstreamParams.size > 0;
   const wsPath = `/api/agent-sessions/${encodeURIComponent(remoteInfo.remoteSessionId)}/stream${usesBoundedReplay ? `?${upstreamParams}` : ""}`;
+  if (!hasCachedData) {
+    cache2.declareCoverage(sessionId, { epoch: upstreamEpoch ?? null, start: 0 });
+  }
   const adapter = new VirtualWsAdapter(
     (data) => reverseConnectManager.sendChannelData(remoteInfo.remoteServerId, channelId, data),
     () => reverseConnectManager.closeChannel(remoteInfo.remoteServerId, channelId)
@@ -239861,6 +239889,11 @@ function percentile(sorted, fraction) {
   const rank = Math.ceil(fraction * sorted.length);
   return sorted[Math.min(sorted.length, Math.max(1, rank)) - 1];
 }
+function coverageAdmitsReplay(coverage, clientEpoch, afterEntryIndex) {
+  if (!coverage) return false;
+  if (clientEpoch !== void 0 && coverage.epoch !== null && clientEpoch !== coverage.epoch) return false;
+  return (afterEntryIndex ?? -1) + 1 >= coverage.start;
+}
 var RemotePatchCache = class {
   cache = /* @__PURE__ */ new Map();
   getOrCreate(sessionId) {
@@ -239879,6 +239912,7 @@ var RemotePatchCache = class {
         historyEpoch: null,
         latestEntryIndex: null,
         lastTurnEndEntryIndex: null,
+        coverage: null,
         sessionStatus: null
       };
       this.cache.set(sessionId, entry);
@@ -239927,6 +239961,7 @@ var RemotePatchCache = class {
       if (metadata.lastTurnEnd !== null) lastTurnEndEntryIndex = Math.max(lastTurnEndEntryIndex ?? -1, metadata.lastTurnEnd);
     }
     const sessionStatus = existing?.sessionStatus ?? null;
+    const coverage = existing?.coverage ?? null;
     this.cache.set(sessionId, {
       messages,
       approxBytes: messages.reduce((sum, raw) => sum + raw.length, 0),
@@ -239940,6 +239975,7 @@ var RemotePatchCache = class {
       historyEpoch,
       latestEntryIndex,
       lastTurnEndEntryIndex,
+      coverage,
       sessionStatus
     });
   }
@@ -239981,7 +240017,19 @@ var RemotePatchCache = class {
     }
   }
   setHistoryEpoch(sessionId, epoch) {
-    this.getOrCreate(sessionId).historyEpoch = epoch;
+    const entry = this.getOrCreate(sessionId);
+    entry.historyEpoch = epoch;
+    if (!entry.coverage) return;
+    if (entry.coverage.epoch === null) entry.coverage.epoch = epoch;
+    else if (entry.coverage.epoch !== epoch) entry.coverage = null;
+  }
+  /**
+   * Record the interval this cache was authorized to fetch. Callers pass the
+   * lower bound they REQUESTED upstream — 0 for an unbounded replay, N+1 for
+   * `after=N`, the window's first index for a REST seed — not what came back.
+   */
+  declareCoverage(sessionId, coverage) {
+    this.getOrCreate(sessionId).coverage = { ...coverage };
   }
   /** Start a fresh entry-index namespace without dropping live connections. */
   resetHistory(sessionId, epoch) {
@@ -239993,6 +240041,7 @@ var RemotePatchCache = class {
     entry.historyEpoch = epoch;
     entry.latestEntryIndex = null;
     entry.lastTurnEndEntryIndex = null;
+    entry.coverage = { epoch, start: 0 };
   }
   setLastTurnEndEntryIndex(sessionId, index) {
     this.getOrCreate(sessionId).lastTurnEndEntryIndex = index;
@@ -247674,6 +247723,10 @@ var routes11 = async (fastify2) => {
                 const patch = ConversationPatch.addEntry(entryIndex, message);
                 fastify2.remotePatchCache.appendMessage(localSessionId, JSON.stringify({ JsonPatch: patch }), true);
               }
+              fastify2.remotePatchCache.declareCoverage(localSessionId, {
+                epoch: remoteData.historyWindow?.historyEpoch ?? null,
+                start: seededEntries[0]?.entryIndex ?? 0
+              });
               if (remoteData.historyWindow) {
                 fastify2.remotePatchCache.setHistoryEpoch(localSessionId, remoteData.historyWindow.historyEpoch);
                 if (remoteData.historyWindow.lastTurnEndEntryIndex !== null) {
@@ -247942,6 +247995,9 @@ var routes11 = async (fastify2) => {
       );
       if (result.ok) {
         const data = result.data;
+        console.log(
+          `[API] history-window ${req.params.sessionId}: latest=${String(data.latestEntryIndex)}, lastTurnEnd=${String(data.lastTurnEndEntryIndex)}, hasMore=${String(data.hasMore)}, before=${before ?? "-"}, turns=${turns}`
+        );
         return reply.code(200).send({
           ...data,
           session: data.session ? {
@@ -247997,6 +248053,9 @@ var routes11 = async (fastify2) => {
         if (!remoteInfo) return reply.code(404).send({ error: "Remote session not found" });
         const cached2 = fastify2.remotePatchCache.get(req.params.sessionId);
         if (cached2?.historyEpoch !== null && cached2?.lastTurnEndEntryIndex !== null && cached2?.sessionStatus) {
+          console.log(
+            `[API] history-head ${req.params.sessionId} (from cache): latest=${cached2.latestEntryIndex}, lastTurnEnd=${cached2.lastTurnEndEntryIndex}, status=${cached2.sessionStatus}`
+          );
           return reply.code(200).send({
             historyEpoch: cached2.historyEpoch,
             latestEntryIndex: cached2.latestEntryIndex,
@@ -248009,7 +248068,13 @@ var routes11 = async (fastify2) => {
           "GET",
           `/api/agent-sessions/${encodeURIComponent(remoteInfo.remoteSessionId)}/history-head`
         );
-        if (result.ok) return reply.code(200).send(result.data);
+        if (result.ok) {
+          const head3 = result.data;
+          console.log(
+            `[API] history-head ${req.params.sessionId} (from worker): latest=${String(head3.latestEntryIndex)}, lastTurnEnd=${String(head3.lastTurnEndEntryIndex)}, status=${String(head3.status)}`
+          );
+          return reply.code(200).send(result.data);
+        }
         if (result.status !== 404) return reply.code(proxyStatus(result)).send(result.data);
         const legacy = await proxyAuto(
           remoteInfo.remoteServerId,
@@ -251582,6 +251647,11 @@ var routes23 = async (fastify2) => {
               afterEntryIndex
             );
             console.log(`[AgentWS] Replaying cached msgs for ${sessionId} after=${replayAfter}`);
+            if (!coverageAdmitsReplay(cacheEntry.coverage, historyEpoch, afterEntryIndex)) {
+              console.warn(
+                `[AgentWS] COVERAGE GAP ${sessionId}: client needs from ${(afterEntryIndex ?? -1) + 1} (epoch=${historyEpoch ?? "-"}), cache covers from ${cacheEntry.coverage?.start ?? "unknown"} (epoch=${cacheEntry.coverage?.epoch ?? "-"}), frames=${cacheEntry.messages.length}, entriesLatest=${cacheEntry.latestEntryIndex ?? "-"} \u2014 Ready will be sent anyway`
+              );
+            }
             try {
               socket.send(JSON.stringify({
                 HistorySync: {
@@ -253432,7 +253502,8 @@ var routes31 = async (fastify2) => {
         return respond({
           protocolVersion: PROTOCOL_VERSION2,
           capabilities: { tools: {} },
-          serverInfo: { name: "vibedeckx-session-tools", version: "1.0.0" }
+          serverInfo: { name: "vibedeckx-session-tools", version: "1.0.0" },
+          instructions: SESSION_TOOLS_MCP_INSTRUCTIONS
         });
       case "ping":
         return respond({});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibedeckx/linux-x64",
-  "version": "0.3.24",
+  "version": "0.3.25",
   "description": "Vibedeckx platform binaries for Linux x64",
   "os": [
     "linux"