@lark-apaas/devtool-kits 1.2.10 → 1.2.11-alpha.1

package/dist/index.cjs

@@ -1506,7 +1506,7 @@ function sendSimpleRedirect(req, res) {
 __name(sendSimpleRedirect, "sendSimpleRedirect");
 
 // src/middlewares/index.ts
-var import_node_path9 = __toESM(require("path"), 1);
+var import_node_path10 = __toESM(require("path"), 1);
 
 // src/middlewares/openapi/router.ts
 var import_express = __toESM(require("express"), 1);
@@ -1949,10 +1949,194 @@ function serializeError(error) {
 __name(serializeError, "serializeError");
 
 // src/middlewares/dev-logs/controller.ts
-var import_node_path7 = require("path");
+var import_node_path8 = require("path");
 
-// src/middlewares/dev-logs/services.ts
+// src/middlewares/dev-logs/services/file-reader.ts
 var import_node_fs7 = require("fs");
+async function readFileReverse(filePath, chunkSize, processLine) {
+  const handle = await import_node_fs7.promises.open(filePath, "r");
+  try {
+    const stats = await handle.stat();
+    let position = stats.size;
+    let remainder = "";
+    while (position > 0) {
+      const length = Math.min(chunkSize, position);
+      position -= length;
+      const buffer = Buffer.alloc(length);
+      await handle.read(buffer, 0, length, position);
+      let chunk = buffer.toString("utf8");
+      if (remainder) {
+        chunk += remainder;
+        remainder = "";
+      }
+      const lines = chunk.split("\n");
+      remainder = lines.shift() ?? "";
+      for (let i = lines.length - 1; i >= 0; i -= 1) {
+        if (lines[i]) {
+          processLine(lines[i]);
+        }
+      }
+    }
+    if (remainder) {
+      processLine(remainder);
+    }
+  } finally {
+    await handle.close();
+  }
+}
+__name(readFileReverse, "readFileReverse");
+function buildPaginatedResponse(items, page, pageSize) {
+  const totalItems = items.length;
+  const totalPages = totalItems === 0 ? 0 : Math.ceil(totalItems / pageSize);
+  const startIndex = (page - 1) * pageSize;
+  const endIndex = Math.min(startIndex + pageSize, totalItems);
+  const pagedItems = items.slice(startIndex, endIndex).map((builder) => ({
+    traceId: builder.traceId,
+    method: builder.method,
+    path: builder.path,
+    startTime: builder.startTime,
+    endTime: builder.endTime,
+    statusCode: builder.statusCode,
+    durationMs: builder.durationMs,
+    entries: builder.entries.slice().reverse()
+  }));
+  return {
+    page,
+    pageSize,
+    totalCalls: totalItems,
+    totalPages,
+    calls: pagedItems
+  };
+}
+__name(buildPaginatedResponse, "buildPaginatedResponse");
+
+// src/middlewares/dev-logs/services/parsers.ts
+function generateUUID() {
+  return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
+    const r = Math.random() * 16 | 0;
+    const v = c === "x" ? r : r & 3 | 8;
+    return v.toString(16);
+  });
+}
+__name(generateUUID, "generateUUID");
+function mapPinoLevelToServerLogLevel(pinoLevel) {
+  if (typeof pinoLevel === "string") {
+    const lower = pinoLevel.toLowerCase();
+    if (lower === "fatal") return "fatal";
+    if (lower === "error") return "error";
+    if (lower === "warn" || lower === "warning") return "warn";
+    if (lower === "info" || lower === "log") return "log";
+    if (lower === "debug") return "debug";
+    if (lower === "trace" || lower === "verbose") return "verbose";
+    return "log";
+  }
+  if (pinoLevel >= 60) return "fatal";
+  if (pinoLevel >= 50) return "error";
+  if (pinoLevel >= 40) return "warn";
+  if (pinoLevel >= 30) return "log";
+  if (pinoLevel >= 20) return "debug";
+  return "verbose";
+}
+__name(mapPinoLevelToServerLogLevel, "mapPinoLevelToServerLogLevel");
+function extractLogLevel(text) {
+  const lower = text.toLowerCase();
+  if (lower.includes("fatal") || lower.includes("critical")) return "fatal";
+  if (lower.includes("error") || lower.includes("<e>") || lower.includes("\u2716")) return "error";
+  if (lower.includes("warn") || lower.includes("warning") || lower.includes("<w>") || lower.includes("\u26A0")) return "warn";
+  if (lower.includes("debug") || lower.includes("<d>")) return "debug";
+  if (lower.includes("verbose") || lower.includes("trace")) return "verbose";
+  return "log";
+}
+__name(extractLogLevel, "extractLogLevel");
+function parsePinoLog(line, source) {
+  try {
+    const pinoLog = JSON.parse(line);
+    const id = generateUUID();
+    return {
+      id,
+      level: mapPinoLevelToServerLogLevel(pinoLog.level),
+      timestamp: new Date(pinoLog.time).getTime(),
+      message: pinoLog.message || pinoLog.msg || "",
+      context: pinoLog.context || null,
+      traceId: pinoLog.trace_id || null,
+      userId: pinoLog.user_id || null,
+      appId: pinoLog.app_id || null,
+      tenantId: pinoLog.tenant_id || null,
+      stack: pinoLog.stack || null,
+      meta: {
+        pid: pinoLog.pid,
+        hostname: pinoLog.hostname,
+        path: pinoLog.path,
+        method: pinoLog.method,
+        statusCode: pinoLog.status_code,
+        durationMs: pinoLog.duration_ms,
+        ip: pinoLog.ip,
+        requestBody: pinoLog.request_body,
+        responseBody: pinoLog.response_body
+      },
+      tags: [
+        source
+      ]
+    };
+  } catch (error) {
+    return null;
+  }
+}
+__name(parsePinoLog, "parsePinoLog");
+function parseStdLog(line, source) {
+  const id = generateUUID();
+  const match = line.match(/^\[(\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2})\] \[(server|client)\] (.*)$/);
+  if (!match) {
+    return {
+      id,
+      level: "log",
+      timestamp: Date.now(),
+      message: line,
+      context: null,
+      traceId: null,
+      userId: null,
+      appId: null,
+      tenantId: null,
+      stack: null,
+      meta: null,
+      tags: [
+        source
+      ]
+    };
+  }
+  const [, timeStr, , content] = match;
+  let timestamp;
+  try {
+    const isoStr = timeStr.replace(" ", "T");
+    timestamp = new Date(isoStr).getTime();
+    if (isNaN(timestamp)) {
+      timestamp = Date.now();
+    }
+  } catch (error) {
+    timestamp = Date.now();
+  }
+  const level = extractLogLevel(content);
+  return {
+    id,
+    level,
+    timestamp,
+    message: content,
+    context: null,
+    traceId: null,
+    userId: null,
+    appId: null,
+    tenantId: null,
+    stack: null,
+    meta: null,
+    tags: [
+      source
+    ]
+  };
+}
+__name(parseStdLog, "parseStdLog");
+
+// src/middlewares/dev-logs/services/trace.service.ts
+var import_node_fs8 = require("fs");
 var import_node_readline = require("readline");
 async function readLogEntriesByTrace(filePath, traceId, limit) {
   const exists = await fileExists(filePath);
@@ -1960,7 +2144,7 @@ async function readLogEntriesByTrace(filePath, traceId, limit) {
     return void 0;
   }
   const matches = [];
-  const stream = (0, import_node_fs7.createReadStream)(filePath, {
+  const stream = (0, import_node_fs8.createReadStream)(filePath, {
     encoding: "utf8"
   });
   const rl = (0, import_node_readline.createInterface)({
@@ -2051,62 +2235,6 @@ async function readRecentTraceCalls(filePath, page, pageSize, pathFilter, method
   return buildPaginatedResponse(completedCalls, page, pageSize);
 }
 __name(readRecentTraceCalls, "readRecentTraceCalls");
-async function readFileReverse(filePath, chunkSize, processLine) {
-  const handle = await import_node_fs7.promises.open(filePath, "r");
-  try {
-    const stats = await handle.stat();
-    let position = stats.size;
-    let remainder = "";
-    while (position > 0) {
-      const length = Math.min(chunkSize, position);
-      position -= length;
-      const buffer = Buffer.alloc(length);
-      await handle.read(buffer, 0, length, position);
-      let chunk = buffer.toString("utf8");
-      if (remainder) {
-        chunk += remainder;
-        remainder = "";
-      }
-      const lines = chunk.split("\n");
-      remainder = lines.shift() ?? "";
-      for (let i = lines.length - 1; i >= 0; i -= 1) {
-        if (lines[i]) {
-          processLine(lines[i]);
-        }
-      }
-    }
-    if (remainder) {
-      processLine(remainder);
-    }
-  } finally {
-    await handle.close();
-  }
-}
-__name(readFileReverse, "readFileReverse");
-function buildPaginatedResponse(items, page, pageSize) {
-  const totalItems = items.length;
-  const totalPages = totalItems === 0 ? 0 : Math.ceil(totalItems / pageSize);
-  const startIndex = (page - 1) * pageSize;
-  const endIndex = Math.min(startIndex + pageSize, totalItems);
-  const pagedItems = items.slice(startIndex, endIndex).map((builder) => ({
-    traceId: builder.traceId,
-    method: builder.method,
-    path: builder.path,
-    startTime: builder.startTime,
-    endTime: builder.endTime,
-    statusCode: builder.statusCode,
-    durationMs: builder.durationMs,
-    entries: builder.entries.slice().reverse()
-  }));
-  return {
-    page,
-    pageSize,
-    totalCalls: totalItems,
-    totalPages,
-    calls: pagedItems
-  };
-}
-__name(buildPaginatedResponse, "buildPaginatedResponse");
 async function readLogFilePage(filePath, page, pageSize) {
   if (!await fileExists(filePath)) {
     return void 0;
@@ -2114,7 +2242,7 @@ async function readLogFilePage(filePath, page, pageSize) {
   const capacity = page * pageSize;
   const buffer = [];
   let totalLines = 0;
-  const stream = (0, import_node_fs7.createReadStream)(filePath, {
+  const stream = (0, import_node_fs8.createReadStream)(filePath, {
     encoding: "utf8"
   });
   const rl = (0, import_node_readline.createInterface)({
@@ -2162,6 +2290,11 @@ async function readLogFilePage(filePath, page, pageSize) {
   };
 }
 __name(readLogFilePage, "readLogFilePage");
+
+// src/middlewares/dev-logs/services/server-log.service.ts
+var import_node_fs9 = require("fs");
+var import_node_readline2 = require("readline");
+var import_node_path7 = require("path");
 async function readServerLogs(logDir, options = {}) {
   const limit = options.limit || 100;
   const offset = options.offset || 0;
@@ -2204,20 +2337,19 @@ async function readServerLogs(logDir, options = {}) {
 }
 __name(readServerLogs, "readServerLogs");
 async function readLogsBySource(logDir, source) {
-  const { join: join6 } = await import("path");
   let filePath;
   let parser;
   if (source === "server") {
-    filePath = join6(logDir, "server.log");
+    filePath = (0, import_node_path7.join)(logDir, "server.log");
     parser = /* @__PURE__ */ __name((line) => parsePinoLog(line, "server"), "parser");
   } else if (source === "trace") {
-    filePath = join6(logDir, "trace.log");
+    filePath = (0, import_node_path7.join)(logDir, "trace.log");
     parser = /* @__PURE__ */ __name((line) => parsePinoLog(line, "trace"), "parser");
   } else if (source === "server-std") {
-    filePath = join6(logDir, "server.std.log");
+    filePath = (0, import_node_path7.join)(logDir, "server.std.log");
     parser = /* @__PURE__ */ __name((line) => parseStdLog(line, "server-std"), "parser");
   } else if (source === "client-std") {
-    filePath = join6(logDir, "client.std.log");
+    filePath = (0, import_node_path7.join)(logDir, "client.std.log");
     parser = /* @__PURE__ */ __name((line) => parseStdLog(line, "client-std"), "parser");
   } else {
     console.warn(`[readLogsBySource] Unknown source: ${source}`);
@@ -2231,10 +2363,10 @@ async function readLogsBySource(logDir, source) {
   let stream = null;
   let rl = null;
   try {
-    stream = (0, import_node_fs7.createReadStream)(filePath, {
+    stream = (0, import_node_fs9.createReadStream)(filePath, {
       encoding: "utf8"
     });
-    rl = (0, import_node_readline.createInterface)({
+    rl = (0, import_node_readline2.createInterface)({
       input: stream,
       crlfDelay: Infinity
     });
@@ -2262,129 +2394,10 @@ async function readLogsBySource(logDir, source) {
   return logs;
 }
 __name(readLogsBySource, "readLogsBySource");
-function parsePinoLog(line, source) {
-  try {
-    const pinoLog = JSON.parse(line);
-    const id = generateUUID();
-    return {
-      id,
-      level: mapPinoLevelToServerLogLevel(pinoLog.level),
-      timestamp: new Date(pinoLog.time).getTime(),
-      message: pinoLog.message || pinoLog.msg || "",
-      context: pinoLog.context || null,
-      traceId: pinoLog.trace_id || null,
-      userId: pinoLog.user_id || null,
-      appId: pinoLog.app_id || null,
-      tenantId: pinoLog.tenant_id || null,
-      stack: pinoLog.stack || null,
-      meta: {
-        pid: pinoLog.pid,
-        hostname: pinoLog.hostname,
-        path: pinoLog.path,
-        method: pinoLog.method,
-        statusCode: pinoLog.status_code,
-        durationMs: pinoLog.duration_ms,
-        ip: pinoLog.ip,
-        requestBody: pinoLog.request_body,
-        responseBody: pinoLog.response_body
-      },
-      tags: [
-        source
-      ]
-    };
-  } catch (error) {
-    return null;
-  }
-}
-__name(parsePinoLog, "parsePinoLog");
-function parseStdLog(line, source) {
-  const id = generateUUID();
-  const match = line.match(/^\[(\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2})\] \[(server|client)\] (.*)$/);
-  if (!match) {
-    return {
-      id,
-      level: "log",
-      timestamp: Date.now(),
-      message: line,
-      context: null,
-      traceId: null,
-      userId: null,
-      appId: null,
-      tenantId: null,
-      stack: null,
-      meta: null,
-      tags: [
-        source
-      ]
-    };
-  }
-  const [, timeStr, , content] = match;
-  let timestamp;
-  try {
-    const isoStr = timeStr.replace(" ", "T");
-    timestamp = new Date(isoStr).getTime();
-    if (isNaN(timestamp)) {
-      timestamp = Date.now();
-    }
-  } catch (error) {
-    timestamp = Date.now();
-  }
-  const level = extractLogLevel(content);
-  return {
-    id,
-    level,
-    timestamp,
-    message: content,
-    context: null,
-    traceId: null,
-    userId: null,
-    appId: null,
-    tenantId: null,
-    stack: null,
-    meta: null,
-    tags: [
-      source
-    ]
-  };
-}
-__name(parseStdLog, "parseStdLog");
-function mapPinoLevelToServerLogLevel(pinoLevel) {
-  if (typeof pinoLevel === "string") {
-    const lower = pinoLevel.toLowerCase();
-    if (lower === "fatal") return "fatal";
-    if (lower === "error") return "error";
-    if (lower === "warn" || lower === "warning") return "warn";
-    if (lower === "info" || lower === "log") return "log";
-    if (lower === "debug") return "debug";
-    if (lower === "trace" || lower === "verbose") return "verbose";
-    return "log";
-  }
-  if (pinoLevel >= 60) return "fatal";
-  if (pinoLevel >= 50) return "error";
-  if (pinoLevel >= 40) return "warn";
-  if (pinoLevel >= 30) return "log";
-  if (pinoLevel >= 20) return "debug";
-  return "verbose";
-}
-__name(mapPinoLevelToServerLogLevel, "mapPinoLevelToServerLogLevel");
-function extractLogLevel(text) {
-  const lower = text.toLowerCase();
-  if (lower.includes("fatal") || lower.includes("critical")) return "fatal";
-  if (lower.includes("error") || lower.includes("<e>") || lower.includes("\u2716")) return "error";
-  if (lower.includes("warn") || lower.includes("warning") || lower.includes("<w>") || lower.includes("\u26A0")) return "warn";
-  if (lower.includes("debug") || lower.includes("<d>")) return "debug";
-  if (lower.includes("verbose") || lower.includes("trace")) return "verbose";
-  return "log";
-}
-__name(extractLogLevel, "extractLogLevel");
-function generateUUID() {
-  return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
-    const r = Math.random() * 16 | 0;
-    const v = c === "x" ? r : r & 3 | 8;
-    return v.toString(16);
-  });
-}
-__name(generateUUID, "generateUUID");
+
+// src/middlewares/dev-logs/services/trigger.service.ts
+var import_node_fs10 = require("fs");
+var import_node_readline3 = require("readline");
 async function readTriggerList(filePath, trigger, path7, limit, triggerID) {
   if (!await fileExists(filePath)) {
     return void 0;
@@ -2500,10 +2513,10 @@ async function readTriggerDetail(filePath, path7, instanceID) {
     return void 0;
   }
   const matches = [];
-  const stream = (0, import_node_fs7.createReadStream)(filePath, {
+  const stream = (0, import_node_fs10.createReadStream)(filePath, {
     encoding: "utf8"
   });
-  const rl = (0, import_node_readline.createInterface)({
+  const rl = (0, import_node_readline3.createInterface)({
     input: stream,
     crlfDelay: Infinity
   });
@@ -2524,6 +2537,118 @@ async function readTriggerDetail(filePath, path7, instanceID) {
 }
 __name(readTriggerDetail, "readTriggerDetail");
 
+// src/middlewares/dev-logs/services/capability.service.ts
+async function readCapabilityTraceList(filePath, capabilityId, limit) {
+  if (!await fileExists(filePath)) {
+    return void 0;
+  }
+  const config = {
+    chunkSize: 64 * 1024
+  };
+  const builders = /* @__PURE__ */ new Map();
+  const completedTraces = [];
+  const createCapabilityTraceBuilder = /* @__PURE__ */ __name((traceId, capId) => ({
+    traceId,
+    capabilityId: capId,
+    hasCompleted: false,
+    hasStartEntry: false
+  }), "createCapabilityTraceBuilder");
+  const shouldIncludeInCompletedTraces = /* @__PURE__ */ __name((builder) => {
+    const alreadyAdded = completedTraces.some((trace) => trace.traceId === builder.traceId);
+    if (alreadyAdded) {
+      return false;
+    }
+    return builder.capabilityId === capabilityId;
+  }, "shouldIncludeInCompletedTraces");
+  const updateBuilderMetadata = /* @__PURE__ */ __name((builder, entry) => {
+    if (entry.plugin_key && !builder.pluginKey) {
+      builder.pluginKey = String(entry.plugin_key);
+    }
+    if (entry.action && !builder.action) {
+      builder.action = String(entry.action);
+    }
+    const message = entry.message || "";
+    if (message.includes("Executing capability") && !builder.hasStartEntry) {
+      builder.hasStartEntry = true;
+      builder.startTime = entry.time;
+      if (entry.input) {
+        builder.input = String(entry.input);
+      }
+    }
+    if (message.includes("executed successfully")) {
+      builder.hasCompleted = true;
+      builder.endTime = entry.time;
+      builder.status = "success";
+      if (entry.output) {
+        builder.output = String(entry.output);
+      }
+      if (entry.duration_ms) {
+        builder.durationMs = Number(entry.duration_ms);
+      }
+      if (shouldIncludeInCompletedTraces(builder)) {
+        completedTraces.push(builder);
+      }
+    }
+    if (message.includes("execution failed")) {
+      builder.hasCompleted = true;
+      builder.endTime = entry.time;
+      builder.status = "failed";
+      if (entry.error) {
+        builder.error = {
+          message: String(entry.error)
+        };
+      }
+      if (entry.duration_ms) {
+        builder.durationMs = Number(entry.duration_ms);
+      }
+      if (shouldIncludeInCompletedTraces(builder)) {
+        completedTraces.push(builder);
+      }
+    }
+  }, "updateBuilderMetadata");
+  const processLogEntry = /* @__PURE__ */ __name((entry) => {
+    const { trace_id: traceId, capability_id: capId } = entry;
+    if (!traceId || !capId || capId !== capabilityId) return;
+    let builder = builders.get(traceId);
+    if (!builder) {
+      builder = createCapabilityTraceBuilder(traceId, capId);
+      builders.set(traceId, builder);
+    }
+    updateBuilderMetadata(builder, entry);
+  }, "processLogEntry");
+  const processLine = /* @__PURE__ */ __name((line) => {
+    const entry = parseLogLine2(line);
+    if (entry?.capability_id) {
+      processLogEntry(entry);
+    }
+  }, "processLine");
+  await readFileReverse(filePath, config.chunkSize, processLine);
+  completedTraces.sort((a, b) => {
+    const timeA = a.endTime ? new Date(a.endTime).getTime() : 0;
+    const timeB = b.endTime ? new Date(b.endTime).getTime() : 0;
+    return timeB - timeA;
+  });
+  const limitedTraces = limit ? completedTraces.slice(0, limit) : completedTraces;
+  return {
+    capabilityId,
+    totalTraces: limitedTraces.length,
+    traces: limitedTraces.map((builder) => ({
+      traceId: builder.traceId,
+      capabilityId: builder.capabilityId,
+      pluginKey: builder.pluginKey,
+      action: builder.action,
+      startTime: builder.startTime,
+      endTime: builder.endTime,
+      durationMs: builder.durationMs,
+      status: builder.status || "failed",
+      input: builder.input,
+      output: builder.output,
+      error: builder.error
+    }))
+  };
+}
+__name(readCapabilityTraceList, "readCapabilityTraceList");
+
 // src/middlewares/dev-logs/controller.ts
 function handleNotFound(res, filePath, message = "Log file not found") {
   res.status(404).json({
@@ -2539,7 +2664,7 @@ function handleError(res, error, message = "Failed to read log file") {
 }
 __name(handleError, "handleError");
 function createGetTraceEntriesHandler(logDir) {
-  const appLogPath = (0, import_node_path7.join)(logDir, "server.log");
+  const appLogPath = (0, import_node_path8.join)(logDir, "server.log");
   return async (req, res) => {
     const traceId = (req.params.traceId || "").trim();
     if (!traceId) {
@@ -2566,7 +2691,7 @@ function createGetTraceEntriesHandler(logDir) {
 }
 __name(createGetTraceEntriesHandler, "createGetTraceEntriesHandler");
 function createGetRecentTracesHandler(logDir) {
-  const traceLogPath = (0, import_node_path7.join)(logDir, "trace.log");
+  const traceLogPath = (0, import_node_path8.join)(logDir, "trace.log");
   return async (req, res) => {
     const page = parsePositiveInt(req.query.page, 1);
     const pageSize = parseLimit(req.query.pageSize, 10, 100);
@@ -2643,7 +2768,7 @@ function createGetServerLogsHandler(logDir) {
 }
 __name(createGetServerLogsHandler, "createGetServerLogsHandler");
 function createGetTriggerListHandler(logDir) {
-  const traceLogPath = (0, import_node_path7.join)(logDir, "trace.log");
+  const traceLogPath = (0, import_node_path8.join)(logDir, "trace.log");
   return async (req, res) => {
     const trigger = typeof req.query.trigger === "string" ? req.query.trigger.trim() : void 0;
     if (!trigger) {
@@ -2671,7 +2796,7 @@ function createGetTriggerListHandler(logDir) {
 }
 __name(createGetTriggerListHandler, "createGetTriggerListHandler");
 function createGetTriggerDetailHandler(logDir) {
-  const traceLogPath = (0, import_node_path7.join)(logDir, "server.log");
+  const traceLogPath = (0, import_node_path8.join)(logDir, "server.log");
   return async (req, res) => {
     const instanceID = (req.params.instanceID || "").trim();
     if (!instanceID) {
@@ -2695,6 +2820,31 @@ function createGetTriggerDetailHandler(logDir) {
   };
 }
 __name(createGetTriggerDetailHandler, "createGetTriggerDetailHandler");
+function createGetCapabilityTraceListHandler(logDir) {
+  const serverLogPath = (0, import_node_path8.join)(logDir, "server.log");
+  return async (req, res) => {
+    const capabilityId = typeof req.query.capability_id === "string" ? req.query.capability_id.trim() : void 0;
+    if (!capabilityId) {
+      return res.status(400).json({
+        message: "capability_id is required"
+      });
+    }
+    const limit = parseLimit(req.query.limit, 10, 200);
+    try {
+      const result = await readCapabilityTraceList(serverLogPath, capabilityId, limit);
+      if (!result) {
+        return handleNotFound(res, serverLogPath);
+      }
+      res.json({
+        file: getRelativePath(serverLogPath),
+        ...result
+      });
+    } catch (error) {
+      handleError(res, error, "Failed to read server log");
+    }
+  };
+}
+__name(createGetCapabilityTraceListHandler, "createGetCapabilityTraceListHandler");
 
 // src/middlewares/dev-logs/health.controller.ts
 var import_node_http2 = __toESM(require("http"), 1);
@@ -2773,6 +2923,7 @@ function createDevLogRouter(options = {}) {
   router.get("/server-logs", createGetServerLogsHandler(logDir));
   router.get("/trace/trigger/list", createGetTriggerListHandler(logDir));
   router.get("/trace/trigger/:instanceID", createGetTriggerDetailHandler(logDir));
+  router.get("/trace/capability/list", createGetCapabilityTraceListHandler(logDir));
   router.get("/health", createHealthCheckHandler());
   return router;
 }
@@ -2835,18 +2986,18 @@ var import_path2 = require("path");
 var import_fs2 = __toESM(require("fs"), 1);
 
 // src/middlewares/collect-logs/utils.ts
-var import_node_path8 = require("path");
-var import_node_fs8 = __toESM(require("fs"), 1);
+var import_node_path9 = require("path");
+var import_node_fs11 = __toESM(require("fs"), 1);
 function resolveLogDir2(provided) {
   if (!provided) {
-    return (0, import_node_path8.join)(process.cwd(), "logs");
+    return (0, import_node_path9.join)(process.cwd(), "logs");
   }
-  return (0, import_node_path8.isAbsolute)(provided) ? provided : (0, import_node_path8.join)(process.cwd(), provided);
+  return (0, import_node_path9.isAbsolute)(provided) ? provided : (0, import_node_path9.join)(process.cwd(), provided);
 }
 __name(resolveLogDir2, "resolveLogDir");
 function ensureDir(dir) {
-  if (!import_node_fs8.default.existsSync(dir)) {
-    import_node_fs8.default.mkdirSync(dir, {
+  if (!import_node_fs11.default.existsSync(dir)) {
+    import_node_fs11.default.mkdirSync(dir, {
       recursive: true
     });
   }
@@ -2969,7 +3120,7 @@ function isGlobalMiddleware(middleware) {
 }
 __name(isGlobalMiddleware, "isGlobalMiddleware");
 function computeMountPath(basePath, mountPath) {
-  const routePath = import_node_path9.default.posix.join(basePath, mountPath);
+  const routePath = import_node_path10.default.posix.join(basePath, mountPath);
   return routePath.startsWith("/") ? routePath : `/${routePath}`;
 }
 __name(computeMountPath, "computeMountPath");
@@ -2977,7 +3128,7 @@ function logMiddlewareRegistration(middleware, fullMountPath) {
   if (middleware.routes && middleware.routes.length > 0) {
     console.log(`[Middleware] Registered: ${middleware.name} at ${fullMountPath}`);
     middleware.routes.forEach((route) => {
-      const routePath = route.path === "/" ? fullMountPath : import_node_path9.default.posix.join(fullMountPath, route.path);
+      const routePath = route.path === "/" ? fullMountPath : import_node_path10.default.posix.join(fullMountPath, route.path);
       console.log(`  ${route.method} ${routePath} - ${route.description}`);
     });
   } else {