@llblab/pi-actors 0.24.5 → 0.24.6

package/CHANGELOG.md

@@ -2,6 +2,10 @@
 
 ## Unreleased
 
+## 0.24.6: Async Run Restart Status Hotfix
+
+- `[Async Runs]` Treat freshly spawned runner PIDs as running during a short Linux `/proc` identity grace window, preventing restart status checks and immediate run messages from misclassifying a new run as `exited` before its command line is observable.
+
 ## 0.24.5: Auto-Discovered Skills Hotfix
 
 - `[Skills]` Auto-discovered source checkouts now contribute their co-located `skills/` directory through Pi resource discovery, so extension-local actors/swarm skills load even when `pi-actors` is used directly from `~/.pi/agent/extensions` instead of installed as a package.

package/dist/lib/async-runs.js

@@ -19,6 +19,7 @@ import * as RecipeUsage from "./recipe-usage.js";
 import { notifyRuntimeWake } from "./runtime-notifier.js";
 const START_LOCK_MAX_AGE_MS = 5 * 60 * 1000;
 const RUN_INBOX_LOCK_TIMEOUT_MS = 5000;
+const RUNNER_IDENTITY_GRACE_MS = 5000;
 const DEFAULT_STATE_ROOT = Paths.getRunStateRoot();
 const DEFAULT_RECIPE_ROOT = Paths.getRecipeRoot();
 function packageRoot() {
@@ -215,6 +216,12 @@ function pidMatchesRun(pid, cwd, stateDir) {
         return false;
     }
 }
+function isWithinRunnerIdentityGrace(meta) {
+    const createdAt = typeof meta.createdAt === "string" ? Date.parse(meta.createdAt) : NaN;
+    return (Number.isFinite(createdAt) &&
+        Date.now() - createdAt >= 0 &&
+        Date.now() - createdAt <= RUNNER_IDENTITY_GRACE_MS);
+}
 function tailFile(path, lines) {
     if (!existsSync(path))
         return "";
@@ -446,7 +453,8 @@ export function getRunStatus(runOrDir) {
     const aliveOwnedRunner = Boolean(pid &&
         isAlive(pid) &&
         (!Array.isArray(meta.argv) ||
-            pidMatchesRun(pid, String(meta.cwd ?? ""), stateDir)));
+            pidMatchesRun(pid, String(meta.cwd ?? ""), stateDir) ||
+            isWithinRunnerIdentityGrace(meta)));
     const status = result
         ? Number(result.code ?? 0) === 0
             ? "done"
@@ -891,7 +899,8 @@ export async function sendRunMessage(runOrDir, message, options = {}) {
     const pid = Number(status.pid || 0);
     if (!pid || !isAlive(pid))
         throw new Error(`Run pid is not alive: ${run}`);
-    if (!pidMatchesRun(pid, String(status.cwd), stateDir))
+    if (!pidMatchesRun(pid, String(status.cwd), stateDir) &&
+        !isWithinRunnerIdentityGrace(status))
         throw new Error(`Run pid owner mismatch: ${run}`);
     const endpoint = getRunControlEndpoint(status, stateDir);
     const payload = message.endsWith("\n") ? message : `${message}\n`;

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.24.5
+  version: 0.24.6
 ---
 
 # 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.24.5
+  version: 0.24.6
 ---
 
 # Swarm

package/lib/async-runs.ts

@@ -41,6 +41,7 @@ import { notifyRuntimeWake } from "./runtime-notifier.ts";
 
 const START_LOCK_MAX_AGE_MS = 5 * 60 * 1000;
 const RUN_INBOX_LOCK_TIMEOUT_MS = 5000;
+const RUNNER_IDENTITY_GRACE_MS = 5000;
 
 export type AsyncRunLaunchSource = "spawn" | "tool";
 
@@ -377,6 +378,16 @@ function pidMatchesRun(pid: number, cwd: string, stateDir: string): boolean {
   }
 }
 
+function isWithinRunnerIdentityGrace(meta: Record<string, unknown>): boolean {
+  const createdAt =
+    typeof meta.createdAt === "string" ? Date.parse(meta.createdAt) : NaN;
+  return (
+    Number.isFinite(createdAt) &&
+    Date.now() - createdAt >= 0 &&
+    Date.now() - createdAt <= RUNNER_IDENTITY_GRACE_MS
+  );
+}
+
 function tailFile(path: string, lines: number): string {
   if (!existsSync(path)) return "";
   const content = readFileSync(path, "utf8").trimEnd();
@@ -658,7 +669,8 @@ export function getRunStatus(runOrDir: string): Record<string, unknown> {
     pid &&
     isAlive(pid) &&
     (!Array.isArray(meta.argv) ||
-      pidMatchesRun(pid, String(meta.cwd ?? ""), stateDir)),
+      pidMatchesRun(pid, String(meta.cwd ?? ""), stateDir) ||
+      isWithinRunnerIdentityGrace(meta)),
   );
   const status: AsyncRunStatus = result
     ? Number(result.code ?? 0) === 0
@@ -1240,7 +1252,10 @@ export async function sendRunMessage(
     throw new Error(`Run is not running: ${run}`);
   const pid = Number(status.pid || 0);
   if (!pid || !isAlive(pid)) throw new Error(`Run pid is not alive: ${run}`);
-  if (!pidMatchesRun(pid, String(status.cwd), stateDir))
+  if (
+    !pidMatchesRun(pid, String(status.cwd), stateDir) &&
+    !isWithinRunnerIdentityGrace(status)
+  )
     throw new Error(`Run pid owner mismatch: ${run}`);
   const endpoint = getRunControlEndpoint(status, stateDir);
   const payload = message.endsWith("\n") ? message : `${message}\n`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llblab/pi-actors",
-  "version": "0.24.5",
+  "version": "0.24.6",
   "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.24.5
+  version: 0.24.6
 ---
 
 # 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.24.5
+  version: 0.24.6
 ---
 
 # Swarm