@ouro.bot/cli 0.1.0-alpha.565 → 0.1.0-alpha.566

package/changelog.json

@@ -1,6 +1,13 @@
 {
   "_note": "This changelog is maintained as part of the PR/version-bump workflow. Agent-curated, not auto-generated. Agents read this file directly via read_file to understand what changed between versions.",
   "versions": [
+    {
+      "version": "0.1.0-alpha.566",
+      "changes": [
+        "Shared sense delivery recovery is now an exported contract so replaying transports such as Voice/Twilio recover tool-required `settle`/`speak` output only after outward delivery acknowledgements.",
+        "Sense development docs now spell out the sense/transport boundary and the tool-required delivery rules for future Voice, meeting, Twilio, and other adapter work."
+      ]
+    },
     {
       "version": "0.1.0-alpha.565",
       "changes": [

package/dist/senses/shared-turn.js

@@ -40,6 +40,7 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.stripThinkBlocks = stripThinkBlocks;
+exports.extractOutwardSenseDeliveryText = extractOutwardSenseDeliveryText;
 exports.runSenseTurn = runSenseTurn;
 const os = __importStar(require("os"));
 const path = __importStar(require("path"));
@@ -61,7 +62,7 @@ const pipeline_1 = require("./pipeline");
 const mcp_manager_1 = require("../repertoire/mcp-manager");
 const runtime_1 = require("../nerves/runtime");
 const RESPONSE_CAP = 50_000;
-const DELIVERY_TOOL_ACKS = new Map([
+const OUTWARD_DELIVERY_TOOL_ACKS = new Map([
     ["settle", "(delivered)"],
     ["speak", "(spoken)"],
 ]);
@@ -117,7 +118,7 @@ function parseToolStringArg(toolCall, toolName, argName) {
 function hasDeliveredToolResult(messages, assistantIndex, toolCallId, toolName) {
     if (typeof toolCallId !== "string" || !toolCallId.trim())
         return false;
-    const expectedAck = DELIVERY_TOOL_ACKS.get(toolName);
+    const expectedAck = OUTWARD_DELIVERY_TOOL_ACKS.get(toolName);
     for (let index = assistantIndex + 1; index < messages.length; index++) {
         const message = messages[index];
         if (message.role !== "tool")
@@ -130,7 +131,7 @@ function hasDeliveredToolResult(messages, assistantIndex, toolCallId, toolName)
     }
     return false;
 }
-function deliveredTextFromAssistantTools(messages, assistantIndex) {
+function outwardDeliveryTextFromAssistantTools(messages, assistantIndex) {
     const assistant = messages[assistantIndex];
     if (!Array.isArray(assistant.tool_calls))
         return null;
@@ -152,13 +153,29 @@ function deliveredTextFromAssistantTools(messages, assistantIndex) {
     }
     return delivered.length > 0 ? delivered.join("\n") : null;
 }
-function responseFromSessionMessages(messages) {
+/**
+ * Recover the text that actually reached a friend in an outward sense turn.
+ *
+ * Ouro runs outward channels in tool-required mode. That means the visible
+ * response may be a `settle({ answer })` or `speak({ message })` tool call
+ * whose assistant message has `content: null`. The authoritative delivery
+ * signal is the following tool ack:
+ *
+ * - `(delivered)` for `settle.answer`
+ * - `(spoken)` for `speak.message`
+ *
+ * Inner-dialog `(settled)`, malformed tool arguments, rejected tools, and
+ * interrupted tool-call sequences are not outward speech. Sense transports
+ * that need to replay the turn later (Voice/Twilio TTS, future meeting audio)
+ * should use this helper instead of reading `assistant.content` directly.
+ */
+function extractOutwardSenseDeliveryText(messages) {
     const assistantIndex = messages.findLastIndex((message) => message.role === "assistant");
     if (assistantIndex < 0)
         return null;
     const assistant = messages[assistantIndex];
     return assistantContentText(assistant.content)
-        ?? deliveredTextFromAssistantTools(messages, assistantIndex);
+        ?? outwardDeliveryTextFromAssistantTools(messages, assistantIndex);
 }
 /**
  * Run a single agent turn through the inbound pipeline.
@@ -279,7 +296,7 @@ async function runSenseTurn(options) {
             await persistPromise;
         const postTurnSession = (0, context_1.loadSession)(sessPath);
         if (postTurnSession?.messages) {
-            finalResponse = responseFromSessionMessages(postTurnSession.messages)
+            finalResponse = extractOutwardSenseDeliveryText(postTurnSession.messages)
                 ?? "(agent responded but response was empty)";
         }
         else {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ouro.bot/cli",
-  "version": "0.1.0-alpha.565",
+  "version": "0.1.0-alpha.566",
   "main": "dist/heart/daemon/ouro-entry.js",
   "bin": {
     "cli": "dist/heart/daemon/ouro-bot-entry.js",