@osfactory/har 0.16.2 → 0.18.0

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 path48 = url.path;
-      if (path48.length === 0) {
+      const path49 = url.path;
+      if (path49.length === 0) {
         return;
       }
-      if (url.scheme === "file" && path48.length === 1 && isNormalizedWindowsDriveLetter(path48[0])) {
+      if (url.scheme === "file" && path49.length === 1 && isNormalizedWindowsDriveLetter(path49[0])) {
         return;
       }
-      path48.pop();
+      path49.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(resolve33, reject) {
+      return new Body.Promise(function(resolve34, reject) {
         let resTimeout;
         if (_this4.timeout) {
           resTimeout = setTimeout(function() {
@@ -2126,7 +2126,7 @@ var require_lib2 = __commonJS({
           }
           clearTimeout(resTimeout);
           try {
-            resolve33(Buffer.concat(accum, accumBytes));
+            resolve34(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(resolve33, reject) {
+      return new fetch3.Promise(function(resolve34, 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");
                 }
-                resolve33(fetch3(new Request3(locationURL, requestOpts)));
+                resolve34(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);
-            resolve33(response);
+            resolve34(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);
-            resolve33(response);
+            resolve34(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);
-              resolve33(response);
+              resolve34(response);
             });
             raw.on("end", function() {
               if (!response) {
                 response = new Response3(body, response_options);
-                resolve33(response);
+                resolve34(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);
-            resolve33(response);
+            resolve34(response);
             return;
           }
           response = new Response3(body, response_options);
-          resolve33(response);
+          resolve34(response);
         });
         writeToStream(req, request);
       });
@@ -6351,14 +6351,14 @@ __export(fileFromPath_exports, {
   fileFromPathSync: () => fileFromPathSync,
   isFile: () => isFile
 });
-function createFileFromPath(path48, { mtimeMs, size }, filenameOrOptions, options = {}) {
+function createFileFromPath(path49, { mtimeMs, size }, filenameOrOptions, options = {}) {
   let filename;
   if (isPlainObject_default2(filenameOrOptions)) {
     [options, filename] = [filenameOrOptions, void 0];
   } else {
     filename = filenameOrOptions;
   }
-  const file = new FileFromPath({ path: path48, size, lastModified: mtimeMs });
+  const file = new FileFromPath({ path: path49, size, lastModified: mtimeMs });
   if (!filename) {
     filename = file.name;
   }
@@ -6367,13 +6367,13 @@ function createFileFromPath(path48, { mtimeMs, size }, filenameOrOptions, option
     lastModified: file.lastModified
   });
 }
-function fileFromPathSync(path48, filenameOrOptions, options = {}) {
-  const stats = (0, import_fs5.statSync)(path48);
-  return createFileFromPath(path48, stats, filenameOrOptions, options);
+function fileFromPathSync(path49, filenameOrOptions, options = {}) {
+  const stats = (0, import_fs5.statSync)(path49);
+  return createFileFromPath(path49, stats, filenameOrOptions, options);
 }
-async function fileFromPath2(path48, filenameOrOptions, options) {
-  const stats = await import_fs5.promises.stat(path48);
-  return createFileFromPath(path48, stats, filenameOrOptions, options);
+async function fileFromPath2(path49, filenameOrOptions, options) {
+  const stats = await import_fs5.promises.stat(path49);
+  return createFileFromPath(path49, stats, filenameOrOptions, options);
 }
 var import_fs5, import_path5, import_node_domexception, __classPrivateFieldSet5, __classPrivateFieldGet6, _FileFromPath_path, _FileFromPath_start, MESSAGE, FileFromPath;
 var init_fileFromPath = __esm({
@@ -6433,6 +6433,412 @@ var init_fileFromPath = __esm({
   }
 });
 
+// src/core/control-config.ts
+function getControlApiUrl() {
+  return process.env.HAR_CONTROL_API_URL ?? DEFAULT_CONTROL_API_URL;
+}
+function isControlEnabled() {
+  return process.env.HAR_CONTROL_DISABLED !== "true";
+}
+var DEFAULT_CONTROL_API_URL;
+var init_control_config = __esm({
+  "src/core/control-config.ts"() {
+    "use strict";
+    DEFAULT_CONTROL_API_URL = "http://localhost:3847";
+  }
+});
+
+// src/core/telemetry-config.ts
+function getPreferencePath() {
+  if (process.env.HAR_TELEMETRY_CONFIG_PATH) {
+    return path34.resolve(process.env.HAR_TELEMETRY_CONFIG_PATH);
+  }
+  return path34.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 normalizeSignals(enabled, raw) {
+  if (!enabled) return { ...DEFAULT_SIGNALS_OFF };
+  return {
+    metrics: raw?.metrics !== false,
+    logs: raw?.logs !== false,
+    prompts: raw?.prompts === true,
+    traces: raw?.traces !== false
+  };
+}
+function readTelemetryPreference() {
+  const preferencePath = getPreferencePath();
+  try {
+    if (!fs34.existsSync(preferencePath)) {
+      return { enabled: true, signals: { ...DEFAULT_SIGNALS_ON } };
+    }
+    const parsed = JSON.parse(fs34.readFileSync(preferencePath, "utf8"));
+    const enabled = parsed.enabled !== false;
+    return {
+      enabled,
+      signals: normalizeSignals(enabled, parsed.signals),
+      updatedAt: typeof parsed.updatedAt === "string" ? parsed.updatedAt : void 0
+    };
+  } catch {
+    return { enabled: true, signals: { ...DEFAULT_SIGNALS_ON } };
+  }
+}
+function writeTelemetryPreference(enabled, signals) {
+  const current = readTelemetryPreference();
+  const nextSignals = normalizeSignals(enabled, {
+    ...current.signals,
+    ...signals
+  });
+  const preference = {
+    enabled,
+    signals: enabled ? nextSignals : { ...DEFAULT_SIGNALS_OFF },
+    updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+  };
+  const preferencePath = getPreferencePath();
+  fs34.mkdirSync(path34.dirname(preferencePath), { recursive: true });
+  fs34.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 getTelemetrySignals() {
+  if (!isTelemetryEnabled()) return { ...DEFAULT_SIGNALS_OFF };
+  return readTelemetryPreference().signals;
+}
+function getTelemetryPreferencePath() {
+  return getPreferencePath();
+}
+var fs34, os9, path34, DEFAULT_SIGNALS_ON, DEFAULT_SIGNALS_OFF, TELEMETRY_SIGNALS;
+var init_telemetry_config = __esm({
+  "src/core/telemetry-config.ts"() {
+    "use strict";
+    fs34 = __toESM(require("fs"));
+    os9 = __toESM(require("os"));
+    path34 = __toESM(require("path"));
+    DEFAULT_SIGNALS_ON = {
+      metrics: true,
+      logs: true,
+      prompts: false,
+      /** Hooks are traces-first; usage metrics are derived from span gen_ai.usage.* in Mission Control. */
+      traces: true
+    };
+    DEFAULT_SIGNALS_OFF = {
+      metrics: false,
+      logs: false,
+      prompts: false,
+      traces: false
+    };
+    TELEMETRY_SIGNALS = [
+      "Traces (default): Cursor / Claude / Codex activity via opentelemetry-hooks \u2192 Mission Control",
+      "Logs/events (default): hook lifecycle logs without prompt bodies",
+      "Metrics (default): token usage derived from span gen_ai.usage.* attributes",
+      "Prompts (opt-in): user prompt text via IDE_OTEL_CAPTURE_TEXT \u2014 har telemetry on --prompts (also fills Mission Control purpose)",
+      "Fallback: har control sync harvests local Claude/Codex session files when hooks telemetry is missing"
+    ];
+  }
+});
+
+// src/core/otel-hooks.ts
+var otel_hooks_exports = {};
+__export(otel_hooks_exports, {
+  OTEL_HOOKS_AGENTS: () => OTEL_HOOKS_AGENTS,
+  OTEL_HOOKS_PACKAGE: () => OTEL_HOOKS_PACKAGE,
+  buildOtelHooksConfig: () => buildOtelHooksConfig,
+  disableOtelHooksExport: () => disableOtelHooksExport,
+  ensureOtelHooks: () => ensureOtelHooks,
+  getOtelHooksConfigPath: () => getOtelHooksConfigPath,
+  getOtelHooksHome: () => getOtelHooksHome,
+  getOtelHooksWrapperPath: () => getOtelHooksWrapperPath,
+  rewriteHookCommandsToWrapper: () => rewriteHookCommandsToWrapper,
+  writeOtelHooksConfig: () => writeOtelHooksConfig,
+  writeOtelHooksWrapper: () => writeOtelHooksWrapper
+});
+function getOtelHooksHome() {
+  if (process.env.HAR_OTEL_HOOKS_HOME) {
+    return path40.resolve(process.env.HAR_OTEL_HOOKS_HOME);
+  }
+  return path40.join(os12.homedir(), ".har", "otel-hooks");
+}
+function getOtelHooksConfigPath(hooksHome = getOtelHooksHome()) {
+  return path40.join(hooksHome, "otel_config.json");
+}
+function getOtelHooksWrapperPath(hooksHome = getOtelHooksHome()) {
+  return path40.join(hooksHome, "run-otel-hook.sh");
+}
+function buildOtelHooksConfig(options) {
+  const enabled = options?.enabled ?? isTelemetryEnabled();
+  const signals = getTelemetrySignals();
+  const apiUrl = (options?.apiUrl ?? getControlApiUrl()).replace(/\/$/, "");
+  return {
+    OTEL_EXPORTER_OTLP_ENDPOINT: enabled ? `${apiUrl}/api/otel/v1/traces` : null,
+    OTEL_EXPORTER_OTLP_PROTOCOL: "http/json",
+    OTEL_SERVICE_NAME: "har-ide-agent",
+    IDE_OTEL_BATCH_ON_STOP: "true",
+    IDE_OTEL_ENABLE_LOGS: enabled && signals.logs ? "true" : "false",
+    IDE_OTEL_LOG_ALL_EVENTS: enabled && signals.logs ? "true" : "false",
+    IDE_OTEL_CAPTURE_TEXT: enabled && signals.prompts ? "true" : "false",
+    IDE_OTEL_MASK_PROMPTS: "false",
+    OTEL_RESOURCE_ATTRIBUTES: options?.resourceAttributes ?? null
+  };
+}
+function writeOtelHooksConfig(config2, hooksHome = getOtelHooksHome()) {
+  fs38.mkdirSync(hooksHome, { recursive: true });
+  const configPath = getOtelHooksConfigPath(hooksHome);
+  const payload = {
+    _comment: "Managed by har telemetry \u2014 do not edit by hand; use: har telemetry on|off",
+    ...config2
+  };
+  fs38.writeFileSync(configPath, `${JSON.stringify(payload, null, 2)}
+`);
+  return configPath;
+}
+function writeOtelHooksWrapper(otelHookCommand, hooksHome = getOtelHooksHome()) {
+  fs38.mkdirSync(hooksHome, { recursive: true });
+  const wrapperPath = getOtelHooksWrapperPath(hooksHome);
+  const script = `#!/usr/bin/env bash
+# Managed by har telemetry \u2014 invokes opentelemetry-hooks with HAR config home.
+set -euo pipefail
+export IDE_OTEL_HOOK_HOME="${hooksHome}"
+exec "${otelHookCommand}" "$@"
+`;
+  fs38.writeFileSync(wrapperPath, script, { mode: 493 });
+  try {
+    fs38.chmodSync(wrapperPath, 493);
+  } catch {
+  }
+  return wrapperPath;
+}
+function commandExists(command2) {
+  const result = (0, import_child_process9.spawnSync)("sh", ["-c", `command -v ${JSON.stringify(command2)}`], {
+    encoding: "utf8"
+  });
+  return result.status === 0 && Boolean(result.stdout?.trim());
+}
+function resolveOtelHookCommand() {
+  if (commandExists("otel-hook")) {
+    const which = (0, import_child_process9.spawnSync)("sh", ["-c", "command -v otel-hook"], { encoding: "utf8" });
+    return which.stdout?.trim() || "otel-hook";
+  }
+  return null;
+}
+function tryInstallPackage() {
+  if (commandExists("uv")) {
+    const result = (0, import_child_process9.spawnSync)(
+      "uv",
+      ["tool", "install", "--force", OTEL_HOOKS_PACKAGE],
+      { encoding: "utf8", timeout: 18e4 }
+    );
+    if (result.status === 0) {
+      return { ok: true, detail: `uv tool install ${OTEL_HOOKS_PACKAGE}` };
+    }
+  }
+  if (commandExists("pipx")) {
+    const result = (0, import_child_process9.spawnSync)("pipx", ["install", "--force", OTEL_HOOKS_PACKAGE], {
+      encoding: "utf8",
+      timeout: 18e4
+    });
+    if (result.status === 0) {
+      return { ok: true, detail: `pipx install ${OTEL_HOOKS_PACKAGE}` };
+    }
+    return {
+      ok: false,
+      detail: `pipx install failed: ${(result.stderr || result.stdout || "").trim().slice(0, 400)}`
+    };
+  }
+  if (commandExists("pip3") || commandExists("pip")) {
+    const pip = commandExists("pip3") ? "pip3" : "pip";
+    const result = (0, import_child_process9.spawnSync)(
+      pip,
+      ["install", "--user", OTEL_HOOKS_PACKAGE],
+      { encoding: "utf8", timeout: 18e4 }
+    );
+    if (result.status === 0) {
+      return { ok: true, detail: `${pip} install --user ${OTEL_HOOKS_PACKAGE}` };
+    }
+    return {
+      ok: false,
+      detail: `${pip} install failed: ${(result.stderr || result.stdout || "").trim().slice(0, 400)}`
+    };
+  }
+  return {
+    ok: false,
+    detail: "Neither uv, pipx, nor pip3/pip found; install Python tooling to use opentelemetry-hooks"
+  };
+}
+function runSetupAgent(agent, otelHookCommand, hooksHome) {
+  const result = (0, import_child_process9.spawnSync)(otelHookCommand, ["setup", "--agent", agent], {
+    encoding: "utf8",
+    env: {
+      ...process.env,
+      IDE_OTEL_HOOK_HOME: hooksHome
+    },
+    timeout: 6e4
+  });
+  if (result.status === 0) {
+    return { ok: true, detail: `setup --agent ${agent}` };
+  }
+  return {
+    ok: false,
+    detail: `setup --agent ${agent} failed: ${(result.stderr || result.stdout || "").trim().slice(0, 400)}`
+  };
+}
+function rewriteHookCommandsToWrapper(filePath, wrapperPath) {
+  if (!fs38.existsSync(filePath)) return false;
+  let raw;
+  try {
+    raw = fs38.readFileSync(filePath, "utf8");
+  } catch {
+    return false;
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch {
+    return false;
+  }
+  if (!parsed || typeof parsed !== "object") return false;
+  const quoted = JSON.stringify(wrapperPath);
+  const rewriteCommand = (command2) => {
+    if (!command2.includes("otel-hook") && !command2.includes("otel_hook.py")) return command2;
+    if (command2.includes(wrapperPath)) return command2;
+    return command2.replace(
+      /(?:^|[;&|]\s*)(?:env\s+[^=\s]+=\S+\s+)*(?:python3?\s+)?(?:\S*otel[_-]hook\S*)/,
+      (match) => match.replace(/(?:python3?\s+)?(?:\S*otel[_-]hook\S*)/, quoted.slice(1, -1))
+    );
+  };
+  const walk = (node) => {
+    let changed = false;
+    if (Array.isArray(node)) {
+      for (const item of node) changed = walk(item) || changed;
+      return changed;
+    }
+    if (!node || typeof node !== "object") return false;
+    const obj = node;
+    if (typeof obj.command === "string") {
+      const next = rewriteCommand(obj.command);
+      if (next !== obj.command) {
+        obj.command = next;
+        changed = true;
+      }
+    }
+    for (const value of Object.values(obj)) changed = walk(value) || changed;
+    return changed;
+  };
+  if (!walk(parsed)) return false;
+  fs38.writeFileSync(filePath, `${JSON.stringify(parsed, null, 2)}
+`);
+  return true;
+}
+function rewriteKnownHookRegistrations(wrapperPath) {
+  const home = os12.homedir();
+  const candidates = [
+    path40.join(home, ".cursor", "hooks.json"),
+    path40.join(home, ".claude", "settings.json"),
+    path40.join(home, ".codex", "hooks.json")
+  ];
+  for (const filePath of candidates) {
+    try {
+      rewriteHookCommandsToWrapper(filePath, wrapperPath);
+    } catch {
+    }
+  }
+}
+function ensureOtelHooks(options) {
+  const hooksHome = getOtelHooksHome();
+  const errors = [];
+  const agentsSetup = [];
+  fs38.mkdirSync(hooksHome, { recursive: true });
+  let otelHookCommand = resolveOtelHookCommand();
+  if (!otelHookCommand) {
+    const installed = tryInstallPackage();
+    if (!installed.ok) {
+      errors.push(installed.detail);
+      const configPath2 = writeOtelHooksConfig(
+        buildOtelHooksConfig({ resourceAttributes: options?.resourceAttributes }),
+        hooksHome
+      );
+      return {
+        ok: false,
+        hooksHome,
+        configPath: configPath2,
+        wrapperPath: getOtelHooksWrapperPath(hooksHome),
+        otelHookCommand: null,
+        warning: installed.detail,
+        agentsSetup,
+        errors
+      };
+    }
+    otelHookCommand = resolveOtelHookCommand();
+    if (!otelHookCommand) {
+      errors.push("opentelemetry-hooks installed but otel-hook is not on PATH");
+      const configPath2 = writeOtelHooksConfig(
+        buildOtelHooksConfig({ resourceAttributes: options?.resourceAttributes }),
+        hooksHome
+      );
+      return {
+        ok: false,
+        hooksHome,
+        configPath: configPath2,
+        wrapperPath: getOtelHooksWrapperPath(hooksHome),
+        otelHookCommand: null,
+        warning: errors[errors.length - 1],
+        agentsSetup,
+        errors
+      };
+    }
+  }
+  const configPath = writeOtelHooksConfig(
+    buildOtelHooksConfig({ resourceAttributes: options?.resourceAttributes }),
+    hooksHome
+  );
+  const wrapperPath = writeOtelHooksWrapper(otelHookCommand, hooksHome);
+  if (options?.setupAgents !== false && isTelemetryEnabled()) {
+    for (const agent of OTEL_HOOKS_AGENTS) {
+      const setup = runSetupAgent(agent, otelHookCommand, hooksHome);
+      if (setup.ok) agentsSetup.push(agent);
+      else errors.push(setup.detail);
+    }
+    rewriteKnownHookRegistrations(wrapperPath);
+  }
+  const ok = errors.length === 0;
+  return {
+    ok,
+    hooksHome,
+    configPath,
+    wrapperPath,
+    otelHookCommand,
+    message: ok ? `opentelemetry-hooks ready (${agentsSetup.join(", ") || "config only"}) \u2192 ${configPath}` : void 0,
+    warning: errors.length ? errors.join("; ") : void 0,
+    agentsSetup,
+    errors
+  };
+}
+function disableOtelHooksExport() {
+  return writeOtelHooksConfig(buildOtelHooksConfig({ enabled: false }));
+}
+var import_child_process9, fs38, os12, path40, OTEL_HOOKS_PACKAGE, OTEL_HOOKS_AGENTS;
+var init_otel_hooks = __esm({
+  "src/core/otel-hooks.ts"() {
+    "use strict";
+    import_child_process9 = require("child_process");
+    fs38 = __toESM(require("fs"));
+    os12 = __toESM(require("os"));
+    path40 = __toESM(require("path"));
+    init_control_config();
+    init_telemetry_config();
+    OTEL_HOOKS_PACKAGE = "opentelemetry-hooks==0.14.0";
+    OTEL_HOOKS_AGENTS = ["cursor", "claude", "codex"];
+  }
+});
+
 // node_modules/ajv/dist/compile/codegen/code.js
 var require_code = __commonJS({
   "node_modules/ajv/dist/compile/codegen/code.js"(exports2) {
@@ -9384,7 +9790,7 @@ var require_compile = __commonJS({
       const schOrFunc = root.refs[ref];
       if (schOrFunc)
         return schOrFunc;
-      let _sch = resolve33.call(this, root, ref);
+      let _sch = resolve34.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 +9817,7 @@ var require_compile = __commonJS({
     function sameSchemaEnv(s1, s2) {
       return s1.schema === s2.schema && s1.root === s2.root && s1.baseId === s2.baseId;
     }
-    function resolve33(root, ref) {
+    function resolve34(root, ref) {
       let sch;
       while (typeof (sch = this.refs[ref]) == "string")
         ref = sch;
@@ -9629,8 +10035,8 @@ var require_utils2 = __commonJS({
       }
       return ind;
     }
-    function removeDotSegments(path48) {
-      let input = path48;
+    function removeDotSegments(path49) {
+      let input = path49;
       const output = [];
       let nextSlash = -1;
       let len = 0;
@@ -9882,8 +10288,8 @@ var require_schemes = __commonJS({
         wsComponent.secure = void 0;
       }
       if (wsComponent.resourceName) {
-        const [path48, query] = wsComponent.resourceName.split("?");
-        wsComponent.path = path48 && path48 !== "/" ? path48 : void 0;
+        const [path49, query] = wsComponent.resourceName.split("?");
+        wsComponent.path = path49 && path49 !== "/" ? path49 : void 0;
         wsComponent.query = query;
         wsComponent.resourceName = void 0;
       }
@@ -10042,7 +10448,7 @@ var require_fast_uri = __commonJS({
       }
       return uri;
     }
-    function resolve33(baseURI, relativeURI, options) {
+    function resolve34(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 +10706,7 @@ var require_fast_uri = __commonJS({
     var fastUri = {
       SCHEMES,
       normalize: normalize3,
-      resolve: resolve33,
+      resolve: resolve34,
       resolveComponent,
       equal,
       serialize,
@@ -14565,11 +14971,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: (path48) => {
+  require: (path49) => {
     if (typeof require !== "undefined") {
-      return require(path48);
-    } else if (path48.match(/\.json$/)) {
-      return JSON.parse((0, import_fs2.readFileSync)(path48, "utf8"));
+      return require(path49);
+    } else if (path49.match(/\.json$/)) {
+      return JSON.parse((0, import_fs2.readFileSync)(path49, "utf8"));
     } else {
       throw Error("only .json config files are supported in ESM");
     }
@@ -17095,12 +17501,12 @@ var YargsInstance = class {
   async getCompletion(args, done) {
     argsert("<array> [function]", [args, done], arguments.length);
     if (!done) {
-      return new Promise((resolve33, reject) => {
+      return new Promise((resolve34, reject) => {
         __classPrivateFieldGet(this, _YargsInstance_completion, "f").getCompletion(args, (err, completions) => {
           if (err)
             reject(err);
           else
-            resolve33(completions);
+            resolve34(completions);
         });
       });
     } else {
@@ -19250,8 +19656,8 @@ function getErrorMap() {
 
 // node_modules/zod/v3/helpers/parseUtil.js
 var makeIssue = (params) => {
-  const { data, path: path48, errorMaps, issueData } = params;
-  const fullPath = [...path48, ...issueData.path || []];
+  const { data, path: path49, errorMaps, issueData } = params;
+  const fullPath = [...path49, ...issueData.path || []];
   const fullIssue = {
     ...issueData,
     path: fullPath
@@ -19367,11 +19773,11 @@ var errorUtil;
 
 // node_modules/zod/v3/types.js
 var ParseInputLazyPath = class {
-  constructor(parent, value, path48, key) {
+  constructor(parent, value, path49, key) {
     this._cachedPath = [];
     this.parent = parent;
     this.data = value;
-    this._path = path48;
+    this._path = path49;
     this._key = key;
   }
   get path() {
@@ -22992,7 +23398,6 @@ var SlotRegistryEntrySchema = external_exports.object({
   /** Random per-session chars; absent in root mode. */
   suffix: external_exports.string().optional(),
   createdAt: external_exports.string(),
-  purpose: external_exports.string().optional(),
   ports: external_exports.record(external_exports.number()).optional(),
   previewUrls: external_exports.record(external_exports.string()).optional(),
   status: external_exports.enum(["starting", "active", "failed", "completed"]).default("active"),
@@ -23038,6 +23443,7 @@ var AgentSlotStatusSchema = external_exports.object({
   baseBranch: external_exports.string().optional(),
   baseCommit: external_exports.string().optional(),
   sessionCreatedAt: external_exports.string().optional(),
+  /** Derived from first captured user prompt (OTEL hooks); not set at launch. */
   purpose: external_exports.string().optional(),
   sessionStatus: external_exports.enum(["starting", "active", "failed", "completed"]).optional(),
   lastError: external_exports.string().optional(),
@@ -23106,7 +23512,7 @@ var ValidationRecordSchema = external_exports.object({
 var SyncValidationsInputSchema = external_exports.object({
   validations: external_exports.array(ValidationRecordSchema)
 });
-var AgentToolSchema = external_exports.enum(["claude_code", "codex"]);
+var AgentToolSchema = external_exports.enum(["claude_code", "codex", "cursor"]);
 var UsageSourceSchema = external_exports.enum(["otel", "harvest"]);
 var AgentSessionUsageSchema = external_exports.object({
   sessionKey: external_exports.string().min(1),
@@ -23410,16 +23816,16 @@ async function handleAgentSkills(options) {
 }
 async function askYesNo(question) {
   const rl = readline.createInterface({ input: process.stdin, output: process.stderr });
-  return new Promise((resolve33) => {
+  return new Promise((resolve34) => {
     process.stderr.write(`${question} `);
     rl.once("line", (answer) => {
       rl.close();
       const trimmed = answer.trim();
       if (trimmed === "") {
-        resolve33(true);
+        resolve34(true);
         return;
       }
-      resolve33(/^y(es)?$/i.test(trimmed));
+      resolve34(/^y(es)?$/i.test(trimmed));
     });
   });
 }
@@ -23498,7 +23904,7 @@ function handleRemove(argv) {
 }
 
 // src/cli/commands/env.ts
-var path41 = __toESM(require("path"));
+var path42 = __toESM(require("path"));
 
 // src/core/harness.ts
 var fs20 = __toESM(require("fs"));
@@ -24277,13 +24683,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(path48, ...args) {
+async function fileFromPath3(path49, ...args) {
   const { fileFromPath: _fileFromPath } = await Promise.resolve().then(() => (init_fileFromPath(), fileFromPath_exports));
   if (!fileFromPathWarned) {
-    console.warn(`fileFromPath is deprecated; use fs.createReadStream(${JSON.stringify(path48)}) instead`);
+    console.warn(`fileFromPath is deprecated; use fs.createReadStream(${JSON.stringify(path49)}) instead`);
     fileFromPathWarned = true;
   }
-  return await _fileFromPath(path48, ...args);
+  return await _fileFromPath(path49, ...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 });
@@ -24779,8 +25185,8 @@ async function defaultParseResponse(props) {
 }
 var APIPromise = class _APIPromise extends Promise {
   constructor(responsePromise, parseResponse = defaultParseResponse) {
-    super((resolve33) => {
-      resolve33(null);
+    super((resolve34) => {
+      resolve34(null);
     });
     this.responsePromise = responsePromise;
     this.parseResponse = parseResponse;
@@ -24880,29 +25286,29 @@ var APIClient = class {
   defaultIdempotencyKey() {
     return `stainless-node-retry-${uuid4()}`;
   }
-  get(path48, opts) {
-    return this.methodRequest("get", path48, opts);
+  get(path49, opts) {
+    return this.methodRequest("get", path49, opts);
   }
-  post(path48, opts) {
-    return this.methodRequest("post", path48, opts);
+  post(path49, opts) {
+    return this.methodRequest("post", path49, opts);
   }
-  patch(path48, opts) {
-    return this.methodRequest("patch", path48, opts);
+  patch(path49, opts) {
+    return this.methodRequest("patch", path49, opts);
   }
-  put(path48, opts) {
-    return this.methodRequest("put", path48, opts);
+  put(path49, opts) {
+    return this.methodRequest("put", path49, opts);
   }
-  delete(path48, opts) {
-    return this.methodRequest("delete", path48, opts);
+  delete(path49, opts) {
+    return this.methodRequest("delete", path49, opts);
   }
-  methodRequest(method, path48, opts) {
+  methodRequest(method, path49, 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: path48, ...opts2, body };
+      return { method, path: path49, ...opts2, body };
     }));
   }
-  getAPIList(path48, Page, opts) {
-    return this.requestAPIList(Page, { method: "get", path: path48, ...opts });
+  getAPIList(path49, Page, opts) {
+    return this.requestAPIList(Page, { method: "get", path: path49, ...opts });
   }
   calculateContentLength(body) {
     if (typeof body === "string") {
@@ -24920,10 +25326,10 @@ var APIClient = class {
     return null;
   }
   buildRequest(options) {
-    const { method, path: path48, query, headers = {} } = options;
+    const { method, path: path49, 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(path48, query);
+    const url = this.buildURL(path49, query);
     if ("timeout" in options)
       validatePositiveInteger("timeout", options.timeout);
     const timeout = options.timeout ?? this.timeout;
@@ -25032,8 +25438,8 @@ var APIClient = class {
     const request = this.makeRequest(options, null);
     return new PagePromise(this, request, Page);
   }
-  buildURL(path48, query) {
-    const url = isAbsoluteURL(path48) ? new URL(path48) : new URL(this.baseURL + (this.baseURL.endsWith("/") && path48.startsWith("/") ? path48.slice(1) : path48));
+  buildURL(path49, query) {
+    const url = isAbsoluteURL(path49) ? new URL(path49) : new URL(this.baseURL + (this.baseURL.endsWith("/") && path49.startsWith("/") ? path49.slice(1) : path49));
     const defaultQuery = this.defaultQuery();
     if (!isEmptyObj(defaultQuery)) {
       query = { ...defaultQuery, ...query };
@@ -25318,7 +25724,7 @@ var startsWithSchemeRegexp = new RegExp("^(?:[a-z]+:)?//", "i");
 var isAbsoluteURL = (url) => {
   return startsWithSchemeRegexp.test(url);
 };
-var sleep = (ms) => new Promise((resolve33) => setTimeout(resolve33, ms));
+var sleep = (ms) => new Promise((resolve34) => setTimeout(resolve34, ms));
 var validatePositiveInteger = (name, n2) => {
   if (typeof n2 !== "number" || !Number.isInteger(n2)) {
     throw new AnthropicError(`${name} must be an integer`);
@@ -25809,12 +26215,12 @@ var PromptCachingBetaMessageStream = class _PromptCachingBetaMessageStream {
       }
       return this._emit("error", new AnthropicError(String(error3)));
     });
-    __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_connectedPromise, new Promise((resolve33, reject) => {
-      __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_resolveConnectedPromise, resolve33, "f");
+    __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_connectedPromise, new Promise((resolve34, reject) => {
+      __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_resolveConnectedPromise, resolve34, "f");
       __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_rejectConnectedPromise, reject, "f");
     }), "f");
-    __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_endPromise, new Promise((resolve33, reject) => {
-      __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_resolveEndPromise, resolve33, "f");
+    __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_endPromise, new Promise((resolve34, reject) => {
+      __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_resolveEndPromise, resolve34, "f");
       __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_rejectEndPromise, reject, "f");
     }), "f");
     __classPrivateFieldGet8(this, _PromptCachingBetaMessageStream_connectedPromise, "f").catch(() => {
@@ -25943,11 +26349,11 @@ var PromptCachingBetaMessageStream = class _PromptCachingBetaMessageStream {
    *   const message = await stream.emitted('message') // rejects if the stream errors
    */
   emitted(event) {
-    return new Promise((resolve33, reject) => {
+    return new Promise((resolve34, reject) => {
       __classPrivateFieldSet7(this, _PromptCachingBetaMessageStream_catchingPromiseCreated, true, "f");
       if (event !== "error")
         this.once("error", reject);
-      this.once(event, resolve33);
+      this.once(event, resolve34);
     });
   }
   async done() {
@@ -26174,7 +26580,7 @@ var PromptCachingBetaMessageStream = class _PromptCachingBetaMessageStream {
           if (done) {
             return { 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 });
+          return new Promise((resolve34, reject) => readQueue.push({ resolve: resolve34, reject })).then((chunk2) => chunk2 ? { value: chunk2, done: false } : { value: void 0, done: true });
         }
         const chunk = pushQueue.shift();
         return { value: chunk, done: false };
@@ -26322,12 +26728,12 @@ var MessageStream = class _MessageStream {
       }
       return this._emit("error", new AnthropicError(String(error3)));
     });
-    __classPrivateFieldSet8(this, _MessageStream_connectedPromise, new Promise((resolve33, reject) => {
-      __classPrivateFieldSet8(this, _MessageStream_resolveConnectedPromise, resolve33, "f");
+    __classPrivateFieldSet8(this, _MessageStream_connectedPromise, new Promise((resolve34, reject) => {
+      __classPrivateFieldSet8(this, _MessageStream_resolveConnectedPromise, resolve34, "f");
       __classPrivateFieldSet8(this, _MessageStream_rejectConnectedPromise, reject, "f");
     }), "f");
-    __classPrivateFieldSet8(this, _MessageStream_endPromise, new Promise((resolve33, reject) => {
-      __classPrivateFieldSet8(this, _MessageStream_resolveEndPromise, resolve33, "f");
+    __classPrivateFieldSet8(this, _MessageStream_endPromise, new Promise((resolve34, reject) => {
+      __classPrivateFieldSet8(this, _MessageStream_resolveEndPromise, resolve34, "f");
       __classPrivateFieldSet8(this, _MessageStream_rejectEndPromise, reject, "f");
     }), "f");
     __classPrivateFieldGet9(this, _MessageStream_connectedPromise, "f").catch(() => {
@@ -26456,11 +26862,11 @@ var MessageStream = class _MessageStream {
    *   const message = await stream.emitted('message') // rejects if the stream errors
    */
   emitted(event) {
-    return new Promise((resolve33, reject) => {
+    return new Promise((resolve34, reject) => {
       __classPrivateFieldSet8(this, _MessageStream_catchingPromiseCreated, true, "f");
       if (event !== "error")
         this.once("error", reject);
-      this.once(event, resolve33);
+      this.once(event, resolve34);
     });
   }
   async done() {
@@ -26687,7 +27093,7 @@ var MessageStream = class _MessageStream {
           if (done) {
             return { 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 });
+          return new Promise((resolve34, reject) => readQueue.push({ resolve: resolve34, reject })).then((chunk2) => chunk2 ? { value: chunk2, done: false } : { value: void 0, done: true });
         }
         const chunk = pushQueue.shift();
         return { value: chunk, done: false };
@@ -26947,11 +27353,11 @@ async function promptApplyAgentMdProposal(repoPath) {
 }
 async function askYesNo2(question) {
   const rl = readline2.createInterface({ input: process.stdin, output: process.stderr });
-  return new Promise((resolve33) => {
+  return new Promise((resolve34) => {
     process.stderr.write(`${question} `);
     rl.once("line", (answer) => {
       rl.close();
-      resolve33(/^y(es)?$/i.test(answer.trim()));
+      resolve34(/^y(es)?$/i.test(answer.trim()));
     });
   });
 }
@@ -27181,7 +27587,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((resolve33) => {
+  return new Promise((resolve34) => {
     process.stderr.write("\n");
     process.stderr.write(`\u2753 ${question}
 `);
@@ -27192,7 +27598,7 @@ async function askUser(question, options) {
     process.stderr.write("> ");
     rl.once("line", (answer) => {
       rl.close();
-      resolve33(answer.trim());
+      resolve34(answer.trim());
     });
   });
 }
@@ -27336,7 +27742,7 @@ function runScript(scriptPath, args = [], options = {}) {
 function runScriptCapture(scriptPath, args = [], options = {}) {
   const stream = options.stream ?? false;
   const { stream: _stream, ...spawnOptions } = options;
-  return new Promise((resolve33) => {
+  return new Promise((resolve34) => {
     const proc = (0, import_child_process.spawn)("bash", [scriptPath, ...args], {
       ...spawnOptions,
       stdio: ["inherit", "pipe", "pipe"]
@@ -27351,13 +27757,13 @@ function runScriptCapture(scriptPath, args = [], options = {}) {
       stderr += d2;
       if (stream) process.stderr.write(d2);
     });
-    proc.on("close", (code) => resolve33({ stdout, stderr, code: code ?? 0 }));
+    proc.on("close", (code) => resolve34({ stdout, stderr, code: code ?? 0 }));
   });
 }
 function runShellCommand(command2, options = {}) {
   const stream = options.stream ?? false;
   const { stream: _stream, ...spawnOptions } = options;
-  return new Promise((resolve33) => {
+  return new Promise((resolve34) => {
     const proc = (0, import_child_process.spawn)("bash", ["-lc", command2], {
       ...spawnOptions,
       stdio: ["inherit", "pipe", "pipe"]
@@ -27372,7 +27778,7 @@ function runShellCommand(command2, options = {}) {
       stderr += d2;
       if (stream) process.stderr.write(d2);
     });
-    proc.on("close", (code) => resolve33({ stdout, stderr, code: code ?? 0 }));
+    proc.on("close", (code) => resolve34({ stdout, stderr, code: code ?? 0 }));
   });
 }
 
@@ -28536,16 +28942,16 @@ async function promptScaffoldCursorRule(exists) {
 }
 async function askYesNo3(question) {
   const rl = readline4.createInterface({ input: process.stdin, output: process.stderr });
-  return new Promise((resolve33) => {
+  return new Promise((resolve34) => {
     process.stderr.write(`${question} `);
     rl.once("line", (answer) => {
       rl.close();
       const trimmed = answer.trim();
       if (trimmed === "") {
-        resolve33(true);
+        resolve34(true);
         return;
       }
-      resolve33(/^y(es)?$/i.test(trimmed));
+      resolve34(/^y(es)?$/i.test(trimmed));
     });
   });
 }
@@ -28652,6 +29058,19 @@ function readSlotRegistry(repoPath, agentId) {
 }
 
 // src/core/local-executor.ts
+function quoteShellArg(arg) {
+  if (/^[A-Za-z0-9_./:=+-]+$/.test(arg)) return arg;
+  return `'${arg.replace(/'/g, `'\\''`)}'`;
+}
+function buildLaunchFlagArgs(flags) {
+  const args = [];
+  if (flags.worktree === false) args.push("--no-worktree");
+  if (flags.claude) args.push("--claude");
+  if (flags.confirmReplace) args.push("--replace");
+  if (flags.force) args.push("--force");
+  if (flags.resume) args.push("--resume");
+  return args;
+}
 function resolveRepoPath(repoPath) {
   return path24.resolve(repoPath);
 }
@@ -28729,18 +29148,11 @@ function buildExecutionPlan(repoPath, stage, options) {
   };
   const cwd = stage.cwd ? path24.resolve(resolvedRepo, stage.cwd) : resolvedRepo;
   const extraArgs = options.args ?? [];
-  const launchFlagArgs = [];
-  if (stage.kind === "launch" && options.launchFlags) {
-    if (options.launchFlags.worktree === false) launchFlagArgs.push("--no-worktree");
-    if (options.launchFlags.claude) launchFlagArgs.push("--claude");
-    if (options.launchFlags.confirmReplace) launchFlagArgs.push("--replace");
-    if (options.launchFlags.force) launchFlagArgs.push("--force");
-    if (options.launchFlags.resume) launchFlagArgs.push("--resume");
-  }
+  const launchFlagArgs = stage.kind === "launch" && options.launchFlags ? buildLaunchFlagArgs(options.launchFlags) : [];
   if (stage.command) {
     let shellCommand = substituteAgentId(stage.command, options.agentId);
     for (const extra of [...extraArgs, ...launchFlagArgs]) {
-      shellCommand = `${shellCommand} ${extra}`;
+      shellCommand = `${shellCommand} ${quoteShellArg(extra)}`;
     }
     return { mode: "shell", shellCommand, args: [], cwd, env: mergedEnv };
   }
@@ -28833,15 +29245,7 @@ var localScriptExecutor = new LocalScriptExecutor();
 
 // src/core/control-sync.ts
 var path38 = __toESM(require("path"));
-
-// src/core/control-config.ts
-var DEFAULT_CONTROL_API_URL = "http://localhost:3847";
-function getControlApiUrl() {
-  return process.env.HAR_CONTROL_API_URL ?? DEFAULT_CONTROL_API_URL;
-}
-function isControlEnabled() {
-  return process.env.HAR_CONTROL_DISABLED !== "true";
-}
+init_control_config();
 
 // src/core/control-registry.ts
 var fs26 = __toESM(require("fs"));
@@ -29087,6 +29491,7 @@ var path30 = __toESM(require("path"));
 var import_child_process4 = require("child_process");
 var fs29 = __toESM(require("fs"));
 var path28 = __toESM(require("path"));
+init_control_config();
 
 // src/core/slot-ports.ts
 var import_child_process3 = require("child_process");
@@ -29793,7 +30198,6 @@ function collectSlotStatus(harnessRoot, agentId, runs, pm2Procs) {
     baseBranch: session?.baseBranch,
     baseCommit: session?.baseCommit,
     sessionCreatedAt: session?.createdAt,
-    purpose: session?.purpose,
     sessionStatus: session?.status,
     lastError: session?.lastError,
     resumeHint,
@@ -30032,105 +30436,19 @@ function createRemoteExecutor(apiUrl, apiKey) {
   return new RemoteExecutor(url, key);
 }
 
-// src/core/telemetry-config.ts
-var fs34 = __toESM(require("fs"));
-var os9 = __toESM(require("os"));
-var path34 = __toESM(require("path"));
-var DEFAULT_SIGNALS_ON = {
-  metrics: true,
-  logs: true,
-  prompts: false,
-  traces: false
-};
-var DEFAULT_SIGNALS_OFF = {
-  metrics: false,
-  logs: false,
-  prompts: false,
-  traces: false
-};
-function getPreferencePath() {
-  if (process.env.HAR_TELEMETRY_CONFIG_PATH) {
-    return path34.resolve(process.env.HAR_TELEMETRY_CONFIG_PATH);
-  }
-  return path34.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 normalizeSignals(enabled, raw) {
-  if (!enabled) return { ...DEFAULT_SIGNALS_OFF };
-  return {
-    metrics: raw?.metrics !== false,
-    logs: raw?.logs !== false,
-    prompts: raw?.prompts === true,
-    traces: raw?.traces === true
-  };
-}
-function readTelemetryPreference() {
-  const preferencePath = getPreferencePath();
-  try {
-    if (!fs34.existsSync(preferencePath)) {
-      return { enabled: true, signals: { ...DEFAULT_SIGNALS_ON } };
-    }
-    const parsed = JSON.parse(fs34.readFileSync(preferencePath, "utf8"));
-    const enabled = parsed.enabled !== false;
-    return {
-      enabled,
-      signals: normalizeSignals(enabled, parsed.signals),
-      updatedAt: typeof parsed.updatedAt === "string" ? parsed.updatedAt : void 0
-    };
-  } catch {
-    return { enabled: true, signals: { ...DEFAULT_SIGNALS_ON } };
-  }
-}
-function writeTelemetryPreference(enabled, signals) {
-  const current = readTelemetryPreference();
-  const nextSignals = normalizeSignals(enabled, {
-    ...current.signals,
-    ...signals
-  });
-  const preference = {
-    enabled,
-    signals: enabled ? nextSignals : { ...DEFAULT_SIGNALS_OFF },
-    updatedAt: (/* @__PURE__ */ new Date()).toISOString()
-  };
-  const preferencePath = getPreferencePath();
-  fs34.mkdirSync(path34.dirname(preferencePath), { recursive: true });
-  fs34.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 getTelemetrySignals() {
-  if (!isTelemetryEnabled()) return { ...DEFAULT_SIGNALS_OFF };
-  return readTelemetryPreference().signals;
-}
-function getTelemetryPreferencePath() {
-  return getPreferencePath();
-}
-var TELEMETRY_SIGNALS = [
-  "Metrics (default): tokens and estimated USD cost via OTEL metrics",
-  "Logs/events (default): session events (tool calls, api_request) without prompt bodies",
-  "Prompts (opt-in): user/assistant text via OTEL_LOG_USER_PROMPTS \u2014 har telemetry on --prompts",
-  "Traces (opt-in): thin span ingest when CLAUDE_CODE_ENHANCED_TELEMETRY_BETA=1",
-  "Fallback: har control sync harvests local Claude/Codex session files when OTEL is missing"
-];
+// src/core/control-sync.ts
+init_telemetry_config();
 
 // src/core/usage-harvest/claude.ts
 var fs36 = __toESM(require("fs"));
 var os10 = __toESM(require("os"));
 var path36 = __toESM(require("path"));
+init_telemetry_config();
 
 // src/core/telemetry-env.ts
 var fs35 = __toESM(require("fs"));
 var path35 = __toESM(require("path"));
+init_control_config();
 function escapeAttrValue(value) {
   return value.replace(/[,=]/g, "_");
 }
@@ -30143,7 +30461,6 @@ function buildOtelResourceAttributes(attrs) {
   ];
   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) {
@@ -30151,49 +30468,22 @@ function buildSessionKey(input) {
   const stamp = (input.createdAt ?? (/* @__PURE__ */ new Date()).toISOString()).replace(/[:.]/g, "-");
   return `agent-${input.agentId}-${input.suffix ?? stamp}`;
 }
-function buildTelemetryEnvBlock(attrs, options) {
+function buildTelemetryEnvBlock(attrs) {
   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)}`
+    `OTEL_RESOURCE_ATTRIBUTES=${buildOtelResourceAttributes(attrs)}`,
+    "# Agent telemetry: opentelemetry-hooks \u2192 Mission Control (har telemetry on|off)"
   ];
-  const injectOtel = isTelemetryEnabled() && options?.otelReady !== false;
-  if (injectOtel) {
-    const signals = getTelemetrySignals();
-    lines.push(
-      "# HAR telemetry \u2192 Mission Control OTLP (disable: har telemetry off)",
-      "CLAUDE_CODE_ENABLE_TELEMETRY=1",
-      "OTEL_EXPORTER_OTLP_PROTOCOL=http/json",
-      `OTEL_EXPORTER_OTLP_ENDPOINT=${apiUrl}/api/otel`
-    );
-    if (signals.metrics) {
-      lines.push("OTEL_METRICS_EXPORTER=otlp");
-    }
-    if (signals.logs) {
-      lines.push("OTEL_LOGS_EXPORTER=otlp");
-    }
-    if (signals.prompts) {
-      lines.push(
-        "OTEL_LOG_USER_PROMPTS=1",
-        "OTEL_LOG_ASSISTANT_RESPONSES=1"
-      );
-    }
-    if (signals.traces) {
-      lines.push(
-        "OTEL_TRACES_EXPORTER=otlp",
-        "CLAUDE_CODE_ENHANCED_TELEMETRY_BETA=1"
-      );
-    }
-  }
   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() + `
+function appendTelemetryEnvToFile(envFilePath, attrs) {
+  const block = buildTelemetryEnvBlock(attrs).trimEnd() + `
 ${TELEMETRY_MARKER_END}
 `;
   let existing = "";
@@ -30213,22 +30503,6 @@ ${TELEMETRY_MARKER_END}
   const combined = (existing.replace(/\n+$/, "\n") + block).replace(/^\n+/, "");
   fs35.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) {
@@ -30566,7 +30840,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((resolve33) => setTimeout(resolve33, intervalMs));
+    await new Promise((resolve34) => setTimeout(resolve34, intervalMs));
   }
   return false;
 }
@@ -30763,6 +31037,9 @@ function checkLaunchGuard2(repoPath, agentId, options = {}) {
   return { allowed: true, slot: occupied.slot, readiness };
 }
 
+// src/core/telemetry-ensure.ts
+init_control_config();
+
 // src/core/control-lifecycle.ts
 var import_child_process8 = require("child_process");
 var path39 = __toESM(require("path"));
@@ -30783,6 +31060,7 @@ function shouldBuildControlLocally() {
 }
 
 // src/core/control-lifecycle.ts
+init_control_config();
 var CONTROL_CONTAINER_NAME = "har-control";
 var CONTROL_DATA_VOLUME = "har_control_data";
 var CONTROL_CONTAINER_PORT = 3847;
@@ -30891,6 +31169,7 @@ async function startControlAndSync(options) {
 }
 
 // src/core/telemetry-ensure.ts
+init_telemetry_config();
 async function ensureTelemetryInfrastructure(options) {
   const apiUrl = getControlApiUrl();
   const telemetryEnabled = isTelemetryEnabled();
@@ -30989,7 +31268,8 @@ async function ensureTelemetryInfrastructure(options) {
 }
 
 // src/core/run-service.ts
-var path40 = __toESM(require("path"));
+init_telemetry_config();
+var path41 = __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 ?? "";
@@ -31110,17 +31390,26 @@ var RunService = class {
       };
     }
     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
+Usage from Cursor / Claude / Codex (opentelemetry-hooks) will appear under Worktrees. Disable: har telemetry off
 `;
       }
       if (ensured.warning) {
         telemetryBanner += `${ensured.warning}
+`;
+      }
+      try {
+        const { ensureOtelHooks: ensureOtelHooks2 } = await Promise.resolve().then(() => (init_otel_hooks(), otel_hooks_exports));
+        const hooks = ensureOtelHooks2({ setupAgents: true });
+        if (hooks.message) telemetryBanner += `${hooks.message}
+`;
+        if (hooks.warning) telemetryBanner += `${hooks.warning}
+`;
+      } catch (err) {
+        telemetryBanner += `opentelemetry-hooks setup skipped: ${err instanceof Error ? err.message : String(err)}
 `;
       }
     }
@@ -31153,21 +31442,16 @@ Usage from Claude Code / Codex will appear under Worktrees. Disable: har telemet
           suffix: session.suffix,
           createdAt: session.createdAt
         });
-        const envFile = path40.join(session.workDir, `.env.agent.${options.agentId}`);
+        const envFile = path41.join(session.workDir, `.env.agent.${options.agentId}`);
         try {
-          appendTelemetryEnvToFile(
-            envFile,
-            {
-              sessionKey,
-              agentId: options.agentId,
-              repoPath: path40.resolve(options.repoPath),
-              workDir: session.workDir,
-              branch: session.branch,
-              suffix: session.suffix,
-              purpose: session.purpose
-            },
-            { otelReady: otelReady && isTelemetryEnabled() }
-          );
+          appendTelemetryEnvToFile(envFile, {
+            sessionKey,
+            agentId: options.agentId,
+            repoPath: path41.resolve(options.repoPath),
+            workDir: session.workDir,
+            branch: session.branch,
+            suffix: session.suffix
+          });
         } catch {
         }
       }
@@ -31526,7 +31810,7 @@ var envCommand = {
   }
 };
 async function handleInit(argv) {
-  const repoPath = path41.resolve(argv.repo);
+  const repoPath = path42.resolve(argv.repo);
   header("har env init");
   info(`Repository: ${repoPath}`);
   try {
@@ -31584,7 +31868,7 @@ async function handleInit(argv) {
   }
 }
 async function handleMaintain(argv) {
-  const repoPath = path41.resolve(argv.repo);
+  const repoPath = path42.resolve(argv.repo);
   header("har env maintain");
   info(`Repository: ${repoPath}`);
   try {
@@ -31682,7 +31966,7 @@ async function handleAgentMdProposal(repoPath, autoYes) {
   if (autoYes) {
     const proposal = readAgentMdProposal(repoPath);
     if (proposal) {
-      writeFileSafe(path41.join(repoPath, "AGENT.md"), proposal.content);
+      writeFileSafe(path42.join(repoPath, "AGENT.md"), proposal.content);
       clearAgentMdProposal(repoPath);
       info("Applied AGENT.md proposal (--yes)");
     }
@@ -31691,7 +31975,7 @@ async function handleAgentMdProposal(repoPath, autoYes) {
   await promptApplyAgentMdProposal(repoPath);
 }
 async function handleAddStage(argv) {
-  const repoPath = path41.resolve(argv.repo);
+  const repoPath = path42.resolve(argv.repo);
   const available = listStageTemplateIds();
   if (argv.list) {
     for (const id of available) {
@@ -31768,7 +32052,7 @@ async function handleAddStage(argv) {
   }
 }
 async function handlePreflight(argv) {
-  const repo = path41.resolve(argv.repo);
+  const repo = path42.resolve(argv.repo);
   const agentId = validateAgentId(argv.id, repo);
   const result = await preflightEnvironment({
     repoPath: repo,
@@ -31786,7 +32070,7 @@ async function handlePreflight(argv) {
   process.exit(result.code);
 }
 async function handleLaunch(argv) {
-  const repo = path41.resolve(argv.repo);
+  const repo = path42.resolve(argv.repo);
   const agentId = validateAgentId(argv.id, repo);
   let confirmReplace = argv.replace;
   let force = argv.force;
@@ -31798,8 +32082,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((resolve33) => {
-          rl.question("Replace this slot? [y/N] ", resolve33);
+        const answer = await new Promise((resolve34) => {
+          rl.question("Replace this slot? [y/N] ", resolve34);
         });
         rl.close();
         if (!/^[Yy]$/.test(answer.trim())) {
@@ -31815,8 +32099,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((resolve33) => {
-          rl.question("Discard uncommitted changes? [y/N] ", resolve33);
+        const answer = await new Promise((resolve34) => {
+          rl.question("Discard uncommitted changes? [y/N] ", resolve34);
         });
         rl.close();
         if (!/^[Yy]$/.test(answer.trim())) {
@@ -31870,7 +32154,7 @@ async function handleRecover(argv) {
   });
 }
 async function handleVerify(argv) {
-  const repo = path41.resolve(argv.repo);
+  const repo = path42.resolve(argv.repo);
   const agentId = validateAgentId(argv.id, repo);
   const result = await runVerification({
     repoPath: repo,
@@ -31882,7 +32166,7 @@ async function handleVerify(argv) {
   process.exit(result.code);
 }
 async function handleTeardown(argv) {
-  const repo = path41.resolve(argv.repo);
+  const repo = path42.resolve(argv.repo);
   const agentId = validateAgentId(argv.id, repo);
   const result = await teardownEnvironment({
     repoPath: repo,
@@ -31893,7 +32177,7 @@ async function handleTeardown(argv) {
   process.exit(result.code);
 }
 async function handleComplete(argv) {
-  const repo = path41.resolve(argv.repo);
+  const repo = path42.resolve(argv.repo);
   const agentId = validateAgentId(argv.id, repo);
   const result = await completeEnvironment({
     repoPath: repo,
@@ -31914,7 +32198,7 @@ async function handleComplete(argv) {
   process.exit(result.code);
 }
 async function handleStatus(argv) {
-  const repoPath = path41.resolve(argv.repo);
+  const repoPath = path42.resolve(argv.repo);
   if (argv.json) {
     const status = collectEnvironmentStatus(repoPath);
     const output = EnvironmentStatusSchema.parse(status);
@@ -31927,7 +32211,7 @@ async function handleStatus(argv) {
   });
 }
 async function handleRunsList(argv) {
-  const repoPath = path41.resolve(argv.repo);
+  const repoPath = path42.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");
@@ -31944,7 +32228,7 @@ async function handleRunsList(argv) {
   }
 }
 async function handleRunsGet(argv) {
-  const run2 = getRun(path41.resolve(argv.repo), argv.runId);
+  const run2 = getRun(path42.resolve(argv.repo), argv.runId);
   if (!run2) {
     error(`Run not found: ${argv.runId}`);
     process.exit(1);
@@ -32023,7 +32307,8 @@ function printNextSteps(auto2) {
 }
 
 // src/cli/commands/control.ts
-var path42 = __toESM(require("path"));
+var path43 = __toESM(require("path"));
+init_control_config();
 var controlCommand = {
   command: "control <subcommand>",
   describe: "Mission Control dashboard (local)",
@@ -32126,7 +32411,7 @@ async function handleDown() {
   process.exit(code);
 }
 async function handleRegister(argv) {
-  const repoPath = path42.resolve(argv.repo);
+  const repoPath = path43.resolve(argv.repo);
   header("har control register");
   info(`Repository: ${repoPath}`);
   try {
@@ -32146,7 +32431,7 @@ async function handleRegister(argv) {
   }
 }
 async function handleSync(argv) {
-  const repoPath = path42.resolve(argv.repo);
+  const repoPath = path43.resolve(argv.repo);
   try {
     await syncRepoWithControl({
       repoPath,
@@ -32185,7 +32470,7 @@ async function handleWatch(argv) {
   };
   const tick = async () => {
     if (argv.repo) {
-      await syncOne(path42.resolve(argv.repo));
+      await syncOne(path43.resolve(argv.repo));
       return;
     }
     try {
@@ -32216,12 +32501,12 @@ async function handleLogin(argv) {
 }
 
 // src/cli/commands/hooks.ts
-var path45 = __toESM(require("path"));
+var path46 = __toESM(require("path"));
 
 // src/core/hooks.ts
-var fs38 = __toESM(require("fs"));
-var os12 = __toESM(require("os"));
-var path43 = __toESM(require("path"));
+var fs39 = __toESM(require("fs"));
+var os13 = __toESM(require("os"));
+var path44 = __toESM(require("path"));
 var MARKER_START = "# >>> har commit gate (managed by `har hooks`) >>>";
 var MARKER_END = "# <<< har commit gate <<<";
 var PRE_COMMIT_BLOCK = [
@@ -32246,7 +32531,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 path43.resolve(checkoutDir, hooksPath);
+  return path44.resolve(checkoutDir, hooksPath);
 }
 function getConfiguredHooksPath(checkoutDir) {
   return tryGit2(checkoutDir, "config core.hooksPath") || void 0;
@@ -32254,9 +32539,9 @@ function getConfiguredHooksPath(checkoutDir) {
 function defaultHarInvocation() {
   const entry = process.argv[1];
   if (entry && entry.endsWith(".js")) {
-    return `"${process.execPath}" "${path43.resolve(entry)}"`;
+    return `"${process.execPath}" "${path44.resolve(entry)}"`;
   }
-  if (entry) return `"${path43.resolve(entry)}"`;
+  if (entry) return `"${path44.resolve(entry)}"`;
   return "har";
 }
 function buildHookScript(harInvocation, subcommand, failOpenNotice) {
@@ -32277,40 +32562,40 @@ exit 0
 `;
 }
 function upsertMarkedBlock(filePath, block) {
-  if (!fs38.existsSync(filePath)) {
-    fs38.writeFileSync(filePath, `#!/bin/sh
+  if (!fs39.existsSync(filePath)) {
+    fs39.writeFileSync(filePath, `#!/bin/sh
 ${block}
 `, { mode: 493 });
     return "created";
   }
-  const content = fs38.readFileSync(filePath, "utf8");
+  const content = fs39.readFileSync(filePath, "utf8");
   if (content.includes(MARKER_START)) {
     const pattern = new RegExp(
       `${escapeRegExp(MARKER_START)}[\\s\\S]*?${escapeRegExp(MARKER_END)}`
     );
-    fs38.writeFileSync(filePath, content.replace(pattern, block));
-    fs38.chmodSync(filePath, 493);
+    fs39.writeFileSync(filePath, content.replace(pattern, block));
+    fs39.chmodSync(filePath, 493);
     return "updated";
   }
   const suffix = content.endsWith("\n") ? "" : "\n";
-  fs38.writeFileSync(filePath, `${content}${suffix}
+  fs39.writeFileSync(filePath, `${content}${suffix}
 ${block}
 `);
-  fs38.chmodSync(filePath, 493);
+  fs39.chmodSync(filePath, 493);
   return "appended";
 }
 function removeMarkedBlock(filePath) {
-  if (!fs38.existsSync(filePath)) return false;
-  const content = fs38.readFileSync(filePath, "utf8");
+  if (!fs39.existsSync(filePath)) return false;
+  const content = fs39.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() === "") {
-    fs38.rmSync(filePath);
+    fs39.rmSync(filePath);
   } else {
-    fs38.writeFileSync(filePath, stripped);
+    fs39.writeFileSync(filePath, stripped);
   }
   return true;
 }
@@ -32332,20 +32617,20 @@ Or re-run with --force to write into that directory anyway.`
     );
   }
   const hooksDir = resolveHooksDir(checkout);
-  fs38.mkdirSync(hooksDir, { recursive: true });
+  fs39.mkdirSync(hooksDir, { recursive: true });
   const invocation = options.harInvocation ?? defaultHarInvocation();
-  fs38.writeFileSync(
-    path43.join(hooksDir, "har-pre-commit"),
+  fs39.writeFileSync(
+    path44.join(hooksDir, "har-pre-commit"),
     buildHookScript(invocation, "check", "har: binary not found; skipping commit gate (reinstall with har hooks install)"),
     { mode: 493 }
   );
-  fs38.writeFileSync(
-    path43.join(hooksDir, "har-post-commit"),
+  fs39.writeFileSync(
+    path44.join(hooksDir, "har-post-commit"),
     buildHookScript(invocation, "record-commit", "har: binary not found; skipping commit association"),
     { mode: 493 }
   );
-  const preCommit = upsertMarkedBlock(path43.join(hooksDir, "pre-commit"), PRE_COMMIT_BLOCK);
-  const postCommit = upsertMarkedBlock(path43.join(hooksDir, "post-commit"), POST_COMMIT_BLOCK);
+  const preCommit = upsertMarkedBlock(path44.join(hooksDir, "pre-commit"), PRE_COMMIT_BLOCK);
+  const postCommit = upsertMarkedBlock(path44.join(hooksDir, "post-commit"), POST_COMMIT_BLOCK);
   ensureValidationsIgnored(checkout);
   return { hooksDir, preCommit, postCommit };
 }
@@ -32354,12 +32639,12 @@ function uninstallHooks(repoPath) {
   if (!checkout) throw new Error(`Not a git repository: ${repoPath}`);
   const hooksDir = resolveHooksDir(checkout);
   let removed = false;
-  removed = removeMarkedBlock(path43.join(hooksDir, "pre-commit")) || removed;
-  removed = removeMarkedBlock(path43.join(hooksDir, "post-commit")) || removed;
+  removed = removeMarkedBlock(path44.join(hooksDir, "pre-commit")) || removed;
+  removed = removeMarkedBlock(path44.join(hooksDir, "post-commit")) || removed;
   for (const file of ["har-pre-commit", "har-post-commit"]) {
-    const full = path43.join(hooksDir, file);
-    if (fs38.existsSync(full)) {
-      fs38.rmSync(full);
+    const full = path44.join(hooksDir, file);
+    if (fs39.existsSync(full)) {
+      fs39.rmSync(full);
       removed = true;
     }
   }
@@ -32376,9 +32661,9 @@ function getCommitGateConfig(checkoutDir) {
 function isAgentWorktree(checkoutDir) {
   const branch = getCurrentBranch(checkoutDir);
   if (branch && /^har-agent-\d+$/.test(branch)) return true;
-  const worktreesRoot = path43.join(os12.homedir(), "worktrees");
-  const resolved = path43.resolve(checkoutDir);
-  return resolved.startsWith(`${worktreesRoot}${path43.sep}`) && /-agent-\d+$/.test(path43.basename(resolved));
+  const worktreesRoot = path44.join(os13.homedir(), "worktrees");
+  const resolved = path44.resolve(checkoutDir);
+  return resolved.startsWith(`${worktreesRoot}${path44.sep}`) && /-agent-\d+$/.test(path44.basename(resolved));
 }
 function resolveEffectiveMode(checkoutDir, gate) {
   if (!gate.enabled) return "off";
@@ -32391,15 +32676,15 @@ function getHooksStatus(repoPath) {
   const hooksDir = resolveHooksDir(checkout);
   const gate = getCommitGateConfig(checkout);
   const hasBlock = (name) => {
-    const file = path43.join(hooksDir, name);
-    return fs38.existsSync(file) && fs38.readFileSync(file, "utf8").includes(MARKER_START);
+    const file = path44.join(hooksDir, name);
+    return fs39.existsSync(file) && fs39.readFileSync(file, "utf8").includes(MARKER_START);
   };
   return {
     checkout,
     hooksDir,
     configuredHooksPath: getConfiguredHooksPath(checkout),
-    preCommitInstalled: hasBlock("pre-commit") && fs38.existsSync(path43.join(hooksDir, "har-pre-commit")),
-    postCommitInstalled: hasBlock("post-commit") && fs38.existsSync(path43.join(hooksDir, "har-post-commit")),
+    preCommitInstalled: hasBlock("pre-commit") && fs39.existsSync(path44.join(hooksDir, "har-pre-commit")),
+    postCommitInstalled: hasBlock("post-commit") && fs39.existsSync(path44.join(hooksDir, "har-post-commit")),
     gate,
     effectiveMode: resolveEffectiveMode(checkout, gate)
   };
@@ -32410,7 +32695,7 @@ function checkCommitGate(cwd) {
   }
   const checkout = resolveCheckoutRoot(cwd);
   if (!checkout) return { exitCode: 0, messages: [] };
-  if (!fs38.existsSync(path43.join(checkout, ".har", "stages.json"))) {
+  if (!fs39.existsSync(path44.join(checkout, ".har", "stages.json"))) {
     return { exitCode: 0, messages: [] };
   }
   const gate = getCommitGateConfig(checkout);
@@ -32481,8 +32766,8 @@ async function recordCommitAssociation(cwd) {
 }
 
 // src/core/claude-hooks.ts
-var fs39 = __toESM(require("fs"));
-var path44 = __toESM(require("path"));
+var fs40 = __toESM(require("fs"));
+var path45 = __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";
@@ -32493,8 +32778,8 @@ function isHarGuardEntry(entry) {
   );
 }
 function readSettings(settingsPath) {
-  if (!fs39.existsSync(settingsPath)) return {};
-  const raw = fs39.readFileSync(settingsPath, "utf8").trim();
+  if (!fs40.existsSync(settingsPath)) return {};
+  const raw = fs40.readFileSync(settingsPath, "utf8").trim();
   if (raw === "") return {};
   const parsed = JSON.parse(raw);
   if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
@@ -32503,19 +32788,19 @@ function readSettings(settingsPath) {
   return parsed;
 }
 function writeSettings(settingsPath, settings) {
-  fs39.mkdirSync(path44.dirname(settingsPath), { recursive: true });
-  fs39.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + "\n");
+  fs40.mkdirSync(path45.dirname(settingsPath), { recursive: true });
+  fs40.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 = path44.join(repoPath, CLAUDE_GUARD_RELATIVE_PATH);
-  fs39.mkdirSync(path44.dirname(guardScript), { recursive: true });
-  fs39.copyFileSync(templatePath, guardScript);
-  fs39.chmodSync(guardScript, 493);
-  const settingsPath = path44.join(repoPath, CLAUDE_SETTINGS_RELATIVE_PATH);
+  const guardScript = path45.join(repoPath, CLAUDE_GUARD_RELATIVE_PATH);
+  fs40.mkdirSync(path45.dirname(guardScript), { recursive: true });
+  fs40.copyFileSync(templatePath, guardScript);
+  fs40.chmodSync(guardScript, 493);
+  const settingsPath = path45.join(repoPath, CLAUDE_SETTINGS_RELATIVE_PATH);
   const settings = readSettings(settingsPath);
   const hooks = settings.hooks ?? {};
   const preToolUse = (hooks.PreToolUse ?? []).filter((entry) => !isHarGuardEntry(entry));
@@ -32529,15 +32814,15 @@ function installClaudeGuard(repoPath) {
 }
 function uninstallClaudeGuard(repoPath) {
   let removed = false;
-  const guardScript = path44.join(repoPath, CLAUDE_GUARD_RELATIVE_PATH);
-  if (fs39.existsSync(guardScript)) {
-    fs39.rmSync(guardScript);
+  const guardScript = path45.join(repoPath, CLAUDE_GUARD_RELATIVE_PATH);
+  if (fs40.existsSync(guardScript)) {
+    fs40.rmSync(guardScript);
     removed = true;
-    const parent = path44.dirname(guardScript);
-    if (fs39.existsSync(parent) && fs39.readdirSync(parent).length === 0) fs39.rmdirSync(parent);
+    const parent = path45.dirname(guardScript);
+    if (fs40.existsSync(parent) && fs40.readdirSync(parent).length === 0) fs40.rmdirSync(parent);
   }
-  const settingsPath = path44.join(repoPath, CLAUDE_SETTINGS_RELATIVE_PATH);
-  if (fs39.existsSync(settingsPath)) {
+  const settingsPath = path45.join(repoPath, CLAUDE_SETTINGS_RELATIVE_PATH);
+  if (fs40.existsSync(settingsPath)) {
     const settings = readSettings(settingsPath);
     const preToolUse = settings.hooks?.PreToolUse;
     if (preToolUse) {
@@ -32562,8 +32847,8 @@ function uninstallClaudeGuard(repoPath) {
   return { removed };
 }
 function claudeGuardInstalled(repoPath) {
-  const settingsPath = path44.join(repoPath, CLAUDE_SETTINGS_RELATIVE_PATH);
-  if (!fs39.existsSync(settingsPath)) return false;
+  const settingsPath = path45.join(repoPath, CLAUDE_SETTINGS_RELATIVE_PATH);
+  if (!fs40.existsSync(settingsPath)) return false;
   try {
     const settings = readSettings(settingsPath);
     return (settings.hooks?.PreToolUse ?? []).some(isHarGuardEntry);
@@ -32579,7 +32864,7 @@ function repoOption(y2) {
 function handleInstall2(argv) {
   try {
     if (argv.claude) {
-      const result2 = installClaudeGuard(path45.resolve(argv.repo));
+      const result2 = installClaudeGuard(path46.resolve(argv.repo));
       success("Claude Code worktree guard installed.");
       info(`Guard script:  ${result2.guardScript}`);
       info(`Settings:      ${result2.settingsPath} (PreToolUse: Edit|Write|MultiEdit|NotebookEdit)`);
@@ -32587,7 +32872,7 @@ function handleInstall2(argv) {
       info("Commit both files so the guard travels with the repo.");
       return;
     }
-    const result = installHooks({ repoPath: path45.resolve(argv.repo), force: argv.force });
+    const result = installHooks({ repoPath: path46.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.");
@@ -32600,7 +32885,7 @@ function handleInstall2(argv) {
 function handleUninstall(argv) {
   try {
     if (argv.claude) {
-      const result2 = uninstallClaudeGuard(path45.resolve(argv.repo));
+      const result2 = uninstallClaudeGuard(path46.resolve(argv.repo));
       if (result2.removed) {
         success("Claude Code worktree guard removed.");
       } else {
@@ -32608,7 +32893,7 @@ function handleUninstall(argv) {
       }
       return;
     }
-    const result = uninstallHooks(path45.resolve(argv.repo));
+    const result = uninstallHooks(path46.resolve(argv.repo));
     if (result.removed) {
       success(`Commit gate removed from ${result.hooksDir}`);
     } else {
@@ -32621,7 +32906,7 @@ function handleUninstall(argv) {
 }
 function handleStatus2(argv) {
   try {
-    const status = getHooksStatus(path45.resolve(argv.repo));
+    const status = getHooksStatus(path46.resolve(argv.repo));
     if (argv.json) {
       process.stdout.write(`${JSON.stringify(status, null, 2)}
 `);
@@ -32639,7 +32924,7 @@ function handleStatus2(argv) {
     );
     info(`Effective:     ${status.effectiveMode} (in this checkout)`);
     info(
-      `Claude guard:  ${claudeGuardInstalled(path45.resolve(argv.repo)) ? `installed (${CLAUDE_GUARD_RELATIVE_PATH})` : "not installed"}`
+      `Claude guard:  ${claudeGuardInstalled(path46.resolve(argv.repo)) ? `installed (${CLAUDE_GUARD_RELATIVE_PATH})` : "not installed"}`
     );
   } catch (err) {
     error(err instanceof Error ? err.message : String(err));
@@ -32900,10 +33185,10 @@ function assignProp(target, prop, value) {
     configurable: true
   });
 }
-function getElementAtPath(obj, path48) {
-  if (!path48)
+function getElementAtPath(obj, path49) {
+  if (!path49)
     return obj;
-  return path48.reduce((acc, key) => acc?.[key], obj);
+  return path49.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject(promisesObj) {
   const keys = Object.keys(promisesObj);
@@ -33223,11 +33508,11 @@ function aborted(x2, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues(path48, issues) {
+function prefixIssues(path49, issues) {
   return issues.map((iss) => {
     var _a3;
     (_a3 = iss).path ?? (_a3.path = []);
-    iss.path.unshift(path48);
+    iss.path.unshift(path49);
     return iss;
   });
 }
@@ -38550,7 +38835,7 @@ var Protocol = class {
           return;
         }
         const pollInterval = task2.pollInterval ?? this._options?.defaultTaskPollInterval ?? 1e3;
-        await new Promise((resolve33) => setTimeout(resolve33, pollInterval));
+        await new Promise((resolve34) => setTimeout(resolve34, pollInterval));
         options?.signal?.throwIfAborted();
       }
     } catch (error3) {
@@ -38567,7 +38852,7 @@ var Protocol = class {
    */
   request(request, resultSchema, options) {
     const { relatedRequestId, resumptionToken, onresumptiontoken, task, relatedTask } = options ?? {};
-    return new Promise((resolve33, reject) => {
+    return new Promise((resolve34, reject) => {
       const earlyReject = (error3) => {
         reject(error3);
       };
@@ -38645,7 +38930,7 @@ var Protocol = class {
           if (!parseResult.success) {
             reject(parseResult.error);
           } else {
-            resolve33(parseResult.data);
+            resolve34(parseResult.data);
           }
         } catch (error3) {
           reject(error3);
@@ -38906,12 +39191,12 @@ var Protocol = class {
       }
     } catch {
     }
-    return new Promise((resolve33, reject) => {
+    return new Promise((resolve34, reject) => {
       if (signal.aborted) {
         reject(new McpError(ErrorCode.InvalidRequest, "Request cancelled"));
         return;
       }
-      const timeoutId = setTimeout(resolve33, interval);
+      const timeoutId = setTimeout(resolve34, interval);
       signal.addEventListener("abort", () => {
         clearTimeout(timeoutId);
         reject(new McpError(ErrorCode.InvalidRequest, "Request cancelled"));
@@ -39701,7 +39986,7 @@ var Server = class extends Protocol {
 };
 
 // src/mcp/server.ts
-var path46 = __toESM(require("path"));
+var path47 = __toESM(require("path"));
 
 // node_modules/@modelcontextprotocol/sdk/dist/esm/server/stdio.js
 var import_node_process2 = __toESM(require("node:process"), 1);
@@ -39784,12 +40069,12 @@ var StdioServerTransport = class {
     this.onclose?.();
   }
   send(message) {
-    return new Promise((resolve33) => {
+    return new Promise((resolve34) => {
       const json = serializeMessage(message);
       if (this._stdout.write(json)) {
-        resolve33();
+        resolve34();
       } else {
-        this._stdout.once("drain", resolve33);
+        this._stdout.once("drain", resolve34);
       }
     });
   }
@@ -40333,7 +40618,7 @@ async function handleMcpToolCall(toolName, args, defaultRepo = ".") {
       const input = ControlUpInputSchema.parse({ ...args, repo });
       const result = await startControlAndSync({
         detach: input.detach,
-        cwd: path46.resolve(input.repo)
+        cwd: path47.resolve(input.repo)
       });
       if (result.code !== 0) {
         return {
@@ -40396,8 +40681,10 @@ var mcpCommand = {
 };
 
 // src/cli/commands/telemetry.ts
-var fs40 = __toESM(require("fs"));
-var path47 = __toESM(require("path"));
+var path48 = __toESM(require("path"));
+init_control_config();
+init_otel_hooks();
+init_telemetry_config();
 function printSignals() {
   info("Collected when enabled (local Mission Control only):");
   for (const signal of TELEMETRY_SIGNALS) {
@@ -40421,6 +40708,8 @@ async function handleStatus3(argv) {
     controlApiUrl: apiUrl,
     controlReachable: reachable,
     otelEndpoint: `${apiUrl.replace(/\/$/, "")}/api/otel`,
+    otelHooksHome: getOtelHooksHome(),
+    otelHooksConfig: getOtelHooksConfigPath(),
     signalDescriptions: [...TELEMETRY_SIGNALS]
   };
   if (argv.json) {
@@ -40436,25 +40725,29 @@ async function handleStatus3(argv) {
   );
   info(`Mission Control: ${apiUrl} (${reachable ? "reachable" : "not reachable"})`);
   info(`OTLP endpoint: ${payload.otelEndpoint}`);
+  info(`Hooks home:    ${payload.otelHooksHome}`);
   printSignals();
 }
 async function handleOn(argv) {
   header("har telemetry on");
   const preference = writeTelemetryPreference(true, {
     prompts: argv.prompts === true ? true : void 0,
-    traces: argv.traces === true ? true : void 0
+    traces: true
   });
-  success("Telemetry enabled (opt-out). Agent usage will be stored in local Mission Control.");
+  success("Telemetry enabled. Cursor / Claude / Codex export via opentelemetry-hooks \u2192 Mission Control.");
   info(
     `Signals: metrics=${preference.signals.metrics} logs=${preference.signals.logs} prompts=${preference.signals.prompts} traces=${preference.signals.traces}`
   );
   if (preference.signals.prompts) {
-    warn("Prompt/response text will leave the agent machine for local Mission Control storage.");
+    warn("Prompt text will leave the agent machine for local Mission Control (also used as session purpose).");
   }
   printSignals();
   const result = await ensureTelemetryInfrastructure({ startIfNeeded: true });
   if (result.message) success(result.message);
   if (result.warning) warn(result.warning);
+  const hooks = ensureOtelHooks({ setupAgents: true });
+  if (hooks.message) success(hooks.message);
+  if (hooks.warning) warn(hooks.warning);
   if (result.otelReady) {
     info(`OTLP ingest: ${result.apiUrl.replace(/\/$/, "")}/api/otel`);
     info("Usage appears under Mission Control \u2192 Worktrees / Usage. Disable: har telemetry off");
@@ -40463,44 +40756,48 @@ async function handleOn(argv) {
 async function handleOff() {
   header("har telemetry off");
   writeTelemetryPreference(false);
+  try {
+    disableOtelHooksExport();
+  } catch (err) {
+    warn(`Could not refresh hooks config: ${err instanceof Error ? err.message : String(err)}`);
+  }
   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.");
+  info("Hooks stay registered but OTLP export is cleared in ~/.har/otel-hooks/otel_config.json.");
+  info("Mission Control will not auto-start. Existing usage rows are kept.");
 }
 async function handleWriteEnv(argv) {
-  const repoPath = path47.resolve(argv.repo);
+  const repoPath = path48.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 ?? path47.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 envFile = argv.envFile ?? path48.join(workDir, `.env.agent.${argv.agentId}`);
   const attrs = {
     sessionKey,
     agentId: argv.agentId,
     repoPath,
     workDir,
     branch,
-    suffix,
-    purpose
+    suffix
   };
-  appendTelemetryEnvToFile(envFile, attrs, { otelReady: otelReady !== false && isTelemetryEnabled() });
-  success(`Wrote telemetry env to ${envFile}`);
+  appendTelemetryEnvToFile(envFile, attrs);
+  if (isTelemetryEnabled()) {
+    ensureOtelHooks({
+      setupAgents: false,
+      resourceAttributes: buildOtelResourceAttributes(attrs)
+    });
+  }
+  success(`Wrote session attribution to ${envFile}`);
 }
 function handlePrintEnv(argv) {
-  const repoPath = path47.resolve(argv.repo);
+  const repoPath = path48.resolve(argv.repo);
   const workDir = argv.workDir ?? repoPath;
   const sessionKey = buildSessionKey({
     branch: argv.branch,
@@ -40508,55 +40805,38 @@ function handlePrintEnv(argv) {
     suffix: argv.suffix
   });
   process.stdout.write(
-    buildTelemetryEnvBlock(
-      {
-        sessionKey,
-        agentId: argv.agentId,
-        repoPath,
-        workDir,
-        branch: argv.branch,
-        suffix: argv.suffix
-      },
-      { otelReady: argv.otelReady && isTelemetryEnabled() }
-    )
+    buildTelemetryEnvBlock({
+      sessionKey,
+      agentId: argv.agentId,
+      repoPath,
+      workDir,
+      branch: argv.branch,
+      suffix: argv.suffix
+    })
   );
 }
-function handleCodexSnippet(argv) {
-  const repoPath = path47.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 = path47.join(harnessRoot, ".har", "telemetry");
-    fs40.mkdirSync(outDir, { recursive: true });
-    const outPath = path47.join(outDir, "codex.otel.toml.snippet");
-    fs40.writeFileSync(outPath, snippet);
-    success(`Wrote ${outPath}`);
-    info("Merge the [otel] table into ~/.codex/config.toml manually.");
-    return;
+async function handleInstallHooks() {
+  header("har telemetry install-hooks");
+  if (!isTelemetryEnabled()) {
+    warn("Telemetry is off \u2014 enabling preference so hooks can export.");
+    writeTelemetryPreference(true, { traces: true });
+  }
+  const result = await ensureTelemetryInfrastructure({ startIfNeeded: true });
+  if (result.message) success(result.message);
+  if (result.warning) warn(result.warning);
+  const hooks = ensureOtelHooks({ setupAgents: true });
+  if (hooks.ok) {
+    success(hooks.message ?? "opentelemetry-hooks installed and agents registered");
+    info(`Config: ${hooks.configPath}`);
+    info(`Wrapper: ${hooks.wrapperPath}`);
+  } else {
+    error(hooks.warning ?? "Failed to install opentelemetry-hooks");
+    process.exitCode = 1;
   }
-  process.stdout.write(snippet);
 }
 var telemetryCommand = {
   command: "telemetry <subcommand>",
-  describe: "Agent usage telemetry (Claude Code / Codex \u2192 Mission Control)",
+  describe: "Agent usage telemetry (Cursor / Claude / Codex via opentelemetry-hooks \u2192 Mission Control)",
   builder: (yargs) => yargs.command(
     "status",
     "Show telemetry preference and Mission Control reachability",
@@ -40566,34 +40846,40 @@ var telemetryCommand = {
     }
   ).command(
     "on",
-    "Enable telemetry (default) and ensure Mission Control is running",
+    "Enable telemetry, ensure Mission Control, install/configure opentelemetry-hooks",
     (y2) => y2.option("prompts", {
       type: "boolean",
       default: false,
-      describe: "Opt in to shipping user/assistant prompt text to Mission Control"
-    }).option("traces", {
-      type: "boolean",
-      default: false,
-      describe: "Opt in to thin OTEL traces ingest (Claude beta)"
+      describe: "Opt in to shipping user prompt text (also fills Mission Control purpose)"
     }),
     (argv) => {
       void handleOn({
-        prompts: argv.prompts,
-        traces: argv.traces
+        prompts: argv.prompts
       });
     }
   ).command(
     "off",
-    "Disable telemetry (no OTEL injection, no MC auto-start)",
+    "Disable telemetry (clear hooks OTLP endpoint, no MC auto-start)",
     () => {
     },
     () => {
       void handleOff();
     }
+  ).command(
+    "install-hooks",
+    "Install opentelemetry-hooks and register Cursor / Claude / Codex",
+    () => {
+    },
+    () => {
+      void handleInstallHooks().catch((err) => {
+        error(err instanceof Error ? err.message : String(err));
+        process.exitCode = 1;
+      });
+    }
   ).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" }),
+    "Append HAR session attribution to .env.agent.<id> and refresh hooks config",
+    (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("session-key", { type: "string" }),
     (argv) => handleWriteEnv({
       agentId: argv["agent-id"],
       repo: argv.repo,
@@ -40601,42 +40887,23 @@ var telemetryCommand = {
       workDir: argv["work-dir"],
       branch: argv.branch,
       suffix: argv.suffix,
-      purpose: argv.purpose,
-      sessionKey: argv["session-key"],
-      otelReady: argv["otel-ready"]
+      sessionKey: argv["session-key"]
     }).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 }),
+    "Print session attribution 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" }),
     (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
+      suffix: argv.suffix
     })
-  ).demandCommand(1, "Please specify a subcommand: status, on, off, write-env, print-env, codex-snippet"),
+  ).demandCommand(1, "Please specify a subcommand: status, on, off, install-hooks, write-env, print-env"),
   handler: () => {
   }
 };