@llblab/pi-actors 0.19.10 → 0.20.0

package/lib/async-runs.ts

@@ -20,7 +20,8 @@ import {
   writeSync,
 } from "node:fs";
 import { platform } from "node:os";
-import { basename, extname, join, resolve } from "node:path";
+import { basename, dirname, extname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
 
 import type {
   CommandTemplateFailureScope,
@@ -118,8 +119,23 @@ export interface AsyncRunMeta {
 
 const DEFAULT_STATE_ROOT = Paths.getRunStateRoot();
 const DEFAULT_RECIPE_ROOT = Paths.getRecipeRoot();
-const RUNNER_PATH = new URL("../scripts/async-runner.mjs", import.meta.url)
-  .pathname;
+
+function packageRoot(): string {
+  const moduleDir = dirname(fileURLToPath(import.meta.url));
+  if (basename(moduleDir) === "lib" && basename(dirname(moduleDir)) === "dist") {
+    return dirname(dirname(moduleDir));
+  }
+  return dirname(moduleDir);
+}
+
+const PACKAGE_ROOT = packageRoot();
+const RUNNER_PATH = join(PACKAGE_ROOT, "scripts", "async-runner.mjs");
+
+function asyncRunnerArgv(stateDir: string): string[] {
+  return existsSync(join(PACKAGE_ROOT, "dist", "lib", "execution.js"))
+    ? [RUNNER_PATH, stateDir]
+    : ["--experimental-strip-types", RUNNER_PATH, stateDir];
+}
 
 function safeRunId(value: string | undefined): string {
   const run = (value || `run-${Date.now()}`).trim();
@@ -400,7 +416,7 @@ export function startRun(
   }
   const outFd = openSync(stdout, "a");
   const errFd = openSync(stderr, "a");
-  const argv = ["--experimental-strip-types", RUNNER_PATH, stateDir];
+  const argv = asyncRunnerArgv(stateDir);
   const values = {
     ...(startParams.values || {}),
     actor_address: `run:${run}`,

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@llblab/pi-actors",
-  "version": "0.19.10",
+  "version": "0.20.0",
   "private": false,
-  "description": "Actor runtime and orchestrator for agent-managed local processes",
+  "description": "Local Actor Kernel for Pi",
   "keywords": [
     "pi-package",
     "pi-extension",
@@ -28,12 +28,15 @@
     "check": "node --experimental-strip-types -e \"await import('./index.ts'); console.log('pi-actors: extension import ok')\"",
     "test": "node --experimental-strip-types --test tests/*.test.ts",
     "pack:dry": "npm pack --dry-run",
-    "validate": "npx tsc --noEmit && npm run check && npm test && npm run pack:dry"
+    "validate": "npx tsc --noEmit && npm run build && npm run check && npm test && npm run pack:dry",
+    "build": "tsc -p tsconfig.build.json",
+    "prepack": "npm run build"
   },
   "files": [
     "index.ts",
     "lib",
     "scripts",
+    "dist",
     "recipes",
     "skills",
     "README.md",

package/scripts/async-runner.mjs

@@ -11,18 +11,38 @@
  * Keep orchestration policy out of this file.
  */
 
-import { appendFileSync, readFileSync } from "node:fs";
-import { join } from "node:path";
+import { appendFileSync, existsSync, readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
 
 const stateDir = process.argv[2];
 if (!stateDir) {
   console.error("missing state dir");
   process.exit(1);
 }
-const { executeRegisteredTool } = await import("../lib/execution.ts");
-const { execCommandTemplate } = await import("../lib/command-templates.ts");
-const { appendRecipeContextToPiArgs } = await import("../lib/actor-recipe-context.ts");
-const { writeJsonAtomic } = await import("../lib/file-state.ts");
+
+function scriptFile() {
+  return fileURLToPath(import.meta.url);
+}
+
+function packageRoot() {
+  return dirname(dirname(scriptFile()));
+}
+
+function libModulePath(name) {
+  const root = packageRoot();
+  const compiled = join(root, "dist", "lib", `${name}.js`);
+  return existsSync(compiled) ? compiled : join(root, "lib", `${name}.ts`);
+}
+
+async function importLib(name) {
+  return import(pathToFileURL(libModulePath(name)).href);
+}
+
+const { executeRegisteredTool } = await importLib("execution");
+const { execCommandTemplate } = await importLib("command-templates");
+const { appendRecipeContextToPiArgs } = await importLib("actor-recipe-context");
+const { writeJsonAtomic } = await importLib("file-state");
 const runPath = join(stateDir, "run.json");
 const progressPath = join(stateDir, "progress.json");
 const resultPath = join(stateDir, "result.json");

package/scripts/validate-recipe.mjs

@@ -1,9 +1,26 @@
 #!/usr/bin/env -S node --experimental-strip-types
 import { existsSync, readdirSync, statSync } from "node:fs";
 import { homedir } from "node:os";
-import { resolve } from "node:path";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
 
-import { readResolvedRecipeConfig } from "../lib/recipe-references.ts";
+function scriptFile() {
+  return fileURLToPath(import.meta.url);
+}
+
+function packageRoot() {
+  return dirname(dirname(scriptFile()));
+}
+
+function libModulePath(name) {
+  const root = packageRoot();
+  const compiled = join(root, "dist", "lib", `${name}.js`);
+  return existsSync(compiled) ? compiled : join(root, "lib", `${name}.ts`);
+}
+
+const { readResolvedRecipeConfig } = await import(
+  pathToFileURL(libModulePath("recipe-references")).href
+);
 
 function usage() {
   console.error(`Usage:

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.19.10
+  version: 0.20.0
 ---
 
 # 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.19.10
+  version: 0.20.0
 ---
 
 # Swarm