@kybernesis/buzz 0.9.8 → 0.9.9

package/dist/turn.d.ts

@@ -101,5 +101,15 @@ export declare function answerTurn(client: Client, sessions: SessionStore, chann
  */
 export declare function isSessionGone(error: unknown): boolean;
 export declare function rejectedTurnReply(error: unknown): string | null;
-/** Give the originating channel one accurate recovery message for bridge-owned silence. */
+/**
+ * Give the originating channel one accurate recovery message for bridge-owned silence.
+ *
+ * Two different failures wear the same timeout. Before the send, a stalled
+ * unread drain means the message never reached the agent: "try again here" is
+ * actively wrong, because there is nothing to resume and the agent will answer
+ * whatever it last genuinely received — a confident reply to a question nobody
+ * asked. After the send, the message did reach the agent and the conversation
+ * is kept, so trying again is the right advice. The phase on the error tells
+ * the two apart.
+ */
 export declare function agentSilenceReply(error: unknown): string | null;

package/dist/turn.js

@@ -17,6 +17,16 @@ export const DEFAULT_AGENT_SILENCE_TIMEOUT_MS = 5 * 60_000;
  */
 export const DEFAULT_AGENT_WORK_TIMEOUT_MS = 60 * 60_000;
 const isWorkPhase = (phase) => phase.endsWith("response stream");
+/**
+ * A phase that runs BEFORE the message is sent to the agent.
+ *
+ * The unread drain runs before the send, so a timeout here means the message
+ * never reached the agent and no run was created. Every other phase — the
+ * send/create acknowledgement and the response stream — is after the POST that
+ * delivers it, so by then the agent has the message. This is the difference
+ * between a lost message and a lost turn, and the recovery text turns on it.
+ */
+const isPreSendPhase = (phase) => phase === "unread drain";
 /** A caller-owned inactivity timeout. Aborting the transport does not cancel the eve session. */
 export class AgentSilenceTimeoutError extends Error {
     phase;
@@ -405,9 +415,22 @@ export function rejectedTurnReply(error) {
         ? `I couldn't read that message (${detail}). Try sending it again, or as plain text.`
         : "I couldn't read that message. Try sending it again, or as plain text.";
 }
-/** Give the originating channel one accurate recovery message for bridge-owned silence. */
+/**
+ * Give the originating channel one accurate recovery message for bridge-owned silence.
+ *
+ * Two different failures wear the same timeout. Before the send, a stalled
+ * unread drain means the message never reached the agent: "try again here" is
+ * actively wrong, because there is nothing to resume and the agent will answer
+ * whatever it last genuinely received — a confident reply to a question nobody
+ * asked. After the send, the message did reach the agent and the conversation
+ * is kept, so trying again is the right advice. The phase on the error tells
+ * the two apart.
+ */
 export function agentSilenceReply(error) {
     if (!(error instanceof AgentSilenceTimeoutError))
         return null;
+    if (isPreSendPhase(error.phase)) {
+        return "I couldn't get your message to the agent before it went quiet, so it was not delivered — nothing was sent and no answer is coming. Please send it again.";
+    }
     return "The agent was silent for too long, so I stopped waiting. I kept this conversation, and you can try again here.";
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kybernesis/buzz",
-  "version": "0.9.8",
+  "version": "0.9.9",
   "description": "Put an eve agent in a Buzz workspace as a member: per-speaker verified identity resolved through the control plane, self-service identity linking, presence, typing and seen signals.",
   "license": "Apache-2.0",
   "type": "module",