oh-langfuse 0.1.70 → 0.1.72

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oh-langfuse",
-  "version": "0.1.70",
+  "version": "0.1.72",
   "private": false,
   "type": "module",
   "description": "Use npm scripts to configure Claude Code / OpenCode / Codex with Langfuse tracing.",
@@ -16,6 +16,7 @@
     "scripts/auto-update-runtime.mjs",
     "scripts/codex-langfuse-check.mjs",
     "scripts/codex-langfuse-setup.mjs",
+    "scripts/cli-detection-utils.mjs",
     "scripts/json-utils.mjs",
     "scripts/langfuse-check.mjs",
     "scripts/langfuse-setup.mjs",

package/scripts/cli-detection-utils.mjs

@@ -0,0 +1,114 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { spawnSync } from "node:child_process";
+
+function unique(values) {
+  return [...new Set(values.filter(Boolean))];
+}
+
+function stripExecutableExtension(name) {
+  return String(name || "").replace(/\.(cmd|bat|exe)$/i, "");
+}
+
+function isTargetBinary(target, candidate) {
+  const base = stripExecutableExtension(path.basename(String(candidate || ""))).toLowerCase();
+  return base === String(target || "").toLowerCase();
+}
+
+function sortWindowsCliCandidates(candidates) {
+  const extPriority = (candidate) => {
+    const ext = path.extname(String(candidate || "")).toLowerCase();
+    if (ext === ".cmd" || ext === ".bat" || ext === ".exe") return 0;
+    return 1;
+  };
+  return [...candidates].sort((a, b) => extPriority(a) - extPriority(b));
+}
+
+export function parseWhereisBinaryOutput(target, stdout) {
+  const candidates = [];
+  for (const line of String(stdout || "").split(/\r?\n/)) {
+    const colon = line.indexOf(":");
+    const body = colon === -1 ? line : line.slice(colon + 1);
+    for (const token of body.split(/\s+/)) {
+      const candidate = token.trim();
+      if (candidate && path.isAbsolute(candidate) && isTargetBinary(target, candidate)) {
+        candidates.push(candidate);
+      }
+    }
+  }
+  return unique(candidates);
+}
+
+function isLikelyNodePrefix(name) {
+  return /^(node|nodejs)(?:[-_.].*)?$/i.test(String(name || ""));
+}
+
+export function listCommonUnixCliCandidates(target, roots = ["/usr/local", "/opt"]) {
+  if (process.platform === "win32") return [];
+  const candidates = [
+    path.join("/usr/local", "bin", target),
+    path.join("/usr", "bin", target),
+    path.join("/bin", target),
+  ];
+  for (const root of roots) {
+    try {
+      if (!fs.existsSync(root)) continue;
+      for (const ent of fs.readdirSync(root, { withFileTypes: true })) {
+        if (ent.isDirectory() && isLikelyNodePrefix(ent.name)) {
+          candidates.push(path.join(root, ent.name, "bin", target));
+        }
+      }
+    } catch {
+      // Best effort only; command lookups and other candidates may still work.
+    }
+  }
+  return unique(candidates);
+}
+
+export function listSystemCliCandidates(target) {
+  if (!target) return [];
+  const candidates = [];
+  if (process.platform === "win32") {
+    const result = spawnSync("where.exe", [target], { encoding: "utf8", windowsHide: true });
+    if (result.status === 0) {
+      candidates.push(...String(result.stdout || "").split(/\r?\n/).map((line) => line.trim()).filter(Boolean));
+    }
+    return sortWindowsCliCandidates(unique(candidates));
+  }
+
+  const which = spawnSync("which", ["-a", target], { encoding: "utf8", windowsHide: true });
+  if (which.status === 0) {
+    candidates.push(...String(which.stdout || "").split(/\r?\n/).map((line) => line.trim()).filter(Boolean));
+  }
+
+  const whereis = spawnSync("whereis", ["-b", target], { encoding: "utf8", windowsHide: true });
+  if (whereis.status === 0) {
+    candidates.push(...parseWhereisBinaryOutput(target, whereis.stdout));
+  }
+
+  candidates.push(...listCommonUnixCliCandidates(target));
+  return unique(candidates);
+}
+
+export function candidateExists(candidate) {
+  try {
+    return Boolean(candidate) && fs.existsSync(candidate);
+  } catch {
+    return false;
+  }
+}
+
+export function hasSystemCli(target) {
+  return listSystemCliCandidates(target).some(candidateExists);
+}
+
+export function defaultWindowsNpmCliCandidates(target) {
+  const appData = process.env.APPDATA || path.join(os.homedir(), "AppData", "Roaming");
+  if (process.platform !== "win32") return [];
+  return [
+    path.join(appData, "npm", `${target}.cmd`),
+    path.join(appData, "npm", `${target}.exe`),
+    path.join(appData, "npm", target),
+  ];
+}

package/scripts/codex-langfuse-setup.mjs

@@ -2,9 +2,10 @@ import fs from "node:fs";
 import fsp from "node:fs/promises";
 import path from "node:path";
 import os from "node:os";
-import { execFileSync, spawnSync } from "node:child_process";
-import { fileURLToPath } from "node:url";
-import { writeRuntimeInstallRecord } from "./runtime-state-utils.mjs";
+import { execFileSync, spawnSync } from "node:child_process";
+import { fileURLToPath } from "node:url";
+import { defaultWindowsNpmCliCandidates, listSystemCliCandidates } from "./cli-detection-utils.mjs";
+import { writeRuntimeInstallRecord } from "./runtime-state-utils.mjs";
 
 const packageRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
 const USER_ID_PATTERN = /^[a-z](?:\d{8}|wx\d{7})$/;
@@ -217,19 +218,11 @@ function listLocalCodexCliCandidates() {
   return candidates;
 }
 
-function listCliCandidatesFromPath(target) {
-  const cmd = process.platform === "win32" ? "where.exe" : "which";
-  const args = process.platform === "win32" ? [target] : ["-a", target];
-  const result = spawnSync(cmd, args, { encoding: "utf8", windowsHide: true });
-  if (result.status !== 0) return [];
-  const candidates = String(result.stdout || "")
-    .split(/\r?\n/)
-    .map((line) => line.trim())
-    .filter(Boolean);
-  return process.platform === "win32" ? sortWindowsCliCandidates(candidates) : candidates;
-}
-
-function sortWindowsCliCandidates(candidates) {
+function listCliCandidatesFromPath(target) {
+  return listSystemCliCandidates(target);
+}
+
+function sortWindowsCliCandidates(candidates) {
   const extPriority = (candidate) => {
     const ext = path.extname(String(candidate || "")).toLowerCase();
     if (ext === ".cmd" || ext === ".bat" || ext === ".exe") return 0;
@@ -238,16 +231,13 @@ function sortWindowsCliCandidates(candidates) {
   return [...candidates].sort((a, b) => extPriority(a) - extPriority(b));
 }
 
-function resolveAgentCli({ target, preferred = "", shimDir = "" }) {
-  const appData = process.env.APPDATA || path.join(os.homedir(), "AppData", "Roaming");
-  const candidates = [
-    preferred,
-    ...(target === "codex" ? listLocalCodexCliCandidates() : []),
-    process.platform === "win32" ? path.join(appData, "npm", `${target}.cmd`) : "",
-    process.platform === "win32" ? path.join(appData, "npm", `${target}.exe`) : "",
-    process.platform === "win32" ? path.join(appData, "npm", target) : "",
-    ...listCliCandidatesFromPath(target)
-  ];
+function resolveAgentCli({ target, preferred = "", shimDir = "" }) {
+  const candidates = [
+    preferred,
+    ...(target === "codex" ? listLocalCodexCliCandidates() : []),
+    ...defaultWindowsNpmCliCandidates(target),
+    ...listCliCandidatesFromPath(target)
+  ];
   for (const candidate of candidates) {
     const found = existingCliCandidate(candidate, shimDir);
     if (found) return found;

package/scripts/langfuse-setup.mjs

@@ -2,9 +2,10 @@ import fs from "node:fs";
 import fsp from "node:fs/promises";
 import path from "node:path";
 import os from "node:os";
-import { execFileSync, spawnSync } from "node:child_process";
-import { fileURLToPath } from "node:url";
-import { writeRuntimeInstallRecord } from "./runtime-state-utils.mjs";
+import { execFileSync, spawnSync } from "node:child_process";
+import { fileURLToPath } from "node:url";
+import { defaultWindowsNpmCliCandidates, listSystemCliCandidates } from "./cli-detection-utils.mjs";
+import { writeRuntimeInstallRecord } from "./runtime-state-utils.mjs";
 
 const packageRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
 const packageJson = JSON.parse(fs.readFileSync(path.join(packageRoot, "package.json"), "utf8"));
@@ -221,26 +222,16 @@ function existingCliCandidate(candidate, shimDir) {
   }
 }
 
-function listCliCandidatesFromPath(target) {
-  const cmd = process.platform === "win32" ? "where.exe" : "which";
-  const args = process.platform === "win32" ? [target] : ["-a", target];
-  const result = spawnSync(cmd, args, { encoding: "utf8", windowsHide: true });
-  if (result.status !== 0) return [];
-  return String(result.stdout || "")
-    .split(/\r?\n/)
-    .map((line) => line.trim())
-    .filter(Boolean);
-}
-
-function resolveAgentCli({ target, preferred = "", shimDir = "" }) {
-  const appData = process.env.APPDATA || path.join(os.homedir(), "AppData", "Roaming");
-  const candidates = [
-    preferred,
-    process.platform === "win32" ? path.join(appData, "npm", `${target}.cmd`) : "",
-    process.platform === "win32" ? path.join(appData, "npm", `${target}.exe`) : "",
-    process.platform === "win32" ? path.join(appData, "npm", target) : "",
-    ...listCliCandidatesFromPath(target)
-  ];
+function listCliCandidatesFromPath(target) {
+  return listSystemCliCandidates(target);
+}
+
+function resolveAgentCli({ target, preferred = "", shimDir = "" }) {
+  const candidates = [
+    preferred,
+    ...defaultWindowsNpmCliCandidates(target),
+    ...listCliCandidatesFromPath(target)
+  ];
   for (const candidate of candidates) {
     const found = existingCliCandidate(candidate, shimDir);
     if (found) return found;

package/scripts/opencode-langfuse-setup.mjs

@@ -413,16 +413,42 @@ function getPatchedLangfuseDistIndexJs() {
     "    toolCallId: callId || '',",
     "  };",
     "};",
-    "const tokenMetricsFromPart = (part) => {",
-    "  const tokens = part?.tokens ?? part?.usage ?? {};",
-    "  return {",
-    "    input: metricNumber(tokens.input ?? tokens.input_tokens ?? tokens.inputTokens),",
+    "const tokenMetricsFromPart = (part) => {",
+    "  const tokens = part?.tokens ?? part?.usage ?? {};",
+    "  return {",
+    "    input: metricNumber(tokens.input ?? tokens.input_tokens ?? tokens.inputTokens),",
     "    output: metricNumber(tokens.output ?? tokens.output_tokens ?? tokens.outputTokens),",
     "    total: metricNumber(tokens.total ?? tokens.total_tokens ?? tokens.totalTokens),",
     "    cacheRead: metricNumber(tokens.cache?.read ?? tokens.cacheRead ?? tokens.cache_read_tokens ?? tokens.cachedInputTokens),",
-    "    reasoning: metricNumber(tokens.reasoning ?? tokens.reasoning_tokens ?? tokens.reasoningTokens),",
-    "  };",
-    "};",
+    "    reasoning: metricNumber(tokens.reasoning ?? tokens.reasoning_tokens ?? tokens.reasoningTokens),",
+    "  };",
+    "};",
+    "const OBSERVATION_TEXT_LIMIT = 20000;",
+    "const limitObservationText = (text) => {",
+    "  const normalized = typeof text === 'string' ? text.trim() : '';",
+    "  if (!normalized) return '';",
+    "  return normalized.length > OBSERVATION_TEXT_LIMIT ? `${normalized.slice(0, OBSERVATION_TEXT_LIMIT)}\\n...[truncated]` : normalized;",
+    "};",
+    "const textFromContent = (value, depth = 0) => {",
+    "  if (depth > 6 || value === null || value === undefined) return '';",
+    "  if (typeof value === 'string') return value.trim();",
+    "  if (Array.isArray(value)) return value.map((item) => textFromContent(item, depth + 1)).filter(Boolean).join('\\n').trim();",
+    "  if (typeof value !== 'object') return '';",
+    "  for (const key of ['text', 'content', 'prompt', 'message', 'input', 'output', 'parts']) {",
+    "    const text = textFromContent(value[key], depth + 1);",
+    "    if (text) return text;",
+    "  }",
+    "  return '';",
+    "};",
+    "const promptFromArgv = () => {",
+    "  const args = process.argv.slice(2);",
+    "  if (!args.includes('run')) return '';",
+    "  for (let i = args.length - 1; i >= 0; i -= 1) {",
+    "    const arg = args[i];",
+    "    if (typeof arg === 'string' && arg.trim() && !arg.startsWith('-')) return arg.trim();",
+    "  }",
+    "  return '';",
+    "};",
     "",
     "const normalizeSkillNames = (names) => {",
     "  if (!Array.isArray(names)) return [];",
@@ -643,11 +669,14 @@ function getPatchedLangfuseDistIndexJs() {
     "  const sdkStartPromise = Promise.resolve().then(() => sdk.start()).catch((err) => {",
     '    log("warn", `OTEL SDK start failed: ${err?.message ?? err}`);',
     "  });",
-    "  const getMetricsTracer = () => trace.getTracer('oh-langfuse-opencode-metrics');",
-    "  const knownSkillNames = await collectKnownSkillNames();",
-    "  const startupSkillUsages = detectOpencodeSkillUsages(process.argv.join('\\n'), knownSkillNames);",
-    "  const messageTextById = new Map();",
-    "  const skillUsagesByMessageId = new Map();",
+    "  const getMetricsTracer = () => trace.getTracer('oh-langfuse-opencode-metrics');",
+    "  const knownSkillNames = await collectKnownSkillNames();",
+    "  const startupSkillUsages = detectOpencodeSkillUsages(process.argv.join('\\n'), knownSkillNames);",
+    "  const startupPromptText = limitObservationText(promptFromArgv());",
+    "  const messageTextById = new Map();",
+    "  const messageInputById = new Map();",
+    "  const lastUserTextBySessionId = new Map();",
+    "  const skillUsagesByMessageId = new Map();",
     "  const skillUsagesBySessionId = new Map();",
     "  const startupSkillSessionIds = new Set();",
     "  const toolCallIdsByMessageId = new Map();",
@@ -717,9 +746,17 @@ function getPatchedLangfuseDistIndexJs() {
     "  const recordInteractionMetric = async (event) => {",
     "    const payload = eventPayload(event);",
     "    const part = eventPart(event);",
-    "    const partType = part?.type ?? '';",
-    "    const sessionId = pickEventString(part?.sessionID, part?.sessionId, payload?.sessionID, payload?.sessionId, payload?.session?.id, event?.sessionID, event?.sessionId);",
-    "    const messageId = pickEventString(part?.messageID, part?.messageId, payload?.messageID, payload?.messageId, payload?.message?.id, event?.messageID, event?.messageId);",
+    "    const partType = part?.type ?? '';",
+    "    const sessionId = pickEventString(part?.sessionID, part?.sessionId, payload?.sessionID, payload?.sessionId, payload?.session?.id, event?.sessionID, event?.sessionId);",
+    "    const messageId = pickEventString(part?.messageID, part?.messageId, payload?.messageID, payload?.messageId, payload?.message?.id, event?.messageID, event?.messageId);",
+    "    const role = pickEventString(part?.role, payload?.role, payload?.message?.role, event?.role).toLowerCase();",
+    "    const eventText = textFromContent(part) || textFromContent(payload?.message) || textFromContent(payload);",
+    "    if (eventText && role === 'user') {",
+    "      const inputText = limitObservationText(eventText);",
+    "      if (messageId) messageInputById.set(messageId, inputText);",
+    "      if (sessionId) lastUserTextBySessionId.set(sessionId, inputText);",
+    "      return;",
+    "    }",
     "    if (sessionId && startupSkillUsages.length && !startupSkillSessionIds.has(sessionId)) {",
     "      startupSkillSessionIds.add(sessionId);",
     "      rememberSkillUsages(skillUsagesBySessionId, sessionId, startupSkillUsages);",
@@ -733,11 +770,11 @@ function getPatchedLangfuseDistIndexJs() {
     "    rememberToolActivity(toolCallIdsBySessionId, sessionId, toolActivity, 'toolCallCount');",
     "    rememberToolActivity(toolResultIdsByMessageId, messageId, toolActivity, 'toolResultCount');",
     "    rememberToolActivity(toolResultIdsBySessionId, sessionId, toolActivity, 'toolResultCount');",
-    "    if (partType === 'text' && messageId && typeof part.text === 'string') {",
-    "      messageTextById.set(messageId, part.text);",
-    "      const textSkillUsages = detectOpencodeSkillUsages(part.text, knownSkillNames);",
-    "      rememberSkillUsages(skillUsagesByMessageId, messageId, textSkillUsages);",
-    "      rememberSkillUsages(skillUsagesBySessionId, sessionId, textSkillUsages);",
+    "    if (eventText && messageId && (role === 'assistant' || partType === 'text')) {",
+    "      messageTextById.set(messageId, limitObservationText(eventText));",
+    "      const textSkillUsages = detectOpencodeSkillUsages(eventText, knownSkillNames);",
+    "      rememberSkillUsages(skillUsagesByMessageId, messageId, textSkillUsages);",
+    "      rememberSkillUsages(skillUsagesBySessionId, sessionId, textSkillUsages);",
     "      return;",
     "    }",
     "    if (partType !== 'step-finish' || !messageId || emittedMessageIds.has(messageId)) return;",
@@ -745,10 +782,11 @@ function getPatchedLangfuseDistIndexJs() {
     "    const tokenMetrics = tokenMetricsFromPart(part);",
     "    const total = tokenMetrics.total ?? (tokenMetrics.input !== undefined && tokenMetrics.output !== undefined ? tokenMetrics.input + tokenMetrics.output : undefined);",
     "    const tokenAvailable = [tokenMetrics.input, tokenMetrics.output, total, tokenMetrics.cacheRead, tokenMetrics.reasoning].some((value) => value !== undefined);",
-    "    await sdkStartPromise;",
-    "    const span = getMetricsTracer().startSpan('OpenCode Agent Turn');",
-    "    const text = messageTextById.get(messageId) || '';",
-    "    const skillUsages = dedupeSkillUsages([...(skillUsagesByMessageId.get(messageId) ?? []), ...(skillUsagesBySessionId.get(sessionId) ?? [])]);",
+    "    await sdkStartPromise;",
+    "    const span = getMetricsTracer().startSpan('OpenCode Agent Turn');",
+    "    const text = messageTextById.get(messageId) || '';",
+    "    const inputText = messageInputById.get(messageId) || lastUserTextBySessionId.get(sessionId) || startupPromptText || '';",
+    "    const skillUsages = dedupeSkillUsages([...(skillUsagesByMessageId.get(messageId) ?? []), ...(skillUsagesBySessionId.get(sessionId) ?? [])]);",
     "    const interactionId = `opencode:${userId || \"unknown\"}:${sessionId || \"unknown\"}:${messageId}`;",
     "    const skillUseEvents = buildSkillUseEvents(interactionId, skillUsages);",
     "    const skillNames = uniqueSkillNames(skillUsages);",
@@ -781,14 +819,22 @@ function getPatchedLangfuseDistIndexJs() {
     '    if (skillInvocationModes.length) span.setAttribute("langfuse.observation.metadata.skill_invocation_modes", skillInvocationModes);',
     '    if (skillAgentPaths.length) span.setAttribute("langfuse.observation.metadata.skill_agent_paths", skillAgentPaths);',
     '    if (tokenMetrics.input !== undefined) span.setAttribute("langfuse.observation.metadata.input_tokens", tokenMetrics.input);',
-    '    if (tokenMetrics.output !== undefined) span.setAttribute("langfuse.observation.metadata.output_tokens", tokenMetrics.output);',
-    '    if (total !== undefined) span.setAttribute("langfuse.observation.metadata.total_tokens", total);',
-    '    if (tokenMetrics.cacheRead !== undefined) span.setAttribute("langfuse.observation.metadata.cache_read_tokens", tokenMetrics.cacheRead);',
-    '    if (tokenMetrics.reasoning !== undefined) span.setAttribute("langfuse.observation.metadata.reasoning_tokens", tokenMetrics.reasoning);',
-    '    if (text) span.setAttribute("langfuse.observation.metadata.output_text_preview", text.slice(0, 512));',
-    '    writeRepoContextMetrics(span, collectRepoContext(process.cwd(), "process"));',
-    "    span.end();",
-    "    messageTextById.delete(messageId);",
+    '    if (tokenMetrics.output !== undefined) span.setAttribute("langfuse.observation.metadata.output_tokens", tokenMetrics.output);',
+    '    if (total !== undefined) span.setAttribute("langfuse.observation.metadata.total_tokens", total);',
+    '    if (tokenMetrics.cacheRead !== undefined) span.setAttribute("langfuse.observation.metadata.cache_read_tokens", tokenMetrics.cacheRead);',
+    '    if (tokenMetrics.reasoning !== undefined) span.setAttribute("langfuse.observation.metadata.reasoning_tokens", tokenMetrics.reasoning);',
+    '    if (inputText) span.setAttribute("langfuse.observation.input", inputText);',
+    '    if (inputText) span.setAttribute("langfuse.trace.input", inputText);',
+    '    if (inputText) span.setAttribute("input.value", inputText);',
+    '    if (text) span.setAttribute("langfuse.observation.output", text);',
+    '    if (text) span.setAttribute("langfuse.trace.output", text);',
+    '    if (text) span.setAttribute("output.value", text);',
+    '    if (inputText) span.setAttribute("langfuse.observation.metadata.input_text_preview", inputText.slice(0, 512));',
+    '    if (text) span.setAttribute("langfuse.observation.metadata.output_text_preview", text.slice(0, 512));',
+    '    writeRepoContextMetrics(span, collectRepoContext(process.cwd(), "process"));',
+    "    span.end();",
+    "    messageTextById.delete(messageId);",
+    "    messageInputById.delete(messageId);",
     "    skillUsagesByMessageId.delete(messageId);",
     "    skillUsagesBySessionId.delete(sessionId);",
     "    toolCallIdsByMessageId.delete(messageId);",

package/scripts/real-self-verify.mjs

@@ -354,14 +354,29 @@ function metadataValue(item, key) {
   return undefined;
 }
 
-function directMetadataValue(item, key) {
-  const metadata = item?.metadata || {};
-  return metadata[key];
-}
-
-function hasMetadataKey(item, key) {
-  return metadataValue(item, key) !== undefined;
-}
+function directMetadataValue(item, key) {
+  const metadata = item?.metadata || {};
+  return metadata[key];
+}
+
+function observationIOValue(item, key) {
+  const metadata = item?.metadata || {};
+  const attrs = metadata.attributes || {};
+  for (const value of [
+    item?.[key],
+    metadata[key],
+    attrs[`langfuse.observation.${key}`],
+    attrs[`langfuse.trace.${key}`],
+    attrs[`${key}.value`],
+  ]) {
+    if (value !== undefined && value !== null && String(value).trim() !== "") return value;
+  }
+  return undefined;
+}
+
+function hasMetadataKey(item, key) {
+  return metadataValue(item, key) !== undefined;
+}
 
 function metricInteractionId(item, target) {
   return target === "opencode"
@@ -507,13 +522,20 @@ async function verifyMetricObservations(config, found, { since, target, marker =
         throw new Error(`Metric verification failed for ${target}: Agent Turn is missing repo context ${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}.`);
-        }
-      }
-    }
+    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}.`);
+        }
+      }
+      if (item?.name === expectedName) {
+        for (const key of ["input", "output"]) {
+          if (observationIOValue(item, key) === undefined) {
+            throw new Error(`Metric verification failed for ${target}: ${expectedName} 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);

package/scripts/resolve-opencode-cli.mjs

@@ -1,7 +1,8 @@
 import fs from "node:fs";
-import path from "node:path";
-import os from "node:os";
-import { spawnSync } from "node:child_process";
+import path from "node:path";
+import os from "node:os";
+import { spawnSync } from "node:child_process";
+import { listSystemCliCandidates } from "./cli-detection-utils.mjs";
 
 /**
  * OpenCode CLI 的官方安装脚本默认会把二进制放到 ~/.opencode/bin；
@@ -36,10 +37,11 @@ export function resolveOpencodeCli(preferred) {
       candidates.push(path.join(process.env.APPDATA, "npm", "node_modules", "opencode-windows-x64-baseline", "bin", "opencode.exe"));
     }
     candidates.push(path.join(home, "scoop", "shims", "opencode.exe"));
-  } else {
-    candidates.push(path.join(home, ".opencode", "bin", "opencode"));
-    candidates.push(path.join(home, ".local", "bin", "opencode"));
-  }
+  } else {
+    candidates.push(path.join(home, ".opencode", "bin", "opencode"));
+    candidates.push(path.join(home, ".local", "bin", "opencode"));
+    candidates.push(...listSystemCliCandidates("opencode"));
+  }
 
   for (const c of candidates) {
     if (c && fs.existsSync(c)) return c;

package/scripts/update-langfuse-runtime.mjs

@@ -1,10 +1,11 @@
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
-import { spawnSync } from "node:child_process";
-import { fileURLToPath } from "node:url";
-import { buildUpdatePlan, extractVersionFromNpmMetadata } from "./update-utils.mjs";
-import { writeRuntimeInstallRecord } from "./runtime-state-utils.mjs";
+import { spawnSync } from "node:child_process";
+import { fileURLToPath } from "node:url";
+import { hasSystemCli } from "./cli-detection-utils.mjs";
+import { buildUpdatePlan, extractVersionFromNpmMetadata } from "./update-utils.mjs";
+import { writeRuntimeInstallRecord } from "./runtime-state-utils.mjs";
 
 const rootDir = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
 const packageJson = JSON.parse(fs.readFileSync(path.join(rootDir, "package.json"), "utf8"));
@@ -59,16 +60,21 @@ function readJsonIfExists(p) {
   }
 }
 
-function detectInstalledTargets(home = os.homedir()) {
-  const codexHome = process.env.CODEX_HOME || path.join(home, ".codex");
-  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, "hooks", "codex_langfuse_notify.py")),
-  };
-}
+function detectInstalledTargets(home = os.homedir()) {
+  const codexHome = process.env.CODEX_HOME || path.join(home, ".codex");
+  return {
+    claude:
+      fs.existsSync(path.join(home, ".claude", "hooks", "langfuse_hook.py")) ||
+      hasSystemCli("claude"),
+    opencode:
+      fs.existsSync(path.join(home, ".config", "opencode", "opencode.json")) ||
+      fs.existsSync(path.join(home, ".config", "opencode", "plugins", "opencode-plugin-langfuse")) ||
+      hasSystemCli("opencode"),
+    codex:
+      fs.existsSync(path.join(codexHome, "hooks", "codex_langfuse_notify.py")) ||
+      hasSystemCli("codex"),
+  };
+}
 
 function claudeConfig(home) {
   const settings = readJsonIfExists(path.join(home, ".claude", "settings.json")) || {};