@probelabs/visor 0.1.96 → 0.1.97

package/dist/sdk/chunk-IG3BFIIN.mjs

@@ -0,0 +1,174 @@
+import {
+  __esm,
+  __export,
+  __toCommonJS
+} from "./chunk-WMJKH4XE.mjs";
+
+// src/telemetry/fallback-ndjson.ts
+var fallback_ndjson_exports = {};
+__export(fallback_ndjson_exports, {
+  emitNdjsonFallback: () => emitNdjsonFallback,
+  emitNdjsonSpanWithEvents: () => emitNdjsonSpanWithEvents,
+  flushNdjson: () => flushNdjson
+});
+import * as fs from "fs";
+import * as path from "path";
+function resolveTargetPath(outDir) {
+  if (process.env.VISOR_FALLBACK_TRACE_FILE) {
+    CURRENT_FILE = process.env.VISOR_FALLBACK_TRACE_FILE;
+    return CURRENT_FILE;
+  }
+  if (CURRENT_FILE) return CURRENT_FILE;
+  const ts = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
+  CURRENT_FILE = path.join(outDir, `${ts}.ndjson`);
+  return CURRENT_FILE;
+}
+function isEnabled() {
+  if (process.env.VISOR_FALLBACK_TRACE_FILE) return true;
+  return process.env.VISOR_TELEMETRY_ENABLED === "true" && (process.env.VISOR_TELEMETRY_SINK || "file") === "file";
+}
+function appendAsync(outDir, line) {
+  writeChain = writeChain.then(async () => {
+    if (!dirReady) {
+      try {
+        await fs.promises.mkdir(outDir, { recursive: true });
+      } catch {
+      }
+      dirReady = true;
+    }
+    const target = resolveTargetPath(outDir);
+    await fs.promises.appendFile(target, line, "utf8");
+  }).catch(() => {
+  });
+}
+async function flushNdjson() {
+  try {
+    await writeChain;
+  } catch {
+  }
+}
+function emitNdjsonFallback(name, attrs) {
+  try {
+    if (!isEnabled()) return;
+    const outDir = process.env.VISOR_TRACE_DIR || path.join(process.cwd(), "output", "traces");
+    const line = JSON.stringify({ name, attributes: attrs }) + "\n";
+    appendAsync(outDir, line);
+  } catch {
+  }
+}
+function emitNdjsonSpanWithEvents(name, attrs, events) {
+  try {
+    if (!isEnabled()) return;
+    const outDir = process.env.VISOR_TRACE_DIR || path.join(process.cwd(), "output", "traces");
+    const line = JSON.stringify({ name, attributes: attrs, events }) + "\n";
+    appendAsync(outDir, line);
+  } catch {
+  }
+}
+var CURRENT_FILE, dirReady, writeChain;
+var init_fallback_ndjson = __esm({
+  "src/telemetry/fallback-ndjson.ts"() {
+    "use strict";
+    CURRENT_FILE = null;
+    dirReady = false;
+    writeChain = Promise.resolve();
+  }
+});
+
+// src/telemetry/trace-helpers.ts
+import { context as otContext, SpanStatusCode, trace } from "@opentelemetry/api";
+function addEvent(name, attrs) {
+  const span = trace.getSpan(otContext.active());
+  if (span) {
+    try {
+      span.addEvent(name, attrs);
+    } catch {
+    }
+  }
+  try {
+    const { emitNdjsonSpanWithEvents: emitNdjsonSpanWithEvents2 } = (init_fallback_ndjson(), __toCommonJS(fallback_ndjson_exports));
+    emitNdjsonSpanWithEvents2("visor.event", {}, [{ name, attrs }]);
+    if (name === "fail_if.triggered") {
+      emitNdjsonSpanWithEvents2("visor.event", {}, [
+        { name: "fail_if.evaluated", attrs },
+        { name: "fail_if.triggered", attrs }
+      ]);
+    }
+  } catch {
+  }
+}
+
+// src/telemetry/metrics.ts
+import { metrics } from "@opentelemetry/api";
+var initialized = false;
+var meter = metrics.getMeter("visor");
+var TEST_ENABLED = process.env.VISOR_TEST_METRICS === "true";
+var TEST_SNAPSHOT = { fail_if_triggered: 0 };
+var checkDurationHist;
+var providerDurationHist;
+var foreachDurationHist;
+var issuesCounter;
+var activeChecks;
+var failIfCounter;
+var diagramBlocks;
+function ensureInstruments() {
+  if (initialized) return;
+  try {
+    checkDurationHist = meter.createHistogram("visor.check.duration_ms", {
+      description: "Duration of a check execution in milliseconds",
+      unit: "ms"
+    });
+    providerDurationHist = meter.createHistogram("visor.provider.duration_ms", {
+      description: "Duration of provider execution in milliseconds",
+      unit: "ms"
+    });
+    foreachDurationHist = meter.createHistogram("visor.foreach.item.duration_ms", {
+      description: "Duration of a forEach item execution in milliseconds",
+      unit: "ms"
+    });
+    issuesCounter = meter.createCounter("visor.check.issues", {
+      description: "Number of issues produced by checks",
+      unit: "1"
+    });
+    activeChecks = meter.createUpDownCounter("visor.run.active_checks", {
+      description: "Number of checks actively running",
+      unit: "1"
+    });
+    failIfCounter = meter.createCounter("visor.fail_if.triggered", {
+      description: "Number of times fail_if condition triggered",
+      unit: "1"
+    });
+    diagramBlocks = meter.createCounter("visor.diagram.blocks", {
+      description: "Number of Mermaid diagram blocks emitted",
+      unit: "1"
+    });
+    initialized = true;
+  } catch {
+  }
+}
+function addFailIfTriggered(check, scope) {
+  ensureInstruments();
+  try {
+    failIfCounter?.add(1, { "visor.check.id": check, scope });
+  } catch {
+  }
+  if (TEST_ENABLED) TEST_SNAPSHOT.fail_if_triggered++;
+}
+function addDiagramBlock(origin) {
+  ensureInstruments();
+  try {
+    diagramBlocks?.add(1, { origin });
+  } catch {
+  }
+}
+
+export {
+  emitNdjsonFallback,
+  emitNdjsonSpanWithEvents,
+  fallback_ndjson_exports,
+  init_fallback_ndjson,
+  addEvent,
+  addFailIfTriggered,
+  addDiagramBlock
+};
+//# sourceMappingURL=chunk-IG3BFIIN.mjs.map

package/dist/sdk/chunk-IG3BFIIN.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/telemetry/fallback-ndjson.ts","../../src/telemetry/trace-helpers.ts","../../src/telemetry/metrics.ts"],"sourcesContent":["import * as fs from 'fs';\nimport * as path from 'path';\n\nlet CURRENT_FILE: string | null = null;\nlet dirReady = false;\nlet writeChain: Promise<void> = Promise.resolve();\nfunction resolveTargetPath(outDir: string): string {\n  if (process.env.VISOR_FALLBACK_TRACE_FILE) {\n    CURRENT_FILE = process.env.VISOR_FALLBACK_TRACE_FILE;\n    return CURRENT_FILE;\n  }\n  if (CURRENT_FILE) return CURRENT_FILE;\n  const ts = new Date().toISOString().replace(/[:.]/g, '-');\n  CURRENT_FILE = path.join(outDir, `${ts}.ndjson`);\n  return CURRENT_FILE;\n}\n\nfunction isEnabled(): boolean {\n  // Enable when CLI set a fallback file (serverless mode), or when explicit file sink is enabled\n  if (process.env.VISOR_FALLBACK_TRACE_FILE) return true;\n  return (\n    process.env.VISOR_TELEMETRY_ENABLED === 'true' &&\n    (process.env.VISOR_TELEMETRY_SINK || 'file') === 'file'\n  );\n}\n\nfunction appendAsync(outDir: string, line: string): void {\n  writeChain = writeChain\n    .then(async () => {\n      if (!dirReady) {\n        try {\n          await fs.promises.mkdir(outDir, { recursive: true });\n        } catch {}\n        dirReady = true;\n      }\n      const target = resolveTargetPath(outDir);\n      await fs.promises.appendFile(target, line, 'utf8');\n    })\n    .catch(() => {});\n}\n\nexport async function flushNdjson(): Promise<void> {\n  try {\n    await writeChain;\n  } catch {}\n}\n\nexport function emitNdjsonFallback(name: string, attrs: Record<string, unknown>): void {\n  try {\n    if (!isEnabled()) return;\n    const outDir = process.env.VISOR_TRACE_DIR || path.join(process.cwd(), 'output', 'traces');\n    const line = JSON.stringify({ name, attributes: attrs }) + '\\n';\n    appendAsync(outDir, line);\n  } catch {\n    // ignore\n  }\n}\n\nexport function emitNdjsonSpanWithEvents(\n  name: string,\n  attrs: Record<string, unknown>,\n  events: Array<{ name: string; attrs?: Record<string, unknown> }>\n): void {\n  try {\n    if (!isEnabled()) return;\n    const outDir = process.env.VISOR_TRACE_DIR || path.join(process.cwd(), 'output', 'traces');\n    const line = JSON.stringify({ name, attributes: attrs, events }) + '\\n';\n    appendAsync(outDir, line);\n  } catch {\n    // ignore\n  }\n}\n","import { context as otContext, Span, SpanStatusCode, trace, Attributes } from '@opentelemetry/api';\n\nexport function getTracer() {\n  return trace.getTracer('visor');\n}\n\nexport async function withActiveSpan<T>(\n  name: string,\n  attrs: Record<string, unknown> | undefined,\n  fn: (span: Span) => Promise<T>\n): Promise<T> {\n  const tracer = getTracer();\n  return await new Promise<T>((resolve, reject) => {\n    const callback = async (span: Span) => {\n      try {\n        const res = await fn(span);\n        resolve(res);\n      } catch (err) {\n        try {\n          if (err instanceof Error) span.recordException(err);\n          span.setStatus({ code: SpanStatusCode.ERROR });\n        } catch {}\n        reject(err);\n      } finally {\n        try {\n          span.end();\n        } catch {}\n      }\n    };\n    if (attrs) {\n      tracer.startActiveSpan(name, { attributes: attrs as Attributes }, callback);\n    } else {\n      tracer.startActiveSpan(name, callback as (span: Span) => void);\n    }\n  });\n}\n\nexport function addEvent(name: string, attrs?: Record<string, unknown>): void {\n  const span = trace.getSpan(otContext.active());\n  if (span) {\n    try {\n      span.addEvent(name, attrs as Attributes);\n    } catch {\n      // ignore\n    }\n  }\n  // Fallback NDJSON emission for serverless/file sink when SDK may be inactive\n  try {\n    const { emitNdjsonSpanWithEvents } = require('./fallback-ndjson');\n    emitNdjsonSpanWithEvents('visor.event', {}, [{ name, attrs }]);\n    if (name === 'fail_if.triggered') {\n      emitNdjsonSpanWithEvents('visor.event', {}, [\n        { name: 'fail_if.evaluated', attrs },\n        { name: 'fail_if.triggered', attrs },\n      ]);\n    }\n  } catch {}\n}\n\nexport function setSpanAttributes(attrs: Record<string, unknown>): void {\n  const span = trace.getSpan(otContext.active());\n  if (!span) return;\n  try {\n    for (const [k, v] of Object.entries(attrs)) span.setAttribute(k, v as never);\n  } catch {\n    // ignore\n  }\n}\n\nexport function setSpanError(err: unknown): void {\n  const span = trace.getSpan(otContext.active());\n  if (!span) return;\n  try {\n    if (err instanceof Error) span.recordException(err);\n    span.setStatus({ code: SpanStatusCode.ERROR });\n  } catch {\n    // ignore\n  }\n}\n\n// Internal helper for tests: write a minimal run marker to NDJSON when using file sink\nlet __ndjsonPath: string | null = null;\nexport function __getOrCreateNdjsonPath(): string | null {\n  try {\n    if (process.env.VISOR_TELEMETRY_SINK !== 'file') return null;\n    const path = require('path');\n    const fs = require('fs');\n    // Prefer explicit fallback file path if set by the CLI\n    if (process.env.VISOR_FALLBACK_TRACE_FILE) {\n      __ndjsonPath = process.env.VISOR_FALLBACK_TRACE_FILE;\n      const dir = path.dirname(__ndjsonPath);\n      if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });\n      return __ndjsonPath;\n    }\n    const outDir = process.env.VISOR_TRACE_DIR || path.join(process.cwd(), 'output', 'traces');\n    if (!fs.existsSync(outDir)) fs.mkdirSync(outDir, { recursive: true });\n    if (!__ndjsonPath) {\n      const ts = new Date().toISOString().replace(/[:.]/g, '-');\n      __ndjsonPath = path.join(outDir, `${ts}.ndjson`);\n    }\n    return __ndjsonPath;\n  } catch {\n    return null;\n  }\n}\nexport function _appendRunMarker(): void {\n  try {\n    const fs = require('fs');\n    const p = __getOrCreateNdjsonPath();\n    if (!p) return;\n    const line = { name: 'visor.run', attributes: { started: true } };\n    fs.appendFileSync(p, JSON.stringify(line) + '\\n', 'utf8');\n  } catch {}\n}\n","import { metrics } from '@opentelemetry/api';\n\nlet initialized = false;\nconst meter = metrics.getMeter('visor');\n\n// Test helpers (enabled with VISOR_TEST_METRICS=true)\nconst TEST_ENABLED = process.env.VISOR_TEST_METRICS === 'true';\nconst TEST_SNAPSHOT: { [k: string]: number } = { fail_if_triggered: 0 };\n\n// Instruments (lazily created when first used)\nlet checkDurationHist: ReturnType<typeof meter.createHistogram> | undefined;\nlet providerDurationHist: ReturnType<typeof meter.createHistogram> | undefined;\nlet foreachDurationHist: ReturnType<typeof meter.createHistogram> | undefined;\nlet issuesCounter: ReturnType<typeof meter.createCounter> | undefined;\nlet activeChecks: ReturnType<typeof meter.createUpDownCounter> | undefined;\nlet failIfCounter: ReturnType<typeof meter.createCounter> | undefined;\nlet diagramBlocks: ReturnType<typeof meter.createCounter> | undefined;\n\nfunction ensureInstruments() {\n  if (initialized) return;\n  try {\n    checkDurationHist = meter.createHistogram('visor.check.duration_ms', {\n      description: 'Duration of a check execution in milliseconds',\n      unit: 'ms',\n    });\n    providerDurationHist = meter.createHistogram('visor.provider.duration_ms', {\n      description: 'Duration of provider execution in milliseconds',\n      unit: 'ms',\n    });\n    foreachDurationHist = meter.createHistogram('visor.foreach.item.duration_ms', {\n      description: 'Duration of a forEach item execution in milliseconds',\n      unit: 'ms',\n    });\n    issuesCounter = meter.createCounter('visor.check.issues', {\n      description: 'Number of issues produced by checks',\n      unit: '1',\n    });\n    activeChecks = meter.createUpDownCounter('visor.run.active_checks', {\n      description: 'Number of checks actively running',\n      unit: '1',\n    });\n    failIfCounter = meter.createCounter('visor.fail_if.triggered', {\n      description: 'Number of times fail_if condition triggered',\n      unit: '1',\n    });\n    diagramBlocks = meter.createCounter('visor.diagram.blocks', {\n      description: 'Number of Mermaid diagram blocks emitted',\n      unit: '1',\n    });\n    initialized = true;\n  } catch {\n    // Metrics may be unavailable if SDK not initialized; ignore gracefully\n  }\n}\n\nexport function recordCheckDuration(check: string, durationMs: number, group?: string) {\n  ensureInstruments();\n  try {\n    checkDurationHist?.record(durationMs, {\n      'visor.check.id': check,\n      'visor.check.group': group || 'default',\n    });\n  } catch {}\n}\n\nexport function recordProviderDuration(check: string, providerType: string, durationMs: number) {\n  ensureInstruments();\n  try {\n    providerDurationHist?.record(durationMs, {\n      'visor.check.id': check,\n      'visor.provider.type': providerType,\n    });\n  } catch {}\n}\n\nexport function recordForEachDuration(\n  check: string,\n  index: number,\n  total: number,\n  durationMs: number\n) {\n  ensureInstruments();\n  try {\n    foreachDurationHist?.record(durationMs, {\n      'visor.check.id': check,\n      'visor.foreach.index': index,\n      'visor.foreach.total': total,\n    });\n  } catch {}\n}\n\nexport function addIssues(check: string, severity: string, count = 1) {\n  ensureInstruments();\n  try {\n    issuesCounter?.add(count, {\n      'visor.check.id': check,\n      severity,\n    });\n  } catch {}\n}\n\nexport function incActiveCheck(check: string) {\n  ensureInstruments();\n  try {\n    activeChecks?.add(1, { 'visor.check.id': check });\n  } catch {}\n}\n\nexport function decActiveCheck(check: string) {\n  ensureInstruments();\n  try {\n    activeChecks?.add(-1, { 'visor.check.id': check });\n  } catch {}\n}\n\nexport function addFailIfTriggered(check: string, scope: 'global' | 'check') {\n  ensureInstruments();\n  try {\n    failIfCounter?.add(1, { 'visor.check.id': check, scope });\n  } catch {}\n  if (TEST_ENABLED) TEST_SNAPSHOT.fail_if_triggered++;\n}\n\nexport function addDiagramBlock(origin: 'content' | 'issue') {\n  ensureInstruments();\n  try {\n    diagramBlocks?.add(1, { origin });\n  } catch {}\n}\n\nexport function getTestMetricsSnapshot() {\n  return { ...TEST_SNAPSHOT };\n}\n\nexport function resetTestMetricsSnapshot() {\n  Object.keys(TEST_SNAPSHOT).forEach(k => (TEST_SNAPSHOT[k] = 0));\n}\n"],"mappings":"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","names":["emitNdjsonSpanWithEvents"]}

package/dist/sdk/chunk-YXOWIDEF.mjs

@@ -0,0 +1,60 @@
+import {
+  __esm
+} from "./chunk-WMJKH4XE.mjs";
+
+// src/utils/tracer-init.ts
+import * as path from "path";
+import * as fs from "fs";
+import { SimpleTelemetry, SimpleAppTracer } from "@probelabs/probe";
+async function initializeTracer(sessionId, checkName) {
+  try {
+    if (SimpleTelemetry && SimpleAppTracer) {
+      const sanitizedCheckName = checkName ? path.basename(checkName) : "check";
+      const timestamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
+      const traceDir = process.env.GITHUB_WORKSPACE ? path.join(process.env.GITHUB_WORKSPACE, "debug-artifacts") : path.join(process.cwd(), "debug-artifacts");
+      if (!fs.existsSync(traceDir)) {
+        fs.mkdirSync(traceDir, { recursive: true });
+      }
+      const traceFilePath = path.join(traceDir, `trace-${sanitizedCheckName}-${timestamp}.jsonl`);
+      const resolvedTracePath = path.resolve(traceFilePath);
+      const resolvedTraceDir = path.resolve(traceDir);
+      if (!resolvedTracePath.startsWith(resolvedTraceDir)) {
+        console.error(
+          `\u26A0\uFE0F Security: Attempted path traversal detected. Check name: ${checkName}, resolved path: ${resolvedTracePath}`
+        );
+        return null;
+      }
+      const telemetry = new SimpleTelemetry({
+        enableFile: true,
+        filePath: traceFilePath,
+        enableConsole: false
+      });
+      const tracer = new SimpleAppTracer(telemetry, sessionId);
+      console.error(`\u{1F4CA} Simple tracing enabled, will save to: ${traceFilePath}`);
+      if (process.env.GITHUB_ACTIONS) {
+        console.log(`::notice title=AI Trace::Trace will be saved to ${traceFilePath}`);
+        console.log(`::set-output name=trace-path::${traceFilePath}`);
+      }
+      return {
+        tracer,
+        telemetryConfig: telemetry,
+        filePath: traceFilePath
+      };
+    }
+    console.error("\u26A0\uFE0F Telemetry classes not available in ProbeAgent, skipping tracing");
+    return null;
+  } catch (error) {
+    console.error("\u26A0\uFE0F Warning: Failed to initialize tracing:", error);
+    return null;
+  }
+}
+var init_tracer_init = __esm({
+  "src/utils/tracer-init.ts"() {
+  }
+});
+
+export {
+  initializeTracer,
+  init_tracer_init
+};
+//# sourceMappingURL=chunk-YXOWIDEF.mjs.map

package/dist/sdk/chunk-YXOWIDEF.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/tracer-init.ts"],"sourcesContent":["import * as path from 'path';\nimport * as fs from 'fs';\nimport { SimpleTelemetry, SimpleAppTracer } from '@probelabs/probe';\n\n/**\n * Safely initialize a tracer for ProbeAgent with proper path sanitization\n * Uses SimpleTelemetry for lightweight tracing\n * This prevents path traversal vulnerabilities by sanitizing the checkName\n */\nexport async function initializeTracer(\n  sessionId: string,\n  checkName?: string\n): Promise<{ tracer: unknown; telemetryConfig: unknown; filePath: string } | null> {\n  try {\n    // Use SimpleTelemetry (probe no longer exports full OpenTelemetry classes)\n    if (SimpleTelemetry && SimpleAppTracer) {\n      // SECURITY: Sanitize checkName to prevent path traversal attacks\n      const sanitizedCheckName = checkName ? path.basename(checkName) : 'check';\n\n      // Create trace file path in debug-artifacts directory\n      const timestamp = new Date().toISOString().replace(/[:.]/g, '-');\n      const traceDir = process.env.GITHUB_WORKSPACE\n        ? path.join(process.env.GITHUB_WORKSPACE, 'debug-artifacts')\n        : path.join(process.cwd(), 'debug-artifacts');\n\n      // Create traces directory if it doesn't exist\n      if (!fs.existsSync(traceDir)) {\n        fs.mkdirSync(traceDir, { recursive: true });\n      }\n\n      // SECURITY: Use path.join to safely construct the path\n      const traceFilePath = path.join(traceDir, `trace-${sanitizedCheckName}-${timestamp}.jsonl`);\n\n      // SECURITY: Verify the resolved path is within the intended directory\n      const resolvedTracePath = path.resolve(traceFilePath);\n      const resolvedTraceDir = path.resolve(traceDir);\n      if (!resolvedTracePath.startsWith(resolvedTraceDir)) {\n        console.error(\n          `⚠️ Security: Attempted path traversal detected. Check name: ${checkName}, resolved path: ${resolvedTracePath}`\n        );\n        return null;\n      }\n\n      // Initialize simple telemetry\n      const telemetry = new SimpleTelemetry({\n        enableFile: true,\n        filePath: traceFilePath,\n        enableConsole: false,\n      });\n\n      const tracer = new SimpleAppTracer(telemetry, sessionId);\n\n      console.error(`📊 Simple tracing enabled, will save to: ${traceFilePath}`);\n\n      // If in GitHub Actions, log the path for artifact upload\n      if (process.env.GITHUB_ACTIONS) {\n        console.log(`::notice title=AI Trace::Trace will be saved to ${traceFilePath}`);\n        console.log(`::set-output name=trace-path::${traceFilePath}`);\n      }\n\n      // Return with SimpleTelemetry\n      return {\n        tracer,\n        telemetryConfig: telemetry,\n        filePath: traceFilePath,\n      };\n    }\n\n    console.error('⚠️ Telemetry classes not available in ProbeAgent, skipping tracing');\n    return null;\n  } catch (error) {\n    console.error('⚠️ Warning: Failed to initialize tracing:', error);\n    return null;\n  }\n}\n"],"mappings":";;;;;AAAA,YAAY,UAAU;AACtB,YAAY,QAAQ;AACpB,SAAS,iBAAiB,uBAAuB;AAOjD,eAAsB,iBACpB,WACA,WACiF;AACjF,MAAI;AAEF,QAAI,mBAAmB,iBAAiB;AAEtC,YAAM,qBAAqB,YAAiB,cAAS,SAAS,IAAI;AAGlE,YAAM,aAAY,oBAAI,KAAK,GAAE,YAAY,EAAE,QAAQ,SAAS,GAAG;AAC/D,YAAM,WAAW,QAAQ,IAAI,mBACpB,UAAK,QAAQ,IAAI,kBAAkB,iBAAiB,IACpD,UAAK,QAAQ,IAAI,GAAG,iBAAiB;AAG9C,UAAI,CAAI,cAAW,QAAQ,GAAG;AAC5B,QAAG,aAAU,UAAU,EAAE,WAAW,KAAK,CAAC;AAAA,MAC5C;AAGA,YAAM,gBAAqB,UAAK,UAAU,SAAS,kBAAkB,IAAI,SAAS,QAAQ;AAG1F,YAAM,oBAAyB,aAAQ,aAAa;AACpD,YAAM,mBAAwB,aAAQ,QAAQ;AAC9C,UAAI,CAAC,kBAAkB,WAAW,gBAAgB,GAAG;AACnD,gBAAQ;AAAA,UACN,yEAA+D,SAAS,oBAAoB,iBAAiB;AAAA,QAC/G;AACA,eAAO;AAAA,MACT;AAGA,YAAM,YAAY,IAAI,gBAAgB;AAAA,QACpC,YAAY;AAAA,QACZ,UAAU;AAAA,QACV,eAAe;AAAA,MACjB,CAAC;AAED,YAAM,SAAS,IAAI,gBAAgB,WAAW,SAAS;AAEvD,cAAQ,MAAM,mDAA4C,aAAa,EAAE;AAGzE,UAAI,QAAQ,IAAI,gBAAgB;AAC9B,gBAAQ,IAAI,mDAAmD,aAAa,EAAE;AAC9E,gBAAQ,IAAI,iCAAiC,aAAa,EAAE;AAAA,MAC9D;AAGA,aAAO;AAAA,QACL;AAAA,QACA,iBAAiB;AAAA,QACjB,UAAU;AAAA,MACZ;AAAA,IACF;AAEA,YAAQ,MAAM,8EAAoE;AAClF,WAAO;AAAA,EACT,SAAS,OAAO;AACd,YAAQ,MAAM,uDAA6C,KAAK;AAChE,WAAO;AAAA,EACT;AACF;AA1EA;AAAA;AAAA;AAAA;","names":[]}

package/dist/sdk/{mermaid-telemetry-LZGDD35I.mjs → mermaid-telemetry-4DUEYCLE.mjs}

@@ -1,7 +1,7 @@
 import {
   addDiagramBlock,
   addEvent
-} from "./chunk-TWJKAYT6.mjs";
+} from "./chunk-IG3BFIIN.mjs";
 import "./chunk-WMJKH4XE.mjs";
 
 // src/utils/mermaid-telemetry.ts
@@ -58,4 +58,4 @@ function emitMermaidFromMarkdown(checkName, markdown, origin) {
 export {
   emitMermaidFromMarkdown
 };
-//# sourceMappingURL=mermaid-telemetry-LZGDD35I.mjs.map
+//# sourceMappingURL=mermaid-telemetry-4DUEYCLE.mjs.map

package/dist/sdk/sdk.d.mts

@@ -120,7 +120,7 @@ interface FailureConditionResult {
 /**
  * Valid check types in configuration
  */
-type ConfigCheckType = 'ai' | 'command' | 'http' | 'http_input' | 'http_client' | 'noop' | 'log' | 'memory' | 'github' | 'claude-code';
+type ConfigCheckType = 'ai' | 'command' | 'http' | 'http_input' | 'http_client' | 'noop' | 'log' | 'memory' | 'github' | 'claude-code' | 'mcp';
 /**
  * Valid event triggers for checks
  */
@@ -314,6 +314,17 @@ interface CheckConfig {
     op?: string;
     /** Values for GitHub operations (can be array or single value) */
     values?: string[] | string;
+    /**
+     * MCP provider specific options (optional, only used when type === 'mcp').
+     */
+    /** Transport type for MCP: stdio (default), sse (legacy), or http (streamable HTTP) */
+    transport?: 'stdio' | 'sse' | 'http';
+    /** Arguments to pass to the MCP method (supports Liquid templates) */
+    methodArgs?: Record<string, unknown>;
+    /** Transform template for method arguments (Liquid) */
+    argsTransform?: string;
+    /** Session ID for HTTP transport (optional, server may generate one) */
+    sessionId?: string;
 }
 /**
  * Backoff policy for retries

package/dist/sdk/sdk.d.ts

@@ -120,7 +120,7 @@ interface FailureConditionResult {
 /**
  * Valid check types in configuration
  */
-type ConfigCheckType = 'ai' | 'command' | 'http' | 'http_input' | 'http_client' | 'noop' | 'log' | 'memory' | 'github' | 'claude-code';
+type ConfigCheckType = 'ai' | 'command' | 'http' | 'http_input' | 'http_client' | 'noop' | 'log' | 'memory' | 'github' | 'claude-code' | 'mcp';
 /**
  * Valid event triggers for checks
  */
@@ -314,6 +314,17 @@ interface CheckConfig {
     op?: string;
     /** Values for GitHub operations (can be array or single value) */
     values?: string[] | string;
+    /**
+     * MCP provider specific options (optional, only used when type === 'mcp').
+     */
+    /** Transport type for MCP: stdio (default), sse (legacy), or http (streamable HTTP) */
+    transport?: 'stdio' | 'sse' | 'http';
+    /** Arguments to pass to the MCP method (supports Liquid templates) */
+    methodArgs?: Record<string, unknown>;
+    /** Transform template for method arguments (Liquid) */
+    argsTransform?: string;
+    /** Session ID for HTTP transport (optional, server may generate one) */
+    sessionId?: string;
 }
 /**
  * Backoff policy for retries