@probelabs/visor 0.1.186-ee → 0.1.187-ee

package/dist/sdk/{telegram-frontend-5UA77YAT.mjs → telegram-frontend-YQRYDKPN.mjs}

@@ -1,7 +1,7 @@
 import {
   init_task_live_updates,
   isFrontendLiveUpdatesEnabled
-} from "./chunk-SRU5TFNY.mjs";
+} from "./chunk-D6O5SCPC.mjs";
 import "./chunk-IY5PQ5EN.mjs";
 import "./chunk-6E625R3C.mjs";
 import "./chunk-B2OUZAWY.mjs";
@@ -583,4 +583,4 @@ init_telegram_frontend();
 export {
   TelegramFrontend
 };
-//# sourceMappingURL=telegram-frontend-5UA77YAT.mjs.map
+//# sourceMappingURL=telegram-frontend-YQRYDKPN.mjs.map

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

@@ -0,0 +1,31 @@
+import {
+  __getOrCreateNdjsonPath,
+  _appendRunMarker,
+  addEvent,
+  emitImmediateSpan,
+  getTracer,
+  getVisorRunAttributes,
+  init_trace_helpers,
+  setSpanAttributes,
+  setSpanError,
+  withActiveSpan,
+  withVisorRun
+} from "./chunk-ZCBVXBKG.mjs";
+import "./chunk-6LQEODDA.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-AM2QE5UZ.mjs.map

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

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

package/dist/sdk/trace-serializer-4TOIAVQL.mjs

@@ -0,0 +1,32 @@
+import {
+  buildTraceHeaderLines,
+  buildTraceReport,
+  extractProbeTaskSummary,
+  fetchTraceSpans,
+  findTraceFile,
+  init_trace_serializer,
+  readTraceIdFromFile,
+  renderSpanTree,
+  renderSpanYaml,
+  renderTraceTree,
+  resolveTraceSpans,
+  serializeTraceForPrompt
+} from "./chunk-BVEATT5V.mjs";
+import "./chunk-6E625R3C.mjs";
+import "./chunk-B2OUZAWY.mjs";
+import "./chunk-J7LXIPZS.mjs";
+init_trace_serializer();
+export {
+  buildTraceHeaderLines,
+  buildTraceReport,
+  extractProbeTaskSummary,
+  fetchTraceSpans,
+  findTraceFile,
+  readTraceIdFromFile,
+  renderSpanTree,
+  renderSpanYaml,
+  renderTraceTree,
+  resolveTraceSpans,
+  serializeTraceForPrompt
+};
+//# sourceMappingURL=trace-serializer-4TOIAVQL.mjs.map

package/dist/sdk/trace-serializer-4TOIAVQL.mjs.map

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

package/dist/sdk/{track-execution-3CHMGEPH.mjs → track-execution-BULXL2XD.mjs}

@@ -2,7 +2,7 @@ import {
   TaskLiveUpdateManager,
   init_task_live_updates,
   resolveTaskLiveUpdatesConfig
-} from "./chunk-SRU5TFNY.mjs";
+} from "./chunk-D6O5SCPC.mjs";
 import "./chunk-IY5PQ5EN.mjs";
 import {
   init_task_trace_resolution,
@@ -246,4 +246,4 @@ init_track_execution();
 export {
   trackExecution
 };
-//# sourceMappingURL=track-execution-3CHMGEPH.mjs.map
+//# sourceMappingURL=track-execution-BULXL2XD.mjs.map

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

@@ -0,0 +1,320 @@
+import {
+  TaskLiveUpdateManager,
+  init_task_live_updates,
+  resolveTaskLiveUpdatesConfig
+} from "./chunk-YU3VR5SZ.mjs";
+import "./chunk-BVEATT5V.mjs";
+import {
+  init_task_trace_resolution,
+  resolveTaskTraceReference
+} from "./chunk-2LLKENYD.mjs";
+import {
+  init_user_facing_error,
+  summarizeUserFacingIssues
+} from "./chunk-TL3ZTYFY.mjs";
+import {
+  getInstanceId,
+  init_instance_id,
+  require_package
+} from "./chunk-6LQEODDA.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 unwrapJsonText(text) {
+  if (text.startsWith("{") && text.includes('"text"')) {
+    try {
+      const parsed = JSON.parse(text);
+      if (typeof parsed?.text === "string" && parsed.text.trim().length > 0) {
+        return parsed.text.trim();
+      }
+    } catch {
+      try {
+        const sanitized = text.replace(
+          /[\x00-\x1F\x7F]/g,
+          (ch) => "\\u" + ch.charCodeAt(0).toString(16).padStart(4, "0")
+        );
+        const parsed = JSON.parse(sanitized);
+        if (typeof parsed?.text === "string" && parsed.text.trim().length > 0) {
+          return parsed.text.trim();
+        }
+      } catch {
+      }
+    }
+  }
+  return text;
+}
+function isToolOutput(text) {
+  if (/^[├│└─┬┘┤┼]{1,3}/.test(text)) return true;
+  if (text.startsWith("[task:")) return true;
+  return false;
+}
+function extractTextFromEntries(entries) {
+  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) {
+        return unwrapJsonText(text.trim());
+      }
+    }
+  }
+  return void 0;
+}
+function extractBestResponseText(history, allKeys) {
+  const topLevelEntries = Object.entries(history).filter(([key]) => !key.includes(".")).map(([, v]) => v);
+  const topLevelText = extractTextFromEntries(topLevelEntries);
+  if (topLevelText && !isToolOutput(topLevelText)) {
+    logger.info(
+      `[TaskTracking] Extracted responseText (${topLevelText.length} chars): "${topLevelText.substring(0, 100)}..."`
+    );
+    return topLevelText;
+  }
+  const genResponseKeys = allKeys.filter(
+    (k) => k.endsWith(".generate-response") || k === "generate-response"
+  );
+  if (genResponseKeys.length > 0) {
+    const genEntries = genResponseKeys.map((k) => history[k]);
+    const genText = extractTextFromEntries(genEntries);
+    if (genText && !isToolOutput(genText)) {
+      logger.info(
+        `[TaskTracking] Fallback to generate-response entry (${genText.length} chars): "${genText.substring(0, 100)}..."`
+      );
+      return genText;
+    }
+  }
+  if (topLevelText) {
+    logger.warn(
+      `[TaskTracking] Using tool output as responseText (${topLevelText.length} chars) \u2014 no better candidate found`
+    );
+    return topLevelText;
+  }
+  return "Execution completed";
+}
+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-4TOIAVQL.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_file || current?.metadata?.trace_id || 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 allKeys = Object.keys(history);
+          responseText = extractBestResponseText(history, allKeys);
+        }
+        if (responseText === "Execution completed") {
+          const issueSummary = summarizeUserFacingIssues(result?.reviewSummary?.issues);
+          if (issueSummary) {
+            responseText = issueSummary;
+          }
+        }
+      } 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-4QG4CYQA.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_user_facing_error();
+  }
+});
+init_track_execution();
+export {
+  trackExecution
+};
+//# sourceMappingURL=track-execution-VJJVJH6K.mjs.map

package/dist/sdk/track-execution-VJJVJH6K.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';\nimport { summarizeUserFacingIssues } from '../utils/user-facing-error';\n\n/**\n * If `text` looks like a JSON object with a `.text` field, extract it.\n * Handles the edge case where the AI double-wraps its response as\n * `{\"text\":\"actual content\"}` instead of returning the string directly.\n */\nfunction unwrapJsonText(text: string): string {\n  if (text.startsWith('{') && text.includes('\"text\"')) {\n    try {\n      const parsed = JSON.parse(text);\n      if (typeof parsed?.text === 'string' && parsed.text.trim().length > 0) {\n        return parsed.text.trim();\n      }\n    } catch {\n      // JSON.parse fails when the string contains unescaped control characters\n      // (newlines, tabs) inside JSON string values — common with markdown content.\n      // Escape them and retry.\n      try {\n        const sanitized = text.replace(\n          /[\\x00-\\x1F\\x7F]/g,\n          ch => '\\\\u' + ch.charCodeAt(0).toString(16).padStart(4, '0')\n        );\n        const parsed = JSON.parse(sanitized);\n        if (typeof parsed?.text === 'string' && parsed.text.trim().length > 0) {\n          return parsed.text.trim();\n        }\n      } catch {\n        // genuine malformed JSON — give up\n      }\n    }\n  }\n  return text;\n}\n\n/**\n * Detect text that is ProbeAgent tool/task management output rather than\n * the AI's actual response. This output leaks into .text when answer()\n * concatenates tool output with the response.\n */\nfunction isToolOutput(text: string): boolean {\n  // ProbeAgent task tool tree output (├─┬, │, └─)\n  if (/^[├│└─┬┘┤┼]{1,3}/.test(text)) return true;\n  // Task tool markers\n  if (text.startsWith('[task:')) return true;\n  return false;\n}\n\n/**\n * Extract the last .text from a set of history entries (array of output arrays).\n * Returns undefined if no text found.\n */\nfunction extractTextFromEntries(entries: unknown[][]): string | undefined {\n  for (let i = entries.length - 1; i >= 0; i--) {\n    const outputs = entries[i];\n    if (!Array.isArray(outputs)) continue;\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        return unwrapJsonText(text.trim());\n      }\n    }\n  }\n  return undefined;\n}\n\n/**\n * Multi-pass extraction: prefer top-level entries, but fall back to\n * generate-response entries if the top-level text is tool output.\n */\nfunction extractBestResponseText(history: Record<string, unknown[]>, allKeys: string[]): string {\n  // Pass 1: top-level entries (no dots) — the workflow's computed output\n  const topLevelEntries = Object.entries(history)\n    .filter(([key]) => !key.includes('.'))\n    .map(([, v]) => v);\n  const topLevelText = extractTextFromEntries(topLevelEntries);\n\n  if (topLevelText && !isToolOutput(topLevelText)) {\n    logger.info(\n      `[TaskTracking] Extracted responseText (${topLevelText.length} chars): \"${topLevelText.substring(0, 100)}...\"`\n    );\n    return topLevelText;\n  }\n\n  // Pass 2: look for generate-response entries specifically — the AI step\n  // that produces the final user-facing response in assistant workflows.\n  const genResponseKeys = allKeys.filter(\n    k => k.endsWith('.generate-response') || k === 'generate-response'\n  );\n  if (genResponseKeys.length > 0) {\n    const genEntries = genResponseKeys.map(k => history[k]);\n    const genText = extractTextFromEntries(genEntries);\n    if (genText && !isToolOutput(genText)) {\n      logger.info(\n        `[TaskTracking] Fallback to generate-response entry (${genText.length} chars): \"${genText.substring(0, 100)}...\"`\n      );\n      return genText;\n    }\n  }\n\n  // Pass 3: if top-level text exists but was tool output, use it anyway\n  // as a last resort — better than \"Execution completed\"\n  if (topLevelText) {\n    logger.warn(\n      `[TaskTracking] Using tool output as responseText (${topLevelText.length} chars) — no better candidate found`\n    );\n    return topLevelText;\n  }\n\n  return 'Execution completed';\n}\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_file as string | undefined) ||\n                  (current?.metadata?.trace_id 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 response text via multi-pass extraction.\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 allKeys = Object.keys(history);\n          responseText = extractBestResponseText(history, allKeys);\n        }\n        if (responseText === 'Execution completed') {\n          const issueSummary = summarizeUserFacingIssues((result as any)?.reviewSummary?.issues);\n          if (issueSummary) {\n            responseText = issueSummary;\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":"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","names":[]}

package/dist/sdk/utcp-check-provider-WDTSQ7DZ.mjs

@@ -0,0 +1,17 @@
+import {
+  UtcpCheckProvider,
+  init_utcp_check_provider
+} from "./chunk-HW4MPCOW.mjs";
+import "./chunk-7QI6F66G.mjs";
+import "./chunk-4HIWZA6M.mjs";
+import "./chunk-25IC7KXZ.mjs";
+import "./chunk-LW3INISN.mjs";
+import "./chunk-4MHHELVZ.mjs";
+import "./chunk-6E625R3C.mjs";
+import "./chunk-B2OUZAWY.mjs";
+import "./chunk-J7LXIPZS.mjs";
+init_utcp_check_provider();
+export {
+  UtcpCheckProvider
+};
+//# sourceMappingURL=utcp-check-provider-WDTSQ7DZ.mjs.map

package/dist/sdk/utcp-check-provider-WDTSQ7DZ.mjs.map

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