pi-fabric 0.65.0 → 0.65.2

package/dist/agents/manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/agents/manager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/agents/manager.ts"],"names":[],"mappings":"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"}

package/dist/agents/pi-binary.d.ts

@@ -0,0 +1,7 @@
+export interface PiBinaryResolutionOptions {
+    env?: NodeJS.ProcessEnv;
+    homeDirectory?: string;
+    isExecutable?: (file: string) => boolean;
+}
+export declare const resolvePiBinary: (configured?: string, options?: PiBinaryResolutionOptions) => string;
+//# sourceMappingURL=pi-binary.d.ts.map

package/dist/agents/pi-binary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi-binary.d.ts","sourceRoot":"","sources":["../../src/agents/pi-binary.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,yBAAyB;IACxC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;CAC1C;AAWD,eAAO,MAAM,eAAe,GAC1B,aAAa,MAAM,EACnB,UAAS,yBAA8B,KACtC,MAWF,CAAC"}

package/dist/chunks/{chunk-LNLQOUUR.js → chunk-3XLK3HIF.js}

@@ -736,6 +736,29 @@ ${Date.now()}
   }
 };
 
+// src/agents/pi-binary.ts
+import { accessSync, constants } from "node:fs";
+import { homedir } from "node:os";
+import path2 from "node:path";
+var executable = (file) => {
+  try {
+    accessSync(file, constants.X_OK);
+    return true;
+  } catch {
+    return false;
+  }
+};
+var resolvePiBinary = (configured, options = {}) => {
+  if (configured !== void 0) return configured;
+  const env = options.env ?? process.env;
+  if (env.PI_FABRIC_PI_BINARY !== void 0) return env.PI_FABRIC_PI_BINARY;
+  if (env.LOCALTERM === "1") {
+    const shim = path2.join(options.homeDirectory ?? homedir(), ".localterm", "shims", "pi");
+    if ((options.isExecutable ?? executable)(shim)) return shim;
+  }
+  return "pi";
+};
+
 // src/lifecycle/types.ts
 var FABRIC_PARTICIPANT_LIFECYCLE_TOPIC = "fabric.participant.lifecycle";
 var FABRIC_LIFECYCLE_SUBSCRIPTION_PREFIX = "topology/subscriptions/";
@@ -815,7 +838,7 @@ var lifecycleSubscriptionFromValue = (value) => {
 import { randomUUID as randomUUID2 } from "node:crypto";
 import fs2 from "node:fs";
 import os from "node:os";
-import path2 from "node:path";
+import path3 from "node:path";
 var ENV_BUDGET = "PI_FABRIC_BUDGET";
 var ENV_BUDGET_FILE = "PI_FABRIC_BUDGET_FILE";
 var ENV_BUDGET_ID = "PI_FABRIC_BUDGET_ID";
@@ -831,8 +854,8 @@ function activeBudgetState() {
   return { budget, file, id: process.env[ENV_BUDGET_ID] ?? "" };
 }
 function initBudgetLedger(budget) {
-  const directory = fs2.mkdtempSync(path2.join(os.tmpdir(), "pi-fabric-budget-"));
-  const file = path2.join(directory, "cost.jsonl");
+  const directory = fs2.mkdtempSync(path3.join(os.tmpdir(), "pi-fabric-budget-"));
+  const file = path3.join(directory, "cost.jsonl");
   fs2.writeFileSync(file, "", { mode: 384 });
   const id = randomUUID2().replaceAll("-", "").slice(0, 16);
   process.env[ENV_BUDGET] = String(budget);
@@ -882,7 +905,7 @@ function appendBudgetLedger(file, entry) {
 import { randomUUID as randomUUID4 } from "node:crypto";
 import fs6 from "node:fs";
 import os4 from "node:os";
-import path6 from "node:path";
+import path7 from "node:path";
 import { fileURLToPath } from "node:url";
 
 // src/agents/semaphore.ts
@@ -1244,11 +1267,11 @@ var TmuxTransport = class {
 // src/agents/worktree-manager.ts
 import fs4 from "node:fs";
 import os2 from "node:os";
-import path3 from "node:path";
+import path4 from "node:path";
 var safeLabel = (value) => value.toLowerCase().replace(/[^a-z0-9-]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 30) || "agent";
 var isInside = (root, target) => {
-  const relative = path3.relative(root, target);
-  return relative === "" || relative !== ".." && !relative.startsWith(`..${path3.sep}`) && !path3.isAbsolute(relative);
+  const relative = path4.relative(root, target);
+  return relative === "" || relative !== ".." && !relative.startsWith(`..${path4.sep}`) && !path4.isAbsolute(relative);
 };
 var worktreePrefixParts = (prefix) => {
   const parts = prefix.split(/[\\/]+/).filter(Boolean);
@@ -1272,9 +1295,9 @@ var WorktreeManager = class {
       throw new Error("Worktree isolation requires a Git repository");
     }
     const branch = `pi-fabric/${safeLabel(name)}-${id.slice(0, 8)}`;
-    const parent = path3.join(os2.tmpdir(), "pi-fabric-worktrees");
+    const parent = path4.join(os2.tmpdir(), "pi-fabric-worktrees");
     fs4.mkdirSync(parent, { recursive: true });
-    const worktreePath = path3.join(parent, id);
+    const worktreePath = path4.join(parent, id);
     await executeFile("git", ["worktree", "add", "-b", branch, worktreePath, "HEAD"], {
       cwd: gitRoot,
       timeoutMs: 6e4
@@ -1283,7 +1306,7 @@ var WorktreeManager = class {
     const prefix = preserveSourceSubdirectory ? worktreePrefixParts(sourcePrefix) : void 0;
     let effectiveCwd = canonicalWorktreePath;
     if (prefix && prefix.length > 0) {
-      const candidate = path3.resolve(canonicalWorktreePath, ...prefix);
+      const candidate = path4.resolve(canonicalWorktreePath, ...prefix);
       try {
         const canonicalCandidate = fs4.realpathSync(candidate);
         if (fs4.statSync(canonicalCandidate).isDirectory() && isInside(canonicalWorktreePath, canonicalCandidate)) {
@@ -1319,11 +1342,11 @@ var WorktreeManager = class {
 
 // src/storage/retention.ts
 import fs5 from "node:fs";
-import path4 from "node:path";
+import path5 from "node:path";
 var FABRIC_RUN_ROOT_PREFIX = "pi-fabric-runs-";
 var RUN_ROOT_OWNER_FILE = ".fabric-owner.json";
 var TERMINAL_STATUSES = /* @__PURE__ */ new Set(["completed", "failed", "stopped", "timed_out"]);
-var ownerPath = (root) => path4.join(root, RUN_ROOT_OWNER_FILE);
+var ownerPath = (root) => path5.join(root, RUN_ROOT_OWNER_FILE);
 var readJson = (filePath) => {
   try {
     return JSON.parse(fs5.readFileSync(filePath, "utf8"));
@@ -1374,8 +1397,8 @@ var pruneClosedRunRoot = (root, orphanedTempRunRetentionMs, oneShotRunRetentionM
   }
   for (const entry of entries) {
     if (!entry.isDirectory()) continue;
-    const runDirectory = path4.join(root, entry.name);
-    const record = readJson(path4.join(runDirectory, "status.json"));
+    const runDirectory = path5.join(root, entry.name);
+    const record = readJson(path5.join(runDirectory, "status.json"));
     if (!record?.status || !TERMINAL_STATUSES.has(record.status)) continue;
     let fallback = now;
     try {
@@ -1410,8 +1433,8 @@ var sweepTempRunRoots = (options) => {
   }
   for (const entry of entries) {
     if (!entry.isDirectory() || !entry.name.startsWith(FABRIC_RUN_ROOT_PREFIX)) continue;
-    const root = path4.join(options.tempRoot, entry.name);
-    if (options.currentRoot && path4.resolve(root) === path4.resolve(options.currentRoot)) continue;
+    const root = path5.join(options.tempRoot, entry.name);
+    if (options.currentRoot && path5.resolve(root) === path5.resolve(options.currentRoot)) continue;
     const owner = readJson(ownerPath(root));
     if (!owner) {
       try {
@@ -1457,8 +1480,8 @@ var pruneActorRunArchives = (options) => {
   }
   for (const entry of entries) {
     if (!entry.isDirectory() || entry.name === options.latestRunId) continue;
-    const runDirectory = path4.join(options.runsDirectory, entry.name);
-    const record = readJson(path4.join(runDirectory, "status.json"));
+    const runDirectory = path5.join(options.runsDirectory, entry.name);
+    const record = readJson(path5.join(runDirectory, "status.json"));
     if (!record?.status || !TERMINAL_STATUSES.has(record.status)) continue;
     let fallback = now;
     try {
@@ -1474,21 +1497,21 @@ var pruneActorRunArchives = (options) => {
 
 // src/agents/session-export.ts
 import os3 from "node:os";
-import path5 from "node:path";
+import path6 from "node:path";
 var SESSION_EXPORT_ENV = "PI_FABRIC_AGENT_DIR";
-var expandHome = (value) => value === "~" ? os3.homedir() : value.startsWith("~/") || value.startsWith(`~${path5.win32.sep}`) ? path5.join(os3.homedir(), value.slice(2)) : value;
+var expandHome = (value) => value === "~" ? os3.homedir() : value.startsWith("~/") || value.startsWith(`~${path6.win32.sep}`) ? path6.join(os3.homedir(), value.slice(2)) : value;
 var encodeSessionExportCwd = (cwd) => {
-  const absolute = path5.isAbsolute(cwd) || path5.win32.isAbsolute(cwd) ? cwd : path5.resolve(cwd);
+  const absolute = path6.isAbsolute(cwd) || path6.win32.isAbsolute(cwd) ? cwd : path6.resolve(cwd);
   return `--${absolute.replace(/^[/\\]/, "").replace(/[/\\:]/g, "-")}--`;
 };
 var resolveSessionExportDir = (config) => {
   if (!config.sessionExport) return void 0;
-  const raw = process.env[SESSION_EXPORT_ENV]?.trim() || config.sessionExportDir.trim() || path5.join(os3.homedir(), ".pi", "agent");
+  const raw = process.env[SESSION_EXPORT_ENV]?.trim() || config.sessionExportDir.trim() || path6.join(os3.homedir(), ".pi", "agent");
   return expandHome(raw);
 };
 var sessionExportFileFor = (root, cwd, runId, at) => {
   const fileTimestamp = at.toISOString().replace(/[:.]/g, "-");
-  return path5.join(
+  return path6.join(
     root,
     "sessions",
     ".fabric",
@@ -1533,7 +1556,7 @@ var resolveAgentCwd = (parentCwd, requestedCwd) => {
   if (typeof requested !== "string" || requested.trim().length === 0) {
     throw new Error(`Invalid Fabric agent cwd ${JSON.stringify(requested)}: path must not be empty`);
   }
-  const candidate = path6.isAbsolute(requested) ? requested : path6.resolve(parentCwd, requested);
+  const candidate = path7.isAbsolute(requested) ? requested : path7.resolve(parentCwd, requested);
   try {
     const canonical = fs6.realpathSync(candidate);
     fs6.accessSync(canonical, fs6.constants.R_OK | fs6.constants.X_OK);
@@ -1596,7 +1619,7 @@ var compactUiRecord = (record) => {
 };
 var readNestedAgents = (runDirectory, depth = 0) => {
   if (depth >= 8) return [];
-  const nestedRoot = path6.join(runDirectory, "nested");
+  const nestedRoot = path7.join(runDirectory, "nested");
   let entries;
   try {
     entries = fs6.readdirSync(nestedRoot);
@@ -1605,15 +1628,15 @@ var readNestedAgents = (runDirectory, depth = 0) => {
   }
   const agents = [];
   for (const entry of entries.slice(0, 200)) {
-    const runDirectory2 = path6.join(nestedRoot, entry);
-    const record = readRecord(path6.join(runDirectory2, "status.json"));
+    const runDirectory2 = path7.join(nestedRoot, entry);
+    const record = readRecord(path7.join(runDirectory2, "status.json"));
     if (!record) continue;
     const nestedAgents = readNestedAgents(runDirectory2, depth + 1);
     const { logFile: _logFile, nestedAgents: _nestedAgents, ...safeRecord } = record;
     agents.push(
       compactUiRecord({
         ...safeRecord,
-        logFile: path6.join(runDirectory2, "events.jsonl"),
+        logFile: path7.join(runDirectory2, "events.jsonl"),
         ...nestedAgents.length > 0 ? { nestedAgents } : {}
       })
     );
@@ -1621,7 +1644,7 @@ var readNestedAgents = (runDirectory, depth = 0) => {
   return agents;
 };
 var summarizeRunLog = (runDirectory, lines) => {
-  const page = readJsonlPage(path6.join(runDirectory, "events.jsonl"), lines);
+  const page = readJsonlPage(path7.join(runDirectory, "events.jsonl"), lines);
   const summary = [];
   for (const entry of page.lines) {
     const parsed = entry.parsed;
@@ -1672,11 +1695,11 @@ var AgentManager = class {
     this.config = config;
     this.#semaphore = new Semaphore(config.maxConcurrent);
     this.#managedTempRoot = options.runRoot === void 0 && process.env.PI_FABRIC_RUN_ROOT === void 0;
-    this.#runRoot = options.runRoot ?? process.env.PI_FABRIC_RUN_ROOT ?? fs6.mkdtempSync(path6.join(os4.tmpdir(), "pi-fabric-runs-"));
+    this.#runRoot = options.runRoot ?? process.env.PI_FABRIC_RUN_ROOT ?? fs6.mkdtempSync(path7.join(os4.tmpdir(), "pi-fabric-runs-"));
     this.#retention = options.retention ?? DEFAULT_FABRIC_CONFIG.retention;
     this.#workerPath = options.workerPath ?? fileURLToPath(new URL("../worker.js", import.meta.url));
     this.#fabricExtensionPath = options.fabricExtensionPath ?? fileURLToPath(new URL("../index.js", import.meta.url));
-    this.#piBinary = options.piBinary ?? process.env.PI_FABRIC_PI_BINARY ?? "pi";
+    this.#piBinary = resolvePiBinary(options.piBinary);
     this.#claudeBinary = options.claudeBinary ?? process.env.PI_FABRIC_CLAUDE_BINARY ?? config.claude.binary;
     this.#vedaBinary = options.vedaBinary ?? process.env.PI_FABRIC_VEDA_BINARY ?? config.veda.binary;
     this.#onBackgroundComplete = options.onBackgroundComplete;
@@ -1826,15 +1849,15 @@ var AgentManager = class {
     const release = await this.#semaphore.acquire(signal);
     const id = randomUUID4().replaceAll("-", "");
     const name = safeName(request.name ?? request.task.split("\n", 1)[0] ?? "Fabric agent");
-    const runDirectory = path6.join(this.#runRoot, id);
+    const runDirectory = path7.join(this.#runRoot, id);
     fs6.mkdirSync(runDirectory, { recursive: true });
-    const taskFile = path6.join(runDirectory, "task.txt");
-    const statusFile = path6.join(runDirectory, "status.json");
-    const lifecycleFile = path6.join(runDirectory, "lifecycle.jsonl");
-    const logFile = path6.join(runDirectory, "events.jsonl");
-    const steerFile = path6.join(runDirectory, "steer.jsonl");
-    const schemaFile = request.schema ? path6.join(runDirectory, "schema.json") : void 0;
-    const imagesFile = request.images && request.images.length > 0 ? path6.join(runDirectory, "images.json") : void 0;
+    const taskFile = path7.join(runDirectory, "task.txt");
+    const statusFile = path7.join(runDirectory, "status.json");
+    const lifecycleFile = path7.join(runDirectory, "lifecycle.jsonl");
+    const logFile = path7.join(runDirectory, "events.jsonl");
+    const steerFile = path7.join(runDirectory, "steer.jsonl");
+    const schemaFile = request.schema ? path7.join(runDirectory, "schema.json") : void 0;
+    const imagesFile = request.images && request.images.length > 0 ? path7.join(runDirectory, "images.json") : void 0;
     fs6.writeFileSync(taskFile, request.task, { encoding: "utf8", mode: 384 });
     if (imagesFile) {
       fs6.writeFileSync(imagesFile, JSON.stringify(request.images), {
@@ -1866,7 +1889,7 @@ var AgentManager = class {
       const sessionFile = request.sessionSeed ? writeHandoffSession(
         request.sessionSeed,
         agentCwd,
-        path6.join(runDirectory, "handoff-session"),
+        path7.join(runDirectory, "handoff-session"),
         request.thinkingTransfer,
         request.handoffCompact
       ) : request.sessionFile;
@@ -1943,7 +1966,7 @@ var AgentManager = class {
         ...this.#identityId ? ["--owner-identity-id", this.#identityId] : [],
         ...request.runnerSessionId ? ["--runner-session-id", request.runnerSessionId] : [],
         "--run-root",
-        path6.join(runDirectory, "nested"),
+        path7.join(runDirectory, "nested"),
         "--steer-file",
         steerFile,
         ...schemaFile ? ["--schema-file", schemaFile] : [],
@@ -2136,10 +2159,10 @@ var AgentManager = class {
   readLog(id, opts = {}) {
     const managed = this.#requireRun(id);
     const runDirectory = managed.runDirectory;
-    const logFile = path6.join(runDirectory, "events.jsonl");
+    const logFile = path7.join(runDirectory, "events.jsonl");
     const lines = Math.max(1, Math.min(opts.lines ?? 200, 5e3));
     const page = readJsonlPage(logFile, lines, opts.before);
-    const statusRecord = readRecord(path6.join(runDirectory, "status.json"));
+    const statusRecord = readRecord(path7.join(runDirectory, "status.json"));
     return {
       id,
       runDirectory,
@@ -2200,7 +2223,7 @@ var AgentManager = class {
         `Fabric agent ${id} already finished (${record.status}); steering has no target`
       );
     }
-    const steerFile = path6.join(managed.runDirectory, "steer.jsonl");
+    const steerFile = path7.join(managed.runDirectory, "steer.jsonl");
     const messageId = randomUUID4();
     const line = JSON.stringify({ ...entry, id: messageId, ts: Date.now() }) + "\n";
     fs6.appendFileSync(steerFile, line, { encoding: "utf8", mode: 384 });
@@ -2221,7 +2244,7 @@ var AgentManager = class {
       await removeTree(this.#runRoot);
     }
     if (this.#budgetOwned && this.#budget) {
-      await removeTree(path6.dirname(this.#budget.file));
+      await removeTree(path7.dirname(this.#budget.file));
       clearOwnedBudgetEnv();
     }
   }
@@ -2382,7 +2405,7 @@ var AgentManager = class {
     if (managed.settled) return;
     this.#drainLifecycle(managed);
     managed.settled = true;
-    fs6.rmSync(path6.join(managed.runDirectory, "images.json"), { force: true });
+    fs6.rmSync(path7.join(managed.runDirectory, "images.json"), { force: true });
     this.#emitLifecycle(managed, `run.${result.status}`, result.finishedAt ?? Date.now(), {
       status: result.status
     });
@@ -2614,7 +2637,7 @@ var AgentManager = class {
   // in the parent run until that parent is explicitly cleaned up.
   #nestedAgents(managed, force = false) {
     const now = Date.now();
-    const needsInitialDiscovery = managed.nestedSnapshot === void 0 && fs6.existsSync(path6.join(managed.runDirectory, "nested"));
+    const needsInitialDiscovery = managed.nestedSnapshot === void 0 && fs6.existsSync(path7.join(managed.runDirectory, "nested"));
     if (!force && !needsInitialDiscovery && managed.nestedSnapshotAt !== void 0 && now - managed.nestedSnapshotAt < NESTED_SNAPSHOT_POLL_MS) {
       return managed.nestedSnapshot ? structuredClone(managed.nestedSnapshot) : [];
     }
@@ -2638,7 +2661,7 @@ var AgentManager = class {
       cwd: managed.cwd,
       runner: managed.runner,
       ...managed.residency === "durable" ? { residency: "durable" } : {},
-      logFile: path6.join(managed.runDirectory, "events.jsonl"),
+      logFile: path7.join(managed.runDirectory, "events.jsonl"),
       ...nestedAgents.length > 0 ? { nestedAgents } : {},
       ...budget ? { budget } : {},
       ...managed.model ? { model: managed.model } : {},
@@ -2694,7 +2717,7 @@ var actorDeliveryNotice = (delivery, triggerTurn) => {
 import { randomUUID as randomUUID6 } from "node:crypto";
 import fs8 from "node:fs";
 import os5 from "node:os";
-import path8 from "node:path";
+import path9 from "node:path";
 
 // src/actors/predicate.ts
 var PREDICATE_VERSION = 1;
@@ -2766,7 +2789,7 @@ var evaluateActorValidWhile = async (source, facts) => {
 // src/actors/binding-store.ts
 import { createHash, randomUUID as randomUUID5 } from "node:crypto";
 import fs7 from "node:fs";
-import path7 from "node:path";
+import path8 from "node:path";
 var BINDING_LOCK_TIMEOUT_MS = 5e3;
 var BINDING_STALE_LOCK_MS = 3e4;
 var bindingFileName = (sessionId) => `${createHash("sha256").update(sessionId).digest("hex")}.json`;
@@ -2776,7 +2799,7 @@ var delay3 = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 var ActorBindingStore = class {
   constructor(sessionId, root) {
     this.sessionId = sessionId;
-    this.filePath = root ? path7.join(root, "bindings", bindingFileName(sessionId)) : void 0;
+    this.filePath = root ? path8.join(root, "bindings", bindingFileName(sessionId)) : void 0;
     this.#sync(true);
   }
   #bindings = /* @__PURE__ */ new Map();
@@ -2892,7 +2915,7 @@ var ActorBindingStore = class {
   async #withLock(operation) {
     if (!this.filePath) return operation();
     const lockPath = `${this.filePath}.lock`;
-    const ownerPath2 = path7.join(lockPath, "owner");
+    const ownerPath2 = path8.join(lockPath, "owner");
     const deadline = Date.now() + BINDING_LOCK_TIMEOUT_MS;
     const token = randomUUID5();
     const processAlive3 = (pid) => {
@@ -2904,7 +2927,7 @@ var ActorBindingStore = class {
         return false;
       }
     };
-    fs7.mkdirSync(path7.dirname(this.filePath), { recursive: true, mode: 448 });
+    fs7.mkdirSync(path8.dirname(this.filePath), { recursive: true, mode: 448 });
     while (true) {
       try {
         fs7.mkdirSync(lockPath, { mode: 448 });
@@ -3084,7 +3107,7 @@ var ActorManager = class {
     this.meshConfig = meshConfig;
     this.agents = agents;
     this.onDeliver = onDeliver;
-    this.#actorRoot = options.actorRoot ?? fs8.mkdtempSync(path8.join(os5.tmpdir(), "pi-fabric-actors-"));
+    this.#actorRoot = options.actorRoot ?? fs8.mkdtempSync(path9.join(os5.tmpdir(), "pi-fabric-actors-"));
     this.#persistent = options.persistent ?? false;
     this.#mainAgent = options.mainAgent;
     this.#canManageActor = options.canManageActor;
@@ -3093,7 +3116,7 @@ var ActorManager = class {
     this.#claimResidency = options.claimResidency;
     this.#rootId = options.rootId ?? identity.id;
     this.#meshCursorPath = options.meshCursorPath;
-    this.#registryPath = path8.join(this.#actorRoot, "actors.json");
+    this.#registryPath = path9.join(this.#actorRoot, "actors.json");
     this.#bindings = new ActorBindingStore(
       sessionId,
       this.#persistent && meshConfig.enabled ? this.#actorRoot : void 0
@@ -3203,7 +3226,7 @@ var ActorManager = class {
       throw new Error("This Fabric host cannot commit actor capability requirements");
     }
     const id = randomUUID6().replaceAll("-", "");
-    const actorDirectory = path8.join(this.#actorRoot, id);
+    const actorDirectory = path9.join(this.#actorRoot, id);
     fs8.mkdirSync(actorDirectory, { recursive: true, mode: 448 });
     const actor = {
       id,
@@ -3228,7 +3251,7 @@ var ActorManager = class {
       requirements,
       ...request.validWhile ? { validWhile: structuredClone(request.validWhile) } : {},
       latestActivationSequence: 0,
-      sessionFile: path8.join(actorDirectory, "session.jsonl"),
+      sessionFile: path9.join(actorDirectory, "session.jsonl"),
       queue: [],
       draining: false,
       messages: [],
@@ -3561,17 +3584,17 @@ var ActorManager = class {
     const type = opts.type ?? "session";
     const lines = Math.max(1, Math.min(opts.lines ?? 200, 5e3));
     const sessionFile = actor.sessionFile;
-    const logDir = path8.join(path8.dirname(sessionFile), "runs");
+    const logDir = path9.join(path9.dirname(sessionFile), "runs");
     const sessionPage = type === "run" ? { lines: [], hasMore: false } : readJsonlPage(sessionFile, lines, opts.before);
     const session = sessionPage.lines;
     let run;
     if (type !== "session") {
       const targetRunId = opts.runId ?? actor.lastRunId;
       if (targetRunId) {
-        const runPath = path8.join(logDir, targetRunId);
+        const runPath = path9.join(logDir, targetRunId);
         if (fs8.existsSync(runPath)) {
-          const statusRecord = readRunRecord(path8.join(runPath, "status.json"));
-          const eventsFile = path8.join(runPath, "events.jsonl");
+          const statusRecord = readRunRecord(path9.join(runPath, "status.json"));
+          const eventsFile = path9.join(runPath, "events.jsonl");
           const page = readJsonlPage(eventsFile, lines, opts.before);
           run = {
             runId: targetRunId,
@@ -3788,7 +3811,7 @@ var ActorManager = class {
     await this.#bindings.delete(actor.id);
     this.#actors.delete(actor.id);
     this.#emitChange();
-    fs8.rmSync(path8.dirname(actor.sessionFile), { recursive: true, force: true });
+    fs8.rmSync(path9.dirname(actor.sessionFile), { recursive: true, force: true });
     await this.#saveActors(/* @__PURE__ */ new Set([actor.id]));
     await this.mesh.delete({ key: this.#presenceKey(actor.id) }).catch(() => ({ deleted: false }));
     if (retainedRunId) await this.agents.cleanup(retainedRunId).catch(() => ({ cleaned: false }));
@@ -4221,7 +4244,7 @@ var ActorManager = class {
     }
     try {
       const watcher = fs8.watch(this.mesh.root, { persistent: false }, (_event, filename) => {
-        if (filename !== null && path8.basename(filename.toString()) !== "events.jsonl") return;
+        if (filename !== null && path9.basename(filename.toString()) !== "events.jsonl") return;
         this.#scheduleMeshPoll();
       });
       this.#meshWatcher = watcher;
@@ -4331,16 +4354,16 @@ var ActorManager = class {
   async #retainRunLog(actor, runId) {
     const runDirectory = this.agents.runDirectory(runId);
     if (!runDirectory || !fs8.existsSync(runDirectory)) return;
-    const dest = path8.join(path8.dirname(actor.sessionFile), "runs", runId);
+    const dest = path9.join(path9.dirname(actor.sessionFile), "runs", runId);
     fs8.mkdirSync(dest, { recursive: true, mode: 448 });
     for (const file of ["events.jsonl", "status.json", "task.txt"]) {
-      const src = path8.join(runDirectory, file);
-      if (fs8.existsSync(src)) fs8.copyFileSync(src, path8.join(dest, file));
+      const src = path9.join(runDirectory, file);
+      if (fs8.existsSync(src)) fs8.copyFileSync(src, path9.join(dest, file));
     }
-    const nested = path8.join(runDirectory, "nested");
+    const nested = path9.join(runDirectory, "nested");
     if (fs8.existsSync(nested)) {
       try {
-        fs8.cpSync(nested, path8.join(dest, "nested"), { recursive: true });
+        fs8.cpSync(nested, path9.join(dest, "nested"), { recursive: true });
       } catch {
       }
     }
@@ -4348,7 +4371,7 @@ var ActorManager = class {
   }
   #pruneRetainedRuns(actor, now = Date.now()) {
     pruneActorRunArchives({
-      runsDirectory: path8.join(path8.dirname(actor.sessionFile), "runs"),
+      runsDirectory: path9.join(path9.dirname(actor.sessionFile), "runs"),
       ...actor.lastRunId ? { latestRunId: actor.lastRunId } : {},
       retentionMs: this.#retention.actorRunArchiveMs,
       now
@@ -4362,7 +4385,7 @@ var ActorManager = class {
     }
   }
   #retainedRunIds(actor) {
-    const runsDir = path8.join(path8.dirname(actor.sessionFile), "runs");
+    const runsDir = path9.join(path9.dirname(actor.sessionFile), "runs");
     try {
       return fs8.readdirSync(runsDir).sort();
     } catch {
@@ -4491,7 +4514,7 @@ var ActorManager = class {
   }
   async #withRegistryLock(operation) {
     const lockPath = `${this.#registryPath}.lock`;
-    const ownerPath2 = path8.join(lockPath, "owner");
+    const ownerPath2 = path9.join(lockPath, "owner");
     const deadline = Date.now() + ACTOR_REGISTRY_LOCK_TIMEOUT_MS;
     const token = randomUUID6();
     const processAlive3 = (pid) => {
@@ -4677,7 +4700,7 @@ ${Date.now()}
         ...typeof record.capabilityDigest === "string" ? { capabilityDigest: record.capabilityDigest } : {},
         ...record.validWhile?.version === 1 && typeof record.validWhile.source === "string" ? { validWhile: record.validWhile } : {},
         latestActivationSequence: 0,
-        sessionFile: path8.join(this.#actorRoot, record.id, "session.jsonl"),
+        sessionFile: path9.join(this.#actorRoot, record.id, "session.jsonl"),
         queue: [],
         draining: false,
         messages: [],
@@ -4762,7 +4785,7 @@ ${Date.now()}
       ...actor.lastRunId ? { lastRunId: actor.lastRunId } : {},
       ...actor.lastError ? { lastError: actor.lastError } : {},
       sessionFile: actor.sessionFile,
-      logDir: path8.join(path8.dirname(actor.sessionFile), "runs")
+      logDir: path9.join(path9.dirname(actor.sessionFile), "runs")
     };
   }
   validateDirectMessage(message, data) {
@@ -6199,16 +6222,17 @@ var actorParticipantRecord = (actor, rootId, ownerHostId, ownerIdentityId, paren
 
 // src/residency/protocol.ts
 import { createHash as createHash4 } from "node:crypto";
-import path9 from "node:path";
+import path10 from "node:path";
 var RESIDENT_HOST_FORMAT = 1;
 var RESIDENT_DELIVERY_PREFIX = "residency/deliveries/";
 var digest = (value) => createHash4("sha256").update(value).digest("hex");
 var residentHostId = (rootId) => `resident:${digest(rootId).slice(0, 24)}`;
-var residentRoot = (meshRoot, rootId) => path9.join(meshRoot, "residency", digest(rootId));
+var residentRoot = (meshRoot, rootId) => path10.join(meshRoot, "residency", digest(rootId));
 var residentDeliveryPrefix = (rootId) => `${RESIDENT_DELIVERY_PREFIX}${digest(rootId).slice(0, 32)}/`;
 
 export {
   MeshStore,
+  resolvePiBinary,
   FABRIC_PARTICIPANT_LIFECYCLE_TOPIC,
   FABRIC_LIFECYCLE_EVENTS,
   isFabricLifecycleEventType,
@@ -6231,4 +6255,4 @@ export {
   residentRoot,
   residentDeliveryPrefix
 };
-//# sourceMappingURL=chunk-LNLQOUUR.js.map
+//# sourceMappingURL=chunk-3XLK3HIF.js.map