HomeOps-Hub/api/proto/homeops/hub.proto

syntax = "proto3";

import "google/protobuf/empty.proto";

option go_package = "github.com/lorsanstand/HomeOps-Hub/api/gen/homeops;homeops";

service Hub {
  rpc Ping (google.protobuf.Empty) returns (PongResponse) {}
  rpc RegisterAgent (RegisterAgentRequest) returns (RegisterAgentResponse) {}
  rpc StreamConnection (stream AgentEvent) returns (stream ServerCommandRequest) {}
}

message PongResponse {
  string pong = 1;
}

message RegisterAgentRequest {
  string agent_id = 1;
  string agent_name = 2;
  string version = 3;
  HostInfo host = 4;
  repeated Capability capability = 5;
}

message HostInfo {
  string system = 1;
  string hostname = 2;
  string arch = 3;
}

message Capability {
  bool available = 1;
  string version = 2;
  string name = 3;
  string reason = 4;
}

message RegisterAgentResponse {
  int64 heartbeat_interval_second = 1;
  string agent_id = 2;
}

message ServerCommandRequest {
  string request_id = 1;
  string name = 2;
  map<string, string> args = 3;
  int64 timeout_seconds = 4;
}

message AgentEvent {
  string agent_id = 1;

  oneof event {
    Heartbeat heartbeat = 2;
    CommandResponse command_response = 3;
    Alert alert = 4;
  }
}

message Heartbeat {
  int64 timestamp = 1;
  SystemMetrics metrics = 2;
}

message SystemMetrics {
  float cpu_usage = 1;
  float memory_usage = 2;
  float disk_usage = 3;
}

message CommandResponse {
  string request_id = 1;
  bool success = 2;
  string output = 3;
  string error = 4;
  int64 exec_time_ms = 5;
}

message Alert {
  int64 timestamp = 1;
  string level = 2;
  string title = 3;
  string description = 4;
}