lhumina_code/hero_compute
20
0
Fork 0
Code Issues 14 Pull requests 3 Projects Releases 7 Packages Wiki Activity Actions

feat(sockets): align with Hero Socket Convention -- HTTP over UDS + standardized layout #67

Merged
mahmoud merged 3 commits from development_hero_socket into development 2026-04-07 09:32:58 +00:00
Conversation 0 Commits 3 Files changed 23 +350 -256
mahmoud commented 2026-04-06 18:35:44 +00:00
Owner
Copy link

Migrate hero_compute from raw newline-delimited JSON-RPC via UnixRpcServer
to HTTP-over-UDS via AxumRpcServer with standardized socket directory layout
under $HERO_SOCKET_DIR/hero_compute/.

  • Replace UnixRpcServer with AxumRpcServer in server and explorer
  • Add SDK path helpers: socket_dir(), server_socket_path(), ui_socket_path(),
    explorer_socket_path()
  • Replace raw_rpc_unix() with http_rpc_unix() (HTTP/1.1 POST over UDS)
  • Add connect_server_socket() for correct /api/root/cloud/rpc path
  • Add protocol: "openrpc" to heroservice.json for hero_router discovery
  • Standardize HERO_COMPUTE_EXPLORER_SOCKET env var across all crates
  • Update all documentation: protocol descriptions, socket paths, examples
  • TCP bridges preserved for multi-node (Phase 2 removes them)

Socket layout:
~/hero/var/sockets/hero_compute/rpc.sock (server)
~/hero/var/sockets/hero_compute/ui.sock (dashboard)
~/hero/var/sockets/hero_compute/explorer_rpc.sock (explorer)

#65

Migrate hero_compute from raw newline-delimited JSON-RPC via UnixRpcServer to HTTP-over-UDS via AxumRpcServer with standardized socket directory layout under $HERO_SOCKET_DIR/hero_compute/. - Replace UnixRpcServer with AxumRpcServer in server and explorer - Add SDK path helpers: socket_dir(), server_socket_path(), ui_socket_path(), explorer_socket_path() - Replace raw_rpc_unix() with http_rpc_unix() (HTTP/1.1 POST over UDS) - Add connect_server_socket() for correct /api/root/cloud/rpc path - Add protocol: "openrpc" to heroservice.json for hero_router discovery - Standardize HERO_COMPUTE_EXPLORER_SOCKET env var across all crates - Update all documentation: protocol descriptions, socket paths, examples - TCP bridges preserved for multi-node (Phase 2 removes them) Socket layout: ~/hero/var/sockets/hero_compute/rpc.sock (server) ~/hero/var/sockets/hero_compute/ui.sock (dashboard) ~/hero/var/sockets/hero_compute/explorer_rpc.sock (explorer) https://forge.ourworld.tf/lhumina_code/hero_compute/issues/65
feat(sockets): align with Hero Socket Convention -- HTTP over UDS + standardized layout
All checks were successful
Test / test (push) Successful in 1m28s
Details
Test / test (pull_request) Successful in 1m58s
Details
367356c0a8 
Migrate hero_compute from raw newline-delimited JSON-RPC via UnixRpcServer
to HTTP-over-UDS via AxumRpcServer with standardized socket directory layout
under $HERO_SOCKET_DIR/hero_compute/.

- Replace UnixRpcServer with AxumRpcServer in server and explorer
- Add SDK path helpers: socket_dir(), server_socket_path(), ui_socket_path(),
  explorer_socket_path()
- Replace raw_rpc_unix() with http_rpc_unix() (HTTP/1.1 POST over UDS)
- Add connect_server_socket() for correct /api/root/cloud/rpc path
- Add protocol: "openrpc" to heroservice.json for hero_router discovery
- Standardize HERO_COMPUTE_EXPLORER_SOCKET env var across all crates
- Update all documentation: protocol descriptions, socket paths, examples
- TCP bridges preserved for multi-node (Phase 2 removes them)

Socket layout:
  ~/hero/var/sockets/hero_compute/rpc.sock          (server)
  ~/hero/var/sockets/hero_compute/ui.sock            (dashboard)
  ~/hero/var/sockets/hero_compute/explorer_rpc.sock  (explorer)

#65
merge: resolve conflicts with development (env_file_path, Cargo.toml duplicates)
All checks were successful
Test / test (pull_request) Successful in 1m46s
Details
Test / test (push) Successful in 2m22s
Details
f7018e7265
Merge branch 'development' into development_hero_socket
All checks were successful
Test / test (pull_request) Successful in 1m27s
Details
Test / test (push) Successful in 2m27s
Details
97920c5da7
mahmoud merged commit 3540c37f66 into development 2026-04-07 09:32:58 +00:00
mahmoud deleted branch development_hero_socket 2026-04-07 09:32:59 +00:00
Sign in to join this conversation.
Reviewers
No reviewers
Labels
Clear labels   
prio_critical

   
prio_low

   
type_bug

   
type_contact

   
type_issue

   
type_lead

   
type_question

   
type_story

   
type_task
No labels
prio_critical
prio_low
type_bug
type_contact
type_issue
type_lead
type_question
type_story
type_task
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
lhumina_code/hero_compute!67
No description provided.