@pi-harness/pi-harness 0.1.14 → 0.1.15

package/packages/core/dist/plugins/colleague-skill.js

@@ -1,129 +0,0 @@
-import { randomUUID } from "node:crypto";
-import { Type } from "@earendil-works/pi-ai";
-import { defineTool } from "@earendil-works/pi-coding-agent";
-import { EmptyConfig } from "../config.js";
-const customType = "pi-harness/colleague-handoff";
-const maxRoleLength = 128;
-const maxObjectiveLength = 4_000;
-const maxContextLength = 4_000;
-const maxListTextLength = 1_000;
-const maxFileLength = 4_096;
-const maxListItems = 20;
-function boundedText(value, field, maximum, required = false) {
-    if (value === undefined && !required)
-        return "";
-    if (typeof value !== "string")
-        throw new Error(`${field} must be a string`);
-    const text = value.trim();
-    if (required && text.length === 0)
-        throw new Error(`${field} is required`);
-    if (text.length > maximum)
-        throw new Error(`${field} must be ${maximum} characters or fewer`);
-    if (text.includes("\0"))
-        throw new Error(`${field} must not contain null bytes`);
-    return text;
-}
-function boundedList(values, field, itemMaximum) {
-    if (values === undefined)
-        return [];
-    if (!Array.isArray(values))
-        throw new Error(`${field} must be an array`);
-    if (values.length > maxListItems)
-        throw new Error(`${field} must contain ${maxListItems} items or fewer`);
-    return values.map((value) => boundedText(value, `${field} item`, itemMaximum, true));
-}
-export function createColleagueHandoff(input, id, createdAt) {
-    if (input === null || typeof input !== "object" || Array.isArray(input))
-        throw new Error("Handoff input must be an object");
-    const value = input;
-    const toRole = boundedText(value.toRole, "toRole", maxRoleLength, true);
-    const objective = boundedText(value.objective, "objective", maxObjectiveLength, true);
-    const validatedId = boundedText(id, "handoff id", 128, true);
-    const validatedCreatedAt = boundedText(createdAt, "createdAt", 64, true);
-    if (!Number.isFinite(Date.parse(validatedCreatedAt)))
-        throw new Error("createdAt must be a valid timestamp");
-    return {
-        id: validatedId,
-        toRole,
-        objective,
-        context: boundedText(value.context, "context", maxContextLength),
-        constraints: boundedList(value.constraints, "constraints", maxListTextLength),
-        files: boundedList(value.files, "files", maxFileLength),
-        acceptance: boundedList(value.acceptance, "acceptance", maxListTextLength),
-        createdAt: validatedCreatedAt,
-    };
-}
-function readLatest(context) {
-    const entries = context.piSession.manager.getEntries();
-    for (let index = entries.length - 1; index >= 0; index -= 1) {
-        const entry = entries[index];
-        if (entry?.type !== "custom" || entry.customType !== customType || entry.data === null || typeof entry.data !== "object")
-            continue;
-        const value = entry.data;
-        if (typeof value.id !== "string" || typeof value.createdAt !== "string")
-            continue;
-        try {
-            return createColleagueHandoff(value, value.id, value.createdAt);
-        }
-        catch {
-            continue;
-        }
-    }
-    return undefined;
-}
-function throwIfAborted(signal) {
-    if (!signal.aborted)
-        return;
-    throw signal.reason instanceof Error ? signal.reason : new Error("Colleague handoff was cancelled", { cause: signal.reason });
-}
-export default {
-    name: "pi-colleague-skill",
-    inject: ["piSession", "piPluginUi", "piTools"],
-    Config: EmptyConfig,
-    apply(context) {
-        const lifecycle = new AbortController();
-        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", minLength: 1, maxLength: maxRoleLength }),
-                objective: Type.String({ description: "The concrete outcome the colleague should deliver", minLength: 1, maxLength: maxObjectiveLength }),
-                context: Type.Optional(Type.String({ maxLength: maxContextLength })),
-                constraints: Type.Optional(Type.Array(Type.String({ minLength: 1, maxLength: maxListTextLength }), { maxItems: maxListItems })),
-                files: Type.Optional(Type.Array(Type.String({ minLength: 1, maxLength: maxFileLength }), { maxItems: maxListItems })),
-                acceptance: Type.Optional(Type.Array(Type.String({ minLength: 1, maxLength: maxListTextLength }), { maxItems: maxListItems })),
-            }, { additionalProperties: false }),
-            executionMode: "sequential",
-            execute(_toolCallId, params, signal) {
-                return Promise.resolve().then(() => {
-                    const actionSignal = signal === undefined ? lifecycle.signal : AbortSignal.any([signal, lifecycle.signal]);
-                    throwIfAborted(actionSignal);
-                    const handoff = createColleagueHandoff(params, `handoff-${Date.now()}-${randomUUID().slice(0, 8)}`, new Date().toISOString());
-                    context.piSession.manager.appendCustomEntry(customType, structuredClone(handoff));
-                    latest = handoff;
-                    return {
-                        content: [{ type: "text", text: `Handoff ${handoff.id} prepared for ${handoff.toRole}.` }],
-                        details: structuredClone(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 === undefined ? null : structuredClone(latest) }),
-        });
-        context.effect(() => () => {
-            lifecycle.abort(new Error("Colleague Skill plugin disposed"));
-            unregister();
-            disposePanel();
-        });
-    },
-};
-//# sourceMappingURL=colleague-skill.js.map

package/packages/core/dist/plugins/colleague-skill.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"colleague-skill.js","sourceRoot":"","sources":["../../src/plugins/colleague-skill.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAwB,MAAM,iCAAiC,CAAC;AACnF,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,MAAM,UAAU,GAAG,8BAA8B,CAAC;AAClD,MAAM,aAAa,GAAG,GAAG,CAAC;AAC1B,MAAM,kBAAkB,GAAG,KAAK,CAAC;AACjC,MAAM,gBAAgB,GAAG,KAAK,CAAC;AAC/B,MAAM,iBAAiB,GAAG,KAAK,CAAC;AAChC,MAAM,aAAa,GAAG,KAAK,CAAC;AAC5B,MAAM,YAAY,GAAG,EAAE,CAAC;AAsBxB,SAAS,WAAW,CAAC,KAAc,EAAE,KAAa,EAAE,OAAe,EAAE,QAAQ,GAAG,KAAK;IACnF,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,CAAC;IAChD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,mBAAmB,CAAC,CAAC;IAC5E,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC1B,IAAI,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,cAAc,CAAC,CAAC;IAC3E,IAAI,IAAI,CAAC,MAAM,GAAG,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,YAAY,OAAO,sBAAsB,CAAC,CAAC;IAC9F,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,8BAA8B,CAAC,CAAC;IACjF,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,WAAW,CAAC,MAAe,EAAE,KAAa,EAAE,WAAmB;IACtE,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACpC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,mBAAmB,CAAC,CAAC;IACzE,IAAI,MAAM,CAAC,MAAM,GAAG,YAAY;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,iBAAiB,YAAY,iBAAiB,CAAC,CAAC;IAC1G,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,KAAK,EAAE,GAAG,KAAK,OAAO,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC;AACvF,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,KAAc,EAAE,EAAU,EAAE,SAAiB;IAClF,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IAC5H,MAAM,KAAK,GAAG,KAAgC,CAAC;IAC/C,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,IAAI,CAAC,CAAC;IACxE,MAAM,SAAS,GAAG,WAAW,CAAC,KAAK,CAAC,SAAS,EAAE,WAAW,EAAE,kBAAkB,EAAE,IAAI,CAAC,CAAC;IACtF,MAAM,WAAW,GAAG,WAAW,CAAC,EAAE,EAAE,YAAY,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;IAC7D,MAAM,kBAAkB,GAAG,WAAW,CAAC,SAAS,EAAE,WAAW,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;IACzE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IAC7G,OAAO;QACL,EAAE,EAAE,WAAW;QACf,MAAM;QACN,SAAS;QACT,OAAO,EAAE,WAAW,CAAC,KAAK,CAAC,OAAO,EAAE,SAAS,EAAE,gBAAgB,CAAC;QAChE,WAAW,EAAE,WAAW,CAAC,KAAK,CAAC,WAAW,EAAE,aAAa,EAAE,iBAAiB,CAAC;QAC7E,KAAK,EAAE,WAAW,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,aAAa,CAAC;QACvD,UAAU,EAAE,WAAW,CAAC,KAAK,CAAC,UAAU,EAAE,YAAY,EAAE,iBAAiB,CAAC;QAC1E,SAAS,EAAE,kBAAkB;KAC9B,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,OAAgB;IAClC,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;IACvD,KAAK,IAAI,KAAK,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC5D,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;QAC7B,IAAI,KAAK,EAAE,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,UAAU,KAAK,UAAU,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;YAAE,SAAS;QACnI,MAAM,KAAK,GAAG,KAAK,CAAC,IAA+B,CAAC;QACpD,IAAI,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ,IAAI,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ;YAAE,SAAS;QAClF,IAAI,CAAC;YACH,OAAO,sBAAsB,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;QAClE,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;IACH,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,cAAc,CAAC,MAAmB;IACzC,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO;IAC5B,MAAM,MAAM,CAAC,MAAM,YAAY,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,iCAAiC,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;AAChI,CAAC;AAED,eAAe;IACb,IAAI,EAAE,oBAAoB;IAC1B,MAAM,EAAE,CAAC,WAAW,EAAE,YAAY,EAAE,SAAS,CAAC;IAC9C,MAAM,EAAE,WAAW;IACnB,KAAK,CAAC,OAAgB;QACpB,MAAM,SAAS,GAAG,IAAI,eAAe,EAAE,CAAC;QACxC,IAAI,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;QACjC,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CACzC,UAAU,CAAC;YACT,IAAI,EAAE,mBAAmB;YACzB,KAAK,EAAE,mBAAmB;YAC1B,WAAW,EAAE,4HAA4H;YACzI,aAAa,EAAE,mDAAmD;YAClE,UAAU,EAAE,IAAI,CAAC,MAAM,CACrB;gBACE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,kDAAkD,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC;gBAChI,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,mDAAmD,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,kBAAkB,EAAE,CAAC;gBACzI,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,gBAAgB,EAAE,CAAC,CAAC;gBACpE,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,iBAAiB,EAAE,CAAC,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAC;gBAC/H,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAC;gBACrH,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,iBAAiB,EAAE,CAAC,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAC;aAC/H,EACD,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAChC;YACD,aAAa,EAAE,YAAY;YAC3B,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM;gBACjC,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;oBACjC,MAAM,YAAY,GAAG,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;oBAC3G,cAAc,CAAC,YAAY,CAAC,CAAC;oBAC7B,MAAM,OAAO,GAAG,sBAAsB,CAAC,MAAM,EAAE,WAAW,IAAI,CAAC,GAAG,EAAE,IAAI,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;oBAC9H,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,iBAAiB,CAAC,UAAU,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC;oBAClF,MAAM,GAAG,OAAO,CAAC;oBACjB,OAAO;wBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,WAAW,OAAO,CAAC,EAAE,iBAAiB,OAAO,CAAC,MAAM,GAAG,EAAE,CAAC;wBACnG,OAAO,EAAE,eAAe,CAAC,OAAO,CAAC;qBAClC,CAAC;gBACJ,CAAC,CAAC,CAAC;YACL,CAAC;SACF,CAAC,CACH,CAAC;QACF,MAAM,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC;YAC/C,EAAE,EAAE,uBAAuB;YAC3B,QAAQ,EAAE,0CAA0C;YACpD,KAAK,EAAE,iBAAiB;YACxB,WAAW,EAAE,8BAA8B;YAC3C,IAAI,EAAE,GAAG;YACT,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC;SAChF,CAAC,CAAC;QACH,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE;YACxB,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC,CAAC;YAC9D,UAAU,EAAE,CAAC;YACb,YAAY,EAAE,CAAC;QACjB,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

package/packages/core/dist/plugins/context-doctor.d.ts

@@ -1,35 +0,0 @@
-import type { Context } from "@deepseek-ai/cordis";
-import z from "@deepseek-ai/schemastery";
-type ContextDoctorReport = {
-    status: "ok" | "warning";
-    usagePercent: number | null;
-    tokens: number | null;
-    contextWindow: number | null;
-    messageCount: number;
-    scannedMessages: number;
-    messagesTruncated: boolean;
-    oversizedMessages: number;
-    uninspectableMessages: number;
-    toolErrors: number;
-    warnPercent: number;
-    maxMessageBytes: number;
-    recommendations: string[];
-};
-export interface ContextDoctorPluginConfig {
-    warnPercent?: number;
-    maxMessageBytes?: number;
-}
-export declare const Config: z<ContextDoctorPluginConfig>;
-export declare function inspectMessages(messages: readonly unknown[], usage: {
-    percent?: number | null;
-    tokens?: number | null;
-    contextWindow?: number | null;
-} | undefined, warnPercent: number, maxMessageBytes: number): ContextDoctorReport;
-declare const _default: {
-    name: string;
-    inject: string[];
-    Config: z<ContextDoctorPluginConfig>;
-    apply(context: Context, config?: ContextDoctorPluginConfig): void;
-};
-export default _default;
-//# sourceMappingURL=context-doctor.d.ts.map

package/packages/core/dist/plugins/context-doctor.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"context-doctor.d.ts","sourceRoot":"","sources":["../../src/plugins/context-doctor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,CAAC,MAAM,0BAA0B,CAAC;AAIzC,KAAK,mBAAmB,GAAG;IACzB,MAAM,EAAE,IAAI,GAAG,SAAS,CAAC;IACzB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B,CAAC;AAwBF,MAAM,WAAW,yBAAyB;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,eAAO,MAAM,MAAM,EAAE,CAAC,CAAC,yBAAyB,CAQ9C,CAAC;AAmKH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,SAAS,OAAO,EAAE,EAC5B,KAAK,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,SAAS,EACrG,WAAW,EAAE,MAAM,EACnB,eAAe,EAAE,MAAM,GACtB,mBAAmB,CA+CrB;;;;;mBAMgB,OAAO,WAAU,yBAAyB;;AAJ3D,wBAqNE"}

package/packages/core/dist/plugins/context-doctor.js

@@ -1,459 +0,0 @@
-import z from "@deepseek-ai/schemastery";
-import { Type } from "@earendil-works/pi-ai";
-import { defineTool } from "@earendil-works/pi-coding-agent";
-const defaultWarnPercent = 75;
-const defaultMaxMessageBytes = 64 * 1024;
-const maxScannedMessages = 10_000;
-const maxJsonDepth = 64;
-const maxJsonNodes = 10_000;
-const maxJsonNodesPerAudit = 100_000;
-const toolParameterNames = new Set(["compact", "confirm"]);
-const maxErrorLength = 2_000;
-export const Config = z.object({
-    warnPercent: z.number().min(1).max(100).default(defaultWarnPercent),
-    maxMessageBytes: z
-        .number()
-        .min(1024)
-        .max(1024 * 1024)
-        .step(1)
-        .default(defaultMaxMessageBytes),
-});
-function measureJsonBytes(value, maximum, auditBudget) {
-    const ancestors = new WeakSet();
-    let nodes = 0;
-    const uninspectable = () => ({ bytes: maximum + 1, inspectable: false, omitted: false });
-    const measure = (current, depth, arrayItem) => {
-        nodes += 1;
-        auditBudget.remaining -= 1;
-        if (nodes > maxJsonNodes || auditBudget.remaining < 0 || depth > maxJsonDepth)
-            return uninspectable();
-        if (current === null)
-            return { bytes: 4, inspectable: true, omitted: false };
-        if (typeof current === "string")
-            return { bytes: Buffer.byteLength(JSON.stringify(current), "utf8"), inspectable: true, omitted: false };
-        if (typeof current === "boolean")
-            return { bytes: current ? 4 : 5, inspectable: true, omitted: false };
-        if (typeof current === "number")
-            return { bytes: Buffer.byteLength(JSON.stringify(current), "utf8"), inspectable: true, omitted: false };
-        if (current === undefined || typeof current === "function" || typeof current === "symbol")
-            return arrayItem ? { bytes: 4, inspectable: true, omitted: false } : { bytes: 0, inspectable: true, omitted: true };
-        if (typeof current === "bigint")
-            return uninspectable();
-        if (ancestors.has(current))
-            return uninspectable();
-        let prototype;
-        let descriptors;
-        try {
-            prototype = Object.getPrototypeOf(current);
-            descriptors = Object.getOwnPropertyDescriptors(current);
-        }
-        catch {
-            return uninspectable();
-        }
-        const isArray = Array.isArray(current);
-        if (isArray ? prototype !== Array.prototype && prototype !== null : prototype !== Object.prototype && prototype !== null)
-            return uninspectable();
-        const toJson = descriptors.toJSON;
-        if (toJson !== undefined && (!("value" in toJson) || typeof toJson.value === "function"))
-            return uninspectable();
-        if (prototype === Array.prototype || prototype === Object.prototype) {
-            const inheritedToJson = Object.getOwnPropertyDescriptor(prototype, "toJSON");
-            if (inheritedToJson !== undefined && (!("value" in inheritedToJson) || typeof inheritedToJson.value === "function"))
-                return uninspectable();
-        }
-        ancestors.add(current);
-        let bytes = 2;
-        let emitted = 0;
-        if (isArray) {
-            const lengthDescriptor = descriptors.length;
-            if (lengthDescriptor === undefined || !("value" in lengthDescriptor) || !Number.isSafeInteger(lengthDescriptor.value) || lengthDescriptor.value < 0) {
-                ancestors.delete(current);
-                return uninspectable();
-            }
-            const length = lengthDescriptor.value;
-            for (let index = 0; index < length; index += 1) {
-                const descriptor = descriptors[String(index)];
-                if (descriptor !== undefined && !("value" in descriptor)) {
-                    ancestors.delete(current);
-                    return uninspectable();
-                }
-                const child = measure(descriptor === undefined ? undefined : descriptor.value, depth + 1, true);
-                if (!child.inspectable) {
-                    ancestors.delete(current);
-                    return child;
-                }
-                bytes += child.bytes + (index === 0 ? 0 : 1);
-                if (bytes > maximum)
-                    break;
-            }
-        }
-        else {
-            for (const [key, descriptor] of Object.entries(descriptors)) {
-                if (!descriptor.enumerable)
-                    continue;
-                if (!("value" in descriptor)) {
-                    ancestors.delete(current);
-                    return uninspectable();
-                }
-                const child = measure(descriptor.value, depth + 1, false);
-                if (!child.inspectable) {
-                    ancestors.delete(current);
-                    return child;
-                }
-                if (child.omitted)
-                    continue;
-                bytes += Buffer.byteLength(JSON.stringify(key), "utf8") + 1 + child.bytes + (emitted === 0 ? 0 : 1);
-                emitted += 1;
-                if (bytes > maximum)
-                    break;
-            }
-        }
-        ancestors.delete(current);
-        return { bytes, inspectable: true, omitted: false };
-    };
-    try {
-        return measure(value, 0, false);
-    }
-    catch {
-        return uninspectable();
-    }
-}
-function dataProperty(value, key) {
-    try {
-        const descriptor = Object.getOwnPropertyDescriptor(value, key);
-        return descriptor !== undefined && "value" in descriptor ? descriptor.value : undefined;
-    }
-    catch {
-        return undefined;
-    }
-}
-function normalizeWarnPercent(value) {
-    return typeof value === "number" && Number.isFinite(value) ? Math.max(1, Math.min(100, value)) : defaultWarnPercent;
-}
-function normalizeMaxMessageBytes(value) {
-    return typeof value === "number" && Number.isSafeInteger(value) ? Math.max(1, Math.min(1024 * 1024, value)) : defaultMaxMessageBytes;
-}
-function nonNegativeInteger(value) {
-    return typeof value === "number" && Number.isSafeInteger(value) && value >= 0 ? value : null;
-}
-function validPercent(value) {
-    return typeof value === "number" && Number.isFinite(value) && value >= 0 ? value : null;
-}
-function cloneReport(report) {
-    return { ...report, recommendations: [...report.recommendations] };
-}
-function boundedError(error) {
-    if (typeof error === "string")
-        return error.slice(0, maxErrorLength);
-    if (error !== null && typeof error === "object") {
-        const message = dataProperty(error, "message");
-        if (typeof message === "string")
-            return message.slice(0, maxErrorLength);
-    }
-    return "Unknown context compaction error";
-}
-function throwIfAborted(signal) {
-    if (!signal.aborted)
-        return;
-    throw signal.reason instanceof Error ? signal.reason : new Error("Context Doctor operation was cancelled", { cause: signal.reason });
-}
-function waitForOperation(operation, signal) {
-    if (signal.aborted)
-        return Promise.reject(signal.reason instanceof Error ? signal.reason : new Error("Context Doctor operation was cancelled", { cause: signal.reason }));
-    return new Promise((resolve, reject) => {
-        const onAbort = () => {
-            reject(signal.reason instanceof Error ? signal.reason : new Error("Context Doctor operation was cancelled", { cause: signal.reason }));
-        };
-        signal.addEventListener("abort", onAbort, { once: true });
-        void operation.then(resolve, reject).finally(() => {
-            signal.removeEventListener("abort", onAbort);
-        });
-    });
-}
-function parseToolParams(value) {
-    if (value === null || typeof value !== "object" || Array.isArray(value))
-        throw new Error("Context Doctor parameters must be an object");
-    const prototype = Object.getPrototypeOf(value);
-    if (prototype !== Object.prototype && prototype !== null)
-        throw new Error("Context Doctor parameters must be a plain object");
-    const descriptors = Object.getOwnPropertyDescriptors(value);
-    if (Reflect.ownKeys(descriptors).some((key) => typeof key !== "string" || !toolParameterNames.has(key)))
-        throw new Error("Context Doctor parameters contain an unknown property");
-    if (Object.values(descriptors).some((descriptor) => !("value" in descriptor)))
-        throw new Error("Context Doctor parameters must use data properties");
-    const compact = descriptors.compact?.value;
-    const confirm = descriptors.confirm?.value;
-    if (compact !== undefined && typeof compact !== "boolean")
-        throw new Error("compact must be a boolean");
-    if (confirm !== undefined && typeof confirm !== "boolean")
-        throw new Error("confirm must be a boolean");
-    if (compact === true && confirm !== true)
-        throw new Error("Context compaction requires confirm=true");
-    return { compact: compact === true };
-}
-export function inspectMessages(messages, usage, warnPercent, maxMessageBytes) {
-    const normalizedWarnPercent = normalizeWarnPercent(warnPercent);
-    const normalizedMaxMessageBytes = normalizeMaxMessageBytes(maxMessageBytes);
-    const rawMessageCount = dataProperty(messages, "length");
-    const messageCount = typeof rawMessageCount === "number" && Number.isSafeInteger(rawMessageCount) && rawMessageCount >= 0 ? rawMessageCount : 0;
-    const scannedMessages = Math.min(messageCount, maxScannedMessages);
-    const start = messageCount - scannedMessages;
-    let oversizedMessages = 0;
-    let uninspectableMessages = 0;
-    let toolErrors = 0;
-    const auditBudget = { remaining: maxJsonNodesPerAudit };
-    for (let index = start; index < messageCount; index += 1) {
-        const descriptor = Object.getOwnPropertyDescriptor(messages, String(index));
-        if (descriptor !== undefined && !("value" in descriptor)) {
-            oversizedMessages += 1;
-            uninspectableMessages += 1;
-            continue;
-        }
-        const message = descriptor?.value;
-        const measurement = measureJsonBytes(message, normalizedMaxMessageBytes, auditBudget);
-        if (!measurement.inspectable)
-            uninspectableMessages += 1;
-        if (!measurement.inspectable || (!measurement.omitted && measurement.bytes > normalizedMaxMessageBytes))
-            oversizedMessages += 1;
-        if (typeof message === "object" && message !== null && dataProperty(message, "role") === "toolResult" && dataProperty(message, "isError") === true)
-            toolErrors += 1;
-    }
-    const usagePercent = validPercent(usage === undefined ? undefined : dataProperty(usage, "percent"));
-    const recommendations = [];
-    if (usagePercent !== null && usagePercent >= normalizedWarnPercent)
-        recommendations.push("压缩较早的会话历史，释放上下文空间。");
-    const byteLimitExceededMessages = oversizedMessages - uninspectableMessages;
-    if (byteLimitExceededMessages > 0)
-        recommendations.push(`检查 ${byteLimitExceededMessages} 条超大消息，优先引用摘要或文件路径。`);
-    if (uninspectableMessages > 0)
-        recommendations.push(`检查 ${uninspectableMessages} 条无法安全测量的消息，其结构可能过深、循环或包含访问器。`);
-    if (toolErrors > 0)
-        recommendations.push(`处理 ${toolErrors} 个工具错误后再继续长任务。`);
-    return {
-        status: recommendations.length === 0 ? "ok" : "warning",
-        usagePercent,
-        tokens: nonNegativeInteger(usage === undefined ? undefined : dataProperty(usage, "tokens")),
-        contextWindow: nonNegativeInteger(usage === undefined ? undefined : dataProperty(usage, "contextWindow")),
-        messageCount,
-        scannedMessages,
-        messagesTruncated: messageCount > scannedMessages,
-        oversizedMessages,
-        uninspectableMessages,
-        toolErrors,
-        warnPercent: normalizedWarnPercent,
-        maxMessageBytes: normalizedMaxMessageBytes,
-        recommendations,
-    };
-}
-export default {
-    name: "pi-context-doctor",
-    inject: ["piPluginUi", "piTools"],
-    Config,
-    apply(context, config = {}) {
-        const warnPercent = normalizeWarnPercent(config.warnPercent);
-        const maxMessageBytes = Math.max(1024, normalizeMaxMessageBytes(config.maxMessageBytes));
-        const lifecycle = new AbortController();
-        let compaction = { status: "idle" };
-        let active;
-        let queued;
-        const runtime = () => context.get("piRuntime");
-        let cachedSession;
-        let cachedReport = inspectMessages([], undefined, warnPercent, maxMessageBytes);
-        const refreshReport = () => {
-            const service = runtime();
-            cachedSession = service?.session;
-            let usage;
-            if (service !== undefined) {
-                try {
-                    usage = service.session.getContextUsage();
-                }
-                catch {
-                    usage = undefined;
-                }
-            }
-            cachedReport =
-                service === undefined
-                    ? inspectMessages([], undefined, warnPercent, maxMessageBytes)
-                    : inspectMessages(service.session.messages, usage, warnPercent, maxMessageBytes);
-            return cloneReport(cachedReport);
-        };
-        const cancelQueuedForSessionChange = (session) => {
-            if (queued === undefined || queued.session === session)
-                return;
-            const request = queued;
-            queued = undefined;
-            request.removeAbortListener();
-            compaction = {
-                status: "cancelled",
-                requestedAt: request.requestedAt,
-                finishedAt: new Date().toISOString(),
-                error: "Session changed before the queued context compaction could start",
-            };
-        };
-        const report = () => {
-            const service = runtime();
-            cancelQueuedForSessionChange(service?.session);
-            if (service?.session !== cachedSession)
-                return refreshReport();
-            return cloneReport(cachedReport);
-        };
-        refreshReport();
-        const details = (compacted) => ({ ...report(), compacted, compaction: { ...compaction } });
-        const startCompaction = (session, signal, requestedAt) => {
-            const startedAt = new Date().toISOString();
-            compaction = { status: "running", requestedAt, startedAt };
-            const operation = Promise.resolve().then(async () => {
-                throwIfAborted(signal);
-                const cancellableSession = session;
-                const abort = () => {
-                    cancellableSession.abortCompaction?.();
-                };
-                signal.addEventListener("abort", abort, { once: true });
-                try {
-                    await session.compact();
-                    compaction = { status: "completed", requestedAt, startedAt, finishedAt: new Date().toISOString() };
-                    refreshReport();
-                }
-                catch (error) {
-                    compaction = {
-                        status: signal.aborted ? "cancelled" : "failed",
-                        requestedAt,
-                        startedAt,
-                        finishedAt: new Date().toISOString(),
-                        error: boundedError(error),
-                    };
-                    refreshReport();
-                    throw error;
-                }
-                finally {
-                    signal.removeEventListener("abort", abort);
-                }
-            });
-            active = operation;
-            void operation.then(() => {
-                if (active === operation)
-                    active = undefined;
-            }, () => {
-                if (active === operation)
-                    active = undefined;
-            });
-            return operation;
-        };
-        const unsubscribe = context.on("pi/session-event", (event) => {
-            const eventType = dataProperty(event, "type");
-            if (typeof eventType !== "string")
-                return;
-            cancelQueuedForSessionChange(runtime()?.session);
-            if (["message_end", "tool_execution_end", "agent_end", "agent_settled", "compaction_end", "entry_appended"].includes(eventType))
-                refreshReport();
-            if (eventType !== "agent_settled" || queued === undefined)
-                return;
-            const request = queued;
-            queued = undefined;
-            request.removeAbortListener();
-            const service = runtime();
-            if (service === undefined || service.session !== request.session) {
-                compaction = {
-                    status: "cancelled",
-                    requestedAt: request.requestedAt,
-                    finishedAt: new Date().toISOString(),
-                    error: "Session changed before the queued context compaction could start",
-                };
-                return;
-            }
-            void startCompaction(service.session, request.signal, request.requestedAt).catch(() => undefined);
-        });
-        context.effect(() => () => {
-            lifecycle.abort(new Error("Context Doctor plugin disposed"));
-            if (queued !== undefined) {
-                queued.removeAbortListener();
-                queued = undefined;
-            }
-            unsubscribe();
-        });
-        const unregisterTool = context.piTools.register(defineTool({
-            name: "context_doctor",
-            label: "Context doctor",
-            description: "Audit context pressure, oversized or uninspectable messages, and tool errors; confirmed compaction is queued until the active agent has settled.",
-            promptSnippet: "audit context pressure and recommend safe cleanup",
-            promptGuidelines: ["Set compact=true only with confirm=true after the user approves model-backed compaction that may incur usage and cost."],
-            parameters: Type.Object({
-                compact: Type.Optional(Type.Boolean({ description: "Compact with the active model after the audit; this may incur cost" })),
-                confirm: Type.Optional(Type.Boolean({ description: "Must be true when compact is requested" })),
-            }, { additionalProperties: false }),
-            executionMode: "sequential",
-            async execute(_toolCallId, params, signal) {
-                const request = parseToolParams(params);
-                const actionSignal = signal === undefined ? lifecycle.signal : AbortSignal.any([signal, lifecycle.signal]);
-                throwIfAborted(actionSignal);
-                const service = runtime();
-                if (service === undefined)
-                    throw new Error("Pi runtime is not ready");
-                refreshReport();
-                if (request.compact) {
-                    if (active !== undefined || queued !== undefined)
-                        throw new Error("A context compaction is already in progress");
-                    const requestedAt = new Date().toISOString();
-                    if (service.session.isIdle === false) {
-                        const onAbort = () => {
-                            if (queued?.signal !== actionSignal)
-                                return;
-                            queued = undefined;
-                            compaction = {
-                                status: "cancelled",
-                                requestedAt,
-                                finishedAt: new Date().toISOString(),
-                                error: "Context compaction was cancelled before it started",
-                            };
-                        };
-                        actionSignal.addEventListener("abort", onAbort, { once: true });
-                        queued = {
-                            session: service.session,
-                            signal: actionSignal,
-                            requestedAt,
-                            removeAbortListener: () => actionSignal.removeEventListener("abort", onAbort),
-                        };
-                        compaction = { status: "queued", requestedAt };
-                        const queuedDetails = details(false);
-                        return {
-                            content: [{ type: "text", text: "Context compaction queued until the current agent run settles." }],
-                            details: queuedDetails,
-                        };
-                    }
-                    await waitForOperation(startCompaction(service.session, actionSignal, requestedAt), actionSignal);
-                }
-                const resultDetails = details(request.compact);
-                return {
-                    content: [
-                        {
-                            type: "text",
-                            text: `${resultDetails.status}: ${resultDetails.messageCount} messages, ${resultDetails.oversizedMessages} oversized, ${resultDetails.toolErrors} tool errors.`,
-                        },
-                    ],
-                    details: resultDetails,
-                };
-            },
-        }));
-        context.effect(() => unregisterTool);
-        const disposePanel = context.piPluginUi.register({
-            id: "context-doctor-panel",
-            pluginId: "@pi-harness/core/plugins/context-doctor",
-            title: "Context Doctor",
-            description: "安全审计上下文压力、超大或不可测量消息和工具错误，并展示确认压缩的生命周期。",
-            icon: "⌁",
-            read: () => ({
-                ...report(),
-                compaction: { ...compaction },
-                limits: {
-                    scannedMessages: maxScannedMessages,
-                    jsonDepth: maxJsonDepth,
-                    jsonNodesPerMessage: maxJsonNodes,
-                    jsonNodesPerAudit: maxJsonNodesPerAudit,
-                    errorCharacters: maxErrorLength,
-                },
-            }),
-        });
-        context.effect(() => disposePanel);
-    },
-};
-//# sourceMappingURL=context-doctor.js.map