@getmagical/cli 0.1.17 → 0.1.18

package/dist/index.js

@@ -1345,7 +1345,7 @@ var require_helpers = __commonJS({
       if (instance.helpers[helperName]) {
         instance.hooks[helperName] = instance.helpers[helperName];
         if (!keepHelper) {
-          delete instance.helpers[helperName];
+          instance.helpers[helperName] = void 0;
         }
       }
     }
@@ -1437,22 +1437,6 @@ var require_logger = __commonJS({
   }
 });
 
-// ../../node_modules/handlebars/dist/cjs/handlebars/internal/create-new-lookup-object.js
-var require_create_new_lookup_object = __commonJS({
-  "../../node_modules/handlebars/dist/cjs/handlebars/internal/create-new-lookup-object.js"(exports) {
-    "use strict";
-    exports.__esModule = true;
-    exports.createNewLookupObject = createNewLookupObject;
-    var _utils = require_utils();
-    function createNewLookupObject() {
-      for (var _len = arguments.length, sources = Array(_len), _key = 0; _key < _len; _key++) {
-        sources[_key] = arguments[_key];
-      }
-      return _utils.extend.apply(void 0, [/* @__PURE__ */ Object.create(null)].concat(sources));
-    }
-  }
-});
-
 // ../../node_modules/handlebars/dist/cjs/handlebars/internal/proto-access.js
 var require_proto_access = __commonJS({
   "../../node_modules/handlebars/dist/cjs/handlebars/internal/proto-access.js"(exports) {
@@ -1464,25 +1448,28 @@ var require_proto_access = __commonJS({
     function _interopRequireDefault(obj) {
       return obj && obj.__esModule ? obj : { "default": obj };
     }
-    var _createNewLookupObject = require_create_new_lookup_object();
+    var _utils = require_utils();
     var _logger = require_logger();
     var _logger2 = _interopRequireDefault(_logger);
     var loggedProperties = /* @__PURE__ */ Object.create(null);
     function createProtoAccessControl(runtimeOptions) {
-      var defaultMethodWhiteList = /* @__PURE__ */ Object.create(null);
-      defaultMethodWhiteList["constructor"] = false;
-      defaultMethodWhiteList["__defineGetter__"] = false;
-      defaultMethodWhiteList["__defineSetter__"] = false;
-      defaultMethodWhiteList["__lookupGetter__"] = false;
-      var defaultPropertyWhiteList = /* @__PURE__ */ Object.create(null);
-      defaultPropertyWhiteList["__proto__"] = false;
+      var propertyWhiteList = /* @__PURE__ */ Object.create(null);
+      propertyWhiteList["__proto__"] = false;
+      _utils.extend(propertyWhiteList, runtimeOptions.allowedProtoProperties);
+      var methodWhiteList = /* @__PURE__ */ Object.create(null);
+      methodWhiteList["constructor"] = false;
+      methodWhiteList["__defineGetter__"] = false;
+      methodWhiteList["__defineSetter__"] = false;
+      methodWhiteList["__lookupGetter__"] = false;
+      methodWhiteList["__lookupSetter__"] = false;
+      _utils.extend(methodWhiteList, runtimeOptions.allowedProtoMethods);
       return {
         properties: {
-          whitelist: _createNewLookupObject.createNewLookupObject(defaultPropertyWhiteList, runtimeOptions.allowedProtoProperties),
+          whitelist: propertyWhiteList,
           defaultValue: runtimeOptions.allowProtoPropertiesByDefault
         },
         methods: {
-          whitelist: _createNewLookupObject.createNewLookupObject(defaultMethodWhiteList, runtimeOptions.allowedProtoMethods),
+          whitelist: methodWhiteList,
           defaultValue: runtimeOptions.allowProtoMethodsByDefault
         }
       };
@@ -1535,7 +1522,7 @@ var require_base = __commonJS({
     var _logger = require_logger();
     var _logger2 = _interopRequireDefault(_logger);
     var _internalProtoAccess = require_proto_access();
-    var VERSION = "4.7.8";
+    var VERSION = "4.7.9";
     exports.VERSION = VERSION;
     var COMPILER_REVISION = 8;
     exports.COMPILER_REVISION = COMPILER_REVISION;
@@ -1721,14 +1708,12 @@ var require_runtime = __commonJS({
           }
         }
         partial = env.VM.resolvePartial.call(this, partial, context, options);
-        var extendedOptions = Utils.extend({}, options, {
-          hooks: this.hooks,
-          protoAccessControl: this.protoAccessControl
-        });
-        var result = env.VM.invokePartial.call(this, partial, context, extendedOptions);
+        options.hooks = this.hooks;
+        options.protoAccessControl = this.protoAccessControl;
+        var result = env.VM.invokePartial.call(this, partial, context, options);
         if (result == null && env.compile) {
           options.partials[options.name] = env.compile(partial, templateSpec.compilerOptions, env);
-          result = options.partials[options.name](context, extendedOptions);
+          result = options.partials[options.name](context, options);
         }
         if (result != null) {
           if (options.indent) {
@@ -1773,7 +1758,7 @@ var require_runtime = __commonJS({
           for (var i = 0; i < len; i++) {
             var result = depths[i] && container.lookupProperty(depths[i], name);
             if (result != null) {
-              return depths[i][name];
+              return result;
             }
           }
         },
@@ -1839,8 +1824,9 @@ var require_runtime = __commonJS({
       ret.isTop = true;
       ret._setup = function(options) {
         if (!options.partial) {
-          var mergedHelpers = Utils.extend({}, env.helpers, options.helpers);
-          wrapHelpersToPassLookupProperty(mergedHelpers, container);
+          var mergedHelpers = {};
+          addHelpers(mergedHelpers, env.helpers, container);
+          addHelpers(mergedHelpers, options.helpers, container);
           container.helpers = mergedHelpers;
           if (templateSpec.usePartial) {
             container.partials = container.mergeIfNeeded(options.partials, env.partials);
@@ -1890,18 +1876,18 @@ var require_runtime = __commonJS({
     function resolvePartial(partial, context, options) {
       if (!partial) {
         if (options.name === "@partial-block") {
-          partial = options.data["partial-block"];
+          partial = lookupOwnProperty(options.data, "partial-block");
         } else {
-          partial = options.partials[options.name];
+          partial = lookupOwnProperty(options.partials, options.name);
         }
       } else if (!partial.call && !options.name) {
         options.name = partial;
-        partial = options.partials[partial];
+        partial = lookupOwnProperty(options.partials, partial);
       }
       return partial;
     }
     function invokePartial(partial, context, options) {
-      var currentPartialBlock = options.data && options.data["partial-block"];
+      var currentPartialBlock = lookupOwnProperty(options.data, "partial-block");
       options.partial = true;
       if (options.ids) {
         options.data.contextPath = options.ids[0] || options.data.contextPath;
@@ -1934,6 +1920,11 @@ var require_runtime = __commonJS({
     function noop() {
       return "";
     }
+    function lookupOwnProperty(obj, name) {
+      if (obj && Object.prototype.hasOwnProperty.call(obj, name)) {
+        return obj[name];
+      }
+    }
     function initData(context, data) {
       if (!data || !("root" in data)) {
         data = data ? _base.createFrame(data) : {};
@@ -1949,16 +1940,18 @@ var require_runtime = __commonJS({
       }
       return prog;
     }
-    function wrapHelpersToPassLookupProperty(mergedHelpers, container) {
-      Object.keys(mergedHelpers).forEach(function(helperName) {
-        var helper = mergedHelpers[helperName];
+    function addHelpers(mergedHelpers, helpers, container) {
+      if (!helpers) return;
+      Object.keys(helpers).forEach(function(helperName) {
+        var helper = helpers[helperName];
         mergedHelpers[helperName] = passLookupPropertyOption(helper, container);
       });
     }
     function passLookupPropertyOption(helper, container) {
       var lookupProperty = container.lookupProperty;
       return _internalWrapHelper.wrapHelper(helper, function(options) {
-        return Utils.extend({ lookupProperty }, options);
+        options.lookupProperty = lookupProperty;
+        return options;
       });
     }
   }
@@ -2768,7 +2761,7 @@ var require_parser = __commonJS({
               break;
           }
         };
-        lexer2.rules = [/^(?:[^\x00]*?(?=(\{\{)))/, /^(?:[^\x00]+)/, /^(?:[^\x00]{2,}?(?=(\{\{|\\\{\{|\\\\\{\{|$)))/, /^(?:\{\{\{\{(?=[^/]))/, /^(?:\{\{\{\{\/[^\s!"#%-,\.\/;->@\[-\^`\{-~]+(?=[=}\s\/.])\}\}\}\})/, /^(?:[^\x00]+?(?=(\{\{\{\{)))/, /^(?:[\s\S]*?--(~)?\}\})/, /^(?:\()/, /^(?:\))/, /^(?:\{\{\{\{)/, /^(?:\}\}\}\})/, /^(?:\{\{(~)?>)/, /^(?:\{\{(~)?#>)/, /^(?:\{\{(~)?#\*?)/, /^(?:\{\{(~)?\/)/, /^(?:\{\{(~)?\^\s*(~)?\}\})/, /^(?:\{\{(~)?\s*else\s*(~)?\}\})/, /^(?:\{\{(~)?\^)/, /^(?:\{\{(~)?\s*else\b)/, /^(?:\{\{(~)?\{)/, /^(?:\{\{(~)?&)/, /^(?:\{\{(~)?!--)/, /^(?:\{\{(~)?![\s\S]*?\}\})/, /^(?:\{\{(~)?\*?)/, /^(?:=)/, /^(?:\.\.)/, /^(?:\.(?=([=~}\s\/.)|])))/, /^(?:[\/.])/, /^(?:\s+)/, /^(?:\}(~)?\}\})/, /^(?:(~)?\}\})/, /^(?:"(\\["]|[^"])*")/, /^(?:'(\\[']|[^'])*')/, /^(?:@)/, /^(?:true(?=([~}\s)])))/, /^(?:false(?=([~}\s)])))/, /^(?:undefined(?=([~}\s)])))/, /^(?:null(?=([~}\s)])))/, /^(?:-?[0-9]+(?:\.[0-9]+)?(?=([~}\s)])))/, /^(?:as\s+\|)/, /^(?:\|)/, /^(?:([^\s!"#%-,\.\/;->@\[-\^`\{-~]+(?=([=~}\s\/.)|]))))/, /^(?:\[(\\\]|[^\]])*\])/, /^(?:.)/, /^(?:$)/];
+        lexer2.rules = [/^(?:[^\x00]*?(?=(\{\{)))/, /^(?:[^\x00]+)/, /^(?:[^\x00]{2,}?(?=(\{\{|\\\{\{|\\\\\{\{|$)))/, /^(?:\{\{\{\{(?=[^\/]))/, /^(?:\{\{\{\{\/[^\s!"#%-,\.\/;->@\[-\^`\{-~]+(?=[=}\s\/.])\}\}\}\})/, /^(?:[^\x00]+?(?=(\{\{\{\{)))/, /^(?:[\s\S]*?--(~)?\}\})/, /^(?:\()/, /^(?:\))/, /^(?:\{\{\{\{)/, /^(?:\}\}\}\})/, /^(?:\{\{(~)?>)/, /^(?:\{\{(~)?#>)/, /^(?:\{\{(~)?#\*?)/, /^(?:\{\{(~)?\/)/, /^(?:\{\{(~)?\^\s*(~)?\}\})/, /^(?:\{\{(~)?\s*else\s*(~)?\}\})/, /^(?:\{\{(~)?\^)/, /^(?:\{\{(~)?\s*else\b)/, /^(?:\{\{(~)?\{)/, /^(?:\{\{(~)?&)/, /^(?:\{\{(~)?!--)/, /^(?:\{\{(~)?![\s\S]*?\}\})/, /^(?:\{\{(~)?\*?)/, /^(?:=)/, /^(?:\.\.)/, /^(?:\.(?=([=~}\s\/.)|])))/, /^(?:[\/.])/, /^(?:\s+)/, /^(?:\}(~)?\}\})/, /^(?:(~)?\}\})/, /^(?:"(\\["]|[^"])*")/, /^(?:'(\\[']|[^'])*')/, /^(?:@)/, /^(?:true(?=([~}\s)])))/, /^(?:false(?=([~}\s)])))/, /^(?:undefined(?=([~}\s)])))/, /^(?:null(?=([~}\s)])))/, /^(?:-?[0-9]+(?:\.[0-9]+)?(?=([~}\s)])))/, /^(?:as\s+\|)/, /^(?:\|)/, /^(?:([^\s!"#%-,\.\/;->@\[-\^`\{-~]+(?=([=~}\s\/.)|]))))/, /^(?:\[(\\\]|[^\]])*\])/, /^(?:.)/, /^(?:$)/];
         lexer2.conditions = { "mu": { "rules": [7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44], "inclusive": false }, "emu": { "rules": [2], "inclusive": false }, "com": { "rules": [6], "inclusive": false }, "raw": { "rules": [3, 4, 5], "inclusive": false }, "INITIAL": { "rules": [0, 1, 44], "inclusive": true } };
         return lexer2;
       })();
@@ -3275,12 +3268,15 @@ var require_base2 = __commonJS({
     var _whitespaceControl2 = _interopRequireDefault(_whitespaceControl);
     var _helpers = require_helpers2();
     var Helpers = _interopRequireWildcard(_helpers);
+    var _exception = require_exception();
+    var _exception2 = _interopRequireDefault(_exception);
     var _utils = require_utils();
     exports.parser = _parser2["default"];
     var yy = {};
     _utils.extend(yy, Helpers);
     function parseWithoutProcessing(input, options) {
       if (input.type === "Program") {
+        validateInputAst(input);
         return input;
       }
       _parser2["default"].yy = yy;
@@ -3295,6 +3291,51 @@ var require_base2 = __commonJS({
       var strip = new _whitespaceControl2["default"](options);
       return strip.accept(ast);
     }
+    function validateInputAst(ast) {
+      validateAstNode(ast);
+    }
+    function validateAstNode(node) {
+      if (node == null) {
+        return;
+      }
+      if (Array.isArray(node)) {
+        node.forEach(validateAstNode);
+        return;
+      }
+      if (typeof node !== "object") {
+        return;
+      }
+      if (node.type === "PathExpression") {
+        if (!isValidDepth(node.depth)) {
+          throw new _exception2["default"]("Invalid AST: PathExpression.depth must be an integer");
+        }
+        if (!Array.isArray(node.parts)) {
+          throw new _exception2["default"]("Invalid AST: PathExpression.parts must be an array");
+        }
+        for (var i = 0; i < node.parts.length; i++) {
+          if (typeof node.parts[i] !== "string") {
+            throw new _exception2["default"]("Invalid AST: PathExpression.parts must only contain strings");
+          }
+        }
+      } else if (node.type === "NumberLiteral") {
+        if (typeof node.value !== "number" || !isFinite(node.value)) {
+          throw new _exception2["default"]("Invalid AST: NumberLiteral.value must be a number");
+        }
+      } else if (node.type === "BooleanLiteral") {
+        if (typeof node.value !== "boolean") {
+          throw new _exception2["default"]("Invalid AST: BooleanLiteral.value must be a boolean");
+        }
+      }
+      Object.keys(node).forEach(function(propertyName) {
+        if (propertyName === "loc") {
+          return;
+        }
+        validateAstNode(node[propertyName]);
+      });
+    }
+    function isValidDepth(depth) {
+      return typeof depth === "number" && isFinite(depth) && Math.floor(depth) === depth && depth >= 0;
+    }
   }
 });
 
@@ -5734,12 +5775,10 @@ var require_javascript_compiler = __commonJS({
           var programs = _context.programs;
           var decorators = _context.decorators;
           for (i = 0, l = programs.length; i < l; i++) {
-            if (programs[i]) {
-              ret[i] = programs[i];
-              if (decorators[i]) {
-                ret[i + "_d"] = decorators[i];
-                ret.useDecorators = true;
-              }
+            ret[i] = programs[i];
+            if (decorators[i]) {
+              ret[i + "_d"] = decorators[i];
+              ret.useDecorators = true;
             }
           }
           if (this.environment.usePartial) {
@@ -6000,22 +6039,25 @@ var require_javascript_compiler = __commonJS({
         }
         this.resolvePath("data", parts, 0, true, strict);
       },
-      resolvePath: function resolvePath(type, parts, i, falsy, strict) {
+      resolvePath: function resolvePath(type, parts, startPartIndex, falsy, strict) {
         var _this2 = this;
         if (this.options.strict || this.options.assumeObjects) {
-          this.push(strictLookup(this.options.strict && strict, this, parts, i, type));
+          this.push(strictLookup(this.options.strict && strict, this, parts, startPartIndex, type));
           return;
         }
         var len = parts.length;
-        for (; i < len; i++) {
-          this.replaceStack(function(current) {
-            var lookup = _this2.nameLookup(current, parts[i], type);
+        var _loop = function(i2) {
+          _this2.replaceStack(function(current) {
+            var lookup = _this2.nameLookup(current, parts[i2], type);
             if (!falsy) {
               return [" != null ? ", lookup, " : ", current];
             } else {
               return [" && ", lookup];
             }
           });
+        };
+        for (var i = startPartIndex; i < len; i++) {
+          _loop(i);
         }
       },
       // [resolvePossibleLambda]
@@ -6119,7 +6161,9 @@ var require_javascript_compiler = __commonJS({
       // and inserts the decorator into the decorators list.
       registerDecorator: function registerDecorator(paramSize, name) {
         var foundDecorator = this.nameLookup("decorators", name, "decorator"), options = this.setupHelperArgs(name, paramSize);
-        this.decorators.push(["fn = ", this.decorators.functionCall(foundDecorator, "", ["fn", "props", "container", options]), " || fn;"]);
+        this.decorators.push(["var decorator = ", foundDecorator, ";"]);
+        this.decorators.push(['if (typeof decorator !== "function") { throw new Error(', this.quotedString('Missing decorator: "' + name + '"'), "); }"]);
+        this.decorators.push(["fn = ", this.decorators.functionCall("decorator", "", ["fn", "props", "container", options]), " || fn;"]);
       },
       // [invokeHelper]
       //
@@ -6266,8 +6310,7 @@ var require_javascript_compiler = __commonJS({
           compiler = new this.compiler();
           var existing = this.matchExistingProgram(child);
           if (existing == null) {
-            this.context.programs.push("");
-            var index = this.context.programs.length;
+            var index = this.context.programs.push("") - 1;
             child.index = index;
             child.name = "program" + index;
             this.context.programs[index] = compiler.compile(child, options, this.context, !this.precompile);
@@ -6511,16 +6554,16 @@ var require_javascript_compiler = __commonJS({
     JavaScriptCompiler.isValidJavaScriptVariableName = function(name) {
       return !JavaScriptCompiler.RESERVED_WORDS[name] && /^[a-zA-Z_$][0-9a-zA-Z_$]*$/.test(name);
     };
-    function strictLookup(requireTerminal, compiler, parts, i, type) {
+    function strictLookup(requireTerminal, compiler, parts, startPartIndex, type) {
       var stack = compiler.popStack(), len = parts.length;
       if (requireTerminal) {
         len--;
       }
-      for (; i < len; i++) {
+      for (var i = startPartIndex; i < len; i++) {
         stack = compiler.nameLookup(stack, parts[i], type);
       }
       if (requireTerminal) {
-        return [compiler.aliasable("container.strict"), "(", stack, ", ", compiler.quotedString(parts[i]), ", ", JSON.stringify(compiler.source.currentLocation), " )"];
+        return [compiler.aliasable("container.strict"), "(", stack, ", ", compiler.quotedString(parts[len]), ", ", JSON.stringify(compiler.source.currentLocation), " )"];
       } else {
         return stack;
       }
@@ -7603,6 +7646,16 @@ function ErrFromThrowable(error) {
     error
   };
 }
+function resolveAppErrorInfo(errorInfo, cause) {
+  if (typeof errorInfo !== "function") {
+    return errorInfo;
+  }
+  const result = fromThrowable(() => errorInfo(cause), "resolve-app-error-info-error");
+  return isOk(result) ? result.value : void 0;
+}
+function isOk(result) {
+  return result._tag === "Ok";
+}
 function isErr(result) {
   return result._tag === "Err";
 }
@@ -7611,7 +7664,7 @@ function fromThrowable(fn, errorType, errorInfo) {
     const result = fn();
     if (result && typeof result.then === "function") {
       return result.then((value) => Ok(value)).catch((err) => Err({
-        ...errorInfo,
+        ...resolveAppErrorInfo(errorInfo, err),
         type: errorType,
         cause: err
       }));
@@ -7619,7 +7672,7 @@ function fromThrowable(fn, errorType, errorInfo) {
     return Ok(result);
   } catch (err) {
     return Err({
-      ...errorInfo,
+      ...resolveAppErrorInfo(errorInfo, err),
       type: errorType,
       cause: err
     });
@@ -8299,6 +8352,7 @@ var browserProviderOptionsSchema = z6.object({
     viewport: viewportSizeSchema.optional()
   }).optional().describe("Configuration options for local browser execution (development only)."),
   hyperbrowser: z6.object({
+    solveCaptchas: z6.boolean().default(true).optional().describe("Automatically solve CAPTCHAs in the background when encountered."),
     viewport: viewportSizeSchema.optional()
   }).optional().describe("Configuration options specific to the Hyperbrowser provider."),
   steel: z6.object({
@@ -10021,6 +10075,7 @@ var agentBrowserProviderOptionsSelection = `            browserbase {
               }
             }
             hyperbrowser {
+              solveCaptchas
               viewport {
                 width
                 height
@@ -10383,14 +10438,12 @@ query GetAutomationAgents($ids: [ID!]!) {
     operationName: "GetAutomationDiffFromPublished",
     kind: "query",
     inputSchema: z17.object({
-      automationId: z17.string().min(1),
-      draftVersionId: z17.string().min(1).optional(),
-      publishedVersionId: z17.string().min(1).optional()
+      automationId: z17.string().min(1)
     }),
     cli: {
       name: "get-automation-diff-from-published",
       path: ["automations", "diff-from-published"],
-      description: "Fetch draft-vs-published automation change scope.",
+      description: "Fetch draft-vs-published automation JSON Patch.",
       resultKey: "automationDiffFromPublished",
       options: [
         stringOption({
@@ -10398,39 +10451,128 @@ query GetAutomationAgents($ids: [ID!]!) {
           flagName: "automation-id",
           description: "Automation ID.",
           required: true
-        }),
-        stringOption({
-          inputKey: "draftVersionId",
-          flagName: "draft-version-id",
-          description: "Draft automation version ID to compare from."
-        }),
-        stringOption({
-          inputKey: "publishedVersionId",
-          flagName: "published-version-id",
-          description: "Published automation version ID to compare against."
         })
       ]
     },
     mcp: { fileName: "automationDiffFromPublished.graphql" },
-    document: `# Query deterministic draft-vs-published agent and field changes
-query GetAutomationDiffFromPublished($automationId: ID!, $draftVersionId: ID, $publishedVersionId: ID) {
-  automationDiffFromPublished(automationId: $automationId, draftVersionId: $draftVersionId, publishedVersionId: $publishedVersionId) {
+    document: `# Query JSON Patch changes from published automation JSON to draft automation JSON
+query GetAutomationDiffFromPublished($automationId: ID!) {
+  automationDiffFromPublished(automationId: $automationId) {
     automationId
     automationName
     mode
-    publishedAutomationId
+    draftVersionId
+    publishedVersionId
     hasChanges
-    changedAgents {
-      agentId
-      agentName
-      changeTypes
-      changedFields
-      changes {
-        type
-        field
-      }
-    }
+    changes
   }
+}`
+  }),
+  createOperationSpec({
+    operationName: "GetAutomationDiffVersions",
+    kind: "query",
+    inputSchema: z17.object({
+      baseVersionId: z17.string().min(1),
+      targetVersionId: z17.string().min(1)
+    }),
+    cli: {
+      name: "get-automation-diff-versions",
+      path: ["automations", "diff-versions"],
+      description: "Fetch automation JSON Patch between two saved versions.",
+      resultKey: "automationDiffVersions",
+      options: [
+        stringOption({
+          inputKey: "baseVersionId",
+          flagName: "base-version-id",
+          description: "Older automation version ID to compare from.",
+          required: true
+        }),
+        stringOption({
+          inputKey: "targetVersionId",
+          flagName: "target-version-id",
+          description: "Newer automation version ID to compare to.",
+          required: true
+        })
+      ]
+    },
+    mcp: { fileName: "automationDiffVersions.graphql" },
+    document: `# Query JSON Patch changes between two normalized automation JSON payloads
+query GetAutomationDiffVersions($baseVersionId: ID!, $targetVersionId: ID!) {
+  automationDiffVersions(baseVersionId: $baseVersionId, targetVersionId: $targetVersionId) {
+    baseAutomationId
+    baseAutomationName
+    baseVersionId
+    targetAutomationId
+    targetAutomationName
+    targetVersionId
+    mode
+    hasChanges
+    changes
+  }
+}`
+  }),
+  createOperationSpec({
+    operationName: "GetAutomationVersionJson",
+    kind: "query",
+    inputSchema: z17.object({
+      versionId: z17.string().min(1),
+      paths: z17.array(z17.string().min(1)).optional(),
+      format: z17.enum(["normalized", "export"]).optional()
+    }),
+    cli: {
+      name: "get-automation-version-json",
+      path: ["automations", "versions", "get-json"],
+      description: "Fetch one saved automation version as normalized automation JSON by default. Pass --format export for raw import/export JSON.",
+      resultKey: "automationVersionJson",
+      options: [
+        stringOption({
+          inputKey: "versionId",
+          flagName: "version-id",
+          description: "Saved automation version ID.",
+          required: true
+        }),
+        stringOption({
+          inputKey: "format",
+          flagName: "format",
+          description: "Optional output format: normalized or export."
+        }),
+        stringArrayOption({
+          inputKey: "paths",
+          flagName: "paths",
+          description: "Optional comma-separated JSON Pointer paths to fetch from normalized automation JSON."
+        })
+      ]
+    },
+    mcp: { fileName: "automationVersionJson.graphql" },
+    document: `# Query one saved automation version as normalized automation JSON by default, or raw import/export JSON with format: export
+query GetAutomationVersionJson($versionId: ID!, $paths: [String!], $format: String) {
+  automationVersionJson(versionId: $versionId, paths: $paths, format: $format)
+}`
+  }),
+  createOperationSpec({
+    operationName: "GetAutomationVersionJsonSkeleton",
+    kind: "query",
+    inputSchema: z17.object({
+      versionId: z17.string().min(1)
+    }),
+    cli: {
+      name: "get-automation-version-json-skeleton",
+      path: ["automations", "versions", "get-skeleton"],
+      description: "Fetch one saved automation version as compact normalized automation JSON skeleton.",
+      resultKey: "automationVersionJsonSkeleton",
+      options: [
+        stringOption({
+          inputKey: "versionId",
+          flagName: "version-id",
+          description: "Saved automation version ID.",
+          required: true
+        })
+      ]
+    },
+    mcp: { fileName: "automationVersionJsonSkeleton.graphql" },
+    document: `# Query one saved automation version as compact normalized automation JSON skeleton
+query GetAutomationVersionJsonSkeleton($versionId: ID!) {
+  automationVersionJsonSkeleton(versionId: $versionId)
 }`
   }),
   createOperationSpec({