@llblab/pi-actors 0.26.2 → 0.26.3

package/CHANGELOG.md

@@ -2,6 +2,11 @@
 
 ## Unreleased
 
+## 0.26.3: Branch Message Delivery UX Hotfix
+
+- `[Actor Messages]` Treat branch mailbox persistence as a successful queued outcome even when the parent run control endpoint is unavailable, returning compact `queued=true` delivery diagnostics instead of throwing an unframed tool error.
+- `[UX]` Preserve the compact action-output contract for branch `message` calls by keeping delivery diagnostics in the normal result formatter, including the leading blank-line separation used by other tool actions.
+
 ## 0.26.2: Terminal Progress Hotfix
 
 - `[Async Runs]` Keep `progress.json` aligned with terminal kill/cancel handling by writing `phase=killed` or `phase=cancelled` and clearing active subagent counts when a run is stopped by runtime control.

package/dist/lib/tools.js

@@ -441,6 +441,8 @@ function compactActorMessageResult(message, result) {
     ];
     if (result.bytes !== undefined)
         tokens.push(`bytes=${String(result.bytes)}`);
+    if (result.queued === true)
+        tokens.push("queued=true");
     if (result.control)
         tokens.push(`control=${String(result.control)}`);
     if (result.outbox)
@@ -459,6 +461,9 @@ function compactActorMessageResult(message, result) {
         tokens.push(`signal=${String(result.signal)}`);
     if (result.invoked === true)
         tokens.push("invoked=true");
+    if (result.delivery_error) {
+        tokens.push(`delivery_error=${compactPreview(result.delivery_error, 96)}`);
+    }
     return `\n${tokens.join(" ")}`;
 }
 function maybeJsonText(value, verbose, compact) {
@@ -543,7 +548,25 @@ function assertMessageSenderBelongsToRun(message, run, routeLabel) {
 async function routeBranchEnvelope(stateDir, runId, recipient, message, _options) {
     const branchMessage = { ...message, to: recipient };
     ActorRooms.appendBranchInboxMessage(stateDir, runId, recipient, branchMessage);
-    return AsyncRuns.sendRunMessage(runId, JSON.stringify(branchMessage));
+    try {
+        return await AsyncRuns.sendRunMessage(runId, JSON.stringify(branchMessage));
+    }
+    catch (error) {
+        const record = error && typeof error === "object" ? error : {};
+        if (record.queued === true) {
+            return {
+                control_path: record.control_path,
+                control_type: record.control_type,
+                delivery_error: record.delivery_error ?? (error instanceof Error ? error.message : String(error)),
+                inbox_id: record.inbox_id,
+                queued: true,
+                run: runId,
+                sent: false,
+                state_dir: stateDir,
+            };
+        }
+        throw error;
+    }
 }
 function getRoomMulticastRecipients(message, run) {
     const raw = message.metadata?.recipients;

package/dist/skills/actors/SKILL.md

@@ -2,7 +2,7 @@
 name: actors
 description: Highest-density practical guide for pi-actors. Read this skill whenever prompt and tools are not enough for spawn, message, inspect, actor runs, tools, recipes, command templates, async lifecycle, mailboxes, artifacts, and local orchestration mechanics.
 metadata:
-  version: 0.26.2
+  version: 0.26.3
 ---
 
 # Actors (pi-actors)

package/dist/skills/swarm/SKILL.md

@@ -2,7 +2,7 @@
 name: swarm
 description: Subagent orchestration with scoped locks and quorum consensus. Use for multi-model review, parallel scoped work, delegated audit, and coordinated subagent execution.
 metadata:
-  version: 0.26.2
+  version: 0.26.3
 ---
 
 # Swarm

package/lib/tools.ts

@@ -535,6 +535,7 @@ function compactActorMessageResult(
     `message=${result.sent === true || result.stopped === true ? "sent" : "not_sent"}`,
   ];
   if (result.bytes !== undefined) tokens.push(`bytes=${String(result.bytes)}`);
+  if (result.queued === true) tokens.push("queued=true");
   if (result.control) tokens.push(`control=${String(result.control)}`);
   if (result.outbox) tokens.push(`messages=${String(result.outbox)}`);
   if (result.message_count !== undefined)
@@ -546,6 +547,9 @@ function compactActorMessageResult(
   if (result.stopped === true) tokens.push("stopped=true");
   if (result.signal) tokens.push(`signal=${String(result.signal)}`);
   if (result.invoked === true) tokens.push("invoked=true");
+  if (result.delivery_error) {
+    tokens.push(`delivery_error=${compactPreview(result.delivery_error, 96)}`);
+  }
   return `\n${tokens.join(" ")}`;
 }
 
@@ -695,7 +699,24 @@ async function routeBranchEnvelope(
     recipient,
     branchMessage,
   );
-  return AsyncRuns.sendRunMessage(runId, JSON.stringify(branchMessage));
+  try {
+    return await AsyncRuns.sendRunMessage(runId, JSON.stringify(branchMessage));
+  } catch (error) {
+    const record = error && typeof error === "object" ? (error as Record<string, unknown>) : {};
+    if (record.queued === true) {
+      return {
+        control_path: record.control_path,
+        control_type: record.control_type,
+        delivery_error: record.delivery_error ?? (error instanceof Error ? error.message : String(error)),
+        inbox_id: record.inbox_id,
+        queued: true,
+        run: runId,
+        sent: false,
+        state_dir: stateDir,
+      };
+    }
+    throw error;
+  }
 }
 
 function getRoomMulticastRecipients(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llblab/pi-actors",
-  "version": "0.26.2",
+  "version": "0.26.3",
   "private": false,
   "description": "Local Actor Kernel for Pi",
   "keywords": [

package/skills/actors/SKILL.md

@@ -2,7 +2,7 @@
 name: actors
 description: Highest-density practical guide for pi-actors. Read this skill whenever prompt and tools are not enough for spawn, message, inspect, actor runs, tools, recipes, command templates, async lifecycle, mailboxes, artifacts, and local orchestration mechanics.
 metadata:
-  version: 0.26.2
+  version: 0.26.3
 ---
 
 # Actors (pi-actors)

package/skills/swarm/SKILL.md

@@ -2,7 +2,7 @@
 name: swarm
 description: Subagent orchestration with scoped locks and quorum consensus. Use for multi-model review, parallel scoped work, delegated audit, and coordinated subagent execution.
 metadata:
-  version: 0.26.2
+  version: 0.26.3
 ---
 
 # Swarm