@pi-harness/pi-harness 0.1.2 → 0.1.3

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

@@ -0,0 +1,114 @@
+import { Type } from "@earendil-works/pi-ai";
+import { defineTool } from "@earendil-works/pi-coding-agent";
+const maxPromptBytes = 128 * 1024;
+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: 5,
+        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_payload", severity: "medium", score: 2, message: "检测到从远程地址加载或执行内容的文本。", pattern: /\b(?:curl|wget)\s+https?:\/\//iu },
+    {
+        code: "system_prompt_probe",
+        severity: "medium",
+        score: 2,
+        message: "检测到探测系统或开发者提示词的文本。",
+        pattern: /\b(?:system|developer)\s+(?:prompt|message|instruction)s?\b/iu,
+    },
+    {
+        code: "hidden_instruction",
+        severity: "medium",
+        score: 2,
+        message: "检测到要求隐藏执行意图或绕过披露的文本。",
+        pattern: /\b(?:do not|don't)\s+(?:tell|show|disclose)\s+(?:the\s+)?(?:user|human)\b/iu,
+    },
+];
+function inspect(text, source) {
+    if (Buffer.byteLength(text, "utf8") > maxPromptBytes)
+        throw new Error(`Prompt guard input must be at most ${maxPromptBytes} 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 highFindings = findings.filter((finding) => finding.severity === "high").length;
+    const risk = highFindings >= 2 || score >= 8 ? "blocked" : findings.length > 0 ? "review" : "safe";
+    return { source: source.trim().slice(0, 64) || "unknown", risk, score, scannedChars: text.length, findings };
+}
+function messageText(message) {
+    if (message === null || typeof message !== "object")
+        return "";
+    const content = message.content;
+    if (typeof content === "string")
+        return content;
+    if (!Array.isArray(content))
+        return "";
+    return content
+        .filter((item) => item !== null && typeof item === "object" && item.type === "text" && typeof item.text === "string")
+        .map((item) => item.text)
+        .join("\n");
+}
+export default {
+    name: "pi-prompt-guard",
+    inject: ["piPluginUi", "piTools"],
+    apply(context) {
+        let scans = 0;
+        let latest;
+        const onSessionEvent = context.on("pi/session-event", (event) => {
+            if (event.type !== "message_start" || event.message.role !== "user")
+                return;
+            try {
+                latest = inspect(messageText(event.message), "message_start");
+                scans += 1;
+            }
+            catch {
+                latest = {
+                    source: "message_start",
+                    risk: "review",
+                    score: 0,
+                    scannedChars: 0,
+                    findings: [{ code: "input_limit", severity: "medium", message: "输入超过 Prompt Guard 扫描上限。" }],
+                };
+                scans += 1;
+            }
+        });
+        const unregisterTool = context.piTools.register(defineTool({
+            name: "prompt_guard_scan",
+            label: "Prompt guard scan",
+            description: "Scan text for prompt injection, secret exfiltration, and remote payload indicators without retaining the source text.",
+            promptSnippet: "scan untrusted text for prompt injection risks",
+            parameters: Type.Object({ text: Type.String(), source: Type.Optional(Type.String()) }),
+            execute(_toolCallId, params) {
+                return Promise.resolve().then(() => {
+                    const report = inspect(params.text, params.source ?? "tool");
+                    latest = report;
+                    scans += 1;
+                    return {
+                        content: [{ type: "text", text: `${report.risk}: ${report.findings.length} finding(s), score ${report.score}.` }],
+                        details: report,
+                    };
+                });
+            },
+        }));
+        const disposePanel = context.piPluginUi.register({
+            id: "prompt-guard-panel",
+            pluginId: "@pi-harness/core/plugins/prompt-guard",
+            title: "Prompt Guard",
+            description: "扫描潜在提示词注入和秘密外传风险，只保留摘要，不保存原文。",
+            icon: "⊘",
+            read: () => ({ scans, risk: latest?.risk ?? "safe", latest: latest ?? null }),
+        });
+        context.effect(() => () => {
+            onSessionEvent();
+            unregisterTool();
+            disposePanel();
+        });
+    },
+};
+//# sourceMappingURL=prompt-guard.js.map

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

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

package/packages/core/dist/plugins/prompt-library.d.ts

@@ -0,0 +1,25 @@
+import type { Context } from "@deepseek-ai/cordis";
+export interface PromptTemplateInput {
+    title: string;
+    prompt: string;
+    tags?: string[];
+}
+export interface PromptTemplate {
+    id: string;
+    title: string;
+    prompt: string;
+    tags: string[];
+    createdAt: string;
+    updatedAt: string;
+}
+export interface PromptLibraryState {
+    templates: PromptTemplate[];
+}
+export declare function createPromptTemplate(input: PromptTemplateInput, id: string, timestamp: string): PromptTemplate;
+declare const _default: {
+    name: string;
+    inject: string[];
+    apply(context: Context): void;
+};
+export default _default;
+//# sourceMappingURL=prompt-library.d.ts.map

package/packages/core/dist/plugins/prompt-library.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-library.d.ts","sourceRoot":"","sources":["../../src/plugins/prompt-library.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAWnD,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,cAAc,EAAE,CAAC;CAC7B;AAeD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,mBAAmB,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,cAAc,CAS9G;;;;mBAsCgB,OAAO;;AAHxB,wBA6EE"}

package/packages/core/dist/plugins/prompt-library.js

@@ -0,0 +1,142 @@
+import { Type } from "@earendil-works/pi-ai";
+import { defineTool } from "@earendil-works/pi-coding-agent";
+const customType = "pi-harness/prompt-library";
+const maxTitleLength = 120;
+const maxPromptLength = 8_000;
+const maxTagLength = 40;
+const maxTags = 10;
+const maxTemplates = 100;
+function bounded(value, field, maxLength) {
+    const text = value.trim();
+    if (!text)
+        throw new Error(`${field} is required`);
+    if (text.length > maxLength)
+        throw new Error(`${field} must be ${maxLength.toLocaleString()} characters or fewer`);
+    return text;
+}
+function normalizeTags(values) {
+    const tags = values ?? [];
+    if (tags.length > maxTags)
+        throw new Error(`tags must contain ${maxTags} items or fewer`);
+    return [...new Set(tags.map((tag) => tag.trim()).filter(Boolean))].map((tag) => bounded(tag, "tag", maxTagLength));
+}
+export function createPromptTemplate(input, id, timestamp) {
+    return {
+        id,
+        title: bounded(input.title, "title", maxTitleLength),
+        prompt: bounded(input.prompt, "prompt", maxPromptLength),
+        tags: normalizeTags(input.tags),
+        createdAt: timestamp,
+        updatedAt: timestamp,
+    };
+}
+function readState(context) {
+    const entry = [...context.piSession.manager.getEntries()].reverse().find((item) => item.type === "custom" && item.customType === customType);
+    if (entry?.type !== "custom" || entry.data === undefined || entry.data === null || typeof entry.data !== "object")
+        return { templates: [] };
+    const value = entry.data;
+    if (!Array.isArray(value.templates))
+        return { templates: [] };
+    const templates = value.templates.flatMap((item) => {
+        if (item === null || typeof item !== "object")
+            return [];
+        const candidate = item;
+        if (typeof candidate.id !== "string" || typeof candidate.title !== "string" || typeof candidate.prompt !== "string")
+            return [];
+        return [
+            {
+                id: candidate.id,
+                title: candidate.title,
+                prompt: candidate.prompt,
+                tags: Array.isArray(candidate.tags) ? candidate.tags.filter((tag) => typeof tag === "string") : [],
+                createdAt: typeof candidate.createdAt === "string" ? candidate.createdAt : new Date(0).toISOString(),
+                updatedAt: typeof candidate.updatedAt === "string" ? candidate.updatedAt : new Date(0).toISOString(),
+            },
+        ];
+    });
+    return { templates: templates.slice(-maxTemplates) };
+}
+function persist(context, state) {
+    context.piSession.manager.appendCustomEntry(customType, state);
+}
+function filterTemplates(state, query) {
+    const normalized = query?.trim().toLocaleLowerCase() ?? "";
+    if (!normalized)
+        return state.templates;
+    return state.templates.filter((template) => `${template.title} ${template.prompt} ${template.tags.join(" ")}`.toLocaleLowerCase().includes(normalized));
+}
+export default {
+    name: "pi-prompt-library",
+    inject: ["piSession", "piPluginUi", "piTools"],
+    apply(context) {
+        let sequence = 0;
+        let latest = readState(context);
+        const unregister = context.piTools.register(defineTool({
+            name: "prompt_library",
+            label: "Prompt library",
+            description: "Save, search, update, and delete reusable prompt templates in the current Pi session.",
+            promptSnippet: "manage reusable prompts for the current project",
+            parameters: Type.Object({
+                action: Type.Union([Type.Literal("save"), Type.Literal("list"), Type.Literal("delete")]),
+                id: Type.Optional(Type.String()),
+                title: Type.Optional(Type.String()),
+                prompt: Type.Optional(Type.String()),
+                tags: Type.Optional(Type.Array(Type.String())),
+                query: Type.Optional(Type.String()),
+            }),
+            execute(_toolCallId, params) {
+                return Promise.resolve().then(() => {
+                    const state = readState(context);
+                    if (params.action === "save") {
+                        const now = new Date().toISOString();
+                        const existing = params.id?.trim() ? state.templates.find((template) => template.id === params.id?.trim()) : undefined;
+                        const template = existing
+                            ? {
+                                ...existing,
+                                title: bounded(params.title ?? existing.title, "title", maxTitleLength),
+                                prompt: bounded(params.prompt ?? existing.prompt, "prompt", maxPromptLength),
+                                tags: normalizeTags(params.tags ?? existing.tags),
+                                updatedAt: now,
+                            }
+                            : createPromptTemplate({ title: params.title ?? "", prompt: params.prompt ?? "", ...(params.tags === undefined ? {} : { tags: params.tags }) }, `prompt-${Date.now()}-${++sequence}`, now);
+                        const templates = existing
+                            ? state.templates.map((item) => (item.id === existing.id ? template : item))
+                            : [...state.templates, template].slice(-maxTemplates);
+                        latest = { templates };
+                        persist(context, latest);
+                        return { content: [{ type: "text", text: `Prompt ${template.id} saved.` }], details: { ...latest, selected: template } };
+                    }
+                    if (params.action === "delete") {
+                        const id = params.id?.trim();
+                        if (!id)
+                            throw new Error("id is required when action is delete");
+                        if (!state.templates.some((template) => template.id === id))
+                            throw new Error(`Prompt was not found: ${id}`);
+                        latest = { templates: state.templates.filter((template) => template.id !== id) };
+                        persist(context, latest);
+                        return { content: [{ type: "text", text: `Prompt ${id} deleted.` }], details: latest };
+                    }
+                    latest = state;
+                    const templates = filterTemplates(state, params.query);
+                    return {
+                        content: [{ type: "text", text: templates.map((template) => `${template.id}: ${template.title}`).join("\n") || "No prompts found." }],
+                        details: { templates },
+                    };
+                });
+            },
+        }));
+        const disposePanel = context.piPluginUi.register({
+            id: "prompt-library-panel",
+            pluginId: "@pi-harness/core/plugins/prompt-library",
+            title: "Prompt Library",
+            description: "保存和检索可复用的提示词模板，数据跟随当前会话。",
+            icon: "✎",
+            read: () => ({ total: latest.templates.length, templates: latest.templates }),
+        });
+        context.effect(() => () => {
+            unregister();
+            disposePanel();
+        });
+    },
+};
+//# sourceMappingURL=prompt-library.js.map

package/packages/core/dist/plugins/prompt-library.js.map

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

package/packages/core/dist/plugins/readme-gen.d.ts

@@ -0,0 +1,25 @@
+import type { Context } from "@deepseek-ai/cordis";
+export type ReadmeMetadata = {
+    name: string;
+    version: string;
+    description: string;
+    scripts: string[];
+    plugins: string[];
+};
+export type ReadmeReport = ReadmeMetadata & {
+    markdown: string;
+};
+export type ReadmeWriteReport = {
+    path: string;
+    bytes: number;
+    overwritten: boolean;
+};
+export declare function renderReadme(metadata: ReadmeMetadata): string;
+export declare function writeReadmeFile(root: string, markdown: string, requestedPath: string, confirm: boolean): Promise<ReadmeWriteReport>;
+declare const _default: {
+    name: string;
+    inject: string[];
+    apply(context: Context): void;
+};
+export default _default;
+//# sourceMappingURL=readme-gen.d.ts.map

package/packages/core/dist/plugins/readme-gen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readme-gen.d.ts","sourceRoot":"","sources":["../../src/plugins/readme-gen.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAInD,MAAM,MAAM,cAAc,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAC1H,MAAM,MAAM,YAAY,GAAG,cAAc,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AACjE,MAAM,MAAM,iBAAiB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,OAAO,CAAA;CAAE,CAAC;AAEtF,wBAAgB,YAAY,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,CAkB7D;AA2CD,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAsBzI;;;;mBAKgB,OAAO;;AAHxB,wBAkDE"}

package/packages/core/dist/plugins/readme-gen.js

@@ -0,0 +1,139 @@
+import { lstat, mkdir, readFile, realpath, rename, writeFile } from "node:fs/promises";
+import { randomUUID } from "node:crypto";
+import { basename, dirname, join, relative, resolve } from "node:path";
+import { Type } from "@earendil-works/pi-ai";
+import { defineTool } from "@earendil-works/pi-coding-agent";
+export function renderReadme(metadata) {
+    const { name, version, description, scripts, plugins } = metadata;
+    return [
+        `# ${name}`,
+        "",
+        description,
+        "",
+        `Version: ${version}`,
+        "",
+        "## Scripts",
+        "",
+        ...(scripts.length ? scripts.map((script) => `- \`npm run ${script}\``) : ["- No npm scripts declared."]),
+        "",
+        "## Runtime plugins",
+        "",
+        ...(plugins.length ? plugins.map((plugin) => `- \`${plugin}\``) : ["- No runtime plugins reported."]),
+        "",
+    ].join("\n");
+}
+async function generate(context) {
+    const path = join(context.piHarnessLaunch.cwd, "package.json");
+    const source = await readFile(path, "utf8");
+    let parsed;
+    try {
+        parsed = JSON.parse(source);
+    }
+    catch (error) {
+        throw new Error(`Invalid package.json: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
+    }
+    if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed))
+        throw new Error("package.json root must be an object");
+    const packageJson = parsed;
+    const name = typeof packageJson.name === "string" ? packageJson.name : "Unnamed project";
+    const version = typeof packageJson.version === "string" ? packageJson.version : "unknown";
+    const description = typeof packageJson.description === "string" ? packageJson.description : "";
+    const scripts = packageJson.scripts !== null && typeof packageJson.scripts === "object" && !Array.isArray(packageJson.scripts)
+        ? Object.keys(packageJson.scripts).sort()
+        : [];
+    const loader = context.get("loader");
+    const plugins = loader === undefined
+        ? []
+        : [...loader.entries()]
+            .filter((entry) => !entry.disabled)
+            .map((entry) => entry.options.name)
+            .filter((plugin) => !plugin.startsWith("cordis:"))
+            .sort();
+    const metadata = { name, version, description, scripts, plugins };
+    return { ...metadata, markdown: renderReadme(metadata) };
+}
+function outputPath(root, requested) {
+    const value = requested.trim() || "README.generated.md";
+    if (value.length > 512 || value.includes("\\"))
+        throw new Error("README output path must be a relative POSIX path of at most 512 characters");
+    const resolvedRoot = resolve(root);
+    const target = resolve(resolvedRoot, value);
+    const remainder = relative(resolvedRoot, target);
+    if (remainder === ".." || remainder.startsWith(`..${"/"}`) || remainder.startsWith("/"))
+        throw new Error("README output path must stay inside the workspace");
+    return target;
+}
+export async function writeReadmeFile(root, markdown, requestedPath, confirm) {
+    if (!confirm)
+        throw new Error("Writing a README requires confirm=true");
+    const workspace = await realpath(resolve(root));
+    const target = outputPath(workspace, requestedPath);
+    const parent = dirname(target);
+    await mkdir(parent, { recursive: true });
+    const realParent = await realpath(parent);
+    const parentRemainder = relative(workspace, realParent);
+    if (parentRemainder === ".." || parentRemainder.startsWith(`..${"/"}`) || parentRemainder.startsWith("/"))
+        throw new Error("README output path must stay inside the workspace");
+    let overwritten = false;
+    try {
+        const metadata = await lstat(target);
+        if (metadata.isSymbolicLink() || !metadata.isFile())
+            throw new Error("README output path must be a regular file and cannot be a symbolic link");
+        overwritten = true;
+    }
+    catch (error) {
+        if (error.code !== "ENOENT")
+            throw error;
+    }
+    const temporary = join(parent, `.${basename(target)}.${randomUUID()}.tmp`);
+    await writeFile(temporary, markdown, { encoding: "utf8", mode: 0o600 });
+    await rename(temporary, target);
+    return { path: relative(workspace, target), bytes: Buffer.byteLength(markdown, "utf8"), overwritten };
+}
+export default {
+    name: "pi-readme-gen",
+    inject: ["piHarnessLaunch", "piPluginUi", "piTools"],
+    apply(context) {
+        let latest;
+        let lastWrite;
+        const unregisterTool = context.piTools.register(defineTool({
+            name: "readme_report",
+            label: "README report",
+            description: "Generate a Markdown project overview from the local package manifest and active Pi runtime plugins.",
+            promptSnippet: "generate a project README overview",
+            parameters: Type.Object({}),
+            async execute() {
+                latest = await generate(context);
+                return { content: [{ type: "text", text: latest.markdown }], details: latest };
+            },
+        }));
+        const unregisterWrite = context.piTools.register(defineTool({
+            name: "readme_write",
+            label: "Write README",
+            description: "Write the generated Markdown to a workspace file only after explicit confirmation; defaults to README.generated.md.",
+            promptSnippet: "write the generated README to a confirmed workspace path",
+            parameters: Type.Object({ outputPath: Type.Optional(Type.String()), confirm: Type.Boolean() }),
+            async execute(_toolCallId, params) {
+                const report = latest ?? (latest = await generate(context));
+                lastWrite = await writeReadmeFile(context.piHarnessLaunch.cwd, report.markdown, params.outputPath ?? "README.generated.md", params.confirm);
+                return { content: [{ type: "text", text: `README written: ${lastWrite.path} (${lastWrite.bytes} bytes)` }], details: lastWrite };
+            },
+        }));
+        const disposePanel = context.piPluginUi.register({
+            id: "readme-gen-panel",
+            pluginId: "@pi-harness/core/plugins/readme-gen",
+            title: "README Generator",
+            description: "从当前项目清单生成 Markdown 概览；写入文件需要显式确认，默认不会覆盖 README。",
+            icon: "▰",
+            read: () => latest === undefined
+                ? { generated: false, lastWrite: lastWrite ?? null }
+                : { generated: true, name: latest.name, scripts: latest.scripts.length, plugins: latest.plugins.length, lastWrite: lastWrite ?? null },
+        });
+        context.effect(() => () => {
+            unregisterTool();
+            unregisterWrite();
+            disposePanel();
+        });
+    },
+};
+//# sourceMappingURL=readme-gen.js.map

package/packages/core/dist/plugins/readme-gen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readme-gen.js","sourceRoot":"","sources":["../../src/plugins/readme-gen.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACvF,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEvE,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAwB,MAAM,iCAAiC,CAAC;AAMnF,MAAM,UAAU,YAAY,CAAC,QAAwB;IACnD,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,QAAQ,CAAC;IAClE,OAAO;QACL,KAAK,IAAI,EAAE;QACX,EAAE;QACF,WAAW;QACX,EAAE;QACF,YAAY,OAAO,EAAE;QACrB,EAAE;QACF,YAAY;QACZ,EAAE;QACF,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,eAAe,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,4BAA4B,CAAC,CAAC;QACzG,EAAE;QACF,oBAAoB;QACpB,EAAE;QACF,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,gCAAgC,CAAC,CAAC;QACrG,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,KAAK,UAAU,QAAQ,CAAC,OAAgB;IACtC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;IAC/D,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC5C,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAY,CAAC;IACzC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,yBAAyB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IACvH,CAAC;IACD,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACnI,MAAM,WAAW,GAAG,MAAiC,CAAC;IACtD,MAAM,IAAI,GAAG,OAAO,WAAW,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,iBAAiB,CAAC;IACzF,MAAM,OAAO,GAAG,OAAO,WAAW,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1F,MAAM,WAAW,GAAG,OAAO,WAAW,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/F,MAAM,OAAO,GACX,WAAW,CAAC,OAAO,KAAK,IAAI,IAAI,OAAO,WAAW,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC;QAC5G,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE;QACzC,CAAC,CAAC,EAAE,CAAC;IACT,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAkG,CAAC;IACtI,MAAM,OAAO,GACX,MAAM,KAAK,SAAS;QAClB,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;aAClB,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC;aAClC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;aAClC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;aACjD,IAAI,EAAE,CAAC;IAChB,MAAM,QAAQ,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;IAClE,OAAO,EAAE,GAAG,QAAQ,EAAE,QAAQ,EAAE,YAAY,CAAC,QAAQ,CAAC,EAAE,CAAC;AAC3D,CAAC;AAED,SAAS,UAAU,CAAC,IAAY,EAAE,SAAiB;IACjD,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,EAAE,IAAI,qBAAqB,CAAC;IACxD,IAAI,KAAK,CAAC,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,4EAA4E,CAAC,CAAC;IAC9I,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;IAC5C,MAAM,SAAS,GAAG,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IACjD,IAAI,SAAS,KAAK,IAAI,IAAI,SAAS,CAAC,UAAU,CAAC,KAAK,GAAG,EAAE,CAAC,IAAI,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IAC9J,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAY,EAAE,QAAgB,EAAE,aAAqB,EAAE,OAAgB;IAC3G,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IACxE,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAChD,MAAM,MAAM,GAAG,UAAU,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;IACpD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/B,MAAM,KAAK,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC1C,MAAM,eAAe,GAAG,QAAQ,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IACxD,IAAI,eAAe,KAAK,IAAI,IAAI,eAAe,CAAC,UAAU,CAAC,KAAK,GAAG,EAAE,CAAC,IAAI,eAAe,CAAC,UAAU,CAAC,GAAG,CAAC;QACvG,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IACvE,IAAI,WAAW,GAAG,KAAK,CAAC;IACxB,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,CAAC;QACrC,IAAI,QAAQ,CAAC,cAAc,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,yEAAyE,CAAC,CAAC;QAChJ,WAAW,GAAG,IAAI,CAAC;IACrB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;YAAE,MAAM,KAAK,CAAC;IACtE,CAAC;IACD,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,EAAE,IAAI,QAAQ,CAAC,MAAM,CAAC,IAAI,UAAU,EAAE,MAAM,CAAC,CAAC;IAC3E,MAAM,SAAS,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACxE,MAAM,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAChC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;AACxG,CAAC;AAED,eAAe;IACb,IAAI,EAAE,eAAe;IACrB,MAAM,EAAE,CAAC,iBAAiB,EAAE,YAAY,EAAE,SAAS,CAAC;IACpD,KAAK,CAAC,OAAgB;QACpB,IAAI,MAAgC,CAAC;QACrC,IAAI,SAAwC,CAAC;QAC7C,MAAM,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAC7C,UAAU,CAAC;YACT,IAAI,EAAE,eAAe;YACrB,KAAK,EAAE,eAAe;YACtB,WAAW,EAAE,qGAAqG;YAClH,aAAa,EAAE,oCAAoC;YACnD,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,KAAK,CAAC,OAAO;gBACX,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,CAAC;gBACjC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;YACjF,CAAC;SACF,CAAC,CACH,CAAC;QACF,MAAM,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAC9C,UAAU,CAAC;YACT,IAAI,EAAE,cAAc;YACpB,KAAK,EAAE,cAAc;YACrB,WAAW,EAAE,qHAAqH;YAClI,aAAa,EAAE,0DAA0D;YACzE,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;YAC9F,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM;gBAC/B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;gBAC5D,SAAS,GAAG,MAAM,eAAe,CAAC,OAAO,CAAC,eAAe,CAAC,GAAG,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,UAAU,IAAI,qBAAqB,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;gBAC5I,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,SAAS,CAAC,IAAI,KAAK,SAAS,CAAC,KAAK,SAAS,EAAE,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;YACnI,CAAC;SACF,CAAC,CACH,CAAC;QACF,MAAM,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC;YAC/C,EAAE,EAAE,kBAAkB;YACtB,QAAQ,EAAE,qCAAqC;YAC/C,KAAK,EAAE,kBAAkB;YACzB,WAAW,EAAE,iDAAiD;YAC9D,IAAI,EAAE,GAAG;YACT,IAAI,EAAE,GAAG,EAAE,CACT,MAAM,KAAK,SAAS;gBAClB,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,IAAI,IAAI,EAAE;gBACpD,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,IAAI,IAAI,EAAE;SAC3I,CAAC,CAAC;QACH,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE;YACxB,cAAc,EAAE,CAAC;YACjB,eAAe,EAAE,CAAC;YAClB,YAAY,EAAE,CAAC;QACjB,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

package/packages/core/dist/plugins/recall-unread.d.ts

@@ -0,0 +1,24 @@
+import type { Context } from "@deepseek-ai/cordis";
+import z from "@deepseek-ai/schemastery";
+export interface RecallUnreadPluginConfig {
+    maxSessions?: number;
+}
+export declare const Config: z<RecallUnreadPluginConfig>;
+export interface UnreadSession {
+    id: string;
+    path: string;
+    cwd: string;
+    name: string;
+    modified: string;
+    messageCount: number;
+    message: string;
+}
+export declare function unreadUserMessage(entries: readonly unknown[]): string | undefined;
+declare const _default: {
+    name: string;
+    inject: string[];
+    Config: z<RecallUnreadPluginConfig>;
+    apply(context: Context, config: RecallUnreadPluginConfig): void;
+};
+export default _default;
+//# sourceMappingURL=recall-unread.d.ts.map

package/packages/core/dist/plugins/recall-unread.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recall-unread.d.ts","sourceRoot":"","sources":["../../src/plugins/recall-unread.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,CAAC,MAAM,0BAA0B,CAAC;AAWzC,MAAM,WAAW,wBAAwB;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,MAAM,EAAE,CAAC,CAAC,wBAAwB,CAAqE,CAAC;AAErH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAiBD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,SAAS,OAAO,EAAE,GAAG,MAAM,GAAG,SAAS,CAUjF;;;;;mBAmCgB,OAAO,UAAU,wBAAwB;;AAJ1D,wBAwDE"}

package/packages/core/dist/plugins/recall-unread.js

@@ -0,0 +1,124 @@
+import { readFile, stat } from "node:fs/promises";
+import z from "@deepseek-ai/schemastery";
+import { Type } from "@earendil-works/pi-ai";
+import { defineTool, parseSessionEntries, SessionManager } from "@earendil-works/pi-coding-agent";
+import { assertKnownConfigKeys } from "../config.js";
+const defaultMaxSessions = 100;
+const maxAllowedSessions = 500;
+const maxPreviewChars = 500;
+const maxSessionFileBytes = 4 * 1024 * 1024;
+const sessionReadConcurrency = 8;
+export const Config = z.object({ maxSessions: z.number().default(defaultMaxSessions) });
+function record(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value) ? value : undefined;
+}
+function contentText(value) {
+    if (typeof value === "string")
+        return value;
+    if (!Array.isArray(value))
+        return "";
+    return value
+        .flatMap((part) => {
+        const item = record(part);
+        return item?.type === "text" && typeof item.text === "string" ? [item.text] : [];
+    })
+        .join("\n");
+}
+export function unreadUserMessage(entries) {
+    for (let index = entries.length - 1; index >= 0; index -= 1) {
+        const entry = record(entries[index]);
+        if (entry?.type !== "message")
+            continue;
+        const message = record(entry.message);
+        if (message?.role !== "user")
+            return undefined;
+        const text = contentText(message.content).trim();
+        return text === "" ? undefined : text.slice(0, maxPreviewChars);
+    }
+    return undefined;
+}
+async function unreadSession(session) {
+    try {
+        const metadata = await stat(session.path);
+        if (!metadata.isFile() || metadata.size > maxSessionFileBytes)
+            return undefined;
+        const message = unreadUserMessage(parseSessionEntries(await readFile(session.path, "utf8")));
+        if (message === undefined)
+            return undefined;
+        return {
+            id: session.id,
+            path: session.path,
+            cwd: session.cwd,
+            name: session.name?.trim() || session.firstMessage.trim() || session.id,
+            modified: session.modified.toISOString(),
+            messageCount: session.messageCount,
+            message,
+        };
+    }
+    catch {
+        return undefined;
+    }
+}
+async function unreadSessions(sessions) {
+    const results = [];
+    for (let index = 0; index < sessions.length; index += sessionReadConcurrency) {
+        const batch = await Promise.all(sessions.slice(index, index + sessionReadConcurrency).map(unreadSession));
+        results.push(...batch.filter((item) => item !== undefined));
+    }
+    return results;
+}
+export default {
+    name: "pi-recall-unread",
+    inject: ["piHarnessLaunch", "piSession", "piPluginUi", "piTools"],
+    Config,
+    apply(context, config) {
+        assertKnownConfigKeys("pi-recall-unread", config, ["maxSessions"]);
+        const maxSessions = Math.max(1, Math.min(maxAllowedSessions, Math.trunc(config.maxSessions ?? defaultMaxSessions)));
+        let items = [];
+        let scans = 0;
+        const scan = async (query = "") => {
+            const normalizedQuery = query.trim().toLocaleLowerCase();
+            if (normalizedQuery.length > 120)
+                throw new Error("Recall unread query must contain 0-120 characters");
+            const sessions = await SessionManager.list(context.piHarnessLaunch.cwd, context.piSession.manager.getSessionDir());
+            items = (await unreadSessions(sessions.slice(0, maxSessions))).filter((item) => normalizedQuery === "" || `${item.name} ${item.message} ${item.cwd}`.toLocaleLowerCase().includes(normalizedQuery));
+            scans += 1;
+            return items;
+        };
+        const unregister = context.piTools.register(defineTool({
+            name: "session_recall_unread",
+            label: "Recall unread sessions",
+            description: "Find persisted Pi sessions whose latest message is an unanswered user message without modifying the sessions.",
+            promptSnippet: "find previous sessions with unanswered user messages",
+            parameters: Type.Object({ query: Type.Optional(Type.String()) }),
+            async execute(_toolCallId, params) {
+                const matches = await scan(params.query);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: matches.map((item) => `${item.name}: ${item.message}`).join("\n") || "No unanswered sessions found.",
+                        },
+                    ],
+                    details: { total: matches.length, items: matches },
+                };
+            },
+        }));
+        const disposePanel = context.piPluginUi.register({
+            id: "recall-unread-panel",
+            pluginId: "@pi-harness/core/plugins/recall-unread",
+            title: "Recall Unread",
+            description: "查看以未回答用户消息结束的原生 Pi 会话，只读不修改。",
+            icon: "◌",
+            read: async () => {
+                const matches = await scan();
+                return { scans, total: matches.length, items: matches };
+            },
+        });
+        context.effect(() => () => {
+            unregister();
+            disposePanel();
+        });
+    },
+};
+//# sourceMappingURL=recall-unread.js.map