oh-langfuse 0.1.60 → 0.1.62

package/scripts/real-self-verify.mjs

@@ -9,9 +9,10 @@ import { resolveOpencodeCli } from "./resolve-opencode-cli.mjs";
 const rootDir = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
 const packageJson = JSON.parse(fs.readFileSync(path.join(rootDir, "package.json"), "utf8"));
 
-const DEFAULT_LANGFUSE_BASE_URL = "http://120.46.221.227:3000";
-const DEFAULT_LANGFUSE_PUBLIC_KEY = "pk-lf-da0c90a7-6e93-4eb7-bb86-c1047c8d187d";
-const DEFAULT_LANGFUSE_SECRET_KEY = "sk-lf-0269b85d-bfdc-442c-bfa3-e737954e3315";
+const DEFAULT_LANGFUSE_BASE_URL = "http://120.46.221.227:3000";
+const DEFAULT_LANGFUSE_PUBLIC_KEY = "pk-lf-da0c90a7-6e93-4eb7-bb86-c1047c8d187d";
+const DEFAULT_LANGFUSE_SECRET_KEY = "sk-lf-0269b85d-bfdc-442c-bfa3-e737954e3315";
+const OPENCODE_NATIVE_AGENT_TURN_NAMES = new Set(["session.llm:ai.streamText.doStream"]);
 
 function parseArgs(argv) {
   const args = { _: [] };
@@ -136,36 +137,36 @@ function printRunResult(label, result) {
   }
 }
 
-function findOnPath(names) {
-  for (const name of names) {
-    const probe = run(name, ["--version"], { timeoutMs: 15000 });
-    if (probe.status === 0) return name;
-  }
-  return "";
-}
-
-function localCodexCliCandidates() {
-  if (process.platform !== "win32") return ["codex"];
-  const localAppData = process.env.LOCALAPPDATA || path.join(os.homedir(), "AppData", "Local");
-  const codexBin = path.join(localAppData, "OpenAI", "Codex", "bin");
-  const candidates = [
-    process.env.CODEX_CLI_PATH || "",
-    path.join(codexBin, "codex.exe"),
-  ];
-  try {
-    if (fs.existsSync(codexBin)) {
-      for (const ent of fs.readdirSync(codexBin, { withFileTypes: true })) {
-        if (ent.isDirectory()) candidates.push(path.join(codexBin, ent.name, "codex.exe"));
-      }
-    }
-  } catch {
-    // Fall back to PATH probing below.
-  }
-  return [...candidates, "codex.cmd", "codex.exe", "codex"].filter(Boolean);
-}
-
-function configFromArgs(args) {
-  return {
+function findOnPath(names) {
+  for (const name of names) {
+    const probe = run(name, ["--version"], { timeoutMs: 15000 });
+    if (probe.status === 0) return name;
+  }
+  return "";
+}
+
+function localCodexCliCandidates() {
+  if (process.platform !== "win32") return ["codex"];
+  const localAppData = process.env.LOCALAPPDATA || path.join(os.homedir(), "AppData", "Local");
+  const codexBin = path.join(localAppData, "OpenAI", "Codex", "bin");
+  const candidates = [
+    process.env.CODEX_CLI_PATH || "",
+    path.join(codexBin, "codex.exe"),
+  ];
+  try {
+    if (fs.existsSync(codexBin)) {
+      for (const ent of fs.readdirSync(codexBin, { withFileTypes: true })) {
+        if (ent.isDirectory()) candidates.push(path.join(codexBin, ent.name, "codex.exe"));
+      }
+    }
+  } catch {
+    // Fall back to PATH probing below.
+  }
+  return [...candidates, "codex.cmd", "codex.exe", "codex"].filter(Boolean);
+}
+
+function configFromArgs(args) {
+  return {
     baseUrl:
       String(args.langfuseBaseUrl || args.langfuseHost || args.host || process.env.LANGFUSE_BASEURL || process.env.LANGFUSE_HOST || DEFAULT_LANGFUSE_BASE_URL),
     publicKey: String(args.publicKey || process.env.LANGFUSE_PUBLIC_KEY || DEFAULT_LANGFUSE_PUBLIC_KEY),
@@ -233,9 +234,9 @@ function triggerOpenCode(prompt, args, env) {
   return last;
 }
 
-function triggerCodex(prompt, args, env) {
-  const cmd = String(args.codexCmd || findOnPath(localCodexCliCandidates()));
-  if (!cmd) return { status: 127, stdout: "", stderr: "Codex CLI not found. Set --codexCmd=<path>.", command: "codex", args: [] };
+function triggerCodex(prompt, args, env) {
+  const cmd = String(args.codexCmd || findOnPath(localCodexCliCandidates()));
+  if (!cmd) return { status: 127, stdout: "", stderr: "Codex CLI not found. Set --codexCmd=<path>.", command: "codex", args: [] };
   const candidates = [
     ["exec", prompt],
     ["exec", "--skip-git-repo-check", prompt],
@@ -322,31 +323,34 @@ function metadataValue(item, key) {
   const attrs = metadata.attributes || {};
   const prefixed = `langfuse.observation.metadata.${key}`;
   if (attrs[prefixed] !== undefined) return attrs[prefixed];
-  const ohKey = `oh.langfuse.${key}`;
-  if (attrs[ohKey] !== undefined) return attrs[ohKey];
-  if (metadata.source === "opencode" || attrs["oh.langfuse.source"] === "opencode") {
-    if (key === "interaction_id") return `opencode:${metadata.user_id || attrs["oh.langfuse.user_id"] || "unknown"}:${item?.id || item?.traceId || item?.trace_id || "unknown"}`;
-    if (key === "token_metrics_available") {
-      return [
-        "ai.usage.inputTokens",
-        "ai.usage.outputTokens",
-        "ai.usage.totalTokens",
+  const ohKey = `oh.langfuse.${key}`;
+  if (attrs[ohKey] !== undefined) return attrs[ohKey];
+  if (metadata.source === "opencode" || attrs["oh.langfuse.source"] === "opencode") {
+    const usage = item?.usage || {};
+    if (key === "interaction_id") return `opencode:${metadata.user_id || attrs["oh.langfuse.user_id"] || "unknown"}:${item?.id || item?.traceId || item?.trace_id || "unknown"}`;
+    if (key === "interaction_count") return 1;
+    if (key === "token_metrics_available") {
+      return usage.input !== undefined || usage.output !== undefined || usage.total !== undefined || [
+        "ai.usage.inputTokens",
+        "ai.usage.outputTokens",
+        "ai.usage.totalTokens",
         "ai.usage.promptTokens",
         "ai.usage.completionTokens",
       ].some((attrKey) => attrs[attrKey] !== undefined);
     }
-    if (key === "tool_call_count" || key === "skill_use_count") return 0;
-    const tokenAttrMap = {
-      input_tokens: ["ai.usage.inputTokens", "ai.usage.promptTokens"],
-      output_tokens: ["ai.usage.outputTokens", "ai.usage.completionTokens"],
-      total_tokens: ["ai.usage.totalTokens"],
-      cache_read_tokens: ["ai.usage.cachedInputTokens", "ai.usage.inputTokenDetails.cacheReadTokens"],
-      reasoning_tokens: ["ai.usage.reasoningTokens", "ai.usage.outputTokenDetails.reasoningTokens"],
-    };
-    for (const attrKey of tokenAttrMap[key] || []) {
-      if (attrs[attrKey] !== undefined) return attrs[attrKey];
-    }
-  }
+    if (key === "tool_call_count" || key === "skill_use_count") return 0;
+    const tokenAttrMap = {
+      input_tokens: ["input", "ai.usage.inputTokens", "ai.usage.promptTokens"],
+      output_tokens: ["output", "ai.usage.outputTokens", "ai.usage.completionTokens"],
+      total_tokens: ["total", "ai.usage.totalTokens"],
+      cache_read_tokens: ["ai.usage.cachedInputTokens", "ai.usage.inputTokenDetails.cacheReadTokens"],
+      reasoning_tokens: ["ai.usage.reasoningTokens", "ai.usage.outputTokenDetails.reasoningTokens"],
+    };
+    for (const attrKey of tokenAttrMap[key] || []) {
+      if (usage[attrKey] !== undefined) return usage[attrKey];
+      if (attrs[attrKey] !== undefined) return attrs[attrKey];
+    }
+  }
   return undefined;
 }
 
@@ -366,45 +370,51 @@ function metricInteractionId(item, target) {
 }
 
 function isAgentTurnObservation(item) {
-  if (/^(Claude|OpenCode|Codex) Agent Turn$/.test(String(item?.name || "")) || item?.name === "Agent Turn" || metadataValue(item, "interaction_count") === 1 || metadataValue(item, "interaction_count") === "1") {
+  const metadata = item?.metadata || {};
+  const attrs = metadata.attributes || {};
+  const isOpencode = metadata.source === "opencode" || attrs["oh.langfuse.source"] === "opencode";
+  if (/^(Claude|OpenCode|Codex) Agent Turn$/.test(String(item?.name || "")) || item?.name === "Agent Turn" || (!isOpencode && (metadataValue(item, "interaction_count") === 1 || metadataValue(item, "interaction_count") === "1"))) {
     return true;
   }
-  const metadata = item?.metadata || {};
-  const attrs = metadata.attributes || {};
-  const isOpencode = metadata.source === "opencode" || attrs["oh.langfuse.source"] === "opencode";
-  const hasModel = attrs["ai.model.id"] !== undefined || attrs["ai.model.provider"] !== undefined;
-  const isTool = attrs["ai.toolCall.name"] !== undefined || attrs["ai.toolCall.id"] !== undefined;
+  if (isOpencode && OPENCODE_NATIVE_AGENT_TURN_NAMES.has(String(item?.name || ""))) return true;
+  const hasModel = attrs["ai.model.id"] !== undefined || attrs["ai.model.provider"] !== undefined;
+  const isTool = attrs["ai.toolCall.name"] !== undefined || attrs["ai.toolCall.id"] !== undefined;
   return isOpencode && hasModel && !isTool && item?.type === "GENERATION";
 }
-
-function expectedAgentTurnName(target) {
-  if (target === "claude") return "Claude Agent Turn";
-  if (target === "opencode") return "OpenCode Agent Turn";
-  if (target === "codex") return "Codex Agent Turn";
-  return "Agent Turn";
-}
-
-async function observationsForTrace(config, traceId, since) {
-  if (!traceId) return [];
-  const params = { limit: 100, traceId };
-  try {
-    return dataArray(await langfuseGet(config, "/observations", params));
-  } catch (error) {
-    if (error.status !== 400) throw error;
-  }
+
+function expectedAgentTurnName(target) {
+  if (target === "claude") return "Claude Agent Turn";
+  if (target === "opencode") return "OpenCode Agent Turn";
+  if (target === "codex") return "Codex Agent Turn";
+  return "Agent Turn";
+}
+
+async function observationsForTrace(config, traceId, since) {
+  if (!traceId) return [];
+  const params = { limit: 100, fields: "core,basic,usage", traceId };
+  try {
+    return dataArray(await langfuseGet(config, "/v2/observations", params));
+  } catch (error) {
+    if (error.status !== 400 && error.status !== 404) throw error;
+  }
+  try {
+    return dataArray(await langfuseGet(config, "/observations", { limit: 100, traceId }));
+  } catch (error) {
+    if (error.status !== 400) throw error;
+  }
   const fallback = dataArray(await langfuseGetLenient(config, "/observations", { limit: 100, fromTimestamp: since.toISOString() }));
   return fallback.filter((item) => item.traceId === traceId || item.trace_id === traceId);
 }
 
 function mergeMetricCandidates(items) {
   const out = [];
-  const seen = new Set();
-  for (const item of items || []) {
-    if (!item || typeof item !== "object") continue;
-    const key = [idOf(item), item.name || "", item.traceId || item.trace_id || ""].join(":");
-    if (seen.has(key)) continue;
-    seen.add(key);
-    out.push(item);
+  const seen = new Set();
+  for (const item of items || []) {
+    if (!item || typeof item !== "object") continue;
+    const key = idOf(item) || [item.name || "", item.traceId || item.trace_id || ""].join(":");
+    if (seen.has(key)) continue;
+    seen.add(key);
+    out.push(item);
   }
   return out;
 }
@@ -452,17 +462,17 @@ async function verifyMetricObservations(config, found, { since, target, marker =
     throw new Error(`Metric verification failed for ${target}: Skill Use observations should not be emitted as standalone metrics.`);
   }
 
-  if (!interactions.length) {
-    throw new Error(`Metric verification failed for ${target}: Agent Turn observation was not found for trace ${traceId || found.id}.`);
+  if (!interactions.length) {
+    throw new Error(`Metric verification failed for ${target}: Agent Turn observation was not found for trace ${traceId || found.id}.`);
   }
 
   const expectedName = expectedAgentTurnName(target);
-  if (!interactions.some((item) => item?.name === expectedName)) {
+  if (target !== "opencode" && !interactions.some((item) => item?.name === expectedName)) {
     const names = interactions.map((item) => item?.name || "<unnamed>").join(", ");
     throw new Error(`Metric verification failed for ${target}: expected observation name ${expectedName}, found ${names}.`);
   }
-
-  const byInteractionId = new Map();
+
+  const byInteractionId = new Map();
   const seenInteractionIds = new Set();
   for (const item of interactions) {
     const interactionId = metricInteractionId(item, target);
@@ -477,13 +487,13 @@ async function verifyMetricObservations(config, found, { since, target, marker =
         throw new Error(`Metric verification failed for ${target}: Agent Turn is missing ${key}.`);
       }
     }
-    if (target === "opencode") {
-      for (const key of ["interaction_id", "interaction_count", "token_metrics_available", "tool_call_count", "skill_use_count", "input_tokens", "output_tokens", "total_tokens"]) {
-        if (directMetadataValue(item, key) === undefined) {
-          throw new Error(`Metric verification failed for ${target}: visible metadata is missing ${key}.`);
-        }
-      }
-    }
+    if (target === "opencode") {
+      for (const key of ["interaction_id", "interaction_count", "token_metrics_available", "tool_call_count", "skill_use_count", "input_tokens", "output_tokens", "total_tokens"]) {
+        if (metadataValue(item, key) === undefined) {
+          throw new Error(`Metric verification failed for ${target}: effective metadata is missing ${key}.`);
+        }
+      }
+    }
     const tokenAvailable = metadataValue(item, "token_metrics_available");
     for (const tokenKey of ["input_tokens", "output_tokens", "total_tokens"]) {
       const value = metadataValue(item, tokenKey);
@@ -632,12 +642,12 @@ async function main() {
       }
     }
 
-    const found = await pollLangfuse(config, marker, { ...args, since, target });
-    console.log(`[OK] Langfuse marker found for ${target}: ${found.kind} ${found.id || ""}`.trim());
-    const metrics = await verifyMetricObservations(config, found, { since, target, marker });
-    console.log(`[OK] Langfuse metrics found for ${target}: ${expectedAgentTurnName(target)} x${metrics.interactionCount}`);
-    results.push({ target, marker, langfuse: { kind: found.kind, id: found.id || "", traceId: metrics.traceId }, metrics });
-  }
+    const found = await pollLangfuse(config, marker, { ...args, since, target });
+    console.log(`[OK] Langfuse marker found for ${target}: ${found.kind} ${found.id || ""}`.trim());
+    const metrics = await verifyMetricObservations(config, found, { since, target, marker });
+    console.log(`[OK] Langfuse metrics found for ${target}: ${expectedAgentTurnName(target)} x${metrics.interactionCount}`);
+    results.push({ target, marker, langfuse: { kind: found.kind, id: found.id || "", traceId: metrics.traceId }, metrics });
+  }
 
   console.log("");
   console.log(JSON.stringify({ ok: true, package: packageJson.name, marker, results }, null, 2));

package/scripts/update-langfuse-runtime.mjs

@@ -126,6 +126,7 @@ function runNodeScript(script, args, options = {}) {
   const result = spawnSync(process.execPath, [path.join(rootDir, "scripts", script), ...args], {
     cwd: rootDir,
     stdio: "inherit",
+    encoding: "utf8",
     windowsHide: true,
     timeout: options.timeoutMs || 900000,
   });
@@ -254,9 +255,9 @@ async function main() {
   printUpdateSummary(targets);
 }
 
-main()
-  .then(() => process.exit(0))
-  .catch((error) => {
-    console.error(`[FAIL] ${error?.message || String(error)}`);
-    process.exit(1);
-  });
+main()
+  .then(() => process.exit(0))
+  .catch((error) => {
+    console.error(`[FAIL] ${error?.message || String(error)}`);
+    process.exit(1);
+  });

package/scripts/verify-update-runtime.mjs

@@ -1,162 +1,162 @@
-import fs from "node:fs";
-import os from "node:os";
-import path from "node:path";
-import { extractVersionFromNpmMetadata } from "./update-utils.mjs";
-import { readRuntimeState, runtimeStatePath } from "./runtime-state-utils.mjs";
-import {
-  buildVerifyUpdateResults,
-  normalizeVerifyTargets,
-  targetLabel,
-  verifyUpdateExitCode,
-} from "./verify-update-utils.mjs";
-
-const colorEnabled = process.stdout.isTTY && process.env.NO_COLOR !== "1";
-const ansi = (code) => (colorEnabled ? `\x1b[${code}m` : "");
-const t = {
-  reset: ansi(0),
-  bold: ansi(1),
-  green: ansi("92"),
-  gold: ansi("93"),
-  red: ansi("91"),
-  cyan: ansi("96"),
-};
-
-function paint(text, ...styles) {
-  if (!colorEnabled) return text;
-  return `${styles.join("")}${text}${t.reset}`;
-}
-
-function parseArgs(argv) {
-  const args = { _: [] };
-  for (const raw of argv) {
-    if (!raw.startsWith("--")) {
-      args._.push(raw);
-      continue;
-    }
-    const eq = raw.indexOf("=");
-    if (eq === -1) args[raw.slice(2)] = true;
-    else args[raw.slice(2, eq)] = raw.slice(eq + 1);
-  }
-  return args;
-}
-
-function stripBom(s) {
-  return typeof s === "string" && s.charCodeAt(0) === 0xfeff ? s.slice(1) : s;
-}
-
-function readJsonIfExists(p) {
-  try {
-    if (!fs.existsSync(p)) return null;
-    const text = stripBom(fs.readFileSync(p, "utf8"));
-    if (!text.trim()) return null;
-    return JSON.parse(text);
-  } catch {
-    return null;
-  }
-}
-
-function codexHome(home = os.homedir()) {
-  return process.env.CODEX_HOME || path.join(home, ".codex");
-}
-
-function detectInstalledTargets(home = os.homedir()) {
-  return {
-    claude: fs.existsSync(path.join(home, ".claude", "hooks", "langfuse_hook.py")),
-    opencode:
-      fs.existsSync(path.join(home, ".config", "opencode", "opencode.json")) ||
-      fs.existsSync(path.join(home, ".config", "opencode", "plugins", "opencode-plugin-langfuse")),
-    codex: fs.existsSync(path.join(codexHome(home), "hooks", "codex_langfuse_notify.py")),
-  };
-}
-
-async function latestVersion(packageName, registry = "https://registry.npmjs.org") {
-  const base = registry.replace(/\/+$/, "");
-  const response = await fetch(`${base}/${packageName}`, { headers: { accept: "application/json" } });
-  if (!response.ok) throw new Error(`npm registry ${response.status} ${response.statusText}`);
-  return extractVersionFromNpmMetadata(await response.json());
-}
-
-function targetsToVerify(targetArg, installed, runtimeTargets) {
-  const requested = normalizeVerifyTargets(targetArg);
-  if (String(targetArg || "all").trim().toLowerCase() !== "all") return { targets: requested, skipped: [] };
-
-  const targets = requested.filter((target) => installed[target] || runtimeTargets[target]);
-  const skipped = requested
-    .filter((target) => !installed[target] && !runtimeTargets[target])
-    .map((target) => ({ target, reason: "not_detected" }));
-  return { targets, skipped };
-}
-
-function printResult(result) {
-  const label = targetLabel(result.target);
-  if (result.status === "current") {
-    console.log(paint(`[OK] ${label} Langfuse runtime is current: ${result.packageName}@${result.installedVersion}`, t.bold, t.green));
-    if (result.updatedAt) console.log(`[INFO] ${label} updatedAt: ${result.updatedAt}`);
-    return;
-  }
-  if (result.status === "outdated") {
-    console.log(
-      paint(
-        `[FAIL] ${label} Langfuse runtime is outdated: installed ${result.packageName}@${result.installedVersion}, latest ${result.packageName}@${result.latestVersion}`,
-        t.bold,
-        t.red,
-      ),
-    );
-    const fix =
-      result.packageName === "oh-aicoding-tool"
-        ? `npx oh-aicoding-tool@latest langfuse update ${result.target}`
-        : `npx oh-langfuse@latest update ${result.target}`;
-    console.log(paint(`[FIX] Run: ${fix}`, t.bold, t.cyan));
-    return;
-  }
-  console.log(paint(`[FAIL] ${label} Langfuse runtime record is missing.`, t.bold, t.red));
-  console.log(`[INFO] Runtime state: ${runtimeStatePath()}`);
-  console.log(paint(`[FIX] Run: npx oh-langfuse@latest update ${result.target}`, t.bold, t.cyan));
-}
-
-async function main() {
-  const args = parseArgs(process.argv.slice(2));
-  const targetArg = args._[0] || "all";
-  const state = readRuntimeState();
-  const runtimeTargets = state.targets || {};
-  const installed = detectInstalledTargets();
-  const { targets, skipped } = targetsToVerify(targetArg, installed, runtimeTargets);
-
-  for (const item of skipped) {
-    console.log(paint(`[SKIP] ${targetLabel(item.target)} not installed`, t.bold, t.gold));
-  }
-
-  if (!targets.length) {
-    console.log(paint("[FAIL] No installed Langfuse runtime targets were found.", t.bold, t.red));
-    console.log(paint("[FIX] Run setup or update first: npx oh-langfuse@latest update all", t.bold, t.cyan));
-    return 2;
-  }
-
-  let latestVersions = {};
-  try {
-    const packageNames = new Set(["oh-langfuse"]);
-    for (const target of targets) {
-      const packageName = String(runtimeTargets[target]?.packageName || "oh-langfuse").trim() || "oh-langfuse";
-      packageNames.add(packageName);
-    }
-    for (const packageName of packageNames) {
-      latestVersions[packageName] = await latestVersion(packageName, args.npmRegistry);
-    }
-  } catch (error) {
-    console.error(paint(`[FAIL] Could not query npm latest version: ${error.message}`, t.bold, t.red));
-    return 3;
-  }
-
-  const results = buildVerifyUpdateResults({ targets, runtimeTargets, latestVersions });
-  for (const result of results) printResult(result);
-  return verifyUpdateExitCode(results);
-}
-
-main()
-  .then((code) => {
-    process.exit(code);
-  })
-  .catch((error) => {
-    console.error(paint(`[FAIL] ${error?.message || String(error)}`, t.bold, t.red));
-    process.exit(3);
-  });
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { extractVersionFromNpmMetadata } from "./update-utils.mjs";
+import { readRuntimeState, runtimeStatePath } from "./runtime-state-utils.mjs";
+import {
+  buildVerifyUpdateResults,
+  normalizeVerifyTargets,
+  targetLabel,
+  verifyUpdateExitCode,
+} from "./verify-update-utils.mjs";
+
+const colorEnabled = process.stdout.isTTY && process.env.NO_COLOR !== "1";
+const ansi = (code) => (colorEnabled ? `\x1b[${code}m` : "");
+const t = {
+  reset: ansi(0),
+  bold: ansi(1),
+  green: ansi("92"),
+  gold: ansi("93"),
+  red: ansi("91"),
+  cyan: ansi("96"),
+};
+
+function paint(text, ...styles) {
+  if (!colorEnabled) return text;
+  return `${styles.join("")}${text}${t.reset}`;
+}
+
+function parseArgs(argv) {
+  const args = { _: [] };
+  for (const raw of argv) {
+    if (!raw.startsWith("--")) {
+      args._.push(raw);
+      continue;
+    }
+    const eq = raw.indexOf("=");
+    if (eq === -1) args[raw.slice(2)] = true;
+    else args[raw.slice(2, eq)] = raw.slice(eq + 1);
+  }
+  return args;
+}
+
+function stripBom(s) {
+  return typeof s === "string" && s.charCodeAt(0) === 0xfeff ? s.slice(1) : s;
+}
+
+function readJsonIfExists(p) {
+  try {
+    if (!fs.existsSync(p)) return null;
+    const text = stripBom(fs.readFileSync(p, "utf8"));
+    if (!text.trim()) return null;
+    return JSON.parse(text);
+  } catch {
+    return null;
+  }
+}
+
+function codexHome(home = os.homedir()) {
+  return process.env.CODEX_HOME || path.join(home, ".codex");
+}
+
+function detectInstalledTargets(home = os.homedir()) {
+  return {
+    claude: fs.existsSync(path.join(home, ".claude", "hooks", "langfuse_hook.py")),
+    opencode:
+      fs.existsSync(path.join(home, ".config", "opencode", "opencode.json")) ||
+      fs.existsSync(path.join(home, ".config", "opencode", "plugins", "opencode-plugin-langfuse")),
+    codex: fs.existsSync(path.join(codexHome(home), "hooks", "codex_langfuse_notify.py")),
+  };
+}
+
+async function latestVersion(packageName, registry = "https://registry.npmjs.org") {
+  const base = registry.replace(/\/+$/, "");
+  const response = await fetch(`${base}/${packageName}`, { headers: { accept: "application/json" } });
+  if (!response.ok) throw new Error(`npm registry ${response.status} ${response.statusText}`);
+  return extractVersionFromNpmMetadata(await response.json());
+}
+
+function targetsToVerify(targetArg, installed, runtimeTargets) {
+  const requested = normalizeVerifyTargets(targetArg);
+  if (String(targetArg || "all").trim().toLowerCase() !== "all") return { targets: requested, skipped: [] };
+
+  const targets = requested.filter((target) => installed[target] || runtimeTargets[target]);
+  const skipped = requested
+    .filter((target) => !installed[target] && !runtimeTargets[target])
+    .map((target) => ({ target, reason: "not_detected" }));
+  return { targets, skipped };
+}
+
+function printResult(result) {
+  const label = targetLabel(result.target);
+  if (result.status === "current") {
+    console.log(paint(`[OK] ${label} Langfuse runtime is current: ${result.packageName}@${result.installedVersion}`, t.bold, t.green));
+    if (result.updatedAt) console.log(`[INFO] ${label} updatedAt: ${result.updatedAt}`);
+    return;
+  }
+  if (result.status === "outdated") {
+    console.log(
+      paint(
+        `[FAIL] ${label} Langfuse runtime is outdated: installed ${result.packageName}@${result.installedVersion}, latest ${result.packageName}@${result.latestVersion}`,
+        t.bold,
+        t.red,
+      ),
+    );
+    const fix =
+      result.packageName === "oh-aicoding-tool"
+        ? `npx oh-aicoding-tool@latest langfuse update ${result.target}`
+        : `npx oh-langfuse@latest update ${result.target}`;
+    console.log(paint(`[FIX] Run: ${fix}`, t.bold, t.cyan));
+    return;
+  }
+  console.log(paint(`[FAIL] ${label} Langfuse runtime record is missing.`, t.bold, t.red));
+  console.log(`[INFO] Runtime state: ${runtimeStatePath()}`);
+  console.log(paint(`[FIX] Run: npx oh-langfuse@latest update ${result.target}`, t.bold, t.cyan));
+}
+
+async function main() {
+  const args = parseArgs(process.argv.slice(2));
+  const targetArg = args._[0] || "all";
+  const state = readRuntimeState();
+  const runtimeTargets = state.targets || {};
+  const installed = detectInstalledTargets();
+  const { targets, skipped } = targetsToVerify(targetArg, installed, runtimeTargets);
+
+  for (const item of skipped) {
+    console.log(paint(`[SKIP] ${targetLabel(item.target)} not installed`, t.bold, t.gold));
+  }
+
+  if (!targets.length) {
+    console.log(paint("[FAIL] No installed Langfuse runtime targets were found.", t.bold, t.red));
+    console.log(paint("[FIX] Run setup or update first: npx oh-langfuse@latest update all", t.bold, t.cyan));
+    return 2;
+  }
+
+  let latestVersions = {};
+  try {
+    const packageNames = new Set(["oh-langfuse"]);
+    for (const target of targets) {
+      const packageName = String(runtimeTargets[target]?.packageName || "oh-langfuse").trim() || "oh-langfuse";
+      packageNames.add(packageName);
+    }
+    for (const packageName of packageNames) {
+      latestVersions[packageName] = await latestVersion(packageName, args.npmRegistry);
+    }
+  } catch (error) {
+    console.error(paint(`[FAIL] Could not query npm latest version: ${error.message}`, t.bold, t.red));
+    return 3;
+  }
+
+  const results = buildVerifyUpdateResults({ targets, runtimeTargets, latestVersions });
+  for (const result of results) printResult(result);
+  return verifyUpdateExitCode(results);
+}
+
+main()
+  .then((code) => {
+    process.exit(code);
+  })
+  .catch((error) => {
+    console.error(paint(`[FAIL] ${error?.message || String(error)}`, t.bold, t.red));
+    process.exit(3);
+  });