@cofy-x/axern-sdk 0.2.0-bootstrap.0

package/dist/proto/axern/control/admin/v1/node.proto

@@ -0,0 +1,49 @@
+syntax = "proto3";
+
+package axern.control.admin.v1;
+
+option go_package = "github.com/cofy-x/axern/sdk/go/gen/axern/control/admin/v1;adminv1";
+
+import "google/protobuf/timestamp.proto";
+
+enum AdminNodeLifecycleStatus {
+  ADMIN_NODE_LIFECYCLE_STATUS_UNSPECIFIED = 0;
+  ADMIN_NODE_LIFECYCLE_STATUS_ACTIVE = 1;
+  ADMIN_NODE_LIFECYCLE_STATUS_RETIRED = 2;
+}
+
+message AdminNode {
+  string node_id = 1;
+  AdminNodeLifecycleStatus lifecycle_status = 2;
+  bool heartbeat_fresh = 3;
+  bool summary_fresh = 4;
+  bool axnoded_ready = 5;
+  int64 heartbeat_age_seconds = 6;
+  int64 summary_age_seconds = 7;
+  google.protobuf.Timestamp registered_at = 8;
+  google.protobuf.Timestamp updated_at = 9;
+  google.protobuf.Timestamp retired_at = 10;
+  string retired_reason = 11;
+}
+
+message ListAdminNodesRequest {
+  AdminNodeLifecycleStatus lifecycle_status = 1;
+}
+
+message ListAdminNodesResponse {
+  repeated AdminNode nodes = 1;
+}
+
+message RetireAdminNodeRequest {
+  string node_id = 1;
+  string operator_reason = 2;
+}
+
+message RetireAdminNodeResponse {
+  AdminNode node = 1;
+}
+
+service NodeAdmin {
+  rpc ListAdminNodes(ListAdminNodesRequest) returns (ListAdminNodesResponse) {}
+  rpc RetireAdminNode(RetireAdminNodeRequest) returns (RetireAdminNodeResponse) {}
+}

package/dist/proto/axern/control/admin/v1/reliability.proto

@@ -0,0 +1,184 @@
+syntax = "proto3";
+
+package axern.control.admin.v1;
+
+option go_package = "github.com/cofy-x/axern/sdk/go/gen/axern/control/admin/v1;adminv1";
+
+import "google/protobuf/timestamp.proto";
+
+enum AdminReliabilityStatus {
+  ADMIN_RELIABILITY_STATUS_UNSPECIFIED = 0;
+  ADMIN_RELIABILITY_STATUS_OK = 1;
+  ADMIN_RELIABILITY_STATUS_DEGRADED = 2;
+}
+
+enum ConsistencyStatus {
+  CONSISTENCY_STATUS_UNSPECIFIED = 0;
+  CONSISTENCY_STATUS_OK = 1;
+  CONSISTENCY_STATUS_INCONSISTENT = 2;
+}
+
+enum ConsistencyIssueSeverity {
+  CONSISTENCY_ISSUE_SEVERITY_UNSPECIFIED = 0;
+  CONSISTENCY_ISSUE_SEVERITY_WARNING = 1;
+  CONSISTENCY_ISSUE_SEVERITY_ERROR = 2;
+}
+
+enum ConsistencyIssueCode {
+  CONSISTENCY_ISSUE_CODE_UNSPECIFIED = 0;
+  CONSISTENCY_ISSUE_CODE_ACTIVE_RESERVATION_MISSING_ALLOCATION = 1;
+  CONSISTENCY_ISSUE_CODE_ACTIVE_RESERVATION_ON_ENDED_ALLOCATION = 2;
+  CONSISTENCY_ISSUE_CODE_ACTIVE_RESERVATION_ALLOCATION_MISMATCH = 3;
+  CONSISTENCY_ISSUE_CODE_ACTIVE_LEASE_MISSING_ALLOCATION = 4;
+  CONSISTENCY_ISSUE_CODE_ACTIVE_LEASE_ON_ENDED_ALLOCATION = 5;
+  CONSISTENCY_ISSUE_CODE_ACTIVE_LEASE_ALLOCATION_NODE_MISMATCH = 6;
+  CONSISTENCY_ISSUE_CODE_ACTIVE_TUNNEL_MISSING_ALLOCATION = 7;
+  CONSISTENCY_ISSUE_CODE_ACTIVE_TUNNEL_ON_ENDED_ALLOCATION = 8;
+  CONSISTENCY_ISSUE_CODE_ACTIVE_TUNNEL_ALLOCATION_NODE_MISMATCH = 9;
+  CONSISTENCY_ISSUE_CODE_SERVICE_REFERENCE_MISSING_ALLOCATION = 10;
+  CONSISTENCY_ISSUE_CODE_SERVICE_REFERENCE_ENDED_ALLOCATION = 11;
+  CONSISTENCY_ISSUE_CODE_SERVICE_REFERENCE_OWNER_MISMATCH = 12;
+}
+
+enum ConsistencyRepairOwner {
+  CONSISTENCY_REPAIR_OWNER_UNSPECIFIED = 0;
+  CONSISTENCY_REPAIR_OWNER_WORKLOAD_CONTROLLER = 1;
+  CONSISTENCY_REPAIR_OWNER_NODE_LIFECYCLE = 2;
+  CONSISTENCY_REPAIR_OWNER_TUNNEL_CONTROLLER = 3;
+  CONSISTENCY_REPAIR_OWNER_SERVICE_CONTROLLER = 4;
+  CONSISTENCY_REPAIR_OWNER_ADMIN_OPERATOR_TRIAGE = 5;
+}
+
+enum ConsistencyRepairAction {
+  CONSISTENCY_REPAIR_ACTION_UNSPECIFIED = 0;
+  CONSISTENCY_REPAIR_ACTION_WORKLOAD_CLEANUP = 1;
+  CONSISTENCY_REPAIR_ACTION_WORKLOAD_CLEANUP_AND_READMIT = 2;
+  CONSISTENCY_REPAIR_ACTION_NODE_LIFECYCLE_RECONCILE = 3;
+  CONSISTENCY_REPAIR_ACTION_TUNNEL_LIFECYCLE_RECONCILE = 4;
+  CONSISTENCY_REPAIR_ACTION_SERVICE_RECONCILE = 5;
+  CONSISTENCY_REPAIR_ACTION_ADMIN_TRIAGE = 6;
+}
+
+enum ConsistencyRepairTargetType {
+  CONSISTENCY_REPAIR_TARGET_TYPE_UNSPECIFIED = 0;
+  CONSISTENCY_REPAIR_TARGET_TYPE_ALLOCATION = 1;
+  CONSISTENCY_REPAIR_TARGET_TYPE_RUN = 2;
+  CONSISTENCY_REPAIR_TARGET_TYPE_SERVICE = 3;
+  CONSISTENCY_REPAIR_TARGET_TYPE_TUNNEL_SESSION = 4;
+}
+
+enum AdminReliabilitySignalCode {
+  ADMIN_RELIABILITY_SIGNAL_CODE_UNSPECIFIED = 0;
+  ADMIN_RELIABILITY_SIGNAL_CODE_CONSISTENCY_ISSUES = 1;
+  ADMIN_RELIABILITY_SIGNAL_CODE_ALLOCATION_LIFECYCLE_RETRIES = 2;
+  ADMIN_RELIABILITY_SIGNAL_CODE_RECONCILE_FAILURES = 3;
+  ADMIN_RELIABILITY_SIGNAL_CODE_STORAGE_BINDINGS = 4;
+  ADMIN_RELIABILITY_SIGNAL_CODE_NODE_VOLUME_MANAGERS = 5;
+  ADMIN_RELIABILITY_SIGNAL_CODE_NODE_FLEET = 6;
+}
+
+message ConsistencyCounts {
+  int64 active_reservations = 1;
+  int64 active_leases = 2;
+  int64 active_tunnels = 3;
+  int64 allocation_lifecycle_retries = 4;
+  int64 issues = 5;
+}
+
+message ConsistencyIssue {
+  ConsistencyIssueCode code = 1;
+  ConsistencyIssueSeverity severity = 2;
+  string allocation_id = 3;
+  string owner_type = 4;
+  string owner_id = 5;
+  string node_id = 6;
+  string status = 7;
+  string detail = 8;
+  ConsistencyRepairOwner repair_owner = 9;
+  ConsistencyRepairAction repair_action = 10;
+  bool automatic_repair = 11;
+  ConsistencyRepairTargetType repair_target_type = 12;
+  string repair_target_id = 13;
+}
+
+message ConsistencySnapshot {
+  ConsistencyStatus status = 1;
+  ConsistencyCounts counts = 2;
+  repeated ConsistencyIssue issues = 3;
+  bool truncated = 4;
+}
+
+message AdminReliabilitySignal {
+  AdminReliabilitySignalCode code = 1;
+  string message = 2;
+}
+
+message AdminReliabilityHealth {
+  AdminReliabilityStatus status = 1;
+  ConsistencySnapshot consistency = 2;
+  int64 allocation_lifecycle_retries = 3;
+  int64 due_allocation_lifecycle_retries = 4;
+  int64 reconcile_unhealthy_components = 5;
+  repeated AdminReliabilitySignal signals = 6;
+  AdminNodeVolumeHealth node_volume_health = 7;
+  AdminStorageBindingHealth storage_binding_health = 8;
+  repeated ReconcileComponentHealth reconcile_components = 9;
+  AdminNodeFleetHealth node_fleet_health = 10;
+}
+
+message ReconcileComponentHealth {
+  string component = 1;
+  bool running = 2;
+  google.protobuf.Timestamp last_started_at = 3;
+  google.protobuf.Timestamp last_success_at = 4;
+  google.protobuf.Timestamp last_error_at = 5;
+  string last_error = 6;
+  int64 consecutive_failures = 7;
+}
+
+message CheckConsistencyRequest {}
+
+message CheckConsistencyResponse {
+  ConsistencySnapshot snapshot = 1;
+}
+
+message GetAdminReliabilityHealthRequest {}
+
+message GetAdminReliabilityHealthResponse {
+  AdminReliabilityHealth health = 1;
+}
+
+message AdminNodeVolumeHealth {
+  int64 unhealthy_nodes = 1;
+  int64 published_volumes = 2;
+  int64 last_reconcile_stale_allocations = 3;
+  int64 last_reconcile_invalid_volumes = 4;
+  string error = 5;
+}
+
+message AdminNodeFleetHealth {
+  int64 active_nodes = 1;
+  int64 ready_nodes = 2;
+  int64 stale_heartbeat_nodes = 3;
+  int64 stale_summary_nodes = 4;
+  int64 not_ready_nodes = 5;
+  bool unavailable = 6;
+  string error = 7;
+}
+
+message AdminStorageBindingHealth {
+  bool unavailable = 1;
+  string error = 2;
+  int64 failed_bindings = 3;
+  int64 releasing_bindings = 4;
+  int64 stuck_releasing_bindings = 5;
+  int64 inconsistent_claims = 6;
+  int64 invalid_bindings = 7;
+  int64 deleting_claims = 8;
+  int64 stuck_deleting_claims = 9;
+}
+
+service AdminReliability {
+  rpc CheckConsistency(CheckConsistencyRequest) returns (CheckConsistencyResponse) {}
+  rpc GetAdminReliabilityHealth(GetAdminReliabilityHealthRequest) returns (GetAdminReliabilityHealthResponse) {}
+}

package/dist/proto/axern/control/admin/v1/service.proto

@@ -0,0 +1,18 @@
+syntax = "proto3";
+
+package axern.control.admin.v1;
+
+option go_package = "github.com/cofy-x/axern/sdk/go/gen/axern/control/admin/v1;adminv1";
+
+message PurgeServiceRequest {
+  string service_id = 1;
+  string operator_reason = 2;
+}
+
+message PurgeServiceResponse {
+  string service_id = 1;
+}
+
+service ServiceAdmin {
+  rpc PurgeService(PurgeServiceRequest) returns (PurgeServiceResponse) {}
+}

package/dist/proto/axern/control/admin/v1/storage.proto

@@ -0,0 +1,81 @@
+syntax = "proto3";
+
+package axern.control.admin.v1;
+
+option go_package = "github.com/cofy-x/axern/sdk/go/gen/axern/control/admin/v1;adminv1";
+
+import "axern/control/storage/v1/storage_types.proto";
+import "google/protobuf/timestamp.proto";
+
+message StorageBinding {
+  string binding_id = 1;
+  string claim_id = 2;
+  string namespace = 3;
+  string claim_name = 4;
+  string workload_id = 5;
+  string workload_type = 6;
+  string allocation_id = 7;
+  string node_id = 8;
+  axern.control.storage.v1.VolumeStatus status = 9;
+  string message = 10;
+  google.protobuf.Timestamp created_at = 11;
+  google.protobuf.Timestamp updated_at = 12;
+  google.protobuf.Timestamp published_at = 13;
+  google.protobuf.Timestamp released_at = 14;
+}
+
+message StorageBindingFilter {
+  repeated axern.control.storage.v1.VolumeStatus statuses = 1;
+  string namespace = 2;
+  string claim_name = 3;
+  string workload_id = 4;
+  string allocation_id = 5;
+  string node_id = 6;
+}
+
+message ListStorageBindingsRequest {
+  StorageBindingFilter filter = 1;
+  int32 limit = 2;
+}
+
+message ListStorageBindingsResponse {
+  repeated StorageBinding bindings = 1;
+}
+
+message RetryStorageBindingRequest {
+  string binding_id = 1;
+  string operator_reason = 2;
+}
+
+message RetryStorageBindingResponse {
+  StorageBinding binding = 1;
+}
+
+message StorageReclaim {
+  string claim_id = 1;
+  string namespace = 2;
+  string claim_name = 3;
+  string service_id = 4;
+  string node_id = 5;
+  int64 attempt = 6;
+  google.protobuf.Timestamp next_retry_at = 7;
+  string last_error = 8;
+  google.protobuf.Timestamp updated_at = 9;
+}
+
+message ListStorageReclaimsRequest {
+  string namespace = 1;
+  string service_id = 2;
+  string node_id = 3;
+  int32 limit = 4;
+}
+
+message ListStorageReclaimsResponse {
+  repeated StorageReclaim reclaims = 1;
+}
+
+service StorageAdmin {
+  rpc ListStorageBindings(ListStorageBindingsRequest) returns (ListStorageBindingsResponse) {}
+  rpc RetryStorageBinding(RetryStorageBindingRequest) returns (RetryStorageBindingResponse) {}
+  rpc ListStorageReclaims(ListStorageReclaimsRequest) returns (ListStorageReclaimsResponse) {}
+}

package/dist/proto/axern/control/agentprofile/v1/agent_profile.proto

@@ -0,0 +1,169 @@
+syntax = "proto3";
+
+package axern.control.agentprofile.v1;
+
+option go_package = "github.com/cofy-x/axern/sdk/go/gen/axern/control/agentprofile/v1;agentprofilev1";
+
+import "google/protobuf/timestamp.proto";
+
+enum AgentProvider {
+  AGENT_PROVIDER_UNSPECIFIED = 0;
+  AGENT_PROVIDER_OPENAI = 1;
+  AGENT_PROVIDER_ANTHROPIC = 2;
+}
+
+enum AgentWireApi {
+  AGENT_WIRE_API_UNSPECIFIED = 0;
+  AGENT_WIRE_API_OPENAI_RESPONSES = 1;
+  AGENT_WIRE_API_ANTHROPIC_MESSAGES = 2;
+}
+
+message AgentProfileSpec {
+  string agent = 1;
+  AgentProvider provider = 2;
+  AgentWireApi wire_api = 3;
+  string base_url = 4;
+  int32 max_concurrency = 5;
+}
+
+message AgentProfile {
+  string id = 1;
+  string namespace = 2;
+  string name = 3;
+  AgentProfileSpec spec = 4;
+  map<string, string> labels = 5;
+  int64 version = 6;
+  int64 credential_version = 7;
+  google.protobuf.Timestamp created_at = 8;
+  google.protobuf.Timestamp updated_at = 9;
+}
+
+message AgentProfileListFilter {
+  string namespace = 1;
+  string agent = 2;
+  AgentProvider provider = 3;
+  map<string, string> labels = 4;
+  string cursor = 5;
+  int32 page_size = 6;
+}
+
+message CreateAgentProfileRequest {
+  string namespace = 1;
+  string name = 2;
+  AgentProfileSpec spec = 3;
+  map<string, string> labels = 4;
+  bytes credential = 5;
+  string idempotency_key = 6;
+}
+
+message CreateAgentProfileResponse {
+  AgentProfile profile = 1;
+}
+
+message GetAgentProfileRequest {
+  string namespace = 1;
+  string name = 2;
+}
+
+message GetAgentProfileResponse {
+  AgentProfile profile = 1;
+}
+
+message ListAgentProfilesRequest {
+  AgentProfileListFilter filter = 1;
+}
+
+message ListAgentProfilesResponse {
+  repeated AgentProfile profiles = 1;
+  string next_cursor = 2;
+}
+
+message AgentProfilePatch {
+  optional string base_url = 1;
+  optional int32 max_concurrency = 2;
+  map<string, string> labels = 3;
+  bool replace_labels = 4;
+}
+
+message UpdateAgentProfileRequest {
+  string namespace = 1;
+  string name = 2;
+  AgentProfilePatch patch = 3;
+  int64 expected_version = 4;
+  string idempotency_key = 5;
+}
+
+message UpdateAgentProfileResponse {
+  AgentProfile profile = 1;
+}
+
+message RotateAgentProfileCredentialRequest {
+  string namespace = 1;
+  string name = 2;
+  bytes credential = 3;
+  int64 expected_version = 4;
+  string idempotency_key = 5;
+}
+
+message RotateAgentProfileCredentialResponse {
+  AgentProfile profile = 1;
+}
+
+enum ProfileCheckKind {
+  PROFILE_CHECK_KIND_UNSPECIFIED = 0;
+  PROFILE_CHECK_KIND_CONFIGURATION = 1;
+  PROFILE_CHECK_KIND_CREDENTIAL = 2;
+  PROFILE_CHECK_KIND_WORKER_CAPABILITY = 3;
+  PROFILE_CHECK_KIND_PROVIDER_AUTHENTICATION = 4;
+  PROFILE_CHECK_KIND_WIRE_API = 5;
+  PROFILE_CHECK_KIND_MODEL = 6;
+  PROFILE_CHECK_KIND_LATENCY = 7;
+}
+
+enum ProfileCheckStatus {
+  PROFILE_CHECK_STATUS_UNSPECIFIED = 0;
+  PROFILE_CHECK_STATUS_PASS = 1;
+  PROFILE_CHECK_STATUS_WARN = 2;
+  PROFILE_CHECK_STATUS_FAIL = 3;
+}
+
+message ProfileCheck {
+  ProfileCheckKind kind = 1;
+  ProfileCheckStatus status = 2;
+  string code = 3;
+  string message = 4;
+  bool retryable = 5;
+  int64 latency_ms = 6;
+}
+
+message DoctorAgentProfileRequest {
+  string namespace = 1;
+  string name = 2;
+  string model = 3;
+}
+
+message DoctorAgentProfileResponse {
+  AgentProfile profile = 1;
+  repeated ProfileCheck checks = 2;
+  bool healthy = 3;
+}
+
+message DeleteAgentProfileRequest {
+  string namespace = 1;
+  string name = 2;
+  int64 expected_version = 3;
+}
+
+message DeleteAgentProfileResponse {
+  AgentProfile profile = 1;
+}
+
+service AgentProfileControl {
+  rpc CreateAgentProfile(CreateAgentProfileRequest) returns (CreateAgentProfileResponse) {}
+  rpc GetAgentProfile(GetAgentProfileRequest) returns (GetAgentProfileResponse) {}
+  rpc ListAgentProfiles(ListAgentProfilesRequest) returns (ListAgentProfilesResponse) {}
+  rpc UpdateAgentProfile(UpdateAgentProfileRequest) returns (UpdateAgentProfileResponse) {}
+  rpc RotateAgentProfileCredential(RotateAgentProfileCredentialRequest) returns (RotateAgentProfileCredentialResponse) {}
+  rpc DoctorAgentProfile(DoctorAgentProfileRequest) returns (DoctorAgentProfileResponse) {}
+  rpc DeleteAgentProfile(DeleteAgentProfileRequest) returns (DeleteAgentProfileResponse) {}
+}

package/dist/proto/axern/control/catalog/v1/catalog.proto

@@ -0,0 +1,127 @@
+syntax = "proto3";
+
+package axern.control.catalog.v1;
+
+option go_package = "github.com/cofy-x/axern/sdk/go/gen/axern/control/catalog/v1;catalogv1";
+
+message RuntimeMount {
+  string type = 1;
+  string source = 2;
+  string target = 3;
+  repeated string options = 4;
+}
+
+message RuntimeTemplateCapabilities {
+  bool supports_exec = 1;
+  bool supports_exec_stream = 2;
+  bool supports_long_lived_process = 3;
+  bool supports_ports = 4;
+  bool supports_computer_use = 5;
+}
+
+message OciImageDescriptor {
+  string digest = 1;
+  string media_type = 2;
+  int64 size_bytes = 3;
+  map<string, string> annotations = 4;
+}
+
+message RuntimeBaselinePolicy {
+  repeated string capabilities = 1;
+  uint64 no_file_limit = 2;
+}
+
+message RuntimeCapabilityPolicy {
+  string annotation_key = 1;
+  optional bool include_ambient = 2;
+}
+
+message RuntimeNetworkNamespacePolicy {
+  string annotation_key = 1;
+}
+
+message RuntimeResourcePolicy {
+  repeated string ignore_annotation_keys = 1;
+}
+
+message RuntimeExecutionProfile {
+  RuntimeBaselinePolicy runtime_baseline = 1;
+  RuntimeCapabilityPolicy capabilities = 2;
+  RuntimeNetworkNamespacePolicy network_namespace = 3;
+  RuntimeResourcePolicy resources = 4;
+}
+
+message RuntimeTemplate {
+  string id = 1;
+  bool rootfs_readonly = 2;
+  // Informational image default command, usually OCI Entrypoint + Cmd for
+  // built-in templates. Workloads with no explicit argv preserve the image
+  // default at node runtime instead of using this field as a control-plane
+  // bootstrap override.
+  repeated string image_default_argv = 3;
+  string default_cwd = 4;
+  map<string, string> default_env = 5;
+  repeated RuntimeMount mounts = 6;
+  RuntimeTemplateCapabilities capabilities = 7;
+  string language = 8;
+  string language_version = 9;
+  string description = 10;
+  string version = 11;
+  OciImageDescriptor image_descriptor = 12;
+  string warm_policy = 13;
+  string cache_policy = 14;
+  RuntimeExecutionProfile execution_profile = 15;
+}
+
+message ListRuntimeTemplatesRequest {
+  string namespace = 1;
+  string version = 2;
+  string language = 3;
+}
+
+message ListRuntimeTemplatesResponse {
+  repeated RuntimeTemplate runtime_templates = 1;
+}
+
+message GetRuntimeTemplateRequest {
+  string id = 1;
+  string version = 2;
+}
+
+message GetRuntimeTemplateResponse {
+  RuntimeTemplate runtime_template = 1;
+}
+
+// AgentBundle describes a relocatable, read-only agent tool image. The image
+// is mounted into a workload rootfs; it is not itself a runtime template.
+message AgentBundle {
+  string id = 1;
+  string version = 2;
+  OciImageDescriptor image_descriptor = 3;
+  string binary_path = 4;
+  string description = 5;
+}
+
+message ListAgentBundlesRequest {
+  string version = 1;
+}
+
+message ListAgentBundlesResponse {
+  repeated AgentBundle agent_bundles = 1;
+}
+
+message GetAgentBundleRequest {
+  string id = 1;
+  string version = 2;
+}
+
+message GetAgentBundleResponse {
+  AgentBundle agent_bundle = 1;
+}
+
+service RuntimeCatalog {
+  rpc ListRuntimeTemplates(ListRuntimeTemplatesRequest) returns (ListRuntimeTemplatesResponse) {}
+  rpc GetRuntimeTemplate(GetRuntimeTemplateRequest) returns (GetRuntimeTemplateResponse) {}
+  rpc ListAgentBundles(ListAgentBundlesRequest) returns (ListAgentBundlesResponse) {}
+  rpc GetAgentBundle(GetAgentBundleRequest) returns (GetAgentBundleResponse) {}
+}