用途：在持久化 bash 会话中运行命令，cd、环境变量与作业状态跨调用保留，适合多步骤工作流、构建项目等需要连续上下文的场景。
主要能力：状态持久化，设置变量或 cd 一次即可在后续命令复用；每次调用返回输出，末尾附 [exit=N cwd=… timed_out=…] 状态行。
使用方式：必填 command（单条 shell 命令，不是脚本）；可选 timeout（秒，默认 30，安装或构建可用 120–300）。每轮只执行一条命令，读取输出后再决定下一步。示例：{"name": "shell-session", "input": {"command": "cd /work && ls -la"}}；带超时示例：{"name": "shell-session", "input": {"command": "pip install -q requests", "timeout": 180}}。
限制：禁止运行交互式命令（vi、less、top、裸 python REPL），应改用非交互等价方式（cat、sed -i、python -c '…'）。声称成功前须确认 exit=0；若 timed_out=true，不要盲目重试，应诊断原因（延长超时或缩小命令范围）。