@zhushanwen/pi-evolve-daily 0.1.7 → 0.1.9

package/analyzer/analyze.py

@@ -42,7 +42,7 @@ def load_sessions(since_days: int = 1, input_file: str | None = None) -> list[di
     cutoff = datetime.now() - timedelta(days=since_days)
     sessions = []
 
-    for session_file in sessions_dir.glob("*.jsonl"):
+    for session_file in sessions_dir.rglob("*.jsonl"):
         try:
             # 从文件名解析日期
             file_date = datetime.fromisoformat(session_file.stem[:10])

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "@zhushanwen/pi-evolve-daily",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "Daily evolution data collector — runs Python analyzer on first session of the day.",
   "type": "module",
+  "license": "MIT",
   "main": "src/index.ts",
   "pi": {
     "extensions": [
-      "./src/index.ts"
+      "./index.ts"
     ],
     "skills": [
       "./skills"

package/src/detectors/compact.ts

@@ -12,6 +12,12 @@ export interface CompactTrackedItem {
   detail?: string;
 }
 
+// ── ID generation constants ──────────────────────────
+
+const RANDOM_ID_RADIX = 36;
+const RANDOM_ID_SLICE_START = 2;
+const RANDOM_ID_SLICE_END = 7;
+
 export function createCompactDetector(problem: ProblemDefinition) {
   return {
     problemId: problem.id,
@@ -25,7 +31,7 @@ export function createCompactDetector(problem: ProblemDefinition) {
       compactionEntry?: { tokensBefore?: number };
     }): CompactTrackedItem {
       return {
-        id: `compact-${Date.now()}-${Math.random().toString(36).slice(2, 7)}`,
+        id: `compact-${Date.now()}-${Math.random().toString(RANDOM_ID_RADIX).slice(RANDOM_ID_SLICE_START, RANDOM_ID_SLICE_END)}`,
         problemId: problem.id as "compact-frequency",
         sessionId: "",
         tokensBefore: event.compactionEntry?.tokensBefore ?? 0,

package/src/detectors/goal-quality.ts

@@ -2,6 +2,12 @@
 
 import type { ProblemDefinition } from "../problems";
 
+// ── ID generation constants ──────────────────────────
+
+const RANDOM_ID_RADIX = 36;
+const RANDOM_ID_SLICE_START = 2;
+const RANDOM_ID_SLICE_END = 7;
+
 export interface GoalQualityTrackedItem {
   id: string;
   problemId: "goal-task-quality";
@@ -37,7 +43,7 @@ export function createGoalQualityDetector(problem: ProblemDefinition) {
       const total = tasks.length;
 
       return {
-        id: `goal-quality-${Date.now()}-${Math.random().toString(36).slice(2, 7)}`,
+        id: `goal-quality-${Date.now()}-${Math.random().toString(RANDOM_ID_RADIX).slice(RANDOM_ID_SLICE_START, RANDOM_ID_SLICE_END)}`,
         problemId: problem.id as "goal-task-quality",
         sessionId: "",
         goalId: "",

package/src/detectors/param-error.ts

@@ -2,6 +2,13 @@
 
 import type { ProblemDefinition } from "../problems";
 
+// ── ID generation constants ──────────────────────────
+
+const RANDOM_ID_RADIX = 36;
+const RANDOM_ID_SLICE_START = 2;
+const RANDOM_ID_SLICE_END = 7;
+const ERROR_PREVIEW_MAX_LENGTH = 200;
+
 export interface ParamErrorTrackedItem {
   id: string;
   problemId: "tool-param-validation";
@@ -70,12 +77,12 @@ export function createParamErrorDetector(problem: ProblemDefinition) {
     }): ParamErrorTrackedItem {
       const errorMessage = event.content ?? "";
       return {
-        id: `param-error-${Date.now()}-${Math.random().toString(36).slice(2, 7)}`,
+        id: `param-error-${Date.now()}-${Math.random().toString(RANDOM_ID_RADIX).slice(RANDOM_ID_SLICE_START, RANDOM_ID_SLICE_END)}`,
         problemId: problem.id as "tool-param-validation",
         sessionId: "",
         toolName: event.toolName ?? "unknown",
         errorType: classifyError(errorMessage),
-        errorPreview: errorMessage.slice(0, 200),
+        errorPreview: errorMessage.slice(0, ERROR_PREVIEW_MAX_LENGTH),
         status: "pending",
       };
     },

package/src/detectors/subagent-result.ts

@@ -2,6 +2,12 @@
 
 import type { ProblemDefinition } from "../problems";
 
+// ── ID generation constants ──────────────────────────
+
+const RANDOM_ID_RADIX = 36;
+const RANDOM_ID_SLICE_START = 2;
+const RANDOM_ID_SLICE_END = 7;
+
 export interface SubagentTrackedItem {
   id: string;
   problemId: "subagent-efficiency";
@@ -45,7 +51,7 @@ export function createSubagentDetector(problem: ProblemDefinition) {
       taskPrompt?: string;
     }): SubagentTrackedItem {
       return {
-        id: `subagent-${Date.now()}-${Math.random().toString(36).slice(2, 7)}`,
+        id: `subagent-${Date.now()}-${Math.random().toString(RANDOM_ID_RADIX).slice(RANDOM_ID_SLICE_START, RANDOM_ID_SLICE_END)}`,
         problemId: problem.id as "subagent-efficiency",
         sessionId: "",
         taskType: classifyTaskType(event.taskPrompt ?? ""),

package/src/index.ts

@@ -1,16 +1,17 @@
 // packages/evolve-daily/src/index.ts
 
-import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
 import { existsSync, unlinkSync } from "node:fs";
 import { homedir } from "node:os";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 
-import { PROBLEM_REGISTRY } from "./problems";
+import type { ExtensionAPI, ExtensionContext } from "@mariozechner/pi-coding-agent";
+
 import { createCompactDetector } from "./detectors/compact";
-import { createSubagentDetector } from "./detectors/subagent-result";
-import { createParamErrorDetector } from "./detectors/param-error";
 import { createGoalQualityDetector } from "./detectors/goal-quality";
+import { createParamErrorDetector } from "./detectors/param-error";
+import { createSubagentDetector } from "./detectors/subagent-result";
+import { PROBLEM_REGISTRY } from "./problems";
 import { createTracker } from "./trackers/core";
 import { skillExecutionConfig } from "./trackers/skill-execution";
 
@@ -21,6 +22,12 @@ const ANALYZER_PATH = join(EXT_DIR, "..", "analyzer", "analyze.py");
 // 运行时数据目录使用 Pi 平台约定路径（homedir + .pi/agent/）
 const REPORTS_DIR = join(homedir(), ".pi", "agent", "evolution-data", "daily-reports");
 
+const DATE_SLICE_END = 10;
+const ANALYZER_TIMEOUT_MS = 30_000;
+
+/** Pi API 的 on 方法重载签名（覆盖非标事件名） */
+type PiOnAny = { on(event: string, handler: (...args: unknown[]) => Promise<void> | void): void };
+
 /** tool_result 事件中匹配的工具结果 detector */
 interface ToolResultDetector {
   problemId: string;
@@ -30,8 +37,8 @@ interface ToolResultDetector {
 
 export default function evolveDailyExtension(pi: ExtensionAPI) {
   // ── L1: session_start 时调用 Python analyzer ──
-  pi.on("session_start", async () => {
-    const today = new Date().toISOString().slice(0, 10); // YYYY-MM-DD
+  pi.on("session_start", async (_event: unknown, ctx: ExtensionContext) => {
+    const today = new Date().toISOString().slice(0, DATE_SLICE_END); // YYYY-MM-DD
     const reportPath = join(REPORTS_DIR, `${today}.json`);
 
     if (existsSync(reportPath)) return;
@@ -48,12 +55,13 @@ export default function evolveDailyExtension(pi: ExtensionAPI) {
           "--output",
           reportPath,
         ],
-        { timeout: 30_000 }
+        { timeout: ANALYZER_TIMEOUT_MS, signal: ctx.signal }
       );
     } catch (e) {
       // Clean up partial output if analyzer failed mid-write
       try {
         unlinkSync(reportPath);
+      // eslint-disable-next-line taste/no-silent-catch
       } catch {
         /* already gone */
       }
@@ -69,9 +77,10 @@ export default function evolveDailyExtension(pi: ExtensionAPI) {
     PROBLEM_REGISTRY.find((p) => p.id === "compact-frequency")!
   );
 
-  (pi.on as any)("session_compact", async (event: Record<string, unknown>) => {
+  (pi as unknown as PiOnAny).on("session_compact", async (event: unknown) => {
+    const ev = event as Record<string, unknown>;
     try {
-      const item = compactDetector.createItem(event);
+      const item = compactDetector.createItem(ev);
       pi.appendEntry("evolve-feedback", {
         problemId: item.problemId,
         itemId: item.id,
@@ -79,6 +88,7 @@ export default function evolveDailyExtension(pi: ExtensionAPI) {
         detail: item.detail ?? null,
         timestamp: new Date().toISOString(),
       });
+    // eslint-disable-next-line taste/no-silent-catch
     } catch (e) {
       console.error(
         `[evolve-daily] compact detector error:`,
@@ -101,13 +111,14 @@ export default function evolveDailyExtension(pi: ExtensionAPI) {
     ),
   ];
 
-  (pi.on as any)(
+  (pi as unknown as PiOnAny).on(
     "tool_result",
-    async (event: Record<string, unknown>, _ctx?: unknown) => {
+    async (event: unknown, _ctx?: unknown) => {
+      const ev = event as Record<string, unknown>;
       for (const detector of toolDetectors) {
         try {
-          if (detector.match(event)) {
-            const item = detector.createItem(event);
+          if (detector.match(ev)) {
+            const item = detector.createItem(ev);
             pi.appendEntry("evolve-feedback", {
               problemId: item.problemId,
               itemId: item.id,
@@ -116,6 +127,7 @@ export default function evolveDailyExtension(pi: ExtensionAPI) {
               timestamp: new Date().toISOString(),
             });
           }
+        // eslint-disable-next-line taste/no-silent-catch
         } catch (e) {
           console.error(
             `[evolve-daily] detector ${detector.problemId} error:`,

package/src/problems.ts

@@ -49,6 +49,23 @@ interface TrackedItemTemplate {
   status: string;
 }
 
+// ── Severity thresholds ──────────────────────────────
+
+const COMPACT_HIGH_THRESHOLD = 3;
+const COMPACT_MEDIUM_THRESHOLD = 2;
+const CONTEXT_UTILIZATION_MEDIUM = 0.7;
+const CONTEXT_UTILIZATION_HIGH = 0.9;
+const GOAL_LOW_COMPLETION_HIGH = 0.5;
+const GOAL_HIGH_CANCEL = 0.4;
+const GOAL_LOW_COMPLETION_MEDIUM = 0.7;
+const GOAL_MEDIUM_CANCEL = 0.2;
+const SUBAGENT_FAILURE_MEDIUM = 0.2;
+const SUBAGENT_FAILURE_HIGH = 0.4;
+const PARAM_ERROR_MEDIUM = 0.1;
+const PARAM_ERROR_HIGH = 0.25;
+const WORKFLOW_PHASE_RATIO_HIGH = 0.7;
+const WORKFLOW_PHASE_RATIO_MEDIUM = 0.5;
+
 export const PROBLEM_REGISTRY: ProblemDefinition[] = [
   {
     id: "compact-frequency",
@@ -58,8 +75,8 @@ export const PROBLEM_REGISTRY: ProblemDefinition[] = [
       metric: "custom",
       custom: (data) => {
         const rate = data.compactsPerSession as number;
-        if (rate >= 3) return "high";
-        if (rate >= 2) return "medium";
+        if (rate >= COMPACT_HIGH_THRESHOLD) return "high";
+        if (rate >= COMPACT_MEDIUM_THRESHOLD) return "medium";
         return "low";
       },
     },
@@ -86,7 +103,7 @@ export const PROBLEM_REGISTRY: ProblemDefinition[] = [
     category: "context",
     severity: {
       metric: "rate",
-      thresholds: { medium: 0.7, high: 0.9 },
+      thresholds: { medium: CONTEXT_UTILIZATION_MEDIUM, high: CONTEXT_UTILIZATION_HIGH },
     },
     detector: {
       events: ["turn_end"],
@@ -111,7 +128,7 @@ export const PROBLEM_REGISTRY: ProblemDefinition[] = [
     category: "subagent",
     severity: {
       metric: "rate",
-      thresholds: { medium: 0.2, high: 0.4 },
+      thresholds: { medium: SUBAGENT_FAILURE_MEDIUM, high: SUBAGENT_FAILURE_HIGH },
     },
     detector: {
       events: ["tool_result"],
@@ -136,7 +153,7 @@ export const PROBLEM_REGISTRY: ProblemDefinition[] = [
     category: "tool",
     severity: {
       metric: "rate",
-      thresholds: { medium: 0.1, high: 0.25 },
+      thresholds: { medium: PARAM_ERROR_MEDIUM, high: PARAM_ERROR_HIGH },
     },
     detector: {
       events: ["tool_result"],
@@ -163,8 +180,8 @@ export const PROBLEM_REGISTRY: ProblemDefinition[] = [
       metric: "custom",
       custom: (data) => {
         const maxPhaseRatio = data.maxPhaseDurationRatio as number;
-        if (maxPhaseRatio > 0.7) return "high";
-        if (maxPhaseRatio > 0.5) return "medium";
+        if (maxPhaseRatio > WORKFLOW_PHASE_RATIO_HIGH) return "high";
+        if (maxPhaseRatio > WORKFLOW_PHASE_RATIO_MEDIUM) return "medium";
         return "low";
       },
     },
@@ -194,8 +211,8 @@ export const PROBLEM_REGISTRY: ProblemDefinition[] = [
       custom: (data) => {
         const completionRate = data.taskCompletionRate as number;
         const cancelRate = data.taskCancelRate as number;
-        if (completionRate < 0.5 || cancelRate > 0.4) return "high";
-        if (completionRate < 0.7 || cancelRate > 0.2) return "medium";
+        if (completionRate < GOAL_LOW_COMPLETION_HIGH || cancelRate > GOAL_HIGH_CANCEL) return "high";
+        if (completionRate < GOAL_LOW_COMPLETION_MEDIUM || cancelRate > GOAL_MEDIUM_CANCEL) return "medium";
         return "low";
       },
     },

package/src/trackers/core.ts

@@ -13,7 +13,7 @@ import type {
   Theme,
 } from "@mariozechner/pi-coding-agent";
 import { Text } from "@mariozechner/pi-tui";
-
+import type { Static } from "typebox";
 
 import {
   canTransition,
@@ -21,13 +21,46 @@ import {
   deserializeState,
   isTerminalStatus,
   serializeState,
-  TrackerParams,
-
   type TrackedItem,
+  type TrackedItemStatus,
   type TrackerDetails,
+  TrackerParams,
   type TrackerRuntimeState,
 } from "./types";
 
+// ── Pi SDK custom event API type ──────────────────────
+
+type PiOnAny = {
+  on(event: string, handler: (...args: unknown[]) => unknown): void;
+};
+
+// ── Stale context detection ──────────────────────────
+
+const STALE_CONTEXT_PATTERNS = [
+  "Extension context no longer active",
+  "aborted",
+  "context canceled",
+  "stale context",
+  "stalecontext",
+];
+
+/** Detect errors that indicate the Pi session has been torn down (compact/reload/exit). */
+function isStaleContextError(error: unknown): boolean {
+  if (!(error instanceof Error)) return false;
+  const msg = error.message.toLowerCase();
+  return STALE_CONTEXT_PATTERNS.some((p) => msg.includes(p));
+}
+
+// ── Tool execute/render param types ──────────────────
+
+type RenderOptions = { expanded?: boolean };
+
+type ToolResult = {
+  content: Array<{ type: "text"; text: string }>;
+  details: Record<string, unknown> | undefined;
+  isError?: boolean;
+};
+
 // ── Tracker 配置接口（避免 types.ts 引入 Pi API 类型）──
 
 export interface TrackerConfig<TMeta = Record<string, unknown>> {
@@ -89,6 +122,74 @@ function formatItemList<TMeta>(
     .join("\n");
 }
 
+// ── Tool render helpers (extracted to keep createTracker ≤300 lines) ──
+
+function renderTrackerCall<TMeta>(
+  args: Record<string, unknown>,
+  config: TrackerConfig<TMeta>,
+  theme: Theme,
+): Text {
+  const parts = [
+    theme.fg("toolTitle", theme.bold(`${config.toolName} `)),
+    theme.fg("muted", String(args.action ?? "")),
+  ];
+  if (args.id !== undefined)
+    parts.push(theme.fg("accent", `#${String(args.id)}`));
+  if (args.status !== undefined)
+    parts.push(theme.fg("warning", String(args.status)));
+  if (args.detail !== undefined)
+    parts.push(theme.fg("dim", `"${String(args.detail)}"`));
+  return new Text(parts.join(" "), 0, 0);
+}
+
+function renderTrackerResult<TMeta>(
+  result: ToolResult,
+  options: RenderOptions,
+  config: TrackerConfig<TMeta>,
+  theme: Theme,
+): Text {
+  if (config.renderResult && result.details) {
+    return config.renderResult(
+      result.details as unknown as TrackerDetails<TMeta>,
+      options,
+      theme,
+    );
+  }
+
+  if (!result.details) {
+    return new Text(theme.fg("dim", "(no details)"), 0, 0);
+  }
+
+  // 框架默认渲染
+  const details = result.details as unknown as TrackerDetails<TMeta>;
+  if (details.error) {
+    return new Text(
+      theme.fg("error", `[${config.name}] Error: ${details.error}`),
+      0,
+      0,
+    );
+  }
+
+  const prefix = theme.fg("accent", `[${config.name}] `);
+  const summary = `${details.action}: ${details.items.length} items`;
+
+  if (!options.expanded) {
+    return new Text(prefix + theme.fg("dim", summary), 0, 0);
+  }
+
+  const items = details.items
+    .map((item) => {
+      const terminal = isTerminalStatus(item.status) ? " ✓" : "";
+      return `  #${item.id} ${item.name} [${item.status}]${terminal}`;
+    })
+    .join("\n");
+  return new Text(
+    prefix + summary + "\n" + theme.fg("dim", items),
+    0,
+    0,
+  );
+}
+
 // ── 工厂函数 ────────────────────────────────────────
 
 export function createTracker<TMeta>(
@@ -100,8 +201,19 @@ export function createTracker<TMeta>(
   // ── 持久化 + GC ───────────────────────────────────
 
   function persistState(ctx: ExtensionContext): void {
-    pi.appendEntry(config.entryType, serializeState(state));
-    const entries = ctx.sessionManager.getEntries();
+    let entries: SessionEntry[];
+    try {
+      pi.appendEntry(config.entryType, serializeState(state));
+      entries = ctx.sessionManager.getEntries();
+    } catch (e) {
+      if (isStaleContextError(e)) {
+        console.warn(
+          `[${config.name}] skip persist: stale context (${(e as Error).message})`,
+        );
+        return;
+      }
+      throw e;
+    }
     const staleIndices: number[] = [];
     let foundLatest = false;
     for (let i = entries.length - 1; i >= 0; i--) {
@@ -121,7 +233,19 @@ export function createTracker<TMeta>(
   // ── 状态恢复 ──────────────────────────────────────
 
   function reconstructState(ctx: ExtensionContext): void {
-    const entries = ctx.sessionManager.getEntries();
+    let entries: SessionEntry[];
+    try {
+      entries = ctx.sessionManager.getEntries();
+    } catch (e) {
+      if (isStaleContextError(e)) {
+        console.warn(
+          `[${config.name}] skip reconstruct: stale context (${(e as Error).message})`,
+        );
+        state = createInitialState<TMeta>();
+        return;
+      }
+      throw e;
+    }
     const allTypes = [config.entryType, ...(config.legacyEntryTypes ?? [])];
 
     let latestData: Record<string, unknown> | undefined;
@@ -181,10 +305,10 @@ export function createTracker<TMeta>(
   // ── Event: triggerEvent (e.g. tool_call) ───────────
 
   // Pi 事件系统支持任意字符串事件名，但类型定义不完整（与 session_compact 同）
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  (pi as any).on(
+  (pi as unknown as PiOnAny).on(
     config.triggerEvent,
-    async (event: unknown, ctx: ExtensionContext) => {
+    async (event, nextCtx) => {
+      const ctx = nextCtx as ExtensionContext;
       const match = config.triggerMatch(event);
       if (!match) return;
 
@@ -223,10 +347,11 @@ export function createTracker<TMeta>(
 
   // ── Event: turn_end（remind 检查）─────────────────
 
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  (pi as any).on(
+  (pi as unknown as PiOnAny).on(
     "turn_end",
-    async (event: Record<string, unknown>, ctx: ExtensionContext) => {
+    async (rawEvent, nextCtx) => {
+      const event = rawEvent as Record<string, unknown>;
+      const ctx = nextCtx as ExtensionContext;
       const eventTurnIndex = event.turnIndex;
       if (typeof eventTurnIndex === "number") {
         state.currentTurnIndex = eventTurnIndex;
@@ -285,8 +410,7 @@ export function createTracker<TMeta>(
     pi.registerMessageRenderer(
       customType,
       (
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        message: any,
+        message: { content: string | unknown },
         _options: unknown,
         theme: Theme,
       ) => {
@@ -313,14 +437,13 @@ export function createTracker<TMeta>(
     promptGuidelines: config.promptGuidelines,
     parameters: TrackerParams,
 
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     async execute(
       _toolCallId: string,
-      params: any,
-      _signal: any,
-      _onUpdate: any,
+      params: Static<typeof TrackerParams>,
+      _signal: AbortSignal | undefined,
+      _onUpdate: unknown,
       ctx: ExtensionContext,
-    ): Promise<any> {
+    ): Promise<ToolResult> {
       // ── list ──
       if (params.action === "list") {
         return {
@@ -339,30 +462,32 @@ export function createTracker<TMeta>(
       }
 
       // ── update ──
-      if (params.id === undefined) {
-        return { content: [{ type: "text", text: "update action requires id parameter" }], isError: true };
+      const updateId = params.id as number | undefined;
+      const updateStatus = params.status as string | undefined;
+      if (updateId === undefined) {
+        return { content: [{ type: "text", text: "update action requires id parameter" }], details: undefined, isError: true };
       }
-      if (params.status === undefined) {
-        return { content: [{ type: "text", text: "update action requires status parameter" }], isError: true };
+      if (updateStatus === undefined) {
+        return { content: [{ type: "text", text: "update action requires status parameter" }], details: undefined, isError: true };
       }
 
       const itemIndex = state.items.findIndex(
-        (item) => item.id === params.id,
+        (item) => item.id === updateId,
       );
       if (itemIndex === -1) {
-        return { content: [{ type: "text", text: `TrackedItem id=${params.id} not found` }], isError: true };
+        return { content: [{ type: "text", text: `TrackedItem id=${updateId} not found` }], details: undefined, isError: true };
       }
 
       const item = state.items[itemIndex];
-      if (!canTransition(item.status, params.status)) {
-        return { content: [{ type: "text", text: `Invalid transition: ${item.status} → ${params.status} (current: ${item.status}, terminal states are immutable or path not allowed)` }], isError: true };
+      if (!canTransition(item.status, updateStatus as TrackedItemStatus)) {
+        return { content: [{ type: "text", text: `Invalid transition: ${item.status} → ${updateStatus} (current: ${item.status}, terminal states are immutable or path not allowed)` }], details: undefined, isError: true };
       }
 
       // 执行转换
-      item.status = params.status;
-      item.detail = params.detail ?? item.detail;
+      item.status = updateStatus as TrackedItemStatus;
+      item.detail = (params.detail as string | undefined | null) ?? item.detail;
 
-      if (params.status === "error") {
+      if (updateStatus === "error") {
         item.errorCount += 1;
         if (item.errorCount >= config.errorThreshold) {
           await pi.sendUserMessage(config.steering.onError(item), {
@@ -390,68 +515,21 @@ export function createTracker<TMeta>(
       };
     },
 
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     renderCall(
-      args: any,
+      args: Record<string, unknown>,
       theme: Theme,
       _context?: unknown,
     ) {
-      const parts = [
-        theme.fg("toolTitle", theme.bold(`${config.toolName} `)),
-        theme.fg("muted", String(args.action ?? "")),
-      ];
-      if (args.id !== undefined)
-        parts.push(theme.fg("accent", `#${String(args.id)}`));
-      if (args.status !== undefined)
-        parts.push(theme.fg("warning", String(args.status)));
-      if (args.detail !== undefined)
-        parts.push(theme.fg("dim", `"${String(args.detail)}"`));
-      return new Text(parts.join(" "), 0, 0);
+      return renderTrackerCall(args, config, theme);
     },
 
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     renderResult(
-      result: any,
-      options: any,
+      result: { content: Array<{ type: "text"; text?: string } | { type: "image"; data: string; mimeType: string }>; details?: Record<string, unknown> },
+      _options: unknown,
       theme: Theme,
       _context?: unknown,
     ) {
-      if (config.renderResult) {
-        return config.renderResult(
-          result.details as TrackerDetails<TMeta>,
-          options,
-          theme,
-        );
-      }
-
-      // 框架默认渲染
-      const details = result.details as TrackerDetails<TMeta>;
-      if (details.error) {
-        return new Text(
-          theme.fg("error", `[${config.name}] Error: ${details.error}`),
-          0,
-          0,
-        );
-      }
-
-      const prefix = theme.fg("accent", `[${config.name}] `);
-      const summary = `${details.action}: ${details.items.length} items`;
-
-      if (!options.expanded) {
-        return new Text(prefix + theme.fg("dim", summary), 0, 0);
-      }
-
-      const items = details.items
-        .map((item) => {
-          const terminal = isTerminalStatus(item.status) ? " ✓" : "";
-          return `  #${item.id} ${item.name} [${item.status}]${terminal}`;
-        })
-        .join("\n");
-      return new Text(
-        prefix + summary + "\n" + theme.fg("dim", items),
-        0,
-        0,
-      );
+      return renderTrackerResult(result as ToolResult, { expanded: (_options as Record<string, unknown> | undefined)?.expanded as boolean | undefined }, config, theme);
     },
   });
 }

package/src/trackers/skill-execution.ts

@@ -5,8 +5,8 @@
  * 追踪 skill 的加载、执行、异常、记录全生命周期。
  */
 
-import type { TrackedItem } from "./types";
 import type { TrackerConfig } from "./core";
+import type { TrackedItem } from "./types";
 
 // ── Metadata 类型 ───────────────────────────────────