new: Pass proto version in plugin context. (#349)

CHANGELOG.md

@@ -24,6 +24,7 @@
   - Handles stdin, pipes, and redirects efficiently and correctly.
   - Better compatibility and portability.
 - WASM API
+  - Added a `ToolContext.proto_version` field.
   - Added a `ExecutableConfig.shim_env_vars` field.
   - Updated `ExecutableConfig.shim_before_args` and `ExecutableConfig.shim_after_args` to support a list of strings.
 

crates/core/src/helpers.rs

@@ -3,6 +3,7 @@ use cached::proc_macro::cached;
 use miette::IntoDiagnostic;
 use once_cell::sync::Lazy;
 use regex::Regex;
+use semver::Version;
 use serde::de::DeserializeOwned;
 use serde::Serialize;
 use sha2::{Digest, Sha256};
@@ -19,6 +20,11 @@ use tracing::trace;
 
 pub static ENV_VAR: Lazy<Regex> = Lazy::new(|| Regex::new(r"\$([A-Z0-9_]+)").unwrap());
 
+#[cached]
+pub fn get_proto_version() -> Version {
+    Version::parse(env!("CARGO_PKG_VERSION")).unwrap()
+}
+
 pub fn get_proto_home() -> miette::Result<PathBuf> {
     // if cfg!(debug_assertions) {
     //     return Ok(get_home_dir()?.join(".proto-debug"));

crates/core/src/tool.rs

@@ -1,8 +1,8 @@
 use crate::error::ProtoError;
 use crate::events::*;
 use crate::helpers::{
-    extract_filename_from_url, hash_file_contents, is_archive_file, is_cache_enabled, is_offline,
-    remove_bin_file, ENV_VAR,
+    extract_filename_from_url, get_proto_version, hash_file_contents, is_archive_file,
+    is_cache_enabled, is_offline, remove_bin_file, ENV_VAR,
 };
 use crate::host_funcs::{create_host_functions, HostData};
 use crate::proto::ProtoEnvironment;
@@ -258,6 +258,7 @@ impl Tool {
     /// Return contextual information to pass to WASM plugin functions.
     pub fn create_context(&self) -> ToolContext {
         ToolContext {
+            proto_version: Some(get_proto_version()),
             tool_dir: self.to_virtual_path(&self.get_tool_dir()),
             version: self.get_resolved_version(),
         }

crates/pdk-api/src/api.rs

@@ -22,10 +22,13 @@ json_struct!(
 json_struct!(
     /// Information about the current state of the tool.
     pub struct ToolContext {
+        /// The version of proto (the core crate) calling plugin functions.
+        pub proto_version: Option<Version>,
+
         /// Virtual path to the tool's installation directory.
         pub tool_dir: VirtualPath,
 
-        /// Current version. Will be "latest" if not resolved.
+        /// Current version. Will be a "latest" alias if not resolved.
         pub version: VersionSpec,
     }
 );