@osfactory/har 0.11.0 → 0.12.1

package/dist/index.js

@@ -765,14 +765,14 @@ var require_url_state_machine = __commonJS({
       return url.replace(/\u0009|\u000A|\u000D/g, "");
     }
     function shortenPath(url) {
-      const path41 = url.path;
-      if (path41.length === 0) {
+      const path47 = url.path;
+      if (path47.length === 0) {
         return;
       }
-      if (url.scheme === "file" && path41.length === 1 && isNormalizedWindowsDriveLetter(path41[0])) {
+      if (url.scheme === "file" && path47.length === 1 && isNormalizedWindowsDriveLetter(path47[0])) {
         return;
       }
-      path41.pop();
+      path47.pop();
     }
     function includesCredentials(url) {
       return url.username !== "" || url.password !== "";
@@ -2092,7 +2092,7 @@ var require_lib2 = __commonJS({
       let accum = [];
       let accumBytes = 0;
       let abort = false;
-      return new Body.Promise(function(resolve28, reject) {
+      return new Body.Promise(function(resolve33, reject) {
         let resTimeout;
         if (_this4.timeout) {
           resTimeout = setTimeout(function() {
@@ -2126,7 +2126,7 @@ var require_lib2 = __commonJS({
           }
           clearTimeout(resTimeout);
           try {
-            resolve28(Buffer.concat(accum, accumBytes));
+            resolve33(Buffer.concat(accum, accumBytes));
           } catch (err) {
             reject(new FetchError(`Could not create Buffer from response body for ${_this4.url}: ${err.message}`, "system", err));
           }
@@ -2801,7 +2801,7 @@ var require_lib2 = __commonJS({
         throw new Error("native promise missing, set fetch.Promise to your favorite alternative");
       }
       Body.Promise = fetch3.Promise;
-      return new fetch3.Promise(function(resolve28, reject) {
+      return new fetch3.Promise(function(resolve33, reject) {
         const request = new Request3(url, opts);
         const options = getNodeRequestOptions(request);
         const send = (options.protocol === "https:" ? https : http).request;
@@ -2934,7 +2934,7 @@ var require_lib2 = __commonJS({
                   requestOpts.body = void 0;
                   requestOpts.headers.delete("content-length");
                 }
-                resolve28(fetch3(new Request3(locationURL, requestOpts)));
+                resolve33(fetch3(new Request3(locationURL, requestOpts)));
                 finalize();
                 return;
             }
@@ -2955,7 +2955,7 @@ var require_lib2 = __commonJS({
           const codings = headers.get("Content-Encoding");
           if (!request.compress || request.method === "HEAD" || codings === null || res.statusCode === 204 || res.statusCode === 304) {
             response = new Response3(body, response_options);
-            resolve28(response);
+            resolve33(response);
             return;
           }
           const zlibOptions = {
@@ -2965,7 +2965,7 @@ var require_lib2 = __commonJS({
           if (codings == "gzip" || codings == "x-gzip") {
             body = body.pipe(zlib.createGunzip(zlibOptions));
             response = new Response3(body, response_options);
-            resolve28(response);
+            resolve33(response);
             return;
           }
           if (codings == "deflate" || codings == "x-deflate") {
@@ -2977,12 +2977,12 @@ var require_lib2 = __commonJS({
                 body = body.pipe(zlib.createInflateRaw());
               }
               response = new Response3(body, response_options);
-              resolve28(response);
+              resolve33(response);
             });
             raw.on("end", function() {
               if (!response) {
                 response = new Response3(body, response_options);
-                resolve28(response);
+                resolve33(response);
               }
             });
             return;
@@ -2990,11 +2990,11 @@ var require_lib2 = __commonJS({
           if (codings == "br" && typeof zlib.createBrotliDecompress === "function") {
             body = body.pipe(zlib.createBrotliDecompress());
             response = new Response3(body, response_options);
-            resolve28(response);
+            resolve33(response);
             return;
           }
           response = new Response3(body, response_options);
-          resolve28(response);
+          resolve33(response);
         });
         writeToStream(req, request);
       });
@@ -6351,14 +6351,14 @@ __export(fileFromPath_exports, {
   fileFromPathSync: () => fileFromPathSync,
   isFile: () => isFile
 });
-function createFileFromPath(path41, { mtimeMs, size }, filenameOrOptions, options = {}) {
+function createFileFromPath(path47, { mtimeMs, size }, filenameOrOptions, options = {}) {
   let filename;
   if (isPlainObject_default2(filenameOrOptions)) {
     [options, filename] = [filenameOrOptions, void 0];
   } else {
     filename = filenameOrOptions;
   }
-  const file = new FileFromPath({ path: path41, size, lastModified: mtimeMs });
+  const file = new FileFromPath({ path: path47, size, lastModified: mtimeMs });
   if (!filename) {
     filename = file.name;
   }
@@ -6367,13 +6367,13 @@ function createFileFromPath(path41, { mtimeMs, size }, filenameOrOptions, option
     lastModified: file.lastModified
   });
 }
-function fileFromPathSync(path41, filenameOrOptions, options = {}) {
-  const stats = (0, import_fs5.statSync)(path41);
-  return createFileFromPath(path41, stats, filenameOrOptions, options);
+function fileFromPathSync(path47, filenameOrOptions, options = {}) {
+  const stats = (0, import_fs5.statSync)(path47);
+  return createFileFromPath(path47, stats, filenameOrOptions, options);
 }
-async function fileFromPath2(path41, filenameOrOptions, options) {
-  const stats = await import_fs5.promises.stat(path41);
-  return createFileFromPath(path41, stats, filenameOrOptions, options);
+async function fileFromPath2(path47, filenameOrOptions, options) {
+  const stats = await import_fs5.promises.stat(path47);
+  return createFileFromPath(path47, stats, filenameOrOptions, options);
 }
 var import_fs5, import_path5, import_node_domexception, __classPrivateFieldSet5, __classPrivateFieldGet6, _FileFromPath_path, _FileFromPath_start, MESSAGE, FileFromPath;
 var init_fileFromPath = __esm({
@@ -9384,7 +9384,7 @@ var require_compile = __commonJS({
       const schOrFunc = root.refs[ref];
       if (schOrFunc)
         return schOrFunc;
-      let _sch = resolve28.call(this, root, ref);
+      let _sch = resolve33.call(this, root, ref);
       if (_sch === void 0) {
         const schema = (_a3 = root.localRefs) === null || _a3 === void 0 ? void 0 : _a3[ref];
         const { schemaId } = this.opts;
@@ -9411,7 +9411,7 @@ var require_compile = __commonJS({
     function sameSchemaEnv(s1, s2) {
       return s1.schema === s2.schema && s1.root === s2.root && s1.baseId === s2.baseId;
     }
-    function resolve28(root, ref) {
+    function resolve33(root, ref) {
       let sch;
       while (typeof (sch = this.refs[ref]) == "string")
         ref = sch;
@@ -9629,8 +9629,8 @@ var require_utils2 = __commonJS({
       }
       return ind;
     }
-    function removeDotSegments(path41) {
-      let input = path41;
+    function removeDotSegments(path47) {
+      let input = path47;
       const output = [];
       let nextSlash = -1;
       let len = 0;
@@ -9882,8 +9882,8 @@ var require_schemes = __commonJS({
         wsComponent.secure = void 0;
       }
       if (wsComponent.resourceName) {
-        const [path41, query] = wsComponent.resourceName.split("?");
-        wsComponent.path = path41 && path41 !== "/" ? path41 : void 0;
+        const [path47, query] = wsComponent.resourceName.split("?");
+        wsComponent.path = path47 && path47 !== "/" ? path47 : void 0;
         wsComponent.query = query;
         wsComponent.resourceName = void 0;
       }
@@ -10042,7 +10042,7 @@ var require_fast_uri = __commonJS({
       }
       return uri;
     }
-    function resolve28(baseURI, relativeURI, options) {
+    function resolve33(baseURI, relativeURI, options) {
       const schemelessOptions = options ? Object.assign({ scheme: "null" }, options) : { scheme: "null" };
       const resolved = resolveComponent(parse4(baseURI, schemelessOptions), parse4(relativeURI, schemelessOptions), schemelessOptions, true);
       schemelessOptions.skipEscape = true;
@@ -10300,7 +10300,7 @@ var require_fast_uri = __commonJS({
     var fastUri = {
       SCHEMES,
       normalize: normalize3,
-      resolve: resolve28,
+      resolve: resolve33,
       resolveComponent,
       equal,
       serialize,
@@ -13276,12 +13276,12 @@ var require_dist = __commonJS({
         throw new Error(`Unknown format "${name}"`);
       return f2;
     };
-    function addFormats(ajv, list, fs35, exportName) {
+    function addFormats(ajv, list, fs40, exportName) {
       var _a3;
       var _b2;
       (_a3 = (_b2 = ajv.opts.code).formats) !== null && _a3 !== void 0 ? _a3 : _b2.formats = (0, codegen_1._)`require("ajv-formats/dist/formats").${exportName}`;
       for (const f2 of list)
-        ajv.addFormat(f2, fs35[f2]);
+        ajv.addFormat(f2, fs40[f2]);
     }
     module2.exports = exports2 = formatsPlugin;
     Object.defineProperty(exports2, "__esModule", { value: true });
@@ -14565,11 +14565,11 @@ var parser = new YargsParser({
   resolve: import_path2.resolve,
   // TODO: figure  out a  way to combine ESM and CJS coverage, such  that
   // we can exercise all the lines below:
-  require: (path41) => {
+  require: (path47) => {
     if (typeof require !== "undefined") {
-      return require(path41);
-    } else if (path41.match(/\.json$/)) {
-      return JSON.parse((0, import_fs2.readFileSync)(path41, "utf8"));
+      return require(path47);
+    } else if (path47.match(/\.json$/)) {
+      return JSON.parse((0, import_fs2.readFileSync)(path47, "utf8"));
     } else {
       throw Error("only .json config files are supported in ESM");
     }
@@ -15912,13 +15912,13 @@ function usage(yargs, shim3) {
   };
   self.stringifiedValues = function stringifiedValues(values, separator) {
     let string3 = "";
-    const sep3 = separator || ", ";
+    const sep5 = separator || ", ";
     const array2 = [].concat(values);
     if (!values || !array2.length)
       return string3;
     array2.forEach((value) => {
       if (string3.length)
-        string3 += sep3;
+        string3 += sep5;
       string3 += JSON.stringify(value);
     });
     return string3;
@@ -17095,12 +17095,12 @@ var YargsInstance = class {
   async getCompletion(args, done) {
     argsert("<array> [function]", [args, done], arguments.length);
     if (!done) {
-      return new Promise((resolve28, reject) => {
+      return new Promise((resolve33, reject) => {
         __classPrivateFieldGet(this, _YargsInstance_completion, "f").getCompletion(args, (err, completions) => {
           if (err)
             reject(err);
           else
-            resolve28(completions);
+            resolve33(completions);
         });
       });
     } else {
@@ -19250,8 +19250,8 @@ function getErrorMap() {
 
 // node_modules/zod/v3/helpers/parseUtil.js
 var makeIssue = (params) => {
-  const { data, path: path41, errorMaps, issueData } = params;
-  const fullPath = [...path41, ...issueData.path || []];
+  const { data, path: path47, errorMaps, issueData } = params;
+  const fullPath = [...path47, ...issueData.path || []];
   const fullIssue = {
     ...issueData,
     path: fullPath
@@ -19367,11 +19367,11 @@ var errorUtil;
 
 // node_modules/zod/v3/types.js
 var ParseInputLazyPath = class {
-  constructor(parent, value, path41, key) {
+  constructor(parent, value, path47, key) {
     this._cachedPath = [];
     this.parent = parent;
     this.data = value;
-    this._path = path41;
+    this._path = path47;
     this._key = key;
   }
   get path() {
@@ -23106,6 +23106,29 @@ var ValidationRecordSchema = external_exports.object({
 var SyncValidationsInputSchema = external_exports.object({
   validations: external_exports.array(ValidationRecordSchema)
 });
+var AgentToolSchema = external_exports.enum(["claude_code", "codex"]);
+var UsageSourceSchema = external_exports.enum(["otel", "harvest"]);
+var AgentSessionUsageSchema = external_exports.object({
+  sessionKey: external_exports.string().min(1),
+  agentId: external_exports.number().int().min(HAR_AGENT_SLOT_MIN),
+  agentTool: AgentToolSchema,
+  workDir: external_exports.string().optional(),
+  branch: external_exports.string().optional(),
+  suffix: external_exports.string().optional(),
+  tokensInput: external_exports.number().nonnegative().default(0),
+  tokensOutput: external_exports.number().nonnegative().default(0),
+  tokensCacheRead: external_exports.number().nonnegative().default(0),
+  tokensCacheCreation: external_exports.number().nonnegative().default(0),
+  tokensTotal: external_exports.number().nonnegative().default(0),
+  costUsd: external_exports.number().nonnegative().nullable().optional(),
+  modelBreakdown: external_exports.record(external_exports.unknown()).optional(),
+  sources: external_exports.array(UsageSourceSchema).default([]),
+  firstSeenAt: external_exports.string(),
+  lastSeenAt: external_exports.string()
+});
+var SyncUsageInputSchema = external_exports.object({
+  usage: external_exports.array(AgentSessionUsageSchema)
+});
 
 // src/harness/manifest.ts
 var GENERATOR_VERSION = "0.4.0";
@@ -23371,16 +23394,16 @@ async function handleAgentSkills(options) {
 }
 async function askYesNo(question) {
   const rl = readline.createInterface({ input: process.stdin, output: process.stderr });
-  return new Promise((resolve28) => {
+  return new Promise((resolve33) => {
     process.stderr.write(`${question} `);
     rl.once("line", (answer) => {
       rl.close();
       const trimmed = answer.trim();
       if (trimmed === "") {
-        resolve28(true);
+        resolve33(true);
         return;
       }
-      resolve28(/^y(es)?$/i.test(trimmed));
+      resolve33(/^y(es)?$/i.test(trimmed));
     });
   });
 }
@@ -23459,7 +23482,7 @@ function handleRemove(argv) {
 }
 
 // src/cli/commands/env.ts
-var path34 = __toESM(require("path"));
+var path40 = __toESM(require("path"));
 
 // src/core/harness.ts
 var fs19 = __toESM(require("fs"));
@@ -23965,13 +23988,13 @@ var MultipartBody = class {
 // node_modules/@anthropic-ai/sdk/_shims/node-runtime.mjs
 var import_web = require("node:stream/web");
 var fileFromPathWarned = false;
-async function fileFromPath3(path41, ...args) {
+async function fileFromPath3(path47, ...args) {
   const { fileFromPath: _fileFromPath } = await Promise.resolve().then(() => (init_fileFromPath(), fileFromPath_exports));
   if (!fileFromPathWarned) {
-    console.warn(`fileFromPath is deprecated; use fs.createReadStream(${JSON.stringify(path41)}) instead`);
+    console.warn(`fileFromPath is deprecated; use fs.createReadStream(${JSON.stringify(path47)}) instead`);
     fileFromPathWarned = true;
   }
-  return await _fileFromPath(path41, ...args);
+  return await _fileFromPath(path47, ...args);
 }
 var defaultHttpAgent = new import_agentkeepalive.default({ keepAlive: true, timeout: 5 * 60 * 1e3 });
 var defaultHttpsAgent = new import_agentkeepalive.default.HttpsAgent({ keepAlive: true, timeout: 5 * 60 * 1e3 });
@@ -24467,8 +24490,8 @@ async function defaultParseResponse(props) {
 }
 var APIPromise = class _APIPromise extends Promise {
   constructor(responsePromise, parseResponse = defaultParseResponse) {
-    super((resolve28) => {
-      resolve28(null);
+    super((resolve33) => {
+      resolve33(null);
     });
     this.responsePromise = responsePromise;
     this.parseResponse = parseResponse;
@@ -24568,29 +24591,29 @@ var APIClient = class {
   defaultIdempotencyKey() {
     return `stainless-node-retry-${uuid4()}`;
   }
-  get(path41, opts) {
-    return this.methodRequest("get", path41, opts);
+  get(path47, opts) {
+    return this.methodRequest("get", path47, opts);
   }
-  post(path41, opts) {
-    return this.methodRequest("post", path41, opts);
+  post(path47, opts) {
+    return this.methodRequest("post", path47, opts);
   }
-  patch(path41, opts) {
-    return this.methodRequest("patch", path41, opts);
+  patch(path47, opts) {
+    return this.methodRequest("patch", path47, opts);
   }
-  put(path41, opts) {
-    return this.methodRequest("put", path41, opts);
+  put(path47, opts) {
+    return this.methodRequest("put", path47, opts);
   }
-  delete(path41, opts) {
-    return this.methodRequest("delete", path41, opts);
+  delete(path47, opts) {
+    return this.methodRequest("delete", path47, opts);
   }
-  methodRequest(method, path41, opts) {
+  methodRequest(method, path47, opts) {
     return this.request(Promise.resolve(opts).then(async (opts2) => {
       const body = opts2 && isBlobLike(opts2?.body) ? new DataView(await opts2.body.arrayBuffer()) : opts2?.body instanceof DataView ? opts2.body : opts2?.body instanceof ArrayBuffer ? new DataView(opts2.body) : opts2 && ArrayBuffer.isView(opts2?.body) ? new DataView(opts2.body.buffer) : opts2?.body;
-      return { method, path: path41, ...opts2, body };
+      return { method, path: path47, ...opts2, body };
     }));
   }
-  getAPIList(path41, Page, opts) {
-    return this.requestAPIList(Page, { method: "get", path: path41, ...opts });
+  getAPIList(path47, Page, opts) {
+    return this.requestAPIList(Page, { method: "get", path: path47, ...opts });
   }
   calculateContentLength(body) {
     if (typeof body === "string") {
@@ -24608,10 +24631,10 @@ var APIClient = class {
     return null;
   }
   buildRequest(options) {
-    const { method, path: path41, query, headers = {} } = options;
+    const { method, path: path47, query, headers = {} } = options;
     const body = ArrayBuffer.isView(options.body) || options.__binaryRequest && typeof options.body === "string" ? options.body : isMultipartBody(options.body) ? options.body.body : options.body ? JSON.stringify(options.body, null, 2) : null;
     const contentLength = this.calculateContentLength(body);
-    const url = this.buildURL(path41, query);
+    const url = this.buildURL(path47, query);
     if ("timeout" in options)
       validatePositiveInteger("timeout", options.timeout);
     const timeout = options.timeout ?? this.timeout;
@@ -24720,8 +24743,8 @@ var APIClient = class {
     const request = this.makeRequest(options, null);
     return new PagePromise(this, request, Page);
   }
-  buildURL(path41, query) {
-    const url = isAbsoluteURL(path41) ? new URL(path41) : new URL(this.baseURL + (this.baseURL.endsWith("/") && path41.startsWith("/") ? path41.slice(1) : path41));
+  buildURL(path47, query) {
+    const url = isAbsoluteURL(path47) ? new URL(path47) : new URL(this.baseURL + (this.baseURL.endsWith("/") && path47.startsWith("/") ? path47.slice(1) : path47));
     const defaultQuery = this.defaultQuery();
     if (!isEmptyObj(defaultQuery)) {
       query = { ...defaultQuery, ...query };
@@ -25006,7 +25029,7 @@ var startsWithSchemeRegexp = new RegExp("^(?:[a-z]+:)?//", "i");
 var isAbsoluteURL = (url) => {
   return startsWithSchemeRegexp.test(url);
 };
-var sleep = (ms) => new Promise((resolve28) => setTimeout(resolve28, ms));
+var sleep = (ms) => new Promise((resolve33) => setTimeout(resolve33, ms));
 var validatePositiveInteger = (name, n2) => {
   if (typeof n2 !== "number" || !Number.isInteger(n2)) {
     throw new AnthropicError(`${name} must be an integer`);
@@ -25497,12 +25520,12 @@ var PromptCachingBetaMessageStream = class _PromptCachingBetaMessageStream {
       }
       return this._emit("error", new AnthropicError(String(error3)));
     });
-    __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_connectedPromise, new Promise((resolve28, reject) => {
-      __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_resolveConnectedPromise, resolve28, "f");
+    __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_connectedPromise, new Promise((resolve33, reject) => {
+      __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_resolveConnectedPromise, resolve33, "f");
       __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_rejectConnectedPromise, reject, "f");
     }), "f");
-    __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_endPromise, new Promise((resolve28, reject) => {
-      __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_resolveEndPromise, resolve28, "f");
+    __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_endPromise, new Promise((resolve33, reject) => {
+      __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_resolveEndPromise, resolve33, "f");
       __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_rejectEndPromise, reject, "f");
     }), "f");
     __classPrivateFieldGet8(this, _PromptCachingBetaMessageStream_connectedPromise, "f").catch(() => {
@@ -25631,11 +25654,11 @@ var PromptCachingBetaMessageStream = class _PromptCachingBetaMessageStream {
    *   const message = await stream.emitted('message') // rejects if the stream errors
    */
   emitted(event) {
-    return new Promise((resolve28, reject) => {
+    return new Promise((resolve33, reject) => {
       __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_catchingPromiseCreated, true, "f");
       if (event !== "error")
         this.once("error", reject);
-      this.once(event, resolve28);
+      this.once(event, resolve33);
     });
   }
   async done() {
@@ -25862,7 +25885,7 @@ var PromptCachingBetaMessageStream = class _PromptCachingBetaMessageStream {
           if (done) {
             return { value: void 0, done: true };
           }
-          return new Promise((resolve28, reject) => readQueue.push({ resolve: resolve28, reject })).then((chunk2) => chunk2 ? { value: chunk2, done: false } : { value: void 0, done: true });
+          return new Promise((resolve33, reject) => readQueue.push({ resolve: resolve33, reject })).then((chunk2) => chunk2 ? { value: chunk2, done: false } : { value: void 0, done: true });
         }
         const chunk = pushQueue.shift();
         return { value: chunk, done: false };
@@ -26010,12 +26033,12 @@ var MessageStream = class _MessageStream {
       }
       return this._emit("error", new AnthropicError(String(error3)));
     });
-    __classPrivateFieldSet8(this, _MessageStream_connectedPromise, new Promise((resolve28, reject) => {
-      __classPrivateFieldSet8(this, _MessageStream_resolveConnectedPromise, resolve28, "f");
+    __classPrivateFieldSet8(this, _MessageStream_connectedPromise, new Promise((resolve33, reject) => {
+      __classPrivateFieldSet8(this, _MessageStream_resolveConnectedPromise, resolve33, "f");
       __classPrivateFieldSet8(this, _MessageStream_rejectConnectedPromise, reject, "f");
     }), "f");
-    __classPrivateFieldSet8(this, _MessageStream_endPromise, new Promise((resolve28, reject) => {
-      __classPrivateFieldSet8(this, _MessageStream_resolveEndPromise, resolve28, "f");
+    __classPrivateFieldSet8(this, _MessageStream_endPromise, new Promise((resolve33, reject) => {
+      __classPrivateFieldSet8(this, _MessageStream_resolveEndPromise, resolve33, "f");
       __classPrivateFieldSet8(this, _MessageStream_rejectEndPromise, reject, "f");
     }), "f");
     __classPrivateFieldGet9(this, _MessageStream_connectedPromise, "f").catch(() => {
@@ -26144,11 +26167,11 @@ var MessageStream = class _MessageStream {
    *   const message = await stream.emitted('message') // rejects if the stream errors
    */
   emitted(event) {
-    return new Promise((resolve28, reject) => {
+    return new Promise((resolve33, reject) => {
       __classPrivateFieldSet8(this, _MessageStream_catchingPromiseCreated, true, "f");
       if (event !== "error")
         this.once("error", reject);
-      this.once(event, resolve28);
+      this.once(event, resolve33);
     });
   }
   async done() {
@@ -26375,7 +26398,7 @@ var MessageStream = class _MessageStream {
           if (done) {
             return { value: void 0, done: true };
           }
-          return new Promise((resolve28, reject) => readQueue.push({ resolve: resolve28, reject })).then((chunk2) => chunk2 ? { value: chunk2, done: false } : { value: void 0, done: true });
+          return new Promise((resolve33, reject) => readQueue.push({ resolve: resolve33, reject })).then((chunk2) => chunk2 ? { value: chunk2, done: false } : { value: void 0, done: true });
         }
         const chunk = pushQueue.shift();
         return { value: chunk, done: false };
@@ -26635,11 +26658,11 @@ async function promptApplyAgentMdProposal(repoPath) {
 }
 async function askYesNo2(question) {
   const rl = readline2.createInterface({ input: process.stdin, output: process.stderr });
-  return new Promise((resolve28) => {
+  return new Promise((resolve33) => {
     process.stderr.write(`${question} `);
     rl.once("line", (answer) => {
       rl.close();
-      resolve28(/^y(es)?$/i.test(answer.trim()));
+      resolve33(/^y(es)?$/i.test(answer.trim()));
     });
   });
 }
@@ -26869,7 +26892,7 @@ async function executeAuthoringToolCall(toolName, input, repoPath, harnessDir, c
 }
 async function askUser(question, options) {
   const rl = readline3.createInterface({ input: process.stdin, output: process.stderr });
-  return new Promise((resolve28) => {
+  return new Promise((resolve33) => {
     process.stderr.write("\n");
     process.stderr.write(`\u2753 ${question}
 `);
@@ -26880,7 +26903,7 @@ async function askUser(question, options) {
     process.stderr.write("> ");
     rl.once("line", (answer) => {
       rl.close();
-      resolve28(answer.trim());
+      resolve33(answer.trim());
     });
   });
 }
@@ -27024,7 +27047,7 @@ function runScript(scriptPath, args = [], options = {}) {
 function runScriptCapture(scriptPath, args = [], options = {}) {
   const stream = options.stream ?? false;
   const { stream: _stream, ...spawnOptions } = options;
-  return new Promise((resolve28) => {
+  return new Promise((resolve33) => {
     const proc = (0, import_child_process.spawn)("bash", [scriptPath, ...args], {
       ...spawnOptions,
       stdio: ["inherit", "pipe", "pipe"]
@@ -27039,13 +27062,13 @@ function runScriptCapture(scriptPath, args = [], options = {}) {
       stderr += d2;
       if (stream) process.stderr.write(d2);
     });
-    proc.on("close", (code) => resolve28({ stdout, stderr, code: code ?? 0 }));
+    proc.on("close", (code) => resolve33({ stdout, stderr, code: code ?? 0 }));
   });
 }
 function runShellCommand(command2, options = {}) {
   const stream = options.stream ?? false;
   const { stream: _stream, ...spawnOptions } = options;
-  return new Promise((resolve28) => {
+  return new Promise((resolve33) => {
     const proc = (0, import_child_process.spawn)("bash", ["-lc", command2], {
       ...spawnOptions,
       stdio: ["inherit", "pipe", "pipe"]
@@ -27060,7 +27083,7 @@ function runShellCommand(command2, options = {}) {
       stderr += d2;
       if (stream) process.stderr.write(d2);
     });
-    proc.on("close", (code) => resolve28({ stdout, stderr, code: code ?? 0 }));
+    proc.on("close", (code) => resolve33({ stdout, stderr, code: code ?? 0 }));
   });
 }
 
@@ -28392,16 +28415,16 @@ async function promptScaffoldCursorRule(exists) {
 }
 async function askYesNo3(question) {
   const rl = readline4.createInterface({ input: process.stdin, output: process.stderr });
-  return new Promise((resolve28) => {
+  return new Promise((resolve33) => {
     process.stderr.write(`${question} `);
     rl.once("line", (answer) => {
       rl.close();
       const trimmed = answer.trim();
       if (trimmed === "") {
-        resolve28(true);
+        resolve33(true);
         return;
       }
-      resolve28(/^y(es)?$/i.test(trimmed));
+      resolve33(/^y(es)?$/i.test(trimmed));
     });
   });
 }
@@ -28688,7 +28711,7 @@ var LocalScriptExecutor = class {
 var localScriptExecutor = new LocalScriptExecutor();
 
 // src/core/control-sync.ts
-var path33 = __toESM(require("path"));
+var path37 = __toESM(require("path"));
 
 // src/core/control-config.ts
 var DEFAULT_CONTROL_API_URL = "http://localhost:3847";
@@ -29888,6 +29911,396 @@ function createRemoteExecutor(apiUrl, apiKey) {
   return new RemoteExecutor(url, key);
 }
 
+// src/core/telemetry-config.ts
+var fs33 = __toESM(require("fs"));
+var os9 = __toESM(require("os"));
+var path33 = __toESM(require("path"));
+function getPreferencePath() {
+  if (process.env.HAR_TELEMETRY_CONFIG_PATH) {
+    return path33.resolve(process.env.HAR_TELEMETRY_CONFIG_PATH);
+  }
+  return path33.join(os9.homedir(), ".har", "telemetry.json");
+}
+function parseEnvOverride(raw) {
+  if (raw === void 0 || raw === "") return void 0;
+  const normalized = raw.trim().toLowerCase();
+  if (["0", "false", "off", "no", "disabled"].includes(normalized)) return false;
+  if (["1", "true", "on", "yes", "enabled"].includes(normalized)) return true;
+  return void 0;
+}
+function readTelemetryPreference() {
+  const preferencePath = getPreferencePath();
+  try {
+    if (!fs33.existsSync(preferencePath)) {
+      return { enabled: true };
+    }
+    const parsed = JSON.parse(fs33.readFileSync(preferencePath, "utf8"));
+    return {
+      enabled: parsed.enabled !== false,
+      updatedAt: typeof parsed.updatedAt === "string" ? parsed.updatedAt : void 0
+    };
+  } catch {
+    return { enabled: true };
+  }
+}
+function writeTelemetryPreference(enabled) {
+  const preference = {
+    enabled,
+    updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+  };
+  const preferencePath = getPreferencePath();
+  fs33.mkdirSync(path33.dirname(preferencePath), { recursive: true });
+  fs33.writeFileSync(preferencePath, JSON.stringify(preference, null, 2) + "\n");
+  return preference;
+}
+function isTelemetryEnabled() {
+  const envOverride = parseEnvOverride(process.env.HAR_TELEMETRY);
+  if (envOverride !== void 0) return envOverride;
+  return readTelemetryPreference().enabled;
+}
+function getTelemetryPreferencePath() {
+  return getPreferencePath();
+}
+var TELEMETRY_SIGNALS = [
+  "Claude Code: tokens (input/output/cache) and estimated USD cost via OTEL metrics",
+  "Codex CLI: token usage via OTEL metrics (no native USD; harvest fills gaps)",
+  "Fallback: har control sync harvests local Claude/Codex session files when OTEL is missing"
+];
+
+// src/core/usage-harvest/claude.ts
+var fs35 = __toESM(require("fs"));
+var os10 = __toESM(require("os"));
+var path35 = __toESM(require("path"));
+
+// src/core/telemetry-env.ts
+var fs34 = __toESM(require("fs"));
+var path34 = __toESM(require("path"));
+function escapeAttrValue(value) {
+  return value.replace(/[,=]/g, "_");
+}
+function buildOtelResourceAttributes(attrs) {
+  const parts = [
+    `har.session_key=${escapeAttrValue(attrs.sessionKey)}`,
+    `har.agent_id=${attrs.agentId}`,
+    `har.repo_path=${escapeAttrValue(attrs.repoPath)}`,
+    `har.work_dir=${escapeAttrValue(attrs.workDir)}`
+  ];
+  if (attrs.branch) parts.push(`har.branch=${escapeAttrValue(attrs.branch)}`);
+  if (attrs.suffix) parts.push(`har.suffix=${escapeAttrValue(attrs.suffix)}`);
+  if (attrs.purpose) parts.push(`har.purpose=${escapeAttrValue(attrs.purpose)}`);
+  return parts.join(",");
+}
+function buildSessionKey(input) {
+  if (input.branch) return input.branch;
+  const stamp = (input.createdAt ?? (/* @__PURE__ */ new Date()).toISOString()).replace(/[:.]/g, "-");
+  return `agent-${input.agentId}-${input.suffix ?? stamp}`;
+}
+function buildTelemetryEnvBlock(attrs, options) {
+  const apiUrl = getControlApiUrl().replace(/\/$/, "");
+  const lines = [
+    "",
+    "# HAR session attribution (generated)",
+    `HAR_SESSION_KEY=${attrs.sessionKey}`,
+    `HAR_CONTROL_API_URL=${apiUrl}`,
+    `OTEL_RESOURCE_ATTRIBUTES=${buildOtelResourceAttributes(attrs)}`
+  ];
+  const injectOtel = isTelemetryEnabled() && options?.otelReady !== false;
+  if (injectOtel) {
+    lines.push(
+      "# HAR telemetry \u2192 Mission Control OTLP (disable: har telemetry off)",
+      "CLAUDE_CODE_ENABLE_TELEMETRY=1",
+      "OTEL_METRICS_EXPORTER=otlp",
+      "OTEL_EXPORTER_OTLP_PROTOCOL=http/json",
+      `OTEL_EXPORTER_OTLP_ENDPOINT=${apiUrl}/api/otel`
+    );
+  }
+  return lines.join("\n") + "\n";
+}
+var TELEMETRY_MARKER_START = "# HAR session attribution (generated)";
+var TELEMETRY_MARKER_END = "# end HAR telemetry";
+function appendTelemetryEnvToFile(envFilePath, attrs, options) {
+  const block = buildTelemetryEnvBlock(attrs, options).trimEnd() + `
+${TELEMETRY_MARKER_END}
+`;
+  let existing = "";
+  if (fs34.existsSync(envFilePath)) {
+    existing = fs34.readFileSync(envFilePath, "utf8");
+    const start = existing.indexOf(TELEMETRY_MARKER_START);
+    if (start >= 0) {
+      const end = existing.indexOf(TELEMETRY_MARKER_END, start);
+      if (end >= 0) {
+        existing = existing.slice(0, start).replace(/\n+$/, "\n") + existing.slice(end + TELEMETRY_MARKER_END.length).replace(/^\n+/, "\n");
+      } else {
+        existing = existing.slice(0, start).replace(/\n+$/, "\n");
+      }
+    }
+  }
+  fs34.mkdirSync(path34.dirname(envFilePath), { recursive: true });
+  const combined = (existing.replace(/\n+$/, "\n") + block).replace(/^\n+/, "");
+  fs34.writeFileSync(envFilePath, combined.endsWith("\n") ? combined : combined + "\n");
+}
+function buildCodexOtelSnippet(attrs) {
+  const apiUrl = getControlApiUrl().replace(/\/$/, "");
+  const resource = buildOtelResourceAttributes(attrs);
+  return `# Merge into ~/.codex/config.toml (HAR does not overwrite your config)
+# Generated for session ${attrs.sessionKey}
+
+[otel]
+exporter = "otlp-http"
+endpoint = "${apiUrl}/api/otel"
+metrics_exporter = "otlp-http"
+
+# Optional: set resource attributes via environment when starting Codex:
+# export OTEL_RESOURCE_ATTRIBUTES="${resource}"
+# export HAR_SESSION_KEY="${attrs.sessionKey}"
+`;
+}
+
+// src/core/usage-harvest/claude.ts
+function pathsMatch(candidate, targets) {
+  const norm = path35.resolve(candidate);
+  return targets.some((t2) => {
+    const target = path35.resolve(t2);
+    return norm === target || norm.startsWith(target + path35.sep) || target.startsWith(norm + path35.sep);
+  });
+}
+function claudeProjectsRoot() {
+  return process.env.HAR_CLAUDE_PROJECTS_DIR ? path35.resolve(process.env.HAR_CLAUDE_PROJECTS_DIR) : path35.join(os10.homedir(), ".claude", "projects");
+}
+function encodeClaudeProjectDir(cwd) {
+  return cwd.replace(/[^a-zA-Z0-9]/g, "-");
+}
+function readJsonlRecords(filePath) {
+  if (!fs35.existsSync(filePath)) return [];
+  const lines = fs35.readFileSync(filePath, "utf8").split(/\r?\n/);
+  const out = [];
+  for (const line of lines) {
+    const trimmed = line.trim();
+    if (!trimmed.startsWith("{")) continue;
+    try {
+      out.push(JSON.parse(trimmed));
+    } catch {
+    }
+  }
+  return out;
+}
+function extractClaudeUsageFromRecords(records) {
+  let tokensInput = 0;
+  let tokensOutput = 0;
+  let tokensCacheRead = 0;
+  let tokensCacheCreation = 0;
+  let costUsd = null;
+  for (const record2 of records) {
+    if (!record2 || typeof record2 !== "object") continue;
+    const payload = record2;
+    if (payload.type === "result") {
+      const usage2 = payload.usage ?? {};
+      tokensInput = Number(usage2.input_tokens ?? 0) + Number(usage2.cache_read_input_tokens ?? 0);
+      tokensOutput = Number(usage2.output_tokens ?? 0);
+      tokensCacheRead = Number(usage2.cache_read_input_tokens ?? 0);
+      tokensCacheCreation = Number(usage2.cache_creation_input_tokens ?? 0);
+      if (payload.total_cost_usd != null) costUsd = Number(payload.total_cost_usd);
+    }
+    const nestedUsage = payload.usage ?? payload.message?.usage;
+    if (nestedUsage && payload.type !== "result") {
+      tokensInput += Number(nestedUsage.input_tokens ?? 0);
+      tokensOutput += Number(nestedUsage.output_tokens ?? 0);
+      tokensCacheRead += Number(nestedUsage.cache_read_input_tokens ?? 0);
+      tokensCacheCreation += Number(nestedUsage.cache_creation_input_tokens ?? 0);
+    }
+  }
+  return { tokensInput, tokensOutput, tokensCacheRead, tokensCacheCreation, costUsd };
+}
+function harvestClaudeUsage(slot) {
+  const targets = [slot.workDir, slot.worktreePath].filter(Boolean);
+  if (targets.length === 0) return null;
+  const root = claudeProjectsRoot();
+  if (!fs35.existsSync(root)) return null;
+  const sessionKey = buildSessionKey({
+    branch: slot.branch,
+    agentId: slot.agentId,
+    suffix: slot.suffix,
+    createdAt: slot.sessionCreatedAt
+  });
+  let best = null;
+  let bestMtime = 0;
+  for (const entry of fs35.readdirSync(root, { withFileTypes: true })) {
+    if (!entry.isDirectory()) continue;
+    const projectDir = path35.join(root, entry.name);
+    const encodedHit = targets.some((t2) => entry.name.includes(encodeClaudeProjectDir(t2).slice(0, 40)));
+    for (const file of fs35.readdirSync(projectDir)) {
+      if (!file.endsWith(".jsonl")) continue;
+      const filePath = path35.join(projectDir, file);
+      const stat = fs35.statSync(filePath);
+      const records = readJsonlRecords(filePath);
+      let cwdHit = encodedHit;
+      for (const record2 of records) {
+        if (!record2 || typeof record2 !== "object") continue;
+        const cwd = String(record2.cwd ?? "");
+        if (cwd && pathsMatch(cwd, targets)) {
+          cwdHit = true;
+          break;
+        }
+      }
+      if (!cwdHit) continue;
+      const usage2 = extractClaudeUsageFromRecords(records);
+      if (usage2.tokensInput + usage2.tokensOutput + usage2.tokensCacheRead === 0 && (usage2.costUsd == null || usage2.costUsd === 0)) {
+        continue;
+      }
+      if (stat.mtimeMs >= bestMtime) {
+        bestMtime = stat.mtimeMs;
+        best = usage2;
+      }
+    }
+  }
+  if (!best) return null;
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  const tokensTotal = best.tokensInput + best.tokensOutput + best.tokensCacheRead + best.tokensCacheCreation;
+  return {
+    sessionKey,
+    agentId: slot.agentId,
+    agentTool: "claude_code",
+    workDir: slot.workDir,
+    branch: slot.branch,
+    suffix: slot.suffix,
+    tokensInput: best.tokensInput,
+    tokensOutput: best.tokensOutput,
+    tokensCacheRead: best.tokensCacheRead,
+    tokensCacheCreation: best.tokensCacheCreation,
+    tokensTotal,
+    costUsd: best.costUsd,
+    sources: ["harvest"],
+    firstSeenAt: slot.sessionCreatedAt ?? now,
+    lastSeenAt: now
+  };
+}
+
+// src/core/usage-harvest/codex.ts
+var fs36 = __toESM(require("fs"));
+var os11 = __toESM(require("os"));
+var path36 = __toESM(require("path"));
+function pathsMatch2(candidate, targets) {
+  const norm = path36.resolve(candidate);
+  return targets.some((t2) => {
+    const target = path36.resolve(t2);
+    return norm === target || norm.startsWith(target + path36.sep) || target.startsWith(norm + path36.sep);
+  });
+}
+function codexSessionsRoot() {
+  return process.env.HAR_CODEX_SESSIONS_DIR ? path36.resolve(process.env.HAR_CODEX_SESSIONS_DIR) : path36.join(os11.homedir(), ".codex", "sessions");
+}
+function walkJsonlFiles(dir, out = []) {
+  if (!fs36.existsSync(dir)) return out;
+  for (const entry of fs36.readdirSync(dir, { withFileTypes: true })) {
+    const full = path36.join(dir, entry.name);
+    if (entry.isDirectory()) walkJsonlFiles(full, out);
+    else if (entry.isFile() && entry.name.endsWith(".jsonl")) out.push(full);
+  }
+  return out;
+}
+function readJsonl(filePath) {
+  const lines = fs36.readFileSync(filePath, "utf8").split(/\r?\n/);
+  const out = [];
+  for (const line of lines) {
+    const trimmed = line.trim();
+    if (!trimmed.startsWith("{")) continue;
+    try {
+      out.push(JSON.parse(trimmed));
+    } catch {
+    }
+  }
+  return out;
+}
+function extractCodexTokens(records) {
+  let tokensInput = 0;
+  let tokensOutput = 0;
+  let tokensCacheRead = 0;
+  let cwd;
+  for (const record2 of records) {
+    if (!record2 || typeof record2 !== "object") continue;
+    const payload = record2;
+    if (typeof payload.cwd === "string") cwd = payload.cwd;
+    if (typeof payload.working_directory === "string") {
+      cwd = payload.working_directory;
+    }
+    const usage2 = payload.usage ?? payload.token_usage ?? payload.event?.usage;
+    if (usage2) {
+      tokensInput += Number(
+        usage2.input_tokens ?? usage2.input_token_count ?? usage2.input ?? 0
+      );
+      tokensOutput += Number(
+        usage2.output_tokens ?? usage2.output_token_count ?? usage2.output ?? 0
+      );
+      tokensCacheRead += Number(
+        usage2.cached_input_tokens ?? usage2.cached_token_count ?? usage2.cache_read_input_tokens ?? 0
+      );
+      tokensOutput += Number(usage2.reasoning_tokens ?? usage2.reasoning_token_count ?? 0);
+    }
+    if (payload.type === "response.completed" || payload["event.kind"] === "response.completed") {
+      tokensInput = Math.max(tokensInput, Number(payload.input_token_count ?? 0));
+      tokensOutput = Math.max(tokensOutput, Number(payload.output_token_count ?? 0));
+      tokensCacheRead = Math.max(tokensCacheRead, Number(payload.cached_token_count ?? 0));
+    }
+  }
+  return { tokensInput, tokensOutput, tokensCacheRead, cwd };
+}
+function harvestCodexUsage(slot) {
+  const targets = [slot.workDir, slot.worktreePath].filter(Boolean);
+  if (targets.length === 0) return null;
+  const root = codexSessionsRoot();
+  const files = walkJsonlFiles(root);
+  if (files.length === 0) return null;
+  const sessionKey = buildSessionKey({
+    branch: slot.branch,
+    agentId: slot.agentId,
+    suffix: slot.suffix,
+    createdAt: slot.sessionCreatedAt
+  });
+  let best = null;
+  let bestMtime = 0;
+  for (const file of files) {
+    const records = readJsonl(file);
+    const extracted = extractCodexTokens(records);
+    if (!extracted.cwd || !pathsMatch2(extracted.cwd, targets)) continue;
+    if (extracted.tokensInput + extracted.tokensOutput + extracted.tokensCacheRead === 0) continue;
+    const mtime = fs36.statSync(file).mtimeMs;
+    if (mtime >= bestMtime) {
+      bestMtime = mtime;
+      best = extracted;
+    }
+  }
+  if (!best) return null;
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  const tokensTotal = best.tokensInput + best.tokensOutput + best.tokensCacheRead;
+  return {
+    sessionKey,
+    agentId: slot.agentId,
+    agentTool: "codex",
+    workDir: slot.workDir,
+    branch: slot.branch,
+    suffix: slot.suffix,
+    tokensInput: best.tokensInput,
+    tokensOutput: best.tokensOutput,
+    tokensCacheRead: best.tokensCacheRead,
+    tokensCacheCreation: 0,
+    tokensTotal,
+    costUsd: null,
+    sources: ["harvest"],
+    firstSeenAt: slot.sessionCreatedAt ?? now,
+    lastSeenAt: now
+  };
+}
+
+// src/core/usage-harvest/index.ts
+function harvestUsageForSlot(slot) {
+  const out = [];
+  const claude = harvestClaudeUsage(slot);
+  if (claude) out.push(claude);
+  const codex = harvestCodexUsage(slot);
+  if (codex) out.push(codex);
+  return out;
+}
+
 // src/core/control-sync.ts
 async function postJson(url, body, dryRun) {
   if (dryRun) return null;
@@ -29917,7 +30330,7 @@ async function waitForControlApi(apiUrl = getControlApiUrl(), timeoutMs = 6e4, i
   const deadline = Date.now() + timeoutMs;
   while (Date.now() < deadline) {
     if (await isControlApiReachable(apiUrl)) return true;
-    await new Promise((resolve28) => setTimeout(resolve28, intervalMs));
+    await new Promise((resolve33) => setTimeout(resolve33, intervalMs));
   }
   return false;
 }
@@ -29929,7 +30342,7 @@ async function syncAllKnownReposWithControl(options) {
   }
   const repoPaths = new Set(listRegisteredRepos());
   if (options?.cwd) {
-    const cwd = path33.resolve(options.cwd);
+    const cwd = path37.resolve(options.cwd);
     if (readManifest(cwd)) repoPaths.add(cwd);
   }
   try {
@@ -29937,7 +30350,7 @@ async function syncAllKnownReposWithControl(options) {
     if (listResponse.ok) {
       const repos = await listResponse.json();
       for (const repo of repos) {
-        const resolved = path33.resolve(repo.path);
+        const resolved = path37.resolve(repo.path);
         if (readManifest(resolved)) repoPaths.add(resolved);
       }
     }
@@ -29956,7 +30369,7 @@ async function syncAllKnownReposWithControl(options) {
   return { synced, failed };
 }
 async function registerRepoWithControl(options) {
-  const repoPath = path33.resolve(options.repoPath);
+  const repoPath = path37.resolve(options.repoPath);
   const apiUrl = options.apiUrl ?? getControlApiUrl();
   const manifest = readManifest(repoPath);
   const stagesRegistry = readStageRegistry(repoPath);
@@ -29969,7 +30382,7 @@ async function registerRepoWithControl(options) {
   return postJson(`${apiUrl}/api/repos`, body, options.dryRun);
 }
 async function syncRepoWithControl(options) {
-  const repoPath = path33.resolve(options.repoPath);
+  const repoPath = path37.resolve(options.repoPath);
   const apiUrl = options.apiUrl ?? getControlApiUrl();
   if (options.cloud) {
     const remote = createRemoteExecutor();
@@ -29997,7 +30410,7 @@ async function syncRepoWithControl(options) {
     const listResponse = await fetch(`${apiUrl}/api/repos`);
     if (!listResponse.ok) throw new Error("Failed to list repos from Control API");
     const repos = await listResponse.json();
-    const existing = repos.find((r2) => path33.resolve(r2.path) === repoPath);
+    const existing = repos.find((r2) => path37.resolve(r2.path) === repoPath);
     if (!existing) throw new Error(`Repo not registered: ${repoPath}`);
     await syncRepoRunsAndSlots(apiUrl, existing.id, repoPath, options.dryRun);
     return;
@@ -30016,6 +30429,37 @@ async function syncRepoRunsAndSlots(apiUrl, repoId, repoPath, dryRun) {
     generatedAt: status.generatedAt
   });
   await postJson(`${apiUrl}/api/repos/${repoId}/slots`, slotsBody, dryRun);
+  if (isTelemetryEnabled() && process.env.NODE_ENV !== "test") {
+    try {
+      const usage2 = status.slots.flatMap(
+        (slot) => harvestUsageForSlot({
+          agentId: slot.agentId,
+          workDir: slot.workDir,
+          worktreePath: slot.worktreePath,
+          branch: slot.branch,
+          suffix: slot.suffix,
+          sessionCreatedAt: slot.sessionCreatedAt,
+          repoPath
+        }).map((row) => ({
+          ...row,
+          sessionKey: row.sessionKey || buildSessionKey({
+            branch: slot.branch,
+            agentId: slot.agentId,
+            suffix: slot.suffix,
+            createdAt: slot.sessionCreatedAt
+          })
+        }))
+      );
+      if (usage2.length > 0) {
+        const usageBody = SyncUsageInputSchema.parse({ usage: usage2 });
+        await postJson(`${apiUrl}/api/repos/${repoId}/usage`, usageBody, dryRun);
+      }
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      process.stderr.write(`[har control] usage harvest skipped: ${message}
+`);
+    }
+  }
   const validations = listValidations(resolveHarnessRoot(repoPath));
   if (validations.length > 0) {
     const validationsBody = SyncValidationsInputSchema.parse({ validations });
@@ -30068,7 +30512,199 @@ function checkLaunchGuard2(repoPath, agentId, options = {}) {
   return { allowed: true, slot: occupied.slot, readiness };
 }
 
+// src/core/control-lifecycle.ts
+var import_child_process8 = require("child_process");
+var path38 = __toESM(require("path"));
+
+// src/core/control-image.ts
+var DEFAULT_CONTROL_IMAGE = "theosfactory/har-control";
+function getControlImageName() {
+  return process.env.HAR_CONTROL_IMAGE ?? DEFAULT_CONTROL_IMAGE;
+}
+function getControlImageTag() {
+  return process.env.HAR_CONTROL_IMAGE_TAG ?? getHarPackageVersion();
+}
+function getControlImageRef() {
+  return `${getControlImageName()}:${getControlImageTag()}`;
+}
+function shouldBuildControlLocally() {
+  return process.env.HAR_CONTROL_BUILD === "true";
+}
+
+// src/core/control-lifecycle.ts
+function resolveControlDir() {
+  return path38.resolve(__dirname, "..", "control");
+}
+function resolveControlComposeFiles(options) {
+  const controlDir = resolveControlDir();
+  const files = [path38.join(controlDir, "docker-compose.yml")];
+  if (options?.build ?? shouldBuildControlLocally()) {
+    files.push(path38.join(controlDir, "docker-compose.build.yml"));
+  }
+  return files;
+}
+function buildDockerComposeEnv() {
+  return {
+    ...process.env,
+    HAR_CONTROL_IMAGE: getControlImageName(),
+    HAR_CONTROL_IMAGE_TAG: getControlImageTag()
+  };
+}
+function runDockerCompose(args, options) {
+  const controlDir = resolveControlDir();
+  const composeFiles = resolveControlComposeFiles(options);
+  const composeArgs = composeFiles.flatMap((file) => ["-f", file]);
+  const result = (0, import_child_process8.spawnSync)("docker", ["compose", ...composeArgs, ...args], {
+    cwd: controlDir,
+    stdio: "inherit",
+    env: buildDockerComposeEnv()
+  });
+  if (result.error) {
+    throw result.error;
+  }
+  return result.status ?? 1;
+}
+async function startMissionControl(options) {
+  const build = options.build ?? shouldBuildControlLocally();
+  const imageRef = getControlImageRef();
+  if (!build) {
+    const pullCode = runDockerCompose(["pull"], { build: false });
+    if (pullCode !== 0) {
+      return { code: pullCode, apiUrl: getControlApiUrl(), imageRef };
+    }
+  }
+  const detach = options.detach !== false;
+  const upArgs = detach ? ["up", "-d"] : ["up"];
+  if (build) {
+    upArgs.push("--build");
+  }
+  const code = runDockerCompose(upArgs, { build });
+  return { code, apiUrl: getControlApiUrl(), imageRef };
+}
+async function syncReposAfterControlStart(cwd) {
+  if (!isControlEnabled()) {
+    return { synced: 0, failed: 0, apiReady: false };
+  }
+  const apiUrl = getControlApiUrl();
+  const apiReady = await waitForControlApi(apiUrl);
+  if (!apiReady) {
+    return { synced: 0, failed: 0, apiReady: false };
+  }
+  const { synced, failed } = await syncAllKnownReposWithControl({ apiUrl, cwd });
+  return { synced, failed, apiReady: true };
+}
+async function startControlAndSync(options) {
+  const { code, apiUrl, imageRef } = await startMissionControl({
+    detach: options?.detach,
+    build: options?.build
+  });
+  if (code !== 0) {
+    return { code, apiUrl, imageRef, synced: 0, failed: 0, apiReady: false };
+  }
+  const { synced, failed, apiReady } = await syncReposAfterControlStart(options?.cwd ?? process.cwd());
+  return { code, apiUrl, imageRef, synced, failed, apiReady };
+}
+
+// src/core/telemetry-ensure.ts
+async function ensureTelemetryInfrastructure(options) {
+  const apiUrl = getControlApiUrl();
+  const telemetryEnabled = isTelemetryEnabled();
+  const controlEnabled = isControlEnabled();
+  const startIfNeeded = options?.startIfNeeded !== false;
+  if (!telemetryEnabled) {
+    return {
+      telemetryEnabled: false,
+      controlEnabled,
+      apiUrl,
+      reachable: false,
+      started: false,
+      otelReady: false,
+      message: "Telemetry is off \u2014 Mission Control will not be auto-started. Enable with: har telemetry on"
+    };
+  }
+  if (!controlEnabled) {
+    return {
+      telemetryEnabled: true,
+      controlEnabled: false,
+      apiUrl,
+      reachable: false,
+      started: false,
+      otelReady: false,
+      warning: "Telemetry is on but HAR_CONTROL_DISABLED=true \u2014 cannot start Mission Control. Unset it or run har control up manually."
+    };
+  }
+  if (await isControlApiReachable(apiUrl)) {
+    return {
+      telemetryEnabled: true,
+      controlEnabled: true,
+      apiUrl,
+      reachable: true,
+      started: false,
+      otelReady: true,
+      message: `Telemetry on \u2014 Mission Control reachable at ${apiUrl}`
+    };
+  }
+  if (!startIfNeeded || process.env.NODE_ENV === "test") {
+    return {
+      telemetryEnabled: true,
+      controlEnabled: true,
+      apiUrl,
+      reachable: false,
+      started: false,
+      otelReady: false,
+      warning: `Telemetry on but Mission Control is not reachable at ${apiUrl}. Run: har control up`
+    };
+  }
+  try {
+    const { code } = await startMissionControl({ detach: true });
+    if (code !== 0) {
+      return {
+        telemetryEnabled: true,
+        controlEnabled: true,
+        apiUrl,
+        reachable: false,
+        started: false,
+        otelReady: false,
+        warning: `Telemetry on \u2014 failed to start Mission Control (exit ${code}). OTEL export skipped; harvest may fill gaps later. Fix Docker / run: har control up`
+      };
+    }
+  } catch (err) {
+    const detail = err instanceof Error ? err.message : String(err);
+    return {
+      telemetryEnabled: true,
+      controlEnabled: true,
+      apiUrl,
+      reachable: false,
+      started: false,
+      otelReady: false,
+      warning: `Telemetry on \u2014 could not start Mission Control (${detail}). OTEL export skipped. Run: har control up`
+    };
+  }
+  const ready = await waitForControlApi(apiUrl, 9e4);
+  if (!ready) {
+    return {
+      telemetryEnabled: true,
+      controlEnabled: true,
+      apiUrl,
+      reachable: false,
+      started: true,
+      otelReady: false,
+      warning: `Telemetry on \u2014 started Mission Control but API did not become ready at ${apiUrl}. OTEL export skipped for now.`
+    };
+  }
+  return {
+    telemetryEnabled: true,
+    controlEnabled: true,
+    apiUrl,
+    reachable: true,
+    started: true,
+    otelReady: true,
+    message: `Telemetry on \u2014 started Mission Control at ${apiUrl}`
+  };
+}
+
 // src/core/run-service.ts
+var path39 = __toESM(require("path"));
 function extractShellOutput(result) {
   const stdout = result.logs?.find((log) => log.stream === "stdout")?.content ?? result.logs?.find((log) => !log.stream)?.content ?? "";
   const stderr = result.logs?.find((log) => log.stream === "stderr")?.content ?? "";
@@ -30188,6 +30824,21 @@ var RunService = class {
         } : void 0
       };
     }
+    let telemetryBanner = "";
+    let otelReady = false;
+    if (isTelemetryEnabled() && process.env.NODE_ENV !== "test") {
+      const ensured = await ensureTelemetryInfrastructure({ startIfNeeded: true });
+      otelReady = ensured.otelReady;
+      if (ensured.message) {
+        telemetryBanner += `${ensured.message}
+Usage from Claude Code / Codex will appear under Worktrees. Disable: har telemetry off
+`;
+      }
+      if (ensured.warning) {
+        telemetryBanner += `${ensured.warning}
+`;
+      }
+    }
     const result = await this.runStage({
       repoPath: options.repoPath,
       kind: "launch",
@@ -30211,6 +30862,32 @@ var RunService = class {
         envResult.worktreePath = session.worktreePath;
         envResult.branch = session.branch;
         envResult.previewUrls = envResult.previewUrls ?? session.previewUrls;
+        const sessionKey = buildSessionKey({
+          branch: session.branch,
+          agentId: options.agentId,
+          suffix: session.suffix,
+          createdAt: session.createdAt
+        });
+        const envFile = path39.join(session.workDir, `.env.agent.${options.agentId}`);
+        try {
+          appendTelemetryEnvToFile(
+            envFile,
+            {
+              sessionKey,
+              agentId: options.agentId,
+              repoPath: path39.resolve(options.repoPath),
+              workDir: session.workDir,
+              branch: session.branch,
+              suffix: session.suffix,
+              purpose: session.purpose
+            },
+            { otelReady: otelReady && isTelemetryEnabled() }
+          );
+        } catch {
+        }
+      }
+      if (telemetryBanner) {
+        envResult.stderr = `${telemetryBanner}${envResult.stderr ?? ""}`;
       }
     }
     return envResult;
@@ -30577,7 +31254,7 @@ var envCommand = {
   }
 };
 async function handleInit(argv) {
-  const repoPath = path34.resolve(argv.repo);
+  const repoPath = path40.resolve(argv.repo);
   header("har env init");
   info(`Repository: ${repoPath}`);
   try {
@@ -30636,7 +31313,7 @@ async function handleInit(argv) {
   }
 }
 async function handleMaintain(argv) {
-  const repoPath = path34.resolve(argv.repo);
+  const repoPath = path40.resolve(argv.repo);
   header("har env maintain");
   info(`Repository: ${repoPath}`);
   try {
@@ -30732,7 +31409,7 @@ async function handleAgentMdProposal(repoPath, autoYes) {
   if (autoYes) {
     const proposal = readAgentMdProposal(repoPath);
     if (proposal) {
-      writeFileSafe(path34.join(repoPath, "AGENT.md"), proposal.content);
+      writeFileSafe(path40.join(repoPath, "AGENT.md"), proposal.content);
       clearAgentMdProposal(repoPath);
       info("Applied AGENT.md proposal (--yes)");
     }
@@ -30741,7 +31418,7 @@ async function handleAgentMdProposal(repoPath, autoYes) {
   await promptApplyAgentMdProposal(repoPath);
 }
 async function handleAddStage(argv) {
-  const repoPath = path34.resolve(argv.repo);
+  const repoPath = path40.resolve(argv.repo);
   const available = listStageTemplateIds();
   if (argv.list) {
     for (const id of available) {
@@ -30818,7 +31495,7 @@ async function handleAddStage(argv) {
   }
 }
 async function handlePreflight(argv) {
-  const repo = path34.resolve(argv.repo);
+  const repo = path40.resolve(argv.repo);
   const agentId = validateAgentId(argv.id, repo);
   const result = await preflightEnvironment({
     repoPath: repo,
@@ -30836,7 +31513,7 @@ async function handlePreflight(argv) {
   process.exit(result.code);
 }
 async function handleLaunch(argv) {
-  const repo = path34.resolve(argv.repo);
+  const repo = path40.resolve(argv.repo);
   const agentId = validateAgentId(argv.id, repo);
   let confirmReplace = argv.replace;
   let force = argv.force;
@@ -30848,8 +31525,8 @@ async function handleLaunch(argv) {
         console.error(guard.reason ?? "");
         const readline5 = await import("readline");
         const rl = readline5.createInterface({ input: process.stdin, output: process.stderr });
-        const answer = await new Promise((resolve28) => {
-          rl.question("Replace this slot? [y/N] ", resolve28);
+        const answer = await new Promise((resolve33) => {
+          rl.question("Replace this slot? [y/N] ", resolve33);
         });
         rl.close();
         if (!/^[Yy]$/.test(answer.trim())) {
@@ -30865,8 +31542,8 @@ async function handleLaunch(argv) {
         warn("Worktree has uncommitted changes.");
         const readline5 = await import("readline");
         const rl = readline5.createInterface({ input: process.stdin, output: process.stderr });
-        const answer = await new Promise((resolve28) => {
-          rl.question("Discard uncommitted changes? [y/N] ", resolve28);
+        const answer = await new Promise((resolve33) => {
+          rl.question("Discard uncommitted changes? [y/N] ", resolve33);
         });
         rl.close();
         if (!/^[Yy]$/.test(answer.trim())) {
@@ -30895,6 +31572,13 @@ async function handleLaunch(argv) {
     process.exit(result.code || 2);
   }
   if (result.code === 0 && result.workDir) {
+    if (result.stderr) {
+      for (const line of result.stderr.split("\n").filter(Boolean)) {
+        if (/telemetry|mission control|otel/i.test(line)) {
+          info(line);
+        }
+      }
+    }
     divider();
     success(`Session ready \u2014 make ALL file edits under: ${result.workDir}`);
     if (result.branch) info(`Branch: ${result.branch}`);
@@ -30913,7 +31597,7 @@ async function handleRecover(argv) {
   });
 }
 async function handleVerify(argv) {
-  const repo = path34.resolve(argv.repo);
+  const repo = path40.resolve(argv.repo);
   const agentId = validateAgentId(argv.id, repo);
   const result = await runVerification({
     repoPath: repo,
@@ -30925,7 +31609,7 @@ async function handleVerify(argv) {
   process.exit(result.code);
 }
 async function handleTeardown(argv) {
-  const repo = path34.resolve(argv.repo);
+  const repo = path40.resolve(argv.repo);
   const agentId = validateAgentId(argv.id, repo);
   const result = await teardownEnvironment({
     repoPath: repo,
@@ -30936,7 +31620,7 @@ async function handleTeardown(argv) {
   process.exit(result.code);
 }
 async function handleComplete(argv) {
-  const repo = path34.resolve(argv.repo);
+  const repo = path40.resolve(argv.repo);
   const agentId = validateAgentId(argv.id, repo);
   const result = await completeEnvironment({
     repoPath: repo,
@@ -30957,7 +31641,7 @@ async function handleComplete(argv) {
   process.exit(result.code);
 }
 async function handleStatus(argv) {
-  const repoPath = path34.resolve(argv.repo);
+  const repoPath = path40.resolve(argv.repo);
   if (argv.json) {
     const status = collectEnvironmentStatus(repoPath);
     const output = EnvironmentStatusSchema.parse(status);
@@ -30970,7 +31654,7 @@ async function handleStatus(argv) {
   });
 }
 async function handleRunsList(argv) {
-  const repoPath = path34.resolve(argv.repo);
+  const repoPath = path40.resolve(argv.repo);
   const runs = listRuns(repoPath, { stageId: argv.stage, limit: argv.limit });
   if (argv.json) {
     process.stdout.write(JSON.stringify({ runs }, null, 2) + "\n");
@@ -30987,7 +31671,7 @@ async function handleRunsList(argv) {
   }
 }
 async function handleRunsGet(argv) {
-  const run2 = getRun(path34.resolve(argv.repo), argv.runId);
+  const run2 = getRun(path40.resolve(argv.repo), argv.runId);
   if (!run2) {
     error(`Run not found: ${argv.runId}`);
     process.exit(1);
@@ -31060,102 +31744,7 @@ function printNextSteps(auto2) {
 }
 
 // src/cli/commands/control.ts
-var path36 = __toESM(require("path"));
-
-// src/core/control-lifecycle.ts
-var import_child_process8 = require("child_process");
-var path35 = __toESM(require("path"));
-
-// src/core/control-image.ts
-var DEFAULT_CONTROL_IMAGE = "theosfactory/har-control";
-function getControlImageName() {
-  return process.env.HAR_CONTROL_IMAGE ?? DEFAULT_CONTROL_IMAGE;
-}
-function getControlImageTag() {
-  return process.env.HAR_CONTROL_IMAGE_TAG ?? getHarPackageVersion();
-}
-function getControlImageRef() {
-  return `${getControlImageName()}:${getControlImageTag()}`;
-}
-function shouldBuildControlLocally() {
-  return process.env.HAR_CONTROL_BUILD === "true";
-}
-
-// src/core/control-lifecycle.ts
-function resolveControlDir() {
-  return path35.resolve(__dirname, "..", "control");
-}
-function resolveControlComposeFiles(options) {
-  const controlDir = resolveControlDir();
-  const files = [path35.join(controlDir, "docker-compose.yml")];
-  if (options?.build ?? shouldBuildControlLocally()) {
-    files.push(path35.join(controlDir, "docker-compose.build.yml"));
-  }
-  return files;
-}
-function buildDockerComposeEnv() {
-  return {
-    ...process.env,
-    HAR_CONTROL_IMAGE: getControlImageName(),
-    HAR_CONTROL_IMAGE_TAG: getControlImageTag()
-  };
-}
-function runDockerCompose(args, options) {
-  const controlDir = resolveControlDir();
-  const composeFiles = resolveControlComposeFiles(options);
-  const composeArgs = composeFiles.flatMap((file) => ["-f", file]);
-  const result = (0, import_child_process8.spawnSync)("docker", ["compose", ...composeArgs, ...args], {
-    cwd: controlDir,
-    stdio: "inherit",
-    env: buildDockerComposeEnv()
-  });
-  if (result.error) {
-    throw result.error;
-  }
-  return result.status ?? 1;
-}
-async function startMissionControl(options) {
-  const build = options.build ?? shouldBuildControlLocally();
-  const imageRef = getControlImageRef();
-  if (!build) {
-    const pullCode = runDockerCompose(["pull"], { build: false });
-    if (pullCode !== 0) {
-      return { code: pullCode, apiUrl: getControlApiUrl(), imageRef };
-    }
-  }
-  const detach = options.detach !== false;
-  const upArgs = detach ? ["up", "-d"] : ["up"];
-  if (build) {
-    upArgs.push("--build");
-  }
-  const code = runDockerCompose(upArgs, { build });
-  return { code, apiUrl: getControlApiUrl(), imageRef };
-}
-async function syncReposAfterControlStart(cwd) {
-  if (!isControlEnabled()) {
-    return { synced: 0, failed: 0, apiReady: false };
-  }
-  const apiUrl = getControlApiUrl();
-  const apiReady = await waitForControlApi(apiUrl);
-  if (!apiReady) {
-    return { synced: 0, failed: 0, apiReady: false };
-  }
-  const { synced, failed } = await syncAllKnownReposWithControl({ apiUrl, cwd });
-  return { synced, failed, apiReady: true };
-}
-async function startControlAndSync(options) {
-  const { code, apiUrl, imageRef } = await startMissionControl({
-    detach: options?.detach,
-    build: options?.build
-  });
-  if (code !== 0) {
-    return { code, apiUrl, imageRef, synced: 0, failed: 0, apiReady: false };
-  }
-  const { synced, failed, apiReady } = await syncReposAfterControlStart(options?.cwd ?? process.cwd());
-  return { code, apiUrl, imageRef, synced, failed, apiReady };
-}
-
-// src/cli/commands/control.ts
+var path41 = __toESM(require("path"));
 var controlCommand = {
   command: "control <subcommand>",
   describe: "Mission Control dashboard (local)",
@@ -31258,7 +31847,7 @@ async function handleDown() {
   process.exit(code);
 }
 async function handleRegister(argv) {
-  const repoPath = path36.resolve(argv.repo);
+  const repoPath = path41.resolve(argv.repo);
   header("har control register");
   info(`Repository: ${repoPath}`);
   try {
@@ -31278,7 +31867,7 @@ async function handleRegister(argv) {
   }
 }
 async function handleSync(argv) {
-  const repoPath = path36.resolve(argv.repo);
+  const repoPath = path41.resolve(argv.repo);
   try {
     await syncRepoWithControl({
       repoPath,
@@ -31317,7 +31906,7 @@ async function handleWatch(argv) {
   };
   const tick = async () => {
     if (argv.repo) {
-      await syncOne(path36.resolve(argv.repo));
+      await syncOne(path41.resolve(argv.repo));
       return;
     }
     try {
@@ -31348,12 +31937,12 @@ async function handleLogin(argv) {
 }
 
 // src/cli/commands/hooks.ts
-var path39 = __toESM(require("path"));
+var path44 = __toESM(require("path"));
 
 // src/core/hooks.ts
-var fs33 = __toESM(require("fs"));
-var os9 = __toESM(require("os"));
-var path37 = __toESM(require("path"));
+var fs37 = __toESM(require("fs"));
+var os12 = __toESM(require("os"));
+var path42 = __toESM(require("path"));
 var MARKER_START = "# >>> har commit gate (managed by `har hooks`) >>>";
 var MARKER_END = "# <<< har commit gate <<<";
 var PRE_COMMIT_BLOCK = [
@@ -31378,7 +31967,7 @@ function resolveCheckoutRoot(cwd) {
 function resolveHooksDir(checkoutDir) {
   const hooksPath = tryGit2(checkoutDir, "rev-parse --git-path hooks");
   if (!hooksPath) throw new Error(`Not a git checkout: ${checkoutDir}`);
-  return path37.resolve(checkoutDir, hooksPath);
+  return path42.resolve(checkoutDir, hooksPath);
 }
 function getConfiguredHooksPath(checkoutDir) {
   return tryGit2(checkoutDir, "config core.hooksPath") || void 0;
@@ -31386,9 +31975,9 @@ function getConfiguredHooksPath(checkoutDir) {
 function defaultHarInvocation() {
   const entry = process.argv[1];
   if (entry && entry.endsWith(".js")) {
-    return `"${process.execPath}" "${path37.resolve(entry)}"`;
+    return `"${process.execPath}" "${path42.resolve(entry)}"`;
   }
-  if (entry) return `"${path37.resolve(entry)}"`;
+  if (entry) return `"${path42.resolve(entry)}"`;
   return "har";
 }
 function buildHookScript(harInvocation, subcommand, failOpenNotice) {
@@ -31409,40 +31998,40 @@ exit 0
 `;
 }
 function upsertMarkedBlock(filePath, block) {
-  if (!fs33.existsSync(filePath)) {
-    fs33.writeFileSync(filePath, `#!/bin/sh
+  if (!fs37.existsSync(filePath)) {
+    fs37.writeFileSync(filePath, `#!/bin/sh
 ${block}
 `, { mode: 493 });
     return "created";
   }
-  const content = fs33.readFileSync(filePath, "utf8");
+  const content = fs37.readFileSync(filePath, "utf8");
   if (content.includes(MARKER_START)) {
     const pattern = new RegExp(
       `${escapeRegExp(MARKER_START)}[\\s\\S]*?${escapeRegExp(MARKER_END)}`
     );
-    fs33.writeFileSync(filePath, content.replace(pattern, block));
-    fs33.chmodSync(filePath, 493);
+    fs37.writeFileSync(filePath, content.replace(pattern, block));
+    fs37.chmodSync(filePath, 493);
     return "updated";
   }
   const suffix = content.endsWith("\n") ? "" : "\n";
-  fs33.writeFileSync(filePath, `${content}${suffix}
+  fs37.writeFileSync(filePath, `${content}${suffix}
 ${block}
 `);
-  fs33.chmodSync(filePath, 493);
+  fs37.chmodSync(filePath, 493);
   return "appended";
 }
 function removeMarkedBlock(filePath) {
-  if (!fs33.existsSync(filePath)) return false;
-  const content = fs33.readFileSync(filePath, "utf8");
+  if (!fs37.existsSync(filePath)) return false;
+  const content = fs37.readFileSync(filePath, "utf8");
   if (!content.includes(MARKER_START)) return false;
   const pattern = new RegExp(
     `\\n?${escapeRegExp(MARKER_START)}[\\s\\S]*?${escapeRegExp(MARKER_END)}\\n?`
   );
   const stripped = content.replace(pattern, "\n");
   if (stripped.replace(/^#!\/bin\/sh\n?/, "").trim() === "") {
-    fs33.rmSync(filePath);
+    fs37.rmSync(filePath);
   } else {
-    fs33.writeFileSync(filePath, stripped);
+    fs37.writeFileSync(filePath, stripped);
   }
   return true;
 }
@@ -31464,20 +32053,20 @@ Or re-run with --force to write into that directory anyway.`
     );
   }
   const hooksDir = resolveHooksDir(checkout);
-  fs33.mkdirSync(hooksDir, { recursive: true });
+  fs37.mkdirSync(hooksDir, { recursive: true });
   const invocation = options.harInvocation ?? defaultHarInvocation();
-  fs33.writeFileSync(
-    path37.join(hooksDir, "har-pre-commit"),
+  fs37.writeFileSync(
+    path42.join(hooksDir, "har-pre-commit"),
     buildHookScript(invocation, "check", "har: binary not found; skipping commit gate (reinstall with har hooks install)"),
     { mode: 493 }
   );
-  fs33.writeFileSync(
-    path37.join(hooksDir, "har-post-commit"),
+  fs37.writeFileSync(
+    path42.join(hooksDir, "har-post-commit"),
     buildHookScript(invocation, "record-commit", "har: binary not found; skipping commit association"),
     { mode: 493 }
   );
-  const preCommit = upsertMarkedBlock(path37.join(hooksDir, "pre-commit"), PRE_COMMIT_BLOCK);
-  const postCommit = upsertMarkedBlock(path37.join(hooksDir, "post-commit"), POST_COMMIT_BLOCK);
+  const preCommit = upsertMarkedBlock(path42.join(hooksDir, "pre-commit"), PRE_COMMIT_BLOCK);
+  const postCommit = upsertMarkedBlock(path42.join(hooksDir, "post-commit"), POST_COMMIT_BLOCK);
   ensureValidationsIgnored(checkout);
   return { hooksDir, preCommit, postCommit };
 }
@@ -31486,12 +32075,12 @@ function uninstallHooks(repoPath) {
   if (!checkout) throw new Error(`Not a git repository: ${repoPath}`);
   const hooksDir = resolveHooksDir(checkout);
   let removed = false;
-  removed = removeMarkedBlock(path37.join(hooksDir, "pre-commit")) || removed;
-  removed = removeMarkedBlock(path37.join(hooksDir, "post-commit")) || removed;
+  removed = removeMarkedBlock(path42.join(hooksDir, "pre-commit")) || removed;
+  removed = removeMarkedBlock(path42.join(hooksDir, "post-commit")) || removed;
   for (const file of ["har-pre-commit", "har-post-commit"]) {
-    const full = path37.join(hooksDir, file);
-    if (fs33.existsSync(full)) {
-      fs33.rmSync(full);
+    const full = path42.join(hooksDir, file);
+    if (fs37.existsSync(full)) {
+      fs37.rmSync(full);
       removed = true;
     }
   }
@@ -31508,9 +32097,9 @@ function getCommitGateConfig(checkoutDir) {
 function isAgentWorktree(checkoutDir) {
   const branch = getCurrentBranch(checkoutDir);
   if (branch && /^har-agent-\d+$/.test(branch)) return true;
-  const worktreesRoot = path37.join(os9.homedir(), "worktrees");
-  const resolved = path37.resolve(checkoutDir);
-  return resolved.startsWith(`${worktreesRoot}${path37.sep}`) && /-agent-\d+$/.test(path37.basename(resolved));
+  const worktreesRoot = path42.join(os12.homedir(), "worktrees");
+  const resolved = path42.resolve(checkoutDir);
+  return resolved.startsWith(`${worktreesRoot}${path42.sep}`) && /-agent-\d+$/.test(path42.basename(resolved));
 }
 function resolveEffectiveMode(checkoutDir, gate) {
   if (!gate.enabled) return "off";
@@ -31523,15 +32112,15 @@ function getHooksStatus(repoPath) {
   const hooksDir = resolveHooksDir(checkout);
   const gate = getCommitGateConfig(checkout);
   const hasBlock = (name) => {
-    const file = path37.join(hooksDir, name);
-    return fs33.existsSync(file) && fs33.readFileSync(file, "utf8").includes(MARKER_START);
+    const file = path42.join(hooksDir, name);
+    return fs37.existsSync(file) && fs37.readFileSync(file, "utf8").includes(MARKER_START);
   };
   return {
     checkout,
     hooksDir,
     configuredHooksPath: getConfiguredHooksPath(checkout),
-    preCommitInstalled: hasBlock("pre-commit") && fs33.existsSync(path37.join(hooksDir, "har-pre-commit")),
-    postCommitInstalled: hasBlock("post-commit") && fs33.existsSync(path37.join(hooksDir, "har-post-commit")),
+    preCommitInstalled: hasBlock("pre-commit") && fs37.existsSync(path42.join(hooksDir, "har-pre-commit")),
+    postCommitInstalled: hasBlock("post-commit") && fs37.existsSync(path42.join(hooksDir, "har-post-commit")),
     gate,
     effectiveMode: resolveEffectiveMode(checkout, gate)
   };
@@ -31542,7 +32131,7 @@ function checkCommitGate(cwd) {
   }
   const checkout = resolveCheckoutRoot(cwd);
   if (!checkout) return { exitCode: 0, messages: [] };
-  if (!fs33.existsSync(path37.join(checkout, ".har", "stages.json"))) {
+  if (!fs37.existsSync(path42.join(checkout, ".har", "stages.json"))) {
     return { exitCode: 0, messages: [] };
   }
   const gate = getCommitGateConfig(checkout);
@@ -31613,8 +32202,8 @@ async function recordCommitAssociation(cwd) {
 }
 
 // src/core/claude-hooks.ts
-var fs34 = __toESM(require("fs"));
-var path38 = __toESM(require("path"));
+var fs38 = __toESM(require("fs"));
+var path43 = __toESM(require("path"));
 var CLAUDE_GUARD_RELATIVE_PATH = ".har/hooks/claude-worktree-guard.sh";
 var CLAUDE_SETTINGS_RELATIVE_PATH = ".claude/settings.json";
 var GUARD_MATCHER = "Edit|Write|MultiEdit|NotebookEdit";
@@ -31625,8 +32214,8 @@ function isHarGuardEntry(entry) {
   );
 }
 function readSettings(settingsPath) {
-  if (!fs34.existsSync(settingsPath)) return {};
-  const raw = fs34.readFileSync(settingsPath, "utf8").trim();
+  if (!fs38.existsSync(settingsPath)) return {};
+  const raw = fs38.readFileSync(settingsPath, "utf8").trim();
   if (raw === "") return {};
   const parsed = JSON.parse(raw);
   if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
@@ -31635,19 +32224,19 @@ function readSettings(settingsPath) {
   return parsed;
 }
 function writeSettings(settingsPath, settings) {
-  fs34.mkdirSync(path38.dirname(settingsPath), { recursive: true });
-  fs34.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + "\n");
+  fs38.mkdirSync(path43.dirname(settingsPath), { recursive: true });
+  fs38.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + "\n");
 }
 function installClaudeGuard(repoPath) {
   const templatePath = resolveTemplateFile("claude-worktree-guard.sh.template");
   if (!templatePath) {
     throw new Error("Guard template not found (claude-worktree-guard.sh.template). Run npm run build.");
   }
-  const guardScript = path38.join(repoPath, CLAUDE_GUARD_RELATIVE_PATH);
-  fs34.mkdirSync(path38.dirname(guardScript), { recursive: true });
-  fs34.copyFileSync(templatePath, guardScript);
-  fs34.chmodSync(guardScript, 493);
-  const settingsPath = path38.join(repoPath, CLAUDE_SETTINGS_RELATIVE_PATH);
+  const guardScript = path43.join(repoPath, CLAUDE_GUARD_RELATIVE_PATH);
+  fs38.mkdirSync(path43.dirname(guardScript), { recursive: true });
+  fs38.copyFileSync(templatePath, guardScript);
+  fs38.chmodSync(guardScript, 493);
+  const settingsPath = path43.join(repoPath, CLAUDE_SETTINGS_RELATIVE_PATH);
   const settings = readSettings(settingsPath);
   const hooks = settings.hooks ?? {};
   const preToolUse = (hooks.PreToolUse ?? []).filter((entry) => !isHarGuardEntry(entry));
@@ -31661,15 +32250,15 @@ function installClaudeGuard(repoPath) {
 }
 function uninstallClaudeGuard(repoPath) {
   let removed = false;
-  const guardScript = path38.join(repoPath, CLAUDE_GUARD_RELATIVE_PATH);
-  if (fs34.existsSync(guardScript)) {
-    fs34.rmSync(guardScript);
+  const guardScript = path43.join(repoPath, CLAUDE_GUARD_RELATIVE_PATH);
+  if (fs38.existsSync(guardScript)) {
+    fs38.rmSync(guardScript);
     removed = true;
-    const parent = path38.dirname(guardScript);
-    if (fs34.existsSync(parent) && fs34.readdirSync(parent).length === 0) fs34.rmdirSync(parent);
+    const parent = path43.dirname(guardScript);
+    if (fs38.existsSync(parent) && fs38.readdirSync(parent).length === 0) fs38.rmdirSync(parent);
   }
-  const settingsPath = path38.join(repoPath, CLAUDE_SETTINGS_RELATIVE_PATH);
-  if (fs34.existsSync(settingsPath)) {
+  const settingsPath = path43.join(repoPath, CLAUDE_SETTINGS_RELATIVE_PATH);
+  if (fs38.existsSync(settingsPath)) {
     const settings = readSettings(settingsPath);
     const preToolUse = settings.hooks?.PreToolUse;
     if (preToolUse) {
@@ -31694,8 +32283,8 @@ function uninstallClaudeGuard(repoPath) {
   return { removed };
 }
 function claudeGuardInstalled(repoPath) {
-  const settingsPath = path38.join(repoPath, CLAUDE_SETTINGS_RELATIVE_PATH);
-  if (!fs34.existsSync(settingsPath)) return false;
+  const settingsPath = path43.join(repoPath, CLAUDE_SETTINGS_RELATIVE_PATH);
+  if (!fs38.existsSync(settingsPath)) return false;
   try {
     const settings = readSettings(settingsPath);
     return (settings.hooks?.PreToolUse ?? []).some(isHarGuardEntry);
@@ -31711,7 +32300,7 @@ function repoOption(y2) {
 function handleInstall2(argv) {
   try {
     if (argv.claude) {
-      const result2 = installClaudeGuard(path39.resolve(argv.repo));
+      const result2 = installClaudeGuard(path44.resolve(argv.repo));
       success("Claude Code worktree guard installed.");
       info(`Guard script:  ${result2.guardScript}`);
       info(`Settings:      ${result2.settingsPath} (PreToolUse: Edit|Write|MultiEdit|NotebookEdit)`);
@@ -31719,7 +32308,7 @@ function handleInstall2(argv) {
       info("Commit both files so the guard travels with the repo.");
       return;
     }
-    const result = installHooks({ repoPath: path39.resolve(argv.repo), force: argv.force });
+    const result = installHooks({ repoPath: path44.resolve(argv.repo), force: argv.force });
     success(`Commit gate installed in ${result.hooksDir}`);
     info(`pre-commit: ${result.preCommit}, post-commit: ${result.postCommit}`);
     info("Commits of unverified change batches will be blocked in agent worktrees.");
@@ -31732,7 +32321,7 @@ function handleInstall2(argv) {
 function handleUninstall(argv) {
   try {
     if (argv.claude) {
-      const result2 = uninstallClaudeGuard(path39.resolve(argv.repo));
+      const result2 = uninstallClaudeGuard(path44.resolve(argv.repo));
       if (result2.removed) {
         success("Claude Code worktree guard removed.");
       } else {
@@ -31740,7 +32329,7 @@ function handleUninstall(argv) {
       }
       return;
     }
-    const result = uninstallHooks(path39.resolve(argv.repo));
+    const result = uninstallHooks(path44.resolve(argv.repo));
     if (result.removed) {
       success(`Commit gate removed from ${result.hooksDir}`);
     } else {
@@ -31753,7 +32342,7 @@ function handleUninstall(argv) {
 }
 function handleStatus2(argv) {
   try {
-    const status = getHooksStatus(path39.resolve(argv.repo));
+    const status = getHooksStatus(path44.resolve(argv.repo));
     if (argv.json) {
       process.stdout.write(`${JSON.stringify(status, null, 2)}
 `);
@@ -31771,7 +32360,7 @@ function handleStatus2(argv) {
     );
     info(`Effective:     ${status.effectiveMode} (in this checkout)`);
     info(
-      `Claude guard:  ${claudeGuardInstalled(path39.resolve(argv.repo)) ? `installed (${CLAUDE_GUARD_RELATIVE_PATH})` : "not installed"}`
+      `Claude guard:  ${claudeGuardInstalled(path44.resolve(argv.repo)) ? `installed (${CLAUDE_GUARD_RELATIVE_PATH})` : "not installed"}`
     );
   } catch (err) {
     error(err instanceof Error ? err.message : String(err));
@@ -32032,10 +32621,10 @@ function assignProp(target, prop, value) {
     configurable: true
   });
 }
-function getElementAtPath(obj, path41) {
-  if (!path41)
+function getElementAtPath(obj, path47) {
+  if (!path47)
     return obj;
-  return path41.reduce((acc, key) => acc?.[key], obj);
+  return path47.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject(promisesObj) {
   const keys = Object.keys(promisesObj);
@@ -32355,11 +32944,11 @@ function aborted(x2, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues(path41, issues) {
+function prefixIssues(path47, issues) {
   return issues.map((iss) => {
     var _a3;
     (_a3 = iss).path ?? (_a3.path = []);
-    iss.path.unshift(path41);
+    iss.path.unshift(path47);
     return iss;
   });
 }
@@ -37682,7 +38271,7 @@ var Protocol = class {
           return;
         }
         const pollInterval = task2.pollInterval ?? this._options?.defaultTaskPollInterval ?? 1e3;
-        await new Promise((resolve28) => setTimeout(resolve28, pollInterval));
+        await new Promise((resolve33) => setTimeout(resolve33, pollInterval));
         options?.signal?.throwIfAborted();
       }
     } catch (error3) {
@@ -37699,7 +38288,7 @@ var Protocol = class {
    */
   request(request, resultSchema, options) {
     const { relatedRequestId, resumptionToken, onresumptiontoken, task, relatedTask } = options ?? {};
-    return new Promise((resolve28, reject) => {
+    return new Promise((resolve33, reject) => {
       const earlyReject = (error3) => {
         reject(error3);
       };
@@ -37777,7 +38366,7 @@ var Protocol = class {
           if (!parseResult.success) {
             reject(parseResult.error);
           } else {
-            resolve28(parseResult.data);
+            resolve33(parseResult.data);
           }
         } catch (error3) {
           reject(error3);
@@ -38038,12 +38627,12 @@ var Protocol = class {
       }
     } catch {
     }
-    return new Promise((resolve28, reject) => {
+    return new Promise((resolve33, reject) => {
       if (signal.aborted) {
         reject(new McpError(ErrorCode.InvalidRequest, "Request cancelled"));
         return;
       }
-      const timeoutId = setTimeout(resolve28, interval);
+      const timeoutId = setTimeout(resolve33, interval);
       signal.addEventListener("abort", () => {
         clearTimeout(timeoutId);
         reject(new McpError(ErrorCode.InvalidRequest, "Request cancelled"));
@@ -38833,7 +39422,7 @@ var Server = class extends Protocol {
 };
 
 // src/mcp/server.ts
-var path40 = __toESM(require("path"));
+var path45 = __toESM(require("path"));
 
 // node_modules/@modelcontextprotocol/sdk/dist/esm/server/stdio.js
 var import_node_process2 = __toESM(require("node:process"), 1);
@@ -38916,12 +39505,12 @@ var StdioServerTransport = class {
     this.onclose?.();
   }
   send(message) {
-    return new Promise((resolve28) => {
+    return new Promise((resolve33) => {
       const json = serializeMessage(message);
       if (this._stdout.write(json)) {
-        resolve28();
+        resolve33();
       } else {
-        this._stdout.once("drain", resolve28);
+        this._stdout.once("drain", resolve33);
       }
     });
   }
@@ -39465,7 +40054,7 @@ async function handleMcpToolCall(toolName, args, defaultRepo = ".") {
       const input = ControlUpInputSchema.parse({ ...args, repo });
       const result = await startControlAndSync({
         detach: input.detach,
-        cwd: path40.resolve(input.repo)
+        cwd: path45.resolve(input.repo)
       });
       if (result.code !== 0) {
         return {
@@ -39527,9 +40116,231 @@ var mcpCommand = {
   }
 };
 
+// src/cli/commands/telemetry.ts
+var fs39 = __toESM(require("fs"));
+var path46 = __toESM(require("path"));
+function printSignals() {
+  info("Collected when enabled (local Mission Control only):");
+  for (const signal of TELEMETRY_SIGNALS) {
+    info(`  \u2022 ${signal}`);
+  }
+  info("Disable anytime: har telemetry off");
+}
+async function handleStatus3(argv) {
+  const preference = readTelemetryPreference();
+  const enabled = isTelemetryEnabled();
+  const apiUrl = getControlApiUrl();
+  const reachable = enabled ? await isControlApiReachable(apiUrl) : false;
+  const payload = {
+    enabled,
+    preferenceEnabled: preference.enabled,
+    preferencePath: getTelemetryPreferencePath(),
+    updatedAt: preference.updatedAt ?? null,
+    envOverride: process.env.HAR_TELEMETRY ?? null,
+    controlApiUrl: apiUrl,
+    controlReachable: reachable,
+    otelEndpoint: `${apiUrl.replace(/\/$/, "")}/api/otel`,
+    signals: [...TELEMETRY_SIGNALS]
+  };
+  if (argv.json) {
+    process.stdout.write(`${JSON.stringify(payload, null, 2)}
+`);
+    return;
+  }
+  header("har telemetry status");
+  info(`Enabled:       ${enabled ? "yes" : "no"}${process.env.HAR_TELEMETRY ? " (HAR_TELEMETRY override)" : ""}`);
+  info(`Preference:    ${getTelemetryPreferencePath()}${preference.updatedAt ? ` (updated ${preference.updatedAt})` : " (default on)"}`);
+  info(`Mission Control: ${apiUrl} (${reachable ? "reachable" : "not reachable"})`);
+  info(`OTLP endpoint: ${payload.otelEndpoint}`);
+  printSignals();
+}
+async function handleOn() {
+  header("har telemetry on");
+  writeTelemetryPreference(true);
+  success("Telemetry enabled (opt-out). Agent usage will be stored in local Mission Control.");
+  printSignals();
+  const result = await ensureTelemetryInfrastructure({ startIfNeeded: true });
+  if (result.message) success(result.message);
+  if (result.warning) warn(result.warning);
+  if (result.otelReady) {
+    info(`OTLP ingest: ${result.apiUrl.replace(/\/$/, "")}/api/otel`);
+    info("Usage appears under Mission Control \u2192 Worktrees. Disable: har telemetry off");
+  }
+}
+async function handleOff() {
+  header("har telemetry off");
+  writeTelemetryPreference(false);
+  success("Telemetry disabled.");
+  info("Future launches will not inject OTEL exporters or auto-start Mission Control.");
+  info("Existing usage rows in Mission Control are kept. Historical data is not deleted.");
+}
+async function handleWriteEnv(argv) {
+  const repoPath = path46.resolve(argv.repo);
+  const harnessRoot = resolveHarnessRoot(repoPath);
+  const session = readSlotRegistry(harnessRoot, argv.agentId);
+  const workDir = argv.workDir ?? session?.workDir ?? repoPath;
+  const branch = argv.branch ?? session?.branch;
+  const suffix = argv.suffix ?? session?.suffix;
+  const purpose = argv.purpose ?? session?.purpose;
+  const sessionKey = argv.sessionKey ?? buildSessionKey({
+    branch,
+    agentId: argv.agentId,
+    suffix,
+    createdAt: session?.createdAt
+  });
+  const envFile = argv.envFile ?? path46.join(workDir, `.env.agent.${argv.agentId}`);
+  let otelReady = argv.otelReady;
+  if (otelReady === void 0 && isTelemetryEnabled()) {
+    const ensured = await ensureTelemetryInfrastructure({ startIfNeeded: false });
+    otelReady = ensured.otelReady;
+  }
+  const attrs = {
+    sessionKey,
+    agentId: argv.agentId,
+    repoPath,
+    workDir,
+    branch,
+    suffix,
+    purpose
+  };
+  appendTelemetryEnvToFile(envFile, attrs, { otelReady: otelReady !== false && isTelemetryEnabled() });
+  success(`Wrote telemetry env to ${envFile}`);
+}
+function handlePrintEnv(argv) {
+  const repoPath = path46.resolve(argv.repo);
+  const workDir = argv.workDir ?? repoPath;
+  const sessionKey = buildSessionKey({
+    branch: argv.branch,
+    agentId: argv.agentId,
+    suffix: argv.suffix
+  });
+  process.stdout.write(
+    buildTelemetryEnvBlock(
+      {
+        sessionKey,
+        agentId: argv.agentId,
+        repoPath,
+        workDir,
+        branch: argv.branch,
+        suffix: argv.suffix
+      },
+      { otelReady: argv.otelReady && isTelemetryEnabled() }
+    )
+  );
+}
+function handleCodexSnippet(argv) {
+  const repoPath = path46.resolve(argv.repo);
+  const harnessRoot = resolveHarnessRoot(repoPath);
+  const session = readSlotRegistry(harnessRoot, argv.agentId);
+  const workDir = argv.workDir ?? session?.workDir ?? repoPath;
+  const branch = argv.branch ?? session?.branch;
+  const suffix = argv.suffix ?? session?.suffix;
+  const sessionKey = buildSessionKey({
+    branch,
+    agentId: argv.agentId,
+    suffix,
+    createdAt: session?.createdAt
+  });
+  const snippet = buildCodexOtelSnippet({
+    sessionKey,
+    agentId: argv.agentId,
+    repoPath,
+    workDir,
+    branch,
+    suffix,
+    purpose: session?.purpose
+  });
+  if (argv.write) {
+    const outDir = path46.join(harnessRoot, ".har", "telemetry");
+    fs39.mkdirSync(outDir, { recursive: true });
+    const outPath = path46.join(outDir, "codex.otel.toml.snippet");
+    fs39.writeFileSync(outPath, snippet);
+    success(`Wrote ${outPath}`);
+    info("Merge the [otel] table into ~/.codex/config.toml manually.");
+    return;
+  }
+  process.stdout.write(snippet);
+}
+var telemetryCommand = {
+  command: "telemetry <subcommand>",
+  describe: "Agent usage telemetry (Claude Code / Codex \u2192 Mission Control)",
+  builder: (yargs) => yargs.command(
+    "status",
+    "Show telemetry preference and Mission Control reachability",
+    (y2) => y2.option("json", { type: "boolean", default: false }),
+    (argv) => {
+      void handleStatus3({ json: argv.json });
+    }
+  ).command(
+    "on",
+    "Enable telemetry (default) and ensure Mission Control is running",
+    () => {
+    },
+    () => {
+      void handleOn();
+    }
+  ).command(
+    "off",
+    "Disable telemetry (no OTEL injection, no MC auto-start)",
+    () => {
+    },
+    () => {
+      void handleOff();
+    }
+  ).command(
+    "write-env",
+    "Append session + OTEL env vars to .env.agent.<id>",
+    (y2) => y2.option("agent-id", { type: "number", demandOption: true }).option("repo", { type: "string", default: "." }).option("env-file", { type: "string" }).option("work-dir", { type: "string" }).option("branch", { type: "string" }).option("suffix", { type: "string" }).option("purpose", { type: "string" }).option("session-key", { type: "string" }).option("otel-ready", { type: "boolean" }),
+    (argv) => handleWriteEnv({
+      agentId: argv["agent-id"],
+      repo: argv.repo,
+      envFile: argv["env-file"],
+      workDir: argv["work-dir"],
+      branch: argv.branch,
+      suffix: argv.suffix,
+      purpose: argv.purpose,
+      sessionKey: argv["session-key"],
+      otelReady: argv["otel-ready"]
+    }).catch((err) => {
+      error(err instanceof Error ? err.message : String(err));
+      process.exitCode = 1;
+    })
+  ).command(
+    "print-env",
+    "Print telemetry env block to stdout",
+    (y2) => y2.option("agent-id", { type: "number", demandOption: true }).option("repo", { type: "string", default: "." }).option("work-dir", { type: "string" }).option("branch", { type: "string" }).option("suffix", { type: "string" }).option("otel-ready", { type: "boolean", default: true }),
+    (argv) => handlePrintEnv({
+      agentId: argv["agent-id"],
+      repo: argv.repo,
+      workDir: argv["work-dir"],
+      branch: argv.branch,
+      suffix: argv.suffix,
+      otelReady: argv["otel-ready"]
+    })
+  ).command(
+    "codex-snippet",
+    "Print or write a Codex [otel] config snippet",
+    (y2) => y2.option("agent-id", { type: "number", demandOption: true }).option("repo", { type: "string", default: "." }).option("work-dir", { type: "string" }).option("branch", { type: "string" }).option("suffix", { type: "string" }).option("write", {
+      type: "boolean",
+      default: false,
+      describe: "Write to .har/telemetry/codex.otel.toml.snippet"
+    }),
+    (argv) => handleCodexSnippet({
+      agentId: argv["agent-id"],
+      repo: argv.repo,
+      workDir: argv["work-dir"],
+      branch: argv.branch,
+      suffix: argv.suffix,
+      write: argv.write
+    })
+  ).demandCommand(1, "Please specify a subcommand: status, on, off, write-env, print-env, codex-snippet"),
+  handler: () => {
+  }
+};
+
 // src/cli/index.ts
 async function runCli() {
-  await yargs_default(hideBin(process.argv)).scriptName("har").usage("$0 <command> [options]").command(envCommand).command(agentsCommand).command(controlCommand).command(hooksCommand).command(mcpCommand).demandCommand(1, "Please specify a command. Try: har env init").strict().help().version(getHarPackageVersion()).parse();
+  await yargs_default(hideBin(process.argv)).scriptName("har").usage("$0 <command> [options]").command(envCommand).command(agentsCommand).command(controlCommand).command(hooksCommand).command(mcpCommand).command(telemetryCommand).demandCommand(1, "Please specify a command. Try: har env init").strict().help().version(getHarPackageVersion()).parse();
 }
 
 // src/index.ts