agent-inspect 1.0.2 → 1.0.3

package/packages/core/dist/index.cjs

@@ -2537,6 +2537,9 @@ async function inspectRun(name, fn, options) {
   if (typeof fn !== "function") {
     throw new TypeError("inspectRun requires `fn` to be a function");
   }
+  if (options?.enabled === false) {
+    return Promise.resolve(fn());
+  }
   const runName = normalizeRunName(name);
   const runId = createRunId();
   const traceDir = resolveTraceDir({ dir: options?.traceDir });
@@ -2616,6 +2619,25 @@ async function inspectRun(name, fn, options) {
   });
 }
 
+// packages/core/src/maybe-inspect-run.ts
+var ENABLED_ENV_VALUES = /* @__PURE__ */ new Set(["1", "true", "yes", "on", "enabled"]);
+function isAgentInspectEnabled(value) {
+  if (value === void 0) return false;
+  const normalized = value.trim().toLowerCase();
+  if (normalized === "") return false;
+  return ENABLED_ENV_VALUES.has(normalized);
+}
+async function maybeInspectRun(name, fn, options) {
+  if (typeof fn !== "function") {
+    throw new TypeError("maybeInspectRun requires `fn` to be a function");
+  }
+  const enabled = options?.enabled !== void 0 ? options.enabled : isAgentInspectEnabled(process.env.AGENT_INSPECT);
+  if (!enabled) {
+    return Promise.resolve(fn());
+  }
+  return inspectRun(name, fn, options);
+}
+
 // packages/core/src/step.ts
 function normalizeStepName(name) {
   if (typeof name !== "string" || name.trim() === "") {
@@ -3632,6 +3654,7 @@ exports.getTraceFilePath = getTraceFilePath;
 exports.hasActiveContext = hasActiveContext;
 exports.initializeTraceFile = initializeTraceFile;
 exports.inspectRun = inspectRun;
+exports.isAgentInspectEnabled = isAgentInspectEnabled;
 exports.isAgentInspectTrace = isAgentInspectTrace;
 exports.isSilentContext = isSilentContext;
 exports.isStepStatus = isStepStatus;
@@ -3642,6 +3665,7 @@ exports.loadLogIngestConfig = loadLogIngestConfig;
 exports.manualTraceEventsToComparableRun = manualTraceEventsToComparableRun;
 exports.manualTraceEventsToRunTree = manualTraceEventsToRunTree;
 exports.matchMapping = matchMapping;
+exports.maybeInspectRun = maybeInspectRun;
 exports.mergeExportDefaults = mergeExportDefaults;
 exports.mergeLogIngestConfig = mergeLogIngestConfig;
 exports.observe = observe;