@pi-harness/pi-harness 0.1.2 → 0.1.3

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

@@ -0,0 +1,98 @@
+import { readFile } from "node:fs/promises";
+import { basename, resolve } from "node:path";
+import { Type } from "@earendil-works/pi-ai";
+import { defineTool } from "@earendil-works/pi-coding-agent";
+import { listWorkspaceNodes } from "./workspace-navigator.js";
+const defaultMaxNodes = 300;
+const maxComponents = 40;
+const maxDependencies = 40;
+function componentId(path) {
+    const normalized = path.replace(/[^A-Za-z0-9]+/g, "_").replace(/^_+|_+$/g, "");
+    return `component_${normalized || "root"}`;
+}
+function dependencyId(name) {
+    const normalized = name.replace(/[^A-Za-z0-9]+/g, "_").replace(/^_+|_+$/g, "");
+    return `dependency_${normalized || "package"}`;
+}
+function escapeLabel(value) {
+    return value.replace(/["\r\n]/g, (character) => (character === '"' ? """ : " "));
+}
+function topLevelComponents(nodes) {
+    return nodes
+        .filter((node) => node.kind === "directory" && node.depth === 1)
+        .slice(0, maxComponents)
+        .map((directory) => {
+        const prefix = `${directory.path}/`;
+        const descendants = nodes.filter((node) => node.path.startsWith(prefix));
+        return {
+            id: componentId(directory.path),
+            label: directory.name,
+            path: directory.path,
+            files: descendants.filter((node) => node.kind === "file").length,
+            directories: descendants.filter((node) => node.kind === "directory").length,
+        };
+    });
+}
+async function packageDependencies(root) {
+    try {
+        const parsed = JSON.parse(await readFile(resolve(root, "package.json"), "utf8"));
+        const sections = [parsed.dependencies, parsed.devDependencies, parsed.peerDependencies, parsed.optionalDependencies];
+        return [...new Set(sections.flatMap((section) => (section !== null && typeof section === "object" && !Array.isArray(section) ? Object.keys(section) : [])))]
+            .sort((left, right) => left.localeCompare(right))
+            .slice(0, maxDependencies);
+    }
+    catch {
+        return [];
+    }
+}
+function render(workspace, components, dependencies) {
+    const lines = [`flowchart LR`, `    project["${escapeLabel(basename(workspace) || "workspace")}"]`];
+    for (const component of components) {
+        lines.push(`    ${component.id}["${escapeLabel(component.label)}\\n${component.files} files · ${component.directories} dirs"]`);
+        lines.push(`    project --> ${component.id}`);
+    }
+    for (const dependency of dependencies) {
+        const id = dependencyId(dependency);
+        lines.push(`    ${id}["${escapeLabel(dependency)}"]`);
+        lines.push(`    project --> ${id}`);
+    }
+    return lines.join("\n");
+}
+export async function buildArchitectureReport(root, maxNodes = defaultMaxNodes) {
+    const workspace = resolve(root);
+    const tree = await listWorkspaceNodes(workspace, { maxDepth: 4, maxNodes: Math.max(1, Math.min(500, Math.trunc(maxNodes))) });
+    const components = topLevelComponents(tree.nodes);
+    const dependencies = await packageDependencies(workspace);
+    return { workspace, components, dependencies, truncated: tree.truncated, mermaid: render(workspace, components, dependencies) };
+}
+export default {
+    name: "pi-archify",
+    inject: ["piHarnessLaunch", "piPluginUi", "piTools"],
+    apply(context) {
+        let latest;
+        const unregister = context.piTools.register(defineTool({
+            name: "architecture_map",
+            label: "Architecture map",
+            description: "Build a bounded, read-only architecture map from top-level workspace components and package dependencies.",
+            promptSnippet: "map the current workspace architecture",
+            parameters: Type.Object({ maxNodes: Type.Optional(Type.Number({ description: "Maximum scanned workspace nodes, 1-500" })) }),
+            async execute(_toolCallId, params) {
+                latest = await buildArchitectureReport(context.piHarnessLaunch.cwd, params.maxNodes);
+                return { content: [{ type: "text", text: latest.mermaid }], details: latest };
+            },
+        }));
+        const disposePanel = context.piPluginUi.register({
+            id: "archify-panel",
+            pluginId: "@pi-harness/core/plugins/archify",
+            title: "Architecture Map",
+            description: "从工作区目录和 package.json 依赖生成可审计的架构图源码。",
+            icon: "⌘",
+            read: () => ({ latest: latest ?? null, componentCount: latest?.components.length ?? 0, dependencyCount: latest?.dependencies.length ?? 0 }),
+        });
+        context.effect(() => () => {
+            unregister();
+            disposePanel();
+        });
+    },
+};
+//# sourceMappingURL=archify.js.map

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

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

package/packages/core/dist/plugins/at-file.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=at-file.d.ts.map

package/packages/core/dist/plugins/at-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"at-file.d.ts","sourceRoot":"","sources":["../../src/plugins/at-file.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;;;;mBAiBlC,OAAO;;AAHxB,wBAqCE"}

package/packages/core/dist/plugins/at-file.js

@@ -0,0 +1,52 @@
+import { readFile, stat } from "node:fs/promises";
+import { relative, resolve } from "node:path";
+import { Type } from "@earendil-works/pi-ai";
+import { defineTool } from "@earendil-works/pi-coding-agent";
+const maxBytes = 256 * 1024;
+function resolveWorkspaceFile(workspace, requested) {
+    const root = resolve(workspace);
+    const target = resolve(root, requested);
+    const path = relative(root, target);
+    if (path.startsWith("..") || path.includes("/.."))
+        throw new Error("File path must stay inside the current workspace");
+    return target;
+}
+export default {
+    name: "pi-at-file",
+    inject: ["piHarnessLaunch", "piPluginUi", "piTools"],
+    apply(context) {
+        let lastFile;
+        const unregisterTool = context.piTools.register(defineTool({
+            name: "file_context",
+            label: "File context",
+            description: "Attach a text file from the current workspace to the model context with a bounded size.",
+            promptSnippet: "attach a workspace file to the current context",
+            parameters: Type.Object({ path: Type.String({ description: "File path relative to the workspace" }) }),
+            async execute(_toolCallId, params) {
+                const target = resolveWorkspaceFile(context.piHarnessLaunch.cwd, params.path);
+                const metadata = await stat(target);
+                if (!metadata.isFile())
+                    throw new Error("Context path is not a file");
+                if (metadata.size > maxBytes)
+                    throw new Error("Context file exceeds the 256 KiB attachment limit");
+                const path = relative(context.piHarnessLaunch.cwd, target) || ".";
+                const text = await readFile(target, "utf8");
+                lastFile = { path, bytes: metadata.size };
+                return { content: [{ type: "text", text: `<file path="${path}">\n${text}\n</file>` }], details: lastFile };
+            },
+        }));
+        const disposePanel = context.piPluginUi.register({
+            id: "at-file-panel",
+            pluginId: "@pi-harness/core/plugins/at-file",
+            title: "@file 上下文",
+            description: "将工作区内的文本文件安全附加到当前对话。",
+            icon: "⌁",
+            read: () => ({ lastFile: lastFile ?? null, maxBytes }),
+        });
+        context.effect(() => () => {
+            unregisterTool();
+            disposePanel();
+        });
+    },
+};
+//# sourceMappingURL=at-file.js.map

package/packages/core/dist/plugins/at-file.js.map

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

package/packages/core/dist/plugins/auto-mode.d.ts

@@ -0,0 +1,15 @@
+import type { Context } from "@deepseek-ai/cordis";
+import z from "@deepseek-ai/schemastery";
+export interface AutoModePluginConfig {
+    mode?: "safe" | "confirm";
+    timeoutMs?: number;
+}
+export declare const Config: z<AutoModePluginConfig>;
+declare const _default: {
+    name: string;
+    inject: string[];
+    Config: z<AutoModePluginConfig>;
+    apply(context: Context, config: AutoModePluginConfig): void;
+};
+export default _default;
+//# sourceMappingURL=auto-mode.d.ts.map

package/packages/core/dist/plugins/auto-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-mode.d.ts","sourceRoot":"","sources":["../../src/plugins/auto-mode.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,CAAC,MAAM,0BAA0B,CAAC;AAczC,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AACD,eAAO,MAAM,MAAM,EAAE,CAAC,CAAC,oBAAoB,CAGzC,CAAC;;;;;mBAmBc,OAAO,UAAU,oBAAoB;;AAJtD,wBAmFE"}

package/packages/core/dist/plugins/auto-mode.js

@@ -0,0 +1,114 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import z from "@deepseek-ai/schemastery";
+import { Type } from "@earendil-works/pi-ai";
+import { defineTool } from "@earendil-works/pi-coding-agent";
+const execFileAsync = promisify(execFile);
+const maxArgs = 32;
+const maxArgBytes = 4096;
+const maxOutputBytes = 128 * 1024;
+const defaultTimeoutMs = 30_000;
+const shellWrappers = new Set(["sh", "bash", "zsh", "fish", "cmd", "powershell", "pwsh"]);
+const riskyCommands = new Set(["rm", "rmdir", "del", "sudo", "su", "chmod", "chown", "kill", "pkill", "dd", "mkfs"]);
+const riskyWords = new Set(["reset", "clean", "push", "publish", "curl", "wget", "ssh", "scp"]);
+export const Config = z.object({
+    mode: z.union(["safe", "confirm"]).default("safe"),
+    timeoutMs: z.number().default(defaultTimeoutMs),
+});
+function validateCommand(command) {
+    if (command.length === 0 || command.length > maxArgs)
+        throw new Error(`Auto mode command must contain between 1 and ${maxArgs} arguments`);
+    if (command.some((part) => part.length === 0 || Buffer.byteLength(part, "utf8") > maxArgBytes))
+        throw new Error("Auto mode command contains an invalid argument");
+    if (shellWrappers.has((command[0] ?? "").split("/").at(-1).toLowerCase()))
+        throw new Error("Auto mode rejects shell wrappers; pass an executable argv directly");
+}
+function isRisky(command) {
+    const executable = (command[0] ?? "").split("/").at(-1).toLowerCase();
+    return riskyCommands.has(executable) || command.slice(1).some((part) => riskyWords.has(part.toLowerCase()));
+}
+export default {
+    name: "pi-auto-mode",
+    inject: ["piHarnessLaunch", "piPluginUi", "piTools"],
+    Config,
+    apply(context, config) {
+        const mode = config.mode === "confirm" ? "confirm" : "safe";
+        const timeoutMs = Math.max(1_000, Math.min(120_000, Math.trunc(config.timeoutMs ?? defaultTimeoutMs)));
+        let blocked = 0;
+        let last;
+        const execute = async (command, confirm) => {
+            try {
+                validateCommand(command);
+            }
+            catch (error) {
+                blocked += 1;
+                throw error;
+            }
+            const risky = isRisky(command);
+            if (risky && !confirm) {
+                blocked += 1;
+                throw new Error("Auto mode blocked a risky command; retry with confirm=true");
+            }
+            if (mode === "confirm" && !confirm) {
+                blocked += 1;
+                throw new Error("Auto mode is configured for confirmation; retry with confirm=true");
+            }
+            const started = Date.now();
+            try {
+                const result = await execFileAsync(command[0], command.slice(1), { cwd: context.piHarnessLaunch.cwd, timeout: timeoutMs, maxBuffer: maxOutputBytes });
+                last = {
+                    command: [...command],
+                    allowed: true,
+                    confirmed: confirm,
+                    exitCode: 0,
+                    stdout: result.stdout.slice(-maxOutputBytes),
+                    stderr: result.stderr.slice(-maxOutputBytes),
+                    durationMs: Date.now() - started,
+                };
+            }
+            catch (error) {
+                const failure = error;
+                last = {
+                    command: [...command],
+                    allowed: true,
+                    confirmed: confirm,
+                    exitCode: typeof failure.code === "number" ? failure.code : 1,
+                    stdout: (failure.stdout ?? "").slice(-maxOutputBytes),
+                    stderr: (failure.stderr ?? failure.message ?? "").slice(-maxOutputBytes),
+                    durationMs: Date.now() - started,
+                };
+            }
+            return last;
+        };
+        const unregisterTool = context.piTools.register(defineTool({
+            name: "auto_mode_exec",
+            label: "Auto mode exec",
+            description: "Execute an argv command under the configured safe/confirmation policy without a shell.",
+            promptSnippet: "run a command through the safe auto-mode policy",
+            parameters: Type.Object({
+                command: Type.Array(Type.String()),
+                confirm: Type.Optional(Type.Boolean({ description: "Confirm a risky or confirmation-mode command" })),
+            }),
+            async execute(_toolCallId, params) {
+                const result = await execute(params.command, params.confirm === true);
+                return {
+                    content: [{ type: "text", text: `${result.command.join(" ")} exited with ${result.exitCode ?? "unknown"}.\n${result.stdout}${result.stderr}` }],
+                    details: result,
+                };
+            },
+        }));
+        const disposePanel = context.piPluginUi.register({
+            id: "auto-mode-panel",
+            pluginId: "@pi-harness/core/plugins/auto-mode",
+            title: "Auto Mode",
+            description: "按安全策略执行 argv 命令，风险操作需要确认。",
+            icon: "◈",
+            read: () => ({ mode, timeoutMs, blocked, last: last ?? null }),
+        });
+        context.effect(() => () => {
+            unregisterTool();
+            disposePanel();
+        });
+    },
+};
+//# sourceMappingURL=auto-mode.js.map

package/packages/core/dist/plugins/auto-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-mode.js","sourceRoot":"","sources":["../../src/plugins/auto-mode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,CAAC,MAAM,0BAA0B,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAwB,MAAM,iCAAiC,CAAC;AAEnF,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAC1C,MAAM,OAAO,GAAG,EAAE,CAAC;AACnB,MAAM,WAAW,GAAG,IAAI,CAAC;AACzB,MAAM,cAAc,GAAG,GAAG,GAAG,IAAI,CAAC;AAClC,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAChC,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC;AAC1F,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;AACrH,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;AAOhG,MAAM,CAAC,MAAM,MAAM,GAA4B,CAAC,CAAC,MAAM,CAAC;IACtD,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;IAClD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,gBAAgB,CAAC;CAChD,CAAC,CAAC;AAEH,SAAS,eAAe,CAAC,OAAiB;IACxC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,gDAAgD,OAAO,YAAY,CAAC,CAAC;IAC3I,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,WAAW,CAAC;QAC5F,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACpE,IAAI,aAAa,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAE,CAAC,WAAW,EAAE,CAAC;QACxE,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC;AAC1F,CAAC;AAED,SAAS,OAAO,CAAC,OAAiB;IAChC,MAAM,UAAU,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAE,CAAC,WAAW,EAAE,CAAC;IACvE,OAAO,aAAa,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;AAC9G,CAAC;AAED,eAAe;IACb,IAAI,EAAE,cAAc;IACpB,MAAM,EAAE,CAAC,iBAAiB,EAAE,YAAY,EAAE,SAAS,CAAC;IACpD,MAAM;IACN,KAAK,CAAC,OAAgB,EAAE,MAA4B;QAClD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC;QAC5D,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,IAAI,gBAAgB,CAAC,CAAC,CAAC,CAAC;QACvG,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,IAAI,IAAgC,CAAC;QACrC,MAAM,OAAO,GAAG,KAAK,EAAE,OAAiB,EAAE,OAAgB,EAA2B,EAAE;YACrF,IAAI,CAAC;gBACH,eAAe,CAAC,OAAO,CAAC,CAAC;YAC3B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,IAAI,CAAC,CAAC;gBACb,MAAM,KAAK,CAAC;YACd,CAAC;YACD,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;YAC/B,IAAI,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;gBACtB,OAAO,IAAI,CAAC,CAAC;gBACb,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;YAChF,CAAC;YACD,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,OAAO,EAAE,CAAC;gBACnC,OAAO,IAAI,CAAC,CAAC;gBACb,MAAM,IAAI,KAAK,CAAC,mEAAmE,CAAC,CAAC;YACvF,CAAC;YACD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC3B,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,CAAC,CAAE,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC,CAAC;gBACvJ,IAAI,GAAG;oBACL,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC;oBACrB,OAAO,EAAE,IAAI;oBACb,SAAS,EAAE,OAAO;oBAClB,QAAQ,EAAE,CAAC;oBACX,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC;oBAC5C,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC;oBAC5C,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO;iBACjC,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,OAAO,GAAG,KAAuF,CAAC;gBACxG,IAAI,GAAG;oBACL,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC;oBACrB,OAAO,EAAE,IAAI;oBACb,SAAS,EAAE,OAAO;oBAClB,QAAQ,EAAE,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;oBAC7D,MAAM,EAAE,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC;oBACrD,MAAM,EAAE,CAAC,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC;oBACxE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO;iBACjC,CAAC;YACJ,CAAC;YACD,OAAO,IAAI,CAAC;QACd,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,wFAAwF;YACrG,aAAa,EAAE,iDAAiD;YAChE,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC;gBACtB,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;gBAClC,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,8CAA8C,EAAE,CAAC,CAAC;aACtG,CAAC;YACF,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM;gBAC/B,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC;gBACtE,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,gBAAgB,MAAM,CAAC,QAAQ,IAAI,SAAS,MAAM,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;oBAC/I,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,iBAAiB;YACrB,QAAQ,EAAE,oCAAoC;YAC9C,KAAK,EAAE,WAAW;YAClB,WAAW,EAAE,2BAA2B;YACxC,IAAI,EAAE,GAAG;YACT,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,IAAI,IAAI,EAAE,CAAC;SAC/D,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/better-sidebar.d.ts

@@ -0,0 +1,37 @@
+import type { Context } from "@deepseek-ai/cordis";
+import { type WorkspaceGitStatus, type WorkspaceNodeReport } from "./workspace-navigator.js";
+export interface SidebarOverviewInput {
+    readonly cwd: string;
+    readonly gitAvailable: boolean;
+    readonly branch: string | null;
+    readonly clean: boolean;
+    readonly changedFiles: readonly {
+        readonly path: string;
+        readonly status: string;
+    }[];
+    readonly directoryCount: number;
+    readonly fileCount: number;
+    readonly truncated: boolean;
+    readonly sessionId: string;
+}
+export interface SidebarOverview extends SidebarOverviewInput {
+    readonly changedCount: number;
+    readonly summary: string;
+}
+export declare function summarizeSidebar(input: SidebarOverviewInput): SidebarOverview;
+export declare function createSidebarInspector(input: {
+    readonly cwd: string;
+    readonly getSessionId: () => string;
+    readonly listNodes?: (root: string, options: {
+        maxDepth: number;
+        maxNodes: number;
+    }) => Promise<WorkspaceNodeReport>;
+    readonly readGitStatus?: (root: string) => Promise<WorkspaceGitStatus>;
+}): () => Promise<SidebarOverview>;
+declare const _default: {
+    name: string;
+    inject: string[];
+    apply(context: Context): void;
+};
+export default _default;
+//# sourceMappingURL=better-sidebar.d.ts.map

package/packages/core/dist/plugins/better-sidebar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"better-sidebar.d.ts","sourceRoot":"","sources":["../../src/plugins/better-sidebar.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAGnD,OAAO,EAA8C,KAAK,kBAAkB,EAAE,KAAK,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAEzI,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,SAAS;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACrF,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,eAAgB,SAAQ,oBAAoB;IAC3D,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,oBAAoB,GAAG,eAAe,CAM7E;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAC5C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,YAAY,EAAE,MAAM,MAAM,CAAC;IACpC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACrH,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;CACxE,GAAG,MAAM,OAAO,CAAC,eAAe,CAAC,CAqCjC;;;;mBAagB,OAAO;;AAHxB,wBAkCE"}

package/packages/core/dist/plugins/better-sidebar.js

@@ -0,0 +1,89 @@
+import { Type } from "@earendil-works/pi-ai";
+import { defineTool } from "@earendil-works/pi-coding-agent";
+import { listWorkspaceNodes, readWorkspaceGitStatus } from "./workspace-navigator.js";
+export function summarizeSidebar(input) {
+    const changedCount = input.changedFiles.length;
+    const summary = !input.gitAvailable
+        ? `非 Git 工作区 · ${changedCount > 0 ? `${changedCount} 个变更` : "无变更"}`
+        : `${input.branch ?? "detached HEAD"} · ${changedCount > 0 ? `${changedCount} 个变更` : "clean"}`;
+    return { ...input, changedFiles: input.changedFiles.slice(0, 12), changedCount, summary };
+}
+export function createSidebarInspector(input) {
+    const readNodes = input.listNodes ?? listWorkspaceNodes;
+    const readGit = input.readGitStatus ?? readWorkspaceGitStatus;
+    let tree;
+    let inFlight;
+    const inspect = async () => {
+        const [currentTree, git] = await Promise.all([
+            tree === undefined
+                ? readNodes(input.cwd, { maxDepth: 2, maxNodes: 80 }).then((result) => {
+                    tree = result;
+                    return result;
+                })
+                : Promise.resolve(tree),
+            readGit(input.cwd),
+        ]);
+        return summarizeSidebar({
+            cwd: input.cwd,
+            gitAvailable: git.available,
+            branch: git.available ? git.branch : null,
+            clean: git.available && git.clean,
+            changedFiles: git.entries,
+            directoryCount: currentTree.directoryCount,
+            fileCount: currentTree.fileCount,
+            truncated: currentTree.truncated,
+            sessionId: input.getSessionId(),
+        });
+    };
+    return () => {
+        if (inFlight !== undefined)
+            return inFlight;
+        const current = inspect().finally(() => {
+            if (inFlight === current)
+                inFlight = undefined;
+        });
+        inFlight = current;
+        return current;
+    };
+}
+function textSummary(report) {
+    const files = report.changedFiles
+        .slice(0, 8)
+        .map((entry) => `${entry.status} ${entry.path}`)
+        .join(", ");
+    return `${report.summary}; ${report.directoryCount} 个目录，${report.fileCount} 个文件${files ? `; ${files}` : ""}`;
+}
+export default {
+    name: "pi-better-sidebar",
+    inject: ["piHarnessLaunch", "piSession", "piPluginUi", "piTools"],
+    apply(context) {
+        const inspect = createSidebarInspector({
+            cwd: context.piHarnessLaunch.cwd,
+            getSessionId: () => context.piSession.manager.getSessionId(),
+        });
+        const unregisterTool = context.piTools.register(defineTool({
+            name: "sidebar_overview",
+            label: "Sidebar overview",
+            description: "Read a compact workspace and Git overview for the current session without modifying files.",
+            promptSnippet: "inspect the workspace overview shown in the sidebar",
+            parameters: Type.Object({}),
+            async execute() {
+                const report = await inspect();
+                return { content: [{ type: "text", text: textSummary(report) }], details: report };
+            },
+        }));
+        const disposePanel = context.piPluginUi.register({
+            id: "better-sidebar-panel",
+            pluginId: "@pi-harness/core/plugins/better-sidebar",
+            title: "Better Sidebar",
+            description: "在会话旁显示当前工作区、Git 变更和文件概览。",
+            icon: "▤",
+            read: inspect,
+        });
+        context.effect(() => () => {
+            unregisterTool();
+            disposePanel();
+        });
+    },
+};
+//# sourceMappingURL=better-sidebar.js.map

package/packages/core/dist/plugins/better-sidebar.js.map

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

package/packages/core/dist/plugins/browser-fetch.d.ts

@@ -0,0 +1,14 @@
+import type { Context } from "@deepseek-ai/cordis";
+import z from "@deepseek-ai/schemastery";
+export interface BrowserFetchPluginConfig {
+    allowPrivate?: boolean;
+}
+export declare const Config: z<BrowserFetchPluginConfig>;
+declare const _default: {
+    name: string;
+    inject: string[];
+    Config: z<BrowserFetchPluginConfig>;
+    apply(context: Context, config: BrowserFetchPluginConfig): void;
+};
+export default _default;
+//# sourceMappingURL=browser-fetch.d.ts.map

package/packages/core/dist/plugins/browser-fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-fetch.d.ts","sourceRoot":"","sources":["../../src/plugins/browser-fetch.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,CAAC,MAAM,0BAA0B,CAAC;AAiIzC,MAAM,WAAW,wBAAwB;IACvC,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,eAAO,MAAM,MAAM,EAAE,CAAC,CAAC,wBAAwB,CAA0D,CAAC;;;;;mBAMzF,OAAO,UAAU,wBAAwB;;AAJ1D,wBAgCE"}