@llblab/pi-actors 0.16.2 → 0.16.3

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.16.3: Recipe Import Path Placeholders
+
+- `[Template Recipes]` Added static `{repo}` and `{agent}` expansion for recipe paths, including `imports` and `from` bindings. Impact: recipes can import sibling packaged/user recipes without hard-coded absolute paths while keeping imports load-time deterministic.
+- `[Docs]` Documented `{repo}` and `{agent}` import path placeholders in the template recipe standard.
+- `[Package]` Bumped package and packaged skill metadata to `0.16.3` for the hotfix release.
+
 ## 0.16.2: Recipe Registry Diagnostics Hotfix
 
 - `[Schema]` Derived recipe tool arguments without expanding runtime-dependent repeat nodes. Impact: valid recipes using repeat expressions such as `{lenses.length}` can be exposed as tools instead of being skipped during startup schema generation.

package/docs/template-recipes.md

@@ -245,7 +245,7 @@ File-backed recipes may import other file-backed recipes at the recipe layer. Im
 
 An import binding may be either a string recipe path/name or an object with:
 
-- `from`: recipe path or bare name.
+- `from`: recipe path or bare name. Import paths support static load-time placeholders: `{repo}` expands to the directory above the active recipe root, and `{agent}` expands to the pi agent directory. For a packaged recipe in `<repo>/recipes/name.json`, `{repo}/recipes/other.json` resolves to a sibling packaged recipe. For a user recipe in `~/.pi/agent/recipes/name.json`, `{repo}` and `{agent}` both resolve to `~/.pi/agent`.
 - `defaults`: extra default values exposed through the import.
 - `values`: explicit values for embedding that imported recipe.
 

package/lib/recipe-references.ts

@@ -75,11 +75,15 @@ export function resolveRecipePath(
   recipeRoot = Paths.getRecipeRoot(),
 ): string {
   const trimmed = value.trim();
-  if (trimmed.startsWith("~/")) return resolve(homedir(), trimmed.slice(2));
-  if (trimmed.includes("/")) return resolve(trimmed);
+  const repoRoot = resolve(recipeRoot, "..");
+  const expanded = trimmed
+    .replaceAll("{repo}", repoRoot)
+    .replaceAll("{agent}", Paths.getAgentDir());
+  if (expanded.startsWith("~/")) return resolve(homedir(), expanded.slice(2));
+  if (expanded.includes("/")) return resolve(expanded);
   return resolve(
     recipeRoot,
-    trimmed.endsWith(".json") ? trimmed : `${trimmed}.json`,
+    expanded.endsWith(".json") ? expanded : `${expanded}.json`,
   );
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llblab/pi-actors",
-  "version": "0.16.2",
+  "version": "0.16.3",
   "private": false,
   "description": "Actor runtime and orchestrator for agent-managed local processes",
   "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.16.2
+  version: 0.16.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.16.2
+  version: 0.16.3
 ---
 
 # Swarm