CVE-2026-56833

PraisonAI is a multi-agent teams system. From version 3.8.1 to before version 4.6.59, PraisonAI's Dynamic Context module provides filesystem-backed history and terminal-log storage. The module also exports agent-callable tool factories. Those tools accept run_id and agent_id arguments from the tool caller. The underlying stores join those values into filesystem paths without rejecting absolute paths or .. traversal. Because run_id can be an absolute path and agent_id can contain traversal, a lower-trust prompt/user that can call these tools can read .jsonl and .log files outside the configured Dynamic Context base directory. This issue has been patched in version 4.6.59.

PraisonAI is a multi-agent teams system. From version 3.8.1 to before version 4.6.59, PraisonAI's Dynamic Context module provides filesystem-backed history and terminal-log storage. The module also exports agent-callable tool factories. Those tools accept run_id and agent_id arguments from the tool caller. The underlying stores join those values into filesystem paths without rejecting absolute paths or .. traversal. Because run_id can be an absolute path and agent_id can contain traversal, a lower-trust prompt/user that can call these tools can read .jsonl and .log files outside the configured Dynamic Context base directory. This issue has been patched in version 4.6.59.

PraisonAI Dynamic Context history and terminal tools read files outside configured storage via path traversal

Summary

PraisonAI's Dynamic Context module provides filesystem-backed history and terminal-log storage. The SDK reference describes the module as providing:

• artifact storage for tool outputs, history, and terminal logs;
• history persistence with search; and
• terminal session logging.

The module also exports agent-callable tool factories:

• create_history_tools() returns history_search, history_tail, and history_get.
• create_terminal_tools() returns terminal_tail, terminal_grep, and terminal_commands.

Those tools accept run_id and agent_id arguments from the tool caller. The underlying stores join those values into filesystem paths without rejecting absolute paths or .. traversal:

history_dir = self.base_dir / run_id / "history"
return history_dir / f"{agent_id}.jsonl"

terminal_dir = self.base_dir / run_id / "terminal"
return terminal_dir / f"{agent_id}.log"

Because run_id can be an absolute path and agent_id can contain traversal, a lower-trust prompt/user that can call these tools can read .jsonl and .log files outside the configured Dynamic Context base directory.

Affected Product

• Repository: MervinPraison/PraisonAI
• Ecosystem: pip
• Package: praisonai
• Component: Dynamic Context history and terminal tools
• Current source paths:
  • src/praisonai/praisonai/context/history_store.py
  • src/praisonai/praisonai/context/terminal_logger.py
• Latest PyPI version validated: 4.6.58
• Current origin/main validated: 1ad58ca02975ff1398efeda694ea2ab78f20cf3e
• Current origin/main tag validated: v4.6.58

Suggested affected range:

pip:praisonai >= 3.8.1, <= 4.6.58

Representative local sweep:

• 3.8.1: vulnerable
• 4.0.0: vulnerable
• 4.5.113: vulnerable
• 4.6.33: vulnerable
• 4.6.34: vulnerable
• 4.6.40: vulnerable
• 4.6.50: vulnerable
• 4.6.58: vulnerable

Root Cause

HistoryStore._get_history_path() and TerminalLogger._get_log_path() treat logical identifiers as path segments, but never validate that the resolved path stays under base_dir.

History path construction:

def _get_history_path(self, run_id: str, agent_id: str) -> Path:
    history_dir = self.base_dir / run_id / "history"
    history_dir.mkdir(parents=True, exist_ok=True)
    return history_dir / f"{agent_id}.jsonl"

Terminal path construction:

def _get_log_path(self, run_id: str, agent_id: str) -> Path:
    terminal_dir = self.base_dir / run_id / "terminal"
    terminal_dir.mkdir(parents=True, exist_ok=True)
    return terminal_dir / f"{agent_id}.log"

The agent tools pass caller-controlled run_id and agent_id directly into these helpers:

def history_tail(agent_id: str = "default", run_id: str = "default", count: int = 10) -> str:
    messages = history_store.get_last_messages(agent_id=agent_id, run_id=run_id, count=count)

def terminal_tail(agent_id: str = "default", run_id: str = "default", lines: int = 50) -> str:
    return term_logger.tail_session(agent_id=agent_id, run_id=run_id, lines=lines)

There is no check equivalent to:

resolved = candidate.resolve()
base = self.base_dir.resolve()
resolved.relative_to(base)

There is also no identifier allowlist preventing /, \, or .. in run_id or agent_id.

Local PoV

Run against the latest PyPI package:

uv run --with 'praisonai==4.6.58' \
  python poc/pov_prai_cand_027_history_terminal_tools_path_traversal.py --json

The PoV:

1. Creates a temporary Dynamic Context base directory.
2. Creates a separate outside directory containing secret.jsonl and secret.log.
3. Creates legitimate in-base history and terminal log controls.
4. Calls history_tail() and history_get() with run_id=<outside-dir> and agent_id=../secret.
5. Calls terminal_tail() and…

PraisonAI is a multi-agent teams system. From version 3.8.1 to before version 4.6.59, PraisonAI's Dynamic Context module provides filesystem-backed history and terminal-log storage. The module also exports agent-callable tool factories. Those tools accept run_id and agent_id arguments from the tool caller. The underlying stores join those values into filesystem paths without rejecting absolute paths or .. traversal. Because run_id can be an absolute path and agent_id can contain traversal, a lower-trust prompt/user that can call these tools can read .jsonl and .log files outside the configured Dynamic Context base directory. This issue has been patched in version 4.6.59.

PraisonAI is a multi-agent teams system. From version 3.8.1 to before version 4.6.59, PraisonAI's Dynamic Context module provides filesystem-backed history and terminal-log storage. The module also exports agent-callable tool factories. Those tools accept run_id and agent_id arguments from the tool caller. The underlying stores join those values into filesystem paths without rejecting absolute paths or .. traversal. Because run_id can be an absolute path and agent_id can contain traversal, a lower-trust prompt/user that can call these tools can read .jsonl and .log files outside the configured Dynamic Context base directory. This issue has been patched in version 4.6.59.

PraisonAI Dynamic Context history and terminal tools read files outside configured storage via path traversal

Summary

PraisonAI's Dynamic Context module provides filesystem-backed history and terminal-log storage. The SDK reference describes the module as providing:

• artifact storage for tool outputs, history, and terminal logs;
• history persistence with search; and
• terminal session logging.

The module also exports agent-callable tool factories:

• create_history_tools() returns history_search, history_tail, and history_get.
• create_terminal_tools() returns terminal_tail, terminal_grep, and terminal_commands.

Those tools accept run_id and agent_id arguments from the tool caller. The underlying stores join those values into filesystem paths without rejecting absolute paths or .. traversal:

history_dir = self.base_dir / run_id / "history"
return history_dir / f"{agent_id}.jsonl"

terminal_dir = self.base_dir / run_id / "terminal"
return terminal_dir / f"{agent_id}.log"

Because run_id can be an absolute path and agent_id can contain traversal, a lower-trust prompt/user that can call these tools can read .jsonl and .log files outside the configured Dynamic Context base directory.

Affected Product

• Repository: MervinPraison/PraisonAI
• Ecosystem: pip
• Package: praisonai
• Component: Dynamic Context history and terminal tools
• Current source paths:
  • src/praisonai/praisonai/context/history_store.py
  • src/praisonai/praisonai/context/terminal_logger.py
• Latest PyPI version validated: 4.6.58
• Current origin/main validated: 1ad58ca02975ff1398efeda694ea2ab78f20cf3e
• Current origin/main tag validated: v4.6.58

Suggested affected range:

pip:praisonai >= 3.8.1, <= 4.6.58

Representative local sweep:

• 3.8.1: vulnerable
• 4.0.0: vulnerable
• 4.5.113: vulnerable
• 4.6.33: vulnerable
• 4.6.34: vulnerable
• 4.6.40: vulnerable
• 4.6.50: vulnerable
• 4.6.58: vulnerable

Root Cause

HistoryStore._get_history_path() and TerminalLogger._get_log_path() treat logical identifiers as path segments, but never validate that the resolved path stays under base_dir.

History path construction:

def _get_history_path(self, run_id: str, agent_id: str) -> Path:
    history_dir = self.base_dir / run_id / "history"
    history_dir.mkdir(parents=True, exist_ok=True)
    return history_dir / f"{agent_id}.jsonl"

Terminal path construction:

def _get_log_path(self, run_id: str, agent_id: str) -> Path:
    terminal_dir = self.base_dir / run_id / "terminal"
    terminal_dir.mkdir(parents=True, exist_ok=True)
    return terminal_dir / f"{agent_id}.log"

The agent tools pass caller-controlled run_id and agent_id directly into these helpers:

def history_tail(agent_id: str = "default", run_id: str = "default", count: int = 10) -> str:
    messages = history_store.get_last_messages(agent_id=agent_id, run_id=run_id, count=count)

def terminal_tail(agent_id: str = "default", run_id: str = "default", lines: int = 50) -> str:
    return term_logger.tail_session(agent_id=agent_id, run_id=run_id, lines=lines)

There is no check equivalent to:

resolved = candidate.resolve()
base = self.base_dir.resolve()
resolved.relative_to(base)

There is also no identifier allowlist preventing /, \, or .. in run_id or agent_id.

Local PoV

Run against the latest PyPI package:

uv run --with 'praisonai==4.6.58' \
  python poc/pov_prai_cand_027_history_terminal_tools_path_traversal.py --json

The PoV:

1. Creates a temporary Dynamic Context base directory.
2. Creates a separate outside directory containing secret.jsonl and secret.log.
3. Creates legitimate in-base history and terminal log controls.
4. Calls history_tail() and history_get() with run_id=<outside-dir> and agent_id=../secret.
5. Calls terminal_tail() and…

PraisonAI Dynamic Context history and terminal tools read files outside configured storage via path traversal

Summary

PraisonAI's Dynamic Context module provides filesystem-backed history and terminal-log storage. The SDK reference describes the module as providing:

• artifact storage for tool outputs, history, and terminal logs;
• history persistence with search; and
• terminal session logging.

The module also exports agent-callable tool factories:

• create_history_tools() returns history_search, history_tail, and history_get.
• create_terminal_tools() returns terminal_tail, terminal_grep, and terminal_commands.

Those tools accept run_id and agent_id arguments from the tool caller. The underlying stores join those values into filesystem paths without rejecting absolute paths or .. traversal:

history_dir = self.base_dir / run_id / "history"
return history_dir / f"{agent_id}.jsonl"

terminal_dir = self.base_dir / run_id / "terminal"
return terminal_dir / f"{agent_id}.log"

Because run_id can be an absolute path and agent_id can contain traversal, a lower-trust prompt/user that can call these tools can read .jsonl and .log files outside the configured Dynamic Context base directory.

Affected Product

• Repository: MervinPraison/PraisonAI
• Ecosystem: pip
• Package: praisonai
• Component: Dynamic Context history and terminal tools
• Current source paths:
  • src/praisonai/praisonai/context/history_store.py
  • src/praisonai/praisonai/context/terminal_logger.py
• Latest PyPI version validated: 4.6.58
• Current origin/main validated: 1ad58ca02975ff1398efeda694ea2ab78f20cf3e
• Current origin/main tag validated: v4.6.58

Suggested affected range:

pip:praisonai >= 3.8.1, <= 4.6.58

Representative local sweep:

• 3.8.1: vulnerable
• 4.0.0: vulnerable
• 4.5.113: vulnerable
• 4.6.33: vulnerable
• 4.6.34: vulnerable
• 4.6.40: vulnerable
• 4.6.50: vulnerable
• 4.6.58: vulnerable

Root Cause

HistoryStore._get_history_path() and TerminalLogger._get_log_path() treat logical identifiers as path segments, but never validate that the resolved path stays under base_dir.

History path construction:

def _get_history_path(self, run_id: str, agent_id: str) -> Path:
    history_dir = self.base_dir / run_id / "history"
    history_dir.mkdir(parents=True, exist_ok=True)
    return history_dir / f"{agent_id}.jsonl"

Terminal path construction:

def _get_log_path(self, run_id: str, agent_id: str) -> Path:
    terminal_dir = self.base_dir / run_id / "terminal"
    terminal_dir.mkdir(parents=True, exist_ok=True)
    return terminal_dir / f"{agent_id}.log"

The agent tools pass caller-controlled run_id and agent_id directly into these helpers:

def history_tail(agent_id: str = "default", run_id: str = "default", count: int = 10) -> str:
    messages = history_store.get_last_messages(agent_id=agent_id, run_id=run_id, count=count)

def terminal_tail(agent_id: str = "default", run_id: str = "default", lines: int = 50) -> str:
    return term_logger.tail_session(agent_id=agent_id, run_id=run_id, lines=lines)

There is no check equivalent to:

resolved = candidate.resolve()
base = self.base_dir.resolve()
resolved.relative_to(base)

There is also no identifier allowlist preventing /, \, or .. in run_id or agent_id.

Local PoV

Run against the latest PyPI package:

uv run --with 'praisonai==4.6.58' \
  python poc/pov_prai_cand_027_history_terminal_tools_path_traversal.py --json

The PoV:

1. Creates a temporary Dynamic Context base directory.
2. Creates a separate outside directory containing secret.jsonl and secret.log.
3. Creates legitimate in-base history and terminal log controls.
4. Calls history_tail() and history_get() with run_id=<outside-dir> and agent_id=../secret.
5. Calls terminal_tail() and…