@llblab/pi-actors 0.24.4 → 0.24.6

package/CHANGELOG.md

@@ -2,6 +2,15 @@
 
 ## 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.
+- `[Packaging]` Kept package skill metadata directory-based for both `dist/skills` and source `skills`, preserving bundled skill discovery through package installs while the extension also contributes co-located skills at runtime.
+
 ## 0.24.4: Music Player Message Control Hotfix
 
 - `[Music Player]` Preserve typed actor-message envelopes for run-mailbox delivery so `player.<action>` messages dispatch by message type instead of relying on body payload text.

package/README.md

@@ -43,7 +43,7 @@ Or from git:
 pi install git:github.com/llblab/pi-actors
 ```
 
-The npm package is dist-first for JavaScript-only runtimes: default Pi metadata points at compiled `dist/` entrypoints and mirrored runtime assets. Source TypeScript and source skills remain in the package for TypeScript-native runtimes through optional source metadata.
+The npm package is dist-first for JavaScript-only runtimes: default Pi metadata points at compiled `dist/` entrypoints and mirrored runtime assets. Source TypeScript and source skills remain in the package for TypeScript-native runtimes through optional source metadata. When the source checkout is auto-discovered as an extension, it also contributes its co-located `skills/` directory during Pi resource discovery so the actors and swarm skills travel with the extension.
 
 ## Address Surface
 

package/dist/index.js

@@ -5,6 +5,8 @@
  * Wraps command templates as callable pi tools, stores durable user tools as recipe files, and exposes actor orchestration across reloads and sessions.
  */
 import { existsSync, readdirSync, watch } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
 import * as ActorInspectorTui from "./lib/actor-inspector-tui.js";
 import * as AsyncRuns from "./lib/async-runs.js";
 import * as CommandTemplates from "./lib/command-templates.js";
@@ -14,6 +16,8 @@ import * as Prompts from "./lib/prompts.js";
 import * as Runtime from "./lib/runtime.js";
 import * as Temp from "./lib/temp.js";
 import * as Tools from "./lib/tools.js";
+const EXTENSION_DIR = dirname(fileURLToPath(import.meta.url));
+const EXTENSION_SKILLS_DIR = join(EXTENSION_DIR, "skills");
 const CONFIG_PATH = Paths.getConfigPath();
 const TEMP_DIR = Paths.getExtensionTmpDir();
 const RUN_STATE_ROOT = Paths.getRunStateRoot();
@@ -246,6 +250,11 @@ export default function toolRegistryExtension(pi) {
         reservedToolNames: RESERVED_TOOL_NAMES,
         setActiveTools: (toolNames) => pi.setActiveTools(toolNames),
     });
+    pi.on("resources_discover", async () => {
+        if (!existsSync(EXTENSION_SKILLS_DIR))
+            return;
+        return { skillPaths: [EXTENSION_SKILLS_DIR] };
+    });
     pi.on("session_start", async (_event, ctx) => {
         await Temp.prepareExtensionTempDir(TEMP_DIR);
         runtime.loadTools(ctx);

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

package/index.ts

@@ -6,6 +6,8 @@
  */
 
 import { existsSync, readdirSync, watch, type FSWatcher } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
 
 import type {
   ExtensionAPI,
@@ -22,6 +24,8 @@ import * as Runtime from "./lib/runtime.ts";
 import * as Temp from "./lib/temp.ts";
 import * as Tools from "./lib/tools.ts";
 
+const EXTENSION_DIR = dirname(fileURLToPath(import.meta.url));
+const EXTENSION_SKILLS_DIR = join(EXTENSION_DIR, "skills");
 const CONFIG_PATH = Paths.getConfigPath();
 const TEMP_DIR = Paths.getExtensionTmpDir();
 const RUN_STATE_ROOT = Paths.getRunStateRoot();
@@ -299,6 +303,10 @@ export default function toolRegistryExtension(pi: ExtensionAPI) {
     reservedToolNames: RESERVED_TOOL_NAMES,
     setActiveTools: (toolNames) => pi.setActiveTools(toolNames),
   });
+  pi.on("resources_discover", async () => {
+    if (!existsSync(EXTENSION_SKILLS_DIR)) return;
+    return { skillPaths: [EXTENSION_SKILLS_DIR] };
+  });
   pi.on("session_start", async (_event, ctx) => {
     await Temp.prepareExtensionTempDir(TEMP_DIR);
     runtime.loadTools(ctx);

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.4",
+  "version": "0.24.6",
   "private": false,
   "description": "Local Actor Kernel for Pi",
   "keywords": [
@@ -35,9 +35,9 @@
   },
   "files": [
     "index.ts",
+    "dist",
     "lib",
     "scripts",
-    "dist",
     "recipes",
     "skills",
     "README.md",
@@ -56,12 +56,10 @@
       "./index.ts"
     ],
     "skills": [
-      "./dist/skills/actors/SKILL.md",
-      "./dist/skills/swarm/SKILL.md"
+      "./dist/skills"
     ],
     "sourceSkills": [
-      "./skills/actors/SKILL.md",
-      "./skills/swarm/SKILL.md"
+      "./skills"
     ],
     "image": "https://github.com/llblab/pi-actors/raw/main/banner.jpg"
   },

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