Author: NikolaRHristov

Proto/Build.rs

@@ -0,0 +1,27 @@
+// ORIGIN INFORMATION:
+// This code block was extracted by a script.
+// Source Markdown File: Backup/MountainFinalSync/Document/14_MODEL.md
+// Source Block Index in MD (Overall): 3
+// Original Fence Info String: (empty)
+// Content SHA256 (of this block):
+// 7bbaddc3d4a89cda326f09f7335e4a06b4cc0179bb7e5601667744c7198028e1 Extracted to
+// File: Backup/MountainFinalSync/Code/mountain/build.rs Extraction Timestamp:
+// 2025-06-18T18:53:42.858Z --- END OF ORIGIN INFORMATION ---
+
+// @file build.rs
+// @brief The build script for the Mountain crate.
+// @description This script uses `tonic-build` to compile the Protobuf
+// definitions in `Vine.proto` into Rust code, which is then included by the
+// `Vine::Generated` module.
+
+fn main() -> Result<(), Box<dyn std::error::Error>> {
+	println!("cargo:rerun-if-changed=Vine.proto");
+
+	tonic_build::configure()
+		.build_server(true)
+		.build_client(true)
+		.out_dir("Source/Vine/Generated")
+		.compile(&["Vine.proto"], &["proto"])?;
+
+	Ok(())
+}

Proto/Vine.proto

@@ -0,0 +1,66 @@
+// @file vine.proto
+// @brief Defines the gRPC services and messages for communication between Mountain (host) and Cocoon (sidecar).
+
+syntax = "proto3";
+
+package vine_ipc;
+
+// Service running on the Mountain host, listening for requests from Cocoon.
+service MountainService {
+  // A generic request-response method for Cocoon to call a function on Mountain.
+  rpc ProcessCocoonRequest(GenericRequest) returns (GenericResponse);
+  // A generic fire-and-forget method for Cocoon to send a notification to Mountain.
+  rpc SendCocoonNotification(GenericNotification) returns (Empty);
+  // A method for Cocoon to request that Mountain cancel a long-running operation.
+  rpc CancelOperation(CancelOperationRequest) returns (Empty);
+}
+
+// Service running on the Cocoon sidecar, listening for requests from Mountain.
+service CocoonService {
+  // A generic request-response method for Mountain to call a function on Cocoon.
+  rpc ProcessMountainRequest(GenericRequest) returns (GenericResponse);
+  // A generic fire-and-forget method for Mountain to send a notification to Cocoon.
+  rpc SendMountainNotification(GenericNotification) returns (Empty);
+  // A method for Mountain to request that Cocoon cancel a long-running operation.
+  rpc CancelOperation(CancelOperationRequest) returns (Empty);
+}
+
+// Represents an empty message, typically used for RPCs that don't need to return data.
+message Empty {}
+
+// A generic request message containing a method name and serialized parameters.
+message GenericRequest {
+  uint64 request_id = 1;
+  string method = 2;
+  bytes params = 3; // Parameters are expected to be a JSON-serialized byte array.
+}
+
+// A generic response message containing the result or an error.
+message GenericResponse {
+  uint64 request_id = 1;
+  bytes result = 2; // The successful result, JSON-serialized.
+  optional RpcError error = 3;
+}
+
+// A generic notification message, which is fire-and-forget and does not have an ID.
+message GenericNotification {
+  string method = 1;
+  bytes params = 2; // Parameters are expected to be a JSON-serialized byte array.
+}
+
+// A structured error payload, compliant with JSON-RPC error objects.
+message RpcError {
+  int32 code = 1;
+  string message = 2;
+  bytes data = 3; // Optional, additional error data, JSON-serialized.
+}
+
+// A message to cancel a specific, ongoing operation.
+message CancelOperationRequest {
+  uint64 request_id_to_cancel = 1;
+}
+
+// A generic data payload, currently unused but available for future extensions.
+message RpcDataPayload {
+  bytes data = 1;
+}

Source/Vine/Server/Initialize.rs

@@ -11,7 +11,7 @@ use tonic::transport::Server;
 use super::MountainVinegRPCService::MountainVinegRPCService;
 use crate::{
 	RunTime::ApplicationRunTime::ApplicationRunTime,
-	Vine::generated::mountain_service_server::MountainServiceServer,
+	Vine::Generated::mountain_service_server::MountainServiceServer,
 };
 
 /// Initializes and starts the gRPC server on a background task.

Source/Vine/Server/MountainVinegRPCService.rs

@@ -12,7 +12,7 @@ use tonic::{Request, Response, Status};
 
 use crate::{
 	track,
-	Vine::generated::{mountain_service_server::MountainService, *},
+	Vine::Generated::{mountain_service_server::MountainService, *},
 	RunTime::ApplicationRunTime::ApplicationRunTime,
 };
 

Source/Vine/mod.rs

@@ -29,8 +29,8 @@ pub mod generated;
 pub use self::error::VineError;
 // The auto-generated gRPC client for the `CocoonService`.
 // @see generated::CocoonServiceClient
-pub use self::generated::cocoon_service_client::CocoonServiceClient;
+pub use self::Generated::cocoon_service_client::CocoonServiceClient;
 // The auto-generated gRPC server trait for the `MountainService`.
 // Our `MountainVinegRPCService` will implement this trait.
 // @see generated::mountain_service_server::MountainServiceServer;
-pub use self::generated::mountain_service_server::MountainServiceServer;
+pub use self::Generated::mountain_service_server::MountainServiceServer;