Skip to content

v2.2.0

Choose a tag to compare

@lingyue404 lingyue404 released this 01 Nov 01:55

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_subdir to select a case inside a multi-case archive. Imports keep an original/ copy, run in work/, and write context and workflow logs under report/. Source symlinks are rejected, and overwriting an existing managed output requires explicit opt-in. (#43)
  • Native ESI/OpenCFD v2006 support. Select esi-v2006 through --openfoam_target or FOAMAGENT_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 *Final solver entries in fvSolution. (#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-v2006 requires its matching OpenFOAM installation/image and target-specific corpus. The legacy FOAMAGENT_OPENFOAM_FORK=esi translation mode is separate from the native target.
  • Run git lfs pull to 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 in original/.
  • 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=1 to keep the code bundled in the image.

Full Changelog: v2.1.0...b9f43fc