The agent that grows with you
Python aiai-agentai-agentsanthropicchatgptclaudeclaude-codecodexhermeshermes-agentllmnous-researchopenai
fix(skills): the sandbox document venv is built privately and published atomically
Tekniumdc82bec3bd4d
diff --git a/optional-skills/finance/excel-author/SKILL.md b/optional-skills/finance/excel-author/SKILL.mdindex 380e338c17d..3e789055a76 100644--- a/optional-skills/finance/excel-author/SKILL.md+++ b/optional-skills/finance/excel-author/SKILL.md@@ -38,9 +38,21 @@ python -c "import openpyxl" 2>/dev/null && PY=python || if command -v hermes >/dPY="$(hermes pm environment documents --extra documents --extra documents-pdf)"elsePY="$HOME/.cache/hermes-docs-venv/bin/python"- [ -x "$PY" ] || python3 -m venv "$HOME/.cache/hermes-docs-venv"- "$PY" -c "import docx, openpyxl, pptx, reportlab, pypdf, pdfplumber, pypdfium2" 2>/dev/null ||- "$PY" -m pip install -q --disable-pip-version-check python-docx==1.2.0 openpyxl==3.1.5 python-pptx==1.0.2 reportlab==5.1.0 pypdf==6.21.2 pdfplumber==0.11.10 pypdfium2==5.14.0+ "$PY" -c "import docx, openpyxl, pptx, reportlab, pypdf, pdfplumber, pypdfium2" 2>/dev/null || (+ # Safe to run from several agents at once: each caller builds a private venv,+ # a symlink publishes the first finished one atomically, the others delete theirs.+ mkdir -p "$HOME/.cache" && cd "$HOME/.cache" && stage="$(mktemp -d hermes-docs-venv.XXXXXX)" || exit 1+ old="$(readlink hermes-docs-venv)" # an earlier build that no longer imports, if any+ python3 -m venv "$stage" &&+ "$stage/bin/python" -m pip install -q --disable-pip-version-check python-docx==1.2.0 openpyxl==3.1.5 python-pptx==1.0.2 reportlab==5.1.0 pypdf==6.21.2 pdfplumber==0.11.10 pypdfium2==5.14.0 &&+ "$stage/bin/python" -c "import docx, openpyxl, pptx, reportlab, pypdf, pdfplumber, pypdfium2" &&+ if [ -z "$old" ]; then python3 -c 'import os, sys; os.symlink(*sys.argv[1:])' "$stage" hermes-docs-venv+ elif [ "$(readlink hermes-docs-venv)" = "$old" ]; then+ ln -s "$stage" "$stage.lnk" && python3 -c 'import os, sys; os.replace(*sys.argv[1:])' "$stage.lnk" hermes-docs-venv &&+ case "$old" in hermes-docs-venv.??????) rm -rf "$old" ;; esac+ fi 2>/dev/null+ [ "$(readlink hermes-docs-venv)" = "$stage" ] || rm -rf "$stage" "$stage.lnk"+ )fiexport PY```diff --git a/optional-skills/finance/pptx-author/SKILL.md b/optional-skills/finance/pptx-author/SKILL.mdindex b0f6d8a6c9c..fdeaaf3dde0 100644--- a/optional-skills/finance/pptx-author/SKILL.md+++ b/optional-skills/finance/pptx-author/SKILL.md@@ -39,9 +39,21 @@ python -c "import pptx" 2>/dev/null && PY=python || if command -v hermes >/dev/nPY="$(hermes pm environment documents --extra documents --extra documents-pdf)"elsePY="$HOME/.cache/hermes-docs-venv/bin/python"- [ -x "$PY" ] || python3 -m venv "$HOME/.cache/hermes-docs-venv"- "$PY" -c "import docx, openpyxl, pptx, reportlab, pypdf, pdfplumber, pypdfium2" 2>/dev/null ||- "$PY" -m pip install -q --disable-pip-version-check python-docx==1.2.0 openpyxl==3.1.5 python-pptx==1.0.2 reportlab==5.1.0 pypdf==6.21.2 pdfplumber==0.11.10 pypdfium2==5.14.0+ "$PY" -c "import docx, openpyxl, pptx, reportlab, pypdf, pdfplumber, pypdfium2" 2>/dev/null || (+ # Safe to run from several agents at once: each caller builds a private venv,+ # a symlink publishes the first finished one atomically, the others delete theirs.+ mkdir -p "$HOME/.cache" && cd "$HOME/.cache" && stage="$(mktemp -d hermes-docs-venv.XXXXXX)" || exit 1+ old="$(readlink hermes-docs-venv)" # an earlier build that no longer imports, if any+ python3 -m venv "$stage" &&+ "$stage/bin/python" -m pip install -q --disable-pip-version-check python-docx==1.2.0 openpyxl==3.1.5 python-pptx==1.0.2 reportlab==5.1.0 pypdf==6.21.2 pdfplumber==0.11.10 pypdfium2==5.14.0 &&+ "$stage/bin/python" -c "import docx, openpyxl, pptx, reportlab, pypdf, pdfplumber, pypdfium2" &&+ if [ -z "$old" ]; then python3 -c 'import os, sys; os.symlink(*sys.argv[1:])' "$stage" hermes-docs-venv+ elif [ "$(readlink hermes-docs-venv)" = "$old" ]; then+ ln -s "$stage" "$stage.lnk" && python3 -c 'import os, sys; os.replace(*sys.argv[1:])' "$stage.lnk" hermes-docs-venv &&+ case "$old" in hermes-docs-venv.??????) rm -rf "$old" ;; esac+ fi 2>/dev/null+ [ "$(readlink hermes-docs-venv)" = "$stage" ] || rm -rf "$stage" "$stage.lnk"+ )fiexport PY```diff --git a/skills/productivity/docx/SKILL.md b/skills/productivity/docx/SKILL.mdindex 84543a25337..67357e238dd 100644--- a/skills/productivity/docx/SKILL.md+++ b/skills/productivity/docx/SKILL.md@@ -51,9 +51,21 @@ fields, and package health checks. It does not render documents itselfPY="$(hermes pm environment documents --extra documents --extra documents-pdf)"elsePY="$HOME/.cache/hermes-docs-venv/bin/python"- [ -x "$PY" ] || python3 -m venv "$HOME/.cache/hermes-docs-venv"- "$PY" -c "import docx, openpyxl, pptx, reportlab, pypdf, pdfplumber, pypdfium2" 2>/dev/null ||- "$PY" -m pip install -q --disable-pip-version-check python-docx==1.2.0 openpyxl==3.1.5 python-pptx==1.0.2 reportlab==5.1.0 pypdf==6.21.2 pdfplumber==0.11.10 pypdfium2==5.14.0+ "$PY" -c "import docx, openpyxl, pptx, reportlab, pypdf, pdfplumber, pypdfium2" 2>/dev/null || (+ # Safe to run from several agents at once: each caller builds a private venv,+ # a symlink publishes the first finished one atomically, the others delete theirs.+ mkdir -p "$HOME/.cache" && cd "$HOME/.cache" && stage="$(mktemp -d hermes-docs-venv.XXXXXX)" || exit 1+ old="$(readlink hermes-docs-venv)" # an earlier build that no longer imports, if any+ python3 -m venv "$stage" &&+ "$stage/bin/python" -m pip install -q --disable-pip-version-check python-docx==1.2.0 openpyxl==3.1.5 python-pptx==1.0.2 reportlab==5.1.0 pypdf==6.21.2 pdfplumber==0.11.10 pypdfium2==5.14.0 &&+ "$stage/bin/python" -c "import docx, openpyxl, pptx, reportlab, pypdf, pdfplumber, pypdfium2" &&+ if [ -z "$old" ]; then python3 -c 'import os, sys; os.symlink(*sys.argv[1:])' "$stage" hermes-docs-venv+ elif [ "$(readlink hermes-docs-venv)" = "$old" ]; then+ ln -s "$stage" "$stage.lnk" && python3 -c 'import os, sys; os.replace(*sys.argv[1:])' "$stage.lnk" hermes-docs-venv &&+ case "$old" in hermes-docs-venv.??????) rm -rf "$old" ;; esac+ fi 2>/dev/null+ [ "$(readlink hermes-docs-venv)" = "$stage" ] || rm -rf "$stage" "$stage.lnk"+ )fiexport PY"$PY" scripts/docx_create.py --helpdiff --git a/skills/productivity/pdf/SKILL.md b/skills/productivity/pdf/SKILL.mdindex 42beb409a0b..94b2562d664 100644--- a/skills/productivity/pdf/SKILL.md+++ b/skills/productivity/pdf/SKILL.md@@ -46,9 +46,21 @@ Create PDFs from structured specs, build and fill AcroForm forms (with layout liPY="$(hermes pm environment documents --extra documents --extra documents-pdf)"elsePY="$HOME/.cache/hermes-docs-venv/bin/python"- [ -x "$PY" ] || python3 -m venv "$HOME/.cache/hermes-docs-venv"- "$PY" -c "import docx, openpyxl, pptx, reportlab, pypdf, pdfplumber, pypdfium2" 2>/dev/null ||- "$PY" -m pip install -q --disable-pip-version-check python-docx==1.2.0 openpyxl==3.1.5 python-pptx==1.0.2 reportlab==5.1.0 pypdf==6.21.2 pdfplumber==0.11.10 pypdfium2==5.14.0+ "$PY" -c "import docx, openpyxl, pptx, reportlab, pypdf, pdfplumber, pypdfium2" 2>/dev/null || (+ # Safe to run from several agents at once: each caller builds a private venv,+ # a symlink publishes the first finished one atomically, the others delete theirs.+ mkdir -p "$HOME/.cache" && cd "$HOME/.cache" && stage="$(mktemp -d hermes-docs-venv.XXXXXX)" || exit 1+ old="$(readlink hermes-docs-venv)" # an earlier build that no longer imports, if any+ python3 -m venv "$stage" &&+ "$stage/bin/python" -m pip install -q --disable-pip-version-check python-docx==1.2.0 openpyxl==3.1.5 python-pptx==1.0.2 reportlab==5.1.0 pypdf==6.21.2 pdfplumber==0.11.10 pypdfium2==5.14.0 &&+ "$stage/bin/python" -c "import docx, openpyxl, pptx, reportlab, pypdf, pdfplumber, pypdfium2" &&+ if [ -z "$old" ]; then python3 -c 'import os, sys; os.symlink(*sys.argv[1:])' "$stage" hermes-docs-venv+ elif [ "$(readlink hermes-docs-venv)" = "$old" ]; then+ ln -s "$stage" "$stage.lnk" && python3 -c 'import os, sys; os.replace(*sys.argv[1:])' "$stage.lnk" hermes-docs-venv &&+ case "$old" in hermes-docs-venv.??????) rm -rf "$old" ;; esac+ fi 2>/dev/null+ [ "$(readlink hermes-docs-venv)" = "$stage" ] || rm -rf "$stage" "$stage.lnk"+ )fiexport PY"$PY" scripts/pdf_create.py --helpdiff --git a/skills/productivity/pdf/references/ocr-extraction.md b/skills/productivity/pdf/references/ocr-extraction.mdindex d2a07b24005..b63e999fa6f 100644--- a/skills/productivity/pdf/references/ocr-extraction.md+++ b/skills/productivity/pdf/references/ocr-extraction.md@@ -62,8 +62,20 @@ if command -v hermes >/dev/null 2>&1; thenPY="$(hermes pm environment pdf-pymupdf --requirement 'pymupdf>=1.26,<3' --requirement 'pymupdf4llm>=0.2,<3')"elsePY="$HOME/.cache/hermes-pdf-pymupdf-venv/bin/python"- [ -x "$PY" ] || python3 -m venv "$HOME/.cache/hermes-pdf-pymupdf-venv"- "$PY" -c "import pymupdf, pymupdf4llm" 2>/dev/null || "$PY" -m pip install -q --disable-pip-version-check 'pymupdf>=1.26,<3' 'pymupdf4llm>=0.2,<3'+ "$PY" -c "import pymupdf, pymupdf4llm" 2>/dev/null || (+ # concurrency-safe build: see the documents block in SKILL.md+ mkdir -p "$HOME/.cache" && cd "$HOME/.cache" && stage="$(mktemp -d hermes-pdf-pymupdf-venv.XXXXXX)" || exit 1+ old="$(readlink hermes-pdf-pymupdf-venv)" # an earlier build that no longer imports, if any+ python3 -m venv "$stage" &&+ "$stage/bin/python" -m pip install -q --disable-pip-version-check 'pymupdf>=1.26,<3' 'pymupdf4llm>=0.2,<3' &&+ "$stage/bin/python" -c "import pymupdf, pymupdf4llm" &&+ if [ -z "$old" ]; then python3 -c 'import os, sys; os.symlink(*sys.argv[1:])' "$stage" hermes-pdf-pymupdf-venv+ elif [ "$(readlink hermes-pdf-pymupdf-venv)" = "$old" ]; then+ ln -s "$stage" "$stage.lnk" && python3 -c 'import os, sys; os.replace(*sys.argv[1:])' "$stage.lnk" hermes-pdf-pymupdf-venv &&+ case "$old" in hermes-pdf-pymupdf-venv.??????) rm -rf "$old" ;; esac+ fi 2>/dev/null+ [ "$(readlink hermes-pdf-pymupdf-venv)" = "$stage" ] || rm -rf "$stage" "$stage.lnk"+ )fi```@@ -100,8 +112,20 @@ if command -v hermes >/dev/null 2>&1; thenPY="$(hermes pm environment pdf-marker --requirement 'marker-pdf>=1.8,<3')"elsePY="$HOME/.cache/hermes-pdf-marker-venv/bin/python"- [ -x "$PY" ] || python3 -m venv "$HOME/.cache/hermes-pdf-marker-venv"- "$PY" -c "import marker" 2>/dev/null || "$PY" -m pip install -q --disable-pip-version-check 'marker-pdf>=1.8,<3'+ "$PY" -c "import marker" 2>/dev/null || (+ # concurrency-safe build: see the documents block in SKILL.md+ mkdir -p "$HOME/.cache" && cd "$HOME/.cache" && stage="$(mktemp -d hermes-pdf-marker-venv.XXXXXX)" || exit 1+ old="$(readlink hermes-pdf-marker-venv)" # an earlier build that no longer imports, if any+ python3 -m venv "$stage" &&+ "$stage/bin/python" -m pip install -q --disable-pip-version-check 'marker-pdf>=1.8,<3' &&+ "$stage/bin/python" -c "import marker" &&+ if [ -z "$old" ]; then python3 -c 'import os, sys; os.symlink(*sys.argv[1:])' "$stage" hermes-pdf-marker-venv+ elif [ "$(readlink hermes-pdf-marker-venv)" = "$old" ]; then+ ln -s "$stage" "$stage.lnk" && python3 -c 'import os, sys; os.replace(*sys.argv[1:])' "$stage.lnk" hermes-pdf-marker-venv &&+ case "$old" in hermes-pdf-marker-venv.??????) rm -rf "$old" ;; esac+ fi 2>/dev/null+ [ "$(readlink hermes-pdf-marker-venv)" = "$stage" ] || rm -rf "$stage" "$stage.lnk"+ )fi```diff --git a/skills/productivity/powerpoint/SKILL.md b/skills/productivity/powerpoint/SKILL.mdindex 7e2c2ef916b..f571fb1195f 100644--- a/skills/productivity/powerpoint/SKILL.md+++ b/skills/productivity/powerpoint/SKILL.md@@ -48,9 +48,21 @@ and slide rendering — all offline, no PowerPoint installation required.PY="$(hermes pm environment documents --extra documents --extra documents-pdf)"elsePY="$HOME/.cache/hermes-docs-venv/bin/python"- [ -x "$PY" ] || python3 -m venv "$HOME/.cache/hermes-docs-venv"- "$PY" -c "import docx, openpyxl, pptx, reportlab, pypdf, pdfplumber, pypdfium2" 2>/dev/null ||- "$PY" -m pip install -q --disable-pip-version-check python-docx==1.2.0 openpyxl==3.1.5 python-pptx==1.0.2 reportlab==5.1.0 pypdf==6.21.2 pdfplumber==0.11.10 pypdfium2==5.14.0+ "$PY" -c "import docx, openpyxl, pptx, reportlab, pypdf, pdfplumber, pypdfium2" 2>/dev/null || (+ # Safe to run from several agents at once: each caller builds a private venv,+ # a symlink publishes the first finished one atomically, the others delete theirs.+ mkdir -p "$HOME/.cache" && cd "$HOME/.cache" && stage="$(mktemp -d hermes-docs-venv.XXXXXX)" || exit 1+ old="$(readlink hermes-docs-venv)" # an earlier build that no longer imports, if any+ python3 -m venv "$stage" &&+ "$stage/bin/python" -m pip install -q --disable-pip-version-check python-docx==1.2.0 openpyxl==3.1.5 python-pptx==1.0.2 reportlab==5.1.0 pypdf==6.21.2 pdfplumber==0.11.10 pypdfium2==5.14.0 &&+ "$stage/bin/python" -c "import docx, openpyxl, pptx, reportlab, pypdf, pdfplumber, pypdfium2" &&+ if [ -z "$old" ]; then python3 -c 'import os, sys; os.symlink(*sys.argv[1:])' "$stage" hermes-docs-venv+ elif [ "$(readlink hermes-docs-venv)" = "$old" ]; then+ ln -s "$stage" "$stage.lnk" && python3 -c 'import os, sys; os.replace(*sys.argv[1:])' "$stage.lnk" hermes-docs-venv &&+ case "$old" in hermes-docs-venv.??????) rm -rf "$old" ;; esac+ fi 2>/dev/null+ [ "$(readlink hermes-docs-venv)" = "$stage" ] || rm -rf "$stage" "$stage.lnk"+ )fiexport PY"$PY" scripts/pptx_create.py --helpdiff --git a/skills/productivity/xlsx/SKILL.md b/skills/productivity/xlsx/SKILL.mdindex 9c6480e1415..8475becaae3 100644--- a/skills/productivity/xlsx/SKILL.md+++ b/skills/productivity/xlsx/SKILL.md@@ -54,9 +54,21 @@ scripts are argparse CLIs that print JSON and use explicit UTF-8 I/O.PY="$(hermes pm environment documents --extra documents --extra documents-pdf)"elsePY="$HOME/.cache/hermes-docs-venv/bin/python"- [ -x "$PY" ] || python3 -m venv "$HOME/.cache/hermes-docs-venv"- "$PY" -c "import docx, openpyxl, pptx, reportlab, pypdf, pdfplumber, pypdfium2" 2>/dev/null ||- "$PY" -m pip install -q --disable-pip-version-check python-docx==1.2.0 openpyxl==3.1.5 python-pptx==1.0.2 reportlab==5.1.0 pypdf==6.21.2 pdfplumber==0.11.10 pypdfium2==5.14.0+ "$PY" -c "import docx, openpyxl, pptx, reportlab, pypdf, pdfplumber, pypdfium2" 2>/dev/null || (+ # Safe to run from several agents at once: each caller builds a private venv,+ # a symlink publishes the first finished one atomically, the others delete theirs.+ mkdir -p "$HOME/.cache" && cd "$HOME/.cache" && stage="$(mktemp -d hermes-docs-venv.XXXXXX)" || exit 1+ old="$(readlink hermes-docs-venv)" # an earlier build that no longer imports, if any+ python3 -m venv "$stage" &&+ "$stage/bin/python" -m pip install -q --disable-pip-version-check python-docx==1.2.0 openpyxl==3.1.5 python-pptx==1.0.2 reportlab==5.1.0 pypdf==6.21.2 pdfplumber==0.11.10 pypdfium2==5.14.0 &&+ "$stage/bin/python" -c "import docx, openpyxl, pptx, reportlab, pypdf, pdfplumber, pypdfium2" &&+ if [ -z "$old" ]; then python3 -c 'import os, sys; os.symlink(*sys.argv[1:])' "$stage" hermes-docs-venv+ elif [ "$(readlink hermes-docs-venv)" = "$old" ]; then+ ln -s "$stage" "$stage.lnk" && python3 -c 'import os, sys; os.replace(*sys.argv[1:])' "$stage.lnk" hermes-docs-venv &&+ case "$old" in hermes-docs-venv.??????) rm -rf "$old" ;; esac+ fi 2>/dev/null+ [ "$(readlink hermes-docs-venv)" = "$stage" ] || rm -rf "$stage" "$stage.lnk"+ )fiexport PY"$PY" scripts/xlsx_create.py --helpdiff --git a/website/docs/user-guide/skills/bundled/productivity/productivity-docx.md b/website/docs/user-guide/skills/bundled/productivity/productivity-docx.mdindex 7a807c1d62e..d472dc868ff 100644--- a/website/docs/user-guide/skills/bundled/productivity/productivity-docx.md+++ b/website/docs/user-guide/skills/bundled/productivity/productivity-docx.md@@ -68,9 +68,21 @@ fields, and package health checks. It does not render documents itselfPY="$(hermes pm environment documents --extra documents --extra documents-pdf)"elsePY="$HOME/.cache/hermes-docs-venv/bin/python"- [ -x "$PY" ] || python3 -m venv "$HOME/.cache/hermes-docs-venv"- "$PY" -c "import docx, openpyxl, pptx, reportlab, pypdf, pdfplumber, pypdfium2" 2>/dev/null ||- "$PY" -m pip install -q --disable-pip-version-check python-docx==1.2.0 openpyxl==3.1.5 python-pptx==1.0.2 reportlab==5.1.0 pypdf==6.21.2 pdfplumber==0.11.10 pypdfium2==5.14.0+ "$PY" -c "import docx, openpyxl, pptx, reportlab, pypdf, pdfplumber, pypdfium2" 2>/dev/null || (+ # Safe to run from several agents at once: each caller builds a private venv,+ # a symlink publishes the first finished one atomically, the others delete theirs.+ mkdir -p "$HOME/.cache" && cd "$HOME/.cache" && stage="$(mktemp -d hermes-docs-venv.XXXXXX)" || exit 1+ old="$(readlink hermes-docs-venv)" # an earlier build that no longer imports, if any+ python3 -m venv "$stage" &&+ "$stage/bin/python" -m pip install -q --disable-pip-version-check python-docx==1.2.0 openpyxl==3.1.5 python-pptx==1.0.2 reportlab==5.1.0 pypdf==6.21.2 pdfplumber==0.11.10 pypdfium2==5.14.0 &&+ "$stage/bin/python" -c "import docx, openpyxl, pptx, reportlab, pypdf, pdfplumber, pypdfium2" &&+ if [ -z "$old" ]; then python3 -c 'import os, sys; os.symlink(*sys.argv[1:])' "$stage" hermes-docs-venv+ elif [ "$(readlink hermes-docs-venv)" = "$old" ]; then+ ln -s "$stage" "$stage.lnk" && python3 -c 'import os, sys; os.replace(*sys.argv[1:])' "$stage.lnk" hermes-docs-venv &&+ case "$old" in hermes-docs-venv.??????) rm -rf "$old" ;; esac+ fi 2>/dev/null+ [ "$(readlink hermes-docs-venv)" = "$stage" ] || rm -rf "$stage" "$stage.lnk"+ )fiexport PY"$PY" scripts/docx_create.py --helpdiff --git a/website/docs/user-guide/skills/bundled/productivity/productivity-pdf.md b/website/docs/user-guide/skills/bundled/productivity/productivity-pdf.mdindex 8cf273276a8..6211679539e 100644--- a/website/docs/user-guide/skills/bundled/productivity/productivity-pdf.md+++ b/website/docs/user-guide/skills/bundled/productivity/productivity-pdf.md@@ -63,9 +63,21 @@ Create PDFs from structured specs, build and fill AcroForm forms (with layout liPY="$(hermes pm environment documents --extra documents --extra documents-pdf)"elsePY="$HOME/.cache/hermes-docs-venv/bin/python"- [ -x "$PY" ] || python3 -m venv "$HOME/.cache/hermes-docs-venv"- "$PY" -c "import docx, openpyxl, pptx, reportlab, pypdf, pdfplumber, pypdfium2" 2>/dev/null ||- "$PY" -m pip install -q --disable-pip-version-check python-docx==1.2.0 openpyxl==3.1.5 python-pptx==1.0.2 reportlab==5.1.0 pypdf==6.21.2 pdfplumber==0.11.10 pypdfium2==5.14.0+ "$PY" -c "import docx, openpyxl, pptx, reportlab, pypdf, pdfplumber, pypdfium2" 2>/dev/null || (+ # Safe to run from several agents at once: each caller builds a private venv,+ # a symlink publishes the first finished one atomically, the others delete theirs.+ mkdir -p "$HOME/.cache" && cd "$HOME/.cache" && stage="$(mktemp -d hermes-docs-venv.XXXXXX)" || exit 1+ old="$(readlink hermes-docs-venv)" # an earlier build that no longer imports, if any+ python3 -m venv "$stage" &&+ "$stage/bin/python" -m pip install -q --disable-pip-version-check python-docx==1.2.0 openpyxl==3.1.5 python-pptx==1.0.2 reportlab==5.1.0 pypdf==6.21.2 pdfplumber==0.11.10 pypdfium2==5.14.0 &&+ "$stage/bin/python" -c "import docx, openpyxl, pptx, reportlab, pypdf, pdfplumber, pypdfium2" &&+ if [ -z "$old" ]; then python3 -c 'import os, sys; os.symlink(*sys.argv[1:])' "$stage" hermes-docs-venv+ elif [ "$(readlink hermes-docs-venv)" = "$old" ]; then+ ln -s "$stage" "$stage.lnk" && python3 -c 'import os, sys; os.replace(*sys.argv[1:])' "$stage.lnk" hermes-docs-venv &&+ case "$old" in hermes-docs-venv.??????) rm -rf "$old" ;; esac+ fi 2>/dev/null+ [ "$(readlink hermes-docs-venv)" = "$stage" ] || rm -rf "$stage" "$stage.lnk"+ )fiexport PY"$PY" scripts/pdf_create.py --helpdiff --git a/website/docs/user-guide/skills/bundled/productivity/productivity-powerpoint.md b/website/docs/user-guide/skills/bundled/productivity/productivity-powerpoint.mdindex 9fff4c775af..039533945e3 100644--- a/website/docs/user-guide/skills/bundled/productivity/productivity-powerpoint.md+++ b/website/docs/user-guide/skills/bundled/productivity/productivity-powerpoint.md@@ -65,9 +65,21 @@ and slide rendering — all offline, no PowerPoint installation required.PY="$(hermes pm environment documents --extra documents --extra documents-pdf)"elsePY="$HOME/.cache/hermes-docs-venv/bin/python"- [ -x "$PY" ] || python3 -m venv "$HOME/.cache/hermes-docs-venv"- "$PY" -c "import docx, openpyxl, pptx, reportlab, pypdf, pdfplumber, pypdfium2" 2>/dev/null ||- "$PY" -m pip install -q --disable-pip-version-check python-docx==1.2.0 openpyxl==3.1.5 python-pptx==1.0.2 reportlab==5.1.0 pypdf==6.21.2 pdfplumber==0.11.10 pypdfium2==5.14.0+ "$PY" -c "import docx, openpyxl, pptx, reportlab, pypdf, pdfplumber, pypdfium2" 2>/dev/null || (+ # Safe to run from several agents at once: each caller builds a private venv,+ # a symlink publishes the first finished one atomically, the others delete theirs.+ mkdir -p "$HOME/.cache" && cd "$HOME/.cache" && stage="$(mktemp -d hermes-docs-venv.XXXXXX)" || exit 1+ old="$(readlink hermes-docs-venv)" # an earlier build that no longer imports, if any+ python3 -m venv "$stage" &&+ "$stage/bin/python" -m pip install -q --disable-pip-version-check python-docx==1.2.0 openpyxl==3.1.5 python-pptx==1.0.2 reportlab==5.1.0 pypdf==6.21.2 pdfplumber==0.11.10 pypdfium2==5.14.0 &&+ "$stage/bin/python" -c "import docx, openpyxl, pptx, reportlab, pypdf, pdfplumber, pypdfium2" &&+ if [ -z "$old" ]; then python3 -c 'import os, sys; os.symlink(*sys.argv[1:])' "$stage" hermes-docs-venv+ elif [ "$(readlink hermes-docs-venv)" = "$old" ]; then+ ln -s "$stage" "$stage.lnk" && python3 -c 'import os, sys; os.replace(*sys.argv[1:])' "$stage.lnk" hermes-docs-venv &&+ case "$old" in hermes-docs-venv.??????) rm -rf "$old" ;; esac+ fi 2>/dev/null+ [ "$(readlink hermes-docs-venv)" = "$stage" ] || rm -rf "$stage" "$stage.lnk"+ )fiexport PY"$PY" scripts/pptx_create.py --helpdiff --git a/website/docs/user-guide/skills/bundled/productivity/productivity-xlsx.md b/website/docs/user-guide/skills/bundled/productivity/productivity-xlsx.mdindex c233d422a64..8aa3e300605 100644--- a/website/docs/user-guide/skills/bundled/productivity/productivity-xlsx.md+++ b/website/docs/user-guide/skills/bundled/productivity/productivity-xlsx.md@@ -71,9 +71,21 @@ scripts are argparse CLIs that print JSON and use explicit UTF-8 I/O.PY="$(hermes pm environment documents --extra documents --extra documents-pdf)"elsePY="$HOME/.cache/hermes-docs-venv/bin/python"- [ -x "$PY" ] || python3 -m venv "$HOME/.cache/hermes-docs-venv"- "$PY" -c "import docx, openpyxl, pptx, reportlab, pypdf, pdfplumber, pypdfium2" 2>/dev/null ||- "$PY" -m pip install -q --disable-pip-version-check python-docx==1.2.0 openpyxl==3.1.5 python-pptx==1.0.2 reportlab==5.1.0 pypdf==6.21.2 pdfplumber==0.11.10 pypdfium2==5.14.0+ "$PY" -c "import docx, openpyxl, pptx, reportlab, pypdf, pdfplumber, pypdfium2" 2>/dev/null || (+ # Safe to run from several agents at once: each caller builds a private venv,+ # a symlink publishes the first finished one atomically, the others delete theirs.+ mkdir -p "$HOME/.cache" && cd "$HOME/.cache" && stage="$(mktemp -d hermes-docs-venv.XXXXXX)" || exit 1+ old="$(readlink hermes-docs-venv)" # an earlier build that no longer imports, if any+ python3 -m venv "$stage" &&+ "$stage/bin/python" -m pip install -q --disable-pip-version-check python-docx==1.2.0 openpyxl==3.1.5 python-pptx==1.0.2 reportlab==5.1.0 pypdf==6.21.2 pdfplumber==0.11.10 pypdfium2==5.14.0 &&+ "$stage/bin/python" -c "import docx, openpyxl, pptx, reportlab, pypdf, pdfplumber, pypdfium2" &&+ if [ -z "$old" ]; then python3 -c 'import os, sys; os.symlink(*sys.argv[1:])' "$stage" hermes-docs-venv+ elif [ "$(readlink hermes-docs-venv)" = "$old" ]; then+ ln -s "$stage" "$stage.lnk" && python3 -c 'import os, sys; os.replace(*sys.argv[1:])' "$stage.lnk" hermes-docs-venv &&+ case "$old" in hermes-docs-venv.??????) rm -rf "$old" ;; esac+ fi 2>/dev/null+ [ "$(readlink hermes-docs-venv)" = "$stage" ] || rm -rf "$stage" "$stage.lnk"+ )fiexport PY"$PY" scripts/xlsx_create.py --helpdiff --git a/website/docs/user-guide/skills/optional/finance/finance-excel-author.md b/website/docs/user-guide/skills/optional/finance/finance-excel-author.mdindex 29b813bc74e..729add34ec6 100644--- a/website/docs/user-guide/skills/optional/finance/finance-excel-author.md+++ b/website/docs/user-guide/skills/optional/finance/finance-excel-author.md@@ -56,9 +56,21 @@ python -c "import openpyxl" 2>/dev/null && PY=python || if command -v hermes >/dPY="$(hermes pm environment documents --extra documents --extra documents-pdf)"elsePY="$HOME/.cache/hermes-docs-venv/bin/python"- [ -x "$PY" ] || python3 -m venv "$HOME/.cache/hermes-docs-venv"- "$PY" -c "import docx, openpyxl, pptx, reportlab, pypdf, pdfplumber, pypdfium2" 2>/dev/null ||- "$PY" -m pip install -q --disable-pip-version-check python-docx==1.2.0 openpyxl==3.1.5 python-pptx==1.0.2 reportlab==5.1.0 pypdf==6.21.2 pdfplumber==0.11.10 pypdfium2==5.14.0+ "$PY" -c "import docx, openpyxl, pptx, reportlab, pypdf, pdfplumber, pypdfium2" 2>/dev/null || (+ # Safe to run from several agents at once: each caller builds a private venv,+ # a symlink publishes the first finished one atomically, the others delete theirs.+ mkdir -p "$HOME/.cache" && cd "$HOME/.cache" && stage="$(mktemp -d hermes-docs-venv.XXXXXX)" || exit 1+ old="$(readlink hermes-docs-venv)" # an earlier build that no longer imports, if any+ python3 -m venv "$stage" &&+ "$stage/bin/python" -m pip install -q --disable-pip-version-check python-docx==1.2.0 openpyxl==3.1.5 python-pptx==1.0.2 reportlab==5.1.0 pypdf==6.21.2 pdfplumber==0.11.10 pypdfium2==5.14.0 &&+ "$stage/bin/python" -c "import docx, openpyxl, pptx, reportlab, pypdf, pdfplumber, pypdfium2" &&+ if [ -z "$old" ]; then python3 -c 'import os, sys; os.symlink(*sys.argv[1:])' "$stage" hermes-docs-venv+ elif [ "$(readlink hermes-docs-venv)" = "$old" ]; then+ ln -s "$stage" "$stage.lnk" && python3 -c 'import os, sys; os.replace(*sys.argv[1:])' "$stage.lnk" hermes-docs-venv &&+ case "$old" in hermes-docs-venv.??????) rm -rf "$old" ;; esac+ fi 2>/dev/null+ [ "$(readlink hermes-docs-venv)" = "$stage" ] || rm -rf "$stage" "$stage.lnk"+ )fiexport PY```diff --git a/website/docs/user-guide/skills/optional/finance/finance-pptx-author.md b/website/docs/user-guide/skills/optional/finance/finance-pptx-author.mdindex 9f346c2f9ae..8c3e80e05d7 100644--- a/website/docs/user-guide/skills/optional/finance/finance-pptx-author.md+++ b/website/docs/user-guide/skills/optional/finance/finance-pptx-author.md@@ -57,9 +57,21 @@ python -c "import pptx" 2>/dev/null && PY=python || if command -v hermes >/dev/nPY="$(hermes pm environment documents --extra documents --extra documents-pdf)"elsePY="$HOME/.cache/hermes-docs-venv/bin/python"- [ -x "$PY" ] || python3 -m venv "$HOME/.cache/hermes-docs-venv"- "$PY" -c "import docx, openpyxl, pptx, reportlab, pypdf, pdfplumber, pypdfium2" 2>/dev/null ||- "$PY" -m pip install -q --disable-pip-version-check python-docx==1.2.0 openpyxl==3.1.5 python-pptx==1.0.2 reportlab==5.1.0 pypdf==6.21.2 pdfplumber==0.11.10 pypdfium2==5.14.0+ "$PY" -c "import docx, openpyxl, pptx, reportlab, pypdf, pdfplumber, pypdfium2" 2>/dev/null || (+ # Safe to run from several agents at once: each caller builds a private venv,+ # a symlink publishes the first finished one atomically, the others delete theirs.+ mkdir -p "$HOME/.cache" && cd "$HOME/.cache" && stage="$(mktemp -d hermes-docs-venv.XXXXXX)" || exit 1+ old="$(readlink hermes-docs-venv)" # an earlier build that no longer imports, if any+ python3 -m venv "$stage" &&+ "$stage/bin/python" -m pip install -q --disable-pip-version-check python-docx==1.2.0 openpyxl==3.1.5 python-pptx==1.0.2 reportlab==5.1.0 pypdf==6.21.2 pdfplumber==0.11.10 pypdfium2==5.14.0 &&+ "$stage/bin/python" -c "import docx, openpyxl, pptx, reportlab, pypdf, pdfplumber, pypdfium2" &&+ if [ -z "$old" ]; then python3 -c 'import os, sys; os.symlink(*sys.argv[1:])' "$stage" hermes-docs-venv+ elif [ "$(readlink hermes-docs-venv)" = "$old" ]; then+ ln -s "$stage" "$stage.lnk" && python3 -c 'import os, sys; os.replace(*sys.argv[1:])' "$stage.lnk" hermes-docs-venv &&+ case "$old" in hermes-docs-venv.??????) rm -rf "$old" ;; esac+ fi 2>/dev/null+ [ "$(readlink hermes-docs-venv)" = "$stage" ] || rm -rf "$stage" "$stage.lnk"+ )fiexport PY```