agent-inspect 0.1.0

package/packages/core/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts","../src/utils.ts","../src/context.ts","../src/storage.ts","../src/terminal.ts","../src/inspect-run.ts","../src/step.ts","../src/observe.ts"],"names":["path","os","nanoid","mkdir","AsyncLocalStorage","isRecord","writeFile","appendFile","readFile","readdir","stat","chalk","endTime","durationMs","printPath","safeInstrumentation"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Discriminator for what kind of work a {@link Step} represents.\n * `\"decision\"` captures agent branching/choices; other values cover runs, LLM calls, tools, and user-defined steps.\n */\nexport type StepType =\n  | \"run\"\n  | \"llm\"\n  | \"tool\"\n  | \"decision\"\n  | \"logic\"\n  | \"state\"\n  | \"custom\";\n\n/** Lifecycle state of a single {@link Step}. */\nexport type StepStatus = \"running\" | \"success\" | \"error\";\n\n/** Lifecycle state of an entire {@link Run}. */\nexport type RunStatus = \"running\" | \"success\" | \"error\";\n\n/** Structured error attached to a run or step when status is `\"error\"`. */\nexport interface ErrorInfo {\n  message: string;\n  stack?: string;\n}\n\n/**\n * Optional token counts for a step (e.g. LLM usage).\n * Reserved for future roadmap; MVP does not compute or persist token usage.\n */\nexport interface TokenMetadata {\n  input?: number;\n  output?: number;\n}\n\n/** Arbitrary structured fields for a step; safe extensions use string keys. */\nexport interface StepMetadata {\n  model?: string;\n  toolName?: string;\n  tokens?: TokenMetadata;\n  retryCount?: number;\n  [key: string]: unknown;\n}\n\n/**\n * One traced agent run (root of an execution tree).\n * MVP intentionally omits `input` / `output` on the run to limit PII, secrets, and serialization risk.\n */\nexport interface Run {\n  id: string;\n  name: string;\n  status: RunStatus;\n  startTime: number;\n  endTime?: number;\n  durationMs?: number;\n  error?: ErrorInfo;\n  metadata?: Record<string, unknown>;\n}\n\n/**\n * One node in the execution tree under a {@link Run}.\n * MVP intentionally omits `input` / `output`; capture/redaction may come in a later version.\n */\nexport interface Step {\n  id: string;\n  runId: string;\n  parentId?: string;\n  name: string;\n  type: StepType;\n  status: StepStatus;\n  startTime: number;\n  endTime?: number;\n  durationMs?: number;\n  error?: ErrorInfo;\n  metadata?: StepMetadata;\n}\n\n/** Version of the JSONL trace line schema consumed by AgentInspect tooling. */\nexport type TraceSchemaVersion = \"0.1\";\n\n/** Fields shared by every persisted trace event line. */\nexport interface TraceEventBase {\n  schemaVersion: TraceSchemaVersion;\n  event: string;\n  timestamp: number;\n}\n\n/** Emitted when a run begins. */\nexport interface RunStartedEvent extends TraceEventBase {\n  event: \"run_started\";\n  runId: string;\n  name: string;\n  startTime: number;\n  metadata?: Record<string, unknown>;\n}\n\n/** Emitted when a run finishes successfully or with an error. */\nexport interface RunCompletedEvent extends TraceEventBase {\n  event: \"run_completed\";\n  runId: string;\n  status: \"success\" | \"error\";\n  endTime: number;\n  durationMs: number;\n  error?: ErrorInfo;\n}\n\n/** Emitted when a step begins (including nested steps under `parentId`). */\nexport interface StepStartedEvent extends TraceEventBase {\n  event: \"step_started\";\n  runId: string;\n  stepId: string;\n  parentId?: string;\n  name: string;\n  type: StepType;\n  startTime: number;\n  metadata?: StepMetadata;\n}\n\n/**\n * Emitted when a step finishes (success or failure).\n * Failures use `status: \"error\"` and optional {@link ErrorInfo}; there is no separate `step_failed` event in MVP.\n */\nexport interface StepCompletedEvent extends TraceEventBase {\n  event: \"step_completed\";\n  runId: string;\n  stepId: string;\n  status: \"success\" | \"error\";\n  endTime: number;\n  durationMs: number;\n  error?: ErrorInfo;\n}\n\n/** Discriminated union of all MVP trace events written as JSONL lines. */\nexport type TraceEvent =\n  | RunStartedEvent\n  | RunCompletedEvent\n  | StepStartedEvent\n  | StepCompletedEvent;\n\n/** Options for `inspectRun()` (implemented in a later step). */\nexport interface InspectRunOptions {\n  traceDir?: string;\n  silent?: boolean;\n  metadata?: Record<string, unknown>;\n}\n\n/** Options passed when opening a logical step (implemented in a later step). */\nexport interface StepOptions {\n  type?: StepType;\n  metadata?: StepMetadata;\n}\n\n/** Options for `observe()` — same surface as {@link InspectRunOptions} in MVP. */\nexport type ObserveOptions = InspectRunOptions;\n\n/**\n * Resolved settings for the active run while tracing is enabled.\n * Populated by runtime code in a later step; defined here for `context.ts`.\n */\nexport interface ExecutionContext {\n  runId: string;\n  runName: string;\n  traceDir: string;\n  silent: boolean;\n  metadata?: Record<string, unknown>;\n}\n\n/** Stack position of the step currently executing (used by future context tracking). */\nexport interface ActiveStepContext {\n  stepId: string;\n  parentId?: string;\n  depth: number;\n}\n\nconst STEP_TYPES: readonly StepType[] = [\n  \"run\",\n  \"llm\",\n  \"tool\",\n  \"decision\",\n  \"logic\",\n  \"state\",\n  \"custom\",\n] as const;\n\nconst STEP_STATUSES: readonly StepStatus[] = [\n  \"running\",\n  \"success\",\n  \"error\",\n] as const;\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\n/** Returns true if `value` is one of the MVP {@link StepType} literals. */\nexport function isStepType(value: unknown): value is StepType {\n  return (\n    typeof value === \"string\" &&\n    (STEP_TYPES as readonly string[]).includes(value)\n  );\n}\n\n/** Returns true if `value` is one of the MVP {@link StepStatus} literals. */\nexport function isStepStatus(value: unknown): value is StepStatus {\n  return (\n    typeof value === \"string\" &&\n    (STEP_STATUSES as readonly string[]).includes(value)\n  );\n}\n\n/**\n * Narrowing guard for a {@link TraceEvent} object with required MVP fields.\n * Does not deeply validate optional `metadata` shapes.\n */\nexport function isTraceEvent(value: unknown): value is TraceEvent {\n  if (!isRecord(value)) return false;\n  if (value.schemaVersion !== \"0.1\") return false;\n  if (typeof value.timestamp !== \"number\") return false;\n  if (typeof value.event !== \"string\") return false;\n\n  switch (value.event) {\n    case \"run_started\": {\n      return (\n        typeof value.runId === \"string\" &&\n        typeof value.name === \"string\" &&\n        typeof value.startTime === \"number\"\n      );\n    }\n    case \"run_completed\": {\n      return (\n        typeof value.runId === \"string\" &&\n        (value.status === \"success\" || value.status === \"error\") &&\n        typeof value.endTime === \"number\" &&\n        typeof value.durationMs === \"number\"\n      );\n    }\n    case \"step_started\": {\n      return (\n        typeof value.runId === \"string\" &&\n        typeof value.stepId === \"string\" &&\n        typeof value.name === \"string\" &&\n        isStepType(value.type) &&\n        typeof value.startTime === \"number\"\n      );\n    }\n    case \"step_completed\": {\n      return (\n        typeof value.runId === \"string\" &&\n        typeof value.stepId === \"string\" &&\n        (value.status === \"success\" || value.status === \"error\") &&\n        typeof value.endTime === \"number\" &&\n        typeof value.durationMs === \"number\"\n      );\n    }\n    default:\n      return false;\n  }\n}\n","import { mkdir } from \"node:fs/promises\";\nimport os from \"node:os\";\nimport path from \"node:path\";\n\nimport { nanoid } from \"nanoid\";\n\nimport type { ErrorInfo } from \"./types.js\";\n\n/** Default folder under the user home for AgentInspect data. */\nexport const DEFAULT_TRACE_DIR_NAME = \".agent-inspect\";\n\n/** Subfolder where JSONL run traces are stored. */\nexport const RUNS_DIR_NAME = \"runs\";\n\n/** Writable trace root when the default home path cannot be used. */\nexport const FALLBACK_TRACE_DIR = path.join(\n  os.tmpdir(),\n  \"agent-inspect\",\n  RUNS_DIR_NAME,\n);\n\n/** Maximum display length for run/step names before truncation. */\nexport const MAX_NAME_LENGTH = 100;\n\n/** Returns `run_` + a 10-character nanoid segment. */\nexport function createRunId(): string {\n  return `run_${nanoid(10)}`;\n}\n\n/** Returns `step_` + a 10-character nanoid segment. */\nexport function createStepId(): string {\n  return `step_${nanoid(10)}`;\n}\n\n/**\n * Formats a duration for CLI display.\n * Under 1000 ms uses whole milliseconds; from 1000 ms uses seconds with one decimal.\n */\nexport function formatDuration(ms: number): string {\n  if (!Number.isFinite(ms) || ms < 0) {\n    return \"0ms\";\n  }\n  if (ms < 1000) {\n    return `${Math.floor(ms)}ms`;\n  }\n  const seconds = ms / 1000;\n  return `${(Math.round(seconds * 10) / 10).toFixed(1)}s`;\n}\n\n/**\n * Formats a Unix timestamp (ms) as local `YYYY-MM-DD HH:mm:ss`.\n * Invalid values yield `\"Invalid date\"` (no throw).\n */\nexport function formatTimestamp(timestamp: number): string {\n  if (!Number.isFinite(timestamp)) {\n    return \"Invalid date\";\n  }\n  const d = new Date(timestamp);\n  if (Number.isNaN(d.getTime())) {\n    return \"Invalid date\";\n  }\n  const y = d.getFullYear();\n  const mo = String(d.getMonth() + 1).padStart(2, \"0\");\n  const day = String(d.getDate()).padStart(2, \"0\");\n  const h = String(d.getHours()).padStart(2, \"0\");\n  const min = String(d.getMinutes()).padStart(2, \"0\");\n  const s = String(d.getSeconds()).padStart(2, \"0\");\n  return `${y}-${mo}-${day} ${h}:${min}:${s}`;\n}\n\n/**\n * Default directory for trace files: `~/DEFAULT_TRACE_DIR_NAME/RUNS_DIR_NAME`.\n * Falls back to {@link FALLBACK_TRACE_DIR} when home cannot be resolved.\n */\nexport function getDefaultTraceDir(): string {\n  try {\n    const home = os.homedir();\n    if (typeof home !== \"string\" || home.trim() === \"\") {\n      return FALLBACK_TRACE_DIR;\n    }\n    return path.join(home, DEFAULT_TRACE_DIR_NAME, RUNS_DIR_NAME);\n  } catch {\n    return FALLBACK_TRACE_DIR;\n  }\n}\n\n/**\n * Full path to the JSONL trace file for a run.\n * `runId` is passed through `path.basename` to avoid traversal; empty ids become `run_unknown`.\n */\nexport function getTraceFilePath(runId: string, traceDir?: string): string {\n  const baseDir = traceDir ?? getDefaultTraceDir();\n  let safeId =\n    typeof runId === \"string\" && runId.trim() !== \"\" ? runId.trim() : \"run_unknown\";\n  safeId = path.basename(safeId);\n  if (safeId === \"\" || safeId === \".\" || safeId === \"..\") {\n    safeId = \"run_unknown\";\n  }\n  return path.join(baseDir, `${safeId}.jsonl`);\n}\n\n/**\n * Ensures a trace directory exists (recursive). Tries {@link FALLBACK_TRACE_DIR} on failure.\n * Returns the directory path that callers should prefer: primary, fallback, or original if both mkdir attempts fail.\n * Emits concise `[AgentInspect]` warnings on failure; never throws.\n */\nexport async function ensureTraceDir(traceDir: string): Promise<string> {\n  const primary = path.resolve(traceDir);\n  try {\n    await mkdir(primary, { recursive: true });\n    return primary;\n  } catch {\n    warn(`Failed to create trace directory: ${primary}`);\n    const fallback = path.resolve(FALLBACK_TRACE_DIR);\n    try {\n      await mkdir(fallback, { recursive: true });\n      return fallback;\n    } catch {\n      warn(`Failed to create fallback trace directory: ${fallback}`);\n      return primary;\n    }\n  }\n}\n\n/**\n * Normalizes any thrown/caught value into {@link ErrorInfo}.\n * Never throws (circular structures and non-JSON values fall back to a generic message).\n */\nexport function formatError(error: unknown): ErrorInfo {\n  if (error instanceof Error) {\n    const out: ErrorInfo = { message: error.message };\n    if (typeof error.stack === \"string\" && error.stack.length > 0) {\n      out.stack = error.stack;\n    }\n    return out;\n  }\n  if (typeof error === \"string\") {\n    return { message: error };\n  }\n  if (error === null) {\n    return { message: \"Unknown error: null\" };\n  }\n  if (error === undefined) {\n    return { message: \"Unknown error: undefined\" };\n  }\n  if (\n    typeof error === \"number\" ||\n    typeof error === \"boolean\" ||\n    typeof error === \"bigint\"\n  ) {\n    return { message: String(error) };\n  }\n  if (typeof error === \"object\") {\n    try {\n      return { message: JSON.stringify(error) };\n    } catch {\n      return { message: \"Unknown error\" };\n    }\n  }\n  return { message: \"Unknown error\" };\n}\n\n/**\n * Truncates a display name to `maxLength`, appending `\"...\"` when shortened.\n * Empty or non-string input becomes `\"unnamed\"`.\n */\nexport function truncateName(name: string, maxLength = MAX_NAME_LENGTH): string {\n  if (typeof name !== \"string\" || name.trim() === \"\") {\n    return \"unnamed\";\n  }\n  const trimmed = name.trim();\n  if (trimmed.length <= maxLength) {\n    return trimmed;\n  }\n  const ellipsis = \"...\";\n  const head = Math.max(0, maxLength - ellipsis.length);\n  return `${trimmed.slice(0, head)}${ellipsis}`;\n}\n\n/**\n * Instrumentation-only warning to stderr. Not a general-purpose logger.\n * Optional `error` is summarized via {@link formatError} (message only).\n */\nexport function warn(message: string, error?: unknown): void {\n  const base = `[AgentInspect] ${message}`;\n  if (error === undefined) {\n    console.warn(base);\n    return;\n  }\n  console.warn(`${base}: ${formatError(error).message}`);\n}\n","import { AsyncLocalStorage } from \"node:async_hooks\";\n\nimport type { ExecutionContext } from \"./types.js\";\n\ntype RuntimeExecutionContext = ExecutionContext & {\n  currentStepId?: string;\n  currentDepth: number;\n};\n\nconst storage = new AsyncLocalStorage<RuntimeExecutionContext>();\n\nfunction toPublicContext(ctx: RuntimeExecutionContext): ExecutionContext {\n  return {\n    runId: ctx.runId,\n    runName: ctx.runName,\n    traceDir: ctx.traceDir,\n    silent: ctx.silent,\n    metadata: ctx.metadata,\n  };\n}\n\nfunction invoke<T>(fn: () => T | Promise<T>): Promise<T> {\n  return new Promise((resolve, reject) => {\n    try {\n      Promise.resolve(fn()).then(resolve, reject);\n    } catch (e) {\n      reject(e);\n    }\n  });\n}\n\n/** Returns the active run context, without internal step fields. */\nexport function getCurrentContext(): ExecutionContext | undefined {\n  try {\n    const s = storage.getStore();\n    if (!s) return undefined;\n    return toPublicContext(s);\n  } catch {\n    return undefined;\n  }\n}\n\n/** Active `runId` when inside `runWithContext`, else `undefined`. */\nexport function getCurrentRunId(): string | undefined {\n  try {\n    return storage.getStore()?.runId;\n  } catch {\n    return undefined;\n  }\n}\n\n/** Active `runName` when inside `runWithContext`, else `undefined`. */\nexport function getCurrentRunName(): string | undefined {\n  try {\n    return storage.getStore()?.runName;\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * Active step id in this async scope (parent for nested `step()` calls).\n * `undefined` at run root or outside any run.\n */\nexport function getCurrentStepId(): string | undefined {\n  try {\n    return storage.getStore()?.currentStepId;\n  } catch {\n    return undefined;\n  }\n}\n\n/** Alias of {@link getCurrentStepId} for readability in step instrumentation. */\nexport function getParentStepId(): string | undefined {\n  return getCurrentStepId();\n}\n\n/**\n * Nesting depth: `0` at run root, increments by one per nested `runWithStepContext`.\n * Returns `0` outside any run.\n */\nexport function getCurrentDepth(): number {\n  try {\n    const d = storage.getStore()?.currentDepth;\n    return typeof d === \"number\" && Number.isFinite(d) ? d : 0;\n  } catch {\n    return 0;\n  }\n}\n\nexport function hasActiveContext(): boolean {\n  try {\n    return storage.getStore() !== undefined;\n  } catch {\n    return false;\n  }\n}\n\nexport function getTraceDirFromContext(): string | undefined {\n  try {\n    return storage.getStore()?.traceDir;\n  } catch {\n    return undefined;\n  }\n}\n\nexport function isSilentContext(): boolean {\n  try {\n    const s = storage.getStore();\n    return s ? s.silent : false;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Runs `fn` with a fresh AgentInspect run context (depth 0, no active step).\n * Propagates sync/async results and rejections; does not swallow user errors.\n */\nexport function runWithContext<T>(\n  context: ExecutionContext,\n  fn: () => Promise<T> | T,\n): Promise<T> {\n  const runtime: RuntimeExecutionContext = {\n    runId: context.runId,\n    runName: context.runName,\n    traceDir: context.traceDir,\n    silent: context.silent,\n    metadata: context.metadata,\n    currentDepth: 0,\n  };\n\n  return new Promise((resolve, reject) => {\n    storage.run(runtime, () => {\n      try {\n        Promise.resolve(fn()).then(resolve, reject);\n      } catch (e) {\n        reject(e);\n      }\n    });\n  });\n}\n\n/**\n * Runs `fn` with `stepId` as the active step (incremented depth).\n * If no run is active, runs `fn` without altering async context.\n */\nexport function runWithStepContext<T>(\n  stepId: string,\n  fn: () => Promise<T> | T,\n): Promise<T> {\n  let parent: RuntimeExecutionContext | undefined;\n  try {\n    parent = storage.getStore();\n  } catch {\n    parent = undefined;\n  }\n\n  if (!parent) {\n    return invoke(fn);\n  }\n\n  const derived: RuntimeExecutionContext = {\n    runId: parent.runId,\n    runName: parent.runName,\n    traceDir: parent.traceDir,\n    silent: parent.silent,\n    metadata: parent.metadata,\n    currentStepId: stepId,\n    currentDepth: parent.currentDepth + 1,\n  };\n\n  return new Promise((resolve, reject) => {\n    storage.run(derived, () => {\n      try {\n        Promise.resolve(fn()).then(resolve, reject);\n      } catch (e) {\n        reject(e);\n      }\n    });\n  });\n}\n","import { appendFile, readdir, readFile, stat, writeFile } from \"node:fs/promises\";\nimport path from \"node:path\";\n\nimport type { TraceEvent } from \"./types.js\";\nimport { isStepType } from \"./types.js\";\nimport {\n  ensureTraceDir,\n  FALLBACK_TRACE_DIR,\n  getTraceFilePath,\n  warn,\n} from \"./utils.js\";\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction nonEmptyString(value: unknown): value is string {\n  return typeof value === \"string\" && value.trim() !== \"\";\n}\n\nfunction finiteNumber(value: unknown): value is number {\n  return typeof value === \"number\" && Number.isFinite(value);\n}\n\nfunction optionalErrorInfo(value: unknown): boolean {\n  if (value === undefined) return true;\n  if (!isRecord(value)) return false;\n  if (typeof value.message !== \"string\") return false;\n  if (\"stack\" in value && value.stack !== undefined) {\n    if (typeof value.stack !== \"string\") return false;\n  }\n  return true;\n}\n\n/**\n * Strict MVP validation before writing JSONL. Rejects empty ids, non-finite times, and malformed payloads.\n */\nexport function validateEvent(event: unknown): event is TraceEvent {\n  if (!isRecord(event)) return false;\n  if (event.schemaVersion !== \"0.1\") return false;\n  if (!finiteNumber(event.timestamp)) return false;\n  if (typeof event.event !== \"string\") return false;\n\n  switch (event.event) {\n    case \"run_started\": {\n      if (\n        !nonEmptyString(event.runId) ||\n        !nonEmptyString(event.name) ||\n        !finiteNumber(event.startTime)\n      ) {\n        return false;\n      }\n      if (event.metadata !== undefined && !isRecord(event.metadata)) {\n        return false;\n      }\n      return true;\n    }\n    case \"run_completed\": {\n      return (\n        nonEmptyString(event.runId) &&\n        (event.status === \"success\" || event.status === \"error\") &&\n        finiteNumber(event.endTime) &&\n        finiteNumber(event.durationMs) &&\n        optionalErrorInfo(event.error)\n      );\n    }\n    case \"step_started\": {\n      if (\n        !nonEmptyString(event.runId) ||\n        !nonEmptyString(event.stepId) ||\n        !nonEmptyString(event.name) ||\n        !isStepType(event.type) ||\n        !finiteNumber(event.startTime)\n      ) {\n        return false;\n      }\n      if (event.parentId !== undefined && typeof event.parentId !== \"string\") {\n        return false;\n      }\n      if (event.metadata !== undefined && !isRecord(event.metadata)) {\n        return false;\n      }\n      return true;\n    }\n    case \"step_completed\": {\n      return (\n        nonEmptyString(event.runId) &&\n        nonEmptyString(event.stepId) &&\n        (event.status === \"success\" || event.status === \"error\") &&\n        finiteNumber(event.endTime) &&\n        finiteNumber(event.durationMs) &&\n        optionalErrorInfo(event.error)\n      );\n    }\n    default:\n      return false;\n  }\n}\n\n/** Serializes a trace line as compact JSON without a trailing newline. */\nexport function serializeEvent(event: TraceEvent): string {\n  try {\n    return JSON.stringify(event);\n  } catch {\n    return \"\";\n  }\n}\n\n/**\n * Creates (or truncates) an empty JSONL file for a run. Uses {@link ensureTraceDir} then {@link getTraceFilePath}.\n * On failure, retries once under {@link FALLBACK_TRACE_DIR}.\n */\nexport async function initializeTraceFile(\n  runId: string,\n  traceDir: string,\n): Promise<string | undefined> {\n  try {\n    const usable = await ensureTraceDir(traceDir);\n    const filePath = getTraceFilePath(runId, usable);\n    await writeFile(filePath, \"\", \"utf-8\");\n    return filePath;\n  } catch (e) {\n    warn(\"Failed to initialize trace file\", e);\n  }\n\n  try {\n    const usable = await ensureTraceDir(FALLBACK_TRACE_DIR);\n    const filePath = getTraceFilePath(runId, usable);\n    await writeFile(filePath, \"\", \"utf-8\");\n    return filePath;\n  } catch (e) {\n    warn(\"Failed to initialize trace file on fallback directory\", e);\n    return undefined;\n  }\n}\n\n/**\n * Appends one validated JSONL line for `event.runId`. Falls back to {@link FALLBACK_TRACE_DIR} on append failure.\n */\nexport async function writeTraceEvent(\n  event: TraceEvent,\n  traceDir: string,\n): Promise<void> {\n  if (!validateEvent(event)) {\n    warn(\"Skipped invalid trace event (validation failed)\");\n    return;\n  }\n\n  const line = serializeEvent(event);\n  if (line === \"\") {\n    warn(\"Skipped trace event (serialization failed)\");\n    return;\n  }\n\n  const payload = `${line}\\n`;\n\n  const tryAppend = async (dir: string): Promise<boolean> => {\n    try {\n      const usable = await ensureTraceDir(dir);\n      const filePath = getTraceFilePath(event.runId, usable);\n      await appendFile(filePath, payload, \"utf-8\");\n      return true;\n    } catch {\n      return false;\n    }\n  };\n\n  if (await tryAppend(traceDir)) {\n    return;\n  }\n\n  warn(`Failed to append trace event for run ${event.runId}`);\n\n  if (await tryAppend(FALLBACK_TRACE_DIR)) {\n    return;\n  }\n\n  warn(\"Failed to append trace event to fallback directory\");\n}\n\n/**\n * Reads raw JSONL file contents for a run, or `undefined` if missing or unreadable.\n */\nexport async function readTraceFile(\n  runId: string,\n  traceDir: string,\n): Promise<string | undefined> {\n  try {\n    const filePath = getTraceFilePath(runId, traceDir);\n    return await readFile(filePath, \"utf-8\");\n  } catch (e) {\n    if (e && typeof e === \"object\" && \"code\" in e && e.code === \"ENOENT\") {\n      return undefined;\n    }\n    warn(\"Unexpected error reading trace file\", e);\n    return undefined;\n  }\n}\n\n/** Parses JSONL into validated {@link TraceEvent} rows; invalid lines are skipped with a warning. */\nexport async function readTraceEvents(\n  runId: string,\n  traceDir: string,\n): Promise<TraceEvent[]> {\n  const out: TraceEvent[] = [];\n  try {\n    const raw = await readTraceFile(runId, traceDir);\n    if (raw === undefined) {\n      return out;\n    }\n    const lines = raw.split(\"\\n\");\n    for (const line of lines) {\n      const trimmed = line.trim();\n      if (trimmed === \"\") continue;\n      let parsed: unknown;\n      try {\n        parsed = JSON.parse(trimmed) as unknown;\n      } catch {\n        warn(\"Skipped invalid JSON line in trace file\");\n        continue;\n      }\n      if (validateEvent(parsed)) {\n        out.push(parsed);\n      } else {\n        warn(\"Skipped invalid trace event line in trace file\");\n      }\n    }\n  } catch (e) {\n    warn(\"Failed to read trace events\", e);\n  }\n  return out;\n}\n\n/**\n * Lists `.jsonl` file names in `traceDir`, newest by mtime first (name sort as tie-breaker).\n */\nexport async function listTraceFiles(traceDir: string): Promise<string[]> {\n  try {\n    const usable = path.resolve(traceDir);\n    const names = await readdir(usable);\n    const jsonl = names.filter((n) => n.endsWith(\".jsonl\"));\n    const withStat = await Promise.all(\n      jsonl.map(async (name) => {\n        try {\n          const st = await stat(path.join(usable, name));\n          return { name, mtime: st.mtimeMs };\n        } catch {\n          return { name, mtime: 0 };\n        }\n      }),\n    );\n    withStat.sort((a, b) => {\n      if (b.mtime !== a.mtime) return b.mtime - a.mtime;\n      return a.name.localeCompare(b.name);\n    });\n    return withStat.map((x) => x.name);\n  } catch {\n    return [];\n  }\n}\n\n/** Maps a `.jsonl` file name to its run id (basename only; no traversal). */\nexport function getRunIdFromTraceFileName(fileName: string): string | undefined {\n  try {\n    const base = path.basename(fileName);\n    if (!base.endsWith(\".jsonl\")) return undefined;\n    const id = base.slice(0, -\".jsonl\".length);\n    return id === \"\" ? undefined : id;\n  } catch {\n    return undefined;\n  }\n}\n","import chalk from \"chalk\";\n\nimport { isSilentContext } from \"./context.js\";\nimport type { ErrorInfo, RunStatus, StepStatus } from \"./types.js\";\nimport { formatDuration, truncateName } from \"./utils.js\";\n\n/** Two spaces per nesting level in terminal output. */\nexport const TERMINAL_INDENT = \"  \";\n\n/** Max display length for names in terminal output. */\nexport const MAX_TERMINAL_NAME_LENGTH = 80;\n\n/** Max nesting depth used for indentation (prevents huge indents). */\nexport const MAX_TERMINAL_DEPTH = 10;\n\nfunction normalizeDepth(depth: number): number {\n  if (!Number.isFinite(depth) || depth < 0) {\n    return 0;\n  }\n  return Math.min(Math.floor(depth), MAX_TERMINAL_DEPTH);\n}\n\nfunction safePrint(line = \"\"): void {\n  try {\n    console.log(line);\n  } catch {\n    /* never break callers */\n  }\n}\n\n/** Indentation string for a nesting depth (capped, never negative). */\nexport function getIndent(depth: number): string {\n  return TERMINAL_INDENT.repeat(normalizeDepth(depth));\n}\n\n/** Truncates a display name for terminal use; invalid input becomes `\"unnamed\"`. */\nexport function formatTerminalName(name: string): string {\n  if (typeof name !== \"string\" || name.trim() === \"\") {\n    return \"unnamed\";\n  }\n  return truncateName(name, MAX_TERMINAL_NAME_LENGTH);\n}\n\nfunction getStatusIcon(status: StepStatus | RunStatus): string {\n  if (status === \"success\") return chalk.green(\"✔\");\n  if (status === \"error\") return chalk.red(\"✖\");\n  return chalk.yellow(\"⏳\");\n}\n\n/** Renders a single step line (colored); does not consult silent mode. */\nexport function renderStepLine(\n  name: string,\n  durationMs: number | undefined,\n  status: StepStatus,\n  depth?: number,\n): string {\n  try {\n    const nm = formatTerminalName(name);\n    const ind = getIndent(depth ?? 0);\n    if (status === \"running\" && durationMs === undefined) {\n      return `${ind}${chalk.yellow(\"⏳\")} ${nm}`;\n    }\n    const hasDur =\n      durationMs !== undefined && Number.isFinite(durationMs as number);\n    const dur = hasDur ? formatDuration(durationMs as number) : undefined;\n    if (status === \"running\") {\n      return dur !== undefined\n        ? `${ind}${chalk.yellow(\"⏳\")} ${nm} (${dur})`\n        : `${ind}${chalk.yellow(\"⏳\")} ${nm}`;\n    }\n    if (!hasDur || dur === undefined) {\n      return `${ind}${chalk.yellow(\"⏳\")} ${nm}`;\n    }\n    if (status === \"success\") {\n      return `${ind}${getStatusIcon(\"success\")} ${nm} (${dur})`;\n    }\n    return `${ind}${getStatusIcon(\"error\")} ${nm} (${dur})`;\n  } catch {\n    return \"\";\n  }\n}\n\n/** Renders an error summary line (no stack in MVP). */\nexport function renderErrorLine(error: ErrorInfo, depth?: number): string {\n  try {\n    const msg =\n      typeof error.message === \"string\" ? error.message : \"\";\n    const ind = getIndent((depth ?? 0) + 1);\n    return `${ind}Error: ${msg}`;\n  } catch {\n    return \"\";\n  }\n}\n\n/** Plain-text run summary lines (no chalk) for stable testing and CLI reuse. */\nexport function renderRunSummary(\n  durationMs: number,\n  status: RunStatus,\n  traceFilePath?: string,\n): string[] {\n  try {\n    const dur = Number.isFinite(durationMs)\n      ? formatDuration(durationMs)\n      : formatDuration(0);\n    const head =\n      status === \"error\" ? `Failed in ${dur}` : `Completed in ${dur}`;\n    const lines = [head];\n    if (traceFilePath !== undefined && traceFilePath.trim() !== \"\") {\n      lines.push(`Trace: ${traceFilePath}`);\n    }\n    return lines;\n  } catch {\n    return [];\n  }\n}\n\n/** Prints run header with icon and dim run id. */\nexport function printRunStart(runId: string, name: string): void {\n  if (isSilentContext()) return;\n  try {\n    safePrint(\"\");\n    const header = `${chalk.cyan.bold(\"🔍 AgentInspect:\")} ${formatTerminalName(name)} ${chalk.dim(`(${runId})`)}`;\n    safePrint(header);\n  } catch {\n    /* noop */\n  }\n}\n\n/** Prints a running step line. */\nexport function printStepStart(name: string, depth = 0): void {\n  if (isSilentContext()) return;\n  try {\n    safePrint(renderStepLine(name, undefined, \"running\", depth));\n  } catch {\n    /* noop */\n  }\n}\n\n/** Prints a completed step line with duration and status icon. */\nexport function printStepComplete(\n  name: string,\n  durationMs: number,\n  status: StepStatus,\n  depth = 0,\n): void {\n  if (isSilentContext()) return;\n  try {\n    safePrint(renderStepLine(name, durationMs, status, depth));\n  } catch {\n    /* noop */\n  }\n}\n\n/** Prints a structured error line (message only, no stack). */\nexport function printError(error: ErrorInfo, depth = 0): void {\n  if (isSilentContext()) return;\n  try {\n    safePrint(renderErrorLine(error, depth));\n  } catch {\n    /* noop */\n  }\n}\n\n/** Prints run completion summary and optional trace path. */\nexport function printRunComplete(\n  _name: string,\n  _runId: string,\n  durationMs: number,\n  status: RunStatus,\n  traceFilePath?: string,\n): void {\n  if (isSilentContext()) return;\n  try {\n    const lines = renderRunSummary(durationMs, status, traceFilePath);\n    for (let i = 0; i < lines.length; i++) {\n      const line = lines[i]!;\n      if (i === 0) {\n        const color =\n          status === \"error\"\n            ? chalk.red\n            : status === \"running\"\n              ? chalk.yellow\n              : chalk.green;\n        safePrint(color(line));\n      } else {\n        safePrint(chalk.dim(line));\n      }\n    }\n  } catch {\n    /* noop */\n  }\n}\n\n/** Prints which step failed. */\nexport function printFailedAt(stepName: string): void {\n  if (isSilentContext()) return;\n  try {\n    safePrint(`Failed at: ${formatTerminalName(stepName)}`);\n  } catch {\n    /* noop */\n  }\n}\n","import { runWithContext } from \"./context.js\";\nimport type { ExecutionContext, InspectRunOptions, TraceEvent } from \"./types.js\";\nimport { initializeTraceFile, writeTraceEvent } from \"./storage.js\";\nimport { printRunComplete, printRunStart } from \"./terminal.js\";\nimport {\n  createRunId,\n  formatError,\n  getDefaultTraceDir,\n  getTraceFilePath,\n  truncateName,\n  warn,\n} from \"./utils.js\";\n\nfunction normalizeRunName(name: unknown): string {\n  if (typeof name !== \"string\" || name.trim() === \"\") {\n    return \"unnamed-run\";\n  }\n  return truncateName(name.trim(), 100);\n}\n\nasync function safeInstrumentation(\n  label: string,\n  op: () => void | Promise<void>,\n): Promise<void> {\n  try {\n    await Promise.resolve(op());\n  } catch (e) {\n    warn(`inspectRun: ${label}`, e);\n  }\n}\n\n/**\n * Runs `fn` inside an AgentInspect trace: JSONL `run_started` / `run_completed`, optional terminal output,\n * and {@link ExecutionContext} for nested APIs. Instrumentation failures are swallowed; user errors are re-thrown.\n */\nexport async function inspectRun<T>(\n  name: string,\n  fn: () => Promise<T> | T,\n  options?: InspectRunOptions,\n): Promise<T> {\n  if (typeof fn !== \"function\") {\n    throw new TypeError(\"inspectRun requires `fn` to be a function\");\n  }\n\n  const runName = normalizeRunName(name);\n  const runId = createRunId();\n  const traceDir =\n    typeof options?.traceDir === \"string\" && options.traceDir.trim() !== \"\"\n      ? options.traceDir.trim()\n      : getDefaultTraceDir();\n\n  const context: ExecutionContext = {\n    runId,\n    runName,\n    traceDir,\n    silent: options?.silent ?? false,\n    metadata: options?.metadata,\n  };\n\n  return runWithContext(context, async () => {\n    const startTime = Date.now();\n    let traceFilePath: string | undefined;\n\n    await safeInstrumentation(\"initializeTraceFile\", async () => {\n      traceFilePath = await initializeTraceFile(runId, traceDir);\n    });\n\n    await safeInstrumentation(\"writeTraceEvent(run_started)\", async () => {\n      const started: TraceEvent = {\n        schemaVersion: \"0.1\",\n        event: \"run_started\",\n        timestamp: startTime,\n        runId,\n        name: runName,\n        startTime,\n        ...(options?.metadata !== undefined\n          ? { metadata: options.metadata }\n          : {}),\n      };\n      await writeTraceEvent(started, traceDir);\n    });\n\n    await safeInstrumentation(\"printRunStart\", () => {\n      printRunStart(runId, runName);\n    });\n\n    let result: T;\n    try {\n      result = await Promise.resolve(fn());\n    } catch (userError) {\n      const endTime = Date.now();\n      const durationMs = endTime - startTime;\n      const formatted = formatError(userError);\n      const printPath = traceFilePath ?? getTraceFilePath(runId, traceDir);\n\n      await safeInstrumentation(\"writeTraceEvent(run_completed error)\", async () => {\n        const completed: TraceEvent = {\n          schemaVersion: \"0.1\",\n          event: \"run_completed\",\n          timestamp: endTime,\n          runId,\n          status: \"error\",\n          endTime,\n          durationMs,\n          error: formatted,\n        };\n        await writeTraceEvent(completed, traceDir);\n      });\n\n      await safeInstrumentation(\"printRunComplete(error)\", () => {\n        printRunComplete(runName, runId, durationMs, \"error\", printPath);\n      });\n\n      throw userError;\n    }\n\n    const endTime = Date.now();\n    const durationMs = endTime - startTime;\n    const printPath = traceFilePath ?? getTraceFilePath(runId, traceDir);\n\n    await safeInstrumentation(\"writeTraceEvent(run_completed success)\", async () => {\n      const completed: TraceEvent = {\n        schemaVersion: \"0.1\",\n        event: \"run_completed\",\n        timestamp: endTime,\n        runId,\n        status: \"success\",\n        endTime,\n        durationMs,\n      };\n      await writeTraceEvent(completed, traceDir);\n    });\n\n    await safeInstrumentation(\"printRunComplete(success)\", () => {\n      printRunComplete(runName, runId, durationMs, \"success\", printPath);\n    });\n\n    return result;\n  });\n}\n","import { getCurrentContext, getCurrentDepth, getParentStepId, runWithStepContext } from \"./context.js\";\nimport type { StepOptions, StepType, TraceEvent } from \"./types.js\";\nimport { writeTraceEvent } from \"./storage.js\";\nimport { printFailedAt, printError, printStepComplete, printStepStart } from \"./terminal.js\";\nimport { createStepId, formatError, truncateName, warn } from \"./utils.js\";\n\nfunction normalizeStepName(name: unknown): string {\n  if (typeof name !== \"string\" || name.trim() === \"\") {\n    return \"unnamed-step\";\n  }\n  return truncateName(name.trim(), 100);\n}\n\nasync function safeInstrumentation(\n  label: string,\n  op: () => void | Promise<void>,\n): Promise<void> {\n  try {\n    await Promise.resolve(op());\n  } catch (e) {\n    warn(`step: ${label}`, e);\n  }\n}\n\nasync function stepImpl<T>(\n  name: string,\n  fn: () => Promise<T> | T,\n  options?: StepOptions,\n): Promise<T> {\n  if (typeof fn !== \"function\") {\n    throw new TypeError(\"step requires `fn` to be a function\");\n  }\n\n  const stepName = normalizeStepName(name);\n  const context = getCurrentContext();\n\n  if (!context) {\n    warn(\"step() called outside inspectRun(); executing without instrumentation\");\n    return Promise.resolve(fn());\n  }\n\n  const stepId = createStepId();\n  const renderDepth = getCurrentDepth();\n  const parentId = getParentStepId();\n  const stepType: StepType = options?.type ?? \"logic\";\n  const metadata = options?.metadata;\n  const startTime = Date.now();\n\n  await safeInstrumentation(\"writeTraceEvent(step_started)\", async () => {\n    const started: TraceEvent = {\n      schemaVersion: \"0.1\",\n      event: \"step_started\",\n      timestamp: startTime,\n      runId: context.runId,\n      stepId,\n      ...(typeof parentId === \"string\" && parentId.trim() !== \"\"\n        ? { parentId }\n        : {}),\n      name: stepName,\n      type: stepType,\n      startTime,\n      ...(metadata !== undefined ? { metadata } : {}),\n    };\n    await writeTraceEvent(started, context.traceDir);\n  });\n\n  await safeInstrumentation(\"printStepStart\", () => {\n    printStepStart(stepName, renderDepth);\n  });\n\n  let result: T;\n  try {\n    result = await runWithStepContext(stepId, async () => {\n      return await Promise.resolve(fn());\n    });\n  } catch (userError) {\n    const endTime = Date.now();\n    const durationMs = endTime - startTime;\n    const formatted = formatError(userError);\n\n    await safeInstrumentation(\"writeTraceEvent(step_completed error)\", async () => {\n      const completed: TraceEvent = {\n        schemaVersion: \"0.1\",\n        event: \"step_completed\",\n        timestamp: endTime,\n        runId: context.runId,\n        stepId,\n        status: \"error\",\n        endTime,\n        durationMs,\n        error: formatted,\n      };\n      await writeTraceEvent(completed, context.traceDir);\n    });\n\n    await safeInstrumentation(\"printStepComplete(error)\", () => {\n      printStepComplete(stepName, durationMs, \"error\", renderDepth);\n    });\n    await safeInstrumentation(\"printError\", () => {\n      printError(formatted, renderDepth);\n    });\n    await safeInstrumentation(\"printFailedAt\", () => {\n      printFailedAt(stepName);\n    });\n\n    throw userError;\n  }\n\n  const endTime = Date.now();\n  const durationMs = endTime - startTime;\n\n  await safeInstrumentation(\"writeTraceEvent(step_completed success)\", async () => {\n    const completed: TraceEvent = {\n      schemaVersion: \"0.1\",\n      event: \"step_completed\",\n      timestamp: endTime,\n      runId: context.runId,\n      stepId,\n      status: \"success\",\n      endTime,\n      durationMs,\n    };\n    await writeTraceEvent(completed, context.traceDir);\n  });\n\n  await safeInstrumentation(\"printStepComplete(success)\", () => {\n    printStepComplete(stepName, durationMs, \"success\", renderDepth);\n  });\n\n  return result;\n}\n\n/** Callable step tracer plus {@link step.llm} and {@link step.tool} shortcuts. */\nexport type StepFunction = {\n  <T>(name: string, fn: () => Promise<T> | T, options?: StepOptions): Promise<T>;\n  llm: <T>(model: string, fn: () => Promise<T> | T) => Promise<T>;\n  tool: <T>(toolName: string, fn: () => Promise<T> | T) => Promise<T>;\n};\n\nasync function stepLlm<T>(model: string, fn: () => Promise<T> | T): Promise<T> {\n  const modelName =\n    typeof model === \"string\" && model.trim() !== \"\"\n      ? model.trim()\n      : \"unknown-model\";\n  return stepImpl<T>(`llm:${modelName}`, fn, {\n    type: \"llm\",\n    metadata: { model: modelName },\n  });\n}\n\nasync function stepTool<T>(\n  toolName: string,\n  fn: () => Promise<T> | T,\n): Promise<T> {\n  const normalized =\n    typeof toolName === \"string\" && toolName.trim() !== \"\"\n      ? toolName.trim()\n      : \"unknown-tool\";\n  return stepImpl<T>(`tool:${normalized}`, fn, {\n    type: \"tool\",\n    metadata: { toolName: normalized },\n  });\n}\n\n/**\n * Traces a named unit of work inside `inspectRun` (`step_started` / `step_completed`, optional terminal).\n * Outside a run, executes `fn` with a warn only. Preserves return values and rethrows user errors unchanged.\n *\n * - `step.llm(model, fn)` — `type: \"llm\"`, `metadata.model` (no SDK calls or token counting).\n * - `step.tool(toolName, fn)` — `type: \"tool\"`, `metadata.toolName` (no framework interception).\n */\nexport const step = Object.assign(stepImpl, {\n  llm: stepLlm,\n  tool: stepTool,\n}) as StepFunction;\n","import { inspectRun } from \"./inspect-run.js\";\nimport type { ObserveOptions } from \"./types.js\";\nimport { truncateName, warn } from \"./utils.js\";\n\nconst INSTRUMENTABLE_METHODS = [\"run\", \"execute\", \"invoke\"] as const;\n\nfunction isInstrumentableProp(\n  prop: string | symbol,\n): prop is (typeof INSTRUMENTABLE_METHODS)[number] {\n  if (typeof prop !== \"string\") return false;\n  return (INSTRUMENTABLE_METHODS as readonly string[]).includes(prop);\n}\n\nfunction getAgentLabel(target: object): string {\n  try {\n    const ctor = Reflect.get(target, \"constructor\") as { name?: string } | undefined;\n    const name = ctor?.name;\n    if (typeof name === \"string\" && name.trim() !== \"\" && name !== \"Object\") {\n      return name.trim();\n    }\n  } catch {\n    /* ignore */\n  }\n  return \"Agent\";\n}\n\nfunction buildRunName(target: object, methodKey: string): string {\n  const label = getAgentLabel(target);\n  return truncateName(`${label}.${methodKey}`, 100);\n}\n\n/**\n * Returns a Proxy that traces top-level `run`, `execute`, and `invoke` via {@link inspectRun}.\n * Other properties pass through; function members are bound to the real target so class private fields work.\n * Invalid agents are returned unchanged (with a warn); this function never throws.\n */\nexport function observe<T>(agent: T, options?: ObserveOptions): T {\n  if (agent === null || agent === undefined) {\n    warn(\"observe() requires an object\");\n    return agent;\n  }\n  const agentType = typeof agent;\n  if (agentType !== \"object\" && agentType !== \"function\") {\n    warn(\"observe() requires an object\");\n    return agent;\n  }\n\n  const target = agent as object;\n\n  const handlers: ProxyHandler<object> = {\n    get(proxyTarget, prop, receiver) {\n      try {\n        const value = Reflect.get(proxyTarget, prop, receiver);\n\n        if (isInstrumentableProp(prop)) {\n          if (typeof value !== \"function\") {\n            return value;\n          }\n          const methodKey = prop;\n          return function observedWrapper(...args: unknown[]) {\n            let runName: string;\n            try {\n              runName = buildRunName(proxyTarget, methodKey);\n            } catch (e) {\n              warn(\"observe() method wrapping failed\", e);\n              return value.apply(proxyTarget, args);\n            }\n            return inspectRun(runName, () => value.apply(proxyTarget, args), options);\n          };\n        }\n\n        if (typeof value === \"function\" && prop !== \"constructor\") {\n          return value.bind(proxyTarget);\n        }\n        return value;\n      } catch (e) {\n        warn(\"observe() method wrapping failed\", e);\n        try {\n          return Reflect.get(proxyTarget, prop, receiver);\n        } catch {\n          return undefined;\n        }\n      }\n    },\n  };\n\n  try {\n    return new Proxy(target, handlers) as T;\n  } catch (e) {\n    warn(\"observe() failed\", e);\n    return agent;\n  }\n}\n"]}

package/packages/core/dist/index.d.cts

@@ -0,0 +1,324 @@
+/**
+ * Discriminator for what kind of work a {@link Step} represents.
+ * `"decision"` captures agent branching/choices; other values cover runs, LLM calls, tools, and user-defined steps.
+ */
+type StepType = "run" | "llm" | "tool" | "decision" | "logic" | "state" | "custom";
+/** Lifecycle state of a single {@link Step}. */
+type StepStatus = "running" | "success" | "error";
+/** Lifecycle state of an entire {@link Run}. */
+type RunStatus = "running" | "success" | "error";
+/** Structured error attached to a run or step when status is `"error"`. */
+interface ErrorInfo {
+    message: string;
+    stack?: string;
+}
+/**
+ * Optional token counts for a step (e.g. LLM usage).
+ * Reserved for future roadmap; MVP does not compute or persist token usage.
+ */
+interface TokenMetadata {
+    input?: number;
+    output?: number;
+}
+/** Arbitrary structured fields for a step; safe extensions use string keys. */
+interface StepMetadata {
+    model?: string;
+    toolName?: string;
+    tokens?: TokenMetadata;
+    retryCount?: number;
+    [key: string]: unknown;
+}
+/**
+ * One traced agent run (root of an execution tree).
+ * MVP intentionally omits `input` / `output` on the run to limit PII, secrets, and serialization risk.
+ */
+interface Run {
+    id: string;
+    name: string;
+    status: RunStatus;
+    startTime: number;
+    endTime?: number;
+    durationMs?: number;
+    error?: ErrorInfo;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * One node in the execution tree under a {@link Run}.
+ * MVP intentionally omits `input` / `output`; capture/redaction may come in a later version.
+ */
+interface Step {
+    id: string;
+    runId: string;
+    parentId?: string;
+    name: string;
+    type: StepType;
+    status: StepStatus;
+    startTime: number;
+    endTime?: number;
+    durationMs?: number;
+    error?: ErrorInfo;
+    metadata?: StepMetadata;
+}
+/** Version of the JSONL trace line schema consumed by AgentInspect tooling. */
+type TraceSchemaVersion = "0.1";
+/** Fields shared by every persisted trace event line. */
+interface TraceEventBase {
+    schemaVersion: TraceSchemaVersion;
+    event: string;
+    timestamp: number;
+}
+/** Emitted when a run begins. */
+interface RunStartedEvent extends TraceEventBase {
+    event: "run_started";
+    runId: string;
+    name: string;
+    startTime: number;
+    metadata?: Record<string, unknown>;
+}
+/** Emitted when a run finishes successfully or with an error. */
+interface RunCompletedEvent extends TraceEventBase {
+    event: "run_completed";
+    runId: string;
+    status: "success" | "error";
+    endTime: number;
+    durationMs: number;
+    error?: ErrorInfo;
+}
+/** Emitted when a step begins (including nested steps under `parentId`). */
+interface StepStartedEvent extends TraceEventBase {
+    event: "step_started";
+    runId: string;
+    stepId: string;
+    parentId?: string;
+    name: string;
+    type: StepType;
+    startTime: number;
+    metadata?: StepMetadata;
+}
+/**
+ * Emitted when a step finishes (success or failure).
+ * Failures use `status: "error"` and optional {@link ErrorInfo}; there is no separate `step_failed` event in MVP.
+ */
+interface StepCompletedEvent extends TraceEventBase {
+    event: "step_completed";
+    runId: string;
+    stepId: string;
+    status: "success" | "error";
+    endTime: number;
+    durationMs: number;
+    error?: ErrorInfo;
+}
+/** Discriminated union of all MVP trace events written as JSONL lines. */
+type TraceEvent = RunStartedEvent | RunCompletedEvent | StepStartedEvent | StepCompletedEvent;
+/** Options for `inspectRun()` (implemented in a later step). */
+interface InspectRunOptions {
+    traceDir?: string;
+    silent?: boolean;
+    metadata?: Record<string, unknown>;
+}
+/** Options passed when opening a logical step (implemented in a later step). */
+interface StepOptions {
+    type?: StepType;
+    metadata?: StepMetadata;
+}
+/** Options for `observe()` — same surface as {@link InspectRunOptions} in MVP. */
+type ObserveOptions = InspectRunOptions;
+/**
+ * Resolved settings for the active run while tracing is enabled.
+ * Populated by runtime code in a later step; defined here for `context.ts`.
+ */
+interface ExecutionContext {
+    runId: string;
+    runName: string;
+    traceDir: string;
+    silent: boolean;
+    metadata?: Record<string, unknown>;
+}
+/** Stack position of the step currently executing (used by future context tracking). */
+interface ActiveStepContext {
+    stepId: string;
+    parentId?: string;
+    depth: number;
+}
+/** Returns true if `value` is one of the MVP {@link StepType} literals. */
+declare function isStepType(value: unknown): value is StepType;
+/** Returns true if `value` is one of the MVP {@link StepStatus} literals. */
+declare function isStepStatus(value: unknown): value is StepStatus;
+/**
+ * Narrowing guard for a {@link TraceEvent} object with required MVP fields.
+ * Does not deeply validate optional `metadata` shapes.
+ */
+declare function isTraceEvent(value: unknown): value is TraceEvent;
+
+/** Default folder under the user home for AgentInspect data. */
+declare const DEFAULT_TRACE_DIR_NAME = ".agent-inspect";
+/** Subfolder where JSONL run traces are stored. */
+declare const RUNS_DIR_NAME = "runs";
+/** Writable trace root when the default home path cannot be used. */
+declare const FALLBACK_TRACE_DIR: string;
+/** Maximum display length for run/step names before truncation. */
+declare const MAX_NAME_LENGTH = 100;
+/** Returns `run_` + a 10-character nanoid segment. */
+declare function createRunId(): string;
+/** Returns `step_` + a 10-character nanoid segment. */
+declare function createStepId(): string;
+/**
+ * Formats a duration for CLI display.
+ * Under 1000 ms uses whole milliseconds; from 1000 ms uses seconds with one decimal.
+ */
+declare function formatDuration(ms: number): string;
+/**
+ * Formats a Unix timestamp (ms) as local `YYYY-MM-DD HH:mm:ss`.
+ * Invalid values yield `"Invalid date"` (no throw).
+ */
+declare function formatTimestamp(timestamp: number): string;
+/**
+ * Default directory for trace files: `~/DEFAULT_TRACE_DIR_NAME/RUNS_DIR_NAME`.
+ * Falls back to {@link FALLBACK_TRACE_DIR} when home cannot be resolved.
+ */
+declare function getDefaultTraceDir(): string;
+/**
+ * Full path to the JSONL trace file for a run.
+ * `runId` is passed through `path.basename` to avoid traversal; empty ids become `run_unknown`.
+ */
+declare function getTraceFilePath(runId: string, traceDir?: string): string;
+/**
+ * Ensures a trace directory exists (recursive). Tries {@link FALLBACK_TRACE_DIR} on failure.
+ * Returns the directory path that callers should prefer: primary, fallback, or original if both mkdir attempts fail.
+ * Emits concise `[AgentInspect]` warnings on failure; never throws.
+ */
+declare function ensureTraceDir(traceDir: string): Promise<string>;
+/**
+ * Normalizes any thrown/caught value into {@link ErrorInfo}.
+ * Never throws (circular structures and non-JSON values fall back to a generic message).
+ */
+declare function formatError(error: unknown): ErrorInfo;
+/**
+ * Truncates a display name to `maxLength`, appending `"..."` when shortened.
+ * Empty or non-string input becomes `"unnamed"`.
+ */
+declare function truncateName(name: string, maxLength?: number): string;
+/**
+ * Instrumentation-only warning to stderr. Not a general-purpose logger.
+ * Optional `error` is summarized via {@link formatError} (message only).
+ */
+declare function warn(message: string, error?: unknown): void;
+
+/** Returns the active run context, without internal step fields. */
+declare function getCurrentContext(): ExecutionContext | undefined;
+/** Active `runId` when inside `runWithContext`, else `undefined`. */
+declare function getCurrentRunId(): string | undefined;
+/** Active `runName` when inside `runWithContext`, else `undefined`. */
+declare function getCurrentRunName(): string | undefined;
+/**
+ * Active step id in this async scope (parent for nested `step()` calls).
+ * `undefined` at run root or outside any run.
+ */
+declare function getCurrentStepId(): string | undefined;
+/** Alias of {@link getCurrentStepId} for readability in step instrumentation. */
+declare function getParentStepId(): string | undefined;
+/**
+ * Nesting depth: `0` at run root, increments by one per nested `runWithStepContext`.
+ * Returns `0` outside any run.
+ */
+declare function getCurrentDepth(): number;
+declare function hasActiveContext(): boolean;
+declare function getTraceDirFromContext(): string | undefined;
+declare function isSilentContext(): boolean;
+/**
+ * Runs `fn` with a fresh AgentInspect run context (depth 0, no active step).
+ * Propagates sync/async results and rejections; does not swallow user errors.
+ */
+declare function runWithContext<T>(context: ExecutionContext, fn: () => Promise<T> | T): Promise<T>;
+/**
+ * Runs `fn` with `stepId` as the active step (incremented depth).
+ * If no run is active, runs `fn` without altering async context.
+ */
+declare function runWithStepContext<T>(stepId: string, fn: () => Promise<T> | T): Promise<T>;
+
+/**
+ * Strict MVP validation before writing JSONL. Rejects empty ids, non-finite times, and malformed payloads.
+ */
+declare function validateEvent(event: unknown): event is TraceEvent;
+/** Serializes a trace line as compact JSON without a trailing newline. */
+declare function serializeEvent(event: TraceEvent): string;
+/**
+ * Creates (or truncates) an empty JSONL file for a run. Uses {@link ensureTraceDir} then {@link getTraceFilePath}.
+ * On failure, retries once under {@link FALLBACK_TRACE_DIR}.
+ */
+declare function initializeTraceFile(runId: string, traceDir: string): Promise<string | undefined>;
+/**
+ * Appends one validated JSONL line for `event.runId`. Falls back to {@link FALLBACK_TRACE_DIR} on append failure.
+ */
+declare function writeTraceEvent(event: TraceEvent, traceDir: string): Promise<void>;
+/**
+ * Reads raw JSONL file contents for a run, or `undefined` if missing or unreadable.
+ */
+declare function readTraceFile(runId: string, traceDir: string): Promise<string | undefined>;
+/** Parses JSONL into validated {@link TraceEvent} rows; invalid lines are skipped with a warning. */
+declare function readTraceEvents(runId: string, traceDir: string): Promise<TraceEvent[]>;
+/**
+ * Lists `.jsonl` file names in `traceDir`, newest by mtime first (name sort as tie-breaker).
+ */
+declare function listTraceFiles(traceDir: string): Promise<string[]>;
+/** Maps a `.jsonl` file name to its run id (basename only; no traversal). */
+declare function getRunIdFromTraceFileName(fileName: string): string | undefined;
+
+/** Two spaces per nesting level in terminal output. */
+declare const TERMINAL_INDENT = "  ";
+/** Max display length for names in terminal output. */
+declare const MAX_TERMINAL_NAME_LENGTH = 80;
+/** Max nesting depth used for indentation (prevents huge indents). */
+declare const MAX_TERMINAL_DEPTH = 10;
+/** Indentation string for a nesting depth (capped, never negative). */
+declare function getIndent(depth: number): string;
+/** Truncates a display name for terminal use; invalid input becomes `"unnamed"`. */
+declare function formatTerminalName(name: string): string;
+/** Renders a single step line (colored); does not consult silent mode. */
+declare function renderStepLine(name: string, durationMs: number | undefined, status: StepStatus, depth?: number): string;
+/** Renders an error summary line (no stack in MVP). */
+declare function renderErrorLine(error: ErrorInfo, depth?: number): string;
+/** Plain-text run summary lines (no chalk) for stable testing and CLI reuse. */
+declare function renderRunSummary(durationMs: number, status: RunStatus, traceFilePath?: string): string[];
+/** Prints run header with icon and dim run id. */
+declare function printRunStart(runId: string, name: string): void;
+/** Prints a running step line. */
+declare function printStepStart(name: string, depth?: number): void;
+/** Prints a completed step line with duration and status icon. */
+declare function printStepComplete(name: string, durationMs: number, status: StepStatus, depth?: number): void;
+/** Prints a structured error line (message only, no stack). */
+declare function printError(error: ErrorInfo, depth?: number): void;
+/** Prints run completion summary and optional trace path. */
+declare function printRunComplete(_name: string, _runId: string, durationMs: number, status: RunStatus, traceFilePath?: string): void;
+/** Prints which step failed. */
+declare function printFailedAt(stepName: string): void;
+
+/**
+ * Runs `fn` inside an AgentInspect trace: JSONL `run_started` / `run_completed`, optional terminal output,
+ * and {@link ExecutionContext} for nested APIs. Instrumentation failures are swallowed; user errors are re-thrown.
+ */
+declare function inspectRun<T>(name: string, fn: () => Promise<T> | T, options?: InspectRunOptions): Promise<T>;
+
+/** Callable step tracer plus {@link step.llm} and {@link step.tool} shortcuts. */
+type StepFunction = {
+    <T>(name: string, fn: () => Promise<T> | T, options?: StepOptions): Promise<T>;
+    llm: <T>(model: string, fn: () => Promise<T> | T) => Promise<T>;
+    tool: <T>(toolName: string, fn: () => Promise<T> | T) => Promise<T>;
+};
+/**
+ * Traces a named unit of work inside `inspectRun` (`step_started` / `step_completed`, optional terminal).
+ * Outside a run, executes `fn` with a warn only. Preserves return values and rethrows user errors unchanged.
+ *
+ * - `step.llm(model, fn)` — `type: "llm"`, `metadata.model` (no SDK calls or token counting).
+ * - `step.tool(toolName, fn)` — `type: "tool"`, `metadata.toolName` (no framework interception).
+ */
+declare const step: StepFunction;
+
+/**
+ * Returns a Proxy that traces top-level `run`, `execute`, and `invoke` via {@link inspectRun}.
+ * Other properties pass through; function members are bound to the real target so class private fields work.
+ * Invalid agents are returned unchanged (with a warn); this function never throws.
+ */
+declare function observe<T>(agent: T, options?: ObserveOptions): T;
+
+export { type ActiveStepContext, DEFAULT_TRACE_DIR_NAME, type ErrorInfo, type ExecutionContext, FALLBACK_TRACE_DIR, type InspectRunOptions, MAX_NAME_LENGTH, MAX_TERMINAL_DEPTH, MAX_TERMINAL_NAME_LENGTH, type ObserveOptions, RUNS_DIR_NAME, type Run, type RunCompletedEvent, type RunStartedEvent, type RunStatus, type Step, type StepCompletedEvent, type StepMetadata, type StepOptions, type StepStartedEvent, type StepStatus, type StepType, TERMINAL_INDENT, type TokenMetadata, type TraceEvent, type TraceEventBase, type TraceSchemaVersion, createRunId, createStepId, ensureTraceDir, formatDuration, formatError, formatTerminalName, formatTimestamp, getCurrentContext, getCurrentDepth, getCurrentRunId, getCurrentRunName, getCurrentStepId, getDefaultTraceDir, getIndent, getParentStepId, getRunIdFromTraceFileName, getTraceDirFromContext, getTraceFilePath, hasActiveContext, initializeTraceFile, inspectRun, isSilentContext, isStepStatus, isStepType, isTraceEvent, listTraceFiles, observe, printError, printFailedAt, printRunComplete, printRunStart, printStepComplete, printStepStart, readTraceEvents, readTraceFile, renderErrorLine, renderRunSummary, renderStepLine, runWithContext, runWithStepContext, serializeEvent, step, truncateName, validateEvent, warn, writeTraceEvent };