@forzalabs/remora 2.0.2 → 2.1.0

package/index.js

@@ -1190,8 +1190,8 @@ var require_levels = __commonJS({
 var require_align = __commonJS({
   "../../node_modules/logform/align.js"(exports2, module2) {
     "use strict";
-    var format3 = require_format();
-    module2.exports = format3((info) => {
+    var format4 = require_format();
+    module2.exports = format4((info) => {
       info.message = `	${info.message}`;
       return info;
     });
@@ -1202,9 +1202,9 @@ var require_align = __commonJS({
 var require_errors = __commonJS({
   "../../node_modules/logform/errors.js"(exports2, module2) {
     "use strict";
-    var format3 = require_format();
+    var format4 = require_format();
     var { LEVEL, MESSAGE } = require_triple_beam();
-    module2.exports = format3((einfo, { stack, cause }) => {
+    module2.exports = format4((einfo, { stack, cause }) => {
       if (einfo instanceof Error) {
         const info = Object.assign({}, einfo, {
           level: einfo.level,
@@ -1340,7 +1340,7 @@ var require_cli2 = __commonJS({
 var require_combine = __commonJS({
   "../../node_modules/logform/combine.js"(exports2, module2) {
     "use strict";
-    var format3 = require_format();
+    var format4 = require_format();
     function cascade(formats) {
       if (!formats.every(isValidFormat)) {
         return;
@@ -1367,7 +1367,7 @@ var require_combine = __commonJS({
       return true;
     }
     module2.exports = (...formats) => {
-      const combinedFormat = format3(cascade(formats));
+      const combinedFormat = format4(cascade(formats));
       const instance = combinedFormat();
       instance.Format = combinedFormat.Format;
       return instance;
@@ -1976,7 +1976,7 @@ ${originalIndentation}`;
 var require_json = __commonJS({
   "../../node_modules/logform/json.js"(exports2, module2) {
     "use strict";
-    var format3 = require_format();
+    var format4 = require_format();
     var { MESSAGE } = require_triple_beam();
     var stringify = require_safe_stable_stringify();
     function replacer(key, value) {
@@ -1984,7 +1984,7 @@ var require_json = __commonJS({
         return value.toString();
       return value;
     }
-    module2.exports = format3((info, opts) => {
+    module2.exports = format4((info, opts) => {
       const jsonStringify = stringify.configure(opts);
       info[MESSAGE] = jsonStringify(info, opts.replacer || replacer, opts.space);
       return info;
@@ -1996,8 +1996,8 @@ var require_json = __commonJS({
 var require_label = __commonJS({
   "../../node_modules/logform/label.js"(exports2, module2) {
     "use strict";
-    var format3 = require_format();
-    module2.exports = format3((info, opts) => {
+    var format4 = require_format();
+    module2.exports = format4((info, opts) => {
       if (opts.message) {
         info.message = `[${opts.label}] ${info.message}`;
         return info;
@@ -2012,10 +2012,10 @@ var require_label = __commonJS({
 var require_logstash = __commonJS({
   "../../node_modules/logform/logstash.js"(exports2, module2) {
     "use strict";
-    var format3 = require_format();
+    var format4 = require_format();
     var { MESSAGE } = require_triple_beam();
     var jsonStringify = require_safe_stable_stringify();
-    module2.exports = format3((info) => {
+    module2.exports = format4((info) => {
       const logstash = {};
       if (info.message) {
         logstash["@message"] = info.message;
@@ -2036,7 +2036,7 @@ var require_logstash = __commonJS({
 var require_metadata = __commonJS({
   "../../node_modules/logform/metadata.js"(exports2, module2) {
     "use strict";
-    var format3 = require_format();
+    var format4 = require_format();
     function fillExcept(info, fillExceptKeys, metadataKey) {
       const savedKeys = fillExceptKeys.reduce((acc, key) => {
         acc[key] = info[key];
@@ -2061,7 +2061,7 @@ var require_metadata = __commonJS({
       }, {});
       return info;
     }
-    module2.exports = format3((info, opts = {}) => {
+    module2.exports = format4((info, opts = {}) => {
       let metadataKey = "metadata";
       if (opts.key) {
         metadataKey = opts.key;
@@ -2205,9 +2205,9 @@ var require_ms = __commonJS({
 var require_ms2 = __commonJS({
   "../../node_modules/logform/ms.js"(exports2, module2) {
     "use strict";
-    var format3 = require_format();
+    var format4 = require_format();
     var ms2 = require_ms();
-    module2.exports = format3((info) => {
+    module2.exports = format4((info) => {
       const curr = +/* @__PURE__ */ new Date();
       exports2.diff = curr - (exports2.prevTime || curr);
       exports2.prevTime = curr;
@@ -2222,9 +2222,9 @@ var require_pretty_print = __commonJS({
   "../../node_modules/logform/pretty-print.js"(exports2, module2) {
     "use strict";
     var inspect = require("util").inspect;
-    var format3 = require_format();
+    var format4 = require_format();
     var { LEVEL, MESSAGE, SPLAT } = require_triple_beam();
-    module2.exports = format3((info, opts = {}) => {
+    module2.exports = format4((info, opts = {}) => {
       const stripped = Object.assign({}, info);
       delete stripped[LEVEL];
       delete stripped[MESSAGE];
@@ -2258,10 +2258,10 @@ var require_printf = __commonJS({
 var require_simple = __commonJS({
   "../../node_modules/logform/simple.js"(exports2, module2) {
     "use strict";
-    var format3 = require_format();
+    var format4 = require_format();
     var { MESSAGE } = require_triple_beam();
     var jsonStringify = require_safe_stable_stringify();
-    module2.exports = format3((info) => {
+    module2.exports = format4((info) => {
       const stringifiedRest = jsonStringify(Object.assign({}, info, {
         level: void 0,
         message: void 0,
@@ -2383,14 +2383,14 @@ function assign(origObj) {
   }
   return origObj;
 }
-function parse(dateStr, format3, i18n) {
+function parse(dateStr, format4, i18n) {
   if (i18n === void 0) {
     i18n = {};
   }
-  if (typeof format3 !== "string") {
+  if (typeof format4 !== "string") {
     throw new Error("Invalid format in fecha parse");
   }
-  format3 = globalMasks[format3] || format3;
+  format4 = globalMasks[format4] || format4;
   if (dateStr.length > 1e3) {
     return null;
   }
@@ -2408,7 +2408,7 @@ function parse(dateStr, format3, i18n) {
   };
   var parseInfo = [];
   var literals = [];
-  var newFormat = format3.replace(literal, function($0, $1) {
+  var newFormat = format4.replace(literal, function($0, $1) {
     literals.push(regexEscape($1));
     return "@@@";
   });
@@ -2770,8 +2770,8 @@ var require_timestamp = __commonJS({
   "../../node_modules/logform/timestamp.js"(exports2, module2) {
     "use strict";
     var fecha2 = (init_fecha(), __toCommonJS(fecha_exports));
-    var format3 = require_format();
-    module2.exports = format3((info, opts = {}) => {
+    var format4 = require_format();
+    module2.exports = format4((info, opts = {}) => {
       if (opts.format) {
         info.timestamp = typeof opts.format === "function" ? opts.format() : fecha2.format(/* @__PURE__ */ new Date(), opts.format);
       }
@@ -2791,9 +2791,9 @@ var require_uncolorize = __commonJS({
   "../../node_modules/logform/uncolorize.js"(exports2, module2) {
     "use strict";
     var colors = require_safe();
-    var format3 = require_format();
+    var format4 = require_format();
     var { MESSAGE } = require_triple_beam();
-    module2.exports = format3((info, opts) => {
+    module2.exports = format4((info, opts) => {
       if (opts.level !== false) {
         info.level = colors.strip(info.level);
       }
@@ -2812,10 +2812,10 @@ var require_uncolorize = __commonJS({
 var require_logform = __commonJS({
   "../../node_modules/logform/index.js"(exports2) {
     "use strict";
-    var format3 = exports2.format = require_format();
+    var format4 = exports2.format = require_format();
     exports2.levels = require_levels();
     function exposeFormat(name, requireFormat) {
-      Object.defineProperty(format3, name, {
+      Object.defineProperty(format4, name, {
         get() {
           return requireFormat();
         },
@@ -2880,17 +2880,17 @@ var require_logform = __commonJS({
 var require_common = __commonJS({
   "../../node_modules/winston/lib/winston/common.js"(exports2) {
     "use strict";
-    var { format: format3 } = require("util");
+    var { format: format4 } = require("util");
     exports2.warn = {
       deprecated(prop) {
         return () => {
-          throw new Error(format3("{ %s } was removed in winston@3.0.0.", prop));
+          throw new Error(format4("{ %s } was removed in winston@3.0.0.", prop));
         };
       },
       useFormat(prop) {
         return () => {
           throw new Error([
-            format3("{ %s } was removed in winston@3.0.0.", prop),
+            format4("{ %s } was removed in winston@3.0.0.", prop),
             "Use a custom winston.format = winston.format(function) instead."
           ].join("\n"));
         };
@@ -4155,14 +4155,14 @@ var require_from = __commonJS({
       return (hint === "string" ? String : Number)(input);
     }
     var ERR_INVALID_ARG_TYPE = require_errors2().codes.ERR_INVALID_ARG_TYPE;
-    function from(Readable7, iterable, opts) {
+    function from(Readable8, iterable, opts) {
       var iterator;
       if (iterable && typeof iterable.next === "function") {
         iterator = iterable;
       } else if (iterable && iterable[Symbol.asyncIterator]) iterator = iterable[Symbol.asyncIterator]();
       else if (iterable && iterable[Symbol.iterator]) iterator = iterable[Symbol.iterator]();
       else throw new ERR_INVALID_ARG_TYPE("iterable", ["Iterable"], iterable);
-      var readable = new Readable7(_objectSpread({
+      var readable = new Readable8(_objectSpread({
         objectMode: true
       }, opts));
       var reading = false;
@@ -4202,9 +4202,9 @@ var require_from = __commonJS({
 var require_stream_readable = __commonJS({
   "../../node_modules/readable-stream/lib/_stream_readable.js"(exports2, module2) {
     "use strict";
-    module2.exports = Readable7;
+    module2.exports = Readable8;
     var Duplex;
-    Readable7.ReadableState = ReadableState;
+    Readable8.ReadableState = ReadableState;
     var EE = require("events").EventEmitter;
     var EElistenerCount = function EElistenerCount2(emitter, type) {
       return emitter.listeners(type).length;
@@ -4239,7 +4239,7 @@ var require_stream_readable = __commonJS({
     var StringDecoder;
     var createReadableStreamAsyncIterator;
     var from;
-    require_inherits()(Readable7, Stream);
+    require_inherits()(Readable8, Stream);
     var errorOrDestroy = destroyImpl.errorOrDestroy;
     var kProxyEvents = ["error", "close", "destroy", "pause", "resume"];
     function prependListener(emitter, event, fn) {
@@ -4283,9 +4283,9 @@ var require_stream_readable = __commonJS({
         this.encoding = options.encoding;
       }
     }
-    function Readable7(options) {
+    function Readable8(options) {
       Duplex = Duplex || require_stream_duplex();
-      if (!(this instanceof Readable7)) return new Readable7(options);
+      if (!(this instanceof Readable8)) return new Readable8(options);
       var isDuplex = this instanceof Duplex;
       this._readableState = new ReadableState(options, this, isDuplex);
       this.readable = true;
@@ -4295,7 +4295,7 @@ var require_stream_readable = __commonJS({
       }
       Stream.call(this);
     }
-    Object.defineProperty(Readable7.prototype, "destroyed", {
+    Object.defineProperty(Readable8.prototype, "destroyed", {
       // making it explicit this property is not enumerable
       // because otherwise some prototype manipulation in
       // userland will fail
@@ -4313,12 +4313,12 @@ var require_stream_readable = __commonJS({
         this._readableState.destroyed = value;
       }
     });
-    Readable7.prototype.destroy = destroyImpl.destroy;
-    Readable7.prototype._undestroy = destroyImpl.undestroy;
-    Readable7.prototype._destroy = function(err2, cb) {
+    Readable8.prototype.destroy = destroyImpl.destroy;
+    Readable8.prototype._undestroy = destroyImpl.undestroy;
+    Readable8.prototype._destroy = function(err2, cb) {
       cb(err2);
     };
-    Readable7.prototype.push = function(chunk, encoding) {
+    Readable8.prototype.push = function(chunk, encoding) {
       var state2 = this._readableState;
       var skipChunkCheck;
       if (!state2.objectMode) {
@@ -4335,7 +4335,7 @@ var require_stream_readable = __commonJS({
       }
       return readableAddChunk(this, chunk, encoding, false, skipChunkCheck);
     };
-    Readable7.prototype.unshift = function(chunk) {
+    Readable8.prototype.unshift = function(chunk) {
       return readableAddChunk(this, chunk, null, true, false);
     };
     function readableAddChunk(stream, chunk, encoding, addToFront, skipChunkCheck) {
@@ -4396,10 +4396,10 @@ var require_stream_readable = __commonJS({
       }
       return er2;
     }
-    Readable7.prototype.isPaused = function() {
+    Readable8.prototype.isPaused = function() {
       return this._readableState.flowing === false;
     };
-    Readable7.prototype.setEncoding = function(enc) {
+    Readable8.prototype.setEncoding = function(enc) {
       if (!StringDecoder) StringDecoder = require_string_decoder().StringDecoder;
       var decoder = new StringDecoder(enc);
       this._readableState.decoder = decoder;
@@ -4445,7 +4445,7 @@ var require_stream_readable = __commonJS({
       }
       return state2.length;
     }
-    Readable7.prototype.read = function(n4) {
+    Readable8.prototype.read = function(n4) {
       debug("read", n4);
       n4 = parseInt(n4, 10);
       var state2 = this._readableState;
@@ -4554,10 +4554,10 @@ var require_stream_readable = __commonJS({
       }
       state2.readingMore = false;
     }
-    Readable7.prototype._read = function(n4) {
+    Readable8.prototype._read = function(n4) {
       errorOrDestroy(this, new ERR_METHOD_NOT_IMPLEMENTED("_read()"));
     };
-    Readable7.prototype.pipe = function(dest, pipeOpts) {
+    Readable8.prototype.pipe = function(dest, pipeOpts) {
       var src = this;
       var state2 = this._readableState;
       switch (state2.pipesCount) {
@@ -4660,7 +4660,7 @@ var require_stream_readable = __commonJS({
         }
       };
     }
-    Readable7.prototype.unpipe = function(dest) {
+    Readable8.prototype.unpipe = function(dest) {
       var state2 = this._readableState;
       var unpipeInfo = {
         hasUnpiped: false
@@ -4694,7 +4694,7 @@ var require_stream_readable = __commonJS({
       dest.emit("unpipe", this, unpipeInfo);
       return this;
     };
-    Readable7.prototype.on = function(ev, fn) {
+    Readable8.prototype.on = function(ev, fn) {
       var res = Stream.prototype.on.call(this, ev, fn);
       var state2 = this._readableState;
       if (ev === "data") {
@@ -4715,15 +4715,15 @@ var require_stream_readable = __commonJS({
       }
       return res;
     };
-    Readable7.prototype.addListener = Readable7.prototype.on;
-    Readable7.prototype.removeListener = function(ev, fn) {
+    Readable8.prototype.addListener = Readable8.prototype.on;
+    Readable8.prototype.removeListener = function(ev, fn) {
       var res = Stream.prototype.removeListener.call(this, ev, fn);
       if (ev === "readable") {
         process.nextTick(updateReadableListening, this);
       }
       return res;
     };
-    Readable7.prototype.removeAllListeners = function(ev) {
+    Readable8.prototype.removeAllListeners = function(ev) {
       var res = Stream.prototype.removeAllListeners.apply(this, arguments);
       if (ev === "readable" || ev === void 0) {
         process.nextTick(updateReadableListening, this);
@@ -4743,7 +4743,7 @@ var require_stream_readable = __commonJS({
       debug("readable nexttick read 0");
       self2.read(0);
     }
-    Readable7.prototype.resume = function() {
+    Readable8.prototype.resume = function() {
       var state2 = this._readableState;
       if (!state2.flowing) {
         debug("resume");
@@ -4769,7 +4769,7 @@ var require_stream_readable = __commonJS({
       flow(stream);
       if (state2.flowing && !state2.reading) stream.read(0);
     }
-    Readable7.prototype.pause = function() {
+    Readable8.prototype.pause = function() {
       debug("call pause flowing=%j", this._readableState.flowing);
       if (this._readableState.flowing !== false) {
         debug("pause");
@@ -4784,7 +4784,7 @@ var require_stream_readable = __commonJS({
       debug("flow", state2.flowing);
       while (state2.flowing && stream.read() !== null) ;
     }
-    Readable7.prototype.wrap = function(stream) {
+    Readable8.prototype.wrap = function(stream) {
       var _this = this;
       var state2 = this._readableState;
       var paused = false;
@@ -4829,14 +4829,14 @@ var require_stream_readable = __commonJS({
       return this;
     };
     if (typeof Symbol === "function") {
-      Readable7.prototype[Symbol.asyncIterator] = function() {
+      Readable8.prototype[Symbol.asyncIterator] = function() {
         if (createReadableStreamAsyncIterator === void 0) {
           createReadableStreamAsyncIterator = require_async_iterator();
         }
         return createReadableStreamAsyncIterator(this);
       };
     }
-    Object.defineProperty(Readable7.prototype, "readableHighWaterMark", {
+    Object.defineProperty(Readable8.prototype, "readableHighWaterMark", {
       // making it explicit this property is not enumerable
       // because otherwise some prototype manipulation in
       // userland will fail
@@ -4845,7 +4845,7 @@ var require_stream_readable = __commonJS({
         return this._readableState.highWaterMark;
       }
     });
-    Object.defineProperty(Readable7.prototype, "readableBuffer", {
+    Object.defineProperty(Readable8.prototype, "readableBuffer", {
       // making it explicit this property is not enumerable
       // because otherwise some prototype manipulation in
       // userland will fail
@@ -4854,7 +4854,7 @@ var require_stream_readable = __commonJS({
         return this._readableState && this._readableState.buffer;
       }
     });
-    Object.defineProperty(Readable7.prototype, "readableFlowing", {
+    Object.defineProperty(Readable8.prototype, "readableFlowing", {
       // making it explicit this property is not enumerable
       // because otherwise some prototype manipulation in
       // userland will fail
@@ -4868,8 +4868,8 @@ var require_stream_readable = __commonJS({
         }
       }
     });
-    Readable7._fromList = fromList;
-    Object.defineProperty(Readable7.prototype, "readableLength", {
+    Readable8._fromList = fromList;
+    Object.defineProperty(Readable8.prototype, "readableLength", {
       // making it explicit this property is not enumerable
       // because otherwise some prototype manipulation in
       // userland will fail
@@ -4915,11 +4915,11 @@ var require_stream_readable = __commonJS({
       }
     }
     if (typeof Symbol === "function") {
-      Readable7.from = function(iterable, opts) {
+      Readable8.from = function(iterable, opts) {
         if (from === void 0) {
           from = require_from();
         }
-        return from(Readable7, iterable, opts);
+        return from(Readable8, iterable, opts);
       };
     }
     function indexOf(xs2, x2) {
@@ -4941,9 +4941,9 @@ var require_stream_duplex = __commonJS({
       return keys2;
     };
     module2.exports = Duplex;
-    var Readable7 = require_stream_readable();
+    var Readable8 = require_stream_readable();
     var Writable2 = require_stream_writable();
-    require_inherits()(Duplex, Readable7);
+    require_inherits()(Duplex, Readable8);
     {
       keys = objectKeys(Writable2.prototype);
       for (v3 = 0; v3 < keys.length; v3++) {
@@ -4956,7 +4956,7 @@ var require_stream_duplex = __commonJS({
     var v3;
     function Duplex(options) {
       if (!(this instanceof Duplex)) return new Duplex(options);
-      Readable7.call(this, options);
+      Readable8.call(this, options);
       Writable2.call(this, options);
       this.allowHalfOpen = true;
       if (options) {
@@ -6498,7 +6498,7 @@ var require_pipeline = __commonJS({
       if (typeof streams[streams.length - 1] !== "function") return noop;
       return streams.pop();
     }
-    function pipeline5() {
+    function pipeline6() {
       for (var _len = arguments.length, streams = new Array(_len), _key = 0; _key < _len; _key++) {
         streams[_key] = arguments[_key];
       }
@@ -6521,7 +6521,7 @@ var require_pipeline = __commonJS({
       });
       return streams.reduce(pipe);
     }
-    module2.exports = pipeline5;
+    module2.exports = pipeline6;
   }
 });
 
@@ -7759,15 +7759,15 @@ var require_index_cjs = __commonJS({
       };
     }
     function wrapConversion(toModel, graph2) {
-      const path29 = [graph2[toModel].parent, toModel];
+      const path30 = [graph2[toModel].parent, toModel];
       let fn = convert$1[graph2[toModel].parent][toModel];
       let cur = graph2[toModel].parent;
       while (graph2[cur].parent) {
-        path29.unshift(graph2[cur].parent);
+        path30.unshift(graph2[cur].parent);
         fn = link(convert$1[graph2[cur].parent][cur], fn);
         cur = graph2[cur].parent;
       }
-      fn.conversion = path29;
+      fn.conversion = path30;
       return fn;
     }
     function route(fromModel) {
@@ -8397,7 +8397,7 @@ var require_node2 = __commonJS({
 var require_tail_file = __commonJS({
   "../../node_modules/winston/lib/winston/tail-file.js"(exports2, module2) {
     "use strict";
-    var fs32 = require("fs");
+    var fs33 = require("fs");
     var { StringDecoder } = require("string_decoder");
     var { Stream } = require_readable();
     function noop() {
@@ -8418,7 +8418,7 @@ var require_tail_file = __commonJS({
         stream.emit("end");
         stream.emit("close");
       };
-      fs32.open(options.file, "a+", "0644", (err2, fd) => {
+      fs33.open(options.file, "a+", "0644", (err2, fd) => {
         if (err2) {
           if (!iter) {
             stream.emit("error", err2);
@@ -8430,10 +8430,10 @@ var require_tail_file = __commonJS({
         }
         (function read() {
           if (stream.destroyed) {
-            fs32.close(fd, noop);
+            fs33.close(fd, noop);
             return;
           }
-          return fs32.read(fd, buffer, 0, buffer.length, pos, (error, bytes) => {
+          return fs33.read(fd, buffer, 0, buffer.length, pos, (error, bytes) => {
             if (error) {
               if (!iter) {
                 stream.emit("error", error);
@@ -8492,8 +8492,8 @@ var require_tail_file = __commonJS({
 var require_file = __commonJS({
   "../../node_modules/winston/lib/winston/transports/file.js"(exports2, module2) {
     "use strict";
-    var fs32 = require("fs");
-    var path29 = require("path");
+    var fs33 = require("fs");
+    var path30 = require("path");
     var asyncSeries = require_series();
     var zlib3 = require("zlib");
     var { MESSAGE } = require_triple_beam();
@@ -8523,14 +8523,14 @@ var require_file = __commonJS({
         this._onError = this._onError.bind(this);
         if (options.filename || options.dirname) {
           throwIf("filename or dirname", "stream");
-          this._basename = this.filename = options.filename ? path29.basename(options.filename) : "winston.log";
-          this.dirname = options.dirname || path29.dirname(options.filename);
+          this._basename = this.filename = options.filename ? path30.basename(options.filename) : "winston.log";
+          this.dirname = options.dirname || path30.dirname(options.filename);
           this.options = options.options || { flags: "a" };
         } else if (options.stream) {
           console.warn("options.stream will be removed in winston@4. Use winston.transports.Stream");
           throwIf("stream", "filename", "maxsize");
           this._dest = this._stream.pipe(this._setupStream(options.stream));
-          this.dirname = path29.dirname(this._dest.path);
+          this.dirname = path30.dirname(this._dest.path);
         } else {
           throw new Error("Cannot log to file without filename or stream.");
         }
@@ -8693,11 +8693,11 @@ var require_file = __commonJS({
           options = {};
         }
         options = normalizeQuery(options);
-        const file = path29.join(this.dirname, this.filename);
+        const file = path30.join(this.dirname, this.filename);
         let buff = "";
         let results = [];
         let row = 0;
-        const stream = fs32.createReadStream(file, {
+        const stream = fs33.createReadStream(file, {
           encoding: "utf8"
         });
         stream.on("error", (err2) => {
@@ -8798,7 +8798,7 @@ var require_file = __commonJS({
        * TODO: Refactor me.
        */
       stream(options = {}) {
-        const file = path29.join(this.dirname, this.filename);
+        const file = path30.join(this.dirname, this.filename);
         const stream = new Stream();
         const tail = {
           file,
@@ -8848,8 +8848,8 @@ var require_file = __commonJS({
        */
       stat(callback) {
         const target = this._getFile();
-        const fullpath = path29.join(this.dirname, target);
-        fs32.stat(fullpath, (err2, stat) => {
+        const fullpath = path30.join(this.dirname, target);
+        fs33.stat(fullpath, (err2, stat) => {
           if (err2 && err2.code === "ENOENT") {
             debug("ENOENT\xA0ok", fullpath);
             this.filename = target;
@@ -8952,9 +8952,9 @@ var require_file = __commonJS({
        * @returns {WritableStream} Stream that writes to disk for the active file.
        */
       _createStream(source) {
-        const fullpath = path29.join(this.dirname, this.filename);
+        const fullpath = path30.join(this.dirname, this.filename);
         debug("create stream start", fullpath, this.options);
-        const dest = fs32.createWriteStream(fullpath, this.options).on("error", (err2) => debug(err2)).on("close", () => debug("close", dest.path, dest.bytesWritten)).on("open", () => {
+        const dest = fs33.createWriteStream(fullpath, this.options).on("error", (err2) => debug(err2)).on("close", () => debug("close", dest.path, dest.bytesWritten)).on("open", () => {
           debug("file open ok", fullpath);
           this.emit("open", fullpath);
           source.pipe(dest);
@@ -8977,16 +8977,16 @@ var require_file = __commonJS({
        */
       _incFile(callback) {
         debug("_incFile", this.filename);
-        const ext = path29.extname(this._basename);
-        const basename = path29.basename(this._basename, ext);
+        const ext = path30.extname(this._basename);
+        const basename = path30.basename(this._basename, ext);
         const tasks = [];
         if (this.zippedArchive) {
           tasks.push(
             function(cb) {
               const num = this._created > 0 && !this.tailable ? this._created : "";
               this._compressFile(
-                path29.join(this.dirname, `${basename}${num}${ext}`),
-                path29.join(this.dirname, `${basename}${num}${ext}.gz`),
+                path30.join(this.dirname, `${basename}${num}${ext}`),
+                path30.join(this.dirname, `${basename}${num}${ext}.gz`),
                 cb
               );
             }.bind(this)
@@ -9011,8 +9011,8 @@ var require_file = __commonJS({
        * @private
        */
       _getFile() {
-        const ext = path29.extname(this._basename);
-        const basename = path29.basename(this._basename, ext);
+        const ext = path30.extname(this._basename);
+        const basename = path30.basename(this._basename, ext);
         const isRotation = this.rotationFormat ? this.rotationFormat() : this._created;
         return !this.tailable && this._created ? `${basename}${isRotation}${ext}` : `${basename}${ext}`;
       }
@@ -9032,8 +9032,8 @@ var require_file = __commonJS({
         const isOldest = oldest !== 0 ? oldest : "";
         const isZipped = this.zippedArchive ? ".gz" : "";
         const filePath = `${basename}${isOldest}${ext}${isZipped}`;
-        const target = path29.join(this.dirname, filePath);
-        fs32.unlink(target, callback);
+        const target = path30.join(this.dirname, filePath);
+        fs33.unlink(target, callback);
       }
       /**
        * Roll files forward based on integer, up to maxFiles. e.g. if base if
@@ -9055,20 +9055,20 @@ var require_file = __commonJS({
         for (let x2 = this.maxFiles - 1; x2 > 1; x2--) {
           tasks.push(function(i6, cb) {
             let fileName = `${basename}${i6 - 1}${ext}${isZipped}`;
-            const tmppath = path29.join(this.dirname, fileName);
-            fs32.exists(tmppath, (exists) => {
+            const tmppath = path30.join(this.dirname, fileName);
+            fs33.exists(tmppath, (exists) => {
               if (!exists) {
                 return cb(null);
               }
               fileName = `${basename}${i6}${ext}${isZipped}`;
-              fs32.rename(tmppath, path29.join(this.dirname, fileName), cb);
+              fs33.rename(tmppath, path30.join(this.dirname, fileName), cb);
             });
           }.bind(this, x2));
         }
         asyncSeries(tasks, () => {
-          fs32.rename(
-            path29.join(this.dirname, `${basename}${ext}${isZipped}`),
-            path29.join(this.dirname, `${basename}1${ext}${isZipped}`),
+          fs33.rename(
+            path30.join(this.dirname, `${basename}${ext}${isZipped}`),
+            path30.join(this.dirname, `${basename}1${ext}${isZipped}`),
             callback
           );
         });
@@ -9082,22 +9082,22 @@ var require_file = __commonJS({
        * @private
        */
       _compressFile(src, dest, callback) {
-        fs32.access(src, fs32.F_OK, (err2) => {
+        fs33.access(src, fs33.F_OK, (err2) => {
           if (err2) {
             return callback();
           }
           var gzip = zlib3.createGzip();
-          var inp = fs32.createReadStream(src);
-          var out = fs32.createWriteStream(dest);
+          var inp = fs33.createReadStream(src);
+          var out = fs33.createWriteStream(dest);
           out.on("finish", () => {
-            fs32.unlink(src, callback);
+            fs33.unlink(src, callback);
           });
           inp.pipe(gzip).pipe(out);
         });
       }
       _createLogDirIfNotExist(dirPath) {
-        if (!fs32.existsSync(dirPath)) {
-          fs32.mkdirSync(dirPath, { recursive: true });
+        if (!fs33.existsSync(dirPath)) {
+          fs33.mkdirSync(dirPath, { recursive: true });
         }
       }
     };
@@ -9181,9 +9181,9 @@ var require_http = __commonJS({
         };
         const auth = options.params.auth || null;
         delete options.params.auth;
-        const path29 = options.params.path || null;
+        const path30 = options.params.path || null;
         delete options.params.path;
-        this._request(options, auth, path29, (err2, res, body) => {
+        this._request(options, auth, path30, (err2, res, body) => {
           if (res && res.statusCode !== 200) {
             err2 = new Error(`Invalid HTTP Status Code: ${res.statusCode}`);
           }
@@ -9211,12 +9211,12 @@ var require_http = __commonJS({
           method: "stream",
           params: options
         };
-        const path29 = options.params.path || null;
+        const path30 = options.params.path || null;
         delete options.params.path;
         const auth = options.params.auth || null;
         delete options.params.auth;
         let buff = "";
-        const req = this._request(options, auth, path29);
+        const req = this._request(options, auth, path30);
         stream.destroy = () => req.destroy();
         req.on("data", (data) => {
           data = (buff + data).split(/\n+/);
@@ -9242,14 +9242,14 @@ var require_http = __commonJS({
        * @param {string} path - request path
        * @param {function} callback - Continuation to respond to when complete.
        */
-      _request(options, auth, path29, callback) {
+      _request(options, auth, path30, callback) {
         options = options || {};
         auth = auth || this.auth;
-        path29 = path29 || this.path || "";
+        path30 = path30 || this.path || "";
         if (this.batch) {
-          this._doBatch(options, callback, auth, path29);
+          this._doBatch(options, callback, auth, path30);
         } else {
-          this._doRequest(options, callback, auth, path29);
+          this._doRequest(options, callback, auth, path30);
         }
       }
       /**
@@ -9259,18 +9259,18 @@ var require_http = __commonJS({
        * @param {Object?} auth - authentication options
        * @param {string} path - request path
        */
-      _doBatch(options, callback, auth, path29) {
+      _doBatch(options, callback, auth, path30) {
         this.batchOptions.push(options);
         if (this.batchOptions.length === 1) {
           const me3 = this;
           this.batchCallback = callback;
           this.batchTimeoutID = setTimeout(function() {
             me3.batchTimeoutID = -1;
-            me3._doBatchRequest(me3.batchCallback, auth, path29);
+            me3._doBatchRequest(me3.batchCallback, auth, path30);
           }, this.batchInterval);
         }
         if (this.batchOptions.length === this.batchCount) {
-          this._doBatchRequest(this.batchCallback, auth, path29);
+          this._doBatchRequest(this.batchCallback, auth, path30);
         }
       }
       /**
@@ -9279,14 +9279,14 @@ var require_http = __commonJS({
        * @param {Object?} auth - authentication options
        * @param {string} path - request path
        */
-      _doBatchRequest(callback, auth, path29) {
+      _doBatchRequest(callback, auth, path30) {
         if (this.batchTimeoutID > 0) {
           clearTimeout(this.batchTimeoutID);
           this.batchTimeoutID = -1;
         }
         const batchOptionsCopy = this.batchOptions.slice();
         this.batchOptions = [];
-        this._doRequest(batchOptionsCopy, callback, auth, path29);
+        this._doRequest(batchOptionsCopy, callback, auth, path30);
       }
       /**
        * Make a request to a winstond server or any http server which can
@@ -9296,7 +9296,7 @@ var require_http = __commonJS({
        * @param {Object?} auth - authentication options
        * @param {string} path - request path
        */
-      _doRequest(options, callback, auth, path29) {
+      _doRequest(options, callback, auth, path30) {
         const headers = Object.assign({}, this.headers);
         if (auth && auth.bearer) {
           headers.Authorization = `Bearer ${auth.bearer}`;
@@ -9306,7 +9306,7 @@ var require_http = __commonJS({
           method: "POST",
           host: this.host,
           port: this.port,
-          path: `/${path29.replace(/^\//, "")}`,
+          path: `/${path30.replace(/^\//, "")}`,
           headers,
           auth: auth && auth.username && auth.password ? `${auth.username}:${auth.password}` : "",
           agent: this.agent
@@ -10275,7 +10275,7 @@ var require_logger = __commonJS({
        */
       configure({
         silent,
-        format: format3,
+        format: format4,
         defaultMeta,
         levels,
         level = "info",
@@ -10294,7 +10294,7 @@ var require_logger = __commonJS({
           this.clear();
         }
         this.silent = silent;
-        this.format = format3 || this.format || require_json()();
+        this.format = format4 || this.format || require_json()();
         this.defaultMeta = defaultMeta || null;
         this.levels = levels || this.levels || config.npm.levels;
         this.level = level;
@@ -11116,18 +11116,32 @@ ${stack}` : base;
 });
 
 // ../../packages/logger/src/logger/Logger.ts
-var import_chalk, MAX_CAUSE_DEPTH, Logger, logger, Logger_default;
+var import_util, import_chalk, MAX_CAUSE_DEPTH, LOG_RECORD_VERSION, MAX_FIELD_CHARS, ANSI_PATTERN, nativeConsole, Logger, logger, Logger_default;
 var init_Logger = __esm({
   "../../packages/logger/src/logger/Logger.ts"() {
+    import_util = require("util");
+    init_src();
     import_chalk = __toESM(require("chalk"), 1);
     init_FileLogService();
     MAX_CAUSE_DEPTH = 10;
+    LOG_RECORD_VERSION = 1;
+    MAX_FIELD_CHARS = 3e4;
+    ANSI_PATTERN = /\u001B\[[0-9;]*m/g;
+    nativeConsole = {
+      log: console.log.bind(console),
+      info: console.info.bind(console),
+      warn: console.warn.bind(console),
+      error: console.error.bind(console)
+    };
     Logger = class {
       constructor() {
         // Counts lines written to the console. In-place TTY renderers (the CLI progress bar) read it to
         // detect that something else has printed since their last frame, so they redraw on a new line
         // instead of moving the cursor up and overwriting a log message.
         this._consoleWrites = 0;
+        // Whether console.* has been redirected into this logger. Once per process, and one-way: our
+        // own writes use `nativeConsole`, so there is nothing to restore it for.
+        this._consoleCaptured = false;
         this.setLevel = (level) => this._level = level;
         this.enableFileLogging = (folder, file) => {
           this._fileLoggingFolder = folder;
@@ -11161,9 +11175,28 @@ var init_Logger = __esm({
           this._level = "debug";
           if (fileLoggingFolder && process.env.NODE_ENV !== "development") {
             this.enableFileLogging(fileLoggingFolder);
-            console.error("Enabled file logger.");
+            nativeConsole.error("Enabled file logger.");
           }
         };
+        /**
+         * Routes `console.*` through this logger, so code that never heard of it still writes one line
+         * per record. Call once from a deployed process entrypoint; a no-op under the `text` format,
+         * where a human is reading the console and Node's own formatting is the better rendering.
+         *
+         * Interception rather than a sweep of the call sites: the requirement is about the STREAM, not
+         * about our code — an express handler, a driver and a dependency all write to the same stdout,
+         * and a rule enforced at the call sites is a rule that the next `console.error` breaks.
+         */
+        this.captureConsole = () => {
+          if (this._consoleCaptured) return;
+          if (this.consoleFormat() !== "json") return;
+          this._consoleCaptured = true;
+          console.log = (...args) => this.info((0, import_util.format)(...args));
+          console.info = console.log;
+          console.debug = (...args) => this.log((0, import_util.format)(...args));
+          console.warn = (...args) => this.warn((0, import_util.format)(...args));
+          console.error = (...args) => args.length === 1 && args[0] instanceof Error ? this.error(args[0]) : this.error((0, import_util.format)(...args));
+        };
         // The file sink replaces the console only for the CLI: there a human is watching the progress bar
         // and can read the log file afterwards. Anywhere else that file sits on an ephemeral container
         // layer nobody reads, and stdout is the only sink reaching the log driver (ECS -> CloudWatch), so
@@ -11174,18 +11207,15 @@ var init_Logger = __esm({
           if (myLevel !== "debug") return;
           FileLogService_default.write("DEBUG", String(message));
           if (this.isConsoleSuppressed()) return;
-          console.log(import_chalk.default.cyanBright("DEBUG"), message);
-          this._consoleWrites++;
+          this.writeConsole("debug", message);
         };
         this.info = (message) => {
           FileLogService_default.write("INFO", String(message));
           if (this.isConsoleSuppressed()) return;
-          console.info(message);
-          this._consoleWrites++;
+          this.writeConsole("info", message);
         };
         this.warn = (message) => {
-          console.warn(message);
-          this._consoleWrites++;
+          this.writeConsole("warn", message);
           FileLogService_default.write("WARN", String(message));
         };
         this.flush = () => FileLogService_default.flush();
@@ -11203,11 +11233,88 @@ var init_Logger = __esm({
             message = String(error);
           }
           const suppressed = this.isConsoleSuppressed();
-          console.error(message);
-          this._consoleWrites++;
+          this.writeConsole("error", message, suppressed ? void 0 : stack);
           FileLogService_default.write("ERROR", message, stack);
-          if (stack && !suppressed)
-            console.error(stack);
+        };
+        /**
+         * How console records are rendered: `text` for a human at a terminal, `json` for a log pipeline.
+         *
+         * Deployed processes default to `json` because there ONE RECORD MUST BE ONE LINE: the awslogs
+         * driver turns every newline on stdout into its own CloudWatch event, so a stack trace arrived as
+         * thirty separate events, none of them carrying the message they belonged to, interleaved with
+         * whatever the other threads were writing. `REMORA_LOG_FORMAT` overrides the default either way.
+         * Same rule as StateEmitter, whose records share the stream.
+         */
+        this.consoleFormat = () => {
+          const configured = process.env.REMORA_LOG_FORMAT?.toLowerCase();
+          if (configured === "json" || configured === "text")
+            return configured;
+          return process.env.REMORA_RUNTIME_CONTEXT === "cli" ? "text" : "json";
+        };
+        /**
+         * The one place anything of ours reaches the console.
+         *
+         * `stack` belongs to the record it explains: a second line in text mode, a field of the same JSON
+         * object in json mode — never a record of its own, which is how it would lose its message.
+         */
+        this.writeConsole = (level, message, stack) => {
+          this._consoleWrites++;
+          if (this.consoleFormat() === "json")
+            return this.writeJson(level, message, stack);
+          this.writeText(level, message, stack);
+        };
+        this.writeText = (level, message, stack) => {
+          if (level === "debug")
+            nativeConsole.log(import_chalk.default.cyanBright("DEBUG"), message);
+          else if (level === "info")
+            nativeConsole.info(message);
+          else if (level === "warn")
+            nativeConsole.warn(message);
+          else
+            nativeConsole.error(message);
+          if (stack)
+            nativeConsole.error(stack);
+        };
+        /**
+         * One JSON object, one line, one log event. Written straight to the stream rather than through
+         * `console`, which reformats and re-wraps what it is given.
+         */
+        this.writeJson = (level, message, stack) => {
+          const record = {
+            remora: "log",
+            v: LOG_RECORD_VERSION,
+            ts: DSTE_default.now().toISOString(),
+            level,
+            message: this.asField(message),
+            ...stack ? { stack: this.asField(stack) } : {}
+          };
+          const stream = level === "warn" || level === "error" ? process.stderr : process.stdout;
+          stream.write(`${this.stringify(record)}
+`);
+        };
+        /** A loggable value as one clamped, colour-free string. */
+        this.asField = (value) => {
+          const plain = this.asText(value).replace(ANSI_PATTERN, "");
+          if (plain.length <= MAX_FIELD_CHARS)
+            return plain;
+          return `${plain.slice(0, MAX_FIELD_CHARS)}\u2026[+${plain.length - MAX_FIELD_CHARS} chars]`;
+        };
+        this.asText = (value) => {
+          if (typeof value === "string")
+            return value;
+          if (value instanceof Error)
+            return value.stack ?? value.message;
+          if (typeof value === "object" && value !== null)
+            return this.stringify(value);
+          return String(value);
+        };
+        /** JSON.stringify that cannot throw: a circular or unserializable value still has to be logged. */
+        this.stringify = (value) => {
+          try {
+            return JSON.stringify(value);
+          } catch {
+            return String(value);
+          }
         };
         // Node's Error.stack omits `cause` — only util.inspect renders it, and we log strings rather
         // than Error objects. Without unwrapping here the root reason of a wrapped error is lost on any
@@ -11527,7 +11634,7 @@ var CONSTANTS, Constants_default;
 var init_Constants = __esm({
   "../../packages/constants/src/Constants.ts"() {
     CONSTANTS = {
-      cliVersion: "2.0.2",
+      cliVersion: "2.1.0",
       backendVersion: 1,
       backendPort: 5088,
       workerVersion: 2,
@@ -11584,7 +11691,12 @@ var init_Constants = __esm({
          * whole run, so the entire work list is submitted at once and needs an upper bound. A queued
          * task holds references, not copies, so this bounds the work list rather than memory.
          */
-        MAX_WORKER_QUEUE_SIZE: 1e5
+        MAX_WORKER_QUEUE_SIZE: 1e5,
+        /**
+         * Rows a sample may ask for out of the pipeline. A sample is a look at the data, never an
+         * export of it — `remora sample -s` and the preview's Data tab are both held to this.
+         */
+        MAX_SAMPLE_ROWS: 100
       }
     };
     Constants_default = CONSTANTS;
@@ -12572,10 +12684,10 @@ var init_Validator = __esm({
               errors.push(`There are outputs with the same type. (duplicates type: ${duplicatesTypes.join(" and ")})`);
             }
             for (const output of consumer.outputs) {
-              const format3 = output.format.toUpperCase();
-              if (format3 === "CSV" || format3 === "JSON" || format3 === "PARQUET" || format3 === "TXT") {
+              const format4 = output.format.toUpperCase();
+              if (format4 === "CSV" || format4 === "JSON" || format4 === "PARQUET" || format4 === "TXT") {
                 if (!output.exportDestination)
-                  errors.push(`A static file output must have an export destination set (${format3})`);
+                  errors.push(`A static file output must have an export destination set (${format4})`);
                 else if (!Environment_default.getSource(output.exportDestination))
                   errors.push(`The export destination "${output.exportDestination}" was not found in the sources.`);
               }
@@ -12647,14 +12759,14 @@ var init_Validator = __esm({
           const errors = [];
           const positionalFormats = ["CSV", "TXT", "PARQUET"];
           for (const output of (consumer.outputs ?? []).filter((x2) => x2.omitNull === true)) {
-            const format3 = output.format.toUpperCase();
-            if (positionalFormats.includes(format3)) {
-              errors.push(`The ${format3} output of consumer "${consumer.name}" declares "omitNull", which only applies to JSON/API output: a positional column can't be omitted from a row.`);
+            const format4 = output.format.toUpperCase();
+            if (positionalFormats.includes(format4)) {
+              errors.push(`The ${format4} output of consumer "${consumer.name}" declares "omitNull", which only applies to JSON/API output: a positional column can't be omitted from a row.`);
               continue;
             }
             const positional = (consumer.outputs ?? []).filter((x2) => positionalFormats.includes(x2.format.toUpperCase()));
             if (positional.length > 0)
-              errors.push(`The ${format3} output of consumer "${consumer.name}" declares "omitNull", but the consumer also writes ${positional.map((x2) => x2.format.toUpperCase()).join(" and ")}. Every output is serialized from one record, so omitting fields would break the positional one \u2014 split them into two consumers.`);
+              errors.push(`The ${format4} output of consumer "${consumer.name}" declares "omitNull", but the consumer also writes ${positional.map((x2) => x2.format.toUpperCase()).join(" and ")}. Every output is serialized from one record, so omitting fields would break the positional one \u2014 split them into two consumers.`);
           }
           return errors;
         };
@@ -12733,7 +12845,7 @@ var init_Validator = __esm({
          */
         this.detectOnFinishRecursion = (consumer) => {
           const errors = [];
-          const path29 = [];
+          const path30 = [];
           const targetsOf = (cons) => {
             const names = [];
             for (const output of cons.outputs ?? []) {
@@ -12745,17 +12857,17 @@ var init_Validator = __esm({
             return names;
           };
           const walk = (name) => {
-            if (path29.some((x2) => x2.toLowerCase() === name.toLowerCase())) {
-              errors.push(`Consumer "${consumer.name}" has a cyclic run-consumer (onSuccess/onError) chain: ${[...path29, name].join(" -> ")}`);
+            if (path30.some((x2) => x2.toLowerCase() === name.toLowerCase())) {
+              errors.push(`Consumer "${consumer.name}" has a cyclic run-consumer (onSuccess/onError) chain: ${[...path30, name].join(" -> ")}`);
               return true;
             }
             const cons = Environment_default.getConsumer(name);
             if (!cons) return false;
-            path29.push(name);
+            path30.push(name);
             for (const target of targetsOf(cons)) {
               if (walk(target)) return true;
             }
-            path29.pop();
+            path30.pop();
             return false;
           };
           walk(consumer.name);
@@ -14241,8 +14353,8 @@ var init_HttpClient = __esm({
             throw new Error(err2.message ?? "An error occurred on GET.");
           }
         };
-        this.getWorkerUrl = (path29) => {
-          const cleanPath = path29.startsWith("/") ? path29.substring(1) : path29;
+        this.getWorkerUrl = (path30) => {
+          const cleanPath = path30.startsWith("/") ? path30.substring(1) : path30;
           return `${this.workerHost}/${cleanPath}`;
         };
         this.workerHost = ProcessENVManager_default.getEnvVariable("REMORA_WORKER_HOST") || "http://worker:5069";
@@ -14685,14 +14797,14 @@ var init_readFile = __esm({
     import_promises3 = require("fs/promises");
     filePromises = {};
     fileIntercept = {};
-    readFile2 = (path29, options) => {
-      if (fileIntercept[path29] !== void 0) {
-        return fileIntercept[path29];
+    readFile2 = (path30, options) => {
+      if (fileIntercept[path30] !== void 0) {
+        return fileIntercept[path30];
       }
-      if (!filePromises[path29] || options?.ignoreCache) {
-        filePromises[path29] = (0, import_promises3.readFile)(path29, "utf8");
+      if (!filePromises[path30] || options?.ignoreCache) {
+        filePromises[path30] = (0, import_promises3.readFile)(path30, "utf8");
       }
-      return filePromises[path29];
+      return filePromises[path30];
     };
   }
 });
@@ -14804,8 +14916,8 @@ var init_externalDataInterceptor = __esm({
       getFileRecord() {
         return fileIntercept;
       },
-      interceptFile(path29, contents) {
-        fileIntercept[path29] = Promise.resolve(contents);
+      interceptFile(path30, contents) {
+        fileIntercept[path30] = Promise.resolve(contents);
       },
       getTokenRecord() {
         return tokenIntercept;
@@ -17587,17 +17699,17 @@ var init_split_header = __esm({
 });
 
 // ../../node_modules/@smithy/core/dist-es/submodules/serde/value/NumericValue.js
-var format2, NumericValue;
+var format3, NumericValue;
 var init_NumericValue = __esm({
   "../../node_modules/@smithy/core/dist-es/submodules/serde/value/NumericValue.js"() {
-    format2 = /^-?\d*(\.\d+)?$/;
+    format3 = /^-?\d*(\.\d+)?$/;
     NumericValue = class _NumericValue {
       string;
       type;
       constructor(string, type) {
         this.string = string;
         this.type = type;
-        if (!format2.test(string)) {
+        if (!format3.test(string)) {
           throw new Error(`@smithy/core/serde - NumericValue must only contain [0-9], at most one decimal point ".", and an optional negation prefix "-".`);
         }
       }
@@ -17609,7 +17721,7 @@ var init_NumericValue = __esm({
           return false;
         }
         const _nv = object;
-        return _NumericValue.prototype.isPrototypeOf(object) || _nv.type === "bigDecimal" && format2.test(_nv.string);
+        return _NumericValue.prototype.isPrototypeOf(object) || _nv.type === "bigDecimal" && format3.test(_nv.string);
       }
     };
   }
@@ -17885,8 +17997,8 @@ var init_createConfigValueProvider = __esm({
               return endpoint.url.href;
             }
             if ("hostname" in endpoint) {
-              const { protocol, hostname, port, path: path29 } = endpoint;
-              return `${protocol}//${hostname}${port ? ":" + port : ""}${path29}`;
+              const { protocol, hostname, port, path: path30 } = endpoint;
+              return `${protocol}//${hostname}${port ? ":" + port : ""}${path30}`;
             }
           }
           return endpoint;
@@ -18261,18 +18373,18 @@ var getAttrPathList;
 var init_getAttrPathList = __esm({
   "../../node_modules/@smithy/core/dist-es/submodules/endpoints/util-endpoints/lib/getAttrPathList.js"() {
     init_types2();
-    getAttrPathList = (path29) => {
-      const parts = path29.split(".");
+    getAttrPathList = (path30) => {
+      const parts = path30.split(".");
       const pathList = [];
       for (const part of parts) {
         const squareBracketIndex = part.indexOf("[");
         if (squareBracketIndex !== -1) {
           if (part.indexOf("]") !== part.length - 1) {
-            throw new EndpointError(`Path: '${path29}' does not end with ']'`);
+            throw new EndpointError(`Path: '${path30}' does not end with ']'`);
           }
           const arrayIndex = part.slice(squareBracketIndex + 1, -1);
           if (Number.isNaN(parseInt(arrayIndex))) {
-            throw new EndpointError(`Invalid array index: '${arrayIndex}' in path: '${path29}'`);
+            throw new EndpointError(`Invalid array index: '${arrayIndex}' in path: '${path30}'`);
           }
           if (squareBracketIndex !== 0) {
             pathList.push(part.slice(0, squareBracketIndex));
@@ -18293,9 +18405,9 @@ var init_getAttr = __esm({
   "../../node_modules/@smithy/core/dist-es/submodules/endpoints/util-endpoints/lib/getAttr.js"() {
     init_types2();
     init_getAttrPathList();
-    getAttr = (value, path29) => getAttrPathList(path29).reduce((acc, index) => {
+    getAttr = (value, path30) => getAttrPathList(path30).reduce((acc, index) => {
       if (typeof acc !== "object") {
-        throw new EndpointError(`Index '${index}' in '${path29}' not found in '${JSON.stringify(value)}'`);
+        throw new EndpointError(`Index '${index}' in '${path30}' not found in '${JSON.stringify(value)}'`);
       } else if (Array.isArray(acc)) {
         const i6 = parseInt(index);
         return acc[i6 < 0 ? acc.length + i6 : i6];
@@ -18356,8 +18468,8 @@ var init_parseURL = __esm({
             return value;
           }
           if (typeof value === "object" && "hostname" in value) {
-            const { hostname: hostname2, port, protocol: protocol2 = "", path: path29 = "", query = {} } = value;
-            const url = new URL(`${protocol2}//${hostname2}${port ? `:${port}` : ""}${path29}`);
+            const { hostname: hostname2, port, protocol: protocol2 = "", path: path30 = "", query = {} } = value;
+            const url = new URL(`${protocol2}//${hostname2}${port ? `:${port}` : ""}${path30}`);
             url.search = Object.entries(query).map(([k7, v3]) => `${k7}=${v3}`).join("&");
             return url;
           }
@@ -20701,11 +20813,11 @@ var init_HttpBindingProtocol = __esm({
           const opTraits = translateTraits(operationSchema.traits);
           if (opTraits.http) {
             request.method = opTraits.http[0];
-            const [path29, search] = opTraits.http[1].split("?");
+            const [path30, search] = opTraits.http[1].split("?");
             if (request.path == "/") {
-              request.path = path29;
+              request.path = path30;
             } else {
-              request.path += path29;
+              request.path += path30;
             }
             const traitSearchParams = new URLSearchParams(search ?? "");
             for (const [key, value] of traitSearchParams) {
@@ -21074,8 +21186,8 @@ var init_FromStringShapeDeserializer = __esm({
           return (this.serdeContext?.base64Decoder ?? fromBase64)(data);
         }
         if (ns2.isTimestampSchema()) {
-          const format3 = determineTimestampFormat(ns2, this.settings);
-          switch (format3) {
+          const format4 = determineTimestampFormat(ns2, this.settings);
+          switch (format4) {
             case 5:
               return _parseRfc3339DateTimeWithOffset(data);
             case 6:
@@ -21197,8 +21309,8 @@ var init_ToStringShapeSerializer = __esm({
               if (!(value instanceof Date)) {
                 throw new Error(`@smithy/core/protocols - received non-Date value ${value} when schema expected Date in ${ns2.getName(true)}`);
               }
-              const format3 = determineTimestampFormat(ns2, this.settings);
-              switch (format3) {
+              const format4 = determineTimestampFormat(ns2, this.settings);
+              switch (format4) {
                 case 5:
                   this.stringBuffer = value.toISOString().replace(".000Z", "Z");
                   break;
@@ -24418,12 +24530,12 @@ or increase socketAcquisitionWarningTimeout=(millis) in the NodeHttpHandler conf
             const password = request.password ?? "";
             auth = `${username}:${password}`;
           }
-          let path29 = request.path;
+          let path30 = request.path;
           if (queryString) {
-            path29 += `?${queryString}`;
+            path30 += `?${queryString}`;
           }
           if (request.fragment) {
-            path29 += `#${request.fragment}`;
+            path30 += `#${request.fragment}`;
           }
           let hostname = request.hostname ?? "";
           if (hostname[0] === "[" && hostname.endsWith("]")) {
@@ -24435,7 +24547,7 @@ or increase socketAcquisitionWarningTimeout=(millis) in the NodeHttpHandler conf
             headers: request.headers,
             host: hostname,
             method: request.method,
-            path: path29,
+            path: path30,
             port: request.port,
             agent,
             auth
@@ -25344,10 +25456,10 @@ ${longDate}
 ${credentialScope}
 ${toHex(hashedRequest)}`;
       }
-      getCanonicalPath({ path: path29 }) {
+      getCanonicalPath({ path: path30 }) {
         if (this.uriEscapePath) {
           const normalizedPathSegments = [];
-          for (const pathSegment of path29.split("/")) {
+          for (const pathSegment of path30.split("/")) {
             if (pathSegment?.length === 0)
               continue;
             if (pathSegment === ".")
@@ -25358,11 +25470,11 @@ ${toHex(hashedRequest)}`;
               normalizedPathSegments.push(pathSegment);
             }
           }
-          const normalizedPath = `${path29?.startsWith("/") ? "/" : ""}${normalizedPathSegments.join("/")}${normalizedPathSegments.length > 0 && path29?.endsWith("/") ? "/" : ""}`;
+          const normalizedPath = `${path30?.startsWith("/") ? "/" : ""}${normalizedPathSegments.join("/")}${normalizedPathSegments.length > 0 && path30?.endsWith("/") ? "/" : ""}`;
           const doubleEncoded = escapeUri(normalizedPath);
           return doubleEncoded.replace(/%2F/g, "/");
         }
-        return path29;
+        return path30;
       }
       validateResolvedCredentials(credentials) {
         if (typeof credentials !== "object" || typeof credentials.accessKeyId !== "string" || typeof credentials.secretAccessKey !== "string") {
@@ -26432,8 +26544,8 @@ var init_JsonShapeDeserializer = __esm({
           return value;
         }
         if (ns2.isTimestampSchema() && value != null) {
-          const format3 = determineTimestampFormat(ns2, this.settings);
-          switch (format3) {
+          const format4 = determineTimestampFormat(ns2, this.settings);
+          switch (format4) {
             case 5:
               return parseRfc3339DateTimeWithOffset(value);
             case 6:
@@ -26657,8 +26769,8 @@ var init_JsonShapeSerializer = __esm({
             return (this.serdeContext?.base64Encoder ?? toBase64)(value);
           }
           if (value instanceof Date && (ns2.isTimestampSchema() || ns2.isDocumentSchema())) {
-            const format3 = determineTimestampFormat(ns2, this.settings);
-            switch (format3) {
+            const format4 = determineTimestampFormat(ns2, this.settings);
+            switch (format4) {
               case 5:
                 return value.toISOString().replace(".000Z", "Z");
               case 6:
@@ -27286,8 +27398,8 @@ var init_QueryShapeSerializer = __esm({
         } else if (ns2.isTimestampSchema()) {
           if (value instanceof Date) {
             this.writeKey(prefix2);
-            const format3 = determineTimestampFormat(ns2, this.settings);
-            switch (format3) {
+            const format4 = determineTimestampFormat(ns2, this.settings);
+            switch (format4) {
               case 5:
                 this.writeValue(value.toISOString().replace(".000Z", "Z"));
                 break;
@@ -41722,11 +41834,13 @@ var init_src7 = __esm({
 });
 
 // ../../packages/drivers/src/DeltaShareDriver.ts
-var fs10, import_promises7, MAX_LIMIT_HINT, DeltaShareSourceDriver, DeltaShareDriver_default;
+var fs10, import_promises7, import_stream, import_promises8, MAX_LIMIT_HINT, PARQUET_BATCH_ROWS, DeltaShareSourceDriver, DeltaShareDriver_default;
 var init_DeltaShareDriver = __esm({
   "../../packages/drivers/src/DeltaShareDriver.ts"() {
     fs10 = __toESM(require("fs"), 1);
     import_promises7 = __toESM(require("fs/promises"), 1);
+    import_stream = require("stream");
+    import_promises8 = require("stream/promises");
     init_src();
     init_src4();
     init_src2();
@@ -41734,6 +41848,7 @@ var init_DeltaShareDriver = __esm({
     init_DeltaSharePredicate();
     init_OidcTokenProvider();
     MAX_LIMIT_HINT = 2147483647;
+    PARQUET_BATCH_ROWS = 5e4;
     DeltaShareSourceDriver = class {
       constructor() {
         this._query = "{prefix}/shares/{share}/schemas/{schema}/tables/{table}/query";
@@ -41743,6 +41858,9 @@ var init_DeltaShareDriver = __esm({
         // Column Delta types per table, for the predicate's literals. A table's schema does not change
         // under a run, and only a read with something to push ever asks for it.
         this._columnTypes = /* @__PURE__ */ new Map();
+        // Rows held as objects at once. A run leaves this at PARQUET_BATCH_ROWS; the tests lower it so a
+        // fixture small enough to read whole still splits its row groups the way a real part file does.
+        this._batchRows = PARQUET_BATCH_ROWS;
         this.init = async (source) => {
           Affirm_default(source, "Invalid source");
           const { authentication } = source;
@@ -41803,12 +41921,11 @@ var init_DeltaShareDriver = __esm({
           Affirm_default(request, "Invalid download request");
           const table = this._resolveTable(request.fileKey);
           const deltaFiles = await this._getAllFilesInTable(table, request.disableHistory);
-          const hyparquet = await import("hyparquet");
           const lines = [];
-          for (const deltaFile of deltaFiles) {
-            const parquetRecords = await this._readParquetObjects(deltaFile);
-            lines.push(...parquetRecords.map((x2) => JSON.stringify(hyparquet.toJson(x2))));
-          }
+          for (const deltaFile of deltaFiles)
+            for await (const batch of this._readRemoteParquetBatches(deltaFile))
+              for (const record of batch)
+                lines.push(JSON.stringify(record));
           Logger_default.log(`Delta Share readAll: ${lines.length} record(s) from ${deltaFiles.length} file(s) of table "${table}"`);
           return lines;
         };
@@ -41818,22 +41935,41 @@ var init_DeltaShareDriver = __esm({
           Affirm_default(request.options.lineFrom !== void 0 && request.options.lineTo !== void 0, "Missing read range");
           const table = this._resolveTable(request.fileKey);
           const deltaFiles = await this._getAllFilesInTable(table, request.disableHistory);
-          const hyparquet = await import("hyparquet");
           const { options: { lineFrom, lineTo } } = request;
+          const lines = await this._collectLinesInRange(deltaFiles, { from: lineFrom, to: lineTo });
+          Logger_default.log(`Delta Share readLinesInRange [${lineFrom}, ${lineTo}) on table "${table}": ${lines.length} record(s)`);
+          return lines;
+        };
+        /**
+         * The records of the given range, serialized. Reading stops the moment the range is filled: a
+         * part file holds hundreds of thousands of rows and a preview asks for a handful of them, so
+         * decoding past `to` is both slow and the memory the batching above exists to avoid.
+         */
+        this._collectLinesInRange = async (deltaFiles, range2) => {
+          if (range2.to <= range2.from)
+            return [];
           const lines = [];
           let index = 0;
           for (const deltaFile of deltaFiles) {
-            const parquetRecords = await this._readParquetObjects(deltaFile);
-            for (const record of parquetRecords) {
-              if (index >= lineFrom && index < lineTo)
-                lines.push(JSON.stringify(hyparquet.toJson(record)));
-              index++;
-              if (index >= lineTo) break;
+            for await (const batch of this._readRemoteParquetBatches(deltaFile)) {
+              index = this._pushRecordsInRange(lines, batch, index, range2);
+              if (index >= range2.to)
+                return lines;
             }
           }
-          Logger_default.log(`Delta Share readLinesInRange [${lineFrom}, ${lineTo}) on table "${table}": ${lines.length} record(s)`);
           return lines;
         };
+        // The index the batch ends on, so the next batch carries on counting where this one stopped.
+        this._pushRecordsInRange = (lines, batch, index, range2) => {
+          for (const record of batch) {
+            if (index >= range2.from && index < range2.to)
+              lines.push(JSON.stringify(record));
+            index++;
+            if (index >= range2.to)
+              break;
+          }
+          return index;
+        };
         this.exist = async (_producer) => {
           void _producer;
           let nextPageToken;
@@ -41977,20 +42113,48 @@ var init_DeltaShareDriver = __esm({
             return "(unparseable url)";
           }
         };
-        this._readParquetObjects = async (deltaFile) => {
+        // Split out so the batch loop above stays one level of nesting, and so both failures name the file
+        this._readParquetMetadata = async (file, label) => {
           const hyparquet = await import("hyparquet");
-          const { compressors: compressors2 } = await Promise.resolve().then(() => (init_src7(), src_exports));
-          const byteLength = deltaFile.file.deltaSingleAction.add?.size ?? deltaFile.file.deltaSingleAction.remove?.size;
-          const startedMs = Date.now();
-          let records;
           try {
-            const file = await hyparquet.asyncBufferFromUrl({ url: deltaFile.file.url, byteLength });
-            records = await hyparquet.parquetReadObjects({ file, compressors: compressors2 });
+            return await hyparquet.parquetMetadataAsync(file);
           } catch (error) {
-            throw new Error(`Delta Share failed reading parquet from ${this._redactUrl(deltaFile.file.url)} (${byteLength ?? "?"} bytes)`, { cause: error });
+            throw new Error(`Delta Share failed reading the parquet footer of ${label}`, { cause: error });
           }
-          Logger_default.log(`Delta Share read ${records.length} record(s) from ${this._redactUrl(deltaFile.file.url)} (${byteLength ?? "?"} bytes) in ${Date.now() - startedMs}ms`);
-          return records;
+        };
+        this._readParquetBatch = async (options, label) => {
+          const hyparquet = await import("hyparquet");
+          try {
+            return await hyparquet.parquetReadObjects(options);
+          } catch (error) {
+            throw new Error(`Delta Share failed reading parquet rows [${options.rowStart}, ${options.rowEnd}) of ${label}`, { cause: error });
+          }
+        };
+        // Reads straight from the pre-signed URL. Only for the bounded readers (preview, sample): every
+        // batch refetches the row group, which is why `ready` stages the file locally instead.
+        this._readRemoteParquetBatches = (deltaFile) => {
+          const byteLength = deltaFile.file.deltaSingleAction.add?.size ?? deltaFile.file.deltaSingleAction.remove?.size;
+          const label = `${this._redactUrl(deltaFile.file.url)} (${byteLength ?? "?"} bytes)`;
+          const open = async () => {
+            const hyparquet = await import("hyparquet");
+            return await hyparquet.asyncBufferFromUrl({ url: deltaFile.file.url, byteLength });
+          };
+          return this._streamParquetBatchesFrom(open, label);
+        };
+        /**
+         * Copies a part file to local disk, streamed, so nothing but the socket buffer is ever in memory.
+         * `ready` re-reads the file once per batch and re-reading it over HTTP would refetch the same
+         * bytes every time.
+         */
+        this._downloadParquet = async (deltaFile, localPath) => {
+          const startedMs = Date.now();
+          const res = await this._fetch(deltaFile.file.url, { method: "GET" }, `parquet download of ${this._redactUrl(deltaFile.file.url)}`);
+          if (!res.ok)
+            throw new Error(`Error downloading parquet from the delta share: ${res.status} ${res.statusText} (${this._redactUrl(deltaFile.file.url)})`);
+          Affirm_default(res.body, `Empty response body downloading parquet from ${this._redactUrl(deltaFile.file.url)}`);
+          await (0, import_promises8.pipeline)(import_stream.Readable.fromWeb(res.body), fs10.createWriteStream(localPath));
+          const { size } = await import_promises7.default.stat(localPath);
+          Logger_default.log(`Delta Share staged ${this._redactUrl(deltaFile.file.url)} (${size} bytes) in ${Date.now() - startedMs}ms`);
         };
         this._serializeDatasetValue = (value) => {
           if (value === null || value === void 0)
@@ -42004,17 +42168,41 @@ var init_DeltaShareDriver = __esm({
         this._getDeltaFileKey = (table, index) => {
           return `${this._resolveSchema()}/${table}/part-${index}.parquet`;
         };
-        this._writeDatasetFile = async (localPath, records, delimiter) => {
-          if (records.length === 0)
-            return false;
-          const header = Object.keys(records[0]);
-          const lines = [
-            CSVParser_default.stringifyRow(header, delimiter),
-            ...records.map((record) => CSVParser_default.stringifyRow(header.map((column) => this._serializeDatasetValue(record[column])), delimiter))
-          ];
-          await import_promises7.default.writeFile(localPath, `${lines.join("\n")}
-`);
-          return true;
+        /**
+         * Writes the batches out as one CSV dataset file and reports how many records landed. Rows are
+         * written as they arrive rather than joined into one string first: a file's worth of lines, and
+         * the single string joining them, were each as large as the records themselves.
+         *
+         * The header is taken from the first record and reused for every later one, so a file whose rows
+         * disagree on their columns still produces a rectangular dataset.
+         */
+        this._writeDatasetFile = async (localPath, batches, delimiter) => {
+          const stream = fs10.createWriteStream(localPath);
+          let header = null;
+          let records = 0;
+          try {
+            for await (const batch of batches) {
+              for (const record of batch) {
+                if (!header) {
+                  header = Object.keys(record);
+                  await this._writeLine(stream, CSVParser_default.stringifyRow(header, delimiter));
+                }
+                await this._writeLine(stream, CSVParser_default.stringifyRow(header.map((column) => this._serializeDatasetValue(record[column])), delimiter));
+                records++;
+              }
+            }
+          } finally {
+            await new Promise((resolve) => stream.end(resolve));
+          }
+          return records;
+        };
+        // A false from write() means the buffer is full; waiting for the drain just then keeps the queued
+        // rows bounded instead of letting them pile up faster than the disk takes them.
+        this._writeLine = async (stream, line) => {
+          if (stream.write(`${line}
+`))
+            return;
+          await new Promise((resolve) => stream.once("drain", resolve));
         };
         /**
          * Every file the share reports for this table. `jsonPredicateHints` lets the server skip the
@@ -42078,30 +42266,22 @@ var init_DeltaShareDriver = __esm({
           const table = this._resolveTable(producer.settings.fileKey);
           const hints = await this._buildHints(producer, table, request.pushdown);
           const deltaFiles = await this._getAllFilesInTable(table, producer.settings.disableHistory, hints);
-          const hyparquet = await import("hyparquet");
           const delimiter = producer.settings.delimiter ?? ",";
           const files = [];
           let records = 0;
           let skipped = 0;
           for (const [index, deltaFile] of deltaFiles.entries()) {
             onProgress?.(index / deltaFiles.length);
-            const parquetRecords = await this._readParquetObjects(deltaFile);
-            if (parquetRecords.length === 0) {
-              skipped++;
-              Logger_default.log(`Delta Share ready: file ${index + 1}/${deltaFiles.length} of table "${table}" holds no records, skipping`);
-              continue;
-            }
             const sourceFileKey = this._getDeltaFileKey(table, index);
             const localPath = ExecutorScope_default.getProducerPath(scope, producer, sourceFileKey);
             ExecutorScope_default.ensurePath(localPath);
-            const jsonRecords = parquetRecords.map((record) => hyparquet.toJson(record));
-            const written = await this._writeDatasetFile(localPath, jsonRecords, delimiter);
-            if (written) {
+            const written = await this._stageDeltaFile(deltaFile, localPath, delimiter);
+            if (written > 0) {
               files.push({ fullUri: localPath, fileSize: fs10.statSync(localPath).size });
-              records += jsonRecords.length;
+              records += written;
             } else {
               skipped++;
-              Logger_default.log(`Delta Share ready: nothing written for ${sourceFileKey}, discarding the staged file`);
+              Logger_default.log(`Delta Share ready: file ${index + 1}/${deltaFiles.length} of table "${table}" (${sourceFileKey}) holds no records, discarding the staged file`);
               await import_promises7.default.unlink(localPath).catch(() => {
               });
             }
@@ -42112,6 +42292,57 @@ var init_DeltaShareDriver = __esm({
           Logger_default.log(`Delta Share ready: staged ${records} record(s) into ${files.length} dataset file(s) (${bytes} bytes) for producer "${producer.name}" from table "${table}"${skippedNote}`);
           return { files, filteredAtSource: !!hints?.jsonPredicateHints };
         };
+        /**
+         * One part file turned into one CSV dataset file, downloaded then converted a batch at a time so
+         * that neither step's memory grows with the file. The download is dropped either way — it is the
+         * dataset file the run reads from here on.
+         */
+        this._stageDeltaFile = async (deltaFile, localPath, delimiter) => {
+          const downloadPath = `${localPath}.parquet`;
+          await this._downloadParquet(deltaFile, downloadPath);
+          try {
+            const open = async () => {
+              const hyparquet = await import("hyparquet");
+              return await hyparquet.asyncBufferFromFile(downloadPath);
+            };
+            return await this._writeDatasetFile(localPath, this._streamParquetBatchesFrom(open, this._redactUrl(deltaFile.file.url)), delimiter);
+          } finally {
+            await import_promises7.default.unlink(downloadPath).catch(() => {
+            });
+          }
+        };
+      }
+      /**
+       * The rows of a part file, `_batchRows` at a time and already JSON-safe.
+       *
+       * hyparquet decodes a whole row group's columns per read either way, but only the requested rows
+       * are turned into objects — and the objects are what dominates — so a row group larger than a
+       * batch is read in several passes. Every pass re-reads the group's bytes, which is why `ready`
+       * stages the file on disk first and only the small readers below stream it from its URL.
+       */
+      async *_streamParquetBatches(file, label) {
+        const hyparquet = await import("hyparquet");
+        const { compressors: compressors2 } = await Promise.resolve().then(() => (init_src7(), src_exports));
+        const startedMs = Date.now();
+        const metadata = await this._readParquetMetadata(file, label);
+        let records = 0;
+        let groupStart = 0;
+        for (const rowGroup of metadata.row_groups) {
+          const groupRows = Number(rowGroup.num_rows);
+          const groupEnd = groupStart + groupRows;
+          for (let rowStart = groupStart; rowStart < groupEnd; rowStart += this._batchRows) {
+            const rowEnd = Math.min(rowStart + this._batchRows, groupEnd);
+            const batch = await this._readParquetBatch({ file, metadata, compressors: compressors2, rowStart, rowEnd }, label);
+            records += batch.length;
+            yield batch.map((record) => hyparquet.toJson(record));
+          }
+          groupStart = groupEnd;
+        }
+        Logger_default.log(`Delta Share read ${records} record(s) from ${label} in ${Date.now() - startedMs}ms`);
+      }
+      // The buffer is opened inside the generator so nothing is fetched until the first batch is pulled
+      async *_streamParquetBatchesFrom(open, label) {
+        yield* this._streamParquetBatches(await open(), label);
       }
     };
     DeltaShareDriver_default = DeltaShareSourceDriver;
@@ -42445,12 +42676,12 @@ var init_HttpApiDriver = __esm({
 });
 
 // ../../packages/drivers/src/DriverHelper.ts
-var import_stream, import_readline, import_promises8, import_fs9, DriverHelper, DriverHelper_default;
+var import_stream2, import_readline, import_promises9, import_fs9, DriverHelper, DriverHelper_default;
 var init_DriverHelper = __esm({
   "../../packages/drivers/src/DriverHelper.ts"() {
-    import_stream = require("stream");
+    import_stream2 = require("stream");
     import_readline = require("readline");
-    import_promises8 = require("stream/promises");
+    import_promises9 = require("stream/promises");
     import_fs9 = require("fs");
     init_src2();
     init_src();
@@ -42467,7 +42698,7 @@ var init_DriverHelper = __esm({
         let leftoverData = "";
         let globalIndex = 0;
         let lineCount = 0;
-        const headerValidationTransform = new import_stream.Transform({
+        const headerValidationTransform = new import_stream2.Transform({
           transform(chunk, encoding, callback) {
             const chunkStr = leftoverData + chunk.toString();
             const lines = chunkStr.split("\n");
@@ -42543,7 +42774,7 @@ var init_DriverHelper = __esm({
         };
         const writeOptions = append ? { flags: "a" } : {};
         const writeStream = (0, import_fs9.createWriteStream)(destinationPath, writeOptions);
-        await (0, import_promises8.pipeline)(stream, headerValidationTransform, writeStream);
+        await (0, import_promises9.pipeline)(stream, headerValidationTransform, writeStream);
         return lineCount;
       },
       appendObjectsToUnifiedFile: async (options) => {
@@ -42569,32 +42800,32 @@ var init_DriverHelper = __esm({
       },
       quickReadFile: async (filePath, lineCount) => {
         const fileStream = (0, import_fs9.createReadStream)(filePath);
-        const rl6 = (0, import_readline.createInterface)({ input: fileStream, crlfDelay: Infinity });
+        const rl7 = (0, import_readline.createInterface)({ input: fileStream, crlfDelay: Infinity });
         const lines = [];
         let counter = 0;
-        for await (const line of rl6) {
+        for await (const line of rl7) {
           lines.push(line);
           counter++;
           if (counter >= lineCount) {
             break;
           }
         }
-        rl6.close();
+        rl7.close();
         fileStream.close();
         return lines;
       },
       quickReadStream: async (stream, lineCount) => {
-        const rl6 = (0, import_readline.createInterface)({ input: stream, crlfDelay: Infinity });
+        const rl7 = (0, import_readline.createInterface)({ input: stream, crlfDelay: Infinity });
         const lines = [];
         let counter = 0;
-        for await (const line of rl6) {
+        for await (const line of rl7) {
           lines.push(line);
           counter++;
           if (counter >= lineCount) {
             break;
           }
         }
-        rl6.close();
+        rl7.close();
         return lines;
       }
     };
@@ -42853,11 +43084,11 @@ var init_LocalSourceDriver = __esm({
 });
 
 // ../../packages/drivers/src/files/LocalDestinationDriver.ts
-var fs12, import_promises9, import_readline3, import_path10, LocalDestinationDriver;
+var fs12, import_promises10, import_readline3, import_path10, LocalDestinationDriver;
 var init_LocalDestinationDriver = __esm({
   "../../packages/drivers/src/files/LocalDestinationDriver.ts"() {
     fs12 = __toESM(require("fs"), 1);
-    import_promises9 = __toESM(require("fs/promises"), 1);
+    import_promises10 = __toESM(require("fs/promises"), 1);
     import_readline3 = __toESM(require("readline"), 1);
     import_path10 = __toESM(require("path"), 1);
     init_src();
@@ -42892,8 +43123,8 @@ var init_LocalDestinationDriver = __esm({
         this.move = async (fromPath, toName) => {
           try {
             const toFilePath = import_path10.default.join(this._path, toName);
-            await import_promises9.default.copyFile(fromPath, toFilePath);
-            await import_promises9.default.unlink(fromPath);
+            await import_promises10.default.copyFile(fromPath, toFilePath);
+            await import_promises10.default.unlink(fromPath);
             return { bucket: "", key: toFilePath, res: true };
           } catch (error) {
             Logger_default.error(error);
@@ -42929,14 +43160,14 @@ var init_LocalDestinationDriver = __esm({
 });
 
 // ../../packages/drivers/src/s3/S3SourceDriver.ts
-var import_client_s32, import_stream2, import_promises10, import_readline4, import_path11, import_fs10, import_xlsx2, S3SourceDriver;
+var import_client_s32, import_stream3, import_promises11, import_readline4, import_path11, import_fs10, import_xlsx2, S3SourceDriver;
 var init_S3SourceDriver = __esm({
   "../../packages/drivers/src/s3/S3SourceDriver.ts"() {
     import_client_s32 = require("@aws-sdk/client-s3");
     init_src();
     init_AwsCredentials();
-    import_stream2 = require("stream");
-    import_promises10 = require("stream/promises");
+    import_stream3 = require("stream");
+    import_promises11 = require("stream/promises");
     import_readline4 = __toESM(require("readline"), 1);
     import_path11 = __toESM(require("path"), 1);
     import_fs10 = __toESM(require("fs"), 1);
@@ -43204,7 +43435,7 @@ var init_S3SourceDriver = __esm({
             }
             const totalBytes = response.ContentLength ?? 0;
             let stagedBytes = 0;
-            const meter = new import_stream2.Transform({
+            const meter = new import_stream3.Transform({
               transform(chunk, _encoding, done) {
                 stagedBytes += chunk.length;
                 if (totalBytes > 0)
@@ -43213,7 +43444,7 @@ var init_S3SourceDriver = __esm({
               }
             });
             const writeStream = import_fs10.default.createWriteStream(localPath);
-            await (0, import_promises10.pipeline)(response.Body, meter, writeStream);
+            await (0, import_promises11.pipeline)(response.Body, meter, writeStream);
             report3(1);
           };
           if (fileKey.includes("%")) {
@@ -43368,7 +43599,7 @@ var init_S3DestinationDriver = __esm({
 });
 
 // ../../packages/drivers/src/DriverFactory.ts
-var DriverFactoryClass, DriverFactory, DriverFactory_default;
+var STAGEABLE_ENGINES, DriverFactoryClass, DriverFactory, DriverFactory_default;
 var init_DriverFactory = __esm({
   "../../packages/drivers/src/DriverFactory.ts"() {
     init_RedshiftDriver();
@@ -43378,8 +43609,11 @@ var init_DriverFactory = __esm({
     init_LocalDestinationDriver();
     init_S3SourceDriver();
     init_S3DestinationDriver();
+    STAGEABLE_ENGINES = ["local", "aws-s3", "delta-share"];
     DriverFactoryClass = class {
       constructor() {
+        /** Whether a run can stage a producer from this engine — see `STAGEABLE_ENGINES`. */
+        this.canStage = (engine) => STAGEABLE_ENGINES.includes(engine);
         this.instantiateSource = async (source) => {
           switch (source.engine) {
             case "aws-redshift": {
@@ -44132,6 +44366,7 @@ var init_ProducerManager = __esm({
     init_src4();
     init_src3();
     init_src6();
+    init_CryptoEngine();
     ProducerManagerClass = class {
       constructor() {
         this.getColumns = (producer) => {
@@ -44186,6 +44421,46 @@ var init_ProducerManager = __esm({
             return true;
           return FixedWidthParser_default.matchesSelector(line, resolved.selector, resolved.range);
         };
+        /**
+         * The post-parse work a producer implies for every record it produces: which keys carry the
+         * source file name, and which carry a mask.
+         *
+         * Resolved once per chunk, never per line — `getMask` resolves a secret and validates the value,
+         * and neither depends on the record. Empty for almost every producer, which is the case worth
+         * keeping fast.
+         */
+        this.compileFills = (dimensions) => {
+          Affirm_default(dimensions, "Invalid producer dimensions");
+          const fills = [];
+          for (const dimension of dimensions) {
+            const { prodDimension } = dimension;
+            const mask = this.getMask(prodDimension);
+            const sourceFilename = prodDimension.sourceFilename === true;
+            if (!sourceFilename && !Algo_default.hasVal(mask))
+              continue;
+            fills.push({ key: dimension.name, mask, sourceFilename, type: prodDimension.type });
+          }
+          return fills;
+        };
+        /**
+         * Applies the compiled fills to one parsed record, in place.
+         *
+         * The one place a producer dimension's mask is ever applied, on purpose: a run reaches it through
+         * `ProducerExecutor.processLine` and a sample through `ProducerEngine`, and a masked dimension
+         * that came back in the clear from one of the two would be a `hash` the project declared and the
+         * screen ignored — a disclosure, not a display bug.
+         */
+        this.applyFills = (record, fills, sourceFilename) => {
+          if (!fills?.length)
+            return record;
+          for (const fill2 of fills) {
+            if (fill2.sourceFilename)
+              record[fill2.key] = sourceFilename;
+            if (Algo_default.hasVal(fill2.mask))
+              record[fill2.key] = CryptoEngine_default.hashValue(fill2.mask, record[fill2.key]?.toString(), fill2.type);
+          }
+          return record;
+        };
       }
     };
     ProducerManager = new ProducerManagerClass();
@@ -44222,7 +44497,7 @@ var init_TypeCaster = __esm({
        *  - Parsing dates (type 'date'/'datetime') from string with tokens: yyyy, mm, dd
        *  - Formatting dates when casting to string with same tokens
        */
-      cast(value, type, format3) {
+      cast(value, type, format4) {
         if (!Algo_default.hasVal(value)) return value;
         switch (type) {
           case "boolean": {
@@ -44233,8 +44508,8 @@ var init_TypeCaster = __esm({
           case "date": {
             let dateValue = null;
             try {
-              if (format3 && typeof value === "string")
-                dateValue = this.parseDate(value, format3, true).toDate();
+              if (format4 && typeof value === "string")
+                dateValue = this.parseDate(value, format4, true).toDate();
               else
                 dateValue = new Date(value);
               return dateValue.toISOString();
@@ -44242,7 +44517,7 @@ var init_TypeCaster = __esm({
               dateValue = new Date(value);
               if (!isNaN(dateValue))
                 return dateValue.toISOString();
-              throw new Error(`Error casting "${value}" to date with format "${format3}": ${error}`);
+              throw new Error(`Error casting "${value}" to date with format "${format4}": ${error}`);
             }
           }
           case "number": {
@@ -44269,13 +44544,13 @@ var init_TypeCaster = __esm({
        * advancedFormat plugin, and then unpadded for `DDD`, while a positional ordinal date is always
        * 3 digits wide; the token is therefore rendered here rather than handed to dayjs.
        */
-      formatDate(value, format3) {
+      formatDate(value, format4) {
         const date2 = import_dayjs.default.utc(value);
-        if (!DAY_OF_YEAR_TOKEN.test(this._stripLiterals(format3)))
-          return date2.format(format3);
+        if (!DAY_OF_YEAR_TOKEN.test(this._stripLiterals(format4)))
+          return date2.format(format4);
         const startOfYear = import_dayjs.default.utc(`${String(date2.year()).padStart(4, "0")}-01-01`, "YYYY-MM-DD", true);
         const dayOfYear = date2.diff(startOfYear, "day") + 1;
-        return date2.format(format3.replace(/D{3,4}/g, `[${String(dayOfYear).padStart(3, "0")}]`));
+        return date2.format(format4.replace(/D{3,4}/g, `[${String(dayOfYear).padStart(3, "0")}]`));
       }
       /**
        * Parses a date string with a dayjs format, as UTC. Single entry point for every date parse, so
@@ -44284,13 +44559,13 @@ var init_TypeCaster = __esm({
        * ever FORMAT with are rejected outright — non-strict parsing would otherwise read `2007305` as
        * 2007-01-05 rather than 2007-11-01 and report no error at all.
        */
-      parseDate(value, format3, strict = true) {
-        if (DAY_OF_YEAR_TOKEN.test(this._stripLiterals(format3)))
-          return this._parseDayOfYear(value, format3);
-        this._assertParsableFormat(format3);
-        const parsed = import_dayjs.default.utc(value, format3, strict);
+      parseDate(value, format4, strict = true) {
+        if (DAY_OF_YEAR_TOKEN.test(this._stripLiterals(format4)))
+          return this._parseDayOfYear(value, format4);
+        this._assertParsableFormat(format4);
+        const parsed = import_dayjs.default.utc(value, format4, strict);
         if (!parsed.isValid())
-          throw new Error(`Cannot parse "${value}" with input format "${format3}"`);
+          throw new Error(`Cannot parse "${value}" with input format "${format4}"`);
         return parsed;
       }
       /**
@@ -44299,61 +44574,61 @@ var init_TypeCaster = __esm({
        * walked token by token against the format — every token of such a format has a fixed width, so
        * a plain cursor is enough — and the date is then built from the year plus the ordinal offset.
        */
-      _parseDayOfYear(value, format3) {
+      _parseDayOfYear(value, format4) {
         const parts = {};
         let cursor = 0;
         let index = 0;
-        while (index < format3.length) {
-          if (format3[index] === "[") {
-            const close = format3.indexOf("]", index);
+        while (index < format4.length) {
+          if (format4[index] === "[") {
+            const close = format4.indexOf("]", index);
             if (close < 0)
-              throw new Error(`Unterminated "[" literal in date format "${format3}"`);
-            const literal2 = format3.slice(index + 1, close);
+              throw new Error(`Unterminated "[" literal in date format "${format4}"`);
+            const literal2 = format4.slice(index + 1, close);
             if (value.slice(cursor, cursor + literal2.length) !== literal2)
-              throw new Error(`Cannot parse "${value}" with input format "${format3}": expected "${literal2}" at character ${cursor + 1}`);
+              throw new Error(`Cannot parse "${value}" with input format "${format4}": expected "${literal2}" at character ${cursor + 1}`);
             cursor += literal2.length;
             index = close + 1;
             continue;
           }
-          const match = DATE_PARSE_TOKENS.find((x2) => format3.startsWith(x2.token, index));
+          const match = DATE_PARSE_TOKENS.find((x2) => format4.startsWith(x2.token, index));
           if (!match) {
-            if (/[A-Za-z]/.test(format3[index]))
-              throw new Error(`Date format "${format3}" mixes a day-of-year token with "${format3[index]}", which can't be parsed alongside it. Use YYYY/YY, DDD/DDDD, HH, mm, ss and SSS only.`);
-            if (value[cursor] !== format3[index])
-              throw new Error(`Cannot parse "${value}" with input format "${format3}": expected "${format3[index]}" at character ${cursor + 1}`);
+            if (/[A-Za-z]/.test(format4[index]))
+              throw new Error(`Date format "${format4}" mixes a day-of-year token with "${format4[index]}", which can't be parsed alongside it. Use YYYY/YY, DDD/DDDD, HH, mm, ss and SSS only.`);
+            if (value[cursor] !== format4[index])
+              throw new Error(`Cannot parse "${value}" with input format "${format4}": expected "${format4[index]}" at character ${cursor + 1}`);
             cursor++;
             index++;
             continue;
           }
           const digits = value.slice(cursor, cursor + match.width);
           if (digits.length !== match.width || !/^\d+$/.test(digits))
-            throw new Error(`Cannot parse "${value}" with input format "${format3}": expected ${match.width} digit(s) for "${match.token}" at character ${cursor + 1}`);
+            throw new Error(`Cannot parse "${value}" with input format "${format4}": expected ${match.width} digit(s) for "${match.token}" at character ${cursor + 1}`);
           parts[match.token] = Number(digits);
           cursor += match.width;
           index += match.token.length;
         }
         if (cursor !== value.length)
-          throw new Error(`Cannot parse "${value}" with input format "${format3}": ${value.length - cursor} unexpected trailing character(s)`);
+          throw new Error(`Cannot parse "${value}" with input format "${format4}": ${value.length - cursor} unexpected trailing character(s)`);
         const year2 = Algo_default.hasVal(parts["YYYY"]) ? parts["YYYY"] : parts["YY"];
         const dayOfYear = Algo_default.hasVal(parts["DDDD"]) ? parts["DDDD"] : parts["DDD"];
         if (!Algo_default.hasVal(year2))
-          throw new Error(`Date format "${format3}" declares a day of year but no year, so the date is ambiguous.`);
+          throw new Error(`Date format "${format4}" declares a day of year but no year, so the date is ambiguous.`);
         const startOfYear = import_dayjs.default.utc(`${String(year2).padStart(4, "0")}-01-01`, "YYYY-MM-DD", true);
         if (!startOfYear.isValid())
-          throw new Error(`Cannot parse "${value}" with input format "${format3}": "${year2}" is not a valid year`);
+          throw new Error(`Cannot parse "${value}" with input format "${format4}": "${year2}" is not a valid year`);
         const parsed = startOfYear.add(dayOfYear - 1, "day").add(parts["HH"] ?? 0, "hour").add(parts["mm"] ?? 0, "minute").add(parts["ss"] ?? 0, "second").add(parts["SSS"] ?? 0, "millisecond");
         if (dayOfYear < 1 || parsed.year() !== startOfYear.year())
-          throw new Error(`Cannot parse "${value}" with input format "${format3}": day of year ${dayOfYear} is outside year ${year2} (which has ${startOfYear.add(1, "year").diff(startOfYear, "day")} days)`);
+          throw new Error(`Cannot parse "${value}" with input format "${format4}": day of year ${dayOfYear} is outside year ${year2} (which has ${startOfYear.add(1, "year").diff(startOfYear, "day")} days)`);
         return parsed;
       }
-      _assertParsableFormat(format3) {
-        const stripped = this._stripLiterals(format3);
+      _assertParsableFormat(format4) {
+        const stripped = this._stripLiterals(format4);
         const offending = FORMAT_ONLY_TOKENS.find((token2) => stripped.includes(token2));
         if (offending)
-          throw new Error(`Date format "${format3}" uses the token "${offending}", which dayjs can only write, never read: parsing would silently produce the wrong date. Use a parseable token, or bracket it as a literal ("[${offending}]") if it is part of the text.`);
+          throw new Error(`Date format "${format4}" uses the token "${offending}", which dayjs can only write, never read: parsing would silently produce the wrong date. Use a parseable token, or bracket it as a literal ("[${offending}]") if it is part of the text.`);
       }
-      _stripLiterals(format3) {
-        return String(format3 ?? "").replace(/\[[^\]]*\]/g, "");
+      _stripLiterals(format4) {
+        return String(format4 ?? "").replace(/\[[^\]]*\]/g, "");
       }
     };
     TypeCaster = new TypeCasterClass();
@@ -44600,7 +44875,8 @@ var init_ProducerEngine = __esm({
                     }
                   };
                 }
-                const fileData = await this.readFile(effectiveProducer, { readmode: "lines", lines: { from: 0, to: sampleSize } }, effectiveSource);
+                const headerLines = ParseHelper_default.hasHeaderLine(effectiveProducer.settings.fileType, effectiveProducer.settings.hasHeaderRow) ? 1 : 0;
+                const fileData = await this.readFile(effectiveProducer, { readmode: "lines", lines: { from: 0, to: sampleSize + headerLines } }, effectiveSource);
                 rawData = fileData.data;
               } finally {
                 if (scope)
@@ -44619,13 +44895,15 @@ var init_ProducerEngine = __esm({
           if (!rawData || rawData.length === 0) return [];
           const firstItem = rawData[0];
           const isLineData = typeof firstItem === "string";
+          const fills = discover2 ? [] : ProducerManager_default.compileFills(this._fillDimensions(producer));
+          const sourceFilename = import_path18.default.basename(producer.settings.fileKey ?? producer.settings.sqlTable ?? "");
           if (isLineData) {
             const lines = rawData;
             const dimensions = this.deriveDimensions(lines[0], producer, discover2);
             const { fileType, hasHeaderRow } = producer.settings;
             const dataLines = ParseHelper_default.hasHeaderLine(fileType, hasHeaderRow) ? lines.slice(1) : lines;
             const recordSelector = ProducerManager_default.resolveRecordSelector(producer);
-            return dataLines.filter((line) => line.trim().length > 0).filter((line) => ProducerManager_default.shouldReadLine(line, recordSelector)).flatMap((line) => LineParser_default.parseAll(line, producer, dimensions, noopTracker));
+            return dataLines.filter((line) => line.trim().length > 0).filter((line) => ProducerManager_default.shouldReadLine(line, recordSelector)).flatMap((line) => LineParser_default.parseAll(line, producer, dimensions, noopTracker)).map((record) => ProducerManager_default.applyFills(record, fills, sourceFilename));
           }
           if (discover2) {
             return rawData.map((item) => ({ ...item }));
@@ -44636,9 +44914,15 @@ var init_ProducerEngine = __esm({
               const key = dim.alias ?? dim.name;
               record[dim.name] = TypeCaster_default.cast(item[key], dim.type, dim.format);
             }
-            return record;
+            return ProducerManager_default.applyFills(record, fills, sourceFilename);
           });
         };
+        /**
+         * The producer's declared dimensions in the shape `compileFills` reads them in. Declaration
+         * order, because a fill is addressed by key and never by position — unlike the executor
+         * dimensions of a run, whose index is reconciled against the file's own header.
+         */
+        this._fillDimensions = (producer) => producer.dimensions.map((prodDimension, index) => ({ index, name: prodDimension.name, prodDimension }));
         /**
          * Builds the executor dimensions of a producer. There are two shapes of source: a FIXED file has
          * no header, so its layout comes from the positions declared on the dimensions; every other file
@@ -44736,7 +45020,7 @@ var init_ProducerEngine = __esm({
 });
 
 // ../../packages/engines/src/ai/DeveloperEngine.ts
-var import_path19, import_promises11, import_dayjs2, import_customParseFormat2, DeveloperEngineClass, DeveloperEngine, DeveloperEngine_default;
+var import_path19, import_promises12, import_dayjs2, import_customParseFormat2, DeveloperEngineClass, DeveloperEngine, DeveloperEngine_default;
 var init_DeveloperEngine = __esm({
   "../../packages/engines/src/ai/DeveloperEngine.ts"() {
     init_src();
@@ -44744,7 +45028,7 @@ var init_DeveloperEngine = __esm({
     init_src4();
     init_src8();
     import_path19 = __toESM(require("path"), 1);
-    import_promises11 = __toESM(require("fs/promises"), 1);
+    import_promises12 = __toESM(require("fs/promises"), 1);
     import_dayjs2 = __toESM(require("dayjs"), 1);
     import_customParseFormat2 = __toESM(require("dayjs/plugin/customParseFormat"), 1);
     import_dayjs2.default.extend(import_customParseFormat2.default);
@@ -44774,8 +45058,8 @@ var init_DeveloperEngine = __esm({
           };
           mappedProducer["$schema"] = producer["$schema"];
           const producerPath = Environment_default.resolveResourceFilePath("producers", producer.name);
-          await import_promises11.default.mkdir(import_path19.default.dirname(producerPath), { recursive: true });
-          await import_promises11.default.writeFile(producerPath, JSON.stringify(mappedProducer, null, 4), "utf-8");
+          await import_promises12.default.mkdir(import_path19.default.dirname(producerPath), { recursive: true });
+          await import_promises12.default.writeFile(producerPath, JSON.stringify(mappedProducer, null, 4), "utf-8");
           return { producer: mappedProducer, fields: typeDefinitions };
         };
         // Discover-only precondition: sampling real data requires a configured, readable file.
@@ -47106,9 +47390,10 @@ var init_MockDataFactory = __esm({
           if (type === "number") {
             const first = bounds?.min ?? 1;
             const last = first + poolSize - 1;
+            const ceiling = bounds?.max;
             Affirm_default(
-              bounds?.max === void 0 || bounds.max >= last,
-              `Key "${norm}" has a synth range of ${first}-${bounds.max}, which holds fewer than the ${poolSize} distinct values it has to generate; widen it or generate fewer records`
+              ceiling === void 0 || ceiling >= last,
+              `Key "${norm}" has a synth range of ${first}-${ceiling}, which holds fewer than the ${poolSize} distinct values it has to generate; widen it or generate fewer records`
             );
             for (let i6 = 0; i6 < poolSize; i6++) pool.push(first + i6);
             return pool;
@@ -47311,10 +47596,10 @@ var init_MockDataFactory = __esm({
 });
 
 // ../../packages/engines/src/mock/SyntheticInputEngine.ts
-var import_promises12, import_os, import_path20, import_dayjs4, import_customParseFormat3, import_utc3, POOL_CAP, SyntheticInputEngineClass, SyntheticInputEngine, SyntheticInputEngine_default;
+var import_promises13, import_os, import_path20, import_dayjs4, import_customParseFormat3, import_utc3, POOL_CAP, SyntheticInputEngineClass, SyntheticInputEngine, SyntheticInputEngine_default;
 var init_SyntheticInputEngine = __esm({
   "../../packages/engines/src/mock/SyntheticInputEngine.ts"() {
-    import_promises12 = __toESM(require("fs/promises"), 1);
+    import_promises13 = __toESM(require("fs/promises"), 1);
     import_os = __toESM(require("os"), 1);
     import_path20 = __toESM(require("path"), 1);
     import_dayjs4 = __toESM(require("dayjs"), 1);
@@ -47340,7 +47625,7 @@ var init_SyntheticInputEngine = __esm({
           for (const cs2 of [...BUILTIN_CODE_SETS, ...codeSets]) codeSetMap.set(cs2.name.toLowerCase(), cs2);
           const producerMap = new Map(producers.map((p5) => [p5.name, p5]));
           const refTargets = this._collectReferences(producers, producerMap);
-          const dir = await import_promises12.default.mkdtemp(import_path20.default.join(import_os.default.tmpdir(), "remora-synth-"));
+          const dir = await import_promises13.default.mkdtemp(import_path20.default.join(import_os.default.tmpdir(), "remora-synth-"));
           const poolSize = Math.min(Math.max(opts.records, 1), POOL_CAP);
           const registry = new MockKeyRegistry();
           const specs = producers.flatMap((p5) => this._specs(p5, codeSetMap, producerMap, refTargets));
@@ -47357,7 +47642,7 @@ var init_SyntheticInputEngine = __esm({
           return { inputs, dir };
         };
         this.cleanup = async (bundle) => {
-          if (bundle?.dir) await import_promises12.default.rm(bundle.dir, { recursive: true, force: true });
+          if (bundle?.dir) await import_promises13.default.rm(bundle.dir, { recursive: true, force: true });
         };
         this._assertOpts = (opts) => {
           Affirm_default(opts, "Invalid options");
@@ -47407,8 +47692,8 @@ var init_SyntheticInputEngine = __esm({
             lines.push(JSON.stringify(row) + "\n");
           }
           const filePath = import_path20.default.join(dir, `${producer.name}.jsonl`);
-          await import_promises12.default.writeFile(filePath, lines.join(""), "utf-8");
-          const { size } = await import_promises12.default.stat(filePath);
+          await import_promises13.default.writeFile(filePath, lines.join(""), "utf-8");
+          const { size } = await import_promises13.default.stat(filePath);
           return { path: filePath, fileSize: size };
         };
         // Distinct structured code sets referenced by these specs -> their records (deduped by name).
@@ -47519,7 +47804,7 @@ var init_SyntheticInputEngine = __esm({
         // True when a date bound names a day rather than an instant — neither the value nor the dimension's
         // format carries a time. Both have to agree: the value alone can't tell `"20240131"` from a compact
         // `YYYYMMDDHHmmss` instant, and the format alone can't tell that an ISO value overrode it.
-        this._isDayGranular = (value, format3) => !/[T ]\d{1,2}:/.test(value) && !/[HhmsSAa]/.test(format3 ?? "");
+        this._isDayGranular = (value, format4) => !/[T ]\d{1,2}:/.test(value) && !/[HhmsSAa]/.test(format4 ?? "");
         /**
          * One bound in the units the generator works in: the number itself, a count of characters for a
          * `string`, or epoch milliseconds for a `datetime`. A date bound is read with the dimension's own
@@ -48449,23 +48734,23 @@ var init_Diagnostics = __esm({
           return [.../* @__PURE__ */ new Set([...inputs, ...chained])];
         };
         this._walk = (start, next, onCycle) => {
-          const path29 = [];
+          const path30 = [];
           const onPath = /* @__PURE__ */ new Set();
           const stack = [{ name: start, done: false }];
           const visited = /* @__PURE__ */ new Set();
           while (stack.length > 0) {
             const frame = stack.pop();
             if (frame.done) {
-              onPath.delete(path29.pop());
+              onPath.delete(path30.pop());
               continue;
             }
             if (onPath.has(frame.name)) {
-              path29.slice(path29.indexOf(frame.name)).forEach((name) => onCycle.add(name));
+              path30.slice(path30.indexOf(frame.name)).forEach((name) => onCycle.add(name));
               continue;
             }
             if (visited.has(frame.name)) continue;
             visited.add(frame.name);
-            path29.push(frame.name);
+            path30.push(frame.name);
             onPath.add(frame.name);
             stack.push({ name: frame.name, done: true });
             const successors = next.get(frame.name) ?? [];
@@ -48809,7 +49094,7 @@ var init_LineageRenderer = __esm({
 });
 
 // ../../packages/engines/src/lineage/ResourceView.ts
-var VISIBLE_AUTH_KEYS, MAX_TABLE_ROWS, MAX_RAW_BYTES, MAX_CELL_CHARS, ResourceViewClass, ResourceView, ResourceView_default;
+var VISIBLE_AUTH_KEYS, MAX_TABLE_ROWS, MAX_RAW_BYTES, MAX_CELL_CHARS, MAX_NOTE_CHARS, ResourceViewClass, ResourceView, ResourceView_default;
 var init_ResourceView = __esm({
   "../../packages/engines/src/lineage/ResourceView.ts"() {
     init_src();
@@ -48848,6 +49133,7 @@ var init_ResourceView = __esm({
     MAX_TABLE_ROWS = 500;
     MAX_RAW_BYTES = 256 * 1024;
     MAX_CELL_CHARS = 200;
+    MAX_NOTE_CHARS = 240;
     ResourceViewClass = class {
       constructor() {
         /**
@@ -49019,7 +49305,7 @@ var init_ResourceView = __esm({
             { key: "classification", label: "Classification" }
           ];
           const rows = dimensions.map((dimension) => [
-            { value: dimension.name },
+            { value: dimension.name, note: this._note(dimension.description) },
             { value: this._text(dimension.type) },
             positioned ? { value: this._position(dimension.position) } : { value: this._text(dimension.alias), muted: !dimension.alias },
             { value: !!dimension.pk, muted: !dimension.pk },
@@ -49031,7 +49317,7 @@ var init_ResourceView = __esm({
         };
         this._measuresTable = (producer) => {
           const rows = (producer.measures ?? []).map((measure) => [
-            { value: measure.name },
+            { value: measure.name, note: this._note(measure.description) },
             { value: measure.sql }
           ]);
           return this._table("Measures", [
@@ -49097,7 +49383,7 @@ var init_ResourceView = __esm({
         };
         this._consumerFieldsTable = (env2, consumer) => {
           const rows = (consumer.fields ?? []).map((field) => [
-            { value: field.key },
+            { value: field.key, note: this._note(field.description) },
             { value: this._text(field.alias), muted: !field.alias },
             { value: this._text(field.from), link: field.from ? this._inputLink(env2, field.from) : void 0, muted: !field.from },
             { value: this._text(field.transform ? Object.keys(field.transform) : null), muted: !field.transform },
@@ -49143,8 +49429,8 @@ var init_ResourceView = __esm({
           if (!source || origin.path.length < 2) return { value: "declared here", muted: true };
           return { value: `${source.resource}.${source.field}`, link: source.node };
         };
-        this._pathText = (path29) => {
-          return path29.map((step) => `${step.resource}.${step.field}`).join(" \u2192 ");
+        this._pathText = (path30) => {
+          return path30.map((step) => `${step.resource}.${step.field}`).join(" \u2192 ");
         };
         this._consumerOutputsTable = (env2, consumer) => {
           const declared = new Set((env2.sources ?? []).map((x2) => x2.name));
@@ -49186,7 +49472,7 @@ var init_ResourceView = __esm({
           const required = new Set(schema.required ?? []);
           const properties = Object.entries(schema.properties ?? {});
           const rows = properties.map(([property, definition]) => [
-            { value: property },
+            { value: property, note: this._note(this._schemaKeyword(definition, "description")) },
             { value: this._schemaType(definition) },
             { value: required.has(property), muted: !required.has(property) },
             { value: this._text(this._schemaKeyword(definition, "format")), muted: !this._schemaKeyword(definition, "format") }
@@ -49292,6 +49578,15 @@ var init_ResourceView = __esm({
           const minutes = Math.floor(elapsedMS / 6e4);
           return `${minutes}m ${Math.round(elapsedMS % 6e4 / 1e3)}s`;
         };
+        /**
+         * A description as the secondary line of a cell. Blank prose is the same as none, so a field
+         * documented with a stray space does not cost the row a line.
+         */
+        this._note = (description) => {
+          const text = (description ?? "").trim();
+          if (!text) return void 0;
+          return text.length > MAX_NOTE_CHARS ? `${text.slice(0, MAX_NOTE_CHARS)}\u2026` : text;
+        };
         /** Anything that is not already a scalar becomes readable text; absent becomes `null`. */
         this._text = (value) => {
           if (value === void 0 || value === null) return null;
@@ -49608,7 +49903,7 @@ var init_OpsHeartbeat = __esm({
   "../../packages/engines/src/ops/OpsHeartbeat.ts"() {
     init_src2();
     init_OpsService();
-    DEFAULT_INTERVAL_MS = 6e4;
+    DEFAULT_INTERVAL_MS = 3e5;
     MIN_INTERVAL_MS = 5e3;
     MAX_INTERVAL_MS = 36e5;
     OpsHeartbeatClass = class {
@@ -49648,11 +49943,24 @@ var init_OpsHeartbeat = __esm({
             Logger_default.error(error);
           }
         };
+        /**
+         * Resolve the configured interval, in milliseconds. A value that is unusable or out of range is
+         * reported rather than silently replaced: an operator who set an interval and got a different
+         * one has no other way to find out.
+         */
         this.resolveInterval = () => {
-          const configured = Number(process.env.REMORA_STATE_INTERVAL_MS);
-          if (!Number.isFinite(configured) || configured <= 0)
+          const raw = process.env.REMORA_STATE_INTERVAL_MS;
+          if (!raw)
+            return DEFAULT_INTERVAL_MS;
+          const configured = Number(raw);
+          if (!Number.isFinite(configured) || configured <= 0) {
+            Logger_default.warn(`REMORA_STATE_INTERVAL_MS is not a positive number of milliseconds ("${raw}"); using ${DEFAULT_INTERVAL_MS}ms.`);
             return DEFAULT_INTERVAL_MS;
-          return Math.min(Math.max(configured, MIN_INTERVAL_MS), MAX_INTERVAL_MS);
+          }
+          const clamped = Math.min(Math.max(configured, MIN_INTERVAL_MS), MAX_INTERVAL_MS);
+          if (clamped !== configured)
+            Logger_default.warn(`REMORA_STATE_INTERVAL_MS of ${configured}ms is outside ${MIN_INTERVAL_MS}ms..${MAX_INTERVAL_MS}ms; using ${clamped}ms.`);
+          return clamped;
         };
       }
     };
@@ -49886,17 +50194,30 @@ var init_LocalUsageDB = __esm({
           }
         };
         /**
-         * The recorded runs, newest first. Only the tail of the file is decoded: a reader wants the recent
+         * The recorded runs, newest first — the newest `limit` of the rows `keep` accepts.
+         *
+         * Decoded from the end and stopped as soon as that many are held: a reader wants the recent
          * executions, and decoding ten thousand rows to show ten of them is work nobody asked for.
          *
+         * `keep` is applied BEFORE the limit, which is the only way "the newest N runs of this kind" can
+         * mean it: filtering afterwards lets the rows a caller does not want displace the ones it does,
+         * so one sample recorded here would silently push a real run out of a history someone is reading.
+         *
          * Never throws. A missing file reads as no history, and so does a half-written one — this store is
          * appended to while it is being read, so failing on that would make it unreadable during a run.
          */
-        this.list = (limit = MAX_LISTED_ROWS) => {
+        this.list = (limit = MAX_LISTED_ROWS, keep) => {
           try {
             if (!(0, import_fs16.existsSync)(CLI_DB_PATH))
               return [];
-            return this._getRows().slice(-Math.max(1, limit)).map((line) => this._fromLine(line)).reverse();
+            const rows = this._getRows();
+            const wanted = Math.max(1, limit);
+            const found = [];
+            for (let index = rows.length - 1; index >= 0 && found.length < wanted; index--) {
+              const usage = this._fromLine(rows[index]);
+              if (!keep || keep(usage)) found.push(usage);
+            }
+            return found;
           } catch (error) {
             this._handleError("list", error);
             return [];
@@ -50077,9 +50398,10 @@ var init_UsageManager = __esm({
 });
 
 // ../../packages/engines/src/ops/RunOverlay.ts
-var MAX_RUNS, MAX_OPERATIONS, RunOverlayClass, RunOverlay, RunOverlay_default;
+var import_crypto5, MAX_RUNS, MAX_OPERATIONS, RunOverlayClass, RunOverlay, RunOverlay_default;
 var init_RunOverlay = __esm({
   "../../packages/engines/src/ops/RunOverlay.ts"() {
+    import_crypto5 = __toESM(require("crypto"), 1);
     init_src();
     init_LineageEngine();
     init_LocalUsageDB();
@@ -50088,6 +50410,8 @@ var init_RunOverlay = __esm({
     MAX_OPERATIONS = 40;
     RunOverlayClass = class {
       constructor() {
+        /** The last store token read, and the overlay token it resolved to. */
+        this._signed = { store: null, overlay: "" };
         /**
          * The recent executions and their aggregates. ONE read of the store answers both, so a page
          * showing a graph, a run list and a timing breakdown costs one file read rather than three.
@@ -50098,20 +50422,40 @@ var init_RunOverlay = __esm({
         this.read = (limit = MAX_RUNS) => {
           Affirm_default(limit > 0, "Run overlay limit must be greater than zero");
           if (!UsageManager_default.recordsLocally()) return { runs: [], metrics: {} };
-          const stats = LocalUsageDB_default.list(limit).filter((stat) => stat?.consumer);
+          const stats = LocalUsageDB_default.list(limit, (stat) => !!stat?.consumer && stat.invokedBy !== "SAMPLE");
           return { runs: stats.map((stat) => this._run(stat)), metrics: this._metrics(stats) };
         };
         /**
-         * A token that changes when the run store does. Empty when there is nothing to read.
+         * A token that changes when the OVERLAY does. Empty when there is nothing to read.
          *
          * A run finishing changes no configuration file, so the config hash cannot notice it — this is
-         * the second half of what the preview polls, and it is cheap for the same reason the hash is
-         * affordable: it reads metadata, not records.
+         * the second half of what the preview polls.
+         *
+         * It signs the painted runs rather than the store, because the two do not move together: a
+         * sample is recorded like any other execution and then filtered out of `read`, so the store's
+         * own token changes while the picture does not. Signing the store there announced a project
+         * change for every sample — and a page told its resource changed drops the sample it is showing,
+         * which is exactly the rows someone had just asked for.
+         *
+         * Still cheap to poll: the store's mtime/size gates the read, so the rows are decoded only after
+         * something has actually been written, never once a second.
          */
         this.signature = () => {
           if (!UsageManager_default.recordsLocally()) return "";
-          return LocalUsageDB_default.signature();
+          const store = LocalUsageDB_default.signature();
+          if (store === this._signed.store) return this._signed.overlay;
+          const overlay = this._token(this.read());
+          this._signed = { store, overlay };
+          return overlay;
         };
+        /**
+         * A token over the whole overlay, runs and metrics alike.
+         *
+         * Everything it carries, not the newest row and a count: `endUsage` updates a row in place and a
+         * finish action writes runs of its own, so a narrower token would miss a transition the graph
+         * exists to show.
+         */
+        this._token = (overlay) => import_crypto5.default.createHash("sha256").update(JSON.stringify(overlay)).digest("hex");
         this._run = (stat) => {
           const startedAt = this._iso(stat.startedAt);
           return {
@@ -50358,64 +50702,6 @@ var init_PushdownEngine = __esm({
   }
 });
 
-// ../../packages/engines/src/producer/SampleEngine.ts
-var MAX_CHAIN_DEPTH2, SampleEngineClass, SampleEngine, SampleEngine_default;
-var init_SampleEngine = __esm({
-  "../../packages/engines/src/producer/SampleEngine.ts"() {
-    init_src();
-    init_src4();
-    init_ProducerEngine();
-    MAX_CHAIN_DEPTH2 = 20;
-    SampleEngineClass = class {
-      constructor() {
-        /**
-         * @param resourceName a producer or consumer name, as declared.
-         * @throws when the name is neither, or when the source cannot be read.
-         */
-        this.read = async (resourceName, size = 10) => {
-          Affirm_default(resourceName, "Missing resource name to sample");
-          Affirm_default(size > 0, "Sample size must be greater than 0");
-          const producer = Environment_default.getProducer(resourceName);
-          if (producer)
-            return { kind: "producer", name: resourceName, records: await ProducerEngine_default.readSampleData(producer, size, false) };
-          const consumer = Environment_default.getConsumer(resourceName);
-          Affirm_default(consumer, `Resource "${resourceName}" not found. Please check if it exists as a producer or consumer.`);
-          return { kind: "consumer", name: resourceName, records: await this._readConsumer(consumer, size, []) };
-        };
-        /**
-         * A consumer has no data of its own until it runs, so what it shows is its FIRST input, projected
-         * through its field list — near enough to answer "what will come out of this" without a run.
-         */
-        this._readConsumer = async (consumer, size, visited) => {
-          Affirm_default(!visited.includes(consumer.name), `Consumer "${consumer.name}" reads itself through ${visited.join(" \u2192 ")}`);
-          Affirm_default(visited.length < MAX_CHAIN_DEPTH2, `Consumer chain from "${visited[0]}" is more than ${MAX_CHAIN_DEPTH2} deep`);
-          const input = consumer.producers[0];
-          Affirm_default(input, `Consumer "${consumer.name}" has no producers configured`);
-          const producer = Environment_default.getProducer(input.name);
-          if (!producer) {
-            const upstream = Environment_default.getConsumer(input.name);
-            Affirm_default(upstream, `Producer or consumer "${input.name}" not found for consumer "${consumer.name}"`);
-            return this._readConsumer(upstream, size, [...visited, consumer.name]);
-          }
-          const records = await ProducerEngine_default.readSampleData(producer, size, false);
-          if (consumer.fields.some((field) => field.key === "*")) return records;
-          return records.map((record) => this._project(consumer, record));
-        };
-        this._project = (consumer, record) => {
-          const projected = {};
-          for (const field of consumer.fields) {
-            if (field.key === "*") continue;
-            projected[field.alias || field.key] = record[field.key];
-          }
-          return projected;
-        };
-      }
-    };
-    SampleEngine = new SampleEngineClass();
-    SampleEngine_default = SampleEngine;
-  }
-});
-
 // ../../packages/engines/src/transform/LookupRegistry.ts
 var LookupRegistryClass, LookupRegistry, LookupRegistry_default;
 var init_LookupRegistry = __esm({
@@ -50452,12 +50738,12 @@ var init_LookupRegistry = __esm({
 });
 
 // ../../packages/engines/src/transform/LookupKey.ts
-var import_crypto5, DELIMITER, idFor, LookupKey, LookupKey_default;
+var import_crypto6, DELIMITER, idFor, LookupKey, LookupKey_default;
 var init_LookupKey = __esm({
   "../../packages/engines/src/transform/LookupKey.ts"() {
-    import_crypto5 = __toESM(require("crypto"), 1);
+    import_crypto6 = __toESM(require("crypto"), 1);
     DELIMITER = String.fromCharCode(0);
-    idFor = (ref) => import_crypto5.default.createHash("sha1").update([ref.consumer, ref.key, ref.value].join(DELIMITER)).digest("hex").slice(0, 16);
+    idFor = (ref) => import_crypto6.default.createHash("sha1").update([ref.consumer, ref.key, ref.value].join(DELIMITER)).digest("hex").slice(0, 16);
     LookupKey = { idFor };
     LookupKey_default = LookupKey;
   }
@@ -50484,8 +50770,8 @@ var init_TransformationEngine = __esm({
             return result;
           }
           if ("cast" in transformations) {
-            const { cast, format: format3 } = transformations;
-            const casted = TypeCaster_default.cast(value, cast, format3);
+            const { cast, format: format4 } = transformations;
+            const casted = TypeCaster_default.cast(value, cast, format4);
             if (cast === "number" && isNaN(casted))
               throw new Error(`Cannot cast non-numeric value in field '${field.key}'`);
             if (cast === "datetime" && casted instanceof Date && isNaN(casted.getTime()))
@@ -51094,7 +51380,6 @@ var init_src10 = __esm({
     init_ProducerEngine();
     init_ProducerManager();
     init_PushdownEngine();
-    init_SampleEngine();
     init_TransformationEngine();
     init_TypeCaster();
     init_LookupRegistry();
@@ -51264,14 +51549,14 @@ var init_OutputExecutor = __esm({
 });
 
 // ../../packages/executors/src/ConsumerExecutor.ts
-var import_path23, import_fs17, import_readline6, import_promises13, import_crypto6, LIMIT_SCAN_BYTES, NEWLINE_BYTE, ConsumerExecutorClass, ConsumerExecutor, ConsumerExecutor_default;
+var import_path23, import_fs17, import_readline6, import_promises14, import_crypto7, LIMIT_SCAN_BYTES, NEWLINE_BYTE, ConsumerExecutorClass, ConsumerExecutor, ConsumerExecutor_default;
 var init_ConsumerExecutor = __esm({
   "../../packages/executors/src/ConsumerExecutor.ts"() {
     import_path23 = __toESM(require("path"));
     import_fs17 = __toESM(require("fs"));
     import_readline6 = __toESM(require("readline"));
-    import_promises13 = __toESM(require("fs/promises"));
-    import_crypto6 = __toESM(require("crypto"));
+    import_promises14 = __toESM(require("fs/promises"));
+    import_crypto7 = __toESM(require("crypto"));
     init_src10();
     init_src10();
     init_src10();
@@ -51457,8 +51742,8 @@ var init_ConsumerExecutor = __esm({
               reader.destroy();
             });
           }
-          await import_promises13.default.unlink(datasetPath);
-          await import_promises13.default.rename(tempWorkPath, datasetPath);
+          await import_promises14.default.unlink(datasetPath);
+          await import_promises14.default.rename(tempWorkPath, datasetPath);
           return processedLineCount;
         };
         /**
@@ -51476,7 +51761,7 @@ var init_ConsumerExecutor = __esm({
         this.processLimit = async (datasetPath, limit) => {
           Affirm_default(datasetPath, "Invalid dataset path");
           Affirm_default(limit > 0, `Invalid record limit ${limit}`);
-          const handle = await import_promises13.default.open(datasetPath, "r+");
+          const handle = await import_promises14.default.open(datasetPath, "r+");
           try {
             const buffer = Buffer.allocUnsafe(LIMIT_SCAN_BYTES);
             let newlines = 0;
@@ -51510,7 +51795,7 @@ var init_ConsumerExecutor = __esm({
           let newLineCount = 0;
           const seen = /* @__PURE__ */ new Set();
           for await (const line of lineReader) {
-            const hash = import_crypto6.default.createHash("sha1").update(line).digest("base64");
+            const hash = import_crypto7.default.createHash("sha1").update(line).digest("base64");
             if (!seen.has(hash)) {
               seen.add(hash);
               if (!writer.write(line + "\n"))
@@ -51530,8 +51815,8 @@ var init_ConsumerExecutor = __esm({
               reader.destroy();
             });
           }
-          await import_promises13.default.unlink(datasetPath);
-          await import_promises13.default.rename(tempWorkPath, datasetPath);
+          await import_promises14.default.unlink(datasetPath);
+          await import_promises14.default.rename(tempWorkPath, datasetPath);
           return newLineCount;
         };
         this.processDistinctOn = async (consumer, datasetPath) => {
@@ -51575,8 +51860,8 @@ var init_ConsumerExecutor = __esm({
               reader.destroy();
             });
           }
-          await import_promises13.default.unlink(datasetPath);
-          await import_promises13.default.rename(tempWorkPath, datasetPath);
+          await import_promises14.default.unlink(datasetPath);
+          await import_promises14.default.rename(tempWorkPath, datasetPath);
           return winners.size;
         };
         this.processPivot = async (consumer, datasetPath) => {
@@ -51682,12 +51967,12 @@ var init_ConsumerExecutor = __esm({
               reader.destroy();
             });
           }
-          await import_promises13.default.unlink(datasetPath);
-          await import_promises13.default.rename(tempWorkPath, datasetPath);
+          await import_promises14.default.unlink(datasetPath);
+          await import_promises14.default.rename(tempWorkPath, datasetPath);
           return outputCount;
         };
-        this._parseLine = (line, format3, fields) => {
-          return format3 === "CSV" ? LineParser_default._internalParseCSV(line, fields) : LineParser_default._internalParseJSON(line);
+        this._parseLine = (line, format4, fields) => {
+          return format4 === "CSV" ? LineParser_default._internalParseCSV(line, fields) : LineParser_default._internalParseJSON(line);
         };
         /**
          * Determines if the new record should replace the existing record based on the resolution strategy
@@ -51786,8 +52071,6 @@ var init_ProducerExecutor = __esm({
     init_src8();
     init_src4();
     init_src10();
-    init_src();
-    init_src10();
     init_src10();
     import_path24 = __toESM(require("path"));
     init_src2();
@@ -51818,20 +52101,14 @@ var init_ProducerExecutor = __esm({
          * the source file name or a mask, and what that file name is. None of it depends on the line, so
          * it is compiled once per chunk instead of rebuilt per line — including the mask's own
          * validation, which used to run once per dimension per line.
+         *
+         * The fills themselves come from `ProducerManager`, which is also where the sample path gets
+         * them: one producer stage, reached from two places.
          */
         this.compileLine = (dimensions, chunk) => {
           Affirm_default(dimensions, "Invalid producer dimensions");
           Affirm_default(chunk, "Invalid chunk");
-          const fills = [];
-          for (const dimension of dimensions) {
-            const { prodDimension } = dimension;
-            const mask = ProducerManager_default.getMask(prodDimension);
-            const sourceFilename = prodDimension.sourceFilename === true;
-            if (!sourceFilename && !Algo_default.hasVal(mask))
-              continue;
-            fills.push({ key: dimension.name, mask, sourceFilename, type: prodDimension.type });
-          }
-          return { fills, sourceFilename: import_path24.default.basename(chunk.fileUri) };
+          return { fills: ProducerManager_default.compileFills(dimensions), sourceFilename: import_path24.default.basename(chunk.fileUri) };
         };
         /**
          * The record(s) one source line produces. Almost always exactly one — a producer with a group
@@ -51852,14 +52129,8 @@ var init_ProducerExecutor = __esm({
           if (plan.fills.length === 0)
             return records;
           counter = performance.now();
-          for (const record of records) {
-            for (const fill2 of plan.fills) {
-              if (fill2.sourceFilename)
-                record[fill2.key] = plan.sourceFilename;
-              if (Algo_default.hasVal(fill2.mask))
-                record[fill2.key] = CryptoEngine_default.hashValue(fill2.mask, record[fill2.key]?.toString(), fill2.type);
-            }
-          }
+          for (const record of records)
+            ProducerManager_default.applyFills(record, plan.fills, plan.sourceFilename);
           tracker.measure("process-line:dimensions-filename-mask", performance.now() - counter);
           return records;
         };
@@ -52170,11 +52441,11 @@ var init_OrchestratorHelper = __esm({
 });
 
 // ../../packages/executors/src/LookupResolver.ts
-var import_fs18, import_promises14, import_path26, import_readline8, LookupResolverClass, LookupResolver, LookupResolver_default;
+var import_fs18, import_promises15, import_path26, import_readline8, LookupResolverClass, LookupResolver, LookupResolver_default;
 var init_LookupResolver = __esm({
   "../../packages/executors/src/LookupResolver.ts"() {
     import_fs18 = __toESM(require("fs"));
-    import_promises14 = __toESM(require("fs/promises"));
+    import_promises15 = __toESM(require("fs/promises"));
     import_path26 = __toESM(require("path"));
     import_readline8 = __toESM(require("readline"));
     init_src();
@@ -52215,11 +52486,11 @@ var init_LookupResolver = __esm({
               this.cache.set(id, await this.buildDict(lookupConsumer, capturePath, ref));
             }
             ExecutorScope_default.ensurePath(outPath);
-            await import_promises14.default.writeFile(outPath, JSON.stringify(this.cache.get(id)));
+            await import_promises15.default.writeFile(outPath, JSON.stringify(this.cache.get(id)));
             manifest.push({ id, consumer: ref.consumer, key: ref.key, value: ref.value, path: import_path26.default.resolve(outPath) });
           }
           for (const capturePath of captureByConsumer.values())
-            await import_promises14.default.rm(capturePath, { force: true });
+            await import_promises15.default.rm(capturePath, { force: true });
           return manifest;
         };
         // Runs the source consumer through the real pipeline, capturing its merged output before cleanup.
@@ -52237,7 +52508,7 @@ var init_LookupResolver = __esm({
         };
         // Projects the captured dataset to a { code: value } dict, bounded by MAX_LOOKUP_ROWS.
         this.buildDict = async (lookupConsumer, capturePath, ref) => {
-          const format3 = OutputExecutor_default._getInternalRecordFormat(lookupConsumer);
+          const format4 = OutputExecutor_default._getInternalRecordFormat(lookupConsumer);
           const visibleFields = ConsumerManager_default.getExpandedFields(lookupConsumer).filter((f7) => !f7.cField.hidden);
           const finalKeys = visibleFields.map((f7) => f7.finalKey);
           Affirm_default(finalKeys.includes(ref.key), `code_lookup key column "${ref.key}" is not in the output of consumer "${ref.consumer}"`);
@@ -52250,7 +52521,7 @@ var init_LookupResolver = __esm({
             if (!line.length) continue;
             rowsRead++;
             Affirm_default(rowsRead <= Constants_default.defaults.MAX_LOOKUP_ROWS, `code_lookup table from consumer "${ref.consumer}" exceeds MAX_LOOKUP_ROWS (${Constants_default.defaults.MAX_LOOKUP_ROWS})`);
-            const record = this.parseLine(line, format3, visibleFields);
+            const record = this.parseLine(line, format4, visibleFields);
             const code = String(record[ref.key]);
             if (code in dict && !warnedDup) {
               Logger_default.warn(`code_lookup: duplicate key(s) in consumer "${ref.consumer}" for "${ref.key}"; last value wins`);
@@ -52261,8 +52532,8 @@ var init_LookupResolver = __esm({
           Logger_default.log(`[lookup] Built table "${ref.consumer}" (${ref.key}->${ref.value}): ${Object.keys(dict).length} entr(ies) from ${rowsRead} row(s)`);
           return dict;
         };
-        this.parseLine = (line, format3, visibleFields) => {
-          if (format3 === "CSV") return LineParser_default._internalParseCSV(line, visibleFields, ",");
+        this.parseLine = (line, format4, visibleFields) => {
+          if (format4 === "CSV") return LineParser_default._internalParseCSV(line, visibleFields, ",");
           return JSON.parse(line);
         };
         this.getCapturePath = (scope, consumerName) => {
@@ -52289,11 +52560,11 @@ var init_LookupResolver = __esm({
 });
 
 // ../../packages/executors/src/ConsumerInputResolver.ts
-var import_fs19, import_promises15, import_path27, ConsumerInputResolverClass, ConsumerInputResolver, ConsumerInputResolver_default;
+var import_fs19, import_promises16, import_path27, ConsumerInputResolverClass, ConsumerInputResolver, ConsumerInputResolver_default;
 var init_ConsumerInputResolver = __esm({
   "../../packages/executors/src/ConsumerInputResolver.ts"() {
     import_fs19 = __toESM(require("fs"));
-    import_promises15 = __toESM(require("fs/promises"));
+    import_promises16 = __toESM(require("fs/promises"));
     import_path27 = __toESM(require("path"));
     init_src();
     init_src3();
@@ -52324,7 +52595,7 @@ var init_ConsumerInputResolver = __esm({
               const capturePath = ExecutorScope_default.getConsumerInputPath(scope, name);
               ExecutorScope_default.ensurePath(capturePath);
               await this.runUpstreamConsumer(upstream, capturePath, stack, request);
-              const { size } = await import_promises15.default.stat(capturePath);
+              const { size } = await import_promises16.default.stat(capturePath);
               this.cache.set(name, { consumer: name, path: import_path27.default.resolve(capturePath), fileSize: size });
             }
             manifest.set(name, this.cache.get(name));
@@ -52387,11 +52658,11 @@ var ExecutorOrchestrator_exports = {};
 __export(ExecutorOrchestrator_exports, {
   default: () => ExecutorOrchestrator_default
 });
-var import_fs20, import_promises16, import_path28, import_readline9, import_workerpool, import_promises17, ExecutorOrchestratorClass, ExecutorOrchestrator, ExecutorOrchestrator_default;
+var import_fs20, import_promises17, import_path28, import_readline9, import_workerpool, import_promises18, ExecutorOrchestratorClass, ExecutorOrchestrator, ExecutorOrchestrator_default;
 var init_ExecutorOrchestrator = __esm({
   "../../packages/executors/src/ExecutorOrchestrator.ts"() {
     import_fs20 = __toESM(require("fs"));
-    import_promises16 = __toESM(require("fs/promises"));
+    import_promises17 = __toESM(require("fs/promises"));
     import_path28 = __toESM(require("path"));
     import_readline9 = __toESM(require("readline"));
     import_workerpool = __toESM(require("workerpool"));
@@ -52409,7 +52680,7 @@ var init_ExecutorOrchestrator = __esm({
     init_src();
     init_src10();
     init_ExecutorWriter();
-    import_promises17 = require("stream/promises");
+    import_promises18 = require("stream/promises");
     init_src2();
     init_ExecutorProgress2();
     init_src6();
@@ -52627,7 +52898,8 @@ var init_ExecutorOrchestrator = __esm({
           } catch (error) {
             Logger_default.log(`[${usageId}] Consumer "${consumer.name}" failed: ${Helper_default.asError(error).message} | ${OrchestratorHelper_default.formatMemoryUsage()}`);
             Logger_default.error(error);
-            await ConsumerOnFinishManager_default.onConsumerError(consumer, usageId, this.makeOnFinishRunner(consumer, request, usageId));
+            if (!request.skipExport)
+              await ConsumerOnFinishManager_default.onConsumerError(consumer, usageId, this.makeOnFinishRunner(consumer, request, usageId));
             Logger_default.log(`[${usageId}] Running cleanup after failure`);
             await this.performCleanupOperations(scope, tracker);
             UsageManager_default.failUsage(usageId, Helper_default.asError(error).message);
@@ -52925,10 +53197,10 @@ var init_ExecutorOrchestrator = __esm({
          * format has no header row, so each row is reprojected. Without a captureFormat it's a verbatim copy.
          */
         this.captureDataset = async (consumer, fields, sourcePath, targetPath, captureFormat) => {
-          await import_promises16.default.mkdir(import_path28.default.dirname(targetPath), { recursive: true });
+          await import_promises17.default.mkdir(import_path28.default.dirname(targetPath), { recursive: true });
           const internalFormat = OutputExecutor_default._getInternalRecordFormat(consumer);
           if (captureFormat !== "JSONL" || internalFormat !== "CSV") {
-            await import_promises16.default.copyFile(sourcePath, targetPath);
+            await import_promises17.default.copyFile(sourcePath, targetPath);
             return;
           }
           const visibleFields = fields.filter((field) => !field.cField.hidden);
@@ -53031,22 +53303,22 @@ var init_ExecutorOrchestrator = __esm({
                   startRow: prod.settings.startRow,
                   startColumn: prod.settings.startColumn
                 });
-                await (0, import_promises17.pipeline)(
+                await (0, import_promises18.pipeline)(
                   xlsCsvStream,
                   import_fs20.default.createWriteStream(decodedPath)
                 );
-                const fileStats = await import_promises16.default.stat(decodedPath);
+                const fileStats = await import_promises17.default.stat(decodedPath);
                 decodedFiles.push({ fullUri: decodedPath, fileSize: fileStats.size });
                 decodedCount++;
                 reportFile();
                 continue;
               }
               if (inferredType === "XML") {
-                const fileContent = await import_promises16.default.readFile(file.fullUri, "utf-8");
+                const fileContent = await import_promises17.default.readFile(file.fullUri, "utf-8");
                 const jsonData = XMLParser_default.xmlToJson(fileContent);
                 const records = normalizeXmlRows(jsonData);
                 if (records.length === 0) {
-                  await import_promises16.default.writeFile(decodedPath, "", "utf-8");
+                  await import_promises17.default.writeFile(decodedPath, "", "utf-8");
                 } else {
                   const columns = [];
                   for (const record of records) {
@@ -53062,9 +53334,9 @@ var init_ExecutorOrchestrator = __esm({
                     const row = columns.map((column) => csvSafeValue(record[column]));
                     lines.push(CSVParser_default.stringifyRow(row));
                   }
-                  await import_promises16.default.writeFile(decodedPath, lines.join("\n"), "utf-8");
+                  await import_promises17.default.writeFile(decodedPath, lines.join("\n"), "utf-8");
                 }
-                const fileStats = await import_promises16.default.stat(decodedPath);
+                const fileStats = await import_promises17.default.stat(decodedPath);
                 decodedFiles.push({ fullUri: decodedPath, fileSize: fileStats.size });
                 decodedCount++;
                 reportFile();
@@ -53092,20 +53364,20 @@ var init_ExecutorOrchestrator = __esm({
             Logger_default.log(`[${scope.id}] Merging ${executorResults.length} worker output files into ${mainPath}`);
             const perf = performance.now();
             for (const workerResult of executorResults) {
-              await (0, import_promises17.pipeline)(
+              await (0, import_promises18.pipeline)(
                 import_fs20.default.createReadStream(workerResult.resultUri),
                 import_fs20.default.createWriteStream(mainPath, { flags: "a" })
               );
-              await import_promises16.default.unlink(workerResult.resultUri);
+              await import_promises17.default.unlink(workerResult.resultUri);
             }
             tracker.measure("merge-workers", performance.now() - perf);
             Logger_default.log(`[${scope.id}] Merge complete in ${Math.round(performance.now() - perf)}ms`);
           } else if (executorResults.length === 1) {
             Logger_default.log(`[${scope.id}] Single worker \u2014 renaming output to ${mainPath}`);
-            await import_promises16.default.rename(executorResults[0].resultUri, mainPath);
+            await import_promises17.default.rename(executorResults[0].resultUri, mainPath);
           } else {
             Logger_default.log(`[${scope.id}] No worker output \u2014 writing an empty dataset to ${mainPath}`);
-            await import_promises16.default.writeFile(mainPath, "");
+            await import_promises17.default.writeFile(mainPath, "");
           }
           return mainPath;
         };
@@ -53826,6 +54098,164 @@ init_src4();
 init_OutputExecutor();
 init_ProducerExecutor();
 
+// ../../packages/executors/src/SampleRunner.ts
+var import_fs21 = __toESM(require("fs"));
+var import_promises19 = __toESM(require("fs/promises"));
+var import_path29 = __toESM(require("path"));
+var import_readline10 = __toESM(require("readline"));
+init_src();
+init_src3();
+init_src4();
+init_src8();
+init_src10();
+init_src5();
+init_src2();
+init_ExecutorOrchestrator();
+var MAX_WALK_DEPTH = 20;
+var SAMPLE_USER = { user: { _id: "sample", name: "sample", type: "licence" } };
+var SampleRunnerClass = class {
+  constructor() {
+    /**
+     * @param resourceName a producer or consumer name, as declared.
+     * @param rows the most rows to return, capped at `MAX_SAMPLE_ROWS`.
+     * @throws when the name is neither, when a source cannot be read, or when the pipeline itself
+     *         fails — a consumer whose transformation throws is a sample that reports the reason.
+     */
+    this.read = async (resourceName, rows = 10, details) => {
+      Affirm_default(resourceName, "Missing resource name to sample");
+      Affirm_default(rows > 0, "Sample size must be greater than 0");
+      const size = Math.min(rows, Constants_default.defaults.MAX_SAMPLE_ROWS);
+      const producer = Environment_default.getProducer(resourceName);
+      if (producer) {
+        const records = await ProducerEngine_default.readSampleData(producer, size, false);
+        return {
+          kind: "producer",
+          name: resourceName,
+          records,
+          note: `${records.length} row(s) read from the source now, with this producer's dimensions, types and masks applied.`
+        };
+      }
+      const consumer = Environment_default.getConsumer(resourceName);
+      Affirm_default(consumer, `Resource "${resourceName}" not found. Please check if it exists as a producer or consumer.`);
+      return this._runConsumer(consumer, size, details);
+    };
+    /**
+     * Runs the consumer for real and reads back what it produced.
+     *
+     * The output is captured instead of exported, so nothing reaches the consumer's destination and
+     * no onSuccess action fires: looking at data must never be indistinguishable from publishing it.
+     */
+    this._runConsumer = async (consumer, size, details) => {
+      this._assertStageable(consumer);
+      const capturePath = import_path29.default.resolve(import_path29.default.join(ExecutorScope_default.getBasePath(), `sample_${consumer.name}_${Helper_default.uuid()}.jsonl`));
+      ExecutorScope_default.ensurePath(capturePath);
+      try {
+        const result = await ExecutorOrchestrator_default.launch({
+          consumer,
+          // `SAMPLE`, so the run it records is distinguishable from one the project did. The
+          // executor treats it like any other invocation; only `RunOverlay` reads the marker.
+          details: { ...details ?? SAMPLE_USER, invokedBy: "SAMPLE" },
+          // The rows asked for, bounded the way `remora run -l` bounds them — pushed to the
+          // source and stopped early per worker wherever nothing downstream can drop a record.
+          options: { limit: size },
+          // Nothing reaches the destination and no finish action fires; the merged dataset
+          // comes back through the same capture the lookup and consumer-input runs use.
+          skipExport: true,
+          captureMainDatasetTo: capturePath,
+          captureFormat: "JSONL"
+        });
+        const captured = await this._readCapture(capturePath, size);
+        const records = captured.map((record) => this._inFieldOrder(consumer, record));
+        Logger_default.log(`[sample] Consumer "${consumer.name}": ${records.length} row(s) from ${result.inputCount} input line(s)`);
+        return {
+          kind: "consumer",
+          name: consumer.name,
+          records,
+          note: `${records.length} row(s) from the real pipeline \u2014 filters, transformations, masking and validation all applied, exactly as in a run. Nothing was written to the destination.`
+        };
+      } finally {
+        await import_promises19.default.rm(capturePath, { force: true });
+      }
+    };
+    /**
+     * Refuses, naming the source, when a run could not read one of this consumer's producers.
+     *
+     * `RedshiftDriver.ready` and `HttpApiSourceDriver.ready` are unimplemented, so the pipeline
+     * cannot reach those sources at all. Checked up front because the alternative is a run that
+     * spins up a worker pool and then surfaces "Not implemented yet" from three layers down, which
+     * names neither the producer nor the source that caused it.
+     */
+    this._assertStageable = (consumer) => {
+      for (const producer of this._inputProducers(consumer)) {
+        const source = Environment_default.getSource(producer.source);
+        Affirm_default(source, `Producer "${producer.name}" of consumer "${consumer.name}" has no source "${producer.source}"`);
+        if (!DriverFactory_default.canStage(source.engine))
+          throw new Error(`Cannot sample consumer "${consumer.name}": its producer "${producer.name}" reads source "${source.name}", and a "${source.engine}" source cannot be run through the pipeline yet. Sample the producer "${producer.name}" instead to see its rows.`);
+      }
+    };
+    /**
+     * Every producer a run of this consumer would stage — its own, plus those of the consumers it
+     * reads as input or consults as a code_lookup table, since each of those is executed too.
+     */
+    this._inputProducers = (consumer, visited = []) => {
+      Affirm_default(!visited.includes(consumer.name), `Consumer "${consumer.name}" reads itself through ${visited.join(" \u2192 ")}`);
+      Affirm_default(visited.length < MAX_WALK_DEPTH, `Consumer chain from "${visited[0]}" is more than ${MAX_WALK_DEPTH} deep`);
+      const seen = [...visited, consumer.name];
+      const upstream = [
+        ...consumer.producers.map((entry) => entry.name),
+        ...ConsumerManager_default.collectLookupRefs(ConsumerManager_default.getExpandedFields(consumer)).map((ref) => ref.consumer)
+      ];
+      return upstream.flatMap((name) => {
+        const producer = Environment_default.getProducer(name);
+        if (producer) return [producer];
+        const nested = Environment_default.getConsumer(name);
+        Affirm_default(nested, `Producer or consumer "${name}" not found for consumer "${consumer.name}"`);
+        return this._inputProducers(nested, seen);
+      });
+    };
+    /**
+     * One row's keys in the order the consumer DECLARES its fields.
+     *
+     * A record comes out of a worker keyed in the order the producer's dimensions were read, which is
+     * the source's layout and not the consumer's — so a consumer declaring country, plan, is_active
+     * over a producer that stores is_active first would be shown its own columns in someone else's
+     * order. Invisible in an exported JSON object; the whole shape of the table here.
+     *
+     * Anything the record carries that the field list does not name is appended rather than dropped:
+     * a column that turns up unexpectedly is exactly the one worth seeing.
+     */
+    this._inFieldOrder = (consumer, record) => {
+      const declared = ConsumerManager_default.getExpandedFields(consumer).filter((field) => !field.cField.hidden).map((field) => field.finalKey);
+      const ordered = {};
+      for (const key of declared) {
+        if (key in record) ordered[key] = record[key];
+      }
+      for (const key of Object.keys(record)) {
+        if (!(key in ordered)) ordered[key] = record[key];
+      }
+      return ordered;
+    };
+    /** The captured dataset, which `captureFormat: 'JSONL'` guarantees is one JSON object per line. */
+    this._readCapture = async (capturePath, size) => {
+      if (!import_fs21.default.existsSync(capturePath)) return [];
+      const records = [];
+      const lines = import_readline10.default.createInterface({ input: import_fs21.default.createReadStream(capturePath), crlfDelay: Infinity });
+      try {
+        for await (const line of lines) {
+          if (!line.length) continue;
+          records.push(JSON.parse(line));
+          if (records.length >= size) break;
+        }
+      } finally {
+        lines.close();
+      }
+      return records;
+    };
+  }
+};
+var SampleRunner = new SampleRunnerClass();
+var SampleRunner_default = SampleRunner;
+
 // src/actions/run.ts
 init_src4();
 init_src2();
@@ -53966,10 +54396,10 @@ init_src5();
 init_src2();
 var FORMATS = ["mermaid", "dot", "json"];
 var graph = async (options) => {
-  const format3 = options?.format ?? "mermaid";
+  const format4 = options?.format ?? "mermaid";
   try {
-    if (!FORMATS.includes(format3)) {
-      console.error(import_chalk9.default.red(`Unknown format "${format3}". Use one of: ${FORMATS.join(", ")}.`));
+    if (!FORMATS.includes(format4)) {
+      console.error(import_chalk9.default.red(`Unknown format "${format4}". Use one of: ${FORMATS.join(", ")}.`));
       await Logger_default.flush();
       process.exit(1);
     }
@@ -53979,10 +54409,10 @@ var graph = async (options) => {
       generatedBy: `remora ${Constants_default.cliVersion}`,
       loadDiagnostics: Diagnostics_default.fromLoadProblems(problems),
       // The json format IS the viewer's contract, so every resource view ships with it.
-      resources: format3 === "json" ? "inline" : "lazy"
+      resources: format4 === "json" ? "inline" : "lazy"
     });
-    process.stdout.write(render(format3, snapshot) + "\n");
-    if (format3 !== "json")
+    process.stdout.write(render(format4, snapshot) + "\n");
+    if (format4 !== "json")
       reportDiagnostics(snapshot.diagnostics);
   } catch (err2) {
     const myErr = Helper_default.asError(err2);
@@ -53992,9 +54422,9 @@ var graph = async (options) => {
     process.exit(1);
   }
 };
-var render = (format3, snapshot) => {
-  if (format3 === "json") return JSON.stringify(snapshot, null, 4);
-  if (format3 === "dot") return LineageRenderer_default.toDot(snapshot.graph);
+var render = (format4, snapshot) => {
+  if (format4 === "json") return JSON.stringify(snapshot, null, 4);
+  if (format4 === "dot") return LineageRenderer_default.toDot(snapshot.graph);
   return LineageRenderer_default.toMermaid(snapshot.graph);
 };
 var reportDiagnostics = (diagnostics) => {
@@ -54018,6 +54448,7 @@ init_src5();
 init_src2();
 var WATCH_INTERVAL_MS = 1e3;
 var SAMPLEABLE_KINDS = ["producer", "consumer"];
+var PIPELINE_SAMPLE_KINDS = ["consumer"];
 var EDITABLE_KINDS = {
   source: "source",
   producer: "producer",
@@ -54054,11 +54485,15 @@ var PreviewProject = class {
     this._files = [];
     this._hash = null;
     /**
-     * The consumer a run started from this page is executing, or null.
+     * What this page is currently executing, or null — a run, or a consumer sample.
+     *
+     * One at a time, deliberately: `remora run` runs consumers sequentially, and two concurrent
+     * executions would each spin up a worker pool in this one process. Refusing the second with the
+     * name of the first is a better answer than thrashing the machine.
      *
-     * One at a time, deliberately: `remora run` runs consumers sequentially, and two concurrent runs
-     * would each spin up a worker pool in this one process. Refusing the second with the name of the
-     * first is a better answer than thrashing the machine.
+     * A sample takes the same lock because it IS an execution: bounded at the input and exporting
+     * nothing, but a worker pool either way. That also means a sample and a run cannot overlap, which
+     * is what stops a click on one panel from slowing the run someone is watching on another.
      */
     this._running = null;
     /** @returns true when the project changed and the snapshot was rebuilt. */
@@ -54104,18 +54539,47 @@ var PreviewProject = class {
           ]
         };
       },
-      sample: async (nodeId, rows) => {
-        if (!this._has(nodeId)) return null;
-        const { kind, name } = LineageEngine_default.parseNodeId(nodeId);
-        if (!SAMPLEABLE_KINDS.includes(kind)) return null;
-        const { records } = await SampleEngine_default.read(name, rows);
-        return ResourceView_default.buildSampleTable(records);
-      },
+      sample: async (nodeId, rows) => this._sample(nodeId, rows),
       run: async (nodeId) => this._run(nodeId),
       file: (nodeId) => this._file(nodeId),
       save: async (nodeId, content) => this._save(nodeId, content),
       logs: (lines) => this._logs(lines)
     });
+    /**
+     * The rows a resource actually holds, as a table.
+     *
+     * A producer answers from a bounded read of its source. A consumer answers by RUNNING — every
+     * filter, transformation, mask, union, distinct, pivot and validation it declares, over a
+     * bounded slice of each producer's input, exporting nothing and recording nothing. Which of the
+     * two happened, and over how much input, is the note `SampleRunner` returns; it becomes the
+     * table's title, so the panel states what it is showing instead of leaving it to be assumed.
+     *
+     * Awaited, unlike a run: a sample is bounded, and its ANSWER is the rows — there is nothing for
+     * the run overlay to show, because a sample deliberately leaves no trace on it.
+     */
+    this._sample = async (nodeId, rows) => {
+      if (!this._has(nodeId)) return null;
+      const { kind, name } = LineageEngine_default.parseNodeId(nodeId);
+      if (!SAMPLEABLE_KINDS.includes(kind)) return null;
+      const pipeline6 = PIPELINE_SAMPLE_KINDS.includes(kind);
+      if (pipeline6 && this._running)
+        throw new Error(`"${this._running}" is still running; one execution at a time`);
+      const blocking = pipeline6 ? this.snapshot.diagnostics.find((x2) => x2.node === nodeId && x2.severity === "error") : null;
+      if (blocking) throw new Error(`Refusing to sample "${name}": ${blocking.message}`);
+      if (pipeline6) this._running = name;
+      try {
+        const licence = LicenceManager_default.validate(ProcessENVManager_default.getEnvVariable("REMORA_LICENCE_KEY"));
+        const { records, note } = await SampleRunner_default.read(name, rows, {
+          // A sample from the preview is a sample from the CLI. It records no usage, so this
+          // only ever names the run in the log.
+          invokedBy: "CLI",
+          user: { _id: licence.customer, name: licence.customer, type: "licence" }
+        });
+        return ResourceView_default.buildSampleTable(records, note);
+      } finally {
+        if (pipeline6) this._running = null;
+      }
+    };
     /**
      * Executes a consumer, and answers as soon as it has STARTED.
      *
@@ -54127,7 +54591,7 @@ var PreviewProject = class {
       if (!this._has(nodeId)) return { started: false, message: `No resource "${nodeId}" in this project` };
       const { kind, name } = LineageEngine_default.parseNodeId(nodeId);
       if (kind !== "consumer") return { started: false, message: `Only a consumer can be run; "${name}" is a ${kind}` };
-      if (this._running) return { started: false, message: `"${this._running}" is still running; one run at a time` };
+      if (this._running) return { started: false, message: `"${this._running}" is still running; one execution at a time` };
       const blocking = this.snapshot.diagnostics.find((x2) => x2.node === nodeId && x2.severity === "error");
       if (blocking) return { started: false, message: `Refusing to run "${name}": ${blocking.message}` };
       const consumer = Environment_default.getConsumer(name);
@@ -54251,22 +54715,22 @@ var stopOnSignal = (server, watch) => {
 
 // src/actions/create_producer.ts
 var import_chalk11 = __toESM(require("chalk"));
-var import_fs21 = __toESM(require("fs"));
-var import_path29 = __toESM(require("path"));
+var import_fs22 = __toESM(require("fs"));
+var import_path30 = __toESM(require("path"));
 init_src2();
 var create_producer = async (name) => {
   try {
-    if (!import_fs21.default.existsSync("./remora/producers")) {
+    if (!import_fs22.default.existsSync("./remora/producers")) {
       throw new Error(import_chalk11.default.red("Missing directory: ") + import_chalk11.default.yellow("./remora/producers"));
     }
-    const defaultProducerTemplate = import_fs21.default.readFileSync(
-      import_path29.default.join(DOCUMENTATION_DIR, "default_resources/producer.json"),
+    const defaultProducerTemplate = import_fs22.default.readFileSync(
+      import_path30.default.join(DOCUMENTATION_DIR, "default_resources/producer.json"),
       "utf-8"
     );
     const defaultProducer = JSON.parse(defaultProducerTemplate);
     defaultProducer.name = name;
-    const producerPath = import_path29.default.join("remora/producers", `${name}.json`);
-    import_fs21.default.writeFileSync(producerPath, JSON.stringify(defaultProducer, null, 4));
+    const producerPath = import_path30.default.join("remora/producers", `${name}.json`);
+    import_fs22.default.writeFileSync(producerPath, JSON.stringify(defaultProducer, null, 4));
     console.log(import_chalk11.default.green(`\u2705 Created producer config at ${producerPath}`));
     console.log(import_chalk11.default.blue("Remember to:"));
     console.log(import_chalk11.default.blue("1. Set the correct source name"));
@@ -54281,26 +54745,26 @@ var create_producer = async (name) => {
 
 // src/actions/create_consumer.ts
 var import_chalk12 = __toESM(require("chalk"));
-var import_fs22 = __toESM(require("fs"));
-var import_path30 = __toESM(require("path"));
+var import_fs23 = __toESM(require("fs"));
+var import_path31 = __toESM(require("path"));
 init_src2();
 var create_consumer = async (name, producerName) => {
   try {
-    if (!import_fs22.default.existsSync("./remora/consumers")) {
+    if (!import_fs23.default.existsSync("./remora/consumers")) {
       throw new Error(import_chalk12.default.red("Missing directory: ") + import_chalk12.default.yellow("./remora/consumers"));
     }
-    const defaultConsumerTemplate = import_fs22.default.readFileSync(
-      import_path30.default.join(DOCUMENTATION_DIR, "default_resources/consumer.json"),
+    const defaultConsumerTemplate = import_fs23.default.readFileSync(
+      import_path31.default.join(DOCUMENTATION_DIR, "default_resources/consumer.json"),
       "utf-8"
     );
     const defaultConsumer = JSON.parse(defaultConsumerTemplate);
     defaultConsumer.name = name;
     if (producerName) {
-      const producerPath = import_path30.default.join("remora/producers", `${producerName}.json`);
-      if (!import_fs22.default.existsSync(producerPath)) {
+      const producerPath = import_path31.default.join("remora/producers", `${producerName}.json`);
+      if (!import_fs23.default.existsSync(producerPath)) {
         throw new Error(import_chalk12.default.red("Producer not found: ") + import_chalk12.default.yellow(producerPath));
       }
-      const producerConfig = JSON.parse(import_fs22.default.readFileSync(producerPath, "utf-8"));
+      const producerConfig = JSON.parse(import_fs23.default.readFileSync(producerPath, "utf-8"));
       defaultConsumer.producers = [{ name: producerName }];
       defaultConsumer.fields = producerConfig.dimensions.map((dim) => ({
         key: dim.name,
@@ -54319,8 +54783,8 @@ var create_consumer = async (name, producerName) => {
       defaultConsumer.filters = void 0;
       defaultConsumer.metadata = void 0;
     }
-    const consumerPath = import_path30.default.join("remora/consumers", `${name}.json`);
-    import_fs22.default.writeFileSync(consumerPath, JSON.stringify(defaultConsumer, null, 4));
+    const consumerPath = import_path31.default.join("remora/consumers", `${name}.json`);
+    import_fs23.default.writeFileSync(consumerPath, JSON.stringify(defaultConsumer, null, 4));
     console.log(import_chalk12.default.green(`\u2705 Created consumer config at ${consumerPath}`));
     if (!producerName) {
       console.log(import_chalk12.default.blue("Remember to:"));
@@ -54348,8 +54812,8 @@ init_src5();
 var import_chalk13 = __toESM(require("chalk"));
 var import_ora5 = __toESM(require("ora"));
 init_src10();
-var import_fs23 = __toESM(require("fs"));
-var import_path31 = __toESM(require("path"));
+var import_fs24 = __toESM(require("fs"));
+var import_path32 = __toESM(require("path"));
 init_src4();
 init_src10();
 init_src2();
@@ -54378,14 +54842,14 @@ var automap = async (producerName, schemaNames) => {
     const mapResult = await AutoMapperEngine_default.map(sampleStrings, schemas, producer.settings.fileKey, [source]);
     for (const producer2 of mapResult.producers) {
       const producerPath = Environment_default.resolveResourceFilePath("producers", producer2.name);
-      import_fs23.default.mkdirSync(import_path31.default.dirname(producerPath), { recursive: true });
-      import_fs23.default.writeFileSync(producerPath, JSON.stringify(producer2, null, 4));
+      import_fs24.default.mkdirSync(import_path32.default.dirname(producerPath), { recursive: true });
+      import_fs24.default.writeFileSync(producerPath, JSON.stringify(producer2, null, 4));
       console.log(import_chalk13.default.blue(`Created producer: ${producer2.name}`));
     }
     for (const consumer of mapResult.consumers) {
       const consumerPath = Environment_default.resolveResourceFilePath("consumers", consumer.name);
-      import_fs23.default.mkdirSync(import_path31.default.dirname(consumerPath), { recursive: true });
-      import_fs23.default.writeFileSync(consumerPath, JSON.stringify(consumer, null, 4));
+      import_fs24.default.mkdirSync(import_path32.default.dirname(consumerPath), { recursive: true });
+      import_fs24.default.writeFileSync(consumerPath, JSON.stringify(consumer, null, 4));
       console.log(import_chalk13.default.blue(`Created consumer: ${consumer.name}`));
     }
     spinner.succeed("Producer has been successfully mapped");
@@ -54405,7 +54869,6 @@ var automap = async (producerName, schemaNames) => {
 // src/actions/sample.ts
 var import_chalk14 = __toESM(require("chalk"));
 var import_ora6 = __toESM(require("ora"));
-init_src10();
 init_src5();
 init_src2();
 var sample = async (resourceName, sampleSize = 10) => {
@@ -54413,8 +54876,9 @@ var sample = async (resourceName, sampleSize = 10) => {
     compile();
     console.log();
     const spinner = (0, import_ora6.default)(import_chalk14.default.blue(`Sampling "${resourceName}"...`)).start();
-    const { kind, records } = await SampleEngine_default.read(resourceName, sampleSize);
+    const { kind, records, note } = await SampleRunner_default.read(resourceName, sampleSize);
     spinner.succeed(import_chalk14.default.green(`Sample data retrieved from ${kind} "${resourceName}"`));
+    console.log(import_chalk14.default.gray(`   ${note}`));
     if (records.length === 0) {
       console.log(import_chalk14.default.yellow("No data found in the dataset."));
       return;