@agimon-ai/po-workflow 0.0.0-alpha.57 → 0.0.0-alpha.59

package/README.md

@@ -84,8 +84,10 @@ not select or resolve the tools folder.
 - `sessionId` and the admitted working directory `cwd`.
 - `workflow`: the trusted `PoWorkflowContextService`, including the captured config, job/step identity,
   admitted `jobEnvironment` and `stepEnvironment`, and workflow state reader.
-- Injected `fs` and `shell` capabilities.
+- Injected `fs` and `shell` capabilities. Their methods take a call context as the last argument.
 - `signal`: the session tools lifetime, aborted on session disposal or mounting failure.
+- `context`: a call context for `fs` and `shell`, aborted with `signal`. Inside `bind(run)`, pass
+  `run.context` instead, which also aborts when that exec ends.
 
 Return the existing `PoCodemodeNamespace` contract: name `jobTools`, a non-empty one-line `summary`
 (maximum 600 characters), TypeScript `declarations` for discovery, and `bind(run)`. Bind returns flat
@@ -144,6 +146,19 @@ bridge. A missing file or invalid factory fails the managed step session rather
 omitting its selected tools. The namespace and skill mount and dispose together; disposing them does
 not stop the owning workflow or change its recovery rules.
 
+## Step instructions
+
+A workflow can give its managed Po agent steps their own instructions file:
+
+```yaml
+instructions: ./AGENTS.md
+```
+
+The file replaces the AGENTS.md files the step session would discover from its working directory; it
+does not add to them. The path resolves relative to the declaring YAML and is inherited through
+`imports` as a default, like `tools`. A missing or unreadable file fails the step session rather than
+running it without instructions. Shell steps and external Claude/Codex CLI runners ignore it.
+
 ## Launch and monitor
 
 Core tools are:

package/dist/{RecoverWorkflowService-DL5itVWA.cjs → RecoverWorkflowService-BQiYI4Pg.cjs}

@@ -251,7 +251,9 @@ const PreBlockSchema = zod.z.object({
 	steps: zod.z.array(StepSchema).optional()
 });
 const JobHookBlockSchema = zod.z.object({ steps: zod.z.array(StepSchema).optional() });
-const WorkflowToolsPathSchema = zod.z.string().min(1).refine((value) => value.trim().length > 0 && !/^[a-z][a-z0-9+.-]*:/iu.test(value.trimStart()) && value.split("").every((character) => character.charCodeAt(0) >= 32 && character.charCodeAt(0) !== 127), "Workflow tools must be a local filesystem path without URL schemes or control characters.").describe("Tools folder relative to its declaring YAML file, containing index.mjs and SKILL.md.");
+const localPathSchema = (label) => zod.z.string().min(1).refine((value) => value.trim().length > 0 && !/^[a-z][a-z0-9+.-]*:/iu.test(value.trimStart()) && value.split("").every((character) => character.charCodeAt(0) >= 32 && character.charCodeAt(0) !== 127), `${label} must be a local filesystem path without URL schemes or control characters.`);
+const WorkflowToolsPathSchema = localPathSchema("Workflow tools").describe("Tools folder relative to its declaring YAML file, containing index.mjs and SKILL.md.");
+const WorkflowInstructionsPathSchema = localPathSchema("Workflow instructions").describe("Instructions file relative to its declaring YAML file. Step sessions read it instead of the AGENTS.md files they would discover.");
 const JobSchema = zod.z.object({
 	tools: WorkflowToolsPathSchema.optional(),
 	"runs-on": zod.z.string().optional(),
@@ -333,6 +335,7 @@ const RunDirectorySchema = zod.z.object({
 const WorkflowSchema = zod.z.object({
 	name: zod.z.string().optional(),
 	tools: WorkflowToolsPathSchema.optional(),
+	instructions: WorkflowInstructionsPathSchema.optional(),
 	tags: zod.z.array(zod.z.string().trim().min(1)).optional().describe("Tags used to categorize and filter workflow definitions."),
 	workspace: zod.z.string().optional(),
 	runner: zod.z.string().optional().describe("Default runner key for step command maps when no CLI runner is provided."),
@@ -2500,6 +2503,7 @@ var WorkflowParserService = class {
 			...Object.values(workflow.jobs ?? {}),
 			workflow.repair
 		]) if (declaration?.tools !== void 0) declaration.tools = (0, node_path.resolve)((0, node_path.dirname)(workflowPath), WorkflowToolsPathSchema.parse(declaration.tools));
+		if (workflow.instructions !== void 0) workflow.instructions = (0, node_path.resolve)((0, node_path.dirname)(workflowPath), WorkflowInstructionsPathSchema.parse(workflow.instructions));
 	}
 	/**
 	* Render a command template into the shell command a step runs.
@@ -2642,7 +2646,7 @@ var WorkflowParserService = class {
 	*   - system-prompt: concatenated (imported + main)
 	*   - commands, choices: merged per name (main overrides imported)
 	*   - runConfig, sessionConfig: merged per key (main overrides imported)
-	*   - tools: scalar default (main wins, otherwise first imported selection)
+	*   - tools, instructions: scalar default (main wins, otherwise first imported selection)
 	* Imports are processed in order; earlier merged values act as main overrides.
 	* Circular imports are detected and throw an error.
 	*/
@@ -2659,6 +2663,7 @@ var WorkflowParserService = class {
 			this.resolveToolsPaths(imported, resolvedImport);
 			if (imported.imports) await this.resolveImports(imported, resolvedImport, visited);
 			workflow.tools ??= imported.tools;
+			workflow.instructions ??= imported.instructions;
 			if (imported.env) workflow.env = {
 				...imported.env,
 				...workflow.env
@@ -11541,4 +11546,4 @@ Object.defineProperty(exports, "workflowShellOutput", {
 	}
 });
 
-//# sourceMappingURL=RecoverWorkflowService-DL5itVWA.cjs.map
+//# sourceMappingURL=RecoverWorkflowService-BQiYI4Pg.cjs.map