@pi-harness/pi-harness 0.1.13 → 0.1.15

package/packages/core/src/plugins/code2skill.ts

@@ -1,96 +0,0 @@
-import { mkdir, readFile, writeFile } from "node:fs/promises";
-import { isAbsolute, join, relative, resolve } from "node:path";
-import type { Context } from "@deepseek-ai/cordis";
-import { Type } from "@earendil-works/pi-ai";
-import { defineTool, type AgentToolResult } from "@earendil-works/pi-coding-agent";
-
-const maxFiles = 32;
-const maxFileBytes = 256 * 1024;
-const maxTotalBytes = 2 * 1024 * 1024;
-
-type SkillFile = { path: string; bytes: number };
-type SkillReport = { slug: string; directory: string; files: SkillFile[]; bytes: number };
-
-function slugify(name: string): string {
-  const slug = name
-    .trim()
-    .toLowerCase()
-    .replace(/[^a-z0-9]+/gu, "-")
-    .replace(/^-+|-+$/gu, "")
-    .slice(0, 64);
-  if (slug.length === 0) throw new Error("Skill name must contain at least one letter or number");
-  return slug;
-}
-
-function resolveWorkspaceFile(cwd: string, input: string): { absolute: string; display: string } {
-  if (typeof input !== "string" || input.trim() === "" || isAbsolute(input)) throw new Error("Skill files must be non-empty relative paths");
-  const absolute = resolve(cwd, input);
-  const display = relative(cwd, absolute);
-  if (display === "" || display.startsWith("..") || isAbsolute(display)) throw new Error(`Skill file must stay inside the workspace: ${input}`);
-  return { absolute, display };
-}
-
-async function createSkill(context: Context, params: { name: string; description: string; files: string[] }): Promise<SkillReport> {
-  if (!Array.isArray(params.files) || params.files.length === 0) throw new Error("At least one source file is required");
-  if (params.files.length > maxFiles) throw new Error(`A skill can include at most ${maxFiles} files`);
-  const cwd = context.piHarnessLaunch.cwd;
-  const slug = slugify(params.name);
-  const sources = params.files.map((file) => resolveWorkspaceFile(cwd, file));
-  const unique = new Set(sources.map((source) => source.display));
-  if (unique.size !== sources.length) throw new Error("Skill files must be unique");
-  let bytes = 0;
-  const files: SkillFile[] = [];
-  const output = join(cwd, ".pi", "skills", slug);
-  for (const source of sources) {
-    const content = await readFile(source.absolute);
-    if (content.byteLength > maxFileBytes) throw new Error(`Skill file exceeds ${maxFileBytes} bytes: ${source.display}`);
-    bytes += content.byteLength;
-    if (bytes > maxTotalBytes) throw new Error(`Skill sources exceed ${maxTotalBytes} bytes`);
-    const target = join(output, "references", source.display);
-    await mkdir(resolve(target, ".."), { recursive: true });
-    await writeFile(target, content);
-    files.push({ path: source.display, bytes: content.byteLength });
-  }
-  const description = params.description.trim();
-  if (description.length === 0) throw new Error("Skill description must not be empty");
-  const references = files.map((file) => `- [${file.path}](references/${file.path})`).join("\n");
-  const markdown = `---\nname: ${slug}\ndescription: ${description.replaceAll("\n", " ")}\n---\n\n# ${params.name.trim()}\n\n${description}\n\n## Reference files\n\n${references}\n`;
-  await mkdir(output, { recursive: true });
-  await writeFile(join(output, "SKILL.md"), markdown, "utf8");
-  return { slug, directory: output, files, bytes };
-}
-
-export default {
-  name: "pi-code2skill",
-  inject: ["piHarnessLaunch", "piPluginUi", "piTools"],
-  apply(context: Context) {
-    let generated = 0;
-    let latest: SkillReport | undefined;
-    const unregisterTool = context.piTools.register(
-      defineTool({
-        name: "skill_pack_create",
-        label: "Create skill pack",
-        description: "Package selected workspace source files into a local .pi/skills skill with a manifest and references.",
-        promptSnippet: "turn selected project files into a reusable skill pack",
-        parameters: Type.Object({ name: Type.String(), description: Type.String(), files: Type.Array(Type.String()) }),
-        async execute(_toolCallId, params): Promise<AgentToolResult<SkillReport>> {
-          latest = await createSkill(context, params);
-          generated += 1;
-          return { content: [{ type: "text", text: `Skill pack created: ${latest.slug} (${latest.files.length} file(s)).` }], details: latest };
-        },
-      }),
-    );
-    const disposePanel = context.piPluginUi.register({
-      id: "code2skill-panel",
-      pluginId: "@pi-harness/core/plugins/code2skill",
-      title: "Code2Skill",
-      description: "把工作区代码打包为可复用的 Pi Skill，保留来源文件并生成 SKILL.md。",
-      icon: "✦",
-      read: () => ({ generated, latest: latest ?? null }),
-    });
-    context.effect(() => () => {
-      unregisterTool();
-      disposePanel();
-    });
-  },
-};

package/packages/core/src/plugins/colleague-skill.ts

@@ -1,122 +0,0 @@
-import type { Context } from "@deepseek-ai/cordis";
-import { Type } from "@earendil-works/pi-ai";
-import { defineTool, type AgentToolResult } from "@earendil-works/pi-coding-agent";
-
-const customType = "pi-harness/colleague-handoff";
-const maxTextLength = 4_000;
-const maxListItems = 20;
-
-export interface ColleagueHandoffInput {
-  toRole: string;
-  objective: string;
-  context?: string;
-  constraints?: string[];
-  files?: string[];
-  acceptance?: string[];
-}
-
-export interface ColleagueHandoff {
-  id: string;
-  toRole: string;
-  objective: string;
-  context: string;
-  constraints: string[];
-  files: string[];
-  acceptance: string[];
-  createdAt: string;
-}
-
-function boundedText(value: string | undefined, field: string): string {
-  const text = value?.trim() ?? "";
-  if (text.length > maxTextLength) throw new Error(`${field} must be ${maxTextLength} characters or fewer`);
-  return text;
-}
-
-function boundedList(values: string[] | undefined, field: string): string[] {
-  const list = values ?? [];
-  if (list.length > maxListItems) throw new Error(`${field} must contain ${maxListItems} items or fewer`);
-  return list.map((value) => boundedText(value, `${field} item`)).filter(Boolean);
-}
-
-export function createColleagueHandoff(input: ColleagueHandoffInput, id: string, createdAt: string): ColleagueHandoff {
-  const toRole = boundedText(input.toRole, "toRole");
-  const objective = boundedText(input.objective, "objective");
-  if (!toRole) throw new Error("toRole is required");
-  if (!objective) throw new Error("objective is required");
-  return {
-    id,
-    toRole,
-    objective,
-    context: boundedText(input.context, "context"),
-    constraints: boundedList(input.constraints, "constraints"),
-    files: boundedList(input.files, "files"),
-    acceptance: boundedList(input.acceptance, "acceptance"),
-    createdAt,
-  };
-}
-
-function readLatest(context: Context): ColleagueHandoff | undefined {
-  const entries = context.piSession.manager.getEntries();
-  const entry = [...entries].reverse().find((item) => item.type === "custom" && item.customType === customType);
-  if (entry?.type !== "custom" || entry.data === undefined || entry.data === null || typeof entry.data !== "object") return undefined;
-  const value = entry.data as Partial<ColleagueHandoff>;
-  if (typeof value.id !== "string" || typeof value.toRole !== "string" || typeof value.objective !== "string" || typeof value.createdAt !== "string")
-    return undefined;
-  return {
-    id: value.id,
-    toRole: value.toRole,
-    objective: value.objective,
-    context: typeof value.context === "string" ? value.context : "",
-    constraints: Array.isArray(value.constraints) ? value.constraints.filter((item): item is string => typeof item === "string") : [],
-    files: Array.isArray(value.files) ? value.files.filter((item): item is string => typeof item === "string") : [],
-    acceptance: Array.isArray(value.acceptance) ? value.acceptance.filter((item): item is string => typeof item === "string") : [],
-    createdAt: value.createdAt,
-  };
-}
-
-export default {
-  name: "pi-colleague-skill",
-  inject: ["piSession", "piPluginUi", "piTools"],
-  apply(context: Context) {
-    let latest = readLatest(context);
-    const unregister = context.piTools.register(
-      defineTool({
-        name: "colleague_handoff",
-        label: "Colleague handoff",
-        description: "Create a durable, structured handoff packet for another role without starting a hidden agent or sending external messages.",
-        promptSnippet: "prepare a structured handoff for a colleague role",
-        parameters: Type.Object({
-          toRole: Type.String({ description: "Receiving role, for example reviewer or frontend" }),
-          objective: Type.String({ description: "The concrete outcome the colleague should deliver" }),
-          context: Type.Optional(Type.String()),
-          constraints: Type.Optional(Type.Array(Type.String())),
-          files: Type.Optional(Type.Array(Type.String())),
-          acceptance: Type.Optional(Type.Array(Type.String())),
-        }),
-        execute(_toolCallId, params): Promise<AgentToolResult<ColleagueHandoff>> {
-          return Promise.resolve().then(() => {
-            const handoff = createColleagueHandoff(params, `handoff-${Date.now()}`, new Date().toISOString());
-            context.piSession.manager.appendCustomEntry(customType, handoff);
-            latest = handoff;
-            return {
-              content: [{ type: "text" as const, text: `Handoff ${handoff.id} prepared for ${handoff.toRole}.` }],
-              details: handoff,
-            };
-          });
-        },
-      }),
-    );
-    const disposePanel = context.piPluginUi.register({
-      id: "colleague-skill-panel",
-      pluginId: "@pi-harness/core/plugins/colleague-skill",
-      title: "Colleague Skill",
-      description: "把任务、上下文、约束和验收条件整理成可追踪的角色交接包。",
-      icon: "⇄",
-      read: () => ({ latest: latest ?? null }),
-    });
-    context.effect(() => () => {
-      unregister();
-      disposePanel();
-    });
-  },
-};

package/packages/core/src/plugins/context-doctor.ts

@@ -1,117 +0,0 @@
-import type { Context } from "@deepseek-ai/cordis";
-import z from "@deepseek-ai/schemastery";
-import { Type } from "@earendil-works/pi-ai";
-import { defineTool, type AgentToolResult } from "@earendil-works/pi-coding-agent";
-
-type ContextDoctorReport = {
-  status: "ok" | "warning";
-  usagePercent: number | null;
-  tokens: number | null;
-  contextWindow: number | null;
-  messageCount: number;
-  oversizedMessages: number;
-  toolErrors: number;
-  recommendations: string[];
-};
-
-export interface ContextDoctorPluginConfig {
-  warnPercent?: number;
-  maxMessageBytes?: number;
-}
-
-export const Config: z<ContextDoctorPluginConfig> = z.object({ warnPercent: z.number().default(75), maxMessageBytes: z.number().default(64 * 1024) });
-
-function byteLength(value: unknown): number {
-  try {
-    return Buffer.byteLength(JSON.stringify(value), "utf8");
-  } catch {
-    return 0;
-  }
-}
-
-export function inspectMessages(
-  messages: readonly unknown[],
-  usage: { percent?: number | null; tokens?: number | null; contextWindow?: number | null } | undefined,
-  warnPercent: number,
-  maxMessageBytes: number,
-): ContextDoctorReport {
-  const oversizedMessages = messages.filter((message) => byteLength(message) > maxMessageBytes).length;
-  const toolErrors = messages.filter(
-    (message) =>
-      typeof message === "object" &&
-      message !== null &&
-      (message as Record<string, unknown>).role === "toolResult" &&
-      (message as Record<string, unknown>).isError === true,
-  ).length;
-  const usagePercent = typeof usage?.percent === "number" ? usage.percent : null;
-  const recommendations: string[] = [];
-  if (usagePercent !== null && usagePercent >= warnPercent) recommendations.push("压缩较早的会话历史，释放上下文空间。");
-  if (oversizedMessages > 0) recommendations.push(`检查 ${oversizedMessages} 条超大消息，优先引用摘要或文件路径。`);
-  if (toolErrors > 0) recommendations.push(`处理 ${toolErrors} 个工具错误后再继续长任务。`);
-  return {
-    status: recommendations.length === 0 ? "ok" : "warning",
-    usagePercent,
-    tokens: typeof usage?.tokens === "number" ? usage.tokens : null,
-    contextWindow: typeof usage?.contextWindow === "number" ? usage.contextWindow : null,
-    messageCount: messages.length,
-    oversizedMessages,
-    toolErrors,
-    recommendations,
-  };
-}
-
-export default {
-  name: "pi-context-doctor",
-  inject: ["piPluginUi", "piTools"],
-  Config,
-  apply(context: Context, config: ContextDoctorPluginConfig) {
-    const warnPercent = Math.max(1, Math.min(100, config.warnPercent ?? 75));
-    const maxMessageBytes = Math.max(1024, Math.min(1024 * 1024, Math.trunc(config.maxMessageBytes ?? 64 * 1024)));
-    const runtime = () => context.get("piRuntime");
-    const report = (): ContextDoctorReport => {
-      const service = runtime();
-      if (service === undefined) return inspectMessages([], undefined, warnPercent, maxMessageBytes);
-      return inspectMessages(service.session.messages, service.session.getContextUsage(), warnPercent, maxMessageBytes);
-    };
-    const unregisterTool = context.piTools.register(
-      defineTool({
-        name: "context_doctor",
-        label: "Context doctor",
-        description: "Audit context pressure, oversized messages, and tool errors; optionally compact after confirmation.",
-        promptSnippet: "audit context pressure and recommend safe cleanup",
-        parameters: Type.Object({
-          compact: Type.Optional(Type.Boolean({ description: "Compact the session after the audit" })),
-          confirm: Type.Optional(Type.Boolean({ description: "Must be true when compact is requested" })),
-        }),
-        async execute(_toolCallId, params): Promise<AgentToolResult<ContextDoctorReport & { compacted: boolean }>> {
-          if (params.compact === true && params.confirm !== true) throw new Error("Context compaction requires confirm=true");
-          const service = runtime();
-          if (service === undefined) throw new Error("Pi runtime is not ready");
-          if (params.compact === true) await service.session.compact();
-          const details = { ...report(), compacted: params.compact === true };
-          return {
-            content: [
-              {
-                type: "text",
-                text: `${details.status}: ${details.messageCount} messages, ${details.oversizedMessages} oversized, ${details.toolErrors} tool errors.`,
-              },
-            ],
-            details,
-          };
-        },
-      }),
-    );
-    const disposePanel = context.piPluginUi.register({
-      id: "context-doctor-panel",
-      pluginId: "@pi-harness/core/plugins/context-doctor",
-      title: "Context Doctor",
-      description: "审计上下文压力、超大消息和工具错误，并给出压缩建议。",
-      icon: "⌁",
-      read: report,
-    });
-    context.effect(() => () => {
-      unregisterTool();
-      disposePanel();
-    });
-  },
-};

package/packages/core/src/plugins/context.ts

@@ -1,102 +0,0 @@
-import type { Context } from "@deepseek-ai/cordis";
-import type { AgentSessionEvent } from "@earendil-works/pi-coding-agent";
-import { Type } from "@earendil-works/pi-ai";
-import { defineTool, type AgentToolResult } from "@earendil-works/pi-coding-agent";
-
-type RuntimeEvent = AgentSessionEvent & { readonly type?: string };
-type MessageRole = "user" | "assistant" | "toolResult" | "system" | "other";
-type ContextComposition = Record<MessageRole, number>;
-type ContextInsightReport = {
-  tokens: number | null;
-  contextWindow: number | null;
-  percent: number | null;
-  messages: number;
-  events: number;
-  compactions: number;
-  composition: ContextComposition;
-  eventTypes: Record<string, number>;
-  recentEvents: { type: string; at: number }[];
-};
-
-function messageRole(message: unknown): MessageRole {
-  if (typeof message !== "object" || message === null) return "other";
-  const role = (message as { role?: unknown }).role;
-  if (role === "user" || role === "assistant" || role === "toolResult" || role === "system") return role;
-  return "other";
-}
-
-export default {
-  name: "pi-context",
-  inject: ["piPluginUi", "piTools"],
-  apply(context: Context) {
-    let eventCount = 0;
-    let compactionCount = 0;
-    const eventTypes = new Map<string, number>();
-    const recentEvents: { type: string; at: number }[] = [];
-    const onEvent = (event: RuntimeEvent) => {
-      eventCount += 1;
-      const type = event.type ?? "unknown";
-      eventTypes.set(type, (eventTypes.get(type) ?? 0) + 1);
-      recentEvents.push({ type, at: Date.now() });
-      if (recentEvents.length > 50) recentEvents.shift();
-      if (type.startsWith("compaction_")) compactionCount += 1;
-    };
-    const unsubscribe = context.on("pi/session-event", onEvent);
-    const report = (): ContextInsightReport => {
-      const runtime = context.get("piRuntime");
-      if (runtime === undefined) {
-        return {
-          tokens: null,
-          contextWindow: null,
-          percent: null,
-          messages: 0,
-          events: eventCount,
-          compactions: compactionCount,
-          composition: { user: 0, assistant: 0, toolResult: 0, system: 0, other: 0 },
-          eventTypes: Object.fromEntries(eventTypes),
-          recentEvents: recentEvents.map((event) => ({ ...event })),
-        };
-      }
-      const usage = runtime.session.getContextUsage();
-      const composition: ContextComposition = { user: 0, assistant: 0, toolResult: 0, system: 0, other: 0 };
-      for (const message of runtime.session.messages) composition[messageRole(message)] += 1;
-      return {
-        tokens: usage?.tokens ?? null,
-        contextWindow: usage?.contextWindow ?? null,
-        percent: usage?.percent ?? null,
-        messages: runtime.session.messages.length,
-        events: eventCount,
-        compactions: compactionCount,
-        composition,
-        eventTypes: Object.fromEntries(eventTypes),
-        recentEvents: recentEvents.map((event) => ({ ...event })),
-      };
-    };
-    const unregisterTool = context.piTools.register(
-      defineTool({
-        name: "context_inspect",
-        label: "Context inspect",
-        description: "Inspect current context usage, message composition, and recent lifecycle events.",
-        promptSnippet: "inspect the current context composition and recent events",
-        parameters: Type.Object({}),
-        execute(): Promise<AgentToolResult<ContextInsightReport>> {
-          const details = report();
-          return Promise.resolve({ content: [{ type: "text", text: `${details.messages} messages, ${details.events} context events.` }], details });
-        },
-      }),
-    );
-    const disposePanel = context.piPluginUi.register({
-      id: "context-insight-panel",
-      pluginId: "@pi-harness/core/plugins/context",
-      title: "上下文洞察",
-      description: "查看当前上下文占用、消息规模和压缩事件。",
-      icon: "◒",
-      read: report,
-    });
-    context.effect(() => () => {
-      unsubscribe();
-      unregisterTool();
-      disposePanel();
-    });
-  },
-};

package/packages/core/src/plugins/cost-meter.ts

@@ -1,231 +0,0 @@
-import { randomUUID } from "node:crypto";
-import { mkdir, open, readFile, rename, stat, unlink, writeFile } from "node:fs/promises";
-import { basename, dirname, join, resolve } from "node:path";
-import type { Context } from "@deepseek-ai/cordis";
-import z from "@deepseek-ai/schemastery";
-import { Type } from "@earendil-works/pi-ai";
-import { defineTool, type AgentToolResult, type SessionStats } from "@earendil-works/pi-coding-agent";
-
-const defaultFileName = "cost-meter.json";
-const defaultMaxEntries = 365;
-const maxFileEntries = 2_000;
-
-export interface CostMeterPluginConfig {
-  fileName?: string;
-  dailyBudget?: number;
-  maxEntries?: number;
-}
-
-export const Config: z<CostMeterPluginConfig> = z.object({
-  fileName: z.string().default(defaultFileName),
-  dailyBudget: z.number().default(0),
-  maxEntries: z.number().default(defaultMaxEntries),
-});
-
-export interface CostEntry {
-  sessionId: string;
-  cost: number;
-  tokens: number;
-  messages: number;
-  recordedAt: string;
-}
-
-export interface CostMeterReport {
-  sessionCost: number;
-  todayCost: number;
-  lifetimeCost: number;
-  budget: number | null;
-  budgetPercent: number | null;
-  entries: CostEntry[];
-}
-
-interface CostFile {
-  version: 1;
-  entries: CostEntry[];
-}
-
-function normalizeFilePath(agentDir: string, fileName: string | undefined): string {
-  const name = (fileName ?? defaultFileName).trim();
-  if (name === "" || basename(name) !== name || !name.toLowerCase().endsWith(".json")) throw new Error("Cost meter fileName must be a single .json filename");
-  return resolve(agentDir, name);
-}
-
-function finiteCost(value: number): number {
-  return Number.isFinite(value) && value >= 0 ? Math.round(value * 1_000_000) / 1_000_000 : 0;
-}
-
-function todayKey(date: Date): string {
-  return date.toISOString().slice(0, 10);
-}
-
-function reportFor(entries: readonly CostEntry[], current: SessionStats, budget: number | null): CostMeterReport {
-  const today = todayKey(new Date());
-  const todayCost = entries.filter((entry) => entry.recordedAt.slice(0, 10) === today).reduce((sum, entry) => sum + entry.cost, 0);
-  const lifetimeCost = entries.reduce((sum, entry) => sum + entry.cost, 0);
-  const roundedToday = finiteCost(todayCost);
-  return {
-    sessionCost: finiteCost(current.cost),
-    todayCost: roundedToday,
-    lifetimeCost: finiteCost(lifetimeCost),
-    budget,
-    budgetPercent: budget === null || budget === 0 ? null : Math.round((roundedToday / budget) * 10_000) / 100,
-    entries: [...entries],
-  };
-}
-
-export function upsertCostEntry(entries: readonly CostEntry[], entry: CostEntry, limit: number): CostEntry[] {
-  return [entry, ...entries.filter((item) => item.sessionId !== entry.sessionId)].slice(0, limit);
-}
-
-export default {
-  name: "pi-cost-meter",
-  inject: ["piHarnessLaunch", "piPluginUi", "piTools"],
-  Config,
-  apply(context: Context, config: CostMeterPluginConfig) {
-    const filePath = normalizeFilePath(context.piHarnessLaunch.agentDir, config.fileName);
-    const budgetValue =
-      typeof config.dailyBudget === "number" && Number.isFinite(config.dailyBudget) && config.dailyBudget > 0 ? finiteCost(config.dailyBudget) : null;
-    const entryLimit = Math.max(1, Math.min(maxFileEntries, Math.trunc(config.maxEntries ?? defaultMaxEntries)));
-    let entries: CostEntry[] = [];
-    let loaded = false;
-    let loading: Promise<void> | undefined;
-    let writeQueue = Promise.resolve();
-    let pendingRecord: Promise<void> | undefined;
-    const runtime = () => {
-      const service = context.get("piRuntime");
-      if (service === undefined) throw new Error("Pi runtime is not ready");
-      return service;
-    };
-    const load = async (): Promise<void> => {
-      if (loaded) return;
-      if (loading !== undefined) return loading;
-      loading = (async () => {
-        try {
-          const parsed = JSON.parse(await readFile(filePath, "utf8")) as Partial<CostFile>;
-          if (parsed.version !== 1 || !Array.isArray(parsed.entries)) throw new Error("Cost meter file has an unsupported format");
-          entries = parsed.entries.filter(
-            (entry): entry is CostEntry =>
-              typeof entry === "object" &&
-              entry !== null &&
-              typeof entry.sessionId === "string" &&
-              typeof entry.recordedAt === "string" &&
-              typeof entry.cost === "number",
-          );
-        } catch (error) {
-          if ((error as NodeJS.ErrnoException).code !== "ENOENT") throw error;
-          entries = [];
-        }
-        loaded = true;
-      })();
-      return loading;
-    };
-    const persist = async (): Promise<void> => {
-      writeQueue = writeQueue.then(async () => {
-        await mkdir(dirname(filePath), { recursive: true });
-        const lockPath = `${filePath}.lock`;
-        let lock: Awaited<ReturnType<typeof open>> | undefined;
-        for (let attempt = 0; attempt < 80; attempt += 1) {
-          try {
-            lock = await open(lockPath, "wx", 0o600);
-            break;
-          } catch (error) {
-            if ((error as NodeJS.ErrnoException).code !== "EEXIST" || attempt === 79) throw error;
-            const lockAge = await stat(lockPath)
-              .then((metadata) => Date.now() - metadata.mtimeMs)
-              .catch(() => 0);
-            if (lockAge > 30_000) await unlink(lockPath).catch(() => {});
-            await new Promise((resolveDelay) => setTimeout(resolveDelay, 25));
-          }
-        }
-        if (lock === undefined) throw new Error("Could not acquire the cost meter persistence lock");
-        try {
-          const diskEntries = await readFile(filePath, "utf8")
-            .then((source) => {
-              const parsed = JSON.parse(source) as Partial<CostFile>;
-              return parsed.version === 1 && Array.isArray(parsed.entries) ? parsed.entries : [];
-            })
-            .catch((error: unknown) => {
-              if ((error as NodeJS.ErrnoException).code === "ENOENT") return [];
-              throw error;
-            });
-          const merged = new Map(diskEntries.map((entry) => [entry.sessionId, entry]));
-          for (const entry of entries) {
-            const existing = merged.get(entry.sessionId);
-            if (existing === undefined || entry.recordedAt >= existing.recordedAt) merged.set(entry.sessionId, entry);
-          }
-          entries = [...merged.values()].sort((left, right) => right.recordedAt.localeCompare(left.recordedAt)).slice(0, entryLimit);
-          const payload = JSON.stringify({ version: 1, entries } satisfies CostFile, null, 2);
-          const temporary = join(dirname(filePath), `.${basename(filePath)}.${randomUUID()}.tmp`);
-          let renamed = false;
-          try {
-            await writeFile(temporary, payload, { encoding: "utf8", mode: 0o600, flag: "wx" });
-            await rename(temporary, filePath);
-            renamed = true;
-          } finally {
-            if (!renamed) await unlink(temporary).catch(() => {});
-          }
-        } finally {
-          await lock.close();
-          await unlink(lockPath).catch(() => {});
-        }
-      });
-      await writeQueue;
-    };
-    const record = async (): Promise<void> => {
-      await load();
-      const current = runtime().session.getSessionStats();
-      const signature = `${current.sessionId}:${current.totalMessages}:${finiteCost(current.cost)}`;
-      if (entries.some((entry) => `${entry.sessionId}:${entry.messages}:${entry.cost}` === signature)) return;
-      entries = upsertCostEntry(
-        entries,
-        {
-          sessionId: current.sessionId,
-          cost: finiteCost(current.cost),
-          tokens: current.tokens.total,
-          messages: current.totalMessages,
-          recordedAt: new Date().toISOString(),
-        },
-        entryLimit,
-      );
-      await persist();
-    };
-    const readReport = async (): Promise<CostMeterReport> => {
-      await load();
-      await pendingRecord;
-      return reportFor(entries, runtime().session.getSessionStats(), budgetValue);
-    };
-    const unsubscribe = context.on("pi/session-event", (event) => {
-      if (event.type === "agent_end") pendingRecord = record();
-    });
-    const unregister = context.piTools.register(
-      defineTool({
-        name: "cost_report",
-        label: "Cost report",
-        description: "Inspect current-session, daily, and persisted local model cost usage with an optional daily budget.",
-        promptSnippet: "inspect session and daily model cost usage",
-        parameters: Type.Object({ refresh: Type.Optional(Type.Boolean({ description: "Record the current completed session before reporting" })) }),
-        async execute(_toolCallId, params): Promise<AgentToolResult<CostMeterReport>> {
-          if (params.refresh === true) await record();
-          const report = await readReport();
-          return {
-            content: [{ type: "text", text: `Today cost $${report.todayCost.toFixed(4)}; current session $${report.sessionCost.toFixed(4)}.` }],
-            details: report,
-          };
-        },
-      }),
-    );
-    const disposePanel = context.piPluginUi.register({
-      id: "cost-meter-panel",
-      pluginId: "@pi-harness/core/plugins/cost-meter",
-      title: "Cost Meter",
-      description: "查看当前会话、今日和历史成本，并监控每日预算。",
-      icon: "¤",
-      read: readReport,
-    });
-    context.effect(() => () => {
-      unsubscribe();
-      unregister();
-      disposePanel();
-    });
-  },
-};