agent-inspect 1.5.0 → 1.7.0

package/packages/core/dist/chunk-6QSLZCBJ.mjs

@@ -0,0 +1,743 @@
+import { source_default } from './chunk-BT7CATSD.mjs';
+import { resolveTraceSafetyOptions, preparePersistedInspectEventForWrite } from './chunk-57S5D6HR.mjs';
+import { extractCorrelationMetadata } from './chunk-S4YWKV4G.mjs';
+import { truncateName, formatDuration, createRunId, getDefaultTraceDir, createStepId } from './chunk-VTIB5MDK.mjs';
+import { AsyncLocalStorage } from 'async_hooks';
+
+var storage = new AsyncLocalStorage();
+function toPublicContext(ctx) {
+  return {
+    runId: ctx.runId,
+    runName: ctx.runName,
+    traceDir: ctx.traceDir,
+    silent: ctx.silent,
+    metadata: ctx.metadata
+  };
+}
+function invoke(fn) {
+  return new Promise((resolve, reject) => {
+    try {
+      Promise.resolve(fn()).then(resolve, reject);
+    } catch (e) {
+      reject(e);
+    }
+  });
+}
+function getCurrentContext() {
+  try {
+    const s = storage.getStore();
+    if (!s) return void 0;
+    return toPublicContext(s);
+  } catch {
+    return void 0;
+  }
+}
+function getCurrentRunId() {
+  try {
+    return storage.getStore()?.runId;
+  } catch {
+    return void 0;
+  }
+}
+function getCurrentCorrelationMetadata() {
+  try {
+    return extractCorrelationMetadata(storage.getStore()?.metadata);
+  } catch {
+    return void 0;
+  }
+}
+function getCurrentRunName() {
+  try {
+    return storage.getStore()?.runName;
+  } catch {
+    return void 0;
+  }
+}
+function getCurrentStepId() {
+  try {
+    return storage.getStore()?.currentStepId;
+  } catch {
+    return void 0;
+  }
+}
+function getParentStepId() {
+  return getCurrentStepId();
+}
+function getCurrentDepth() {
+  try {
+    const d = storage.getStore()?.currentDepth;
+    return typeof d === "number" && Number.isFinite(d) ? d : 0;
+  } catch {
+    return 0;
+  }
+}
+function hasActiveContext() {
+  try {
+    return storage.getStore() !== void 0;
+  } catch {
+    return false;
+  }
+}
+function getTraceDirFromContext() {
+  try {
+    return storage.getStore()?.traceDir;
+  } catch {
+    return void 0;
+  }
+}
+function isSilentContext() {
+  try {
+    const s = storage.getStore();
+    return s ? s.silent : false;
+  } catch {
+    return false;
+  }
+}
+function getTraceSafetyFromContext() {
+  try {
+    return storage.getStore()?.traceSafety;
+  } catch {
+    return void 0;
+  }
+}
+function runWithContext(context, fn, traceSafety = resolveTraceSafetyOptions()) {
+  const runtime = {
+    runId: context.runId,
+    runName: context.runName,
+    traceDir: context.traceDir,
+    silent: context.silent,
+    metadata: context.metadata,
+    traceSafety,
+    currentDepth: 0
+  };
+  return new Promise((resolve, reject) => {
+    storage.run(runtime, () => {
+      try {
+        Promise.resolve(fn()).then(resolve, reject);
+      } catch (e) {
+        reject(e);
+      }
+    });
+  });
+}
+function runWithStepContext(stepId, fn) {
+  let parent;
+  try {
+    parent = storage.getStore();
+  } catch {
+    parent = void 0;
+  }
+  if (!parent) {
+    return invoke(fn);
+  }
+  const derived = {
+    runId: parent.runId,
+    runName: parent.runName,
+    traceDir: parent.traceDir,
+    silent: parent.silent,
+    metadata: parent.metadata,
+    traceSafety: parent.traceSafety,
+    currentStepId: stepId,
+    currentDepth: parent.currentDepth + 1
+  };
+  return new Promise((resolve, reject) => {
+    storage.run(derived, () => {
+      try {
+        Promise.resolve(fn()).then(resolve, reject);
+      } catch (e) {
+        reject(e);
+      }
+    });
+  });
+}
+function invoke2(fn) {
+  return new Promise((resolve, reject) => {
+    try {
+      Promise.resolve(fn()).then(resolve, reject);
+    } catch (error) {
+      reject(error);
+    }
+  });
+}
+function normalizeError(error) {
+  if (error instanceof Error && error.message.trim() !== "") {
+    return error.message;
+  }
+  if (typeof error === "string" && error.trim() !== "") {
+    return error;
+  }
+  return "Unknown inspector runtime error";
+}
+var runtimeSequence = 0;
+function createRuntimeId() {
+  runtimeSequence += 1;
+  return `runtime_${runtimeSequence.toString(36)}`;
+}
+function publicContext(store) {
+  return {
+    runtimeId: store.runtimeId,
+    runId: store.runId,
+    runName: store.runName,
+    traceDir: store.traceDir,
+    silent: store.silent,
+    metadata: store.metadata
+  };
+}
+function createInspectorRuntime(options = {}) {
+  const storage2 = new AsyncLocalStorage();
+  const enabled = options.enabled ?? true;
+  const runtimeId = createRuntimeId();
+  const traceSafety = options.traceSafety ?? resolveTraceSafetyOptions();
+  let closed = false;
+  let instrumentationErrors = 0;
+  let lastInstrumentationError;
+  function recordInstrumentationError(error) {
+    instrumentationErrors += 1;
+    lastInstrumentationError = normalizeError(error);
+  }
+  function currentStore() {
+    try {
+      return storage2.getStore();
+    } catch (error) {
+      recordInstrumentationError(error);
+      return void 0;
+    }
+  }
+  const runtime = {
+    runtimeId,
+    enabled,
+    runWithContext(context, fn) {
+      if (!enabled) return invoke2(fn);
+      const store = {
+        runtimeId,
+        runId: context.runId,
+        runName: context.runName,
+        traceDir: context.traceDir,
+        silent: context.silent,
+        metadata: context.metadata,
+        traceSafety,
+        currentDepth: 0
+      };
+      return new Promise((resolve, reject) => {
+        storage2.run(store, () => {
+          invoke2(fn).then(resolve, reject);
+        });
+      });
+    },
+    runWithStepContext(stepId, fn) {
+      if (!enabled) return invoke2(fn);
+      const parent = currentStore();
+      if (!parent) return invoke2(fn);
+      const store = {
+        runtimeId,
+        runId: parent.runId,
+        runName: parent.runName,
+        traceDir: parent.traceDir,
+        silent: parent.silent,
+        metadata: parent.metadata,
+        traceSafety: parent.traceSafety,
+        currentStepId: stepId,
+        currentDepth: parent.currentDepth + 1
+      };
+      return new Promise((resolve, reject) => {
+        storage2.run(store, () => {
+          invoke2(fn).then(resolve, reject);
+        });
+      });
+    },
+    getCurrentContext() {
+      const store = currentStore();
+      return store ? publicContext(store) : void 0;
+    },
+    getCurrentCorrelationMetadata() {
+      return extractCorrelationMetadata(currentStore()?.metadata);
+    },
+    getCurrentStepId() {
+      return currentStore()?.currentStepId;
+    },
+    getCurrentDepth() {
+      const depth = currentStore()?.currentDepth;
+      return typeof depth === "number" && Number.isFinite(depth) ? depth : 0;
+    },
+    getTraceSafety() {
+      return traceSafety;
+    },
+    async write(event) {
+      if (!enabled || closed || !options.writer) return;
+      try {
+        const safe = preparePersistedInspectEventForWrite(event, traceSafety);
+        if (safe === void 0) {
+          recordInstrumentationError("Invalid persisted inspect event");
+          return;
+        }
+        await options.writer.write(safe);
+      } catch (error) {
+        recordInstrumentationError(error);
+      }
+    },
+    async flush() {
+      if (!options.writer) return;
+      try {
+        await options.writer.flush?.();
+      } catch (error) {
+        recordInstrumentationError(error);
+      }
+    },
+    async close() {
+      if (closed) return;
+      try {
+        await options.writer?.close?.();
+      } catch (error) {
+        recordInstrumentationError(error);
+      } finally {
+        closed = true;
+      }
+    },
+    getDiagnostics() {
+      const diagnostics = {
+        instrumentationErrors
+      };
+      if (lastInstrumentationError !== void 0) {
+        diagnostics.lastInstrumentationError = lastInstrumentationError;
+      }
+      const writerStats = options.writer?.getStats?.();
+      if (writerStats !== void 0) {
+        diagnostics.writerStats = writerStats;
+      }
+      return diagnostics;
+    }
+  };
+  return runtime;
+}
+
+// packages/core/src/inspector.ts
+function normalizeName(name, fallback) {
+  if (typeof name !== "string" || name.trim() === "") return fallback;
+  return truncateName(name.trim(), 100);
+}
+function nowIso() {
+  return (/* @__PURE__ */ new Date()).toISOString();
+}
+function durationMs(startedAt, endedAt) {
+  return Math.max(0, Date.parse(endedAt) - Date.parse(startedAt));
+}
+function mergeMetadata(base, override) {
+  if (base === void 0 && override === void 0) return void 0;
+  return {
+    ...base ?? {},
+    ...override ?? {}
+  };
+}
+function toPersistedError(error) {
+  if (error instanceof Error) {
+    return {
+      name: error.name,
+      message: error.message
+    };
+  }
+  if (typeof error === "string") {
+    return { message: error };
+  }
+  return { message: "Unknown error" };
+}
+function summarizeValue(value) {
+  if (value === null) return { type: "null" };
+  if (Array.isArray(value)) return { type: "array", length: value.length };
+  if (typeof value === "string") return { type: "string", length: value.length };
+  if (typeof value === "number") {
+    return { type: "number", finite: Number.isFinite(value) };
+  }
+  if (typeof value === "bigint") return { type: "bigint" };
+  if (typeof value === "boolean") return { type: "boolean" };
+  if (typeof value === "undefined") return { type: "undefined" };
+  if (typeof value === "symbol") return { type: "symbol" };
+  if (typeof value === "function") {
+    return { type: "function", name: value.name || void 0 };
+  }
+  if (typeof value === "object") {
+    const record = value;
+    let keyCount;
+    try {
+      keyCount = Object.keys(record).length;
+    } catch {
+      keyCount = void 0;
+    }
+    return {
+      type: "object",
+      constructorName: value?.constructor?.name,
+      ...keyCount !== void 0 ? { keyCount } : {}
+    };
+  }
+  return { type: typeof value };
+}
+function summarizeCapturedError(error) {
+  if (error instanceof Error) {
+    return { type: "error", name: error.name };
+  }
+  return summarizeValue(error);
+}
+function stepTypeToKind(type) {
+  switch (type) {
+    case "llm":
+      return "LLM";
+    case "tool":
+      return "TOOL";
+    case "decision":
+      return "DECISION";
+    case "run":
+      return "RUN";
+    default:
+      return "LOGIC";
+  }
+}
+function createInspector(options = {}) {
+  const traceSafety = options.traceSafety ?? resolveTraceSafetyOptions({
+    redactionProfile: options.redactionProfile
+  });
+  const runtime = createInspectorRuntime({
+    enabled: options.enabled,
+    writer: options.writer,
+    traceSafety
+  });
+  async function write(event) {
+    const safe = preparePersistedInspectEventForWrite(event, traceSafety);
+    if (safe !== void 0) {
+      await runtime.write(safe);
+    }
+  }
+  async function run(name, fn, runOptions = {}) {
+    if (typeof fn !== "function") {
+      throw new TypeError("inspector.run requires `fn` to be a function");
+    }
+    if (options.enabled === false) {
+      return Promise.resolve(fn());
+    }
+    const runName = normalizeName(name, "unnamed-run");
+    const runId = runOptions.runId ?? createRunId();
+    const traceDir = runOptions.traceDir ?? options.traceDir ?? getDefaultTraceDir();
+    const metadata = mergeMetadata(options.metadata, runOptions.metadata);
+    const startedAt = nowIso();
+    return runtime.runWithContext(
+      {
+        runId,
+        runName,
+        traceDir,
+        silent: runOptions.silent ?? options.silent ?? true,
+        metadata
+      },
+      async () => {
+        await write({
+          schemaVersion: "0.2",
+          eventId: `${runId}_started`,
+          runId,
+          kind: "RUN",
+          name: runName,
+          status: "running",
+          timestamp: startedAt,
+          startedAt,
+          confidence: "explicit",
+          source: { type: "manual", name: "createInspector" },
+          attributes: {
+            legacyEvent: "run_started",
+            ...metadata !== void 0 ? { metadata } : {}
+          }
+        });
+        try {
+          const result = await Promise.resolve(fn());
+          const endedAt = nowIso();
+          await write({
+            schemaVersion: "0.2",
+            eventId: `${runId}_completed`,
+            runId,
+            kind: "RUN",
+            name: runName,
+            status: "ok",
+            timestamp: endedAt,
+            endedAt,
+            durationMs: durationMs(startedAt, endedAt),
+            confidence: "explicit",
+            source: { type: "manual", name: "createInspector" },
+            attributes: { legacyEvent: "run_completed" },
+            ...options.capture?.onSuccess === "metadata-only" ? { outputSummary: summarizeValue(result) } : {}
+          });
+          return result;
+        } catch (error) {
+          const endedAt = nowIso();
+          await write({
+            schemaVersion: "0.2",
+            eventId: `${runId}_completed`,
+            runId,
+            kind: "RUN",
+            name: runName,
+            status: "error",
+            timestamp: endedAt,
+            endedAt,
+            durationMs: durationMs(startedAt, endedAt),
+            confidence: "explicit",
+            source: { type: "manual", name: "createInspector" },
+            attributes: { legacyEvent: "run_completed" },
+            ...options.capture?.onError === "metadata-only" ? { outputSummary: summarizeCapturedError(error) } : {},
+            error: toPersistedError(error)
+          });
+          throw error;
+        }
+      }
+    );
+  }
+  async function step(name, fn, stepOptions = {}) {
+    if (typeof fn !== "function") {
+      throw new TypeError("inspector.step requires `fn` to be a function");
+    }
+    if (options.enabled === false || !runtime.getCurrentContext()) {
+      return Promise.resolve(fn());
+    }
+    const context = runtime.getCurrentContext();
+    const stepName = normalizeName(name, "unnamed-step");
+    const stepId = createStepId();
+    const parentId = runtime.getCurrentStepId();
+    const stepType = stepOptions.type ?? "logic";
+    const startedAt = nowIso();
+    const attributes = {
+      legacyEvent: "step_started",
+      stepId,
+      stepType,
+      ...stepOptions.metadata !== void 0 ? { metadata: stepOptions.metadata } : {}
+    };
+    await write({
+      schemaVersion: "0.2",
+      eventId: `${stepId}_started`,
+      runId: context.runId,
+      ...parentId !== void 0 ? { parentId } : {},
+      kind: stepTypeToKind(stepType),
+      name: stepName,
+      status: "running",
+      timestamp: startedAt,
+      startedAt,
+      confidence: "explicit",
+      source: { type: "manual", name: "createInspector" },
+      attributes
+    });
+    return runtime.runWithStepContext(stepId, async () => {
+      try {
+        const result = await Promise.resolve(fn());
+        const endedAt = nowIso();
+        await write({
+          schemaVersion: "0.2",
+          eventId: `${stepId}_completed`,
+          runId: context.runId,
+          kind: stepTypeToKind(stepType),
+          name: stepName,
+          status: "ok",
+          timestamp: endedAt,
+          endedAt,
+          durationMs: durationMs(startedAt, endedAt),
+          confidence: "explicit",
+          source: { type: "manual", name: "createInspector" },
+          attributes: {
+            legacyEvent: "step_completed",
+            stepId,
+            stepType
+          },
+          ...options.capture?.onSuccess === "metadata-only" ? { outputSummary: summarizeValue(result) } : {}
+        });
+        return result;
+      } catch (error) {
+        const endedAt = nowIso();
+        await write({
+          schemaVersion: "0.2",
+          eventId: `${stepId}_completed`,
+          runId: context.runId,
+          kind: stepTypeToKind(stepType),
+          name: stepName,
+          status: "error",
+          timestamp: endedAt,
+          endedAt,
+          durationMs: durationMs(startedAt, endedAt),
+          confidence: "explicit",
+          source: { type: "manual", name: "createInspector" },
+          attributes: {
+            legacyEvent: "step_completed",
+            stepId,
+            stepType
+          },
+          ...options.capture?.onError === "metadata-only" ? { outputSummary: summarizeCapturedError(error) } : {},
+          error: toPersistedError(error)
+        });
+        throw error;
+      }
+    });
+  }
+  const inspector = {
+    runtime,
+    run,
+    step,
+    tool(name, fn, toolOptions) {
+      const toolName = normalizeName(name, "unknown-tool");
+      return step(`tool:${toolName}`, fn, {
+        ...toolOptions,
+        type: "tool",
+        metadata: {
+          ...toolOptions?.metadata ?? {},
+          toolName
+        }
+      });
+    },
+    llm(name, fn, llmOptions) {
+      const model = normalizeName(name, "unknown-model");
+      return step(`llm:${model}`, fn, {
+        ...llmOptions,
+        type: "llm",
+        metadata: {
+          ...llmOptions?.metadata ?? {},
+          model
+        }
+      });
+    },
+    observe(name, fn, observeOptions) {
+      return async (...args) => step(name, () => Promise.resolve(fn(...args)), observeOptions);
+    },
+    getDiagnostics() {
+      return runtime.getDiagnostics();
+    },
+    flush() {
+      return runtime.flush();
+    },
+    close() {
+      return runtime.close();
+    }
+  };
+  return inspector;
+}
+
+// packages/core/src/terminal.ts
+var TERMINAL_INDENT = "  ";
+var MAX_TERMINAL_NAME_LENGTH = 80;
+var MAX_TERMINAL_DEPTH = 10;
+function normalizeDepth(depth) {
+  if (!Number.isFinite(depth) || depth < 0) {
+    return 0;
+  }
+  return Math.min(Math.floor(depth), MAX_TERMINAL_DEPTH);
+}
+function safePrint(line = "") {
+  try {
+    console.log(line);
+  } catch {
+  }
+}
+function getIndent(depth) {
+  return TERMINAL_INDENT.repeat(normalizeDepth(depth));
+}
+function formatTerminalName(name) {
+  if (typeof name !== "string" || name.trim() === "") {
+    return "unnamed";
+  }
+  return truncateName(name, MAX_TERMINAL_NAME_LENGTH);
+}
+function getStatusIcon(status) {
+  if (status === "success") return source_default.green("\u2714");
+  if (status === "error") return source_default.red("\u2716");
+  return source_default.yellow("\u23F3");
+}
+function renderStepLine(name, durationMs2, status, depth) {
+  try {
+    const nm = formatTerminalName(name);
+    const ind = getIndent(depth ?? 0);
+    if (status === "running" && durationMs2 === void 0) {
+      return `${ind}${source_default.yellow("\u23F3")} ${nm}`;
+    }
+    const hasDur = durationMs2 !== void 0 && Number.isFinite(durationMs2);
+    const dur = hasDur ? formatDuration(durationMs2) : void 0;
+    if (status === "running") {
+      return dur !== void 0 ? `${ind}${source_default.yellow("\u23F3")} ${nm} (${dur})` : `${ind}${source_default.yellow("\u23F3")} ${nm}`;
+    }
+    if (!hasDur || dur === void 0) {
+      return `${ind}${source_default.yellow("\u23F3")} ${nm}`;
+    }
+    if (status === "success") {
+      return `${ind}${getStatusIcon("success")} ${nm} (${dur})`;
+    }
+    return `${ind}${getStatusIcon("error")} ${nm} (${dur})`;
+  } catch {
+    return "";
+  }
+}
+function renderErrorLine(error, depth) {
+  try {
+    const msg = typeof error.message === "string" ? error.message : "";
+    const ind = getIndent((depth ?? 0) + 1);
+    return `${ind}Error: ${msg}`;
+  } catch {
+    return "";
+  }
+}
+function renderRunSummary(durationMs2, status, traceFilePath) {
+  try {
+    const dur = Number.isFinite(durationMs2) ? formatDuration(durationMs2) : formatDuration(0);
+    const head = status === "error" ? `Failed in ${dur}` : `Completed in ${dur}`;
+    const lines = [head];
+    if (traceFilePath !== void 0 && traceFilePath.trim() !== "") {
+      lines.push(`Trace: ${traceFilePath}`);
+    }
+    return lines;
+  } catch {
+    return [];
+  }
+}
+function printRunStart(runId, name) {
+  if (isSilentContext()) return;
+  try {
+    safePrint("");
+    const header = `${source_default.cyan.bold("\u{1F50D} AgentInspect:")} ${formatTerminalName(name)} ${source_default.dim(`(${runId})`)}`;
+    safePrint(header);
+  } catch {
+  }
+}
+function printStepStart(name, depth = 0) {
+  if (isSilentContext()) return;
+  try {
+    safePrint(renderStepLine(name, void 0, "running", depth));
+  } catch {
+  }
+}
+function printStepComplete(name, durationMs2, status, depth = 0) {
+  if (isSilentContext()) return;
+  try {
+    safePrint(renderStepLine(name, durationMs2, status, depth));
+  } catch {
+  }
+}
+function printError(error, depth = 0) {
+  if (isSilentContext()) return;
+  try {
+    safePrint(renderErrorLine(error, depth));
+  } catch {
+  }
+}
+function printRunComplete(_name, _runId, durationMs2, status, traceFilePath) {
+  if (isSilentContext()) return;
+  try {
+    const lines = renderRunSummary(durationMs2, status, traceFilePath);
+    for (let i = 0; i < lines.length; i++) {
+      const line = lines[i];
+      if (i === 0) {
+        const color = status === "error" ? source_default.red : status === "running" ? source_default.yellow : source_default.green;
+        safePrint(color(line));
+      } else {
+        safePrint(source_default.dim(line));
+      }
+    }
+  } catch {
+  }
+}
+function printFailedAt(stepName) {
+  if (isSilentContext()) return;
+  try {
+    safePrint(`Failed at: ${formatTerminalName(stepName)}`);
+  } catch {
+  }
+}
+
+export { MAX_TERMINAL_DEPTH, MAX_TERMINAL_NAME_LENGTH, TERMINAL_INDENT, createInspector, createInspectorRuntime, formatTerminalName, getCurrentContext, getCurrentCorrelationMetadata, getCurrentDepth, getCurrentRunId, getCurrentRunName, getCurrentStepId, getIndent, getParentStepId, getTraceDirFromContext, getTraceSafetyFromContext, hasActiveContext, isSilentContext, printError, printFailedAt, printRunComplete, printRunStart, printStepComplete, printStepStart, renderErrorLine, renderRunSummary, renderStepLine, runWithContext, runWithStepContext };
+//# sourceMappingURL=chunk-6QSLZCBJ.mjs.map
+//# sourceMappingURL=chunk-6QSLZCBJ.mjs.map