hermes-agent 0.21.5 → 0.21.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -108,7 +108,8 @@ upstream `HERMES_HOME`, as they still do now.
108
108
  Starting with `0.20.0`:
109
109
 
110
110
  - PyPI is not used to install Hermes Agent itself;
111
- - `uv` downloads an isolated managed Python 3.11 runtime;
111
+ - `uv` downloads the isolated managed Python version pinned in the npm package
112
+ metadata;
112
113
  - upstream source is checked out at the exact GitHub Release tag and commit;
113
114
  - dependencies are synchronized from upstream `uv.lock`;
114
115
  - `hermes update` remains the native upstream rolling updater;
@@ -236,6 +237,19 @@ Running `npm rebuild` for the same package version instead
236
237
  preserves an existing native-updated checkout and only resynchronizes its
237
238
  environment.
238
239
 
240
+ ### Python 3.14 in release 0.21.6
241
+
242
+ Upstream `v0.21.6` locks dependencies for Python 3.14. The corresponding npm
243
+ release downloads a managed Python 3.14 runtime with `uv`; a system Python 3.14
244
+ installation is not required.
245
+
246
+ If an existing npm installation uses Python 3.11, run `hermes-npm update` after
247
+ `hermes-agent@0.21.6` is published. Updating the npm package replaces its
248
+ package-local checkout and venv, then creates a new Python 3.14 venv from the
249
+ upstream lockfile. Configuration, credentials, sessions, and other data under
250
+ `HERMES_HOME` remain in place. Rebuilding the old npm version does not perform
251
+ this transition.
252
+
239
253
  For automation and agents, `hermes-npm status --json` is the canonical
240
254
  machine-readable note. Child processes also receive:
241
255
 
@@ -278,8 +292,8 @@ The handoff:
278
292
  5. verifies the resulting Git commit and venv `hermes` executable;
279
293
  6. only after successful verification, removes the npm package in its detected
280
294
  local or global scope;
281
- 7. re-runs only the official installer's idempotent `path` stage from the new
282
- checkout, so a global npm uninstall cannot delete an official launcher when
295
+ 7. re-runs the release's official command publication stage from the new checkout,
296
+ so a global npm uninstall cannot delete an official launcher when
283
297
  both installations use the same bin directory.
284
298
 
285
299
  Configuration, credentials, sessions, memories, skills, and other user state
@@ -353,8 +367,8 @@ then install the exact checked canonical version.
353
367
  Linux libc variant.
354
368
  5. Verifies the `uv` archive against a SHA-256 digest committed in
355
369
  `lib/uv-installer.js` and extracts only the executable.
356
- 6. Creates an `uv`-managed Python 3.11 installation and `venv/` inside the
357
- upstream checkout.
370
+ 6. Creates an `uv`-managed Python installation at the version pinned in the npm
371
+ package metadata and `venv/` inside the upstream checkout.
358
372
  7. Runs `uv sync --frozen --extra all --no-dev` using upstream project
359
373
  configuration and `uv.lock`.
360
374
  8. Deletes the temporary dependency cache and writes a runtime marker.
@@ -414,7 +428,8 @@ The publish workflow polls once per hour and also supports manual
414
428
  non-prerelease upstream GitHub Release once and then:
415
429
 
416
430
  1. resolves annotated tags to their final commit SHA;
417
- 2. reads `project.version` from `pyproject.toml` at that exact commit;
431
+ 2. reads `project.version` from `pyproject.toml` at that exact commit, or uses
432
+ the semantic Release tag when upstream leaves `project.version` at `0.0.0`;
418
433
  3. passes the validated tag, commit, version, and description to smoke and
419
434
  publish jobs for deterministic offline metadata application;
420
435
  4. refuses to reuse an npm version if its published tag/commit mapping differs;
@@ -337,7 +337,7 @@ Native rolling changes are replaced by the next npm Release update.`);
337
337
  hermes-npm migrate upstream --yes
338
338
  Run the pinned official installer non-interactively, verify its exact
339
339
  Release commit and venv command, uninstall this npm package, then re-run
340
- the official PATH stage so command ownership is unambiguous.
340
+ the release's official command publication stage so ownership is unambiguous.
341
341
 
342
342
  The handoff uses the existing HERMES_HOME (or its platform default), preserves
343
343
  user data, and transfers command/update ownership to upstream. It is one-way;
@@ -382,7 +382,7 @@ Execution will run the pinned upstream installer with setup/gateway prompts
382
382
  disabled, verify the exact commit and venv command, and only then run:
383
383
  npm ${plan.npmUninstall.args.join(" ")}
384
384
 
385
- It finishes by re-running the official installer's PATH stage from the verified
385
+ It finishes by re-running the official command publication stage from the verified
386
386
  external checkout, after npm has removed its own shims.
387
387
 
388
388
  User configuration and state under HERMES_HOME are preserved. Stop gateways,
@@ -79,6 +79,7 @@ function getUpstreamInstallerInvocation(plan, platform = process.platform) {
79
79
 
80
80
  function getUpstreamPathInvocation(plan, platform = process.platform) {
81
81
  const paths = platformPath(platform);
82
+ const stage = plan.installerFinalizeStage || "path";
82
83
  const installedScript = platform === "win32"
83
84
  ? paths.join(plan.installDirectory, "scripts", "install.ps1")
84
85
  : paths.join(plan.installDirectory, "scripts", "install.sh");
@@ -89,7 +90,7 @@ function getUpstreamPathInvocation(plan, platform = process.platform) {
89
90
  "-NoProfile",
90
91
  "-ExecutionPolicy", "Bypass",
91
92
  "-File", installedScript,
92
- "-Stage", "path",
93
+ "-Stage", stage,
93
94
  "-NonInteractive",
94
95
  "-InstallDir", plan.installDirectory,
95
96
  "-HermesHome", plan.hermesHome
@@ -100,7 +101,7 @@ function getUpstreamPathInvocation(plan, platform = process.platform) {
100
101
  command: "bash",
101
102
  args: [
102
103
  installedScript,
103
- "--stage", "path",
104
+ "--stage", stage,
104
105
  "--non-interactive",
105
106
  "--dir", plan.installDirectory,
106
107
  "--hermes-home", plan.hermesHome
@@ -133,6 +134,7 @@ function createUpstreamMigrationPlan(context, options = {}) {
133
134
  npmVersion: packageJson.version,
134
135
  upstreamRelease: packageJson.hermesAgent.upstreamGitTag,
135
136
  upstreamCommit: packageJson.hermesAgent.upstreamCommit,
137
+ installerFinalizeStage: packageJson.hermesAgent.installerFinalizeStage || "path",
136
138
  hermesHome,
137
139
  installDirectory,
138
140
  installerPath,
@@ -298,8 +300,8 @@ async function executeUpstreamMigration(plan, helpers) {
298
300
  });
299
301
  } catch (error) {
300
302
  const state = uninstallError
301
- ? "npm removal failed and the official command PATH stage also failed"
302
- : "npm ownership was removed, but the official command PATH stage failed";
303
+ ? "npm removal failed and the official products stage also failed"
304
+ : "npm ownership was removed, but the official products stage failed";
303
305
  throw new Error(
304
306
  `${state}: ${error.message}. ` +
305
307
  `Run ${formatInvocation(plan.finalizePath, plan.platform)} manually.`
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "hermes-agent",
3
- "version": "0.21.5",
4
- "description": "Unofficial npm bridge for Hermes Agent 0.21.5: The self-improving AI agent \u2014 creates skills from experience, improves them during use, and runs anywhere",
3
+ "version": "0.21.7",
4
+ "description": "Unofficial npm bridge for Hermes Agent 0.21.7: The self-improving AI agent \u2014 creates skills from experience, improves them during use, and runs anywhere",
5
5
  "license": "MIT",
6
6
  "keywords": [
7
7
  "hermes-agent",
@@ -46,11 +46,12 @@
46
46
  "SECURITY.md"
47
47
  ],
48
48
  "hermesAgent": {
49
- "upstreamVersion": "0.21.5",
49
+ "upstreamVersion": "0.21.7",
50
50
  "upstreamRepository": "NousResearch/hermes-agent",
51
- "upstreamGitTag": "v2026.9.24",
52
- "upstreamCommit": "f97608f178d1ffeca59860195ab7da295f7c8e5f",
53
- "pythonVersion": "3.11",
54
- "runtimeDirectory": "runtime/hermes-agent"
51
+ "upstreamGitTag": "v0.21.7",
52
+ "upstreamCommit": "71d34bad1045610252eda02ee79549436896e784",
53
+ "pythonVersion": "3.14",
54
+ "runtimeDirectory": "runtime/hermes-agent",
55
+ "installerFinalizeStage": "products"
55
56
  }
56
57
  }