@ericsanchezok/meta-protocol 1.1.20 → 1.1.22

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "@ericsanchezok/meta-protocol",
-  "version": "1.1.20",
+  "version": "1.1.22",
   "type": "module",
   "license": "MIT",
   "types": "./src/index.ts",

package/src/env.ts

@@ -34,14 +34,23 @@ export namespace MetaProtocolEnv {
 
   const PLACEHOLDER_ALIASES = new Set(["undefined", "null", "none", "nil", "n/a"])
 
+  const ENVID_PREFIX = "env_"
+
+  export type InvalidReason = "placeholder_alias" | "invalid_format"
+
   export class InvalidEnvIDError extends Error {
     constructor(
       readonly envID: string,
-      readonly reason: "placeholder_alias",
+      readonly reason: InvalidReason,
     ) {
       super(
-        `Invalid envID \"${envID}\". This looks like a placeholder value, not a real remote environment ID. ` +
-          `For local execution, omit envID entirely. For remote execution, pass a real remote envID such as \"env_...\".`,
+        reason === "placeholder_alias"
+          ? `Invalid envID "${envID}". This looks like a placeholder value, not a real remote environment ID. ` +
+              `For local execution, do NOT include the envID parameter at all — remove it from your tool call. ` +
+              `For remote execution, pass a real remote envID such as "env_...".`
+          : `Invalid envID "${envID}". Remote environment IDs must start with "${ENVID_PREFIX}". ` +
+              `For local execution, do NOT include the envID parameter at all — remove it from your tool call. ` +
+              `Do not try to pass a value meaning "local" or "omit" — simply leave out the envID key entirely.`,
       )
       this.name = "MetaProtocolInvalidEnvIDError"
     }
@@ -66,6 +75,10 @@ export namespace MetaProtocolEnv {
       throw new InvalidEnvIDError(trimmed, "placeholder_alias")
     }
 
+    if (!trimmed.startsWith(ENVID_PREFIX)) {
+      throw new InvalidEnvIDError(trimmed, "invalid_format")
+    }
+
     return trimmed as EnvID
   }