@probelabs/visor 0.1.187 → 0.1.188-ee

package/dist/sdk/trace-helpers-AM2QE5UZ.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/sdk/trace-helpers-OMF4C24T.mjs

@@ -0,0 +1,31 @@
+import {
+  __getOrCreateNdjsonPath,
+  _appendRunMarker,
+  addEvent,
+  emitImmediateSpan,
+  getTracer,
+  getVisorRunAttributes,
+  init_trace_helpers,
+  setSpanAttributes,
+  setSpanError,
+  withActiveSpan,
+  withVisorRun
+} from "./chunk-QLT42TX7.mjs";
+import "./chunk-PUHU6UY6.mjs";
+import "./chunk-FWWLD555.mjs";
+import "./chunk-B2OUZAWY.mjs";
+import "./chunk-J7LXIPZS.mjs";
+init_trace_helpers();
+export {
+  __getOrCreateNdjsonPath,
+  _appendRunMarker,
+  addEvent,
+  emitImmediateSpan,
+  getTracer,
+  getVisorRunAttributes,
+  setSpanAttributes,
+  setSpanError,
+  withActiveSpan,
+  withVisorRun
+};
+//# sourceMappingURL=trace-helpers-OMF4C24T.mjs.map

package/dist/sdk/trace-helpers-OMF4C24T.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/sdk/trace-reader-OVE4DL2D.mjs

@@ -0,0 +1,270 @@
+import {
+  __esm
+} from "./chunk-J7LXIPZS.mjs";
+
+// src/debug-visualizer/trace-reader.ts
+import * as fs from "fs";
+import * as readline from "readline";
+async function parseNDJSONTrace(filePath) {
+  const spans = [];
+  let lineNumber = 0;
+  const fileStream = fs.createReadStream(filePath);
+  const rl = readline.createInterface({
+    input: fileStream,
+    crlfDelay: Infinity
+  });
+  for await (const line of rl) {
+    lineNumber++;
+    if (!line.trim()) {
+      continue;
+    }
+    try {
+      const rawSpan = JSON.parse(line);
+      const processedSpan = processRawSpan(rawSpan);
+      spans.push(processedSpan);
+    } catch (error) {
+      console.warn(`[trace-reader] Malformed JSON at line ${lineNumber}: ${error}`);
+    }
+  }
+  if (spans.length === 0) {
+    throw new Error("No valid spans found in trace file");
+  }
+  const tree = buildExecutionTree(spans);
+  const snapshots = extractStateSnapshots(spans);
+  const timeline = computeTimeline(spans);
+  const sortedSpans = [...spans].sort((a, b) => compareTimeValues(a.startTime, b.startTime));
+  const firstSpan = sortedSpans[0];
+  const lastSpan = sortedSpans[sortedSpans.length - 1];
+  const startTimeMs = timeValueToMillis(firstSpan.startTime);
+  const endTimeMs = timeValueToMillis(lastSpan.endTime);
+  return {
+    runId: tree.checkId,
+    traceId: firstSpan.traceId,
+    spans,
+    tree,
+    timeline,
+    snapshots,
+    metadata: {
+      startTime: timeValueToISO(firstSpan.startTime),
+      endTime: timeValueToISO(lastSpan.endTime),
+      duration: endTimeMs - startTimeMs,
+      totalSpans: spans.length,
+      totalSnapshots: snapshots.length
+    }
+  };
+}
+function processRawSpan(rawSpan) {
+  const traceId = rawSpan.traceId || "";
+  const spanId = rawSpan.spanId || "";
+  const parentSpanId = rawSpan.parentSpanId || void 0;
+  const name = rawSpan.name || "unknown";
+  const startTime = rawSpan.startTime || [0, 0];
+  const endTime = rawSpan.endTime || rawSpan.startTime || [0, 0];
+  const startMs = timeValueToMillis(startTime);
+  const endMs = timeValueToMillis(endTime);
+  const duration = endMs - startMs;
+  const attributes = rawSpan.attributes || {};
+  const events = (rawSpan.events || []).map((evt) => ({
+    name: evt.name || "unknown",
+    time: evt.time || [0, 0],
+    timestamp: evt.timestamp || timeValueToISO(evt.time || [0, 0]),
+    attributes: evt.attributes || {}
+  }));
+  const status = rawSpan.status?.code === 2 ? "error" : "ok";
+  return {
+    traceId,
+    spanId,
+    parentSpanId,
+    name,
+    startTime,
+    endTime,
+    duration,
+    attributes,
+    events,
+    status
+  };
+}
+function buildExecutionTree(spans) {
+  const nodeMap = /* @__PURE__ */ new Map();
+  for (const span of spans) {
+    const node = createExecutionNode(span);
+    nodeMap.set(span.spanId, node);
+  }
+  let rootNode;
+  const orphans = [];
+  for (const span of spans) {
+    const node = nodeMap.get(span.spanId);
+    if (!span.parentSpanId) {
+      rootNode = node;
+    } else {
+      const parent = nodeMap.get(span.parentSpanId);
+      if (parent) {
+        parent.children.push(node);
+      } else {
+        orphans.push(node);
+      }
+    }
+  }
+  if (!rootNode) {
+    console.warn("[trace-reader] No root span found, creating synthetic root");
+    rootNode = {
+      checkId: "synthetic-root",
+      type: "run",
+      status: "completed",
+      children: Array.from(nodeMap.values()).filter((n) => !n.span.parentSpanId),
+      span: spans[0],
+      // Use first span as placeholder
+      state: {}
+    };
+  }
+  if (orphans.length > 0 && rootNode) {
+    rootNode.children.push(...orphans);
+  }
+  return rootNode;
+}
+function createExecutionNode(span) {
+  const attrs = span.attributes;
+  const checkId = attrs["visor.check.id"] || attrs["visor.run.id"] || span.spanId;
+  let type = "unknown";
+  if (span.name === "visor.run") {
+    type = "run";
+  } else if (span.name === "visor.check") {
+    type = "check";
+  } else if (span.name.startsWith("visor.provider.")) {
+    type = "provider";
+  }
+  let status = "completed";
+  if (span.status === "error") {
+    status = "error";
+  } else if (attrs["visor.check.skipped"] === true) {
+    status = "skipped";
+  }
+  const state = {};
+  if (attrs["visor.check.input.context"]) {
+    try {
+      state.inputContext = JSON.parse(attrs["visor.check.input.context"]);
+    } catch {
+      state.inputContext = attrs["visor.check.input.context"];
+    }
+  }
+  if (attrs["visor.check.output"]) {
+    try {
+      state.output = JSON.parse(attrs["visor.check.output"]);
+    } catch {
+      state.output = attrs["visor.check.output"];
+    }
+  }
+  if (span.status === "error" || attrs["visor.check.error"]) {
+    state.errors = [attrs["visor.check.error"] || "Unknown error"];
+  }
+  state.metadata = {
+    type: attrs["visor.check.type"],
+    duration: span.duration,
+    provider: attrs["visor.provider.type"]
+  };
+  return {
+    checkId,
+    type,
+    status,
+    children: [],
+    span,
+    state
+  };
+}
+function extractStateSnapshots(spans) {
+  const snapshots = [];
+  for (const span of spans) {
+    for (const event of span.events) {
+      if (event.name === "state.snapshot") {
+        const attrs = event.attributes || {};
+        const snapshot = {
+          checkId: attrs["visor.snapshot.check_id"] || span.attributes["visor.check.id"] || "unknown",
+          timestamp: attrs["visor.snapshot.timestamp"] || event.timestamp || timeValueToISO(event.time),
+          timestampNanos: event.time,
+          outputs: parseJSON(attrs["visor.snapshot.outputs"], {}),
+          memory: parseJSON(attrs["visor.snapshot.memory"], {})
+        };
+        snapshots.push(snapshot);
+      }
+    }
+  }
+  snapshots.sort((a, b) => compareTimeValues(a.timestampNanos, b.timestampNanos));
+  return snapshots;
+}
+function computeTimeline(spans) {
+  const events = [];
+  for (const span of spans) {
+    const checkId = span.attributes["visor.check.id"] || span.spanId;
+    events.push({
+      type: "check.started",
+      checkId,
+      timestamp: timeValueToISO(span.startTime),
+      timestampNanos: span.startTime,
+      metadata: {
+        name: span.name,
+        type: span.attributes["visor.check.type"]
+      }
+    });
+    events.push({
+      type: span.status === "error" ? "check.failed" : "check.completed",
+      checkId,
+      timestamp: timeValueToISO(span.endTime),
+      timestampNanos: span.endTime,
+      duration: span.duration,
+      status: span.status,
+      metadata: {
+        name: span.name
+      }
+    });
+    for (const evt of span.events) {
+      events.push({
+        type: evt.name === "state.snapshot" ? "state.snapshot" : "event",
+        checkId: evt.attributes?.["visor.snapshot.check_id"] || checkId,
+        timestamp: evt.timestamp || timeValueToISO(evt.time),
+        timestampNanos: evt.time,
+        metadata: {
+          eventName: evt.name,
+          attributes: evt.attributes
+        }
+      });
+    }
+  }
+  events.sort((a, b) => compareTimeValues(a.timestampNanos, b.timestampNanos));
+  return events;
+}
+function timeValueToMillis(timeValue) {
+  const [seconds, nanos] = timeValue;
+  return seconds * 1e3 + nanos / 1e6;
+}
+function timeValueToISO(timeValue) {
+  const millis = timeValueToMillis(timeValue);
+  return new Date(millis).toISOString();
+}
+function compareTimeValues(a, b) {
+  if (a[0] !== b[0]) {
+    return a[0] - b[0];
+  }
+  return a[1] - b[1];
+}
+function parseJSON(value, defaultValue) {
+  if (typeof value !== "string") {
+    return defaultValue;
+  }
+  try {
+    return JSON.parse(value);
+  } catch {
+    return defaultValue;
+  }
+}
+var init_trace_reader = __esm({
+  "src/debug-visualizer/trace-reader.ts"() {
+  }
+});
+init_trace_reader();
+export {
+  buildExecutionTree,
+  computeTimeline,
+  extractStateSnapshots,
+  parseNDJSONTrace
+};
+//# sourceMappingURL=trace-reader-OVE4DL2D.mjs.map

package/dist/sdk/trace-reader-OVE4DL2D.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/debug-visualizer/trace-reader.ts"],"sourcesContent":["/**\n * Trace File Reader & Processor\n *\n * Reads OpenTelemetry NDJSON trace files and reconstructs execution tree structure\n * for the Debug Visualizer.\n *\n * Milestone 2: Trace File Reader\n */\n\nimport * as fs from 'fs';\nimport * as readline from 'readline';\n\n// ============================================================================\n// Core Data Structures\n// ============================================================================\n\n/**\n * OTEL span event with attributes\n */\nexport interface SpanEvent {\n  name: string;\n  time: [number, number]; // [seconds, nanoseconds]\n  timestamp?: string; // ISO timestamp for convenience\n  attributes?: Record<string, any>;\n}\n\n/**\n * Processed OTEL span with clean structure\n */\nexport interface ProcessedSpan {\n  traceId: string;\n  spanId: string;\n  parentSpanId?: string;\n  name: string;\n  startTime: [number, number]; // [seconds, nanoseconds]\n  endTime: [number, number]; // [seconds, nanoseconds]\n  duration: number; // milliseconds\n  attributes: Record<string, any>;\n  events: SpanEvent[];\n  status: 'ok' | 'error';\n}\n\n/**\n * Hierarchical execution tree node\n */\nexport interface ExecutionNode {\n  checkId: string;\n  type: string; // 'run', 'check', 'provider'\n  status: 'pending' | 'running' | 'completed' | 'error' | 'skipped';\n  children: ExecutionNode[];\n  span: ProcessedSpan;\n  state: {\n    inputContext?: any;\n    output?: any;\n    errors?: string[];\n    metadata?: Record<string, any>;\n  };\n}\n\n/**\n * State snapshot for time-travel debugging\n */\nexport interface StateSnapshot {\n  checkId: string;\n  timestamp: string;\n  timestampNanos: [number, number];\n  outputs: Record<string, any>;\n  memory: Record<string, any>;\n}\n\n/**\n * Timeline event for visualization\n */\nexport interface TimelineEvent {\n  type: 'check.started' | 'check.completed' | 'check.failed' | 'state.snapshot' | 'event';\n  checkId?: string;\n  timestamp: string;\n  timestampNanos: [number, number];\n  duration?: number;\n  status?: string;\n  metadata?: Record<string, any>;\n}\n\n/**\n * Complete parsed execution trace\n */\nexport interface ExecutionTrace {\n  runId: string;\n  traceId: string;\n  spans: ProcessedSpan[];\n  tree: ExecutionNode;\n  timeline: TimelineEvent[];\n  snapshots: StateSnapshot[];\n  metadata: {\n    startTime: string;\n    endTime: string;\n    duration: number; // milliseconds\n    totalSpans: number;\n    totalSnapshots: number;\n  };\n}\n\n// ============================================================================\n// NDJSON Parser\n// ============================================================================\n\n/**\n * Parse NDJSON trace file and return structured execution trace\n *\n * @param filePath - Path to NDJSON trace file\n * @returns Parsed execution trace with tree, timeline, and snapshots\n */\nexport async function parseNDJSONTrace(filePath: string): Promise<ExecutionTrace> {\n  const spans: ProcessedSpan[] = [];\n  let lineNumber = 0;\n\n  // Read file line by line\n  const fileStream = fs.createReadStream(filePath);\n  const rl = readline.createInterface({\n    input: fileStream,\n    crlfDelay: Infinity,\n  });\n\n  for await (const line of rl) {\n    lineNumber++;\n\n    // Skip empty lines\n    if (!line.trim()) {\n      continue;\n    }\n\n    try {\n      const rawSpan = JSON.parse(line);\n      const processedSpan = processRawSpan(rawSpan);\n      spans.push(processedSpan);\n    } catch (error) {\n      console.warn(`[trace-reader] Malformed JSON at line ${lineNumber}: ${error}`);\n      // Continue parsing remaining lines\n    }\n  }\n\n  if (spans.length === 0) {\n    throw new Error('No valid spans found in trace file');\n  }\n\n  // Build execution tree\n  const tree = buildExecutionTree(spans);\n\n  // Extract state snapshots\n  const snapshots = extractStateSnapshots(spans);\n\n  // Compute timeline\n  const timeline = computeTimeline(spans);\n\n  // Calculate metadata\n  const sortedSpans = [...spans].sort((a, b) => compareTimeValues(a.startTime, b.startTime));\n  const firstSpan = sortedSpans[0];\n  const lastSpan = sortedSpans[sortedSpans.length - 1];\n\n  const startTimeMs = timeValueToMillis(firstSpan.startTime);\n  const endTimeMs = timeValueToMillis(lastSpan.endTime);\n\n  return {\n    runId: tree.checkId,\n    traceId: firstSpan.traceId,\n    spans,\n    tree,\n    timeline,\n    snapshots,\n    metadata: {\n      startTime: timeValueToISO(firstSpan.startTime),\n      endTime: timeValueToISO(lastSpan.endTime),\n      duration: endTimeMs - startTimeMs,\n      totalSpans: spans.length,\n      totalSnapshots: snapshots.length,\n    },\n  };\n}\n\n/**\n * Process raw OTEL span into clean structure\n */\nfunction processRawSpan(rawSpan: any): ProcessedSpan {\n  // Extract span IDs\n  const traceId = rawSpan.traceId || '';\n  const spanId = rawSpan.spanId || '';\n  const parentSpanId = rawSpan.parentSpanId || undefined;\n\n  // Extract name\n  const name = rawSpan.name || 'unknown';\n\n  // Extract times\n  const startTime = rawSpan.startTime || [0, 0];\n  const endTime = rawSpan.endTime || rawSpan.startTime || [0, 0];\n\n  // Calculate duration in milliseconds\n  const startMs = timeValueToMillis(startTime);\n  const endMs = timeValueToMillis(endTime);\n  const duration = endMs - startMs;\n\n  // Extract attributes\n  const attributes = rawSpan.attributes || {};\n\n  // Extract events\n  const events: SpanEvent[] = (rawSpan.events || []).map((evt: any) => ({\n    name: evt.name || 'unknown',\n    time: evt.time || [0, 0],\n    timestamp: evt.timestamp || timeValueToISO(evt.time || [0, 0]),\n    attributes: evt.attributes || {},\n  }));\n\n  // Determine status\n  const status = rawSpan.status?.code === 2 ? 'error' : 'ok';\n\n  return {\n    traceId,\n    spanId,\n    parentSpanId,\n    name,\n    startTime,\n    endTime,\n    duration,\n    attributes,\n    events,\n    status,\n  };\n}\n\n// ============================================================================\n// Execution Tree Builder\n// ============================================================================\n\n/**\n * Build hierarchical execution tree from flat list of spans\n *\n * @param spans - List of processed spans\n * @returns Root execution node with children\n */\nexport function buildExecutionTree(spans: ProcessedSpan[]): ExecutionNode {\n  // Create map of spanId -> ExecutionNode\n  const nodeMap = new Map<string, ExecutionNode>();\n\n  // First pass: create all nodes\n  for (const span of spans) {\n    const node = createExecutionNode(span);\n    nodeMap.set(span.spanId, node);\n  }\n\n  // Second pass: build parent-child relationships\n  let rootNode: ExecutionNode | undefined;\n  const orphans: ExecutionNode[] = [];\n\n  for (const span of spans) {\n    const node = nodeMap.get(span.spanId)!;\n\n    if (!span.parentSpanId) {\n      // This is the root node (visor.run)\n      rootNode = node;\n    } else {\n      // Find parent and add as child\n      const parent = nodeMap.get(span.parentSpanId);\n      if (parent) {\n        parent.children.push(node);\n      } else {\n        // Orphaned span — parent not in this trace; attach to root later\n        orphans.push(node);\n      }\n    }\n  }\n\n  if (!rootNode) {\n    // No root found, create synthetic root\n    console.warn('[trace-reader] No root span found, creating synthetic root');\n    rootNode = {\n      checkId: 'synthetic-root',\n      type: 'run',\n      status: 'completed',\n      children: Array.from(nodeMap.values()).filter(n => !n.span.parentSpanId),\n      span: spans[0], // Use first span as placeholder\n      state: {},\n    };\n  }\n\n  // Attach orphaned spans (e.g. probe-internal spans whose parent is outside\n  // this trace) to the root so they appear in the visualization.\n  if (orphans.length > 0 && rootNode) {\n    rootNode.children.push(...orphans);\n  }\n\n  return rootNode;\n}\n\n/**\n * Create execution node from span\n */\nfunction createExecutionNode(span: ProcessedSpan): ExecutionNode {\n  const attrs = span.attributes;\n\n  // Extract check ID\n  const checkId = attrs['visor.check.id'] || attrs['visor.run.id'] || span.spanId;\n\n  // Determine type\n  let type = 'unknown';\n  if (span.name === 'visor.run') {\n    type = 'run';\n  } else if (span.name === 'visor.check') {\n    type = 'check';\n  } else if (span.name.startsWith('visor.provider.')) {\n    type = 'provider';\n  }\n\n  // Determine status\n  let status: ExecutionNode['status'] = 'completed';\n  if (span.status === 'error') {\n    status = 'error';\n  } else if (attrs['visor.check.skipped'] === true) {\n    status = 'skipped';\n  }\n\n  // Extract state\n  const state: ExecutionNode['state'] = {};\n\n  // Input context\n  if (attrs['visor.check.input.context']) {\n    try {\n      state.inputContext = JSON.parse(attrs['visor.check.input.context']);\n    } catch {\n      state.inputContext = attrs['visor.check.input.context'];\n    }\n  }\n\n  // Output\n  if (attrs['visor.check.output']) {\n    try {\n      state.output = JSON.parse(attrs['visor.check.output']);\n    } catch {\n      state.output = attrs['visor.check.output'];\n    }\n  }\n\n  // Errors\n  if (span.status === 'error' || attrs['visor.check.error']) {\n    state.errors = [attrs['visor.check.error'] || 'Unknown error'];\n  }\n\n  // Additional metadata\n  state.metadata = {\n    type: attrs['visor.check.type'],\n    duration: span.duration,\n    provider: attrs['visor.provider.type'],\n  };\n\n  return {\n    checkId,\n    type,\n    status,\n    children: [],\n    span,\n    state,\n  };\n}\n\n// ============================================================================\n// State Snapshot Extractor\n// ============================================================================\n\n/**\n * Extract state snapshots from spans for time-travel debugging\n *\n * @param spans - List of processed spans\n * @returns Array of state snapshots sorted by timestamp\n */\nexport function extractStateSnapshots(spans: ProcessedSpan[]): StateSnapshot[] {\n  const snapshots: StateSnapshot[] = [];\n\n  for (const span of spans) {\n    // Find state.snapshot events\n    for (const event of span.events) {\n      if (event.name === 'state.snapshot') {\n        const attrs = event.attributes || {};\n\n        const snapshot: StateSnapshot = {\n          checkId:\n            attrs['visor.snapshot.check_id'] || span.attributes['visor.check.id'] || 'unknown',\n          timestamp:\n            attrs['visor.snapshot.timestamp'] || event.timestamp || timeValueToISO(event.time),\n          timestampNanos: event.time,\n          outputs: parseJSON(attrs['visor.snapshot.outputs'], {}),\n          memory: parseJSON(attrs['visor.snapshot.memory'], {}),\n        };\n\n        snapshots.push(snapshot);\n      }\n    }\n  }\n\n  // Sort by timestamp\n  snapshots.sort((a, b) => compareTimeValues(a.timestampNanos, b.timestampNanos));\n\n  return snapshots;\n}\n\n// ============================================================================\n// Timeline Generator\n// ============================================================================\n\n/**\n * Compute chronological timeline of execution events\n *\n * @param spans - List of processed spans\n * @returns Array of timeline events sorted chronologically\n */\nexport function computeTimeline(spans: ProcessedSpan[]): TimelineEvent[] {\n  const events: TimelineEvent[] = [];\n\n  for (const span of spans) {\n    const checkId = span.attributes['visor.check.id'] || span.spanId;\n\n    // Check started event\n    events.push({\n      type: 'check.started',\n      checkId,\n      timestamp: timeValueToISO(span.startTime),\n      timestampNanos: span.startTime,\n      metadata: {\n        name: span.name,\n        type: span.attributes['visor.check.type'],\n      },\n    });\n\n    // Check completed/failed event\n    events.push({\n      type: span.status === 'error' ? 'check.failed' : 'check.completed',\n      checkId,\n      timestamp: timeValueToISO(span.endTime),\n      timestampNanos: span.endTime,\n      duration: span.duration,\n      status: span.status,\n      metadata: {\n        name: span.name,\n      },\n    });\n\n    // Add span events (state.snapshot, etc.)\n    for (const evt of span.events) {\n      events.push({\n        type: evt.name === 'state.snapshot' ? 'state.snapshot' : 'event',\n        checkId: evt.attributes?.['visor.snapshot.check_id'] || checkId,\n        timestamp: evt.timestamp || timeValueToISO(evt.time),\n        timestampNanos: evt.time,\n        metadata: {\n          eventName: evt.name,\n          attributes: evt.attributes,\n        },\n      });\n    }\n  }\n\n  // Sort chronologically\n  events.sort((a, b) => compareTimeValues(a.timestampNanos, b.timestampNanos));\n\n  return events;\n}\n\n// ============================================================================\n// Utility Functions\n// ============================================================================\n\n/**\n * Convert OTEL time value [seconds, nanoseconds] to milliseconds\n */\nfunction timeValueToMillis(timeValue: [number, number]): number {\n  const [seconds, nanos] = timeValue;\n  return seconds * 1000 + nanos / 1_000_000;\n}\n\n/**\n * Convert OTEL time value to ISO timestamp string\n */\nfunction timeValueToISO(timeValue: [number, number]): string {\n  const millis = timeValueToMillis(timeValue);\n  return new Date(millis).toISOString();\n}\n\n/**\n * Compare two time values for sorting\n * Returns: -1 if a < b, 0 if a === b, 1 if a > b\n */\nfunction compareTimeValues(a: [number, number], b: [number, number]): number {\n  if (a[0] !== b[0]) {\n    return a[0] - b[0];\n  }\n  return a[1] - b[1];\n}\n\n/**\n * Safely parse JSON string, return default on error\n */\nfunction parseJSON<T>(value: any, defaultValue: T): T {\n  if (typeof value !== 'string') {\n    return defaultValue;\n  }\n\n  try {\n    return JSON.parse(value);\n  } catch {\n    return defaultValue;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/sdk/trace-serializer-EBHTHZYT.mjs

@@ -0,0 +1,24 @@
+import {
+  fetchTraceSpans,
+  findTraceFile,
+  init_trace_serializer,
+  readTraceIdFromFile,
+  renderSpanTree,
+  renderSpanYaml,
+  renderTraceTree,
+  serializeTraceForPrompt
+} from "./chunk-IY5PQ5EN.mjs";
+import "./chunk-6E625R3C.mjs";
+import "./chunk-B2OUZAWY.mjs";
+import "./chunk-J7LXIPZS.mjs";
+init_trace_serializer();
+export {
+  fetchTraceSpans,
+  findTraceFile,
+  readTraceIdFromFile,
+  renderSpanTree,
+  renderSpanYaml,
+  renderTraceTree,
+  serializeTraceForPrompt
+};
+//# sourceMappingURL=trace-serializer-EBHTHZYT.mjs.map

package/dist/sdk/trace-serializer-EBHTHZYT.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/sdk/track-execution-BULXL2XD.mjs

@@ -0,0 +1,249 @@
+import {
+  TaskLiveUpdateManager,
+  init_task_live_updates,
+  resolveTaskLiveUpdatesConfig
+} from "./chunk-D6O5SCPC.mjs";
+import "./chunk-IY5PQ5EN.mjs";
+import {
+  init_task_trace_resolution,
+  resolveTaskTraceReference
+} from "./chunk-WZQMTD7W.mjs";
+import {
+  getInstanceId,
+  init_instance_id,
+  require_package
+} from "./chunk-PUHU6UY6.mjs";
+import {
+  init_logger,
+  logger
+} from "./chunk-6E625R3C.mjs";
+import {
+  init_lazy_otel,
+  trace
+} from "./chunk-B2OUZAWY.mjs";
+import {
+  __esm
+} from "./chunk-J7LXIPZS.mjs";
+
+// src/agent-protocol/track-execution.ts
+import crypto from "crypto";
+import fs from "fs";
+import path from "path";
+function getPackageVersion() {
+  try {
+    return require_package()?.version || "dev";
+  } catch {
+    return "dev";
+  }
+}
+async function readTraceIdFromFallbackFile(traceFile) {
+  if (!traceFile || !fs.existsSync(traceFile)) return void 0;
+  try {
+    const { readTraceIdFromFile } = await import("./trace-serializer-EBHTHZYT.mjs");
+    return await readTraceIdFromFile(traceFile) || void 0;
+  } catch {
+    return void 0;
+  }
+}
+async function trackExecution(opts, executor) {
+  const { taskStore, source, configPath, metadata, messageText } = opts;
+  const configName = configPath ? path.basename(configPath, path.extname(configPath)) : void 0;
+  const workflowId = configName && opts.workflowId ? `${configName}#${opts.workflowId}` : opts.workflowId;
+  const requestMessage = {
+    message_id: crypto.randomUUID(),
+    role: "user",
+    parts: [{ text: messageText }]
+  };
+  const traceFile = process.env.VISOR_FALLBACK_TRACE_FILE || void 0;
+  const task = taskStore.createTask({
+    contextId: crypto.randomUUID(),
+    requestMessage,
+    workflowId,
+    requestMetadata: {
+      source,
+      instance_id: getInstanceId(),
+      visor_version: process.env.VISOR_VERSION || getPackageVersion(),
+      ...process.env.VISOR_COMMIT_SHORT ? { visor_commit: process.env.VISOR_COMMIT_SHORT } : {},
+      trace_id: trace.getActiveSpan()?.spanContext().traceId || void 0,
+      ...traceFile ? { trace_file: traceFile } : {},
+      ...metadata
+    }
+  });
+  const instanceId = getInstanceId();
+  return await logger.withTaskContext(task.id, async () => {
+    taskStore.updateTaskState(task.id, "working");
+    taskStore.claimTask(task.id, instanceId);
+    logger.info(
+      `[TaskTracking] Task ${task.id} started (source=${source}, workflow=${workflowId || "-"}, instance=${instanceId})`
+    );
+    const liveUpdateConfig = resolveTaskLiveUpdatesConfig(opts.liveUpdates?.config);
+    const initialTraceId = trace.getActiveSpan()?.spanContext().traceId || task.metadata?.trace_id;
+    if (initialTraceId && !task.metadata?.trace_id) {
+      try {
+        taskStore.updateMetadata(task.id, { trace_id: initialTraceId });
+      } catch {
+      }
+    }
+    const initialResolvedTrace = await resolveTaskTraceReference({
+      trace_id: initialTraceId || task.metadata?.trace_id,
+      trace_file: task.metadata?.trace_file
+    });
+    const liveUpdateManager = liveUpdateConfig && opts.liveUpdates?.sink ? new TaskLiveUpdateManager({
+      taskId: task.id,
+      requestText: messageText,
+      traceRef: initialResolvedTrace.primaryRef,
+      traceId: initialResolvedTrace.traceId,
+      includeTraceId: opts.liveUpdates?.includeTraceId === true,
+      sink: opts.liveUpdates.sink,
+      config: liveUpdateConfig,
+      resolveTraceState: () => {
+        let current;
+        try {
+          current = taskStore.getTask(task.id);
+        } catch {
+          return {
+            traceRef: initialResolvedTrace.primaryRef,
+            traceId: initialResolvedTrace.traceId
+          };
+        }
+        return {
+          traceRef: current?.metadata?.trace_id || current?.metadata?.trace_file || initialResolvedTrace.primaryRef,
+          traceId: current?.metadata?.trace_id
+        };
+      },
+      onPostedRef: (ref) => {
+        try {
+          taskStore.updateMetadata(task.id, ref);
+        } catch {
+        }
+      },
+      appendHistory: (text, stage) => {
+        try {
+          taskStore.appendHistory(task.id, {
+            message_id: crypto.randomUUID(),
+            role: "agent",
+            parts: [{ text }],
+            metadata: { kind: "task_live_update", stage, source }
+          });
+        } catch {
+        }
+      }
+    }) : null;
+    if (liveUpdateConfig && !opts.liveUpdates?.sink) {
+      logger.debug(
+        `[TaskTracking] Live updates requested for task ${task.id} but no sink is available for source=${source}`
+      );
+    } else if (liveUpdateManager) {
+      logger.info(`[TaskTracking] Live updates enabled for task ${task.id} (source=${source})`);
+    }
+    const HEARTBEAT_INTERVAL = 6e4;
+    const heartbeatTimer = setInterval(() => {
+      try {
+        taskStore.heartbeat(task.id);
+      } catch {
+      }
+    }, HEARTBEAT_INTERVAL);
+    try {
+      if (liveUpdateManager) {
+        await liveUpdateManager.start();
+      }
+      const result = await executor();
+      try {
+        const activeTraceId = trace.getActiveSpan()?.spanContext().traceId;
+        const persistedTraceId = (activeTraceId && activeTraceId !== "" ? activeTraceId : void 0) || await readTraceIdFromFallbackFile(traceFile);
+        if (persistedTraceId && !task.metadata?.trace_id) {
+          taskStore.updateMetadata(task.id, { trace_id: persistedTraceId });
+        }
+      } catch {
+      }
+      let responseText = "Execution completed";
+      try {
+        const history = result?.reviewSummary?.history;
+        if (history) {
+          const entries = Object.values(history);
+          for (let i = entries.length - 1; i >= 0; i--) {
+            const outputs = entries[i];
+            if (!Array.isArray(outputs)) continue;
+            for (let j = outputs.length - 1; j >= 0; j--) {
+              const text = outputs[j]?.text;
+              if (typeof text === "string" && text.trim().length > 0) {
+                responseText = text.trim();
+                break;
+              }
+            }
+            if (responseText !== "Execution completed") break;
+          }
+        }
+      } catch {
+      }
+      const completedMsg = {
+        message_id: crypto.randomUUID(),
+        role: "agent",
+        parts: [{ text: responseText }]
+      };
+      try {
+        taskStore.updateTaskState(task.id, "completed", completedMsg);
+        logger.info(`[TaskTracking] Task ${task.id} completed`);
+      } catch (stateErr) {
+        logger.warn(
+          `[TaskTracking] Task ${task.id} completed but state transition failed: ${stateErr instanceof Error ? stateErr.message : stateErr}`
+        );
+      }
+      if (opts.autoEvaluate || process.env.VISOR_TASK_EVALUATE === "true") {
+        scheduleEvaluation(task.id, taskStore);
+      }
+      if (liveUpdateManager) {
+        await liveUpdateManager.complete(responseText);
+      }
+      return { task, result };
+    } catch (err) {
+      const errorText = err instanceof Error ? err.message : String(err);
+      const failMessage = {
+        message_id: crypto.randomUUID(),
+        role: "agent",
+        parts: [{ text: errorText }]
+      };
+      try {
+        taskStore.updateTaskState(task.id, "failed", failMessage);
+        logger.info(`[TaskTracking] Task ${task.id} failed: ${errorText}`);
+      } catch {
+      }
+      if (liveUpdateManager) {
+        await liveUpdateManager.fail(`:warning: ${errorText}`);
+      }
+      throw err;
+    } finally {
+      clearInterval(heartbeatTimer);
+      liveUpdateManager?.stop();
+    }
+  });
+}
+function scheduleEvaluation(taskId, taskStore) {
+  setTimeout(async () => {
+    await logger.withTaskContext(taskId, async () => {
+      try {
+        const { evaluateAndStore } = await import("./task-evaluator-H3BXC7SE.mjs");
+        await evaluateAndStore(taskId, taskStore);
+        logger.info(`[TaskEvaluator] Auto-evaluation completed for task ${taskId}`);
+      } catch (err) {
+        logger.warn(
+          `[TaskEvaluator] Auto-evaluation failed for task ${taskId}: ${err instanceof Error ? err.message : err}`
+        );
+      }
+    });
+  }, 5e3);
+}
+var init_track_execution = __esm({
+  "src/agent-protocol/track-execution.ts"() {
+    init_logger();
+    init_lazy_otel();
+    init_instance_id();
+    init_task_live_updates();
+    init_task_trace_resolution();
+  }
+});
+init_track_execution();
+export {
+  trackExecution
+};
+//# sourceMappingURL=track-execution-BULXL2XD.mjs.map

package/dist/sdk/track-execution-BULXL2XD.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/agent-protocol/track-execution.ts"],"sourcesContent":["/**\n * Shared execution tracking helper.\n *\n * Wraps any engine execution call with task lifecycle management:\n * creates a task in 'submitted' state, transitions to 'working',\n * runs the executor, then sets terminal state (completed/failed).\n *\n * Used by CLI, Slack, TUI, and Scheduler frontends when task_tracking is enabled.\n */\n\nimport crypto from 'crypto';\nimport fs from 'fs';\nimport path from 'path';\nimport { logger } from '../logger';\nimport { trace } from '../telemetry/lazy-otel';\nimport { getInstanceId } from '../utils/instance-id';\nimport type { TaskLiveUpdatesConfig } from '../types/config';\nimport type { TaskStore } from './task-store';\nimport type { AgentMessage, AgentTask } from './types';\nimport {\n  resolveTaskLiveUpdatesConfig,\n  TaskLiveUpdateManager,\n  type TaskLiveUpdateSink,\n} from './task-live-updates';\nimport { resolveTaskTraceReference } from './task-trace-resolution';\n\nfunction getPackageVersion(): string {\n  try {\n    return require('../../package.json')?.version || 'dev';\n  } catch {\n    return 'dev';\n  }\n}\n\nasync function readTraceIdFromFallbackFile(traceFile?: string): Promise<string | undefined> {\n  if (!traceFile || !fs.existsSync(traceFile)) return undefined;\n\n  try {\n    const { readTraceIdFromFile } = await import('./trace-serializer');\n    return (await readTraceIdFromFile(traceFile)) || undefined;\n  } catch {\n    return undefined;\n  }\n}\n\nexport type TaskSource =\n  | 'cli'\n  | 'slack'\n  | 'telegram'\n  | 'email'\n  | 'whatsapp'\n  | 'teams'\n  | 'a2a'\n  | 'mcp'\n  | 'tui'\n  | 'scheduler'\n  | 'webhook'\n  | 'test';\n\nexport interface TrackExecutionOptions {\n  taskStore: TaskStore;\n  source: TaskSource;\n  workflowId?: string;\n  /** Config file path — used to prefix workflowId as \"config.yaml#workflow\" */\n  configPath?: string;\n  metadata?: Record<string, unknown>;\n  /** Human-readable description of what's being executed */\n  messageText: string;\n  /** Run LLM evaluation after task completion (non-blocking). */\n  autoEvaluate?: boolean;\n  /** Optional live progress updates for supported interactive frontends. */\n  liveUpdates?: {\n    config?: boolean | TaskLiveUpdatesConfig;\n    sink?: TaskLiveUpdateSink;\n    includeTraceId?: boolean;\n  };\n}\n\n/**\n * Wrap an engine execution call with task lifecycle tracking.\n *\n * Creates a task, transitions to 'working', runs the executor,\n * then sets terminal state. Returns both the task and the original result.\n * Re-throws any executor error after marking the task as failed.\n */\nexport async function trackExecution<T>(\n  opts: TrackExecutionOptions,\n  executor: () => Promise<T>\n): Promise<{ task: AgentTask; result: T }> {\n  const { taskStore, source, configPath, metadata, messageText } = opts;\n  const configName = configPath ? path.basename(configPath, path.extname(configPath)) : undefined;\n  const workflowId =\n    configName && opts.workflowId ? `${configName}#${opts.workflowId}` : opts.workflowId;\n\n  const requestMessage: AgentMessage = {\n    message_id: crypto.randomUUID(),\n    role: 'user',\n    parts: [{ text: messageText }],\n  };\n\n  // Capture trace file path if telemetry is writing to a file\n  const traceFile = process.env.VISOR_FALLBACK_TRACE_FILE || undefined;\n\n  const task = taskStore.createTask({\n    contextId: crypto.randomUUID(),\n    requestMessage,\n    workflowId,\n    requestMetadata: {\n      source,\n      instance_id: getInstanceId(),\n      visor_version: process.env.VISOR_VERSION || getPackageVersion(),\n      ...(process.env.VISOR_COMMIT_SHORT ? { visor_commit: process.env.VISOR_COMMIT_SHORT } : {}),\n      trace_id: trace.getActiveSpan()?.spanContext().traceId || undefined,\n      ...(traceFile ? { trace_file: traceFile } : {}),\n      ...metadata,\n    },\n  });\n\n  const instanceId = getInstanceId();\n  return await logger.withTaskContext(task.id, async () => {\n    taskStore.updateTaskState(task.id, 'working');\n    taskStore.claimTask(task.id, instanceId);\n    logger.info(\n      `[TaskTracking] Task ${task.id} started (source=${source}, workflow=${workflowId || '-'}, instance=${instanceId})`\n    );\n\n    const liveUpdateConfig = resolveTaskLiveUpdatesConfig(opts.liveUpdates?.config);\n    const initialTraceId =\n      trace.getActiveSpan()?.spanContext().traceId ||\n      (task.metadata?.trace_id as string | undefined);\n    if (initialTraceId && !task.metadata?.trace_id) {\n      try {\n        taskStore.updateMetadata(task.id, { trace_id: initialTraceId });\n      } catch {\n        // best-effort only\n      }\n    }\n    const initialResolvedTrace = await resolveTaskTraceReference({\n      trace_id: initialTraceId || (task.metadata?.trace_id as string | undefined),\n      trace_file: task.metadata?.trace_file as string | undefined,\n    });\n    const liveUpdateManager =\n      liveUpdateConfig && opts.liveUpdates?.sink\n        ? new TaskLiveUpdateManager({\n            taskId: task.id,\n            requestText: messageText,\n            traceRef: initialResolvedTrace.primaryRef,\n            traceId: initialResolvedTrace.traceId,\n            includeTraceId: opts.liveUpdates?.includeTraceId === true,\n            sink: opts.liveUpdates.sink,\n            config: liveUpdateConfig,\n            resolveTraceState: () => {\n              let current;\n              try {\n                current = taskStore.getTask(task.id);\n              } catch {\n                return {\n                  traceRef: initialResolvedTrace.primaryRef,\n                  traceId: initialResolvedTrace.traceId,\n                };\n              }\n              return {\n                traceRef:\n                  (current?.metadata?.trace_id as string | undefined) ||\n                  (current?.metadata?.trace_file as string | undefined) ||\n                  initialResolvedTrace.primaryRef,\n                traceId: current?.metadata?.trace_id as string | undefined,\n              };\n            },\n            onPostedRef: ref => {\n              try {\n                taskStore.updateMetadata(task.id, ref);\n              } catch {\n                // best-effort only\n              }\n            },\n            appendHistory: (text, stage) => {\n              try {\n                taskStore.appendHistory(task.id, {\n                  message_id: crypto.randomUUID(),\n                  role: 'agent',\n                  parts: [{ text }],\n                  metadata: { kind: 'task_live_update', stage, source },\n                });\n              } catch {\n                // best-effort only\n              }\n            },\n          })\n        : null;\n    if (liveUpdateConfig && !opts.liveUpdates?.sink) {\n      logger.debug(\n        `[TaskTracking] Live updates requested for task ${task.id} but no sink is available for source=${source}`\n      );\n    } else if (liveUpdateManager) {\n      logger.info(`[TaskTracking] Live updates enabled for task ${task.id} (source=${source})`);\n    }\n\n    // Heartbeat: periodically touch updated_at so stale-task detection\n    // can distinguish live tasks from orphans (works across nodes).\n    const HEARTBEAT_INTERVAL = 60_000; // 1 minute\n    const heartbeatTimer = setInterval(() => {\n      try {\n        taskStore.heartbeat(task.id);\n      } catch {\n        // best-effort — don't crash the task over a heartbeat failure\n      }\n    }, HEARTBEAT_INTERVAL);\n\n    try {\n      if (liveUpdateManager) {\n        await liveUpdateManager.start();\n      }\n      const result = await executor();\n\n      // Now that execution is done, capture the trace ID from the active span.\n      // At task creation time the span may not have been active yet, so we\n      // update metadata post-execution to ensure trace_id is stored.\n      try {\n        const activeTraceId = trace.getActiveSpan()?.spanContext().traceId;\n        const persistedTraceId =\n          (activeTraceId && activeTraceId !== '' ? activeTraceId : undefined) ||\n          (await readTraceIdFromFallbackFile(traceFile));\n        if (persistedTraceId && !task.metadata?.trace_id) {\n          taskStore.updateMetadata(task.id, { trace_id: persistedTraceId });\n        }\n      } catch {\n        // best-effort — don't fail the task over metadata\n      }\n\n      // Extract AI response text from the result.\n      // result.reviewSummary.history is keyed by checkId with arrays of outputs.\n      // We want the LAST check's text output (the final AI response), not the\n      // first (which is typically the intent router).\n      let responseText = 'Execution completed';\n      try {\n        const history = (result as any)?.reviewSummary?.history as\n          | Record<string, unknown[]>\n          | undefined;\n        if (history) {\n          const entries = Object.values(history);\n          // Iterate in reverse — last check output is the final response\n          for (let i = entries.length - 1; i >= 0; i--) {\n            const outputs = entries[i];\n            if (!Array.isArray(outputs)) continue;\n            // Within a check, look at the last output first too\n            for (let j = outputs.length - 1; j >= 0; j--) {\n              const text = (outputs[j] as any)?.text;\n              if (typeof text === 'string' && text.trim().length > 0) {\n                responseText = text.trim();\n                break;\n              }\n            }\n            if (responseText !== 'Execution completed') break;\n          }\n        }\n      } catch {\n        // ignore extraction errors\n      }\n\n      const completedMsg: AgentMessage = {\n        message_id: crypto.randomUUID(),\n        role: 'agent',\n        parts: [{ text: responseText }],\n      };\n      try {\n        taskStore.updateTaskState(task.id, 'completed', completedMsg);\n        logger.info(`[TaskTracking] Task ${task.id} completed`);\n      } catch (stateErr) {\n        // Another process (e.g. stale sweep) may have already marked this task as failed.\n        // Log a warning but do NOT re-throw — the execution itself succeeded.\n        logger.warn(\n          `[TaskTracking] Task ${task.id} completed but state transition failed: ${stateErr instanceof Error ? stateErr.message : stateErr}`\n        );\n      }\n\n      // Fire-and-forget LLM evaluation (non-blocking)\n      // Enabled via opts.autoEvaluate (from config.task_evaluate) or VISOR_TASK_EVALUATE env var\n      if (opts.autoEvaluate || process.env.VISOR_TASK_EVALUATE === 'true') {\n        scheduleEvaluation(task.id, taskStore);\n      }\n\n      if (liveUpdateManager) {\n        await liveUpdateManager.complete(responseText);\n      }\n\n      return { task, result };\n    } catch (err) {\n      const errorText = err instanceof Error ? err.message : String(err);\n      const failMessage: AgentMessage = {\n        message_id: crypto.randomUUID(),\n        role: 'agent',\n        parts: [{ text: errorText }],\n      };\n      try {\n        taskStore.updateTaskState(task.id, 'failed', failMessage);\n        logger.info(`[TaskTracking] Task ${task.id} failed: ${errorText}`);\n      } catch {\n        // ignore double-failure\n      }\n      if (liveUpdateManager) {\n        await liveUpdateManager.fail(`:warning: ${errorText}`);\n      }\n      throw err; // re-throw to preserve original behavior\n    } finally {\n      clearInterval(heartbeatTimer);\n      liveUpdateManager?.stop();\n    }\n  });\n}\n\n// ---------------------------------------------------------------------------\n// Non-blocking auto-evaluation\n// ---------------------------------------------------------------------------\n\nfunction scheduleEvaluation(taskId: string, taskStore: TaskStore): void {\n  // Delay slightly to let OTEL spans flush before we try to read the trace\n  setTimeout(async () => {\n    await logger.withTaskContext(taskId, async () => {\n      try {\n        const { evaluateAndStore } = await import('./task-evaluator');\n        await evaluateAndStore(taskId, taskStore as any);\n        logger.info(`[TaskEvaluator] Auto-evaluation completed for task ${taskId}`);\n      } catch (err) {\n        logger.warn(\n          `[TaskEvaluator] Auto-evaluation failed for task ${taskId}: ${err instanceof Error ? err.message : err}`\n        );\n      }\n    });\n  }, 5000);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAUA,OAAO,YAAY;AACnB,OAAO,QAAQ;AACf,OAAO,UAAU;AAcjB,SAAS,oBAA4B;AACnC,MAAI;AACF,WAAO,mBAA+B,WAAW;AAAA,EACnD,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEA,eAAe,4BAA4B,WAAiD;AAC1F,MAAI,CAAC,aAAa,CAAC,GAAG,WAAW,SAAS,EAAG,QAAO;AAEpD,MAAI;AACF,UAAM,EAAE,oBAAoB,IAAI,MAAM,OAAO,iCAAoB;AACjE,WAAQ,MAAM,oBAAoB,SAAS,KAAM;AAAA,EACnD,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AA0CA,eAAsB,eACpB,MACA,UACyC;AACzC,QAAM,EAAE,WAAW,QAAQ,YAAY,UAAU,YAAY,IAAI;AACjE,QAAM,aAAa,aAAa,KAAK,SAAS,YAAY,KAAK,QAAQ,UAAU,CAAC,IAAI;AACtF,QAAM,aACJ,cAAc,KAAK,aAAa,GAAG,UAAU,IAAI,KAAK,UAAU,KAAK,KAAK;AAE5E,QAAM,iBAA+B;AAAA,IACnC,YAAY,OAAO,WAAW;AAAA,IAC9B,MAAM;AAAA,IACN,OAAO,CAAC,EAAE,MAAM,YAAY,CAAC;AAAA,EAC/B;AAGA,QAAM,YAAY,QAAQ,IAAI,6BAA6B;AAE3D,QAAM,OAAO,UAAU,WAAW;AAAA,IAChC,WAAW,OAAO,WAAW;AAAA,IAC7B;AAAA,IACA;AAAA,IACA,iBAAiB;AAAA,MACf;AAAA,MACA,aAAa,cAAc;AAAA,MAC3B,eAAe,QAAQ,IAAI,iBAAiB,kBAAkB;AAAA,MAC9D,GAAI,QAAQ,IAAI,qBAAqB,EAAE,cAAc,QAAQ,IAAI,mBAAmB,IAAI,CAAC;AAAA,MACzF,UAAU,MAAM,cAAc,GAAG,YAAY,EAAE,WAAW;AAAA,MAC1D,GAAI,YAAY,EAAE,YAAY,UAAU,IAAI,CAAC;AAAA,MAC7C,GAAG;AAAA,IACL;AAAA,EACF,CAAC;AAED,QAAM,aAAa,cAAc;AACjC,SAAO,MAAM,OAAO,gBAAgB,KAAK,IAAI,YAAY;AACvD,cAAU,gBAAgB,KAAK,IAAI,SAAS;AAC5C,cAAU,UAAU,KAAK,IAAI,UAAU;AACvC,WAAO;AAAA,MACL,uBAAuB,KAAK,EAAE,oBAAoB,MAAM,cAAc,cAAc,GAAG,cAAc,UAAU;AAAA,IACjH;AAEA,UAAM,mBAAmB,6BAA6B,KAAK,aAAa,MAAM;AAC9E,UAAM,iBACJ,MAAM,cAAc,GAAG,YAAY,EAAE,WACpC,KAAK,UAAU;AAClB,QAAI,kBAAkB,CAAC,KAAK,UAAU,UAAU;AAC9C,UAAI;AACF,kBAAU,eAAe,KAAK,IAAI,EAAE,UAAU,eAAe,CAAC;AAAA,MAChE,QAAQ;AAAA,MAER;AAAA,IACF;AACA,UAAM,uBAAuB,MAAM,0BAA0B;AAAA,MAC3D,UAAU,kBAAmB,KAAK,UAAU;AAAA,MAC5C,YAAY,KAAK,UAAU;AAAA,IAC7B,CAAC;AACD,UAAM,oBACJ,oBAAoB,KAAK,aAAa,OAClC,IAAI,sBAAsB;AAAA,MACxB,QAAQ,KAAK;AAAA,MACb,aAAa;AAAA,MACb,UAAU,qBAAqB;AAAA,MAC/B,SAAS,qBAAqB;AAAA,MAC9B,gBAAgB,KAAK,aAAa,mBAAmB;AAAA,MACrD,MAAM,KAAK,YAAY;AAAA,MACvB,QAAQ;AAAA,MACR,mBAAmB,MAAM;AACvB,YAAI;AACJ,YAAI;AACF,oBAAU,UAAU,QAAQ,KAAK,EAAE;AAAA,QACrC,QAAQ;AACN,iBAAO;AAAA,YACL,UAAU,qBAAqB;AAAA,YAC/B,SAAS,qBAAqB;AAAA,UAChC;AAAA,QACF;AACA,eAAO;AAAA,UACL,UACG,SAAS,UAAU,YACnB,SAAS,UAAU,cACpB,qBAAqB;AAAA,UACvB,SAAS,SAAS,UAAU;AAAA,QAC9B;AAAA,MACF;AAAA,MACA,aAAa,SAAO;AAClB,YAAI;AACF,oBAAU,eAAe,KAAK,IAAI,GAAG;AAAA,QACvC,QAAQ;AAAA,QAER;AAAA,MACF;AAAA,MACA,eAAe,CAAC,MAAM,UAAU;AAC9B,YAAI;AACF,oBAAU,cAAc,KAAK,IAAI;AAAA,YAC/B,YAAY,OAAO,WAAW;AAAA,YAC9B,MAAM;AAAA,YACN,OAAO,CAAC,EAAE,KAAK,CAAC;AAAA,YAChB,UAAU,EAAE,MAAM,oBAAoB,OAAO,OAAO;AAAA,UACtD,CAAC;AAAA,QACH,QAAQ;AAAA,QAER;AAAA,MACF;AAAA,IACF,CAAC,IACD;AACN,QAAI,oBAAoB,CAAC,KAAK,aAAa,MAAM;AAC/C,aAAO;AAAA,QACL,kDAAkD,KAAK,EAAE,wCAAwC,MAAM;AAAA,MACzG;AAAA,IACF,WAAW,mBAAmB;AAC5B,aAAO,KAAK,gDAAgD,KAAK,EAAE,YAAY,MAAM,GAAG;AAAA,IAC1F;AAIA,UAAM,qBAAqB;AAC3B,UAAM,iBAAiB,YAAY,MAAM;AACvC,UAAI;AACF,kBAAU,UAAU,KAAK,EAAE;AAAA,MAC7B,QAAQ;AAAA,MAER;AAAA,IACF,GAAG,kBAAkB;AAErB,QAAI;AACF,UAAI,mBAAmB;AACrB,cAAM,kBAAkB,MAAM;AAAA,MAChC;AACA,YAAM,SAAS,MAAM,SAAS;AAK9B,UAAI;AACF,cAAM,gBAAgB,MAAM,cAAc,GAAG,YAAY,EAAE;AAC3D,cAAM,oBACH,iBAAiB,kBAAkB,KAAK,gBAAgB,WACxD,MAAM,4BAA4B,SAAS;AAC9C,YAAI,oBAAoB,CAAC,KAAK,UAAU,UAAU;AAChD,oBAAU,eAAe,KAAK,IAAI,EAAE,UAAU,iBAAiB,CAAC;AAAA,QAClE;AAAA,MACF,QAAQ;AAAA,MAER;AAMA,UAAI,eAAe;AACnB,UAAI;AACF,cAAM,UAAW,QAAgB,eAAe;AAGhD,YAAI,SAAS;AACX,gBAAM,UAAU,OAAO,OAAO,OAAO;AAErC,mBAAS,IAAI,QAAQ,SAAS,GAAG,KAAK,GAAG,KAAK;AAC5C,kBAAM,UAAU,QAAQ,CAAC;AACzB,gBAAI,CAAC,MAAM,QAAQ,OAAO,EAAG;AAE7B,qBAAS,IAAI,QAAQ,SAAS,GAAG,KAAK,GAAG,KAAK;AAC5C,oBAAM,OAAQ,QAAQ,CAAC,GAAW;AAClC,kBAAI,OAAO,SAAS,YAAY,KAAK,KAAK,EAAE,SAAS,GAAG;AACtD,+BAAe,KAAK,KAAK;AACzB;AAAA,cACF;AAAA,YACF;AACA,gBAAI,iBAAiB,sBAAuB;AAAA,UAC9C;AAAA,QACF;AAAA,MACF,QAAQ;AAAA,MAER;AAEA,YAAM,eAA6B;AAAA,QACjC,YAAY,OAAO,WAAW;AAAA,QAC9B,MAAM;AAAA,QACN,OAAO,CAAC,EAAE,MAAM,aAAa,CAAC;AAAA,MAChC;AACA,UAAI;AACF,kBAAU,gBAAgB,KAAK,IAAI,aAAa,YAAY;AAC5D,eAAO,KAAK,uBAAuB,KAAK,EAAE,YAAY;AAAA,MACxD,SAAS,UAAU;AAGjB,eAAO;AAAA,UACL,uBAAuB,KAAK,EAAE,2CAA2C,oBAAoB,QAAQ,SAAS,UAAU,QAAQ;AAAA,QAClI;AAAA,MACF;AAIA,UAAI,KAAK,gBAAgB,QAAQ,IAAI,wBAAwB,QAAQ;AACnE,2BAAmB,KAAK,IAAI,SAAS;AAAA,MACvC;AAEA,UAAI,mBAAmB;AACrB,cAAM,kBAAkB,SAAS,YAAY;AAAA,MAC/C;AAEA,aAAO,EAAE,MAAM,OAAO;AAAA,IACxB,SAAS,KAAK;AACZ,YAAM,YAAY,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;AACjE,YAAM,cAA4B;AAAA,QAChC,YAAY,OAAO,WAAW;AAAA,QAC9B,MAAM;AAAA,QACN,OAAO,CAAC,EAAE,MAAM,UAAU,CAAC;AAAA,MAC7B;AACA,UAAI;AACF,kBAAU,gBAAgB,KAAK,IAAI,UAAU,WAAW;AACxD,eAAO,KAAK,uBAAuB,KAAK,EAAE,YAAY,SAAS,EAAE;AAAA,MACnE,QAAQ;AAAA,MAER;AACA,UAAI,mBAAmB;AACrB,cAAM,kBAAkB,KAAK,aAAa,SAAS,EAAE;AAAA,MACvD;AACA,YAAM;AAAA,IACR,UAAE;AACA,oBAAc,cAAc;AAC5B,yBAAmB,KAAK;AAAA,IAC1B;AAAA,EACF,CAAC;AACH;AAMA,SAAS,mBAAmB,QAAgB,WAA4B;AAEtE,aAAW,YAAY;AACrB,UAAM,OAAO,gBAAgB,QAAQ,YAAY;AAC/C,UAAI;AACF,cAAM,EAAE,iBAAiB,IAAI,MAAM,OAAO,+BAAkB;AAC5D,cAAM,iBAAiB,QAAQ,SAAgB;AAC/C,eAAO,KAAK,sDAAsD,MAAM,EAAE;AAAA,MAC5E,SAAS,KAAK;AACZ,eAAO;AAAA,UACL,mDAAmD,MAAM,KAAK,eAAe,QAAQ,IAAI,UAAU,GAAG;AAAA,QACxG;AAAA,MACF;AAAA,IACF,CAAC;AAAA,EACH,GAAG,GAAI;AACT;AA1UA;AAAA;AAaA;AACA;AACA;AAIA;AAKA;AAAA;AAAA;","names":[]}