pi-subagents 0.8.0 → 0.8.1

package/CHANGELOG.md

@@ -2,6 +2,11 @@
 
 ## [Unreleased]
 
+## [0.8.1] - 2026-02-10
+
+### Added
+- **`chainDir` param** for persistent chain artifacts — specify a directory to keep artifacts beyond the default 24-hour `/tmp/` cleanup. Relative paths are resolved to absolute via `path.resolve()` for safe use in `{chain_dir}` template substitutions.
+
 ## [0.8.0] - 2026-02-09
 
 ### Added

package/README.md

@@ -474,6 +474,7 @@ Notes:
 | `model` | string | agent default | Override model for single agent |
 | `tasks` | `{agent, task, cwd?, skill?}[]` | - | Parallel tasks (sync only) |
 | `chain` | ChainItem[] | - | Sequential steps with behavior overrides (see below) |
+| `chainDir` | string | `/tmp/pi-chain-runs/` | Persistent directory for chain artifacts (default auto-cleaned after 24h) |
 | `clarify` | boolean | true (chains) | Show TUI to preview/edit chain; implies sync mode |
 | `agentScope` | `"user" \| "project" \| "both"` | `user` | Agent discovery scope |
 | `async` | boolean | false | Background execution (requires `clarify: false` for chains) |

package/chain-execution.ts

@@ -76,6 +76,7 @@ export interface ChainExecutionParams {
 	clarify?: boolean;
 	onUpdate?: (r: AgentToolResult<Details>) => void;
 	chainSkills?: string[];
+	chainDir?: string;
 }
 
 export interface ChainExecutionResult {
@@ -103,6 +104,7 @@ export async function executeChain(params: ChainExecutionParams): Promise<ChainE
 		clarify,
 		onUpdate,
 		chainSkills: chainSkillsParam,
+		chainDir: chainDirBase,
 	} = params;
 	const chainSkills = chainSkillsParam ?? [];
 
@@ -123,7 +125,7 @@ export async function executeChain(params: ChainExecutionParams): Promise<ChainE
 		?? (isParallelStep(firstStep) ? firstStep.parallel[0]!.task! : (firstStep as SequentialStep).task!);
 
 	// Create chain directory
-	const chainDir = createChainDir(runId);
+	const chainDir = createChainDir(runId, chainDirBase);
 
 	// Check if chain has any parallel steps
 	const hasParallelSteps = chainSteps.some(isParallelStep);

package/index.ts

@@ -377,6 +377,7 @@ MANAGEMENT (use action field — omit agent/task/chain/tasks):
 					clarify: params.clarify,
 					onUpdate,
 					chainSkills,
+					chainDir: params.chainDir,
 				});
 			}
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-subagents",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "description": "Pi extension for delegating tasks to subagents with chains, parallel execution, and TUI clarification",
   "author": "Nico Bailon",
   "license": "MIT",

package/schemas.ts

@@ -75,6 +75,7 @@ export const SubagentParams = Type.Object({
 	})),
 	tasks: Type.Optional(Type.Array(TaskItem, { description: "PARALLEL mode: [{agent, task}, ...]" })),
 	chain: Type.Optional(Type.Array(ChainItem, { description: "CHAIN mode: sequential pipeline where each step's response becomes {previous} for the next. Use {task}, {previous}, {chain_dir} in task templates." })),
+	chainDir: Type.Optional(Type.String({ description: "Persistent directory for chain artifacts. Default: /tmp/pi-chain-runs/ (auto-cleaned after 24h)" })),
 	async: Type.Optional(Type.Boolean({ description: "Run in background (default: false, or per config)" })),
 	agentScope: Type.Optional(Type.String({ description: "Agent discovery scope: 'user', 'project', or 'both' (default: 'user')" })),
 	cwd: Type.Optional(Type.String()),

package/settings.ts

@@ -88,8 +88,8 @@ export function getStepAgents(step: ChainStep): string[] {
 // Chain Directory Management
 // =============================================================================
 
-export function createChainDir(runId: string): string {
-	const chainDir = path.join(CHAIN_RUNS_DIR, runId);
+export function createChainDir(runId: string, baseDir?: string): string {
+	const chainDir = path.join(baseDir ? path.resolve(baseDir) : CHAIN_RUNS_DIR, runId);
 	fs.mkdirSync(chainDir, { recursive: true });
 	return chainDir;
 }