@pi-harness/pi-harness 0.1.2 → 0.1.3

package/packages/core/dist/plugins/session-insights.js

@@ -0,0 +1,47 @@
+import { Type } from "@earendil-works/pi-ai";
+import { defineTool } from "@earendil-works/pi-coding-agent";
+export default {
+    name: "pi-session-insights",
+    inject: ["piPluginUi", "piTools"],
+    apply(context) {
+        const runtime = () => context.get("piRuntime");
+        const readStats = () => {
+            const service = runtime();
+            if (service === undefined)
+                throw new Error("Pi runtime is not ready");
+            return service.session.getSessionStats();
+        };
+        const unregisterTool = context.piTools.register(defineTool({
+            name: "session_report",
+            label: "Session report",
+            description: "Inspect the current session token, message, tool, cost, and context statistics.",
+            promptSnippet: "inspect current session usage and context statistics",
+            parameters: Type.Object({ compact: Type.Optional(Type.Boolean({ description: "Compact the session when true" })) }),
+            async execute(_toolCallId, params) {
+                const service = runtime();
+                if (service === undefined)
+                    throw new Error("Pi runtime is not ready");
+                if (params.compact === true)
+                    await service.session.compact();
+                const report = readStats();
+                return {
+                    content: [{ type: "text", text: `Session has ${report.totalMessages} messages and ${report.tokens.total} tracked tokens.` }],
+                    details: report,
+                };
+            },
+        }));
+        const disposePanel = context.piPluginUi.register({
+            id: "session-insights-panel",
+            pluginId: "@pi-harness/core/plugins/session-insights",
+            title: "Session Insights",
+            description: "查看当前会话的消息、工具、token、成本和上下文统计，并可触发压缩。",
+            icon: "▥",
+            read: readStats,
+        });
+        context.effect(() => () => {
+            unregisterTool();
+            disposePanel();
+        });
+    },
+};
+//# sourceMappingURL=session-insights.js.map

package/packages/core/dist/plugins/session-insights.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-insights.js","sourceRoot":"","sources":["../../src/plugins/session-insights.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAA2C,MAAM,iCAAiC,CAAC;AAEtG,eAAe;IACb,IAAI,EAAE,qBAAqB;IAC3B,MAAM,EAAE,CAAC,YAAY,EAAE,SAAS,CAAC;IACjC,KAAK,CAAC,OAAgB;QACpB,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC/C,MAAM,SAAS,GAAG,GAAiB,EAAE;YACnC,MAAM,OAAO,GAAG,OAAO,EAAE,CAAC;YAC1B,IAAI,OAAO,KAAK,SAAS;gBAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;YACtE,OAAO,OAAO,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC;QAC3C,CAAC,CAAC;QACF,MAAM,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAC7C,UAAU,CAAC;YACT,IAAI,EAAE,gBAAgB;YACtB,KAAK,EAAE,gBAAgB;YACvB,WAAW,EAAE,iFAAiF;YAC9F,aAAa,EAAE,sDAAsD;YACrE,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,+BAA+B,EAAE,CAAC,CAAC,EAAE,CAAC;YACnH,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM;gBAC/B,MAAM,OAAO,GAAG,OAAO,EAAE,CAAC;gBAC1B,IAAI,OAAO,KAAK,SAAS;oBAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;gBACtE,IAAI,MAAM,CAAC,OAAO,KAAK,IAAI;oBAAE,MAAM,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;gBAC7D,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;gBAC3B,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,MAAM,CAAC,aAAa,iBAAiB,MAAM,CAAC,MAAM,CAAC,KAAK,kBAAkB,EAAE,CAAC;oBAC5H,OAAO,EAAE,MAAM;iBAChB,CAAC;YACJ,CAAC;SACF,CAAC,CACH,CAAC;QACF,MAAM,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC;YAC/C,EAAE,EAAE,wBAAwB;YAC5B,QAAQ,EAAE,2CAA2C;YACrD,KAAK,EAAE,kBAAkB;YACzB,WAAW,EAAE,qCAAqC;YAClD,IAAI,EAAE,GAAG;YACT,IAAI,EAAE,SAAS;SAChB,CAAC,CAAC;QACH,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE;YACxB,cAAc,EAAE,CAAC;YACjB,YAAY,EAAE,CAAC;QACjB,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

package/packages/core/dist/plugins/session-search.d.ts

@@ -0,0 +1,20 @@
+import type { Context } from "@deepseek-ai/cordis";
+export type SessionSearchHit = {
+    role: string;
+    text: string;
+};
+export type SessionSearchItem = {
+    id: string;
+    name: string;
+    path: string;
+    modified: string;
+    hits: SessionSearchHit[];
+};
+export declare function searchSessionEntries(entries: readonly unknown[], query: string): SessionSearchHit[];
+declare const _default: {
+    name: string;
+    inject: string[];
+    apply(context: Context): void;
+};
+export default _default;
+//# sourceMappingURL=session-search.d.ts.map

package/packages/core/dist/plugins/session-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-search.d.ts","sourceRoot":"","sources":["../../src/plugins/session-search.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAWnD,MAAM,MAAM,gBAAgB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAC9D,MAAM,MAAM,iBAAiB,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,gBAAgB,EAAE,CAAA;CAAE,CAAC;AA0BvH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,SAAS,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAUnG;;;;mBAgCgB,OAAO;;AAHxB,wBA+CE"}

package/packages/core/dist/plugins/session-search.js

@@ -0,0 +1,122 @@
+import { readFile, stat } from "node:fs/promises";
+import { Type } from "@earendil-works/pi-ai";
+import { defineTool, parseSessionEntries, SessionManager } from "@earendil-works/pi-coding-agent";
+const maxQueryLength = 120;
+const maxPreviewLength = 500;
+const maxSessions = 200;
+const maxHits = 100;
+const maxSessionFileBytes = 4 * 1024 * 1024;
+const sessionReadConcurrency = 8;
+function record(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value) ? value : undefined;
+}
+function contentText(value) {
+    if (typeof value === "string")
+        return value.trim();
+    if (!Array.isArray(value))
+        return "";
+    return value
+        .flatMap((part) => {
+        const item = record(part);
+        return item?.type === "text" && typeof item.text === "string" ? [item.text.trim()] : [];
+    })
+        .filter(Boolean)
+        .join("\n");
+}
+function matchingPreview(text, normalizedQuery) {
+    if (text.length <= maxPreviewLength)
+        return text;
+    const matchIndex = text.toLocaleLowerCase().indexOf(normalizedQuery);
+    const idealStart = matchIndex - Math.floor((maxPreviewLength - normalizedQuery.length) / 2);
+    const start = Math.max(0, Math.min(idealStart, text.length - maxPreviewLength));
+    return text.slice(start, start + maxPreviewLength);
+}
+export function searchSessionEntries(entries, query) {
+    const normalized = query.trim().toLocaleLowerCase();
+    if (normalized.length < 1 || normalized.length > maxQueryLength)
+        throw new Error("Session search query must contain 1-120 characters");
+    return entries.flatMap((entry) => {
+        const item = record(entry);
+        const message = record(item?.message);
+        if (item?.type !== "message" || typeof message?.role !== "string")
+            return [];
+        const text = contentText(message.content);
+        return text.toLocaleLowerCase().includes(normalized) ? [{ role: message.role, text: matchingPreview(text, normalized) }] : [];
+    });
+}
+async function searchSession(session, query) {
+    try {
+        const metadata = await stat(session.path);
+        if (!metadata.isFile() || metadata.size > maxSessionFileBytes)
+            return undefined;
+        const hits = searchSessionEntries(parseSessionEntries(await readFile(session.path, "utf8")), query);
+        if (hits.length === 0)
+            return undefined;
+        return {
+            id: session.id,
+            name: session.name?.trim() || session.firstMessage.trim() || session.id,
+            path: session.path,
+            modified: session.modified.toISOString(),
+            hits,
+        };
+    }
+    catch {
+        return undefined;
+    }
+}
+async function searchSessions(sessions, query) {
+    const results = [];
+    for (let index = 0; index < sessions.length; index += sessionReadConcurrency) {
+        const batch = await Promise.all(sessions.slice(index, index + sessionReadConcurrency).map((session) => searchSession(session, query)));
+        results.push(...batch.filter((item) => item !== undefined));
+    }
+    return results;
+}
+export default {
+    name: "pi-session-search",
+    inject: ["piHarnessLaunch", "piSession", "piPluginUi", "piTools"],
+    apply(context) {
+        let latest;
+        const search = async (query) => {
+            const normalized = query.trim();
+            if (normalized.length < 1 || normalized.length > maxQueryLength)
+                throw new Error("Session search query must contain 1-120 characters");
+            const sessions = await SessionManager.list(context.piHarnessLaunch.cwd, context.piSession.manager.getSessionDir());
+            const items = (await searchSessions(sessions.slice(0, maxSessions), normalized)).slice(0, maxHits);
+            latest = { query: normalized, total: items.length, items };
+            return items;
+        };
+        const unregister = context.piTools.register(defineTool({
+            name: "session_search",
+            label: "Search sessions",
+            description: "Search persisted Pi JSONL sessions for a bounded text query without modifying session files.",
+            promptSnippet: "search previous Pi sessions for a phrase",
+            parameters: Type.Object({ query: Type.String({ description: "Text to search for, 1-120 characters" }) }),
+            async execute(_toolCallId, params) {
+                const items = await search(params.query);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: items.map((item) => `${item.name}: ${item.hits.map((hit) => hit.text).join(" | ")}`).join("\n") || "No matching sessions found.",
+                        },
+                    ],
+                    details: latest,
+                };
+            },
+        }));
+        const disposePanel = context.piPluginUi.register({
+            id: "session-search-panel",
+            pluginId: "@pi-harness/core/plugins/session-search",
+            title: "Session Search",
+            description: "跨本地持久化会话搜索文本，只读不修改会话文件。",
+            icon: "⌕",
+            read: () => latest ?? { query: "", total: 0, items: [] },
+        });
+        context.effect(() => () => {
+            unregister();
+            disposePanel();
+        });
+    },
+};
+//# sourceMappingURL=session-search.js.map

package/packages/core/dist/plugins/session-search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-search.js","sourceRoot":"","sources":["../../src/plugins/session-search.ts"],"names":[],"mappings":"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"}

package/packages/core/dist/plugins/session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/plugins/session.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,CAAC,MAAM,0BAA0B,CAAC;AAGzC,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,MAAM,EAAE,CAAC,CAAC,mBAAmB,CAGxC,CAAC;;;;;mBAMc,OAAO,UAAU,mBAAmB;;AAJrD,wBAWE"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/plugins/session.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,CAAC,MAAM,0BAA0B,CAAC;AAIzC,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,MAAM,EAAE,CAAC,CAAC,mBAAmB,CAGxC,CAAC;;;;;mBAMc,OAAO,UAAU,mBAAmB;;AAJrD,wBAYE"}

package/packages/core/dist/plugins/session.js

@@ -1,19 +1,21 @@
 import { join, resolve } from "node:path";
 import z from "@deepseek-ai/schemastery";
 import { SessionManager } from "@earendil-works/pi-coding-agent";
+import { assertKnownConfigKeys } from "../config.js";
 export const Config = z.object({
     storage: z.union(["memory", "jsonl"]).default("jsonl"),
-    directory: z.string(),
+    directory: z.string().min(1),
 });
 export default {
     name: "pi-session",
     inject: ["piHarnessLaunch"],
     Config,
     apply(context, config) {
+        assertKnownConfigKeys("pi-session", config, ["storage", "directory"]);
         const storage = config.storage ?? "jsonl";
         const manager = storage === "memory"
             ? SessionManager.inMemory(context.piHarnessLaunch.cwd)
-            : SessionManager.create(context.piHarnessLaunch.cwd, config.directory === undefined ? join(context.piHarnessLaunch.agentDir, "sessions") : resolve(context.piHarnessLaunch.cwd, config.directory));
+            : SessionManager.create(context.piHarnessLaunch.cwd, config.directory == null ? join(context.piHarnessLaunch.agentDir, "sessions") : resolve(context.piHarnessLaunch.cwd, config.directory));
         context.provide("piSession", { manager });
     },
 };

package/packages/core/dist/plugins/session.js.map

@@ -1 +1 @@
-{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/plugins/session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,CAAC,MAAM,0BAA0B,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAOjE,MAAM,CAAC,MAAM,MAAM,GAA2B,CAAC,CAAC,MAAM,CAAC;IACrD,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;IACtD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;CACtB,CAAC,CAAC;AAEH,eAAe;IACb,IAAI,EAAE,YAAY;IAClB,MAAM,EAAE,CAAC,iBAAiB,CAAC;IAC3B,MAAM;IACN,KAAK,CAAC,OAAgB,EAAE,MAA2B;QACjD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,OAAO,CAAC;QAC1C,MAAM,OAAO,GAAG,OAAO,KAAK,QAAQ;YAClC,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,eAAe,CAAC,GAAG,CAAC;YACtD,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,GAAG,EAAE,MAAM,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,GAAG,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;QACrM,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IAC5C,CAAC;CACF,CAAC"}
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/plugins/session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,CAAC,MAAM,0BAA0B,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAOrD,MAAM,CAAC,MAAM,MAAM,GAA2B,CAAC,CAAC,MAAM,CAAC;IACrD,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;IACtD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC7B,CAAC,CAAC;AAEH,eAAe;IACb,IAAI,EAAE,YAAY;IAClB,MAAM,EAAE,CAAC,iBAAiB,CAAC;IAC3B,MAAM;IACN,KAAK,CAAC,OAAgB,EAAE,MAA2B;QACjD,qBAAqB,CAAC,YAAY,EAAE,MAAM,EAAE,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC;QACtE,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,OAAO,CAAC;QAC1C,MAAM,OAAO,GAAG,OAAO,KAAK,QAAQ;YAClC,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,eAAe,CAAC,GAAG,CAAC;YACtD,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,GAAG,EAAE,MAAM,CAAC,SAAS,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,GAAG,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;QAC/L,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IAC5C,CAAC;CACF,CAAC"}

package/packages/core/dist/plugins/skill-catalog.d.ts

@@ -0,0 +1,26 @@
+import type { Context } from "@deepseek-ai/cordis";
+import { type SkillInjection } from "./reverse-skill.js";
+export interface SkillCatalogItem {
+    name: string;
+    description: string;
+    filePath: string;
+    source: string;
+    scope: string;
+    disabled: boolean;
+}
+export interface SkillCatalogReport {
+    total: number;
+    skills: SkillCatalogItem[];
+    diagnostics: Array<{
+        type: string;
+        message: string;
+    }>;
+}
+export declare function prepareSkillRead(name: string, content: string): SkillInjection;
+declare const _default: {
+    name: string;
+    inject: string[];
+    apply(context: Context): void;
+};
+export default _default;
+//# sourceMappingURL=skill-catalog.d.ts.map

package/packages/core/dist/plugins/skill-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-catalog.d.ts","sourceRoot":"","sources":["../../src/plugins/skill-catalog.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAInD,OAAO,EAAuB,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAK9E,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B,WAAW,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACvD;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,cAAc,CAE9E;;;;mBA+BgB,OAAO;;AAHxB,wBA6DE"}

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

@@ -0,0 +1,97 @@
+import { readFile } from "node:fs/promises";
+import { Type } from "@earendil-works/pi-ai";
+import { defineTool } from "@earendil-works/pi-coding-agent";
+import { buildSkillInjection } from "./reverse-skill.js";
+const maxQueryLength = 120;
+const maxSkillBytes = 128 * 1024;
+export function prepareSkillRead(name, content) {
+    return buildSkillInjection(content, name);
+}
+function queryText(value) {
+    const query = (value ?? "").trim();
+    if (query.length > maxQueryLength)
+        throw new Error(`Skill catalog query must contain 0-${maxQueryLength} characters`);
+    return query.toLocaleLowerCase();
+}
+function readCatalog(context, query) {
+    const loaded = context.piResources.resourceLoader.getSkills();
+    const normalized = queryText(query);
+    const skills = loaded.skills
+        .map((skill) => ({
+        name: skill.name,
+        description: skill.description,
+        filePath: skill.filePath,
+        source: skill.sourceInfo.source,
+        scope: skill.sourceInfo.scope,
+        disabled: skill.disableModelInvocation,
+    }))
+        .filter((skill) => normalized === "" || `${skill.name} ${skill.description} ${skill.source}`.toLocaleLowerCase().includes(normalized));
+    return {
+        total: skills.length,
+        skills,
+        diagnostics: loaded.diagnostics.map((diagnostic) => ({ type: diagnostic.type, message: diagnostic.message })),
+    };
+}
+export default {
+    name: "pi-skill-catalog",
+    inject: ["piResources", "piMcp", "piPluginUi", "piTools"],
+    apply(context) {
+        const readMcp = () => context.piMcp.snapshot();
+        const unregister = context.piTools.register(defineTool({
+            name: "skill_catalog",
+            label: "Skill catalog",
+            description: "Inspect loaded Agent Skills, safely read one skill file through a bounded data boundary, and inspect MCP status without changing configuration.",
+            promptSnippet: "inspect loaded skills or managed MCP server status",
+            parameters: Type.Object({
+                action: Type.Union([Type.Literal("list"), Type.Literal("read"), Type.Literal("mcp")]),
+                query: Type.Optional(Type.String()),
+                name: Type.Optional(Type.String()),
+            }),
+            async execute(_toolCallId, params) {
+                if (params.action === "mcp") {
+                    const result = readMcp();
+                    return {
+                        content: [{ type: "text", text: result.servers.map((server) => `${server.id}: ${server.status}`).join("\n") || "No MCP servers configured." }],
+                        details: result,
+                    };
+                }
+                const report = readCatalog(context, params.query);
+                if (params.action === "list") {
+                    return {
+                        content: [{ type: "text", text: report.skills.map((skill) => `${skill.name}: ${skill.description}`).join("\n") || "No matching skills loaded." }],
+                        details: report,
+                    };
+                }
+                const name = (params.name ?? "").trim();
+                if (name === "")
+                    throw new Error("Skill name is required");
+                const skill = report.skills.find((candidate) => candidate.name === name);
+                if (skill === undefined)
+                    throw new Error(`Skill was not found: ${name}`);
+                const content = await readFile(skill.filePath, "utf8");
+                if (Buffer.byteLength(content, "utf8") > maxSkillBytes)
+                    throw new Error(`Skill file exceeds ${maxSkillBytes} bytes`);
+                const result = prepareSkillRead(name, content);
+                const message = result.content === null ? `Skill ${result.name} was blocked from catalog output (${result.risk}).` : result.content;
+                return { content: [{ type: "text", text: message }], details: result };
+            },
+        }));
+        const disposePanel = context.piPluginUi.register({
+            id: "skill-catalog-panel",
+            pluginId: "@pi-harness/core/plugins/skill-catalog",
+            title: "Skills Catalog",
+            description: "查看当前运行时加载的 Skills 与 MCP 服务器状态。",
+            icon: "✦",
+            read: () => {
+                const report = readCatalog(context);
+                const mcp = readMcp();
+                return { skillCount: report.total, skills: report.skills, diagnostics: report.diagnostics, mcpCount: mcp.servers.length, mcpServers: mcp.servers };
+            },
+        });
+        context.effect(() => () => {
+            unregister();
+            disposePanel();
+        });
+    },
+};
+//# sourceMappingURL=skill-catalog.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skill-catalog.js","sourceRoot":"","sources":["../../src/plugins/skill-catalog.ts"],"names":[],"mappings":"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"}

package/packages/core/dist/plugins/skill-guard.d.ts

@@ -0,0 +1,26 @@
+import type { Context } from "@deepseek-ai/cordis";
+export type SkillGuardRisk = "safe" | "review" | "blocked";
+export type SkillGuardFinding = {
+    code: string;
+    severity: "medium" | "high";
+    message: string;
+};
+export type SkillGuardReport = {
+    name: string;
+    risk: SkillGuardRisk;
+    score: number;
+    findings: SkillGuardFinding[];
+};
+export type ScannedSkillReport = SkillGuardReport & {
+    path: string;
+    source: string;
+    scannedBytes: number;
+};
+export declare function inspectSkillText(text: string, name: string): SkillGuardReport;
+declare const _default: {
+    name: string;
+    inject: string[];
+    apply(context: Context): void;
+};
+export default _default;
+//# sourceMappingURL=skill-guard.d.ts.map

package/packages/core/dist/plugins/skill-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-guard.d.ts","sourceRoot":"","sources":["../../src/plugins/skill-guard.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAOnD,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;AAC3D,MAAM,MAAM,iBAAiB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAC/F,MAAM,MAAM,gBAAgB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,cAAc,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,iBAAiB,EAAE,CAAA;CAAE,CAAC;AACpH,MAAM,MAAM,kBAAkB,GAAG,gBAAgB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAAC;AAqD3G,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAM7E;;;;mBA4BgB,OAAO;;AAHxB,wBAwDE"}

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

@@ -0,0 +1,139 @@
+import { readFile } from "node:fs/promises";
+import { Type } from "@earendil-works/pi-ai";
+import { defineTool } from "@earendil-works/pi-coding-agent";
+const maxSkillBytes = 128 * 1024;
+const maxSkills = 50;
+const patterns = [
+    {
+        code: "instruction_override",
+        severity: "high",
+        score: 5,
+        message: "检测到试图覆盖已有指令的文本。",
+        pattern: /\bignore\s+(?:all\s+)?(?:previous|earlier|above)\s+instructions\b/iu,
+    },
+    {
+        code: "secret_exfiltration",
+        severity: "high",
+        score: 6,
+        message: "检测到可能要求外传 API key、token 或密码的文本。",
+        pattern: /\b(?:api[\s_-]?key|token|password|secret)\b.{0,120}\b(?:send|upload|post|share|curl|wget)\b/iu,
+    },
+    {
+        code: "remote_exfiltration",
+        severity: "high",
+        score: 6,
+        message: "检测到通过远程命令外传敏感值的文本。",
+        pattern: /\b(?:curl|wget)\b.{0,180}\b(?:api[\s_-]?key|token|password|secret)\b/iu,
+    },
+    {
+        code: "remote_payload",
+        severity: "medium",
+        score: 2,
+        message: "检测到从远程地址加载或执行内容的文本。",
+        pattern: /\b(?:curl|wget)\s+https?:\/\//iu,
+    },
+    {
+        code: "destructive_command",
+        severity: "high",
+        score: 6,
+        message: "检测到可能破坏工作区或磁盘的命令。",
+        pattern: /\b(?:rm\s+-rf|git\s+reset\s+--hard|git\s+clean\s+-f|mkfs(?:\.[a-z0-9]+)?|dd\s+if=)\b/iu,
+    },
+    {
+        code: "obfuscated_payload",
+        severity: "medium",
+        score: 3,
+        message: "检测到可能用于隐藏执行内容的编码或动态执行。",
+        pattern: /\b(?:eval|base64\s+-d|fromcharcode)\b/iu,
+    },
+];
+function skillName(name) {
+    return name.trim().slice(0, 64) || "unknown";
+}
+export function inspectSkillText(text, name) {
+    if (Buffer.byteLength(text, "utf8") > maxSkillBytes)
+        throw new Error(`Skill guard input must be at most ${maxSkillBytes} bytes`);
+    const findings = patterns.filter((item) => item.pattern.test(text)).map(({ code, severity, message }) => ({ code, severity, message }));
+    const score = findings.reduce((total, finding) => total + (patterns.find((item) => item.code === finding.code)?.score ?? 0), 0);
+    const risk = findings.some((finding) => finding.severity === "high") ? "blocked" : findings.length > 0 ? "review" : "safe";
+    return { name: skillName(name), risk, score, findings };
+}
+async function scanLoadedSkills(context) {
+    const loaded = context.piResources.resourceLoader.getSkills();
+    const reports = [];
+    for (const skill of loaded.skills.slice(0, maxSkills)) {
+        try {
+            const content = await readFile(skill.filePath, "utf8");
+            const report = inspectSkillText(content, skill.name);
+            reports.push({ ...report, path: skill.filePath, source: skill.sourceInfo.source, scannedBytes: Buffer.byteLength(content, "utf8") });
+        }
+        catch {
+            reports.push({
+                name: skillName(skill.name),
+                risk: "review",
+                score: 2,
+                findings: [{ code: "read_error", severity: "medium", message: "Skill 文件无法读取，已标记为需要复核。" }],
+                path: skill.filePath,
+                source: skill.sourceInfo.source,
+                scannedBytes: 0,
+            });
+        }
+    }
+    return reports;
+}
+export default {
+    name: "pi-skill-guard",
+    inject: ["piResources", "piPluginUi", "piTools"],
+    apply(context) {
+        let reports = [];
+        let scans = 0;
+        const unregister = context.piTools.register(defineTool({
+            name: "skill_guard_scan",
+            label: "Skill guard scan",
+            description: "Audit loaded Agent Skills for instruction override, secret exfiltration, destructive commands, and obfuscation without retaining skill source text.",
+            promptSnippet: "audit loaded skills for prompt injection and unsafe command risks",
+            parameters: Type.Object({ query: Type.Optional(Type.String()) }),
+            async execute(_toolCallId, params) {
+                const query = (params.query ?? "").trim().toLocaleLowerCase();
+                if (query.length > 120)
+                    throw new Error("Skill guard query must contain 0-120 characters");
+                reports = await scanLoadedSkills(context);
+                scans += 1;
+                const filtered = reports.filter((report) => query === "" || `${report.name} ${report.source}`.toLocaleLowerCase().includes(query));
+                const result = {
+                    total: filtered.length,
+                    blocked: filtered.filter((report) => report.risk === "blocked").length,
+                    review: filtered.filter((report) => report.risk === "review").length,
+                    reports: filtered,
+                };
+                return {
+                    content: [{ type: "text", text: `${result.total} skill(s) scanned: ${result.blocked} blocked, ${result.review} review.` }],
+                    details: result,
+                };
+            },
+        }));
+        const disposePanel = context.piPluginUi.register({
+            id: "skill-guard-panel",
+            pluginId: "@pi-harness/core/plugins/skill-guard",
+            title: "Skill Guard",
+            description: "审计已加载 Skill 的提示词覆盖、秘密外传和危险命令，只保存风险摘要。",
+            icon: "◇",
+            read: () => ({
+                scans,
+                total: reports.length,
+                blocked: reports.filter((report) => report.risk === "blocked").length,
+                review: reports.filter((report) => report.risk === "review").length,
+                reports,
+            }),
+        });
+        void scanLoadedSkills(context).then((nextReports) => {
+            reports = nextReports;
+            scans = 1;
+        });
+        context.effect(() => () => {
+            unregister();
+            disposePanel();
+        });
+    },
+};
+//# sourceMappingURL=skill-guard.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skill-guard.js","sourceRoot":"","sources":["../../src/plugins/skill-guard.ts"],"names":[],"mappings":"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"}

package/packages/core/dist/plugins/sql-lens.d.ts

@@ -0,0 +1,8 @@
+import type { Context } from "@deepseek-ai/cordis";
+declare const _default: {
+    name: string;
+    inject: string[];
+    apply(context: Context): void;
+};
+export default _default;
+//# sourceMappingURL=sql-lens.d.ts.map

package/packages/core/dist/plugins/sql-lens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql-lens.d.ts","sourceRoot":"","sources":["../../src/plugins/sql-lens.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;;;;mBAiClC,OAAO;;AAHxB,wBA0DE"}