Migrate to hero_osis unified socket path #32

New issue

Open

opened 2026-04-12 14:10:24 +00:00 by timur · 0 comments

timur commented

2026-04-12 14:10:24 +00:00

Owner

Context

hero_osis is migrating to the standard hero_sockets convention (unified OServer architecture from hero_rpc development branch).

Socket Changes

	Old	New
RPC	`~/hero/var/sockets/hero_osis/{context}/rpc.sock` (per-context sockets)	`~/hero/var/sockets/hero_osis/rpc.sock` (single unified socket)
UI	`~/hero/var/sockets/hero_osis/ui.sock`	`~/hero/var/sockets/hero_osis/ui.sock` (unchanged)

Protocol Changes

Context is now passed via X-Hero-Context HTTP header (integer: 0=admin, >=1=user)
Claims via X-Hero-Claims HTTP header (missing = full trust)
All 17 domains served through the single rpc.sock
Method routing: Type.method (e.g., user.get, channel.list)

What Needs Updating

hero_os_http proxy: connect to single rpc.sock instead of per-context sockets
Set X-Hero-Context header based on the request context
Any other consumers connecting to hero_osis need the same update

References

hero_rpc issue: lhumina_code/hero_rpc#13
hero_osis branch: development_hero_sdk

## Context hero_osis is migrating to the standard hero_sockets convention (unified OServer architecture from hero_rpc `development` branch). ## Socket Changes | | Old | New | |---|---|---| | **RPC** | `~/hero/var/sockets/hero_osis/{context}/rpc.sock` (per-context sockets) | `~/hero/var/sockets/hero_osis/rpc.sock` (single unified socket) | | **UI** | `~/hero/var/sockets/hero_osis/ui.sock` | `~/hero/var/sockets/hero_osis/ui.sock` (unchanged) | ## Protocol Changes - Context is now passed via `X-Hero-Context` HTTP header (integer: `0`=admin, `>=1`=user) - Claims via `X-Hero-Claims` HTTP header (missing = full trust) - All 17 domains served through the single `rpc.sock` - Method routing: `Type.method` (e.g., `user.get`, `channel.list`) ## What Needs Updating - `hero_os_http` proxy: connect to single `rpc.sock` instead of per-context sockets - Set `X-Hero-Context` header based on the request context - Any other consumers connecting to hero_osis need the same update ## References - hero_rpc issue: https://forge.ourworld.tf/lhumina_code/hero_rpc/issues/13 - hero_osis branch: `development_hero_sdk`