@cabane/companion 0.6.48 → 0.6.49

package/dist/cli.js

@@ -3599,7 +3599,7 @@ var TurnPump = class {
     };
   }
   opts;
-  // `finalEmitted` gates the end-of-turn empty-final promotion;
+  // `finalEmitted` gates the end-of-turn progress promotion;
   // `lastProgressBody` is what we promote to `final` when a clean turn ended on
   // a tool call with no closing text.
   emittedFinal = false;
@@ -3614,28 +3614,28 @@ var TurnPump = class {
   // frozen committer test — drive. Each callback applies the choreography and
   // commits through the injected sink.
   sink;
-  // End-of-turn empty-final promotion. A clean turn that ended on a tool call
-  // with no closing text still needs exactly one `final` row (so the user gets
-  // one notification and the drawer closes the turn). Promote the last progress
-  // body when we have one (the drawer collapses the dup), else the host's
-  // minimal note. Skipped when cancelled or already final. The held-text flush
-  // that precedes it is a classification concern, driven by the caller before
-  // this runs.
+  // End-of-turn progress promotion. A clean turn that emitted interim text but
+  // no closing text promotes the agent's own last progress body (the drawer
+  // collapses the duplicate). If the agent emitted no words, emit no message:
+  // Cabane never attributes host-authored text to an agent, in any turn shape,
+  // for any reason. The host closes that wordless turn with a marker instead.
+  // Skipped when cancelled or already final. The held-text flush that precedes
+  // this is a classification concern, driven by the caller before this runs.
   async finalize(ok) {
-    if (!ok || this.opts.signal.aborted || this.emittedFinal) return;
-    const body = this.lastProgressBody ?? this.opts.emptyFinalBody;
+    if (!ok || this.opts.signal.aborted || this.emittedFinal || !this.lastProgressBody) return;
+    const body = this.lastProgressBody;
     const seq = this.opts.nextSeq();
     try {
       await this.opts.commit.commitMessage({ body, kind: "final", seq });
       this.emittedFinal = true;
       this.finalReplyBody = body;
-      this.emittedFinalSource = this.lastProgressBody ? "progress_promotion" : "host_fallback";
+      this.emittedFinalSource = "progress_promotion";
     } catch (err) {
-      this.opts.onError?.(err, "empty-final");
+      this.opts.onError?.(err, "progress-promotion");
     }
   }
   // Whether the turn has committed its `final` row — read by the host to decide
-  // whether the empty-final path or a marker is owed.
+  // whether a marker is owed.
   get finalEmitted() {
     return this.emittedFinal;
   }
@@ -7274,7 +7274,6 @@ function pruneOld(dir2, retain) {
 }
 
 // src/turn-committer.ts
-var EMPTY_FINAL_BODY = "Done \u2014 see the changes above.";
 var TurnCommitter = class {
   constructor(deps) {
     this.deps = deps;
@@ -7295,9 +7294,7 @@ var TurnCommitter = class {
             turnId: deps.turnId,
             seq,
             parentMessageId: deps.parentMessageId,
-            ...kind === "final" ? this.summonField() : {},
-            ...kind === "final" ? this.askField() : {},
-            ...kind === "final" ? this.wakeField() : {}
+            ...kind === "final" ? this.turnControlFields() : {}
           },
           deps.signal
         );
@@ -7344,11 +7341,10 @@ var TurnCommitter = class {
       commit,
       signal: deps.signal,
       nextSeq: deps.nextSeq,
-      emptyFinalBody: EMPTY_FINAL_BODY,
       onError: (err) => {
         deps.log.warn(
           { err: err instanceof Error ? err.message : String(err) },
-          "dispatcher: empty-final commit failed"
+          "dispatcher: progress-promotion commit failed"
         );
       }
     });
@@ -7374,11 +7370,11 @@ var TurnCommitter = class {
       this.onError(err, event.type);
     }
   }
-  // End-of-turn empty-final promotion. The held-text flush is now the adapter's
+  // End-of-turn progress promotion. The held-text flush is now the adapter's
   // job (it emits the closing reply as a `text` event before `result`), so this
-  // only runs the pump's empty-final: a clean turn that ended on a tool call with
-  // no closing text still gets exactly one `final`. Guards on the abort signal, so
-  // on cancel no `final` is forced.
+  // only asks the pump to promote agent-authored interim text. A wordless turn
+  // stays wordless and the dispatcher closes it with a marker. Guards on the
+  // abort signal, so on cancel no `final` is forced.
   async finalize(okResult) {
     await this.pump.finalize(okResult);
   }
@@ -7389,6 +7385,19 @@ var TurnCommitter = class {
   get finalSource() {
     return this.pump.finalSource;
   }
+  get finalEmitted() {
+    return this.pump.finalEmitted;
+  }
+  // A closing textual reply and a wordless terminal marker carry the same
+  // per-turn control state. Keep this one projection so ask/wake/summon cannot
+  // silently diverge when the agent ends without words.
+  turnControlFields() {
+    return {
+      ...this.summonField(),
+      ...this.askField(),
+      ...this.wakeField()
+    };
+  }
   // CT183: resolve the in-thread summon into the `dispatch` field for a `final`
   // commit. A self-target is stripped here (mirror of the in-app self-strip); the
   // server strips it again and resolves / ignores an unknown id.
@@ -7617,6 +7626,7 @@ var STOPPED_MARKER_BODY = "(stopped)";
 var RUNTIME_UNAVAILABLE_PREFIX = "**This agent's runtime isn't available on this companion.** The model this agent uses needs a runtime this device isn't running, so I can't run this turn here. Details:";
 var UNEXPECTED_ROLE_REASON = `refused the wake trigger (role "system" isn't dispatchable on this companion) \u2014 the companion is likely running outdated code; refresh it, then re-address the agent`;
 var SKIPPED_MARKER_BODY = "(skipped)";
+var SILENT_MARKER_BODY = "(no reply)";
 var DEFAULT_PREPARING_ROW_DELAY_MS = 1500;
 var DEFAULT_AGENT_IDLE_TIMEOUT_MS = 10 * 6e4;
 var DEFAULT_AGENT_TOTAL_TIMEOUT_MS = 6 * 60 * 6e4;
@@ -8274,6 +8284,7 @@ ${reason}`,
     let contentBearingEvents = 0;
     let latestSessionState = request.session;
     let settledDiagnostics = null;
+    let silentMarkerEmitted = false;
     const committer = new TurnCommitter({
       api: this.opts.api,
       workspaceId,
@@ -8465,6 +8476,27 @@ ${reason}`,
         }
       } else {
         await committer.finalize(okResult);
+        if (!abortController.signal.aborted && okResult && !committer.finalEmitted) {
+          try {
+            await this.opts.api.postTurnMessage(workspaceId, payload.conversationId, {
+              body: SILENT_MARKER_BODY,
+              kind: "silent",
+              turnId,
+              seq: nextSeq(),
+              parentMessageId: payload.messageId,
+              // ask, wake and summon must survive a wordless turn exactly as
+              // they survive a textual final; dropping one can strand a person
+              // or the next actor with no visible failure.
+              ...committer.turnControlFields()
+            });
+            silentMarkerEmitted = true;
+          } catch (err) {
+            turnLog.warn(
+              { err: err instanceof Error ? err.message : String(err) },
+              "dispatcher: silent-marker commit failed"
+            );
+          }
+        }
       }
     } catch (err) {
       okResult = false;
@@ -8555,7 +8587,7 @@ ${reason}`,
         sessionFingerprint: fingerprintSessionState(latestSessionState),
         eventCounts,
         runtimeResultKind,
-        finalSource: outcome === "skipped" || outcome === "cancelled" ? "marker" : committer.finalSource
+        finalSource: outcome === "skipped" || outcome === "cancelled" || silentMarkerEmitted ? "marker" : committer.finalSource
       };
       body.diagnostics = settledDiagnostics;
       if (diagnosticReason && !["usage_capped", "rate_limited", "auth_expired", "cancelled", "skipped"].includes(

package/dist/runtime.js

@@ -3107,7 +3107,7 @@ var TurnPump = class {
     };
   }
   opts;
-  // `finalEmitted` gates the end-of-turn empty-final promotion;
+  // `finalEmitted` gates the end-of-turn progress promotion;
   // `lastProgressBody` is what we promote to `final` when a clean turn ended on
   // a tool call with no closing text.
   emittedFinal = false;
@@ -3122,28 +3122,28 @@ var TurnPump = class {
   // frozen committer test — drive. Each callback applies the choreography and
   // commits through the injected sink.
   sink;
-  // End-of-turn empty-final promotion. A clean turn that ended on a tool call
-  // with no closing text still needs exactly one `final` row (so the user gets
-  // one notification and the drawer closes the turn). Promote the last progress
-  // body when we have one (the drawer collapses the dup), else the host's
-  // minimal note. Skipped when cancelled or already final. The held-text flush
-  // that precedes it is a classification concern, driven by the caller before
-  // this runs.
+  // End-of-turn progress promotion. A clean turn that emitted interim text but
+  // no closing text promotes the agent's own last progress body (the drawer
+  // collapses the duplicate). If the agent emitted no words, emit no message:
+  // Cabane never attributes host-authored text to an agent, in any turn shape,
+  // for any reason. The host closes that wordless turn with a marker instead.
+  // Skipped when cancelled or already final. The held-text flush that precedes
+  // this is a classification concern, driven by the caller before this runs.
   async finalize(ok) {
-    if (!ok || this.opts.signal.aborted || this.emittedFinal) return;
-    const body = this.lastProgressBody ?? this.opts.emptyFinalBody;
+    if (!ok || this.opts.signal.aborted || this.emittedFinal || !this.lastProgressBody) return;
+    const body = this.lastProgressBody;
     const seq = this.opts.nextSeq();
     try {
       await this.opts.commit.commitMessage({ body, kind: "final", seq });
       this.emittedFinal = true;
       this.finalReplyBody = body;
-      this.emittedFinalSource = this.lastProgressBody ? "progress_promotion" : "host_fallback";
+      this.emittedFinalSource = "progress_promotion";
     } catch (err) {
-      this.opts.onError?.(err, "empty-final");
+      this.opts.onError?.(err, "progress-promotion");
     }
   }
   // Whether the turn has committed its `final` row — read by the host to decide
-  // whether the empty-final path or a marker is owed.
+  // whether a marker is owed.
   get finalEmitted() {
     return this.emittedFinal;
   }
@@ -6782,7 +6782,6 @@ function pruneOld(dir2, retain) {
 }
 
 // src/turn-committer.ts
-var EMPTY_FINAL_BODY = "Done \u2014 see the changes above.";
 var TurnCommitter = class {
   constructor(deps) {
     this.deps = deps;
@@ -6803,9 +6802,7 @@ var TurnCommitter = class {
             turnId: deps.turnId,
             seq,
             parentMessageId: deps.parentMessageId,
-            ...kind === "final" ? this.summonField() : {},
-            ...kind === "final" ? this.askField() : {},
-            ...kind === "final" ? this.wakeField() : {}
+            ...kind === "final" ? this.turnControlFields() : {}
           },
           deps.signal
         );
@@ -6852,11 +6849,10 @@ var TurnCommitter = class {
       commit,
       signal: deps.signal,
       nextSeq: deps.nextSeq,
-      emptyFinalBody: EMPTY_FINAL_BODY,
       onError: (err) => {
         deps.log.warn(
           { err: err instanceof Error ? err.message : String(err) },
-          "dispatcher: empty-final commit failed"
+          "dispatcher: progress-promotion commit failed"
         );
       }
     });
@@ -6882,11 +6878,11 @@ var TurnCommitter = class {
       this.onError(err, event.type);
     }
   }
-  // End-of-turn empty-final promotion. The held-text flush is now the adapter's
+  // End-of-turn progress promotion. The held-text flush is now the adapter's
   // job (it emits the closing reply as a `text` event before `result`), so this
-  // only runs the pump's empty-final: a clean turn that ended on a tool call with
-  // no closing text still gets exactly one `final`. Guards on the abort signal, so
-  // on cancel no `final` is forced.
+  // only asks the pump to promote agent-authored interim text. A wordless turn
+  // stays wordless and the dispatcher closes it with a marker. Guards on the
+  // abort signal, so on cancel no `final` is forced.
   async finalize(okResult) {
     await this.pump.finalize(okResult);
   }
@@ -6897,6 +6893,19 @@ var TurnCommitter = class {
   get finalSource() {
     return this.pump.finalSource;
   }
+  get finalEmitted() {
+    return this.pump.finalEmitted;
+  }
+  // A closing textual reply and a wordless terminal marker carry the same
+  // per-turn control state. Keep this one projection so ask/wake/summon cannot
+  // silently diverge when the agent ends without words.
+  turnControlFields() {
+    return {
+      ...this.summonField(),
+      ...this.askField(),
+      ...this.wakeField()
+    };
+  }
   // CT183: resolve the in-thread summon into the `dispatch` field for a `final`
   // commit. A self-target is stripped here (mirror of the in-app self-strip); the
   // server strips it again and resolves / ignores an unknown id.
@@ -7125,6 +7134,7 @@ var STOPPED_MARKER_BODY = "(stopped)";
 var RUNTIME_UNAVAILABLE_PREFIX = "**This agent's runtime isn't available on this companion.** The model this agent uses needs a runtime this device isn't running, so I can't run this turn here. Details:";
 var UNEXPECTED_ROLE_REASON = `refused the wake trigger (role "system" isn't dispatchable on this companion) \u2014 the companion is likely running outdated code; refresh it, then re-address the agent`;
 var SKIPPED_MARKER_BODY = "(skipped)";
+var SILENT_MARKER_BODY = "(no reply)";
 var DEFAULT_PREPARING_ROW_DELAY_MS = 1500;
 var DEFAULT_AGENT_IDLE_TIMEOUT_MS = 10 * 6e4;
 var DEFAULT_AGENT_TOTAL_TIMEOUT_MS = 6 * 60 * 6e4;
@@ -7782,6 +7792,7 @@ ${reason}`,
     let contentBearingEvents = 0;
     let latestSessionState = request.session;
     let settledDiagnostics = null;
+    let silentMarkerEmitted = false;
     const committer = new TurnCommitter({
       api: this.opts.api,
       workspaceId,
@@ -7973,6 +7984,27 @@ ${reason}`,
         }
       } else {
         await committer.finalize(okResult);
+        if (!abortController.signal.aborted && okResult && !committer.finalEmitted) {
+          try {
+            await this.opts.api.postTurnMessage(workspaceId, payload.conversationId, {
+              body: SILENT_MARKER_BODY,
+              kind: "silent",
+              turnId,
+              seq: nextSeq(),
+              parentMessageId: payload.messageId,
+              // ask, wake and summon must survive a wordless turn exactly as
+              // they survive a textual final; dropping one can strand a person
+              // or the next actor with no visible failure.
+              ...committer.turnControlFields()
+            });
+            silentMarkerEmitted = true;
+          } catch (err) {
+            turnLog.warn(
+              { err: err instanceof Error ? err.message : String(err) },
+              "dispatcher: silent-marker commit failed"
+            );
+          }
+        }
       }
     } catch (err) {
       okResult = false;
@@ -8063,7 +8095,7 @@ ${reason}`,
         sessionFingerprint: fingerprintSessionState(latestSessionState),
         eventCounts,
         runtimeResultKind,
-        finalSource: outcome === "skipped" || outcome === "cancelled" ? "marker" : committer.finalSource
+        finalSource: outcome === "skipped" || outcome === "cancelled" || silentMarkerEmitted ? "marker" : committer.finalSource
       };
       body.diagnostics = settledDiagnostics;
       if (diagnosticReason && !["usage_capped", "rate_limited", "auth_expired", "cancelled", "skipped"].includes(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cabane/companion",
-  "version": "0.6.48",
+  "version": "0.6.49",
   "type": "module",
   "description": "The Cabane Companion (headless): connect a coding agent on your machine to your Cabane workspace as a responder — drive work against your own codebase, files, and MCP servers without putting any of it in Cabane.",
   "license": "UNLICENSED",