@telepath-computer/television 0.1.170 → 0.1.171

package/dist/cli.cjs

@@ -1194,7 +1194,7 @@ var require_command = __commonJS({
   "../../node_modules/commander/lib/command.js"(exports2) {
     var EventEmitter2 = require("node:events").EventEmitter;
     var childProcess = require("node:child_process");
-    var path12 = require("node:path");
+    var path15 = require("node:path");
     var fs4 = require("node:fs");
     var process3 = require("node:process");
     var { Argument: Argument2, humanReadableArgName } = require_argument();
@@ -2207,9 +2207,9 @@ Expecting one of '${allowedValues.join("', '")}'`);
         let launchWithNode = false;
         const sourceExt = [".js", ".ts", ".tsx", ".mjs", ".cjs"];
         function findFile(baseDir, baseName) {
-          const localBin = path12.resolve(baseDir, baseName);
+          const localBin = path15.resolve(baseDir, baseName);
           if (fs4.existsSync(localBin)) return localBin;
-          if (sourceExt.includes(path12.extname(baseName))) return void 0;
+          if (sourceExt.includes(path15.extname(baseName))) return void 0;
           const foundExt = sourceExt.find(
             (ext) => fs4.existsSync(`${localBin}${ext}`)
           );
@@ -2227,17 +2227,17 @@ Expecting one of '${allowedValues.join("', '")}'`);
           } catch {
             resolvedScriptPath = this._scriptPath;
           }
-          executableDir = path12.resolve(
-            path12.dirname(resolvedScriptPath),
+          executableDir = path15.resolve(
+            path15.dirname(resolvedScriptPath),
             executableDir
           );
         }
         if (executableDir) {
           let localFile = findFile(executableDir, executableFile);
           if (!localFile && !subcommand._executableFile && this._scriptPath) {
-            const legacyName = path12.basename(
+            const legacyName = path15.basename(
               this._scriptPath,
-              path12.extname(this._scriptPath)
+              path15.extname(this._scriptPath)
             );
             if (legacyName !== this._name) {
               localFile = findFile(
@@ -2248,7 +2248,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
           }
           executableFile = localFile || executableFile;
         }
-        launchWithNode = sourceExt.includes(path12.extname(executableFile));
+        launchWithNode = sourceExt.includes(path15.extname(executableFile));
         let proc;
         if (process3.platform !== "win32") {
           if (launchWithNode) {
@@ -3163,7 +3163,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @return {Command}
        */
       nameFromFilename(filename) {
-        this._name = path12.basename(filename, path12.extname(filename));
+        this._name = path15.basename(filename, path15.extname(filename));
         return this;
       }
       /**
@@ -3177,9 +3177,9 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @param {string} [path]
        * @return {(string|null|Command)}
        */
-      executableDir(path13) {
-        if (path13 === void 0) return this._executableDir;
-        this._executableDir = path13;
+      executableDir(path16) {
+        if (path16 === void 0) return this._executableDir;
+        this._executableDir = path16;
         return this;
       }
       /**
@@ -21480,11 +21480,11 @@ var require_mime_types = __commonJS({
       }
       return exts[0];
     }
-    function lookup(path12) {
-      if (!path12 || typeof path12 !== "string") {
+    function lookup(path15) {
+      if (!path15 || typeof path15 !== "string") {
         return false;
       }
-      var extension3 = extname("x." + path12).toLowerCase().substr(1);
+      var extension3 = extname("x." + path15).toLowerCase().substr(1);
       if (!extension3) {
         return false;
       }
@@ -24221,7 +24221,7 @@ var require_path_to_regexp = __commonJS({
   "../../node_modules/path-to-regexp/index.js"(exports2, module2) {
     module2.exports = pathToRegexp;
     var MATCHING_GROUP_REGEXP = /\\.|\((?:\?<(.*?)>)?(?!\?)/g;
-    function pathToRegexp(path12, keys, options) {
+    function pathToRegexp(path15, keys, options) {
       options = options || {};
       keys = keys || [];
       var strict = options.strict;
@@ -24235,8 +24235,8 @@ var require_path_to_regexp = __commonJS({
       var pos = 0;
       var backtrack = "";
       var m2;
-      if (path12 instanceof RegExp) {
-        while (m2 = MATCHING_GROUP_REGEXP.exec(path12.source)) {
+      if (path15 instanceof RegExp) {
+        while (m2 = MATCHING_GROUP_REGEXP.exec(path15.source)) {
           if (m2[0][0] === "\\") continue;
           keys.push({
             name: m2[1] || name++,
@@ -24244,20 +24244,20 @@ var require_path_to_regexp = __commonJS({
             offset: m2.index
           });
         }
-        return path12;
+        return path15;
       }
-      if (Array.isArray(path12)) {
-        path12 = path12.map(function(value) {
+      if (Array.isArray(path15)) {
+        path15 = path15.map(function(value) {
           return pathToRegexp(value, keys, options).source;
         });
-        return new RegExp(path12.join("|"), flags);
+        return new RegExp(path15.join("|"), flags);
       }
-      if (typeof path12 !== "string") {
+      if (typeof path15 !== "string") {
         throw new TypeError("path must be a string, array of strings, or regular expression");
       }
-      path12 = path12.replace(
+      path15 = path15.replace(
         /\\.|(\/)?(\.)?:(\w+)(\(.*?\))?(\*)?(\?)?|[.*]|\/\(/g,
-        function(match, slash, format, key, capture, star, optional2, offset) {
+        function(match, slash, format, key, capture2, star, optional2, offset) {
           if (match[0] === "\\") {
             backtrack += match;
             pos += 2;
@@ -24272,7 +24272,7 @@ var require_path_to_regexp = __commonJS({
           if (slash || format) {
             backtrack = "";
           } else {
-            backtrack += path12.slice(pos, offset);
+            backtrack += path15.slice(pos, offset);
           }
           pos = offset + match.length;
           if (match === "*") {
@@ -24288,7 +24288,7 @@ var require_path_to_regexp = __commonJS({
           slash = slash || "";
           format = format ? "\\." : "";
           optional2 = optional2 || "";
-          capture = capture ? capture.replace(/\\.|\*/, function(m3) {
+          capture2 = capture2 ? capture2.replace(/\\.|\*/, function(m3) {
             return m3 === "*" ? "(.*)" : m3;
           }) : backtrack ? "((?:(?!/|" + backtrack + ").)+?)" : "([^/" + format + "]+?)";
           keys.push({
@@ -24296,13 +24296,13 @@ var require_path_to_regexp = __commonJS({
             optional: !!optional2,
             offset: offset + extraOffset
           });
-          var result = "(?:" + format + slash + capture + (star ? "((?:[/" + format + "].+?)?)" : "") + ")" + optional2;
+          var result = "(?:" + format + slash + capture2 + (star ? "((?:[/" + format + "].+?)?)" : "") + ")" + optional2;
           backtrack = "";
           extraOffset += result.length - match.length;
           return result;
         }
       );
-      while (m2 = MATCHING_GROUP_REGEXP.exec(path12)) {
+      while (m2 = MATCHING_GROUP_REGEXP.exec(path15)) {
         if (m2[0][0] === "\\") continue;
         if (keysOffset + i === keys.length || keys[keysOffset + i].offset > m2.index) {
           keys.splice(keysOffset + i, 0, {
@@ -24314,13 +24314,13 @@ var require_path_to_regexp = __commonJS({
         }
         i++;
       }
-      path12 += strict ? "" : path12[path12.length - 1] === "/" ? "?" : "/?";
+      path15 += strict ? "" : path15[path15.length - 1] === "/" ? "?" : "/?";
       if (end) {
-        path12 += "$";
-      } else if (path12[path12.length - 1] !== "/") {
-        path12 += lookahead ? "(?=/|$)" : "(?:/|$)";
+        path15 += "$";
+      } else if (path15[path15.length - 1] !== "/") {
+        path15 += lookahead ? "(?=/|$)" : "(?:/|$)";
       }
-      return new RegExp("^" + path12, flags);
+      return new RegExp("^" + path15, flags);
     }
   }
 });
@@ -24333,19 +24333,19 @@ var require_layer = __commonJS({
     var debug = require_src3()("express:router:layer");
     var hasOwnProperty = Object.prototype.hasOwnProperty;
     module2.exports = Layer;
-    function Layer(path12, options, fn) {
+    function Layer(path15, options, fn) {
       if (!(this instanceof Layer)) {
-        return new Layer(path12, options, fn);
+        return new Layer(path15, options, fn);
       }
-      debug("new %o", path12);
+      debug("new %o", path15);
       var opts = options || {};
       this.handle = fn;
       this.name = fn.name || "<anonymous>";
       this.params = void 0;
       this.path = void 0;
-      this.regexp = pathRegexp(path12, this.keys = [], opts);
-      this.regexp.fast_star = path12 === "*";
-      this.regexp.fast_slash = path12 === "/" && opts.end === false;
+      this.regexp = pathRegexp(path15, this.keys = [], opts);
+      this.regexp.fast_star = path15 === "*";
+      this.regexp.fast_slash = path15 === "/" && opts.end === false;
     }
     Layer.prototype.handle_error = function handle_error(error48, req, res, next) {
       var fn = this.handle;
@@ -24369,20 +24369,20 @@ var require_layer = __commonJS({
         next(err);
       }
     };
-    Layer.prototype.match = function match(path12) {
+    Layer.prototype.match = function match(path15) {
       var match2;
-      if (path12 != null) {
+      if (path15 != null) {
         if (this.regexp.fast_slash) {
           this.params = {};
           this.path = "";
           return true;
         }
         if (this.regexp.fast_star) {
-          this.params = { "0": decode_param(path12) };
-          this.path = path12;
+          this.params = { "0": decode_param(path15) };
+          this.path = path15;
           return true;
         }
-        match2 = this.regexp.exec(path12);
+        match2 = this.regexp.exec(path15);
       }
       if (!match2) {
         this.params = void 0;
@@ -24475,10 +24475,10 @@ var require_route = __commonJS({
     var slice = Array.prototype.slice;
     var toString = Object.prototype.toString;
     module2.exports = Route;
-    function Route(path12) {
-      this.path = path12;
+    function Route(path15) {
+      this.path = path15;
       this.stack = [];
-      debug("new %o", path12);
+      debug("new %o", path15);
       this.methods = {};
     }
     Route.prototype._handles_method = function _handles_method(method) {
@@ -24690,8 +24690,8 @@ var require_router = __commonJS({
         if (++sync > 100) {
           return setImmediate(next, err);
         }
-        var path12 = getPathname(req);
-        if (path12 == null) {
+        var path15 = getPathname(req);
+        if (path15 == null) {
           return done(layerError);
         }
         var layer;
@@ -24699,7 +24699,7 @@ var require_router = __commonJS({
         var route;
         while (match !== true && idx < stack.length) {
           layer = stack[idx++];
-          match = matchLayer(layer, path12);
+          match = matchLayer(layer, path15);
           route = layer.route;
           if (typeof match !== "boolean") {
             layerError = layerError || match;
@@ -24737,18 +24737,18 @@ var require_router = __commonJS({
           } else if (route) {
             layer.handle_request(req, res, next);
           } else {
-            trim_prefix(layer, layerError, layerPath, path12);
+            trim_prefix(layer, layerError, layerPath, path15);
           }
           sync = 0;
         });
       }
-      function trim_prefix(layer, layerError, layerPath, path12) {
+      function trim_prefix(layer, layerError, layerPath, path15) {
         if (layerPath.length !== 0) {
-          if (layerPath !== path12.slice(0, layerPath.length)) {
+          if (layerPath !== path15.slice(0, layerPath.length)) {
             next(layerError);
             return;
           }
-          var c = path12[layerPath.length];
+          var c = path15[layerPath.length];
           if (c && c !== "/" && c !== ".") return next(layerError);
           debug("trim prefix (%s) from url %s", layerPath, req.url);
           removed = layerPath;
@@ -24826,7 +24826,7 @@ var require_router = __commonJS({
     };
     proto.use = function use(fn) {
       var offset = 0;
-      var path12 = "/";
+      var path15 = "/";
       if (typeof fn !== "function") {
         var arg = fn;
         while (Array.isArray(arg) && arg.length !== 0) {
@@ -24834,7 +24834,7 @@ var require_router = __commonJS({
         }
         if (typeof arg !== "function") {
           offset = 1;
-          path12 = fn;
+          path15 = fn;
         }
       }
       var callbacks = flatten(slice.call(arguments, offset));
@@ -24846,8 +24846,8 @@ var require_router = __commonJS({
         if (typeof fn !== "function") {
           throw new TypeError("Router.use() requires a middleware function but got a " + gettype(fn));
         }
-        debug("use %o %s", path12, fn.name || "<anonymous>");
-        var layer = new Layer(path12, {
+        debug("use %o %s", path15, fn.name || "<anonymous>");
+        var layer = new Layer(path15, {
           sensitive: this.caseSensitive,
           strict: false,
           end: false
@@ -24857,9 +24857,9 @@ var require_router = __commonJS({
       }
       return this;
     };
-    proto.route = function route(path12) {
-      var route2 = new Route(path12);
-      var layer = new Layer(path12, {
+    proto.route = function route(path15) {
+      var route2 = new Route(path15);
+      var layer = new Layer(path15, {
         sensitive: this.caseSensitive,
         strict: this.strict,
         end: true
@@ -24869,8 +24869,8 @@ var require_router = __commonJS({
       return route2;
     };
     methods.concat("all").forEach(function(method) {
-      proto[method] = function(path12) {
-        var route = this.route(path12);
+      proto[method] = function(path15) {
+        var route = this.route(path15);
         route[method].apply(route, slice.call(arguments, 1));
         return this;
       };
@@ -24906,9 +24906,9 @@ var require_router = __commonJS({
       }
       return toString.call(obj).replace(objectRegExp, "$1");
     }
-    function matchLayer(layer, path12) {
+    function matchLayer(layer, path15) {
       try {
-        return layer.match(path12);
+        return layer.match(path15);
       } catch (err) {
         return err;
       }
@@ -25026,13 +25026,13 @@ var require_view = __commonJS({
   "../../node_modules/express/lib/view.js"(exports2, module2) {
     "use strict";
     var debug = require_src3()("express:view");
-    var path12 = require("path");
+    var path15 = require("path");
     var fs4 = require("fs");
-    var dirname = path12.dirname;
-    var basename = path12.basename;
-    var extname = path12.extname;
-    var join2 = path12.join;
-    var resolve = path12.resolve;
+    var dirname = path15.dirname;
+    var basename = path15.basename;
+    var extname = path15.extname;
+    var join2 = path15.join;
+    var resolve = path15.resolve;
     module2.exports = View;
     function View(name, options) {
       var opts = options || {};
@@ -25061,17 +25061,17 @@ var require_view = __commonJS({
       this.path = this.lookup(fileName);
     }
     View.prototype.lookup = function lookup(name) {
-      var path13;
+      var path16;
       var roots = [].concat(this.root);
       debug('lookup "%s"', name);
-      for (var i = 0; i < roots.length && !path13; i++) {
+      for (var i = 0; i < roots.length && !path16; i++) {
         var root = roots[i];
         var loc = resolve(root, name);
         var dir = dirname(loc);
         var file2 = basename(loc);
-        path13 = this.resolve(dir, file2);
+        path16 = this.resolve(dir, file2);
       }
-      return path13;
+      return path16;
     };
     View.prototype.render = function render(options, callback) {
       debug('render "%s"', this.path);
@@ -25079,21 +25079,21 @@ var require_view = __commonJS({
     };
     View.prototype.resolve = function resolve2(dir, file2) {
       var ext = this.ext;
-      var path13 = join2(dir, file2);
-      var stat = tryStat(path13);
+      var path16 = join2(dir, file2);
+      var stat = tryStat(path16);
       if (stat && stat.isFile()) {
-        return path13;
+        return path16;
       }
-      path13 = join2(dir, basename(file2, ext), "index" + ext);
-      stat = tryStat(path13);
+      path16 = join2(dir, basename(file2, ext), "index" + ext);
+      stat = tryStat(path16);
       if (stat && stat.isFile()) {
-        return path13;
+        return path16;
       }
     };
-    function tryStat(path13) {
-      debug('stat "%s"', path13);
+    function tryStat(path16) {
+      debug('stat "%s"', path16);
       try {
-        return fs4.statSync(path13);
+        return fs4.statSync(path16);
       } catch (e) {
         return void 0;
       }
@@ -25871,7 +25871,7 @@ var require_types = __commonJS({
 // ../../node_modules/mime/mime.js
 var require_mime = __commonJS({
   "../../node_modules/mime/mime.js"(exports2, module2) {
-    var path12 = require("path");
+    var path15 = require("path");
     var fs4 = require("fs");
     function Mime() {
       this.types = /* @__PURE__ */ Object.create(null);
@@ -25901,8 +25901,8 @@ var require_mime = __commonJS({
       this.define(map2);
       this._loading = null;
     };
-    Mime.prototype.lookup = function(path13, fallback) {
-      var ext = path13.replace(/^.*[\.\/\\]/, "").toLowerCase();
+    Mime.prototype.lookup = function(path16, fallback) {
+      var ext = path16.replace(/^.*[\.\/\\]/, "").toLowerCase();
       return this.types[ext] || fallback || this.default_type;
     };
     Mime.prototype.extension = function(mimeType) {
@@ -26136,28 +26136,28 @@ var require_send = __commonJS({
     var ms = require_ms5();
     var onFinished = require_on_finished();
     var parseRange = require_range_parser();
-    var path12 = require("path");
+    var path15 = require("path");
     var statuses = require_statuses();
     var Stream = require("stream");
     var util = require("util");
-    var extname = path12.extname;
-    var join2 = path12.join;
-    var normalize = path12.normalize;
-    var resolve = path12.resolve;
-    var sep = path12.sep;
+    var extname = path15.extname;
+    var join2 = path15.join;
+    var normalize = path15.normalize;
+    var resolve = path15.resolve;
+    var sep = path15.sep;
     var BYTES_RANGE_REGEXP = /^ *bytes=/;
     var MAX_MAXAGE = 60 * 60 * 24 * 365 * 1e3;
     var UP_PATH_REGEXP = /(?:^|[\\/])\.\.(?:[\\/]|$)/;
     module2.exports = send2;
     module2.exports.mime = mime;
-    function send2(req, path13, options) {
-      return new SendStream(req, path13, options);
+    function send2(req, path16, options) {
+      return new SendStream(req, path16, options);
     }
-    function SendStream(req, path13, options) {
+    function SendStream(req, path16, options) {
       Stream.call(this);
       var opts = options || {};
       this.options = opts;
-      this.path = path13;
+      this.path = path16;
       this.req = req;
       this._acceptRanges = opts.acceptRanges !== void 0 ? Boolean(opts.acceptRanges) : true;
       this._cacheControl = opts.cacheControl !== void 0 ? Boolean(opts.cacheControl) : true;
@@ -26203,8 +26203,8 @@ var require_send = __commonJS({
       this._index = index2;
       return this;
     }, "send.index: pass index as option");
-    SendStream.prototype.root = function root(path13) {
-      this._root = resolve(String(path13));
+    SendStream.prototype.root = function root(path16) {
+      this._root = resolve(String(path16));
       debug("root %s", this._root);
       return this;
     };
@@ -26317,10 +26317,10 @@ var require_send = __commonJS({
       var lastModified = this.res.getHeader("Last-Modified");
       return parseHttpDate(lastModified) <= parseHttpDate(ifRange);
     };
-    SendStream.prototype.redirect = function redirect(path13) {
+    SendStream.prototype.redirect = function redirect(path16) {
       var res = this.res;
       if (hasListeners(this, "directory")) {
-        this.emit("directory", res, path13);
+        this.emit("directory", res, path16);
         return;
       }
       if (this.hasTrailingSlash()) {
@@ -26340,42 +26340,42 @@ var require_send = __commonJS({
     SendStream.prototype.pipe = function pipe2(res) {
       var root = this._root;
       this.res = res;
-      var path13 = decode3(this.path);
-      if (path13 === -1) {
+      var path16 = decode3(this.path);
+      if (path16 === -1) {
         this.error(400);
         return res;
       }
-      if (~path13.indexOf("\0")) {
+      if (~path16.indexOf("\0")) {
         this.error(400);
         return res;
       }
       var parts;
       if (root !== null) {
-        if (path13) {
-          path13 = normalize("." + sep + path13);
+        if (path16) {
+          path16 = normalize("." + sep + path16);
         }
-        if (UP_PATH_REGEXP.test(path13)) {
-          debug('malicious path "%s"', path13);
+        if (UP_PATH_REGEXP.test(path16)) {
+          debug('malicious path "%s"', path16);
           this.error(403);
           return res;
         }
-        parts = path13.split(sep);
-        path13 = normalize(join2(root, path13));
+        parts = path16.split(sep);
+        path16 = normalize(join2(root, path16));
       } else {
-        if (UP_PATH_REGEXP.test(path13)) {
-          debug('malicious path "%s"', path13);
+        if (UP_PATH_REGEXP.test(path16)) {
+          debug('malicious path "%s"', path16);
           this.error(403);
           return res;
         }
-        parts = normalize(path13).split(sep);
-        path13 = resolve(path13);
+        parts = normalize(path16).split(sep);
+        path16 = resolve(path16);
       }
       if (containsDotFile(parts)) {
         var access2 = this._dotfiles;
         if (access2 === void 0) {
           access2 = parts[parts.length - 1][0] === "." ? this._hidden ? "allow" : "ignore" : "allow";
         }
-        debug('%s dotfile "%s"', access2, path13);
+        debug('%s dotfile "%s"', access2, path16);
         switch (access2) {
           case "allow":
             break;
@@ -26389,13 +26389,13 @@ var require_send = __commonJS({
         }
       }
       if (this._index.length && this.hasTrailingSlash()) {
-        this.sendIndex(path13);
+        this.sendIndex(path16);
         return res;
       }
-      this.sendFile(path13);
+      this.sendFile(path16);
       return res;
     };
-    SendStream.prototype.send = function send3(path13, stat) {
+    SendStream.prototype.send = function send3(path16, stat) {
       var len = stat.size;
       var options = this.options;
       var opts = {};
@@ -26407,9 +26407,9 @@ var require_send = __commonJS({
         this.headersAlreadySent();
         return;
       }
-      debug('pipe "%s"', path13);
-      this.setHeader(path13, stat);
-      this.type(path13);
+      debug('pipe "%s"', path16);
+      this.setHeader(path16, stat);
+      this.type(path16);
       if (this.isConditionalGET()) {
         if (this.isPreconditionFailure()) {
           this.error(412);
@@ -26458,26 +26458,26 @@ var require_send = __commonJS({
         res.end();
         return;
       }
-      this.stream(path13, opts);
+      this.stream(path16, opts);
     };
-    SendStream.prototype.sendFile = function sendFile(path13) {
+    SendStream.prototype.sendFile = function sendFile(path16) {
       var i = 0;
       var self2 = this;
-      debug('stat "%s"', path13);
-      fs4.stat(path13, function onstat(err, stat) {
-        if (err && err.code === "ENOENT" && !extname(path13) && path13[path13.length - 1] !== sep) {
+      debug('stat "%s"', path16);
+      fs4.stat(path16, function onstat(err, stat) {
+        if (err && err.code === "ENOENT" && !extname(path16) && path16[path16.length - 1] !== sep) {
           return next(err);
         }
         if (err) return self2.onStatError(err);
-        if (stat.isDirectory()) return self2.redirect(path13);
-        self2.emit("file", path13, stat);
-        self2.send(path13, stat);
+        if (stat.isDirectory()) return self2.redirect(path16);
+        self2.emit("file", path16, stat);
+        self2.send(path16, stat);
       });
       function next(err) {
         if (self2._extensions.length <= i) {
           return err ? self2.onStatError(err) : self2.error(404);
         }
-        var p = path13 + "." + self2._extensions[i++];
+        var p = path16 + "." + self2._extensions[i++];
         debug('stat "%s"', p);
         fs4.stat(p, function(err2, stat) {
           if (err2) return next(err2);
@@ -26487,7 +26487,7 @@ var require_send = __commonJS({
         });
       }
     };
-    SendStream.prototype.sendIndex = function sendIndex(path13) {
+    SendStream.prototype.sendIndex = function sendIndex(path16) {
       var i = -1;
       var self2 = this;
       function next(err) {
@@ -26495,7 +26495,7 @@ var require_send = __commonJS({
           if (err) return self2.onStatError(err);
           return self2.error(404);
         }
-        var p = join2(path13, self2._index[i]);
+        var p = join2(path16, self2._index[i]);
         debug('stat "%s"', p);
         fs4.stat(p, function(err2, stat) {
           if (err2) return next(err2);
@@ -26506,10 +26506,10 @@ var require_send = __commonJS({
       }
       next();
     };
-    SendStream.prototype.stream = function stream(path13, options) {
+    SendStream.prototype.stream = function stream(path16, options) {
       var self2 = this;
       var res = this.res;
-      var stream2 = fs4.createReadStream(path13, options);
+      var stream2 = fs4.createReadStream(path16, options);
       this.emit("stream", stream2);
       stream2.pipe(res);
       function cleanup() {
@@ -26524,10 +26524,10 @@ var require_send = __commonJS({
         self2.emit("end");
       });
     };
-    SendStream.prototype.type = function type(path13) {
+    SendStream.prototype.type = function type(path16) {
       var res = this.res;
       if (res.getHeader("Content-Type")) return;
-      var type2 = mime.lookup(path13);
+      var type2 = mime.lookup(path16);
       if (!type2) {
         debug("no content-type");
         return;
@@ -26536,9 +26536,9 @@ var require_send = __commonJS({
       debug("content-type %s", type2);
       res.setHeader("Content-Type", type2 + (charset ? "; charset=" + charset : ""));
     };
-    SendStream.prototype.setHeader = function setHeader(path13, stat) {
+    SendStream.prototype.setHeader = function setHeader(path16, stat) {
       var res = this.res;
-      this.emit("headers", res, path13, stat);
+      this.emit("headers", res, path16, stat);
       if (this._acceptRanges && !res.getHeader("Accept-Ranges")) {
         debug("accept ranges");
         res.setHeader("Accept-Ranges", "bytes");
@@ -26597,9 +26597,9 @@ var require_send = __commonJS({
       }
       return err instanceof Error ? createError(status, err, { expose: false }) : createError(status, err);
     }
-    function decode3(path13) {
+    function decode3(path16) {
       try {
-        return decodeURIComponent(path13);
+        return decodeURIComponent(path16);
       } catch (err) {
         return -1;
       }
@@ -27508,10 +27508,10 @@ var require_utils2 = __commonJS({
     var querystring = require("querystring");
     exports2.etag = createETagGenerator({ weak: false });
     exports2.wetag = createETagGenerator({ weak: true });
-    exports2.isAbsolute = function(path12) {
-      if ("/" === path12[0]) return true;
-      if (":" === path12[1] && ("\\" === path12[2] || "/" === path12[2])) return true;
-      if ("\\\\" === path12.substring(0, 2)) return true;
+    exports2.isAbsolute = function(path15) {
+      if ("/" === path15[0]) return true;
+      if (":" === path15[1] && ("\\" === path15[2] || "/" === path15[2])) return true;
+      if ("\\\\" === path15.substring(0, 2)) return true;
     };
     exports2.flatten = deprecate.function(
       flatten,
@@ -27722,7 +27722,7 @@ var require_application = __commonJS({
     };
     app.use = function use(fn) {
       var offset = 0;
-      var path12 = "/";
+      var path15 = "/";
       if (typeof fn !== "function") {
         var arg = fn;
         while (Array.isArray(arg) && arg.length !== 0) {
@@ -27730,7 +27730,7 @@ var require_application = __commonJS({
         }
         if (typeof arg !== "function") {
           offset = 1;
-          path12 = fn;
+          path15 = fn;
         }
       }
       var fns = flatten(slice.call(arguments, offset));
@@ -27741,12 +27741,12 @@ var require_application = __commonJS({
       var router = this._router;
       fns.forEach(function(fn2) {
         if (!fn2 || !fn2.handle || !fn2.set) {
-          return router.use(path12, fn2);
+          return router.use(path15, fn2);
         }
-        debug(".use app under %s", path12);
-        fn2.mountpath = path12;
+        debug(".use app under %s", path15);
+        fn2.mountpath = path15;
         fn2.parent = this;
-        router.use(path12, function mounted_app(req, res, next) {
+        router.use(path15, function mounted_app(req, res, next) {
           var orig = req.app;
           fn2.handle(req, res, function(err) {
             setPrototypeOf(req, orig.request);
@@ -27758,9 +27758,9 @@ var require_application = __commonJS({
       }, this);
       return this;
     };
-    app.route = function route(path12) {
+    app.route = function route(path15) {
       this.lazyrouter();
-      return this._router.route(path12);
+      return this._router.route(path15);
     };
     app.engine = function engine(ext, fn) {
       if (typeof fn !== "function") {
@@ -27811,7 +27811,7 @@ var require_application = __commonJS({
       }
       return this;
     };
-    app.path = function path12() {
+    app.path = function path15() {
       return this.parent ? this.parent.path() + this.mountpath : "";
     };
     app.enabled = function enabled(setting) {
@@ -27827,19 +27827,19 @@ var require_application = __commonJS({
       return this.set(setting, false);
     };
     methods.forEach(function(method) {
-      app[method] = function(path12) {
+      app[method] = function(path15) {
         if (method === "get" && arguments.length === 1) {
-          return this.set(path12);
+          return this.set(path15);
         }
         this.lazyrouter();
-        var route = this._router.route(path12);
+        var route = this._router.route(path15);
         route[method].apply(route, slice.call(arguments, 1));
         return this;
       };
     });
-    app.all = function all(path12) {
+    app.all = function all(path15) {
       this.lazyrouter();
-      var route = this._router.route(path12);
+      var route = this._router.route(path15);
       var args = slice.call(arguments, 1);
       for (var i = 0; i < methods.length; i++) {
         route[methods[i]].apply(route, args);
@@ -28489,7 +28489,7 @@ var require_request = __commonJS({
     "use strict";
     var accepts = require_accepts();
     var deprecate = require_depd()("express");
-    var isIP = require("net").isIP;
+    var isIP2 = require("net").isIP;
     var typeis = require_type_is();
     var http2 = require("http");
     var fresh = require_fresh();
@@ -28595,10 +28595,10 @@ var require_request = __commonJS({
       var hostname3 = this.hostname;
       if (!hostname3) return [];
       var offset = this.app.get("subdomain offset");
-      var subdomains2 = !isIP(hostname3) ? hostname3.split(".").reverse() : [hostname3];
+      var subdomains2 = !isIP2(hostname3) ? hostname3.split(".").reverse() : [hostname3];
       return subdomains2.slice(offset);
     });
-    defineGetter(req, "path", function path12() {
+    defineGetter(req, "path", function path15() {
       return parse3(this).pathname;
     });
     defineGetter(req, "hostname", function hostname3() {
@@ -28920,7 +28920,7 @@ var require_response = __commonJS({
     var http2 = require("http");
     var isAbsolute = require_utils2().isAbsolute;
     var onFinished = require_on_finished();
-    var path12 = require("path");
+    var path15 = require("path");
     var statuses = require_statuses();
     var merge2 = require_utils_merge();
     var sign = require_cookie_signature().sign;
@@ -28929,9 +28929,9 @@ var require_response = __commonJS({
     var setCharset = require_utils2().setCharset;
     var cookie = require_cookie();
     var send2 = require_send();
-    var extname = path12.extname;
+    var extname = path15.extname;
     var mime = send2.mime;
-    var resolve = path12.resolve;
+    var resolve = path15.resolve;
     var vary = require_vary();
     var res = Object.create(http2.ServerResponse.prototype);
     module2.exports = res;
@@ -29108,26 +29108,26 @@ var require_response = __commonJS({
       this.type("txt");
       return this.send(body);
     };
-    res.sendFile = function sendFile(path13, options, callback) {
+    res.sendFile = function sendFile(path16, options, callback) {
       var done = callback;
       var req = this.req;
       var res2 = this;
       var next = req.next;
       var opts = options || {};
-      if (!path13) {
+      if (!path16) {
         throw new TypeError("path argument is required to res.sendFile");
       }
-      if (typeof path13 !== "string") {
+      if (typeof path16 !== "string") {
         throw new TypeError("path must be a string to res.sendFile");
       }
       if (typeof options === "function") {
         done = options;
         opts = {};
       }
-      if (!opts.root && !isAbsolute(path13)) {
+      if (!opts.root && !isAbsolute(path16)) {
         throw new TypeError("path must be absolute or specify root to res.sendFile");
       }
-      var pathname = encodeURI(path13);
+      var pathname = encodeURI(path16);
       var file2 = send2(req, pathname, opts);
       sendfile(res2, file2, opts, function(err) {
         if (done) return done(err);
@@ -29137,7 +29137,7 @@ var require_response = __commonJS({
         }
       });
     };
-    res.sendfile = function(path13, options, callback) {
+    res.sendfile = function(path16, options, callback) {
       var done = callback;
       var req = this.req;
       var res2 = this;
@@ -29147,7 +29147,7 @@ var require_response = __commonJS({
         done = options;
         opts = {};
       }
-      var file2 = send2(req, path13, opts);
+      var file2 = send2(req, path16, opts);
       sendfile(res2, file2, opts, function(err) {
         if (done) return done(err);
         if (err && err.code === "EISDIR") return next();
@@ -29160,7 +29160,7 @@ var require_response = __commonJS({
       res.sendfile,
       "res.sendfile: Use res.sendFile instead"
     );
-    res.download = function download(path13, filename, options, callback) {
+    res.download = function download(path16, filename, options, callback) {
       var done = callback;
       var name = filename;
       var opts = options || null;
@@ -29177,7 +29177,7 @@ var require_response = __commonJS({
         opts = filename;
       }
       var headers = {
-        "Content-Disposition": contentDisposition(name || path13)
+        "Content-Disposition": contentDisposition(name || path16)
       };
       if (opts && opts.headers) {
         var keys = Object.keys(opts.headers);
@@ -29190,7 +29190,7 @@ var require_response = __commonJS({
       }
       opts = Object.create(opts);
       opts.headers = headers;
-      var fullPath = !opts.root ? resolve(path13) : path13;
+      var fullPath = !opts.root ? resolve(path16) : path16;
       return this.sendFile(fullPath, opts, done);
     };
     res.contentType = res.type = function contentType(type) {
@@ -29491,11 +29491,11 @@ var require_serve_static = __commonJS({
         }
         var forwardError = !fallthrough;
         var originalUrl = parseUrl.original(req);
-        var path12 = parseUrl(req).pathname;
-        if (path12 === "/" && originalUrl.pathname.substr(-1) !== "/") {
-          path12 = "";
+        var path15 = parseUrl(req).pathname;
+        if (path15 === "/" && originalUrl.pathname.substr(-1) !== "/") {
+          path15 = "";
         }
-        var stream = send2(req, path12, opts);
+        var stream = send2(req, path15, opts);
         stream.on("directory", onDirectory);
         if (setHeaders) {
           stream.on("headers", setHeaders);
@@ -31834,7 +31834,7 @@ var require_websocket = __commonJS({
     var http2 = require("http");
     var net = require("net");
     var tls = require("tls");
-    var { randomBytes: randomBytes2, createHash: createHash3 } = require("crypto");
+    var { randomBytes: randomBytes3, createHash: createHash3 } = require("crypto");
     var { Duplex, Readable } = require("stream");
     var { URL: URL2 } = require("url");
     var PerMessageDeflate2 = require_permessage_deflate();
@@ -32364,7 +32364,7 @@ var require_websocket = __commonJS({
         }
       }
       const defaultPort = isSecure ? 443 : 80;
-      const key = randomBytes2(16).toString("base64");
+      const key = randomBytes3(16).toString("base64");
       const request = isSecure ? https.request : http2.request;
       const protocolSet = /* @__PURE__ */ new Set();
       let perMessageDeflate;
@@ -33250,6 +33250,7 @@ var require_websocket_server = __commonJS({
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  inspectTelemetryBuildConfig: () => inspectTelemetryBuildConfig,
   listVisibleCLICommandNames: () => listVisibleCLICommandNames,
   resolveBundledSkillsRoot: () => resolveBundledSkillsRoot,
   resolveBundledViewsPath: () => resolveBundledViewsPath,
@@ -33260,10 +33261,11 @@ __export(index_exports, {
 });
 module.exports = __toCommonJS(index_exports);
 var import_node_child_process3 = require("node:child_process");
-var import_node_fs10 = require("node:fs");
-var import_node_path12 = __toESM(require("node:path"), 1);
+var import_node_fs12 = require("node:fs");
+var import_node_os5 = __toESM(require("node:os"), 1);
+var import_node_path15 = __toESM(require("node:path"), 1);
 var import_node_module = require("node:module");
-var import_node_url2 = require("node:url");
+var import_node_url3 = require("node:url");
 
 // ../../node_modules/commander/esm.mjs
 var import_index = __toESM(require_commander(), 1);
@@ -33414,22 +33416,22 @@ var Daemon = class {
   }
   async install() {
     if (this.platform === "darwin") {
-      const path12 = plistPath(this.home, this.name);
-      if ((0, import_node_fs.existsSync)(path12)) {
-        await this.exec("launchctl", ["unload", "-w", path12]).catch(() => void 0);
+      const path15 = plistPath(this.home, this.name);
+      if ((0, import_node_fs.existsSync)(path15)) {
+        await this.exec("launchctl", ["unload", "-w", path15]).catch(() => void 0);
       }
       await (0, import_promises.mkdir)((0, import_node_path.join)(this.home, "Library", "LaunchAgents"), { recursive: true });
-      await (0, import_promises.writeFile)(path12, renderPlist(this.name, this.programArgs, this.env), "utf8");
-      await this.exec("launchctl", ["load", "-w", path12]);
+      await (0, import_promises.writeFile)(path15, renderPlist(this.name, this.programArgs, this.env), "utf8");
+      await this.exec("launchctl", ["load", "-w", path15]);
       return;
     }
     if (this.platform === "linux") {
-      const path12 = unitPath(this.home, this.name);
-      if ((0, import_node_fs.existsSync)(path12)) {
+      const path15 = unitPath(this.home, this.name);
+      if ((0, import_node_fs.existsSync)(path15)) {
         await this.exec("systemctl", ["--user", "disable", "--now", `${this.name}.service`]).catch(() => void 0);
       }
       await (0, import_promises.mkdir)((0, import_node_path.join)(this.home, ".config", "systemd", "user"), { recursive: true });
-      await (0, import_promises.writeFile)(path12, renderUnit(this.description, this.programArgs, this.env), "utf8");
+      await (0, import_promises.writeFile)(path15, renderUnit(this.description, this.programArgs, this.env), "utf8");
       await this.exec("systemctl", ["--user", "daemon-reload"]);
       await this.exec("systemctl", ["--user", "enable", "--now", `${this.name}.service`]);
       return;
@@ -33438,17 +33440,17 @@ var Daemon = class {
   }
   async uninstall() {
     if (this.platform === "darwin") {
-      const path12 = plistPath(this.home, this.name);
-      if ((0, import_node_fs.existsSync)(path12)) {
-        await this.exec("launchctl", ["unload", "-w", path12]).catch(() => void 0);
-        await (0, import_promises.rm)(path12, { force: true });
+      const path15 = plistPath(this.home, this.name);
+      if ((0, import_node_fs.existsSync)(path15)) {
+        await this.exec("launchctl", ["unload", "-w", path15]).catch(() => void 0);
+        await (0, import_promises.rm)(path15, { force: true });
       }
       return;
     }
     if (this.platform === "linux") {
-      const path12 = unitPath(this.home, this.name);
+      const path15 = unitPath(this.home, this.name);
       await this.exec("systemctl", ["--user", "disable", "--now", `${this.name}.service`]).catch(() => void 0);
-      await (0, import_promises.rm)(path12, { force: true });
+      await (0, import_promises.rm)(path15, { force: true });
       await this.exec("systemctl", ["--user", "daemon-reload"]);
       return;
     }
@@ -33456,8 +33458,8 @@ var Daemon = class {
   }
   async status() {
     if (this.platform === "darwin") {
-      const path12 = plistPath(this.home, this.name);
-      if (!(0, import_node_fs.existsSync)(path12))
+      const path15 = plistPath(this.home, this.name);
+      if (!(0, import_node_fs.existsSync)(path15))
         return { installed: false, running: false };
       try {
         await this.exec("launchctl", ["list", this.name]);
@@ -33467,8 +33469,8 @@ var Daemon = class {
       }
     }
     if (this.platform === "linux") {
-      const path12 = unitPath(this.home, this.name);
-      if (!(0, import_node_fs.existsSync)(path12))
+      const path15 = unitPath(this.home, this.name);
+      if (!(0, import_node_fs.existsSync)(path15))
         return { installed: false, running: false };
       try {
         const result = await this.exec("systemctl", [
@@ -33742,6 +33744,8 @@ function cloneStackChild(node) {
 }
 
 // ../shared/src/types.ts
+var TELEVISION_CLIENT_META_HEADER = "X-Television-Client-Meta";
+var TELEMETRY_ACTIVITY_MESSAGE_TYPE = "telemetry-activity";
 function createCardNode(artifactID, overrides = {}) {
   return {
     type: "card",
@@ -33876,10 +33880,12 @@ var HttpRequester = class {
   serverURL;
   token;
   onUnauthorized;
+  telemetryMeta;
   constructor(serverURL, options) {
     this.serverURL = serverURL.replace(/\/$/, "");
     this.token = options.token;
     this.onUnauthorized = options.onUnauthorized;
+    this.telemetryMeta = options.telemetryMeta;
   }
   async requestJSON(method, pathname, body) {
     const response = await this.request(
@@ -33958,6 +33964,9 @@ var HttpRequester = class {
     if (this.token) {
       headers.Authorization = `Bearer ${this.token}`;
     }
+    if (this.telemetryMeta) {
+      headers[TELEVISION_CLIENT_META_HEADER] = JSON.stringify(this.telemetryMeta);
+    }
     return Object.keys(headers).length > 0 ? headers : void 0;
   }
 };
@@ -34113,6 +34122,21 @@ var MarkdownClient = class {
     );
   }
 };
+var TelemetryControlClient = class {
+  #http;
+  constructor(http2) {
+    this.#http = http2;
+  }
+  status() {
+    return this.#http.requestJSON("GET", "/telemetry");
+  }
+  enable() {
+    return this.#http.requestJSON("POST", "/telemetry/enable");
+  }
+  disable() {
+    return this.#http.requestJSON("POST", "/telemetry/disable");
+  }
+};
 var DisplayClient = class {
   #http;
   constructor(http2) {
@@ -34136,6 +34160,7 @@ var TelevisionClient = class {
   artifacts;
   display;
   markdown;
+  telemetry;
   #http;
   constructor(serverURL, options = {}) {
     this.#http = new HttpRequester(serverURL, options);
@@ -34143,6 +34168,7 @@ var TelevisionClient = class {
     this.artifacts = new ArtifactClient(this.#http);
     this.display = new DisplayClient(this.#http);
     this.markdown = new MarkdownClient(this.#http);
+    this.telemetry = new TelemetryControlClient(this.#http);
   }
   health() {
     return this.#http.requestJSON("GET", "/health");
@@ -34161,7 +34187,10 @@ function buildConnectURL(serverURL, token) {
 
 // ../server/src/server.ts
 var import_express2 = __toESM(require_express2(), 1);
+var import_node_fs9 = require("node:fs");
 var import_node_http = __toESM(require("node:http"), 1);
+var import_node_path11 = __toESM(require("node:path"), 1);
+var import_node_url = require("node:url");
 
 // ../server/src/config.ts
 var import_node_fs2 = require("node:fs");
@@ -34172,6 +34201,13 @@ var APP_HIDDEN_DIRECTORY = ".television";
 var TELEVISION_STORAGE_PATH_ENV = "TELEVISION_STORAGE_PATH";
 var TELEVISION_PORT_ENV = "TELEVISION_PORT";
 var TELEVISION_ACP_AGENT_ENV = "TELEVISION_ACP_AGENT";
+var TELEVISION_DEVELOPER_HOME_ENV = "TELEVISION_DEVELOPER_HOME";
+var TELEMETRY_CONTROL_ENV_VARS = [
+  "DO_NOT_TRACK",
+  "CI",
+  "TV_TELEMETRY_DEV",
+  "TELEVISION_TELEMETRY_BUILD"
+];
 var ACP_AGENT_PROFILES = {
   openclaw: {
     agent: "openclaw",
@@ -34194,8 +34230,11 @@ var DEFAULT_SERVER_URL = buildServerURL(DEFAULT_SERVER_HOST, DEFAULT_SERVER_PORT
 function buildServerURL(host, port) {
   return `http://${host}:${port}`;
 }
+function getDefaultTelevisionStoragePath() {
+  return import_node_path2.default.join(import_node_os2.default.homedir(), APP_HIDDEN_DIRECTORY);
+}
 function getTelevisionStoragePath() {
-  return process.env[TELEVISION_STORAGE_PATH_ENV] ?? import_node_path2.default.join(import_node_os2.default.homedir(), APP_HIDDEN_DIRECTORY);
+  return process.env[TELEVISION_STORAGE_PATH_ENV] ?? getDefaultTelevisionStoragePath();
 }
 function getTelevisionPortEnv() {
   const rawPort = process.env[TELEVISION_PORT_ENV];
@@ -34218,19 +34257,20 @@ function resolveACPAgentProfile(env = process.env) {
     `Unsupported TELEVISION_ACP_AGENT "${rawAgent}". Supported values: openclaw, hermes.`
   );
 }
-function buildPersistedACPEnvironment(env) {
+function buildPersistedACPEnvironment(env, options = {}) {
   const pathValue = env.PATH;
   if (pathValue === void 0) {
     throw new Error("PATH is required to build the persisted ACP environment.");
   }
+  const snapshot = { PATH: pathValue };
+  const developerHome = options.developerHome ?? import_node_os2.default.homedir();
+  if (developerHome !== "") snapshot[TELEVISION_DEVELOPER_HOME_ENV] = developerHome;
+  copyTelemetryControlEnvironment(env, snapshot);
   const profile = resolveACPAgentProfile(env);
   if (!profile) {
-    return { PATH: pathValue };
+    return snapshot;
   }
-  const snapshot = {
-    PATH: pathValue,
-    [TELEVISION_ACP_AGENT_ENV]: profile.agent
-  };
+  snapshot[TELEVISION_ACP_AGENT_ENV] = profile.agent;
   for (const [key, value] of Object.entries(env)) {
     if (key.startsWith(profile.envPrefix) && value !== void 0) {
       snapshot[key] = value;
@@ -34238,6 +34278,12 @@ function buildPersistedACPEnvironment(env) {
   }
   return snapshot;
 }
+function copyTelemetryControlEnvironment(env, snapshot) {
+  for (const key of TELEMETRY_CONTROL_ENV_VARS) {
+    const value = env[key];
+    if (value !== void 0 && value !== "") snapshot[key] = value;
+  }
+}
 function canExecuteFile(filePath) {
   try {
     return (0, import_node_fs2.statSync)(filePath).isFile() && (0, import_node_fs2.accessSync)(filePath, import_node_fs2.constants.X_OK) === void 0;
@@ -35026,10 +35072,10 @@ function mergeDefs(...defs) {
 function cloneDef(schema) {
   return mergeDefs(schema._zod.def);
 }
-function getElementAtPath(obj, path12) {
-  if (!path12)
+function getElementAtPath(obj, path15) {
+  if (!path15)
     return obj;
-  return path12.reduce((acc, key) => acc?.[key], obj);
+  return path15.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject(promisesObj) {
   const keys = Object.keys(promisesObj);
@@ -35412,11 +35458,11 @@ function aborted(x2, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues(path12, issues) {
+function prefixIssues(path15, issues) {
   return issues.map((iss) => {
     var _a2;
     (_a2 = iss).path ?? (_a2.path = []);
-    iss.path.unshift(path12);
+    iss.path.unshift(path15);
     return iss;
   });
 }
@@ -35599,7 +35645,7 @@ function formatError(error48, mapper = (issue2) => issue2.message) {
 }
 function treeifyError(error48, mapper = (issue2) => issue2.message) {
   const result = { errors: [] };
-  const processError = (error49, path12 = []) => {
+  const processError = (error49, path15 = []) => {
     var _a2, _b;
     for (const issue2 of error49.issues) {
       if (issue2.code === "invalid_union" && issue2.errors.length) {
@@ -35609,7 +35655,7 @@ function treeifyError(error48, mapper = (issue2) => issue2.message) {
       } else if (issue2.code === "invalid_element") {
         processError({ issues: issue2.issues }, issue2.path);
       } else {
-        const fullpath = [...path12, ...issue2.path];
+        const fullpath = [...path15, ...issue2.path];
         if (fullpath.length === 0) {
           result.errors.push(mapper(issue2));
           continue;
@@ -35641,8 +35687,8 @@ function treeifyError(error48, mapper = (issue2) => issue2.message) {
 }
 function toDotPath(_path) {
   const segs = [];
-  const path12 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
-  for (const seg of path12) {
+  const path15 = _path.map((seg) => typeof seg === "object" ? seg.key : seg);
+  for (const seg of path15) {
     if (typeof seg === "number")
       segs.push(`[${seg}]`);
     else if (typeof seg === "symbol")
@@ -47619,13 +47665,13 @@ function resolveRef(ref, ctx) {
   if (!ref.startsWith("#")) {
     throw new Error("External $ref is not supported, only local refs (#/...) are allowed");
   }
-  const path12 = ref.slice(1).split("/").filter(Boolean);
-  if (path12.length === 0) {
+  const path15 = ref.slice(1).split("/").filter(Boolean);
+  if (path15.length === 0) {
     return ctx.rootSchema;
   }
   const defsKey = ctx.version === "draft-2020-12" ? "$defs" : "definitions";
-  if (path12[0] === defsKey) {
-    const key = path12[1];
+  if (path15[0] === defsKey) {
+    const key = path15[1];
     if (!key || !ctx.defs[key]) {
       throw new Error(`Reference not found: ${ref}`);
     }
@@ -48027,6 +48073,417 @@ function date4(params) {
 // ../../node_modules/zod/v4/classic/external.js
 config(en_default());
 
+// ../server/src/telemetry/derivation.ts
+var import_node_net = require("node:net");
+
+// ../../node_modules/ulid/dist/node/index.js
+var import_node_crypto = __toESM(require("node:crypto"), 1);
+var ENCODING = "0123456789ABCDEFGHJKMNPQRSTVWXYZ";
+var ENCODING_LEN = 32;
+var RANDOM_LEN = 16;
+var TIME_LEN = 10;
+var TIME_MAX = 281474976710655;
+var ULIDErrorCode;
+(function(ULIDErrorCode2) {
+  ULIDErrorCode2["Base32IncorrectEncoding"] = "B32_ENC_INVALID";
+  ULIDErrorCode2["DecodeTimeInvalidCharacter"] = "DEC_TIME_CHAR";
+  ULIDErrorCode2["DecodeTimeValueMalformed"] = "DEC_TIME_MALFORMED";
+  ULIDErrorCode2["EncodeTimeNegative"] = "ENC_TIME_NEG";
+  ULIDErrorCode2["EncodeTimeSizeExceeded"] = "ENC_TIME_SIZE_EXCEED";
+  ULIDErrorCode2["EncodeTimeValueMalformed"] = "ENC_TIME_MALFORMED";
+  ULIDErrorCode2["PRNGDetectFailure"] = "PRNG_DETECT";
+  ULIDErrorCode2["ULIDInvalid"] = "ULID_INVALID";
+  ULIDErrorCode2["Unexpected"] = "UNEXPECTED";
+  ULIDErrorCode2["UUIDInvalid"] = "UUID_INVALID";
+})(ULIDErrorCode || (ULIDErrorCode = {}));
+var ULIDError = class extends Error {
+  constructor(errorCode, message) {
+    super(`${message} (${errorCode})`);
+    this.name = "ULIDError";
+    this.code = errorCode;
+  }
+};
+function randomChar(prng) {
+  const randomPosition = Math.floor(prng() * ENCODING_LEN) % ENCODING_LEN;
+  return ENCODING.charAt(randomPosition);
+}
+function detectPRNG(root) {
+  const rootLookup = detectRoot();
+  const globalCrypto = rootLookup && (rootLookup.crypto || rootLookup.msCrypto) || (typeof import_node_crypto.default !== "undefined" ? import_node_crypto.default : null);
+  if (typeof globalCrypto?.getRandomValues === "function") {
+    return () => {
+      const buffer = new Uint8Array(1);
+      globalCrypto.getRandomValues(buffer);
+      return buffer[0] / 256;
+    };
+  } else if (typeof globalCrypto?.randomBytes === "function") {
+    return () => globalCrypto.randomBytes(1).readUInt8() / 256;
+  } else if (import_node_crypto.default?.randomBytes) {
+    return () => import_node_crypto.default.randomBytes(1).readUInt8() / 256;
+  }
+  throw new ULIDError(ULIDErrorCode.PRNGDetectFailure, "Failed to find a reliable PRNG");
+}
+function detectRoot() {
+  if (inWebWorker())
+    return self;
+  if (typeof window !== "undefined") {
+    return window;
+  }
+  if (typeof global !== "undefined") {
+    return global;
+  }
+  if (typeof globalThis !== "undefined") {
+    return globalThis;
+  }
+  return null;
+}
+function encodeRandom(len, prng) {
+  let str = "";
+  for (; len > 0; len--) {
+    str = randomChar(prng) + str;
+  }
+  return str;
+}
+function encodeTime(now, len = TIME_LEN) {
+  if (isNaN(now)) {
+    throw new ULIDError(ULIDErrorCode.EncodeTimeValueMalformed, `Time must be a number: ${now}`);
+  } else if (now > TIME_MAX) {
+    throw new ULIDError(ULIDErrorCode.EncodeTimeSizeExceeded, `Cannot encode a time larger than ${TIME_MAX}: ${now}`);
+  } else if (now < 0) {
+    throw new ULIDError(ULIDErrorCode.EncodeTimeNegative, `Time must be positive: ${now}`);
+  } else if (Number.isInteger(now) === false) {
+    throw new ULIDError(ULIDErrorCode.EncodeTimeValueMalformed, `Time must be an integer: ${now}`);
+  }
+  let mod, str = "";
+  for (let currentLen = len; currentLen > 0; currentLen--) {
+    mod = now % ENCODING_LEN;
+    str = ENCODING.charAt(mod) + str;
+    now = (now - mod) / ENCODING_LEN;
+  }
+  return str;
+}
+function inWebWorker() {
+  return typeof WorkerGlobalScope !== "undefined" && self instanceof WorkerGlobalScope;
+}
+function ulid3(seedTime, prng) {
+  const currentPRNG = prng || detectPRNG();
+  const seed = !seedTime || isNaN(seedTime) ? Date.now() : seedTime;
+  return encodeTime(seed, TIME_LEN) + encodeRandom(RANDOM_LEN, currentPRNG);
+}
+
+// ../artifact/src/model.ts
+var ARTIFACT_PATH_EXTENSIONS = [".md", ".markdown", ".htm", ".html"];
+var MARKDOWN_PATH_EXTENSIONS = [".md", ".markdown"];
+var HTML_PATH_EXTENSIONS = [".htm", ".html"];
+function hasTrailingSeparator(value) {
+  if (value.length === 0) return false;
+  const last = value.at(-1);
+  return last === "/" || last === "\\";
+}
+function stripTrailingSeparators(value) {
+  let end = value.length;
+  while (end > 1 && (value[end - 1] === "/" || value[end - 1] === "\\")) {
+    end -= 1;
+  }
+  if (end === 2 && end < value.length && /^[A-Za-z]:$/.test(value.slice(0, 2))) {
+    end += 1;
+  }
+  return value.slice(0, end);
+}
+function artifactBasename(value) {
+  const slash = value.lastIndexOf("/");
+  const backslash = value.lastIndexOf("\\");
+  return value.slice(Math.max(slash, backslash) + 1);
+}
+function lowerArtifactBasename(value) {
+  return artifactBasename(value).toLowerCase();
+}
+function basenameHasExtension(value, extensions) {
+  const basename = lowerArtifactBasename(value);
+  return extensions.some((extension2) => basename.endsWith(extension2));
+}
+function isMarkdownPath(value) {
+  return !hasTrailingSeparator(value) && basenameHasExtension(value, MARKDOWN_PATH_EXTENSIONS);
+}
+function isHtmlPath(value) {
+  return !hasTrailingSeparator(value) && basenameHasExtension(value, HTML_PATH_EXTENSIONS);
+}
+function isAllowedArtifactFilePath(value) {
+  return !hasTrailingSeparator(value) && basenameHasExtension(value, ARTIFACT_PATH_EXTENSIONS);
+}
+function isExternalArtifactURL(value) {
+  let parsed;
+  try {
+    parsed = new URL(value);
+  } catch {
+    return false;
+  }
+  return parsed.protocol === "http:" || parsed.protocol === "https:";
+}
+function isTvArtifact(url2) {
+  try {
+    const { pathname } = new URL(url2);
+    return /^\/artifact\/[0-9A-Za-z]{26}(\/|$)/.test(pathname);
+  } catch {
+    return false;
+  }
+}
+var PathArtifactSchema = external_exports.object({
+  id: external_exports.string().min(1),
+  kind: external_exports.literal("path"),
+  title: external_exports.string(),
+  path: external_exports.string()
+}).strict();
+var UrlArtifactSchema = external_exports.object({
+  id: external_exports.string().min(1),
+  kind: external_exports.literal("url"),
+  title: external_exports.string(),
+  url: external_exports.string().refine(isExternalArtifactURL, { message: "url must be an http(s) URL" })
+}).strict();
+var ArtifactSchema = external_exports.discriminatedUnion("kind", [PathArtifactSchema, UrlArtifactSchema]);
+function createArtifact(input) {
+  return ArtifactSchema.parse({ id: input.id ?? ulid3(), ...input });
+}
+
+// ../server/src/telemetry/types.ts
+var telemetryVersionBrand = Symbol("telemetryVersion");
+function telemetryVersion(value) {
+  return value;
+}
+var AGENT_TYPES = [
+  "pi",
+  "opencode",
+  "claude",
+  "codex",
+  "hermes",
+  "openclaw",
+  "cursor",
+  "dot-agents",
+  "interactive-install",
+  "other"
+];
+
+// ../server/src/telemetry/derivation.ts
+function deriveArtifactProperties(artifact) {
+  if (artifact.kind === "path") {
+    if (hasTrailingSeparator(artifact.path)) {
+      return { artifact_kind: "path", path_kind: "folder" };
+    }
+    return {
+      artifact_kind: "path",
+      path_kind: "file",
+      path_file_type: isHtmlPath(artifact.path) ? "html" : isMarkdownPath(artifact.path) ? "markdown" : "other"
+    };
+  }
+  return {
+    artifact_kind: "url",
+    url_host: classifyUrlHost(artifact.url),
+    url_is_artifact_proxy: isTvArtifact(artifact.url)
+  };
+}
+function deriveThemeProperties(input) {
+  return {
+    theme_state: input.activeThemeName === null ? "default" : "custom",
+    theme_count: input.themeCount
+  };
+}
+var KNOWN_AGENT_TYPES = AGENT_TYPES.filter((agentType) => agentType !== "dot-agents" && agentType !== "interactive-install" && agentType !== "other");
+var IPV4_VERSION = 4;
+var TAILNET_FIRST_OCTET = 100;
+var TAILNET_MIN_SECOND_OCTET = 64;
+var TAILNET_MAX_SECOND_OCTET = 127;
+function deriveAgentTypeFromPath(targetPath) {
+  const tokens = pathTokens(targetPath);
+  const known = KNOWN_AGENT_TYPES.find((agentType) => tokens.includes(agentType));
+  if (known) return { agent_type: known };
+  if (targetPath.split(/[\\/]+/).some((part) => part.toLowerCase() === ".agents")) return { agent_type: "dot-agents" };
+  return { agent_type: "other" };
+}
+function normalizeInstalledByAgent(value) {
+  const normalized = value?.trim().toLowerCase() ?? "";
+  return normalized.length === 0 ? {} : { installed_by_agent: normalized };
+}
+function deriveServerConfigProperties(input) {
+  return {
+    port: input.port === DEFAULT_SERVER_PORT ? "default" : "custom",
+    storage_path: input.storagePath === (input.defaultStoragePath ?? getDefaultTelevisionStoragePath()) ? "default" : "custom",
+    auth_mode: input.authMode === "auth" ? "auth" : "no-auth",
+    launch_mode: input.launchMode
+  };
+}
+function deriveUserAgentProperties(userAgent) {
+  const ua = userAgent ?? "";
+  const browser = parseBrowser(ua);
+  return {
+    client_platform: parsePlatform(ua),
+    browser_vendor: browser.vendor,
+    ...browser.major === void 0 ? {} : { browser_major_version: browser.major }
+  };
+}
+function deriveClientProperties(input) {
+  return {
+    client_app: input.clientApp,
+    ...deriveUserAgentProperties(input.userAgent),
+    ...input.desktopAppVersion === void 0 ? {} : { desktop_app_version: input.desktopAppVersion }
+  };
+}
+function deriveBindingProperties(addresses) {
+  return {
+    binds_loopback: addresses.some(isLoopbackAddress),
+    binds_all_interfaces: addresses.includes("0.0.0.0"),
+    binds_tailnet: addresses.some(isTailnetIPv4),
+    binds_other_specific: addresses.some((address) => !isLoopbackAddress(address) && address !== "0.0.0.0" && !isTailnetIPv4(address))
+  };
+}
+function deriveLayoutChangeProperties(previousLayout, nextLayout) {
+  if (!sameArtifactSet(previousLayout, nextLayout)) return null;
+  const structureChanged = structureSignature(previousLayout) !== structureSignature(nextLayout);
+  if (structureChanged) return { change_type: "move" };
+  const geometryChanged = geometrySignature(previousLayout) !== geometrySignature(nextLayout);
+  if (geometryChanged) return { change_type: "resize" };
+  return null;
+}
+function classifyUrlHost(url2) {
+  let parsed;
+  try {
+    parsed = new URL(url2);
+  } catch {
+    return "third-party";
+  }
+  const hostname3 = parsed.hostname.toLowerCase();
+  if (hostname3 === "localhost" || hostname3 === "::1" || hostname3 === "[::1]" || hostname3.startsWith("127.")) {
+    return "localhost";
+  }
+  if (isTailnetIPv4(hostname3)) return "tailnet";
+  return "third-party";
+}
+function pathTokens(targetPath) {
+  return targetPath.toLowerCase().split(/[^a-z0-9]+/).filter((token) => token.length > 0);
+}
+function parsePlatform(userAgent) {
+  const ua = userAgent.toLowerCase();
+  if (/iphone|ipad|ipod/.test(ua)) return "ios";
+  if (ua.includes("android")) return "android";
+  if (ua.includes("windows nt")) return "windows";
+  if (ua.includes("macintosh") || ua.includes("mac os x")) return "macos";
+  if (ua.includes("linux") || ua.includes("x11")) return "linux";
+  return "other";
+}
+function parseBrowser(userAgent) {
+  const edge = parseMajor(userAgent, /\bEdg\/(\d+)/);
+  if (edge !== void 0) return { vendor: "edge", major: edge };
+  const firefox = parseMajor(userAgent, /\bFirefox\/(\d+)/);
+  if (firefox !== void 0) return { vendor: "firefox", major: firefox };
+  const chrome2 = parseMajor(userAgent, /\b(?:HeadlessChrome|Chrome|CriOS)\/(\d+)/);
+  if (chrome2 !== void 0) return { vendor: "chrome", major: chrome2 };
+  const safari = parseMajor(userAgent, /\bVersion\/(\d+)(?:\.\d+)?[^)]*\bSafari\//);
+  if (safari !== void 0) return { vendor: "safari", major: safari };
+  return { vendor: "other" };
+}
+function parseMajor(userAgent, pattern) {
+  const match = pattern.exec(userAgent);
+  if (!match) return void 0;
+  const value = Number.parseInt(match[1], 10);
+  return Number.isInteger(value) ? value : void 0;
+}
+function sameArtifactSet(previousLayout, nextLayout) {
+  const previous = collectArtifactIDs2(previousLayout).sort();
+  const next = collectArtifactIDs2(nextLayout).sort();
+  return previous.length === next.length && previous.every((artifactID, index) => artifactID === next[index]);
+}
+function collectArtifactIDs2(nodes) {
+  return nodes.flatMap((node) => {
+    switch (node.type) {
+      case "card":
+        return [node.artifactID];
+      case "row":
+        return node.children.map((child) => child.artifactID);
+      case "stack":
+        return collectArtifactIDs2(node.children);
+    }
+  });
+}
+function structureSignature(nodes) {
+  return JSON.stringify(nodes.map(structureNode));
+}
+function structureNode(node) {
+  switch (node.type) {
+    case "card":
+      return { type: "card", artifactID: node.artifactID };
+    case "row":
+      return { type: "row", children: node.children.map(structureNode) };
+    case "stack":
+      return { type: "stack", children: node.children.map(structureNode) };
+  }
+}
+function geometrySignature(nodes) {
+  return JSON.stringify(nodes.map(geometryNode));
+}
+function geometryNode(node) {
+  switch (node.type) {
+    case "card":
+      return { type: "card", artifactID: node.artifactID, width: node.width, height: node.height };
+    case "row":
+      return { type: "row", height: node.height, children: node.children.map(geometryNode) };
+    case "stack":
+      return { type: "stack", children: node.children.map(geometryNode) };
+  }
+}
+function isLoopbackAddress(address) {
+  const normalized = address.toLowerCase();
+  return normalized === "localhost" || normalized === "::1" || normalized === "[::1]" || normalized.startsWith("127.");
+}
+function isTailnetIPv4(hostname3) {
+  if ((0, import_node_net.isIP)(hostname3) !== IPV4_VERSION) return false;
+  const [a, b2] = hostname3.split(".").map((part) => Number.parseInt(part, 10));
+  return a === TAILNET_FIRST_OCTET && b2 !== void 0 && b2 >= TAILNET_MIN_SECOND_OCTET && b2 <= TAILNET_MAX_SECOND_OCTET;
+}
+
+// ../server/src/telemetry/client-meta.ts
+function parseClientTelemetryMetaHeader(value) {
+  if (!value) return null;
+  try {
+    return telemetryContextFromMeta(JSON.parse(value));
+  } catch {
+    return null;
+  }
+}
+function parseClientTelemetryMetaFromRequest(request) {
+  const parsed = new URL(request.url ?? "/", "http://127.0.0.1");
+  return telemetryContextFromMeta({
+    clientId: parsed.searchParams.get("clientId"),
+    userAgent: parsed.searchParams.get("userAgent"),
+    clientApp: parsed.searchParams.get("clientApp"),
+    desktopAppVersion: parsed.searchParams.get("desktopAppVersion") ?? void 0
+  });
+}
+function deriveSessionActivityClientProperties(context) {
+  return deriveClientProperties({
+    clientApp: context.meta.clientApp,
+    userAgent: context.meta.userAgent,
+    ...context.meta.desktopAppVersion ? { desktopAppVersion: telemetryVersion(context.meta.desktopAppVersion) } : {}
+  });
+}
+function telemetryContextFromMeta(value) {
+  if (!value || typeof value !== "object") return null;
+  const record2 = value;
+  if (typeof record2.clientId !== "string") return null;
+  const clientId = record2.clientId.trim();
+  if (!clientId) return null;
+  if (record2.clientApp !== "browser" && record2.clientApp !== "desktop") return null;
+  const userAgent = typeof record2.userAgent === "string" ? record2.userAgent : "";
+  const desktopAppVersion = typeof record2.desktopAppVersion === "string" && record2.desktopAppVersion.length > 0 ? record2.desktopAppVersion : void 0;
+  return {
+    clientId,
+    meta: {
+      clientId,
+      userAgent,
+      clientApp: record2.clientApp,
+      ...desktopAppVersion === void 0 ? {} : { desktopAppVersion }
+    }
+  };
+}
+
 // ../server/src/artifact-proxy.ts
 var import_node_crypto2 = require("node:crypto");
 var import_promises2 = require("node:fs/promises");
@@ -49242,167 +49699,6 @@ var Kt = g.parseInline;
 var Xt = b.parse;
 var Jt = x.lex;
 
-// ../../node_modules/ulid/dist/node/index.js
-var import_node_crypto = __toESM(require("node:crypto"), 1);
-var ENCODING = "0123456789ABCDEFGHJKMNPQRSTVWXYZ";
-var ENCODING_LEN = 32;
-var RANDOM_LEN = 16;
-var TIME_LEN = 10;
-var TIME_MAX = 281474976710655;
-var ULIDErrorCode;
-(function(ULIDErrorCode2) {
-  ULIDErrorCode2["Base32IncorrectEncoding"] = "B32_ENC_INVALID";
-  ULIDErrorCode2["DecodeTimeInvalidCharacter"] = "DEC_TIME_CHAR";
-  ULIDErrorCode2["DecodeTimeValueMalformed"] = "DEC_TIME_MALFORMED";
-  ULIDErrorCode2["EncodeTimeNegative"] = "ENC_TIME_NEG";
-  ULIDErrorCode2["EncodeTimeSizeExceeded"] = "ENC_TIME_SIZE_EXCEED";
-  ULIDErrorCode2["EncodeTimeValueMalformed"] = "ENC_TIME_MALFORMED";
-  ULIDErrorCode2["PRNGDetectFailure"] = "PRNG_DETECT";
-  ULIDErrorCode2["ULIDInvalid"] = "ULID_INVALID";
-  ULIDErrorCode2["Unexpected"] = "UNEXPECTED";
-  ULIDErrorCode2["UUIDInvalid"] = "UUID_INVALID";
-})(ULIDErrorCode || (ULIDErrorCode = {}));
-var ULIDError = class extends Error {
-  constructor(errorCode, message) {
-    super(`${message} (${errorCode})`);
-    this.name = "ULIDError";
-    this.code = errorCode;
-  }
-};
-function randomChar(prng) {
-  const randomPosition = Math.floor(prng() * ENCODING_LEN) % ENCODING_LEN;
-  return ENCODING.charAt(randomPosition);
-}
-function detectPRNG(root) {
-  const rootLookup = detectRoot();
-  const globalCrypto = rootLookup && (rootLookup.crypto || rootLookup.msCrypto) || (typeof import_node_crypto.default !== "undefined" ? import_node_crypto.default : null);
-  if (typeof globalCrypto?.getRandomValues === "function") {
-    return () => {
-      const buffer = new Uint8Array(1);
-      globalCrypto.getRandomValues(buffer);
-      return buffer[0] / 256;
-    };
-  } else if (typeof globalCrypto?.randomBytes === "function") {
-    return () => globalCrypto.randomBytes(1).readUInt8() / 256;
-  } else if (import_node_crypto.default?.randomBytes) {
-    return () => import_node_crypto.default.randomBytes(1).readUInt8() / 256;
-  }
-  throw new ULIDError(ULIDErrorCode.PRNGDetectFailure, "Failed to find a reliable PRNG");
-}
-function detectRoot() {
-  if (inWebWorker())
-    return self;
-  if (typeof window !== "undefined") {
-    return window;
-  }
-  if (typeof global !== "undefined") {
-    return global;
-  }
-  if (typeof globalThis !== "undefined") {
-    return globalThis;
-  }
-  return null;
-}
-function encodeRandom(len, prng) {
-  let str = "";
-  for (; len > 0; len--) {
-    str = randomChar(prng) + str;
-  }
-  return str;
-}
-function encodeTime(now, len = TIME_LEN) {
-  if (isNaN(now)) {
-    throw new ULIDError(ULIDErrorCode.EncodeTimeValueMalformed, `Time must be a number: ${now}`);
-  } else if (now > TIME_MAX) {
-    throw new ULIDError(ULIDErrorCode.EncodeTimeSizeExceeded, `Cannot encode a time larger than ${TIME_MAX}: ${now}`);
-  } else if (now < 0) {
-    throw new ULIDError(ULIDErrorCode.EncodeTimeNegative, `Time must be positive: ${now}`);
-  } else if (Number.isInteger(now) === false) {
-    throw new ULIDError(ULIDErrorCode.EncodeTimeValueMalformed, `Time must be an integer: ${now}`);
-  }
-  let mod, str = "";
-  for (let currentLen = len; currentLen > 0; currentLen--) {
-    mod = now % ENCODING_LEN;
-    str = ENCODING.charAt(mod) + str;
-    now = (now - mod) / ENCODING_LEN;
-  }
-  return str;
-}
-function inWebWorker() {
-  return typeof WorkerGlobalScope !== "undefined" && self instanceof WorkerGlobalScope;
-}
-function ulid3(seedTime, prng) {
-  const currentPRNG = prng || detectPRNG();
-  const seed = !seedTime || isNaN(seedTime) ? Date.now() : seedTime;
-  return encodeTime(seed, TIME_LEN) + encodeRandom(RANDOM_LEN, currentPRNG);
-}
-
-// ../artifact/src/model.ts
-var ARTIFACT_PATH_EXTENSIONS = [".md", ".markdown", ".htm", ".html"];
-var MARKDOWN_PATH_EXTENSIONS = [".md", ".markdown"];
-var HTML_PATH_EXTENSIONS = [".htm", ".html"];
-function hasTrailingSeparator(value) {
-  if (value.length === 0) return false;
-  const last = value.at(-1);
-  return last === "/" || last === "\\";
-}
-function stripTrailingSeparators(value) {
-  let end = value.length;
-  while (end > 1 && (value[end - 1] === "/" || value[end - 1] === "\\")) {
-    end -= 1;
-  }
-  if (end === 2 && end < value.length && /^[A-Za-z]:$/.test(value.slice(0, 2))) {
-    end += 1;
-  }
-  return value.slice(0, end);
-}
-function artifactBasename(value) {
-  const slash = value.lastIndexOf("/");
-  const backslash = value.lastIndexOf("\\");
-  return value.slice(Math.max(slash, backslash) + 1);
-}
-function lowerArtifactBasename(value) {
-  return artifactBasename(value).toLowerCase();
-}
-function basenameHasExtension(value, extensions) {
-  const basename = lowerArtifactBasename(value);
-  return extensions.some((extension2) => basename.endsWith(extension2));
-}
-function isMarkdownPath(value) {
-  return !hasTrailingSeparator(value) && basenameHasExtension(value, MARKDOWN_PATH_EXTENSIONS);
-}
-function isHtmlPath(value) {
-  return !hasTrailingSeparator(value) && basenameHasExtension(value, HTML_PATH_EXTENSIONS);
-}
-function isAllowedArtifactFilePath(value) {
-  return !hasTrailingSeparator(value) && basenameHasExtension(value, ARTIFACT_PATH_EXTENSIONS);
-}
-function isExternalArtifactURL(value) {
-  let parsed;
-  try {
-    parsed = new URL(value);
-  } catch {
-    return false;
-  }
-  return parsed.protocol === "http:" || parsed.protocol === "https:";
-}
-var PathArtifactSchema = external_exports.object({
-  id: external_exports.string().min(1),
-  kind: external_exports.literal("path"),
-  title: external_exports.string(),
-  path: external_exports.string()
-}).strict();
-var UrlArtifactSchema = external_exports.object({
-  id: external_exports.string().min(1),
-  kind: external_exports.literal("url"),
-  title: external_exports.string(),
-  url: external_exports.string().refine(isExternalArtifactURL, { message: "url must be an http(s) URL" })
-}).strict();
-var ArtifactSchema = external_exports.discriminatedUnion("kind", [PathArtifactSchema, UrlArtifactSchema]);
-function createArtifact(input) {
-  return ArtifactSchema.parse({ id: input.id ?? ulid3(), ...input });
-}
-
 // ../disposable/src/index.ts
 function wrapDispose(target, isDisposed, setDisposed) {
   const disposeImpl = target.dispose.bind(target);
@@ -50367,6 +50663,19 @@ function themeExists(storagePath, name) {
     return false;
   }
 }
+function listThemeNames(storagePath) {
+  const themesDir = getThemesDir(storagePath);
+  if (!(0, import_node_fs5.existsSync)(themesDir)) {
+    return [];
+  }
+  let entries;
+  try {
+    entries = (0, import_node_fs5.readdirSync)(themesDir);
+  } catch {
+    return [];
+  }
+  return entries.filter((name) => themeExists(storagePath, name)).sort((left, right) => left.localeCompare(right));
+}
 function rewriteThemeURLs(css, themeName) {
   return css.replace(URL_RE, (whole, quote, url2) => {
     if (/^(data:|https?:)/.test(url2) || url2.startsWith("/")) {
@@ -50466,7 +50775,7 @@ var HTTP_CONFLICT = 409;
 var CORS_HEADERS = {
   "Access-Control-Allow-Origin": "*",
   "Access-Control-Allow-Methods": "GET, POST, PUT, PATCH, DELETE, OPTIONS",
-  "Access-Control-Allow-Headers": "Authorization, Content-Type"
+  "Access-Control-Allow-Headers": `Authorization, Content-Type, ${TELEVISION_CLIENT_META_HEADER}`
 };
 function applyCorsHeaders(res) {
   for (const [name, value] of Object.entries(CORS_HEADERS)) {
@@ -50498,11 +50807,20 @@ function handleStoreError(res, error48, fallback) {
 function registerRoutes(app, store, options) {
   const auth = options.requireAuth ? [options.requireAuth] : [];
   const bearerAuth = options.requireBearerAuth ? [options.requireBearerAuth] : [];
-  app.use("/screens", applyCorsMiddleware);
-  app.use("/artifacts", applyCorsMiddleware);
-  app.use("/display", applyCorsMiddleware);
-  app.use("/themes", applyCorsMiddleware);
-  app.use("/markdown", applyCorsMiddleware);
+  const telemetryContexts = /* @__PURE__ */ new WeakMap();
+  const telemetryMiddleware = (req, _res, next) => {
+    const clientContext = parseClientTelemetryMetaHeader(req.header(TELEVISION_CLIENT_META_HEADER));
+    telemetryContexts.set(req, clientContext);
+    options.observeTelemetryClientRequest?.(clientContext);
+    next();
+  };
+  const telemetryContext = (req) => telemetryContexts.get(req) ?? null;
+  app.use("/screens", applyCorsMiddleware, telemetryMiddleware);
+  app.use("/artifacts", applyCorsMiddleware, telemetryMiddleware);
+  app.use("/display", applyCorsMiddleware, telemetryMiddleware);
+  app.use("/themes", applyCorsMiddleware, telemetryMiddleware);
+  app.use("/markdown", applyCorsMiddleware, telemetryMiddleware);
+  app.use("/telemetry", applyCorsMiddleware);
   app.all("/artifact/:id", serveArtifactProxy(store));
   app.all("/artifact/:id/*", serveArtifactProxy(store));
   const markdownContent = serveMarkdownContent(store);
@@ -50517,6 +50835,18 @@ function registerRoutes(app, store, options) {
   app.options("/themes/:name/theme.css", (_req, res) => res.status(HTTP_NO_CONTENT2).end());
   app.options("/themes/:name/*", (_req, res) => res.status(HTTP_NO_CONTENT2).end());
   app.options("/markdown/:id", (_req, res) => res.status(HTTP_NO_CONTENT2).end());
+  app.options("/telemetry", (_req, res) => res.status(HTTP_NO_CONTENT2).end());
+  app.options("/telemetry/enable", (_req, res) => res.status(HTTP_NO_CONTENT2).end());
+  app.options("/telemetry/disable", (_req, res) => res.status(HTTP_NO_CONTENT2).end());
+  app.get("/telemetry", ...auth, (_req, res) => {
+    res.json(options.getTelemetryStatus?.() ?? { state: "unavailable", reason: null, guidPresent: false, region: "us" });
+  });
+  app.post("/telemetry/enable", ...auth, async (_req, res) => {
+    res.json(await options.enableTelemetry?.() ?? { state: "unavailable", reason: null, guidPresent: false, region: "us" });
+  });
+  app.post("/telemetry/disable", ...auth, async (_req, res) => {
+    res.json(await options.disableTelemetry?.() ?? { state: "unavailable", reason: null, guidPresent: false, region: "us" });
+  });
   app.get("/screens", ...auth, (_req, res) => {
     res.json({ screens: store.listScreens() });
   });
@@ -50530,7 +50860,7 @@ function registerRoutes(app, store, options) {
       const screen = store.createScreen({
         name: parsed.data.name,
         ...parsed.data.id !== void 0 ? { id: parsed.data.id } : {}
-      });
+      }, telemetryContext(req));
       res.status(HTTP_CREATED).json({ screen });
     } catch (error48) {
       sendError(res, HTTP_BAD_REQUEST, error48 instanceof Error ? error48.message : "Failed to create screen");
@@ -50546,7 +50876,7 @@ function registerRoutes(app, store, options) {
   });
   app.delete("/screens/:id", ...auth, (req, res) => {
     try {
-      const result = store.removeScreen(req.params.id);
+      const result = store.removeScreen(req.params.id, telemetryContext(req));
       res.json(result);
     } catch (error48) {
       handleStoreError(res, error48, "Failed to delete screen");
@@ -50569,7 +50899,7 @@ function registerRoutes(app, store, options) {
       const screen = store.updateScreen({
         screenID: req.params.id,
         fields: { ...parsed.data, layout: parsed.data.layout }
-      });
+      }, telemetryContext(req));
       res.json({ screen });
     } catch (error48) {
       handleStoreError(res, error48, "Failed to update screen");
@@ -50596,7 +50926,7 @@ function registerRoutes(app, store, options) {
       return;
     }
     try {
-      const artifact = store.createArtifact(parsed.data);
+      const artifact = store.createArtifact(parsed.data, telemetryContext(req));
       res.status(HTTP_CREATED).json({ artifact, screenID: parsed.data.screenID });
     } catch (error48) {
       handleStoreError(res, error48, "Failed to create artifact");
@@ -50604,7 +50934,7 @@ function registerRoutes(app, store, options) {
   });
   app.delete("/artifacts/:id", ...auth, (req, res) => {
     try {
-      const result = store.deleteArtifact(req.params.id);
+      const result = store.deleteArtifact(req.params.id, telemetryContext(req));
       res.json(result);
     } catch (error48) {
       handleStoreError(res, error48, "Failed to delete artifact");
@@ -50617,7 +50947,7 @@ function registerRoutes(app, store, options) {
       return;
     }
     try {
-      const artifact = store.updateArtifact({ artifactID: req.params.id, fields: parsed.data });
+      const artifact = store.updateArtifact({ artifactID: req.params.id, fields: parsed.data }, telemetryContext(req));
       res.json({ artifact });
     } catch (error48) {
       handleStoreError(res, error48, "Failed to update artifact");
@@ -50641,7 +50971,7 @@ function registerRoutes(app, store, options) {
       return;
     }
     try {
-      store.patchDisplay(parsed.data);
+      store.patchDisplay(parsed.data, telemetryContext(req));
       res.status(HTTP_NO_CONTENT2).end();
     } catch (error48) {
       handleStoreError(res, error48, "Failed to patch display");
@@ -50700,18 +51030,23 @@ var EventStreamServer = class extends withDisposable(class {
   wsServer;
   store;
   authRequired;
+  recordTelemetryActivity;
   unsubscribe = [];
   constructor(options) {
     super();
     this.store = options.store;
     this.authRequired = options.authRequired;
+    this.recordTelemetryActivity = options.recordTelemetryActivity;
     this.wsServer = new import_websocket_server.default({ noServer: true });
     this.wsServer.on("connection", (socket, request) => {
       if (this.authRequired && !isAuthorizedQueryToken(request.url, this.store.authToken)) {
         socket.close(AUTH_FAILED_CLOSE_CODE, "Authentication failed");
         return;
       }
-      socket.on("message", (_data) => {
+      const clientContext = parseClientTelemetryMetaFromRequest(request);
+      socket.on("message", (data) => {
+        if (!isTelemetryActivityMessage(data, clientContext?.clientId ?? null)) return;
+        if (clientContext) this.recordTelemetryActivity?.(clientContext);
       });
     });
     this.subscribeStore();
@@ -50809,6 +51144,18 @@ var EventStreamServer = class extends withDisposable(class {
     }
   }
 };
+function isTelemetryActivityMessage(data, expectedClientId) {
+  if (!expectedClientId) return false;
+  let parsed;
+  try {
+    parsed = JSON.parse(data.toString());
+  } catch {
+    return false;
+  }
+  if (!parsed || typeof parsed !== "object") return false;
+  const record2 = parsed;
+  return record2.type === TELEMETRY_ACTIVITY_MESSAGE_TYPE && record2.clientId === expectedClientId && Object.keys(record2).length === 2;
+}
 
 // ../server/src/acp-bridge.ts
 var import_node_child_process2 = require("node:child_process");
@@ -51091,13 +51438,13 @@ var ACPServer = class extends withDisposable(class {
 };
 
 // ../server/src/bind-addresses.ts
-var import_node_net = require("node:net");
+var import_node_net2 = require("node:net");
 var LOCALHOST_IPV4 = "127.0.0.1";
 var ANY_IPV4 = "0.0.0.0";
 function resolveBindAddresses(listenValues = []) {
   const addresses = [LOCALHOST_IPV4];
   for (const address of splitListenValues(listenValues)) {
-    if (!(0, import_node_net.isIPv4)(address)) {
+    if (!(0, import_node_net2.isIPv4)(address)) {
       throw new Error(`Invalid --listen address \`${address}\`. Use an IPv4 address.`);
     }
     addresses.push(address);
@@ -51341,7 +51688,715 @@ function pad2(value) {
   return String(value).padStart(2, "0");
 }
 
+// ../server/src/telemetry/emitters.ts
+var MEDIAN_PAIR_DIVISOR = 2;
+function createServerStoreTelemetryHooks(store, capture2) {
+  return {
+    artifactCreated(artifact, clientContext) {
+      safeEmit(() => {
+        const totals = deriveContentTotalsProperties(store);
+        capture2({
+          name: "artifact_created",
+          properties: { ...deriveArtifactProperties(artifact), ...totals },
+          personProperties: totals
+        }, clientContext);
+      });
+    },
+    artifactUpdated(artifact, clientContext) {
+      safeEmit(() => capture2({ name: "artifact_updated", properties: deriveArtifactProperties(artifact) }, clientContext));
+    },
+    artifactDeleted(artifact, clientContext) {
+      safeEmit(() => {
+        const totals = deriveContentTotalsProperties(store);
+        capture2({
+          name: "artifact_deleted",
+          properties: { ...deriveArtifactProperties(artifact), ...totals },
+          personProperties: totals
+        }, clientContext);
+      });
+    },
+    screenCreated(_screen, clientContext) {
+      safeEmit(() => {
+        const totals = deriveContentTotalsProperties(store);
+        capture2({ name: "screen_created", properties: totals, personProperties: totals }, clientContext);
+      });
+    },
+    screenUpdated(_screen, clientContext) {
+      safeEmit(() => capture2({ name: "screen_updated" }, clientContext));
+    },
+    screenDeleted(_screen, clientContext) {
+      safeEmit(() => {
+        const totals = deriveContentTotalsProperties(store);
+        capture2({ name: "screen_deleted", properties: totals, personProperties: totals }, clientContext);
+      });
+    },
+    screenLayoutChanged(previousLayout, nextLayout, clientContext) {
+      safeEmit(() => {
+        const properties = deriveLayoutChangeProperties(previousLayout, nextLayout);
+        if (properties) capture2({ name: "layout_changed", properties }, clientContext);
+      });
+    },
+    themeChanged(clientContext) {
+      safeEmit(() => {
+        capture2({
+          name: "theme_changed",
+          properties: deriveThemeProperties({
+            activeThemeName: store.getActiveThemeName(),
+            themeCount: listThemeNames(store.storagePath).length
+          })
+        }, clientContext);
+      });
+    }
+  };
+}
+function deriveContentTotalsProperties(store) {
+  const screens = store.listScreens();
+  const totalScreens = screens.length;
+  const totalArtifacts = store.listArtifacts().length;
+  const artifactCounts = screens.map((screen) => getScreenArtifactIDs(screen).length);
+  return {
+    total_screens: totalScreens,
+    total_artifacts: totalArtifacts,
+    median_artifacts_per_screen: median(artifactCounts),
+    average_artifacts_per_screen: totalScreens === 0 ? 0 : totalArtifacts / totalScreens
+  };
+}
+function deriveServerConfigSnapshotProperties(input) {
+  return {
+    server_version: telemetryVersion(input.version),
+    ...deriveServerConfigProperties({
+      port: input.port,
+      storagePath: input.storagePath,
+      authMode: input.authMode,
+      launchMode: input.launchMode,
+      ...input.defaultStoragePath === void 0 ? {} : { defaultStoragePath: input.defaultStoragePath }
+    }),
+    ...deriveBindingProperties(input.bindAddresses),
+    ...normalizeInstalledByAgent(input.installedByAgent)
+  };
+}
+function emitServerBootTelemetry(capture2, events, serverConfig, telemetryPreference) {
+  safeEmit(() => {
+    for (const event of events) {
+      if (event.name === "server_started") {
+        capture2({
+          name: "server_started",
+          properties: serverConfig,
+          personProperties: { ...serverConfig, ...telemetryPreference }
+        });
+        continue;
+      }
+      capture2(event);
+    }
+  });
+}
+function median(values) {
+  if (values.length === 0) return 0;
+  const sorted = [...values].sort((left, right) => left - right);
+  const middle = Math.floor(sorted.length / MEDIAN_PAIR_DIVISOR);
+  if (sorted.length % MEDIAN_PAIR_DIVISOR === 1) return sorted[middle];
+  return (sorted[middle - 1] + sorted[middle]) / MEDIAN_PAIR_DIVISOR;
+}
+function safeEmit(callback) {
+  try {
+    callback();
+  } catch {
+  }
+}
+
+// ../server/src/telemetry/identity.ts
+var import_node_crypto5 = require("node:crypto");
+var import_promises4 = require("node:fs/promises");
+var import_node_path9 = __toESM(require("node:path"), 1);
+
+// ../server/src/artifact-paths.ts
+var import_node_path8 = __toESM(require("node:path"), 1);
+function getStateDir(storagePath) {
+  return import_node_path8.default.join(storagePath, "state");
+}
+function getScreensDir(storagePath) {
+  return import_node_path8.default.join(getStateDir(storagePath), "screens");
+}
+function getArtifactsMetadataDir(storagePath) {
+  return import_node_path8.default.join(getStateDir(storagePath), "artifacts");
+}
+function getDisplayStatePath(storagePath) {
+  return import_node_path8.default.join(getStateDir(storagePath), "display.json");
+}
+function getTelemetryStatePath(storagePath) {
+  return import_node_path8.default.join(getStateDir(storagePath), "telemetry.json");
+}
+function getTokenPath(storagePath) {
+  return import_node_path8.default.join(getStateDir(storagePath), "token");
+}
+function getOnboardingArtifactSentinelPath(storagePath) {
+  return import_node_path8.default.join(getStateDir(storagePath), "onboarding-artifact.json");
+}
+function getAgentArtifactsDir(storagePath) {
+  return import_node_path8.default.join(...[storagePath, "artifacts"]);
+}
+function getArtifactLiveMetadataPath(storagePath, artifactID) {
+  return import_node_path8.default.join(getArtifactsMetadataDir(storagePath), `${artifactID}.json`);
+}
+
+// ../server/src/telemetry/identity.ts
+var TELEMETRY_STATE_SCHEMA_VERSION = 1;
+var SEMVER_MAJOR_CAPTURE_INDEX = 1;
+var SEMVER_MINOR_CAPTURE_INDEX = 2;
+var SEMVER_PATCH_CAPTURE_INDEX = 3;
+var SEMVER_PRERELEASE_CAPTURE_INDEX = 4;
+async function readTelemetryState(storagePath) {
+  try {
+    return normalizeTelemetryState(JSON.parse(await (0, import_promises4.readFile)(getTelemetryStatePath(storagePath), "utf8")));
+  } catch (error48) {
+    if (isNodeError(error48) && error48.code === "ENOENT") return null;
+    if (error48 instanceof SyntaxError || error48 instanceof InvalidTelemetryStateError) return null;
+    throw error48;
+  }
+}
+async function writeTelemetryState(storagePath, state) {
+  const statePath = getTelemetryStatePath(storagePath);
+  await (0, import_promises4.mkdir)(import_node_path9.default.dirname(statePath), { recursive: true });
+  const tempPath = `${statePath}.${process.pid}.${Date.now()}.tmp`;
+  await (0, import_promises4.writeFile)(tempPath, `${JSON.stringify(state, null, 2)}
+`, "utf8");
+  await (0, import_promises4.rename)(tempPath, statePath);
+}
+async function loadOrMintTelemetryState(storagePath, options = {}) {
+  const existing = await readTelemetryState(storagePath);
+  if (existing) return { state: existing, created: false };
+  const state = {
+    schemaVersion: TELEMETRY_STATE_SCHEMA_VERSION,
+    userId: options.userIdFactory?.() ?? (0, import_node_crypto5.randomUUID)(),
+    optedOut: false,
+    lastVersion: options.lastVersion ?? ""
+  };
+  await writeTelemetryState(storagePath, state);
+  return { state, created: true };
+}
+async function deriveBootTelemetry(storagePath, runningVersion, options) {
+  const loaded = await loadOrMintTelemetryState(storagePath, {
+    lastVersion: "",
+    userIdFactory: options.userIdFactory
+  });
+  const previousVersion = loaded.state.lastVersion.trim() || null;
+  const installed = options.dataDirCreated;
+  const upgraded = !installed && (previousVersion === null || isTelemetryVersionOlder(previousVersion, runningVersion));
+  const events = [];
+  if (installed) events.push({ name: "server_installed", personProperties: { pre_telemetry: false } });
+  if (upgraded) {
+    const preTelemetryAdoption = previousVersion === null;
+    events.push({
+      name: "server_upgraded",
+      properties: {
+        ...preTelemetryAdoption ? { pre_telemetry: true } : { old_version: telemetryVersion(previousVersion) },
+        new_version: telemetryVersion(runningVersion)
+      },
+      ...preTelemetryAdoption ? { personProperties: { pre_telemetry: true } } : {}
+    });
+  }
+  events.push({ name: "server_started" });
+  const nextState = { ...loaded.state, lastVersion: runningVersion };
+  if (nextState.lastVersion !== loaded.state.lastVersion) {
+    await writeTelemetryState(storagePath, nextState);
+  }
+  return {
+    state: nextState,
+    events,
+    installed,
+    upgraded,
+    previousVersion
+  };
+}
+async function setTelemetryOptedOut(storagePath, state, optedOut) {
+  const nextState = { ...state, optedOut };
+  await writeTelemetryState(storagePath, nextState);
+  return nextState;
+}
+function telemetryEnabled(env, state) {
+  if (state.optedOut) return false;
+  return telemetryEnvironmentSuppressionReason(env) === null;
+}
+function telemetryEnvironmentSuppressionReason(env) {
+  if (isEnabledEnvFlag(env.DO_NOT_TRACK)) return "do-not-track";
+  if (isEnabledEnvFlag(env.CI)) return "ci";
+  if (!isProductionTelemetryBuild(env) && !isTelemetryDevMode(env)) return "development";
+  return null;
+}
+function telemetryStatus(env, state) {
+  const reason = telemetryEnvironmentSuppressionReason(env);
+  if (reason) return { state: "suppressed", reason, guidPresent: state !== null, region: "us" };
+  if (state?.optedOut) return { state: "opted-out", reason: null, guidPresent: true, region: "us" };
+  if (state) return { state: "active", reason: null, guidPresent: true, region: "us" };
+  return { state: "unavailable", reason: null, guidPresent: false, region: "us" };
+}
+function isTelemetryDevMode(env) {
+  return isEnabledEnvFlag(env.TV_TELEMETRY_DEV);
+}
+function telemetryBuildMarker(env) {
+  const explicitBuild = env.TELEVISION_TELEMETRY_BUILD?.trim().toLowerCase();
+  if (explicitBuild) return explicitBuild;
+  const bundledBuild = bundledTelemetryBuildMarker()?.trim().toLowerCase();
+  if (bundledBuild) return bundledBuild;
+  if (env.NODE_ENV === "production") return "production";
+  return null;
+}
+function isProductionTelemetryBuild(env) {
+  return telemetryBuildMarker(env) === "production";
+}
+function isTelemetryVersionOlder(previousVersion, runningVersion) {
+  const previous = parseSemanticVersion(previousVersion);
+  const running = parseSemanticVersion(runningVersion);
+  if (!previous || !running) return false;
+  return compareSemanticVersions(previous, running) < 0;
+}
+function parseSemanticVersion(value) {
+  const match = value.trim().match(/^v?(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-([0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?$/);
+  if (!match) return null;
+  return {
+    major: Number(match[SEMVER_MAJOR_CAPTURE_INDEX]),
+    minor: Number(match[SEMVER_MINOR_CAPTURE_INDEX]),
+    patch: Number(match[SEMVER_PATCH_CAPTURE_INDEX]),
+    prerelease: match[SEMVER_PRERELEASE_CAPTURE_INDEX]?.split(".") ?? []
+  };
+}
+function compareSemanticVersions(left, right) {
+  const core = compareNumbers(left.major, right.major) || compareNumbers(left.minor, right.minor) || compareNumbers(left.patch, right.patch);
+  if (core !== 0) return core;
+  return comparePrerelease(left.prerelease, right.prerelease);
+}
+function comparePrerelease(left, right) {
+  if (left.length === 0 && right.length === 0) return 0;
+  if (left.length === 0) return 1;
+  if (right.length === 0) return -1;
+  for (let index = 0; index < Math.max(left.length, right.length); index += 1) {
+    const leftIdentifier = left[index];
+    const rightIdentifier = right[index];
+    if (leftIdentifier === void 0) return -1;
+    if (rightIdentifier === void 0) return 1;
+    const comparison = comparePrereleaseIdentifier(leftIdentifier, rightIdentifier);
+    if (comparison !== 0) return comparison;
+  }
+  return 0;
+}
+function comparePrereleaseIdentifier(left, right) {
+  const leftNumeric = /^\d+$/.test(left);
+  const rightNumeric = /^\d+$/.test(right);
+  if (leftNumeric && rightNumeric) return compareNumbers(Number(left), Number(right));
+  if (leftNumeric) return -1;
+  if (rightNumeric) return 1;
+  return left < right ? -1 : left > right ? 1 : 0;
+}
+function compareNumbers(left, right) {
+  return left < right ? -1 : left > right ? 1 : 0;
+}
+function bundledTelemetryBuildMarker() {
+  return true ? "production" : void 0;
+}
+function isEnabledEnvFlag(value) {
+  if (value === void 0) return false;
+  const normalized = value.trim().toLowerCase();
+  if (normalized === "") return false;
+  return normalized === "1" || normalized === "true" || normalized === "yes";
+}
+function normalizeTelemetryState(value) {
+  if (!value || typeof value !== "object") throw new InvalidTelemetryStateError("Invalid telemetry state file.");
+  const record2 = value;
+  if (record2.schemaVersion !== TELEMETRY_STATE_SCHEMA_VERSION) throw new InvalidTelemetryStateError("Unsupported telemetry state schema version.");
+  if (typeof record2.userId !== "string" || record2.userId.length === 0) throw new InvalidTelemetryStateError("Telemetry state is missing userId.");
+  return {
+    schemaVersion: TELEMETRY_STATE_SCHEMA_VERSION,
+    userId: record2.userId,
+    optedOut: record2.optedOut === true,
+    lastVersion: typeof record2.lastVersion === "string" ? record2.lastVersion : ""
+  };
+}
+var InvalidTelemetryStateError = class extends Error {
+};
+function isNodeError(error48) {
+  return error48 instanceof Error && "code" in error48;
+}
+
+// ../server/src/telemetry/capture.ts
+function capture(event, context) {
+  if (!telemetryEnabled(context.env, context.state)) return;
+  try {
+    context.sink.enqueue(buildTelemetryEvent(event, context));
+  } catch {
+  }
+}
+function buildTelemetryEvent(event, context) {
+  const properties = {
+    distinct_id: context.state.userId,
+    ...event.properties ?? {}
+  };
+  if (context.sessionId) properties.$session_id = context.sessionId;
+  if (event.personProperties && Object.keys(event.personProperties).length > 0) properties.$set = event.personProperties;
+  return {
+    name: event.name,
+    distinctId: context.state.userId,
+    properties
+  };
+}
+
+// ../server/src/telemetry/posthog-config.ts
+var import_node_fs8 = require("node:fs");
+var import_node_os4 = __toESM(require("node:os"), 1);
+var import_node_path10 = __toESM(require("node:path"), 1);
+var POSTHOG_US_INGESTION_HOST = "https://us.i.posthog.com";
+var POSTHOG_US_API_HOST = "https://us.posthog.com";
+var POSTHOG_PRODUCTION_PROJECT_ID = 482022;
+var POSTHOG_TEST_PROJECT_ID = 484904;
+var POSTHOG_PRODUCTION_PROJECT_TOKEN = "phc_qASjRhbnr7AA9ak5YeQtWtHdGY5P9TM9Q2k86G34LoYP";
+var POSTHOG_TEST_PROJECT_TOKEN = "phc_roRM2of2chrstmcQAokxucoYa4KBUatW9bTjLKeBcgi4";
+var POSTHOG_PRODUCTION_PROJECT = {
+  projectId: POSTHOG_PRODUCTION_PROJECT_ID,
+  projectToken: POSTHOG_PRODUCTION_PROJECT_TOKEN,
+  ingestionHost: POSTHOG_US_INGESTION_HOST,
+  apiHost: POSTHOG_US_API_HOST
+};
+var POSTHOG_TEST_PROJECT = {
+  projectId: POSTHOG_TEST_PROJECT_ID,
+  projectToken: POSTHOG_TEST_PROJECT_TOKEN,
+  ingestionHost: POSTHOG_US_INGESTION_HOST,
+  apiHost: POSTHOG_US_API_HOST
+};
+function resolvePostHogProject(env, options = {}) {
+  return isTelemetryDevMode(env) || options.developerHost === true ? POSTHOG_TEST_PROJECT : POSTHOG_PRODUCTION_PROJECT;
+}
+function resolveTelemetryDeveloperHome(env = process.env) {
+  const capturedHome = env.TELEVISION_DEVELOPER_HOME;
+  return capturedHome && capturedHome.length > 0 ? capturedHome : import_node_os4.default.homedir();
+}
+function detectTelemetryDeveloperHost(homeDir = import_node_os4.default.homedir()) {
+  try {
+    return (0, import_node_fs8.existsSync)(import_node_path10.default.join(homeDir, ".tv-developer"));
+  } catch {
+    return false;
+  }
+}
+
+// ../server/src/telemetry/sessions.ts
+var import_node_crypto6 = require("node:crypto");
+var IDLE_TIMEOUT_MINUTES = 30;
+var MAX_SESSION_HOURS = 24;
+var SECONDS_PER_MINUTE2 = 60;
+var MINUTES_PER_HOUR2 = 60;
+var MILLISECONDS_PER_SECOND = 1e3;
+var SESSION_IDLE_TIMEOUT_MS = IDLE_TIMEOUT_MINUTES * SECONDS_PER_MINUTE2 * MILLISECONDS_PER_SECOND;
+var MAX_SESSION_DURATION_MS = MAX_SESSION_HOURS * MINUTES_PER_HOUR2 * SECONDS_PER_MINUTE2 * MILLISECONDS_PER_SECOND;
+var BYTE_HEX_RADIX = 16;
+var UUID_BYTE_COUNT = 16;
+var UUID_VERSION_BYTE_INDEX = 6;
+var UUID_VARIANT_BYTE_INDEX = 8;
+var UUID_TIMESTAMP_LAST_BYTE_INDEX = 5;
+var UUID_VERSION_7_HIGH_BITS = 112;
+var UUID_VARIANT_RFC_9562_HIGH_BITS = 128;
+var UUID_VERSION_LOW_MASK = 15;
+var UUID_VARIANT_LOW_MASK = 63;
+var BYTE_MASK = 255;
+var BYTE_SHIFT = 8;
+var UUID_GROUP_ONE_END = 8;
+var UUID_GROUP_TWO_END = 12;
+var UUID_GROUP_THREE_END = 16;
+var UUID_GROUP_FOUR_END = 20;
+function createTelemetrySessionManager() {
+  return new InMemoryTelemetrySessionManager();
+}
+function createUUIDv7(timestampMs) {
+  const bytes = (0, import_node_crypto6.randomBytes)(UUID_BYTE_COUNT);
+  writeTimestamp(bytes, timestampMs);
+  bytes[UUID_VERSION_BYTE_INDEX] = UUID_VERSION_7_HIGH_BITS | bytes[UUID_VERSION_BYTE_INDEX] & UUID_VERSION_LOW_MASK;
+  bytes[UUID_VARIANT_BYTE_INDEX] = UUID_VARIANT_RFC_9562_HIGH_BITS | bytes[UUID_VARIANT_BYTE_INDEX] & UUID_VARIANT_LOW_MASK;
+  return formatUUID(bytes);
+}
+var InMemoryTelemetrySessionManager = class {
+  #sessions = /* @__PURE__ */ new Map();
+  sessionIdFor(clientId, nowMs) {
+    if (!clientId) return null;
+    const existing = this.#sessions.get(clientId);
+    if (!existing || shouldRotate(existing, nowMs)) {
+      const next = mintSession(clientId, nowMs);
+      this.#sessions.set(clientId, next);
+      return next.sessionId;
+    }
+    const updated = { ...existing, lastActivityMs: nowMs };
+    this.#sessions.set(clientId, updated);
+    return existing.sessionId;
+  }
+  get(clientId) {
+    return this.#sessions.get(clientId) ?? null;
+  }
+};
+function mintSession(clientId, nowMs) {
+  return {
+    clientId,
+    sessionId: createUUIDv7(nowMs),
+    sessionStartMs: nowMs,
+    lastActivityMs: nowMs
+  };
+}
+function shouldRotate(session, nowMs) {
+  return nowMs - session.lastActivityMs > SESSION_IDLE_TIMEOUT_MS || nowMs - session.sessionStartMs >= MAX_SESSION_DURATION_MS;
+}
+function writeTimestamp(bytes, timestampMs) {
+  if (!Number.isSafeInteger(timestampMs) || timestampMs < 0) throw new Error(`Invalid UUIDv7 timestamp: ${timestampMs}`);
+  let remaining = timestampMs;
+  for (let index = UUID_TIMESTAMP_LAST_BYTE_INDEX; index >= 0; index -= 1) {
+    bytes[index] = remaining & BYTE_MASK;
+    remaining = Math.floor(remaining / 2 ** BYTE_SHIFT);
+  }
+}
+function formatUUID(bytes) {
+  const hex3 = [...bytes].map((byte) => byte.toString(BYTE_HEX_RADIX).padStart(2, "0")).join("");
+  const first = hex3.slice(0, UUID_GROUP_ONE_END);
+  const second = hex3.slice(UUID_GROUP_ONE_END, UUID_GROUP_TWO_END);
+  const third = hex3.slice(UUID_GROUP_TWO_END, UUID_GROUP_THREE_END);
+  const fourth = hex3.slice(UUID_GROUP_THREE_END, UUID_GROUP_FOUR_END);
+  const fifth = hex3.slice(UUID_GROUP_FOUR_END);
+  return `${first}-${second}-${third}-${fourth}-${fifth}`;
+}
+
+// ../server/src/telemetry/sink.ts
+var DEFAULT_MAX_BUFFER_SIZE = 1e3;
+var DEFAULT_POSTHOG_TIMEOUT_MS = 1e4;
+function createTelemetrySink(options = {}) {
+  return new BufferedTelemetrySink(
+    options.transport ?? createPostHogTransport({ project: options.project }),
+    options.maxBufferSize ?? DEFAULT_MAX_BUFFER_SIZE,
+    options.autoFlush ?? true
+  );
+}
+function createPostHogTransport(options = {}) {
+  const project = options.project ?? POSTHOG_PRODUCTION_PROJECT;
+  const fetchImpl = options.fetchImpl ?? fetch;
+  const timeoutMs = options.timeoutMs ?? DEFAULT_POSTHOG_TIMEOUT_MS;
+  const captureUrl = new URL("/capture/", project.ingestionHost).toString();
+  return {
+    async send(event) {
+      const controller = new AbortController();
+      const timeout = timeoutMs > 0 ? setTimeout(() => controller.abort(), timeoutMs) : null;
+      try {
+        const response = await fetchImpl(captureUrl, {
+          method: "POST",
+          headers: { "content-type": "application/json" },
+          body: JSON.stringify({
+            api_key: project.projectToken,
+            event: event.name,
+            distinct_id: event.distinctId,
+            properties: event.properties
+          }),
+          signal: controller.signal
+        });
+        if (!response.ok) throw new Error(`PostHog capture failed with HTTP ${response.status}`);
+      } catch (error48) {
+        if (controller.signal.aborted) throw new Error(`PostHog capture timed out after ${timeoutMs}ms`);
+        throw error48;
+      } finally {
+        if (timeout) clearTimeout(timeout);
+      }
+    }
+  };
+}
+var BufferedTelemetrySink = class {
+  transport;
+  maxBufferSize;
+  autoFlush;
+  buffer = [];
+  flushing = false;
+  flushScheduled = false;
+  constructor(transport, maxBufferSize, autoFlush) {
+    this.transport = transport;
+    this.maxBufferSize = Math.max(1, maxBufferSize);
+    this.autoFlush = autoFlush;
+  }
+  enqueue(event) {
+    try {
+      if (this.buffer.length >= this.maxBufferSize) this.buffer.shift();
+      this.buffer.push(event);
+      if (this.autoFlush) this.scheduleFlush();
+    } catch {
+    }
+  }
+  async flush() {
+    if (this.flushing) return;
+    this.flushing = true;
+    try {
+      while (this.buffer.length > 0) {
+        const next = this.buffer[0];
+        try {
+          await this.transport.send(next);
+          this.buffer.shift();
+        } catch {
+          break;
+        }
+      }
+    } finally {
+      this.flushing = false;
+    }
+  }
+  async shutdown() {
+    await this.flush();
+    try {
+      await this.transport.shutdown?.();
+    } catch {
+    }
+  }
+  pendingCount() {
+    return this.buffer.length;
+  }
+  scheduleFlush() {
+    if (this.flushScheduled) return;
+    this.flushScheduled = true;
+    queueMicrotask(() => {
+      this.flushScheduled = false;
+      void this.flush();
+    });
+  }
+};
+
+// ../server/src/telemetry/runtime.ts
+var SKILL_INSTALL_TELEMETRY_TIMEOUT_MS = 500;
+async function emitSkillInstalledTelemetry(options) {
+  const env = options.env ?? process.env;
+  const developerHost = options.developerHost ?? detectTelemetryDeveloperHost(resolveTelemetryDeveloperHome(env));
+  const sink = options.sink ?? createTelemetrySink({
+    transport: createPostHogTransport({ project: resolvePostHogProject(env, { developerHost }), timeoutMs: SKILL_INSTALL_TELEMETRY_TIMEOUT_MS })
+  });
+  try {
+    const loaded = await loadOrMintTelemetryState(options.storagePath, { lastVersion: "" });
+    capture({
+      name: "skill_installed",
+      properties: {
+        server_version: options.version,
+        agent_type: options.agentType,
+        ...normalizeInstalledByAgent(options.installedByAgent)
+      }
+    }, { state: loaded.state, env, sink });
+  } catch {
+  } finally {
+    await bestEffortWithinTimeout(sink.shutdown?.(), SKILL_INSTALL_TELEMETRY_TIMEOUT_MS);
+  }
+}
+async function bestEffortWithinTimeout(promise2, timeoutMs) {
+  if (!promise2) return;
+  void promise2.catch(() => {
+  });
+  await new Promise((resolve) => {
+    const timeout = setTimeout(resolve, timeoutMs);
+    promise2.then(
+      () => {
+        clearTimeout(timeout);
+        resolve();
+      },
+      () => {
+        clearTimeout(timeout);
+        resolve();
+      }
+    );
+  });
+}
+async function createTelemetryRuntime(options) {
+  try {
+    const boot = await deriveBootTelemetry(options.storagePath, options.version, { dataDirCreated: options.dataDirCreated });
+    const env = options.env ?? process.env;
+    const developerHost = options.developerHost ?? detectTelemetryDeveloperHost(resolveTelemetryDeveloperHome(env));
+    const sink = options.sink ?? createTelemetrySink({ project: resolvePostHogProject(env, { developerHost }) });
+    const sessions = options.sessions ?? createTelemetrySessionManager();
+    const nowMs = options.nowMs ?? Date.now;
+    let currentState = boot.state;
+    let pendingPersonProperties = null;
+    const sessionIdFor = (clientContext) => {
+      return sessions.sessionIdFor(clientContext?.clientId ?? null, nowMs());
+    };
+    const captureWithPendingPersonProperties = (event, sessionId) => {
+      const shouldAttachPendingProperties = pendingPersonProperties !== null && telemetryEnabled(env, currentState);
+      capture(shouldAttachPendingProperties ? { ...event, personProperties: { ...event.personProperties ?? {}, ...pendingPersonProperties } } : event, { state: currentState, env, sink, sessionId });
+      if (shouldAttachPendingProperties) pendingPersonProperties = null;
+    };
+    return {
+      boot,
+      get state() {
+        return currentState;
+      },
+      enabled: true,
+      status() {
+        return telemetryStatus(env, currentState);
+      },
+      async disable() {
+        if (!currentState.optedOut) {
+          capture({
+            name: "telemetry_opted_out",
+            personProperties: { telemetry_opted_out: true }
+          }, { state: currentState, env, sink });
+          currentState = await setTelemetryOptedOut(options.storagePath, currentState, true);
+        }
+        return telemetryStatus(env, currentState);
+      },
+      async enable() {
+        if (currentState.optedOut) {
+          currentState = await setTelemetryOptedOut(options.storagePath, currentState, false);
+          pendingPersonProperties = { telemetry_opted_out: false };
+        }
+        return telemetryStatus(env, currentState);
+      },
+      capture(event, clientContext) {
+        captureWithPendingPersonProperties(event, sessionIdFor(clientContext));
+      },
+      observeClientRequest(clientContext) {
+        return sessionIdFor(clientContext);
+      },
+      recordClientActivity(clientContext) {
+        if (!clientContext) return;
+        const sessionId = sessionIdFor(clientContext);
+        if (!sessionId) return;
+        captureWithPendingPersonProperties({
+          name: "session_activity",
+          properties: {
+            server_version: options.version,
+            ...deriveSessionActivityClientProperties(clientContext)
+          }
+        }, sessionId);
+      },
+      async shutdown() {
+        try {
+          await sink.shutdown?.();
+        } catch {
+        }
+      }
+    };
+  } catch {
+    return disabledTelemetryRuntime();
+  }
+}
+function disabledTelemetryRuntime() {
+  return {
+    boot: null,
+    state: null,
+    enabled: false,
+    status() {
+      return telemetryStatus(process.env, null);
+    },
+    async disable() {
+      return telemetryStatus(process.env, null);
+    },
+    async enable() {
+      return telemetryStatus(process.env, null);
+    },
+    capture() {
+    },
+    observeClientRequest() {
+      return null;
+    },
+    recordClientActivity() {
+    },
+    async shutdown() {
+    }
+  };
+}
+
 // ../server/src/server.ts
+var import_meta = {};
 var HTTP_UNAUTHORIZED_STATUS = 401;
 var LOOPBACK_IPV4 = "127.0.0.1";
 var Server = class {
@@ -51355,7 +52410,9 @@ var Server = class {
   authRequired;
   authMode;
   bindAddresses;
+  telemetryOptions;
   bindFailures = [];
+  telemetryRuntime = null;
   listeningPort;
   baseURLs;
   disposed = false;
@@ -51365,6 +52422,7 @@ var Server = class {
     this.authRequired = options.auth ?? false;
     this.authMode = options.auth === true ? "auth" : options.auth === false ? "no-auth" : "none";
     this.bindAddresses = resolveBindAddresses(options.host ? [options.host] : options.listen);
+    this.telemetryOptions = options.telemetry ?? {};
     this.listeningPort = this.port;
     this.baseURLs = [];
     this.app = (0, import_express2.default)();
@@ -51380,7 +52438,8 @@ var Server = class {
     this.app.use(import_express2.default.json());
     this.events = new EventStreamServer({
       store: this.store,
-      authRequired: this.authRequired
+      authRequired: this.authRequired,
+      recordTelemetryActivity: (clientContext) => this.telemetryRuntime?.recordClientActivity(clientContext)
     });
     this.acp = options.acpProfile ? new ACPServer({
       authToken: this.store.authToken,
@@ -51390,7 +52449,13 @@ var Server = class {
     registerRoutes(this.app, this.store, {
       requireAuth: this.requireAuthorization,
       requireBearerAuth: this.requireBearerAuthorization,
-      acpEnabled: this.acp !== null
+      acpEnabled: this.acp !== null,
+      observeTelemetryClientRequest: (clientContext) => {
+        this.telemetryRuntime?.observeClientRequest(clientContext);
+      },
+      getTelemetryStatus: () => this.telemetryRuntime?.status() ?? { state: "unavailable", reason: null, guidPresent: false, region: "us" },
+      enableTelemetry: async () => this.telemetryRuntime?.enable() ?? { state: "unavailable", reason: null, guidPresent: false, region: "us" },
+      disableTelemetry: async () => this.telemetryRuntime?.disable() ?? { state: "unavailable", reason: null, guidPresent: false, region: "us" }
     });
     if (options.canonicalDir) {
       this.app.use("/canonical/v1", (_req, res, next) => {
@@ -51456,6 +52521,7 @@ var Server = class {
       log(this.store.storagePath, message, { reason: "all bind addresses failed", snapshot: this.configurationSnapshot() });
       throw new Error(message);
     }
+    await this.startTelemetry();
     log(this.store.storagePath, "server started", { snapshot: this.configurationSnapshot() });
     if (!this.authRequired) {
       log(this.store.storagePath, "server running without bearer-token enforcement", { authMode: this.authMode });
@@ -51501,7 +52567,8 @@ var Server = class {
       await Promise.all([
         this.events.dispose(),
         this.acp?.dispose() ?? Promise.resolve(),
-        Promise.resolve(this.store.dispose())
+        Promise.resolve(this.store.dispose()),
+        this.telemetryRuntime?.shutdown() ?? Promise.resolve()
       ]);
       await Promise.all(this.httpServers.map((server) => this.closeServer(server)));
     } catch (error48) {
@@ -51551,6 +52618,35 @@ var Server = class {
   getNonLoopbackBoundAddresses() {
     return this.baseURLs.map((url2) => new URL(url2).hostname).filter((address) => address !== LOOPBACK_IPV4);
   }
+  async startTelemetry() {
+    const version2 = this.telemetryOptions.version ?? readServerPackageVersion();
+    const launchMode = this.telemetryOptions.launchMode ?? "cli";
+    const runtime = await createTelemetryRuntime({
+      storagePath: this.store.storagePath,
+      version: version2,
+      dataDirCreated: this.store.dataDirCreated,
+      ...this.telemetryOptions.env === void 0 ? {} : { env: this.telemetryOptions.env },
+      ...this.telemetryOptions.sink === void 0 ? {} : { sink: this.telemetryOptions.sink },
+      ...this.telemetryOptions.developerHost === void 0 ? {} : { developerHost: this.telemetryOptions.developerHost }
+    });
+    this.telemetryRuntime = runtime;
+    this.store.setTelemetryHooks(createServerStoreTelemetryHooks(this.store, runtime.capture));
+    if (!runtime.boot) return;
+    emitServerBootTelemetry(
+      runtime.capture,
+      runtime.boot.events,
+      deriveServerConfigSnapshotProperties({
+        version: version2,
+        storagePath: this.store.storagePath,
+        port: this.port,
+        bindAddresses: this.bindAddresses,
+        authMode: this.authMode,
+        launchMode,
+        installedByAgent: this.telemetryOptions.installedByAgent ?? null
+      }),
+      { telemetry_opted_out: runtime.boot.state.optedOut }
+    );
+  }
   configurationSnapshot() {
     return {
       storagePath: this.store.storagePath,
@@ -51598,15 +52694,23 @@ var Server = class {
     res.status(HTTP_UNAUTHORIZED_STATUS).json({ error: "Unauthorized" });
   };
 };
+function readServerPackageVersion() {
+  if ("0.1.171".length > 0) {
+    return telemetryVersion("0.1.171");
+  }
+  const packageJsonPath = import_node_path11.default.resolve(import_node_path11.default.dirname((0, import_node_url.fileURLToPath)(import_meta.url)), "..", "package.json");
+  if (!(0, import_node_fs9.existsSync)(packageJsonPath)) return telemetryVersion("0.0.0");
+  return telemetryVersion(JSON.parse((0, import_node_fs9.readFileSync)(packageJsonPath, "utf8")).version);
+}
 
 // ../server/src/server-store.ts
-var import_node_fs9 = require("node:fs");
-var import_node_path11 = __toESM(require("node:path"), 1);
+var import_node_fs11 = require("node:fs");
+var import_node_path14 = __toESM(require("node:path"), 1);
 
 // ../server/src/file-watcher.ts
 var import_node_events = require("node:events");
 var fs3 = __toESM(require("node:fs"), 1);
-var import_node_path8 = __toESM(require("node:path"), 1);
+var import_node_path12 = __toESM(require("node:path"), 1);
 var DEFAULT_REARM_INTERVAL_MS = 250;
 function isMissingWatchRootError(error48) {
   return typeof error48 === "object" && error48 !== null && "code" in error48 && error48.code === "ENOENT";
@@ -51625,9 +52729,9 @@ var ReArmingContentWatcher = class extends import_node_events.EventEmitter {
   #rootEventImmediate = null;
   constructor(filePath, onChange, basenames, options = {}) {
     super();
-    this.#dir = basenames === void 0 ? import_node_path8.default.dirname(filePath) : filePath;
-    this.#watchedBasenames = new Set(basenames ?? [import_node_path8.default.basename(filePath)]);
-    this.#watchRootBasename = import_node_path8.default.basename(import_node_path8.default.normalize(this.#dir));
+    this.#dir = basenames === void 0 ? import_node_path12.default.dirname(filePath) : filePath;
+    this.#watchedBasenames = new Set(basenames ?? [import_node_path12.default.basename(filePath)]);
+    this.#watchRootBasename = import_node_path12.default.basename(import_node_path12.default.normalize(this.#dir));
     this.#onChange = onChange;
     this.#options = options;
     try {
@@ -51671,7 +52775,7 @@ var ReArmingContentWatcher = class extends import_node_events.EventEmitter {
     });
     const ancestorWatchers = [];
     for (const ancestorDir of this.#ancestorDirs()) {
-      const ancestorBasename = import_node_path8.default.basename(import_node_path8.default.normalize(ancestorDir));
+      const ancestorBasename = import_node_path12.default.basename(import_node_path12.default.normalize(ancestorDir));
       try {
         const ancestorWatcher = fs3.watch(ancestorDir, (_event, filename) => {
           const basename = filename?.toString();
@@ -51717,10 +52821,10 @@ var ReArmingContentWatcher = class extends import_node_events.EventEmitter {
   }
   #ancestorDirs() {
     const ancestors = [];
-    let current = import_node_path8.default.dirname(this.#dir);
-    while (current !== import_node_path8.default.dirname(current)) {
+    let current = import_node_path12.default.dirname(this.#dir);
+    while (current !== import_node_path12.default.dirname(current)) {
       ancestors.push(current);
-      current = import_node_path8.default.dirname(current);
+      current = import_node_path12.default.dirname(current);
     }
     return ancestors;
   }
@@ -51776,54 +52880,27 @@ var defaultWatchContentFile = (filePath, onChange, basenames, options) => {
   return new ReArmingContentWatcher(filePath, onChange, basenames, options);
 };
 
-// ../server/src/artifact-paths.ts
-var import_node_path9 = __toESM(require("node:path"), 1);
-function getStateDir(storagePath) {
-  return import_node_path9.default.join(storagePath, "state");
-}
-function getScreensDir(storagePath) {
-  return import_node_path9.default.join(getStateDir(storagePath), "screens");
-}
-function getArtifactsMetadataDir(storagePath) {
-  return import_node_path9.default.join(getStateDir(storagePath), "artifacts");
-}
-function getDisplayStatePath(storagePath) {
-  return import_node_path9.default.join(getStateDir(storagePath), "display.json");
-}
-function getTokenPath(storagePath) {
-  return import_node_path9.default.join(getStateDir(storagePath), "token");
-}
-function getOnboardingArtifactSentinelPath(storagePath) {
-  return import_node_path9.default.join(getStateDir(storagePath), "onboarding-artifact.json");
-}
-function getAgentArtifactsDir(storagePath) {
-  return import_node_path9.default.join(...[storagePath, "artifacts"]);
-}
-function getArtifactLiveMetadataPath(storagePath, artifactID) {
-  return import_node_path9.default.join(getArtifactsMetadataDir(storagePath), `${artifactID}.json`);
-}
-
 // ../server/src/onboarding.ts
-var import_node_fs8 = require("node:fs");
-var import_node_path10 = __toESM(require("node:path"), 1);
-var import_node_url = require("node:url");
-var import_meta = {};
+var import_node_fs10 = require("node:fs");
+var import_node_path13 = __toESM(require("node:path"), 1);
+var import_node_url2 = require("node:url");
+var import_meta2 = {};
 var ONBOARDING_ARTIFACT_ID = "television-onboarding";
 var ONBOARDING_SCREEN_NAME = "TV Guide";
 var ONBOARDING_ARTIFACT_TITLE = "Welcome to Television";
 var ONBOARDING_ARTIFACT_DIRNAME = "television-onboarding";
 var ONBOARDING_ARTIFACT_SENTINEL_VERSION = 1;
 function getDefaultOnboardingArtifactSourcePath() {
-  const moduleURL = import_meta.url;
+  const moduleURL = import_meta2.url;
   if (typeof moduleURL !== "string") {
     return void 0;
   }
-  const sourcePath = import_node_path10.default.resolve(
-    import_node_path10.default.dirname((0, import_node_url.fileURLToPath)(moduleURL)),
+  const sourcePath = import_node_path13.default.resolve(
+    import_node_path13.default.dirname((0, import_node_url2.fileURLToPath)(moduleURL)),
     "../assets",
     ONBOARDING_ARTIFACT_DIRNAME
   );
-  return (0, import_node_fs8.existsSync)(sourcePath) ? sourcePath : void 0;
+  return (0, import_node_fs10.existsSync)(sourcePath) ? sourcePath : void 0;
 }
 
 // ../server/src/server-store.ts
@@ -51835,6 +52912,17 @@ var BUNDLED_VIEW_IDS = /* @__PURE__ */ new Set(["artifact-missing", "markdown"])
 function isBundledViewID(id) {
   return BUNDLED_VIEW_IDS.has(id);
 }
+function hasExistingTelevisionDataStructure(storagePath) {
+  return [
+    getDisplayStatePath(storagePath),
+    getTokenPath(storagePath),
+    getOnboardingArtifactSentinelPath(storagePath),
+    getScreensDir(storagePath),
+    getArtifactsMetadataDir(storagePath),
+    getThemesDir(storagePath),
+    getAgentArtifactsDir(storagePath)
+  ].some((markerPath) => (0, import_node_fs11.existsSync)(markerPath));
+}
 function artifactWatchTarget(artifact) {
   if (artifact.kind === "url") {
     return null;
@@ -51850,6 +52938,7 @@ function artifactWatchTarget(artifact) {
 var ServerStore = class extends EventTarget {
   storagePath;
   authToken;
+  dataDirCreated;
   screens = /* @__PURE__ */ new Map();
   activeScreenID = null;
   activeThemeName = null;
@@ -51863,9 +52952,11 @@ var ServerStore = class extends EventTarget {
   watchContentFile;
   bundledViewsPath;
   onboardingArtifactSourcePath;
+  telemetryHooks = null;
   constructor(options) {
     super();
     this.storagePath = options.storagePath;
+    this.dataDirCreated = !hasExistingTelevisionDataStructure(options.storagePath);
     this.watchContentFile = options.watchContentFile ?? defaultWatchContentFile;
     this.bundledViewsPath = options.bundledViewsPath;
     this.onboardingArtifactSourcePath = options.onboardingArtifactSourcePath ?? getDefaultOnboardingArtifactSourcePath();
@@ -51887,6 +52978,9 @@ var ServerStore = class extends EventTarget {
     }
     this.startWatchingActiveTheme();
   }
+  setTelemetryHooks(hooks) {
+    this.telemetryHooks = hooks;
+  }
   getViews() {
     return [];
   }
@@ -51894,8 +52988,8 @@ var ServerStore = class extends EventTarget {
     if (!isBundledViewID(id) || this.bundledViewsPath === void 0) {
       return null;
     }
-    const viewPath = import_node_path11.default.join(this.bundledViewsPath, id);
-    return (0, import_node_fs9.existsSync)(import_node_path11.default.join(viewPath, "index.html")) ? viewPath : null;
+    const viewPath = import_node_path14.default.join(this.bundledViewsPath, id);
+    return (0, import_node_fs11.existsSync)(import_node_path14.default.join(viewPath, "index.html")) ? viewPath : null;
   }
   getScreen(id) {
     const screen = this.screens.get(id);
@@ -51917,7 +53011,7 @@ var ServerStore = class extends EventTarget {
     return [...this._artifacts.values()];
   }
   /** Create a new artifact and append its card to the owning screen. */
-  createArtifact(input) {
+  createArtifact(input, telemetryContext) {
     const screen = this.requireScreen(input.screenID);
     const artifact = this.createKindArtifact(input);
     const previousLayout = screen.layout;
@@ -51927,16 +53021,17 @@ var ServerStore = class extends EventTarget {
       this.persistScreen(screen);
     } catch (error48) {
       screen.layout = previousLayout;
-      (0, import_node_fs9.rmSync)(getArtifactLiveMetadataPath(this.storagePath, artifact.id), { force: true });
+      (0, import_node_fs11.rmSync)(getArtifactLiveMetadataPath(this.storagePath, artifact.id), { force: true });
       throw error48;
     }
     this._artifacts.set(artifact.id, artifact);
     this.artifactScreens.set(artifact.id, screen.id);
     this.startWatchingArtifactContent(artifact);
     this.dispatchEvent(new ArtifactCreatedEvent("artifact-created", { screenID: screen.id, artifact }));
+    this.emitTelemetry((hooks) => hooks.artifactCreated(artifact, telemetryContext));
     return artifact;
   }
-  updateArtifact(input) {
+  updateArtifact(input, telemetryContext) {
     const artifact = this._artifacts.get(input.artifactID);
     if (!artifact) {
       throw new NotFoundError(`Artifact not found: ${input.artifactID}`, { entityType: "artifact", entityID: input.artifactID });
@@ -51978,6 +53073,7 @@ var ServerStore = class extends EventTarget {
       this.scheduleArtifactContentChangedEvent(updated.id);
     }
     this.dispatchEvent(new ArtifactUpdatedEvent("artifact-updated", { artifact: updated }));
+    this.emitTelemetry((hooks) => hooks.artifactUpdated(updated, telemetryContext));
     return updated;
   }
   /**
@@ -51986,7 +53082,7 @@ var ServerStore = class extends EventTarget {
    *
    * Throws `NotFoundError` when the artifact does not exist.
    */
-  deleteArtifact(artifactID) {
+  deleteArtifact(artifactID, telemetryContext) {
     const artifact = this._artifacts.get(artifactID);
     if (!artifact) {
       throw new NotFoundError(`Artifact not found: ${artifactID}`, { entityType: "artifact", entityID: artifactID });
@@ -52006,13 +53102,14 @@ var ServerStore = class extends EventTarget {
     }
     this.stopWatchingArtifactContent(artifactID);
     this._artifacts.delete(artifactID);
-    (0, import_node_fs9.rmSync)(getArtifactLiveMetadataPath(this.storagePath, artifactID), { force: true });
+    (0, import_node_fs11.rmSync)(getArtifactLiveMetadataPath(this.storagePath, artifactID), { force: true });
     if (screenID !== void 0) {
       this.dispatchEvent(new ArtifactRemovedEvent("artifact-removed", { artifactID, screenID }));
     }
+    this.emitTelemetry((hooks) => hooks.artifactDeleted(artifact, telemetryContext));
     return artifact.kind === "path" ? { outcome: "deleted", kind: "path", artifactID, path: artifact.path } : { outcome: "deleted", kind: "url", artifactID, url: artifact.url };
   }
-  createScreen(input) {
+  createScreen(input, telemetryContext) {
     const screen = {
       id: input.id ?? ulid3(),
       name: input.name,
@@ -52021,9 +53118,10 @@ var ServerStore = class extends EventTarget {
     this.screens.set(screen.id, screen);
     this.persistScreen(screen);
     this.dispatchEvent(new ScreenCreatedEvent("screen-created", { screen }));
+    this.emitTelemetry((hooks) => hooks.screenCreated(screen, telemetryContext));
     return screen;
   }
-  updateScreen(input) {
+  updateScreen(input, telemetryContext) {
     const screen = this.requireScreen(input.screenID);
     if (typeof input.fields.name === "string") {
       screen.name = input.fields.name;
@@ -52041,10 +53139,12 @@ var ServerStore = class extends EventTarget {
       }
       this.rebuildArtifactScreensForScreen(screen);
       this.dispatchEvent(new ScreenUpdatedEvent("screen-updated", { screen }));
+      this.emitTelemetry((hooks) => hooks.screenLayoutChanged(previousLayout, screen.layout, telemetryContext));
       return screen;
     }
     this.persistScreen(screen);
     this.dispatchEvent(new ScreenUpdatedEvent("screen-updated", { screen }));
+    this.emitTelemetry((hooks) => hooks.screenUpdated(screen, telemetryContext));
     return screen;
   }
   /** The screen that Television's GUI is currently focused on. */
@@ -52060,7 +53160,7 @@ var ServerStore = class extends EventTarget {
       activeThemeName: this.activeThemeName
     };
   }
-  patchDisplay(input) {
+  patchDisplay(input, telemetryContext) {
     const currentActiveScreenID = this.getActiveScreenID();
     let nextActiveScreenID = this.activeScreenID;
     let nextActiveThemeName = this.activeThemeName;
@@ -52104,6 +53204,7 @@ var ServerStore = class extends EventTarget {
       this.dispatchEvent(
         new ThemeChangedEvent("theme-changed", { themeName: this.activeThemeName })
       );
+      this.emitTelemetry((hooks) => hooks.themeChanged(telemetryContext));
     }
   }
   /**
@@ -52133,15 +53234,16 @@ var ServerStore = class extends EventTarget {
     );
     return { screenID: target, artifactID: input.artifactID };
   }
-  removeScreen(screenID) {
+  removeScreen(screenID, telemetryContext) {
     const screen = this.requireScreen(screenID);
     const previousActiveScreenID = this.getActiveScreenID();
     const artifactIDs = [...new Set(getScreenArtifactIDs(screen))];
-    const artifactResults = artifactIDs.map((artifactID) => this.deleteArtifact(artifactID));
-    const metadataPath = import_node_path11.default.join(this.screensDir, `${screen.id}.json`);
-    (0, import_node_fs9.rmSync)(metadataPath, { force: true });
+    const artifactResults = artifactIDs.map((artifactID) => this.deleteArtifact(artifactID, telemetryContext));
+    const metadataPath = import_node_path14.default.join(this.screensDir, `${screen.id}.json`);
+    (0, import_node_fs11.rmSync)(metadataPath, { force: true });
     this.screens.delete(screen.id);
     this.dispatchEvent(new ScreenRemovedEvent("screen-removed", { screenID }));
+    this.emitTelemetry((hooks) => hooks.screenDeleted(screen, telemetryContext));
     const nextActiveScreenID = this.getActiveScreenID();
     if (previousActiveScreenID !== nextActiveScreenID) {
       this.dispatchEvent(
@@ -52157,14 +53259,21 @@ var ServerStore = class extends EventTarget {
   [Symbol.dispose]() {
     this.dispose();
   }
+  emitTelemetry(callback) {
+    if (!this.telemetryHooks) return;
+    try {
+      callback(this.telemetryHooks);
+    } catch {
+    }
+  }
   load() {
-    if ((0, import_node_fs9.existsSync)(this.screensDir)) {
-      for (const file2 of (0, import_node_fs9.readdirSync)(this.screensDir)) {
+    if ((0, import_node_fs11.existsSync)(this.screensDir)) {
+      for (const file2 of (0, import_node_fs11.readdirSync)(this.screensDir)) {
         if (!file2.endsWith(JSON_FILE_SUFFIX)) continue;
-        const filePath = import_node_path11.default.join(this.screensDir, file2);
+        const filePath = import_node_path14.default.join(this.screensDir, file2);
         let raw;
         try {
-          raw = JSON.parse((0, import_node_fs9.readFileSync)(filePath, "utf8"));
+          raw = JSON.parse((0, import_node_fs11.readFileSync)(filePath, "utf8"));
         } catch (error48) {
           console.warn(`Skipping malformed JSON file: ${filePath}`, error48);
           continue;
@@ -52180,15 +53289,15 @@ var ServerStore = class extends EventTarget {
         });
       }
     }
-    if (!(0, import_node_fs9.existsSync)(this.artifactsDir)) {
+    if (!(0, import_node_fs11.existsSync)(this.artifactsDir)) {
       return;
     }
-    for (const file2 of (0, import_node_fs9.readdirSync)(this.artifactsDir)) {
+    for (const file2 of (0, import_node_fs11.readdirSync)(this.artifactsDir)) {
       if (!file2.endsWith(JSON_FILE_SUFFIX)) {
         continue;
       }
       const id = file2.slice(0, -JSON_FILE_SUFFIX.length);
-      const metadataPath = import_node_path11.default.join(this.artifactsDir, file2);
+      const metadataPath = import_node_path14.default.join(this.artifactsDir, file2);
       const metadata = this.readArtifactFile(metadataPath, id);
       this._artifacts.set(id, metadata);
       this.startWatchingArtifactContent(metadata);
@@ -52357,20 +53466,20 @@ var ServerStore = class extends EventTarget {
    * without statting.
    */
   normalizeArtifactPath(artifactPath) {
-    if (!import_node_path11.default.isAbsolute(artifactPath)) {
+    if (!import_node_path14.default.isAbsolute(artifactPath)) {
       throw new InvalidRequestError("path must be absolute");
     }
     const stripped = stripTrailingSeparators(artifactPath);
     let stat;
     try {
-      (0, import_node_fs9.accessSync)(stripped, import_node_fs9.constants.R_OK);
-      stat = (0, import_node_fs9.statSync)(stripped);
+      (0, import_node_fs11.accessSync)(stripped, import_node_fs11.constants.R_OK);
+      stat = (0, import_node_fs11.statSync)(stripped);
     } catch {
       throw new InvalidRequestError(`path does not exist or is not readable: ${artifactPath}`);
     }
     if (stat.isDirectory()) {
-      const canonical = hasTrailingSeparator(stripped) ? stripped : `${stripped}${import_node_path11.default.sep}`;
-      if (!DIRECTORY_INDEX_BASENAMES.some((basename) => (0, import_node_fs9.existsSync)(import_node_path11.default.join(canonical, basename)))) {
+      const canonical = hasTrailingSeparator(stripped) ? stripped : `${stripped}${import_node_path14.default.sep}`;
+      if (!DIRECTORY_INDEX_BASENAMES.some((basename) => (0, import_node_fs11.existsSync)(import_node_path14.default.join(canonical, basename)))) {
         throw new InvalidRequestError(`directory artifact must contain index.html or index.htm: ${canonical}`);
       }
       return canonical;
@@ -52384,11 +53493,11 @@ var ServerStore = class extends EventTarget {
     return stripped;
   }
   canInstallOnboardingArtifact() {
-    return !(0, import_node_fs9.existsSync)(getOnboardingArtifactSentinelPath(this.storagePath)) && !this._artifacts.has(ONBOARDING_ARTIFACT_ID) && this.onboardingArtifactSourcePath !== void 0;
+    return !(0, import_node_fs11.existsSync)(getOnboardingArtifactSentinelPath(this.storagePath)) && !this._artifacts.has(ONBOARDING_ARTIFACT_ID) && this.onboardingArtifactSourcePath !== void 0;
   }
   installOnboardingArtifactIfNeeded() {
     try {
-      if ((0, import_node_fs9.existsSync)(getOnboardingArtifactSentinelPath(this.storagePath))) {
+      if ((0, import_node_fs11.existsSync)(getOnboardingArtifactSentinelPath(this.storagePath))) {
         return;
       }
       if (this._artifacts.has(ONBOARDING_ARTIFACT_ID)) {
@@ -52400,9 +53509,9 @@ var ServerStore = class extends EventTarget {
         return;
       }
       const screenID = this.resolveActiveScreenID(this.activeScreenID) ?? this.pickPreferredScreenID();
-      const onboardingPath = import_node_path11.default.join(getAgentArtifactsDir(this.storagePath), ONBOARDING_ARTIFACT_DIRNAME) + import_node_path11.default.sep;
-      if (!(0, import_node_fs9.existsSync)(onboardingPath)) {
-        (0, import_node_fs9.cpSync)(this.onboardingArtifactSourcePath, onboardingPath, { recursive: true });
+      const onboardingPath = import_node_path14.default.join(getAgentArtifactsDir(this.storagePath), ONBOARDING_ARTIFACT_DIRNAME) + import_node_path14.default.sep;
+      if (!(0, import_node_fs11.existsSync)(onboardingPath)) {
+        (0, import_node_fs11.cpSync)(this.onboardingArtifactSourcePath, onboardingPath, { recursive: true });
       }
       this.createArtifact({
         id: ONBOARDING_ARTIFACT_ID,
@@ -52418,7 +53527,7 @@ var ServerStore = class extends EventTarget {
     }
   }
   writeOnboardingArtifactSentinel() {
-    (0, import_node_fs9.writeFileSync)(
+    (0, import_node_fs11.writeFileSync)(
       getOnboardingArtifactSentinelPath(this.storagePath),
       JSON.stringify({
         version: ONBOARDING_ARTIFACT_SENTINEL_VERSION,
@@ -52436,11 +53545,11 @@ var ServerStore = class extends EventTarget {
     this.persistDisplayState();
   }
   ensureDirectories() {
-    (0, import_node_fs9.mkdirSync)(import_node_path11.default.join(this.storagePath, "state"), { recursive: true });
-    (0, import_node_fs9.mkdirSync)(this.screensDir, { recursive: true });
-    (0, import_node_fs9.mkdirSync)(this.artifactsDir, { recursive: true });
-    (0, import_node_fs9.mkdirSync)(getThemesDir(this.storagePath), { recursive: true });
-    (0, import_node_fs9.mkdirSync)(getAgentArtifactsDir(this.storagePath), { recursive: true });
+    (0, import_node_fs11.mkdirSync)(import_node_path14.default.join(this.storagePath, "state"), { recursive: true });
+    (0, import_node_fs11.mkdirSync)(this.screensDir, { recursive: true });
+    (0, import_node_fs11.mkdirSync)(this.artifactsDir, { recursive: true });
+    (0, import_node_fs11.mkdirSync)(getThemesDir(this.storagePath), { recursive: true });
+    (0, import_node_fs11.mkdirSync)(getAgentArtifactsDir(this.storagePath), { recursive: true });
   }
   rebuildArtifactScreens() {
     this.artifactScreens.clear();
@@ -52459,12 +53568,12 @@ var ServerStore = class extends EventTarget {
     }
   }
   loadDisplayState() {
-    if (!(0, import_node_fs9.existsSync)(this.displayStatePath)) {
+    if (!(0, import_node_fs11.existsSync)(this.displayStatePath)) {
       return false;
     }
     let raw;
     try {
-      raw = (0, import_node_fs9.readFileSync)(this.displayStatePath, "utf8");
+      raw = (0, import_node_fs11.readFileSync)(this.displayStatePath, "utf8");
     } catch {
       return false;
     }
@@ -52482,7 +53591,7 @@ var ServerStore = class extends EventTarget {
     return false;
   }
   persistDisplayState() {
-    (0, import_node_fs9.writeFileSync)(
+    (0, import_node_fs11.writeFileSync)(
       this.displayStatePath,
       JSON.stringify(this.getDisplayState(), null, JSON_INDENT_SPACES)
     );
@@ -52504,11 +53613,11 @@ var ServerStore = class extends EventTarget {
     return firstScreen.id;
   }
   loadOrCreateAuthToken() {
-    if ((0, import_node_fs9.existsSync)(this.tokenPath)) {
-      return (0, import_node_fs9.readFileSync)(this.tokenPath, "utf8").trim();
+    if ((0, import_node_fs11.existsSync)(this.tokenPath)) {
+      return (0, import_node_fs11.readFileSync)(this.tokenPath, "utf8").trim();
     }
     const token = createToken();
-    (0, import_node_fs9.writeFileSync)(this.tokenPath, `${token}
+    (0, import_node_fs11.writeFileSync)(this.tokenPath, `${token}
 `);
     return token;
   }
@@ -52516,12 +53625,12 @@ var ServerStore = class extends EventTarget {
     if (!this.screens.has(screen.id)) {
       throw new Error(`Cannot persist screen ${screen.id}: not in live map`);
     }
-    (0, import_node_fs9.writeFileSync)(import_node_path11.default.join(this.screensDir, `${screen.id}.json`), JSON.stringify(screen, null, JSON_INDENT_SPACES));
+    (0, import_node_fs11.writeFileSync)(import_node_path14.default.join(this.screensDir, `${screen.id}.json`), JSON.stringify(screen, null, JSON_INDENT_SPACES));
   }
   readArtifactFile(filePath, expectedID) {
     let raw;
     try {
-      raw = (0, import_node_fs9.readFileSync)(filePath, "utf8");
+      raw = (0, import_node_fs11.readFileSync)(filePath, "utf8");
     } catch (error48) {
       throw this.invalidMetadataFile(filePath, "unreadable", error48);
     }
@@ -52543,7 +53652,7 @@ var ServerStore = class extends EventTarget {
         `id ${result.data.id} does not match filename ${expectedID}`
       );
     }
-    if (result.data.kind === "path" && !import_node_path11.default.isAbsolute(result.data.path)) {
+    if (result.data.kind === "path" && !import_node_path14.default.isAbsolute(result.data.path)) {
       throw this.invalidMetadataFile(filePath, "path must be absolute");
     }
     return result.data;
@@ -52560,7 +53669,7 @@ Review docs/storage.md for the current schema, and either update the file to mat
     return cause !== void 0 ? new Error(message, { cause }) : new Error(message);
   }
   writeArtifact(artifact) {
-    (0, import_node_fs9.writeFileSync)(getArtifactLiveMetadataPath(this.storagePath, artifact.id), JSON.stringify(artifact, null, JSON_INDENT_SPACES));
+    (0, import_node_fs11.writeFileSync)(getArtifactLiveMetadataPath(this.storagePath, artifact.id), JSON.stringify(artifact, null, JSON_INDENT_SPACES));
   }
   get screensDir() {
     return getScreensDir(this.storagePath);
@@ -52596,8 +53705,10 @@ function collectLayoutArtifactIDs(node) {
 }
 
 // src/index.ts
-var import_meta2 = {};
+var import_meta3 = {};
 var DAEMON_NAME = "com.television.server";
+var TELEMETRY_LAUNCH_MODE_ENV = "TELEVISION_LAUNCH_MODE";
+var SKILL_INSTALL_TELEMETRY_TIMEOUT_MS2 = 1e3;
 var MAX_PORT = 65535;
 var HTTP_UNAUTHORIZED_STATUS2 = 401;
 var HELP_POINTER = "Television ships bundled skills. The main skill is `television` \u2014 keep its guidance available for screens, lifecycle, the `tv` CLI, and artifact workflow. Re-read it only if it is not already in context or you know the installed skill changed. Additional `tv-*` skills cover specialized artifact types and theming. Install all bundled skills with `tv skills install <path>` (e.g. ~/.openclaw/skills) or `tv skills install -i`.";
@@ -52623,6 +53734,23 @@ function writeConnectURLs(output, urls, options = {}) {
     writeLine(output, `  ${terminalHyperlink(connectURL)}`);
   }
 }
+async function bestEffortWithinTimeout2(operation, timeoutMs) {
+  void operation.catch(() => {
+  });
+  return await new Promise((resolve) => {
+    const timeout = setTimeout(() => resolve(null), timeoutMs);
+    operation.then(
+      (value) => {
+        clearTimeout(timeout);
+        resolve(value);
+      },
+      () => {
+        clearTimeout(timeout);
+        resolve(null);
+      }
+    );
+  });
+}
 function ensureHelpPointer(message) {
   return message.includes(HELP_POINTER) ? message : `${message}
 ${HELP_POINTER}`;
@@ -52631,24 +53759,36 @@ function createDirectiveError(message) {
   return new CLIDirectiveError(ensureHelpPointer(message));
 }
 function getDevPackageDir() {
-  return import_node_path12.default.resolve(import_node_path12.default.dirname((0, import_node_url2.fileURLToPath)(import_meta2.url)), "..");
+  return import_node_path15.default.resolve(import_node_path15.default.dirname((0, import_node_url3.fileURLToPath)(import_meta3.url)), "..");
 }
 function resolveVercelSkillsInstallerBin() {
   if (typeof require === "function" && typeof require.resolve === "function") {
     return require.resolve("skills/bin/cli.mjs");
   }
-  const localRequire = (0, import_node_module.createRequire)(import_node_path12.default.join(getDevPackageDir(), "package.json"));
+  const localRequire = (0, import_node_module.createRequire)(import_node_path15.default.join(getDevPackageDir(), "package.json"));
   return localRequire.resolve("skills/bin/cli.mjs");
 }
 function readCLIVersion() {
-  if ("0.1.170".length > 0) {
-    return "0.1.170";
+  if ("0.1.171".length > 0) {
+    return "0.1.171";
   }
-  const devPackageJsonPath = import_node_path12.default.join(getDevPackageDir(), "package.json");
-  if (!(0, import_node_fs10.existsSync)(devPackageJsonPath)) {
+  const devPackageJsonPath = import_node_path15.default.join(getDevPackageDir(), "package.json");
+  if (!(0, import_node_fs12.existsSync)(devPackageJsonPath)) {
     throw new Error("Could not resolve package.json for repo-local CLI version.");
   }
-  return JSON.parse((0, import_node_fs10.readFileSync)(devPackageJsonPath, "utf8")).version;
+  return JSON.parse((0, import_node_fs12.readFileSync)(devPackageJsonPath, "utf8")).version;
+}
+function inspectTelemetryBuildConfig(env = {}, options = {}) {
+  const project = resolvePostHogProject(env, options);
+  return {
+    telemetryBuild: true ? "production" : null,
+    telemetrySuppressionReason: telemetryEnvironmentSuppressionReason(env),
+    posthogProject: {
+      projectId: project.projectId,
+      projectToken: project.projectToken,
+      ingestionHost: project.ingestionHost
+    }
+  };
 }
 var FRONTMATTER_DELIMITER = "---\n";
 var FRONTMATTER_DELIMITER_LENGTH = FRONTMATTER_DELIMITER.length;
@@ -52701,7 +53841,7 @@ function formatCLIError(error48, argv = []) {
     const status = typeof error48.status === "number" ? Number(error48.status) : void 0;
     if (status === HTTP_UNAUTHORIZED_STATUS2) {
       return ensureHelpPointer(
-        `Television server at ${serverURL} rejected the request as unauthorized. Check the token in ${import_node_path12.default.join(storagePathFromArgv(argv) ?? getTelevisionStoragePath(), "state", "token")}.`
+        `Television server at ${serverURL} rejected the request as unauthorized. Check the token in ${import_node_path15.default.join(storagePathFromArgv(argv) ?? getTelevisionStoragePath(), "state", "token")}.`
       );
     }
     if (status !== void 0) {
@@ -52744,63 +53884,63 @@ function resolveStaticDir() {
   if (!process.argv[1]) {
     return void 0;
   }
-  const entryDir = import_node_path12.default.dirname((0, import_node_fs10.realpathSync)(process.argv[1]));
-  const resolved = import_node_path12.default.resolve(entryDir, "./web");
-  return (0, import_node_fs10.existsSync)(import_node_path12.default.join(resolved, "index.html")) ? resolved : void 0;
+  const entryDir = import_node_path15.default.dirname((0, import_node_fs12.realpathSync)(process.argv[1]));
+  const resolved = import_node_path15.default.resolve(entryDir, "./web");
+  return (0, import_node_fs12.existsSync)(import_node_path15.default.join(resolved, "index.html")) ? resolved : void 0;
 }
 function resolveBundledViewsPath() {
   if (process.argv[1]) {
-    const entryDir = import_node_path12.default.dirname((0, import_node_fs10.realpathSync)(process.argv[1]));
-    const resolved = import_node_path12.default.resolve(entryDir, "./views");
-    return (0, import_node_fs10.existsSync)(resolved) ? resolved : void 0;
+    const entryDir = import_node_path15.default.dirname((0, import_node_fs12.realpathSync)(process.argv[1]));
+    const resolved = import_node_path15.default.resolve(entryDir, "./views");
+    return (0, import_node_fs12.existsSync)(resolved) ? resolved : void 0;
   }
-  const devViewsPath = import_node_path12.default.join(getDevPackageDir(), "dist/views");
-  return (0, import_node_fs10.existsSync)(devViewsPath) ? devViewsPath : void 0;
+  const devViewsPath = import_node_path15.default.join(getDevPackageDir(), "dist/views");
+  return (0, import_node_fs12.existsSync)(devViewsPath) ? devViewsPath : void 0;
 }
 function resolveCanonicalDir() {
   if (process.argv[1]) {
-    const entryDir = import_node_path12.default.dirname((0, import_node_fs10.realpathSync)(process.argv[1]));
-    const resolved = import_node_path12.default.resolve(entryDir, "./canonical/v1");
-    return (0, import_node_fs10.existsSync)(resolved) ? resolved : void 0;
+    const entryDir = import_node_path15.default.dirname((0, import_node_fs12.realpathSync)(process.argv[1]));
+    const resolved = import_node_path15.default.resolve(entryDir, "./canonical/v1");
+    return (0, import_node_fs12.existsSync)(resolved) ? resolved : void 0;
   }
-  const devCanonicalPath = import_node_path12.default.resolve(
+  const devCanonicalPath = import_node_path15.default.resolve(
     getDevPackageDir(),
     "../server/dist/canonical/v1"
   );
-  return (0, import_node_fs10.existsSync)(devCanonicalPath) ? devCanonicalPath : void 0;
+  return (0, import_node_fs12.existsSync)(devCanonicalPath) ? devCanonicalPath : void 0;
 }
 function resolveOnboardingArtifactSourcePath() {
   if (process.argv[1]) {
-    const entryDir = import_node_path12.default.dirname((0, import_node_fs10.realpathSync)(process.argv[1]));
-    const resolved = import_node_path12.default.resolve(entryDir, "./onboarding/television-onboarding");
-    return (0, import_node_fs10.existsSync)(resolved) ? resolved : void 0;
+    const entryDir = import_node_path15.default.dirname((0, import_node_fs12.realpathSync)(process.argv[1]));
+    const resolved = import_node_path15.default.resolve(entryDir, "./onboarding/television-onboarding");
+    return (0, import_node_fs12.existsSync)(resolved) ? resolved : void 0;
   }
-  const devPath = import_node_path12.default.resolve(
+  const devPath = import_node_path15.default.resolve(
     getDevPackageDir(),
     "../server/assets/television-onboarding"
   );
-  return (0, import_node_fs10.existsSync)(devPath) ? devPath : void 0;
+  return (0, import_node_fs12.existsSync)(devPath) ? devPath : void 0;
 }
 function resolveBundledSkillsRoot() {
-  const builtPath = typeof process.argv[1] === "string" ? import_node_path12.default.resolve(import_node_path12.default.dirname((0, import_node_fs10.realpathSync)(process.argv[1])), "./skills") : void 0;
-  if (builtPath && (0, import_node_fs10.existsSync)(builtPath)) {
+  const builtPath = typeof process.argv[1] === "string" ? import_node_path15.default.resolve(import_node_path15.default.dirname((0, import_node_fs12.realpathSync)(process.argv[1])), "./skills") : void 0;
+  if (builtPath && (0, import_node_fs12.existsSync)(builtPath)) {
     return builtPath;
   }
-  const devPath = import_node_path12.default.resolve(getDevPackageDir(), "../skills/dist");
-  return (0, import_node_fs10.existsSync)(devPath) ? devPath : void 0;
+  const devPath = import_node_path15.default.resolve(getDevPackageDir(), "../skills/dist");
+  return (0, import_node_fs12.existsSync)(devPath) ? devPath : void 0;
 }
 function copyBundledSkillsToDestination(bundledSkillsRoot, destinationRoot) {
-  if ((0, import_node_fs10.existsSync)(destinationRoot) && !(0, import_node_fs10.statSync)(destinationRoot).isDirectory()) {
+  if ((0, import_node_fs12.existsSync)(destinationRoot) && !(0, import_node_fs12.statSync)(destinationRoot).isDirectory()) {
     throw new Error(`Skills destination is not a directory: ${destinationRoot}`);
   }
-  (0, import_node_fs10.mkdirSync)(destinationRoot, { recursive: true });
+  (0, import_node_fs12.mkdirSync)(destinationRoot, { recursive: true });
   const copied = [];
-  const entries = (0, import_node_fs10.readdirSync)(bundledSkillsRoot, { withFileTypes: true }).filter((entry) => entry.isDirectory()).sort((a, b2) => a.name.localeCompare(b2.name));
+  const entries = (0, import_node_fs12.readdirSync)(bundledSkillsRoot, { withFileTypes: true }).filter((entry) => entry.isDirectory()).sort((a, b2) => a.name.localeCompare(b2.name));
   for (const entry of entries) {
-    const sourcePath = import_node_path12.default.join(bundledSkillsRoot, entry.name);
-    const destinationPath = import_node_path12.default.join(destinationRoot, entry.name);
-    (0, import_node_fs10.rmSync)(destinationPath, { recursive: true, force: true });
-    (0, import_node_fs10.cpSync)(sourcePath, destinationPath, { recursive: true });
+    const sourcePath = import_node_path15.default.join(bundledSkillsRoot, entry.name);
+    const destinationPath = import_node_path15.default.join(destinationRoot, entry.name);
+    (0, import_node_fs12.rmSync)(destinationPath, { recursive: true, force: true });
+    (0, import_node_fs12.cpSync)(sourcePath, destinationPath, { recursive: true });
     copied.push({ name: entry.name, sourcePath, destinationPath });
   }
   return copied;
@@ -52882,11 +54022,11 @@ function formatCommanderError(argv, error48) {
   return null;
 }
 function readAuthToken(storagePath) {
-  const tokenPath = import_node_path12.default.join(storagePath, "state", "token");
-  if (!(0, import_node_fs10.existsSync)(tokenPath)) {
+  const tokenPath = import_node_path15.default.join(storagePath, "state", "token");
+  if (!(0, import_node_fs12.existsSync)(tokenPath)) {
     return void 0;
   }
-  const token = (0, import_node_fs10.readFileSync)(tokenPath, "utf8").trim();
+  const token = (0, import_node_fs12.readFileSync)(tokenPath, "utf8").trim();
   return token.length > 0 ? token : void 0;
 }
 function readOrCreateAuthToken(storagePath) {
@@ -52904,6 +54044,7 @@ function buildDaemonServeArgs(options = {}) {
   if (options.auth === false) args.push("--no-auth");
   if (options.port !== void 0) args.push("--port", String(options.port));
   if (options.storagePath) args.push("--storage-path", options.storagePath);
+  if (options.installedByAgent) args.push("--installed-by-agent", options.installedByAgent);
   return args;
 }
 function redactSensitiveEnv(env) {
@@ -52913,6 +54054,9 @@ function redactSensitiveEnv(env) {
   }
   return redacted;
 }
+function resolveTelemetryLaunchMode(env) {
+  return env[TELEMETRY_LAUNCH_MODE_ENV] === "daemon" ? "daemon" : "cli";
+}
 function isSensitiveEnvKey(key) {
   const normalized = key.toUpperCase();
   return normalized.startsWith("OPENCLAW_") || normalized.startsWith("HERMES_") || normalized.endsWith("_API_KEY") || normalized.endsWith("_TOKEN") || normalized.endsWith("_SECRET") || normalized.endsWith("_PASSWORD");
@@ -52934,7 +54078,11 @@ function createEnvironment(environment) {
       auth: options.auth,
       staticDir: options.staticDir,
       canonicalDir: options.canonicalDir,
-      acpProfile: options.acpProfile
+      acpProfile: options.acpProfile,
+      telemetry: {
+        launchMode: options.launchMode ?? "cli",
+        installedByAgent: options.installedByAgent ?? null
+      }
     })),
     createDaemon: environment.createDaemon ?? ((options = {}) => {
       const args = buildDaemonServeArgs(options);
@@ -52951,6 +54099,7 @@ function createEnvironment(environment) {
     resolveBundledViewsPath: environment.resolveBundledViewsPath ?? (() => resolveBundledViewsPath()),
     resolveOnboardingArtifactSourcePath: environment.resolveOnboardingArtifactSourcePath ?? (() => resolveOnboardingArtifactSourcePath()),
     resolveBundledSkillsRoot: environment.resolveBundledSkillsRoot ?? (() => resolveBundledSkillsRoot()),
+    resolveHomeDir: environment.resolveHomeDir ?? (() => import_node_os5.default.homedir()),
     runSkillsInstaller: environment.runSkillsInstaller ?? (async (args) => {
       const vercelSkillsInstallerBin = resolveVercelSkillsInstallerBin();
       const result = (0, import_node_child_process3.spawnSync)(process.execPath, [vercelSkillsInstallerBin, ...args], { stdio: "inherit" });
@@ -52958,6 +54107,7 @@ function createEnvironment(environment) {
         throw new Error(`skills ${args.join(" ")} failed (exit ${result.status ?? "signal"})`);
       }
     }),
+    emitSkillInstalledTelemetry: environment.emitSkillInstalledTelemetry ?? ((options) => emitSkillInstalledTelemetry(options)),
     onSignal: environment.onSignal ?? ((signal, handler) => process.on(signal, handler))
   };
 }
@@ -52972,6 +54122,15 @@ function createProgram(env, argv = []) {
       readAuthToken(resolveClientStoragePath(options.storagePath))
     );
   };
+  const emitSkillInstallTelemetry = async (input) => {
+    await bestEffortWithinTimeout2(env.emitSkillInstalledTelemetry({
+      storagePath: getTelevisionStoragePath(),
+      version: telemetryVersion(readCLIVersion()),
+      agentType: input.agentType,
+      ...input.installedByAgent === void 0 ? {} : { installedByAgent: input.installedByAgent },
+      env: process.env
+    }), SKILL_INSTALL_TELEMETRY_TIMEOUT_MS2);
+  };
   const uninstallPersistedService = async (storagePath) => {
     const daemon = env.createDaemon();
     let outcome = "uninstalled";
@@ -52991,7 +54150,7 @@ function createProgram(env, argv = []) {
     outputError: () => {
     }
   }).exitOverride();
-  program2.command("serve").description("Start the Television server").option("--listen <address>", "Additional IPv4 address to bind to (repeatable or comma-separated)", collectOption, []).option("--auth", "Require bearer-token auth on every listener").option("--no-auth", "Disable bearer-token auth on every listener").option("--port <number>", "Port to listen on", parsePortOption).option("--storage-path <path>", "Directory for persisted screen data").option("--persist", "Install as a persistent system service").option("--persist-uninstall", "Uninstall the persistent system service").action(async (opts) => {
+  program2.command("serve").description("Start the Television server").option("--listen <address>", "Additional IPv4 address to bind to (repeatable or comma-separated)", collectOption, []).option("--auth", "Require bearer-token auth on every listener").option("--no-auth", "Disable bearer-token auth on every listener").option("--port <number>", "Port to listen on", parsePortOption).option("--storage-path <path>", "Directory for persisted screen data").option("--installed-by-agent <agent-runtime-harness-name>", "Agent runtime harness name operating this server").option("--persist", "Install as a persistent system service").option("--persist-uninstall", "Uninstall the persistent system service").action(async (opts) => {
     if (opts.persist && opts.persistUninstall) {
       throw createDirectiveError("Use either `--persist` or `--persist-uninstall`, not both.");
     }
@@ -53011,9 +54170,10 @@ function createProgram(env, argv = []) {
     if (opts.persist) {
       const storagePath = opts.storagePath ?? getTelevisionStoragePath();
       const profile2 = resolveACPAgentProfile(process.env);
-      const daemonEnv = buildPersistedACPEnvironment(process.env);
+      const daemonEnv = buildPersistedACPEnvironment(process.env, { developerHome: env.resolveHomeDir() });
       if (process.env.TELEVISION_PORT !== void 0) daemonEnv.TELEVISION_PORT = process.env.TELEVISION_PORT;
       if (process.env.TELEVISION_STORAGE_PATH !== void 0) daemonEnv.TELEVISION_STORAGE_PATH = process.env.TELEVISION_STORAGE_PATH;
+      daemonEnv[TELEMETRY_LAUNCH_MODE_ENV] = "daemon";
       if (profile2 && !isACPCommandResolvable(profile2.command, daemonEnv)) {
         const error48 = createDirectiveError(
           `Could not find ACP agent command \`${profile2.command}\` for \`TELEVISION_ACP_AGENT=${profile2.agent}\` on the persisted PATH. Set TELEVISION_ACP_AGENT to \`openclaw\` or \`hermes\`, and ensure the selected agent binary is available on PATH before running \`tv serve --persist\`.`
@@ -53026,6 +54186,7 @@ function createProgram(env, argv = []) {
         auth,
         port: opts.port,
         storagePath,
+        ...opts.installedByAgent === void 0 ? {} : { installedByAgent: opts.installedByAgent },
         env: daemonEnv
       };
       const daemon = env.createDaemon(daemonOptions);
@@ -53052,8 +54213,9 @@ function createProgram(env, argv = []) {
         });
         throw error48;
       }
-      const serverURL = buildLocalServerURL(opts.port);
-      writeConnectURLs(env.stdout, [serverURL], {
+      const port = resolveClientPort(opts.port);
+      const serverURLs2 = resolveBindAddresses(opts.listen).map((address) => buildServerURL(address, port));
+      writeConnectURLs(env.stdout, serverURLs2, {
         installed: true,
         token: auth === true ? readOrCreateAuthToken(storagePath) : null
       });
@@ -53076,6 +54238,8 @@ function createProgram(env, argv = []) {
       canonicalDir: env.resolveCanonicalDir(),
       bundledViewsPath: env.resolveBundledViewsPath(),
       onboardingArtifactSourcePath: env.resolveOnboardingArtifactSourcePath(),
+      launchMode: resolveTelemetryLaunchMode(process.env),
+      ...opts.installedByAgent === void 0 ? {} : { installedByAgent: opts.installedByAgent },
       ...profile ? { acpProfile: profile } : {}
     });
     await server.start();
@@ -53252,7 +54416,7 @@ function createProgram(env, argv = []) {
     "Examples: ~/.openclaw/skills, ~/.hermes/skills, ~/.agents/skills.",
     "`tv skills install -i` runs the external skills installer against Television's bundled skills root."
   ].join("\n"));
-  skillsCommand.command("install").description("Copy bundled Television skills into an agent harness skills folder, or run the external installer against the bundled skills root").argument("[path]", "Destination agent skills folder (for example: ~/.openclaw/skills, ~/.hermes/skills, ~/.agents/skills)").option("-i, --interactive", "Run the external skills installer against the bundled Television skills root").allowUnknownOption(true).action(async function(inputPath, opts) {
+  skillsCommand.command("install").description("Copy bundled Television skills into an agent harness skills folder, or run the external installer against the bundled skills root").argument("[path]", "Destination agent skills folder (for example: ~/.openclaw/skills, ~/.hermes/skills, ~/.agents/skills)").option("-i, --interactive", "Run the external skills installer against the bundled Television skills root").option("--installed-by-agent <agent-runtime-harness-name>", "Agent runtime harness name performing this install").allowUnknownOption(true).action(async function(inputPath, opts) {
     const bundledTelevisionSkillsCollectionRoot = env.resolveBundledSkillsRoot();
     if (opts.interactive) {
       if (inputPath) {
@@ -53263,6 +54427,10 @@ function createProgram(env, argv = []) {
       }
       const args = ["add", bundledTelevisionSkillsCollectionRoot];
       await env.runSkillsInstaller(args);
+      await emitSkillInstallTelemetry({
+        agentType: "interactive-install",
+        ...opts.installedByAgent === void 0 ? {} : { installedByAgent: opts.installedByAgent }
+      });
       return;
     }
     if (!inputPath) {
@@ -53273,7 +54441,7 @@ function createProgram(env, argv = []) {
     if (!bundledTelevisionSkillsCollectionRoot) {
       throw new Error("Could not resolve the bundled Television skills root.");
     }
-    const destinationRoot = import_node_path12.default.resolve(inputPath);
+    const destinationRoot = import_node_path15.default.resolve(inputPath);
     const copied = copyBundledSkillsToDestination(bundledTelevisionSkillsCollectionRoot, destinationRoot);
     writeLine(env.stdout, `Copied ${copied.length} bundled Television skill(s):`);
     for (const skill of copied) {
@@ -53281,6 +54449,19 @@ function createProgram(env, argv = []) {
       writeLine(env.stdout, `  from: ${skill.sourcePath}`);
       writeLine(env.stdout, `  to:   ${skill.destinationPath}`);
     }
+    await emitSkillInstallTelemetry({
+      agentType: deriveAgentTypeFromPath(destinationRoot).agent_type,
+      ...opts.installedByAgent === void 0 ? {} : { installedByAgent: opts.installedByAgent }
+    });
+  });
+  const telemetryCommand = program2.command("telemetry").description("Control telemetry for the running Television server");
+  telemetryCommand.command("disable").description("Disable telemetry for the running Television server").option("--port <number>", "Server port", parsePortOption).option("--storage-path <path>", "Directory containing the Television token").action(async (opts) => {
+    const client = createAuthenticatedClient(opts);
+    writeJSON(env.stdout, await client.telemetry.disable());
+  });
+  telemetryCommand.command("enable").description("Enable telemetry for the running Television server").option("--port <number>", "Server port", parsePortOption).option("--storage-path <path>", "Directory containing the Television token").action(async (opts) => {
+    const client = createAuthenticatedClient(opts);
+    writeJSON(env.stdout, await client.telemetry.enable());
   });
   program2.command("stop").description("Stop the Television system service").action(async () => {
     await uninstallPersistedService(getTelevisionStoragePath());
@@ -53297,6 +54478,7 @@ function createProgram(env, argv = []) {
       result.healthy = true;
       result.bindAddresses = health.bindAddresses;
       result.port = health.port;
+      result.telemetry = await client.telemetry.status();
     } catch {
     }
     try {
@@ -53348,6 +54530,7 @@ if (!isVitestRuntime()) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  inspectTelemetryBuildConfig,
   listVisibleCLICommandNames,
   resolveBundledSkillsRoot,
   resolveBundledViewsPath,