Repository navigation
v2.2.0
v2.2.0 — Existing Cases, Native ESI v2006, and More Reliable Repairs
Foam-Agent v2.2.0 expands the workflow to existing OpenFOAM cases, adds an explicit native ESI/OpenCFD v2006 target, and improves reference retrieval and error repair. Foundation OpenFOAM v10 remains the default.
Highlights
- Import and modify existing cases. Start from a case directory or ZIP archive with
--case_path, optionally provide a modification prompt, and use--case_subdirto select a case inside a multi-case archive. Imports keep anoriginal/copy, run inwork/, and write context and workflow logs underreport/. Source symlinks are rejected, and overwriting an existing managed output requires explicit opt-in. (#43) - Native ESI/OpenCFD v2006 support. Select
esi-v2006through--openfoam_targetorFOAMAGENT_OPENFOAM_TARGET. The target has its own tutorial corpus, FAISS indices, generation conventions, runtime checks, and Docker build. Both native targets share planning, meshing, execution, repair, visualization, and case-import services. (#43) - More focused retrieval and repair. Tutorial retrieval checks physical-domain compatibility and case-content consistency, with per-file reuse advice that respects user requirements and the selected target. Generated cases, imported cases, and mesh failures share a direct diagnosis-and-rewrite flow without a separate rewrite-plan call in the main repair loop. (#29)
- Stop repairs that make no progress. Repeated unchanged error states and failed repairs that produce no file changes terminate the loop, preserving the last attempt's files and logs. Mesh repairs return to meshing before rerunning the solver. (#29)
Model and Integration Updates
- Added the DeepSeek V4-Pro provider with thinking-mode support. (#31)
- Extended Codex authentication-cache lookup to the OpenClaw/Clawdbot auth-profile path.
- Made the Codex HTTP timeout configurable and increased the default from 60 to 300 seconds. (#36)
- Fixed MCP input generation to pass similar-case advice through to the initial writer. (#28)
Fixes and Documentation
- Excluded solver output directories from case scanning. (#42)
- Fixed relative case paths when running PyVista visualization scripts. (#34)
- Added generation guidance for required
*Finalsolver entries infvSolution. (#38) - Documented separate simulation and visualization outcomes: successful execution with failed visualization reports
partial_success. - Reorganized the README, usage and MCP guides, examples, and regression tests; updated the project citation to the CMAME publication.
Upgrade Notes
- Native
esi-v2006requires its matching OpenFOAM installation/image and target-specific corpus. The legacyFOAMAGENT_OPENFOAM_FORK=esitranslation mode is separate from the native target. - Run
git lfs pullto hydrate tutorial corpora and FAISS indices, and select an embedding model with matching indices. - Imported-case local runs clear previous run artifacts and nonzero time directories in
work/; they do not resume previous solver results. Keep the input copy inoriginal/. - The final repair workflow removes intermediate best-snapshot restoration and JSONL dataset-capture machinery.
- Docker startup still updates code by default. Set
FOAMAGENT_SKIP_UPDATE=1to keep the code bundled in the image.
Full Changelog: v2.1.0...b9f43fc