@pi-harness/pi-harness 0.1.4 → 0.1.6

package/node_modules/@pi-harness/core/dist/plugins/mock-server.js

@@ -0,0 +1,149 @@
+import { createServer } from "node:http";
+import z from "@deepseek-ai/schemastery";
+import { Type } from "@earendil-works/pi-ai";
+import { defineTool } from "@earendil-works/pi-coding-agent";
+const maxRoutes = 64;
+const maxBodyBytes = 128 * 1024;
+const allowedMethods = new Set(["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]);
+const routeConfig = z.object({
+    path: z.string(),
+    method: z.string().default("GET"),
+    status: z.number().default(200),
+    headers: z.dict(z.string()).default({}),
+    body: z.string().default(""),
+});
+export const Config = z.object({ port: z.number().default(0), routes: z.array(routeConfig).default([]) });
+function normalizeRoutes(routes) {
+    if (routes.length > maxRoutes)
+        throw new Error(`Mock server cannot exceed ${maxRoutes} routes`);
+    return routes.map((route) => {
+        const path = route.path.trim();
+        if (!path.startsWith("/") || path.length > 2048 || path.includes("#"))
+            throw new Error("Mock route path must start with / and be at most 2048 characters");
+        const method = (route.method ?? "GET").trim().toUpperCase();
+        if (!allowedMethods.has(method))
+            throw new Error(`Mock route method is not allowed: ${method}`);
+        const status = route.status ?? 200;
+        if (!Number.isInteger(status) || status < 100 || status > 599)
+            throw new Error("Mock route status must be an integer between 100 and 599");
+        const body = route.body ?? "";
+        if (Buffer.byteLength(body, "utf8") > maxBodyBytes)
+            throw new Error(`Mock route body cannot exceed ${maxBodyBytes} bytes`);
+        const headers = Object.fromEntries(Object.entries(route.headers ?? {}).map(([name, value]) => [name, String(value)]));
+        return { path, method, status, headers, body };
+    });
+}
+function routeKey(method, path) {
+    return `${method} ${path}`;
+}
+export default {
+    name: "pi-mock-server",
+    inject: ["piPluginUi", "piTools"],
+    Config,
+    apply(context, config) {
+        const routes = normalizeRoutes(config.routes ?? []);
+        let server;
+        let state = { running: false, url: null, routes: routes.length, lastRequest: null };
+        const start = async (requestedPort) => {
+            if (server !== undefined)
+                throw new Error("Mock server is already running");
+            const port = requestedPort ?? config.port ?? 0;
+            if (!Number.isInteger(port) || port < 0 || port > 65535)
+                throw new Error("Mock server port must be an integer between 0 and 65535");
+            const routeMap = new Map(routes.map((route) => [routeKey(route.method ?? "GET", route.path), route]));
+            server = createServer((request, response) => {
+                const method = (request.method ?? "GET").toUpperCase();
+                const pathname = new URL(request.url ?? "/", "http://127.0.0.1").pathname;
+                state = { ...state, lastRequest: routeKey(method, pathname) };
+                const route = routeMap.get(routeKey(method, pathname));
+                if (route === undefined) {
+                    response.statusCode = 404;
+                    response.setHeader("content-type", "text/plain; charset=utf-8");
+                    response.end("Not found");
+                    return;
+                }
+                response.statusCode = route.status ?? 200;
+                for (const [name, value] of Object.entries(route.headers ?? {}))
+                    response.setHeader(name, value);
+                if (!response.hasHeader("content-type"))
+                    response.setHeader("content-type", "text/plain; charset=utf-8");
+                response.end(route.body ?? "");
+            });
+            await new Promise((resolve, reject) => {
+                const onError = (error) => {
+                    server?.off("listening", onListening);
+                    reject(error);
+                };
+                const onListening = () => {
+                    server?.off("error", onError);
+                    resolve();
+                };
+                server.once("error", onError);
+                server.once("listening", onListening);
+                server.listen(port, "127.0.0.1");
+            });
+            const address = server.address();
+            if (address === null || typeof address === "string")
+                throw new Error("Mock server did not expose a TCP address");
+            state = { ...state, running: true, url: `http://127.0.0.1:${address.port}` };
+            return state;
+        };
+        const stop = async () => {
+            if (server === undefined)
+                return false;
+            const current = server;
+            server = undefined;
+            await new Promise((resolve, reject) => current.close((error) => (error ? reject(error) : resolve())));
+            state = { ...state, running: false, url: null };
+            return true;
+        };
+        const unregisterStart = context.piTools.register(defineTool({
+            name: "mock_server_start",
+            label: "Mock server start",
+            description: "Start a local deterministic HTTP mock server from configured routes.",
+            promptSnippet: "start the local mock HTTP server",
+            parameters: Type.Object({ port: Type.Optional(Type.Number({ description: "Bind port; 0 selects a free local port" })) }),
+            async execute(_toolCallId, params) {
+                const result = await start(params.port);
+                return { content: [{ type: "text", text: `Mock server listening at ${result.url}` }], details: result };
+            },
+        }));
+        const unregisterStop = context.piTools.register(defineTool({
+            name: "mock_server_stop",
+            label: "Mock server stop",
+            description: "Stop the local HTTP mock server.",
+            promptSnippet: "stop the local mock HTTP server",
+            parameters: Type.Object({}),
+            async execute() {
+                const stopped = await stop();
+                return { content: [{ type: "text", text: stopped ? "Mock server stopped." : "Mock server was not running." }], details: { stopped } };
+            },
+        }));
+        const unregisterStatus = context.piTools.register(defineTool({
+            name: "mock_server_status",
+            label: "Mock server status",
+            description: "Show local HTTP mock server status and route count.",
+            promptSnippet: "check the local mock server status",
+            parameters: Type.Object({}),
+            execute() {
+                return Promise.resolve({ content: [{ type: "text", text: `${state.running ? "running" : "stopped"} ${state.url ?? ""}`.trim() }], details: state });
+            },
+        }));
+        const disposePanel = context.piPluginUi.register({
+            id: "mock-server-panel",
+            pluginId: "@pi-harness/core/plugins/mock-server",
+            title: "Mock Server",
+            description: "在本机回环地址提供可控的 HTTP mock 路由。",
+            icon: "⇄",
+            read: () => state,
+        });
+        context.effect(() => () => {
+            unregisterStart();
+            unregisterStop();
+            unregisterStatus();
+            disposePanel();
+            void stop();
+        });
+    },
+};
+//# sourceMappingURL=mock-server.js.map

package/node_modules/@pi-harness/core/dist/plugins/mock-server.js.map

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

package/node_modules/@pi-harness/core/dist/plugins/model.d.ts

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

package/node_modules/@pi-harness/core/dist/plugins/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../src/plugins/model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;;;;mBAMlC,OAAO,UAAU,OAAO;;AAHzC,wBAUE"}

package/node_modules/@pi-harness/core/dist/plugins/model.js

@@ -0,0 +1,14 @@
+import { assertKnownConfigKeys } from "../config.js";
+export default {
+    name: "pi-model",
+    inject: ["piModelRuntime", "piResources"],
+    apply(context, config) {
+        assertKnownConfigKeys("pi-model", config, []);
+        const { runtime, provider, model: modelId } = context.piModelRuntime;
+        const model = runtime.getModel(provider, modelId);
+        if (model === undefined)
+            throw new Error(`Pi model is not registered: ${provider}/${modelId}`);
+        context.provide("piModels", { runtime, model });
+    },
+};
+//# sourceMappingURL=model.js.map

package/node_modules/@pi-harness/core/dist/plugins/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../../src/plugins/model.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAErD,eAAe;IACb,IAAI,EAAE,UAAU;IAChB,MAAM,EAAE,CAAC,gBAAgB,EAAE,aAAa,CAAC;IACzC,KAAK,CAAC,OAAgB,EAAE,MAAe;QACrC,qBAAqB,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;QAC9C,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC;QACrE,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAClD,IAAI,KAAK,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,QAAQ,IAAI,OAAO,EAAE,CAAC,CAAC;QAC/F,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;IAClD,CAAC;CACF,CAAC"}

package/node_modules/@pi-harness/core/dist/plugins/models.d.ts

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

package/node_modules/@pi-harness/core/dist/plugins/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../src/plugins/models.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,CAAC,MAAM,0BAA0B,CAAC;AAIzC,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,eAAO,MAAM,MAAM,EAAE,CAAC,CAAC,kBAAkB,CAIvC,CAAC;;;;;mBAMoB,OAAO,UAAU,kBAAkB;;AAJ1D,wBAgBE"}

package/node_modules/@pi-harness/core/dist/plugins/models.js

@@ -0,0 +1,27 @@
+import { join } from "node:path";
+import z from "@deepseek-ai/schemastery";
+import { ModelRuntime } from "@earendil-works/pi-coding-agent";
+import { assertKnownConfigKeys } from "../config.js";
+export const Config = z.object({
+    provider: z.string().required().min(1),
+    model: z.string().required().min(1),
+    refreshOnCreate: z.boolean().default(false),
+});
+export default {
+    name: "pi-models",
+    inject: ["piHarnessLaunch"],
+    Config,
+    async apply(context, config) {
+        assertKnownConfigKeys("pi-models", config, ["provider", "model", "refreshOnCreate"]);
+        const agentDir = context.piHarnessLaunch.agentDir;
+        const runtime = await ModelRuntime.create({
+            authPath: join(agentDir, "auth.json"),
+            modelsPath: join(agentDir, "models.json"),
+            modelsStorePath: join(agentDir, "models-store.json"),
+            refreshOnCreate: config.refreshOnCreate ?? false,
+            allowModelNetwork: config.refreshOnCreate ?? false,
+        });
+        context.provide("piModelRuntime", { runtime, provider: config.provider, model: config.model });
+    },
+};
+//# sourceMappingURL=models.js.map

package/node_modules/@pi-harness/core/dist/plugins/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../../src/plugins/models.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,CAAC,MAAM,0BAA0B,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAQrD,MAAM,CAAC,MAAM,MAAM,GAA0B,CAAC,CAAC,MAAM,CAAC;IACpD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACtC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACnC,eAAe,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;CAC5C,CAAC,CAAC;AAEH,eAAe;IACb,IAAI,EAAE,WAAW;IACjB,MAAM,EAAE,CAAC,iBAAiB,CAAC;IAC3B,MAAM;IACN,KAAK,CAAC,KAAK,CAAC,OAAgB,EAAE,MAA0B;QACtD,qBAAqB,CAAC,WAAW,EAAE,MAAM,EAAE,CAAC,UAAU,EAAE,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC;QACrF,MAAM,QAAQ,GAAG,OAAO,CAAC,eAAe,CAAC,QAAQ,CAAC;QAClD,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC;YACxC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC;YACrC,UAAU,EAAE,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC;YACzC,eAAe,EAAE,IAAI,CAAC,QAAQ,EAAE,mBAAmB,CAAC;YACpD,eAAe,EAAE,MAAM,CAAC,eAAe,IAAI,KAAK;YAChD,iBAAiB,EAAE,MAAM,CAAC,eAAe,IAAI,KAAK;SACnD,CAAC,CAAC;QACH,OAAO,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;IACjG,CAAC;CACF,CAAC"}

package/node_modules/@pi-harness/core/dist/plugins/modlens.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=modlens.d.ts.map

package/node_modules/@pi-harness/core/dist/plugins/modlens.d.ts.map

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

package/node_modules/@pi-harness/core/dist/plugins/modlens.js

@@ -0,0 +1,63 @@
+import { readFile, stat } from "node:fs/promises";
+import { extname, relative, resolve } from "node:path";
+import { Type } from "@earendil-works/pi-ai";
+import { defineTool } from "@earendil-works/pi-coding-agent";
+const mimeByExtension = {
+    ".gif": "image/gif",
+    ".jpeg": "image/jpeg",
+    ".jpg": "image/jpeg",
+    ".png": "image/png",
+    ".webp": "image/webp",
+};
+export default {
+    name: "pi-modlens",
+    inject: ["piHarnessLaunch", "piTools", "piPluginUi"],
+    apply(context) {
+        let lastImage;
+        const unregisterTool = context.piTools.register(defineTool({
+            name: "vision_inspect",
+            label: "Vision inspect",
+            description: "Attach a local image from the current workspace so a vision-capable model can inspect it.",
+            promptSnippet: "attach a local image for visual inspection",
+            parameters: Type.Object({ path: Type.String({ description: "Image path relative to the workspace" }) }),
+            async execute(_toolCallId, params) {
+                const workspace = resolve(context.piHarnessLaunch.cwd);
+                const target = resolve(workspace, params.path);
+                const relativePath = relative(workspace, target);
+                if (relativePath.startsWith("..") || relativePath.includes("/.."))
+                    throw new Error("Image path must stay inside the current workspace");
+                const mimeType = mimeByExtension[extname(target).toLowerCase()];
+                if (mimeType === undefined)
+                    throw new Error("Unsupported image type; use png, jpeg, gif, or webp");
+                const metadata = await stat(target);
+                if (!metadata.isFile())
+                    throw new Error("Image path is not a file");
+                if (metadata.size > 10 * 1024 * 1024)
+                    throw new Error("Image exceeds the 10 MiB attachment limit");
+                const data = (await readFile(target)).toString("base64");
+                lastImage = { path: relativePath || ".", mimeType, bytes: metadata.size };
+                return {
+                    content: [{ type: "image", data, mimeType }],
+                    details: lastImage,
+                };
+            },
+        }));
+        const disposePanel = context.piPluginUi.register({
+            id: "modlens-panel",
+            pluginId: "@pi-harness/core/plugins/modlens",
+            title: "视觉桥接",
+            description: "将工作区内的图片安全附加到当前对话，交由支持视觉的模型分析。",
+            icon: "◉",
+            read: () => ({
+                attached: lastImage !== undefined,
+                image: lastImage ?? null,
+                supportedTypes: Object.keys(mimeByExtension).map((extension) => extension.slice(1)),
+            }),
+        });
+        context.effect(() => () => {
+            unregisterTool();
+            disposePanel();
+        });
+    },
+};
+//# sourceMappingURL=modlens.js.map

package/node_modules/@pi-harness/core/dist/plugins/modlens.js.map

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

package/node_modules/@pi-harness/core/dist/plugins/module-search.d.ts

@@ -0,0 +1,27 @@
+import type { Context } from "@deepseek-ai/cordis";
+export type ModuleMatchKind = "import" | "export" | "symbol";
+export type ModuleMatch = {
+    kind: ModuleMatchKind;
+    name: string;
+    path: string;
+    line: number;
+    text: string;
+};
+export type ModuleSearchKind = ModuleMatchKind | "all";
+export type ModuleSearchReport = {
+    query: string;
+    kind: ModuleSearchKind;
+    path: string;
+    matches: ModuleMatch[];
+    scannedFiles: number;
+    skippedFiles: number;
+    truncated: boolean;
+};
+export declare function extractModuleMatches(source: string, path: string, query: string, kind: ModuleSearchKind): ModuleMatch[];
+declare const _default: {
+    name: string;
+    inject: string[];
+    apply(context: Context): void;
+};
+export default _default;
+//# sourceMappingURL=module-search.d.ts.map

package/node_modules/@pi-harness/core/dist/plugins/module-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-search.d.ts","sourceRoot":"","sources":["../../src/plugins/module-search.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAanD,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAC7D,MAAM,MAAM,WAAW,GAAG;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAC5G,MAAM,MAAM,gBAAgB,GAAG,eAAe,GAAG,KAAK,CAAC;AACvD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,gBAAgB,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;CACpB,CAAC;AA8CF,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,GAAG,WAAW,EAAE,CAevH;;;;mBAuBgB,OAAO;;AAHxB,wBA6FE"}

package/node_modules/@pi-harness/core/dist/plugins/module-search.js

@@ -0,0 +1,174 @@
+import { lstat, readdir, 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";
+import { resolveExistingWorkspacePath } from "../workspace-path.js";
+const maxQueryLength = 120;
+const maxPathLength = 512;
+const maxFileBytes = 2 * 1024 * 1024;
+const maxFiles = 1_000;
+const maxResults = 100;
+const ignoredDirectories = new Set([".git", "node_modules", ".pi", "dist", "build"]);
+const sourceExtensions = new Set([".cjs", ".js", ".jsx", ".mjs", ".ts", ".tsx"]);
+function moduleNames(source, kind) {
+    if (kind === "import") {
+        const named = [...source.matchAll(/\bimport\s*\{([^}]*)\}/gu)].flatMap((match) => match[1]
+            ?.split(",")
+            .map((item) => item
+            .trim()
+            .split(/\s+as\s+/iu)[0]
+            ?.trim() ?? "")
+            .filter(Boolean) ?? []);
+        const defaults = [...source.matchAll(/\bimport\s+([A-Za-z_$][\w$]*)\s+from\s*["']/gu)].map((match) => match[1]).filter(Boolean);
+        const namespaces = [...source.matchAll(/\bimport\s+\*\s+as\s+([A-Za-z_$][\w$]*)\s+from\s*["']/gu)].map((match) => match[1]).filter(Boolean);
+        return [...named, ...defaults, ...namespaces];
+    }
+    if (kind === "export") {
+        const declarations = [...source.matchAll(/\bexport\s+(?:async\s+)?(?:function|class|const|let|var|type|interface|enum)\s+([A-Za-z_$][\w$]*)/gu)].map((match) => match[1]);
+        const named = [...source.matchAll(/\bexport\s*\{([^}]*)\}/gu)].flatMap((match) => match[1]
+            ?.split(",")
+            .map((item) => item
+            .trim()
+            .split(/\s+as\s+/iu)
+            .at(-1)
+            ?.trim() ?? "")
+            .filter(Boolean) ?? []);
+        return [...declarations, ...named];
+    }
+    return [...source.matchAll(/\b(?:async\s+)?(?:function|class|const|let|var|type|interface|enum)\s+([A-Za-z_$][\w$]*)/gu)]
+        .map((match) => match[1])
+        .filter(Boolean);
+}
+export function extractModuleMatches(source, path, query, kind) {
+    const normalizedQuery = query.trim().toLocaleLowerCase();
+    if (normalizedQuery.length < 1 || normalizedQuery.length > maxQueryLength)
+        throw new Error("Module search query must contain 1-120 characters");
+    const kinds = kind === "all" ? ["import", "export", "symbol"] : [kind];
+    return source.split(/\r?\n/u).flatMap((line, index) => {
+        const matches = [];
+        for (const entryKind of kinds) {
+            if (kind === "all" && entryKind === "symbol" && /\bexport\b/u.test(line))
+                continue;
+            for (const name of moduleNames(line, entryKind)) {
+                if (!name.toLocaleLowerCase().includes(normalizedQuery))
+                    continue;
+                matches.push({ kind: entryKind, name, path, line: index + 1, text: line });
+            }
+        }
+        return matches;
+    });
+}
+async function filesUnder(target, root, files) {
+    if (files.length >= maxFiles)
+        return;
+    const metadata = await lstat(target);
+    if (metadata.isSymbolicLink())
+        return;
+    if (metadata.isFile()) {
+        if (sourceExtensions.has(target.slice(target.lastIndexOf(".")).toLocaleLowerCase()))
+            files.push(target);
+        return;
+    }
+    if (!metadata.isDirectory())
+        return;
+    const entries = (await readdir(target, { withFileTypes: true })).sort((left, right) => left.name.localeCompare(right.name));
+    for (const entry of entries) {
+        if (files.length >= maxFiles)
+            return;
+        if (entry.isDirectory() && ignoredDirectories.has(entry.name))
+            continue;
+        const child = resolve(target, entry.name);
+        await filesUnder(child, root, files);
+    }
+}
+export default {
+    name: "pi-module-search",
+    inject: ["piHarnessLaunch", "piPluginUi", "piTools"],
+    apply(context) {
+        let latest;
+        const search = async (query, requestedPath, kind, requestedLimit) => {
+            const normalizedQuery = query.trim();
+            if (normalizedQuery.length < 1 || normalizedQuery.length > maxQueryLength)
+                throw new Error("Module search query must contain 1-120 characters");
+            const normalizedKind = kind === "import" || kind === "export" || kind === "symbol" ? kind : "all";
+            const requested = requestedPath?.trim() ?? ".";
+            if (requested.length > maxPathLength || requested.includes("\\"))
+                throw new Error("Module search path must be a relative POSIX path of at most 512 characters");
+            const resolved = await resolveExistingWorkspacePath(context.piHarnessLaunch.cwd, requested, "Module search path must stay inside the current workspace");
+            const root = resolved.root;
+            const target = resolved.target;
+            const targetMetadata = await stat(target);
+            const files = [];
+            await filesUnder(target, root, files);
+            const limit = Math.max(1, Math.min(maxResults, Math.trunc(requestedLimit ?? maxResults)));
+            const matches = [];
+            let truncated = false;
+            let scannedFiles = 0;
+            let skippedFiles = targetMetadata.isFile() && targetMetadata.size > maxFileBytes ? 1 : 0;
+            for (const file of files) {
+                if (matches.length >= limit)
+                    break;
+                const metadata = await stat(file);
+                if (metadata.size > maxFileBytes) {
+                    skippedFiles += 1;
+                    continue;
+                }
+                const source = await readFile(file, "utf8");
+                scannedFiles += 1;
+                const fileMatches = extractModuleMatches(source, relative(root, file), normalizedQuery, normalizedKind);
+                const remaining = limit - matches.length;
+                matches.push(...fileMatches.slice(0, remaining));
+                if (fileMatches.length > remaining)
+                    truncated = true;
+            }
+            const report = {
+                query: normalizedQuery,
+                kind: normalizedKind,
+                path: relative(root, target) || ".",
+                matches,
+                scannedFiles,
+                skippedFiles,
+                truncated: truncated || (matches.length >= limit && files.length > scannedFiles + skippedFiles),
+            };
+            latest = report;
+            return report;
+        };
+        const unregister = context.piTools.register(defineTool({
+            name: "module_search",
+            label: "Search modules",
+            description: "Find imports, exports, or declared symbols in bounded workspace source files without modifying them.",
+            promptSnippet: "find a module import, export, or symbol in the workspace",
+            parameters: Type.Object({
+                query: Type.String({ description: "Name fragment to find, 1-120 characters" }),
+                kind: Type.Optional(Type.Union([Type.Literal("all"), Type.Literal("import"), Type.Literal("export"), Type.Literal("symbol")])),
+                path: Type.Optional(Type.String({ description: "Relative workspace path" })),
+                maxResults: Type.Optional(Type.Number({ description: "Maximum matches, 1-100" })),
+            }),
+            async execute(_toolCallId, params) {
+                const report = await search(params.query, params.path, params.kind ?? "all", params.maxResults);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: report.matches.map((match) => `${match.path}:${match.line} ${match.kind} ${match.name}`).join("\n") || "No module matches found.",
+                        },
+                    ],
+                    details: report,
+                };
+            },
+        }));
+        const disposePanel = context.piPluginUi.register({
+            id: "module-search-panel",
+            pluginId: "@pi-harness/core/plugins/module-search",
+            title: "Module Search",
+            description: "按导入、导出和声明符号检索工作区源码。",
+            icon: "⌕",
+            read: () => ({ latest: latest ?? null, matchCount: latest?.matches.length ?? 0 }),
+        });
+        context.effect(() => () => {
+            unregister();
+            disposePanel();
+        });
+    },
+};
+//# sourceMappingURL=module-search.js.map

package/node_modules/@pi-harness/core/dist/plugins/module-search.js.map

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

package/node_modules/@pi-harness/core/dist/plugins/obsidian-sync.d.ts

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

package/node_modules/@pi-harness/core/dist/plugins/obsidian-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"obsidian-sync.d.ts","sourceRoot":"","sources":["../../src/plugins/obsidian-sync.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,CAAC,MAAM,0BAA0B,CAAC;AAQzC,MAAM,WAAW,wBAAwB;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,MAAM,EAAE,CAAC,CAAC,wBAAwB,CAAmD,CAAC;;;;;mBAWlF,OAAO,UAAU,wBAAwB;;AAJ1D,wBA4DE"}