Skip to content

chore: migrate to start-sdk 2.0#5

Open
helix-nine wants to merge 1 commit into
masterfrom
next
Open

chore: migrate to start-sdk 2.0#5
helix-nine wants to merge 1 commit into
masterfrom
next

Conversation

@helix-nine

@helix-nine helix-nine commented Jul 4, 2026

Copy link
Copy Markdown
Contributor

start-sdk 2.0 migration

Migrates this package to @start9labs/start-sdk 2.0, which requires StartOS 0.4.0-beta.10. This is now next's only delta over master: the upstream Hermes 2026.6.19 → 2026.7.1 bump and the health-probe ownership fix already landed on master via #7 (released as 2026.7.1:0 on the SDK 1.5.3 / beta.9 line), and next inherits both by rebasing onto it. Releases as 2026.7.1:1 — same upstream image, rebuilt on SDK 2.0 for beta.10.

Changes

  • SDK pin → 2.0.1, TypeScript → ^6, tsconfig.json extends the shipped tsconfig.base.json, Makefile includes the SDK's s9pk.mk (vendored copy removed), reusable CI workflows repointed to Start9Labs/start-technologies.
  • 2.0 API migrations: sdk.serviceInterface.*sdk.host.* resolved over the LXC bridge, lazy SubContainer, alerts manifest field removed, and the other ### Changed / ### Removed items from the SDK 2.0 changelog.
  • startos/versions/current.ts2026.7.1:1 with SDK-2.0 release notes (all five locales). No state migration — packaging-only rework.

Test plan

  • CI build green (npm citsc → SDK lint → nccs9pk pack) for both x86_64 and aarch64.
  • Install on a StartOS 0.4.0-beta.10 server — fresh install, and upgrade from a 2026.7.1:0 install to confirm the upgrade path is clean.
  • Start the service; confirm it reaches its health check and the "Web Dashboard" (ui) interface loads.
  • Run "Configure Provider" (e.g. Ollama) and confirm Hermes wires it over the LXC bridge and completes a prompt.
  • Confirm the health probes run as uid 1000 and /opt/data stays hermes-owned (the release 2026.7.1:0: Hermes 2026.7.1 + health-probe ownership fix #7 fix, carried forward under SDK 2.0).
  • Restart and confirm the Hermes home scaffolding (hooks/, cron/, sessions/) survives with uid-1000 ownership (no EACCES crash-loop).

@helix-nine helix-nine changed the title chore: migrate to start-sdk 2.0 chore: migrate to start-sdk 2.0 and bump Hermes Agent to 2026.7.1 Jul 4, 2026
helix-nine added a commit that referenced this pull request Jul 7, 2026
Ships on the SDK 1.5.3 / StartOS beta.9 line (the SDK 2.0 migration that
requires beta.10 stays on `next`, PR #5, which will rebase onto this).

- Bump upstream Hermes 2026.6.19 -> 2026.7.1 (the Judgment Release): Dockerfile
  FROM digest, HERMES_VERSION, release notes. Drop-in — no probe/schema/action
  changes needed (mirrors what next's bump touched).
- Fix recurring Nous/OAuth token-refresh drops (#6): the provider and gateway
  health probes ran as root (image USER is root, runHealthScript takes no user),
  so their `import hermes_cli` created auth-store files (auth.lock/auth.json)
  root-owned and EACCES-locked the uid-1000 gateway out of refreshing its
  ~15-min access token. Run both probes as `hermes` (uid 1000), matching the
  daemons, so nothing on the volume is ever root-owned. Also refreshes the
  Dockerfile HERMES_UID/GID comment.

Existing installs self-heal on the upgrade restart via the boot chown.

Fixes #6

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@helix-nine helix-nine changed the title chore: migrate to start-sdk 2.0 and bump Hermes Agent to 2026.7.1 chore: migrate to start-sdk 2.0 Jul 7, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant