@pi-harness/pi-harness 0.1.2 → 0.1.3

package/packages/core/dist/plugins/web-research.js

@@ -0,0 +1,275 @@
+import z from "@deepseek-ai/schemastery";
+import { Type } from "@earendil-works/pi-ai";
+import { defineTool } from "@earendil-works/pi-coding-agent";
+const defaultBaseUrl = "https://api.firecrawl.dev";
+const maxQueryLength = 500;
+const maxResponseBytes = 1024 * 1024;
+function normalizeBaseUrl(value) {
+    let url;
+    try {
+        url = new URL((value ?? defaultBaseUrl).trim());
+    }
+    catch {
+        throw new Error("Web research base URL is invalid");
+    }
+    if (url.protocol !== "http:" && url.protocol !== "https:")
+        throw new Error("Web research base URL must use http or https");
+    if (url.username !== "" || url.password !== "")
+        throw new Error("Web research base URL must not contain credentials");
+    return url.toString().replace(/\/+$/u, "");
+}
+function boundedInteger(value, fallback, minimum, maximum) {
+    const normalized = Math.trunc(value ?? fallback);
+    if (!Number.isFinite(normalized))
+        return fallback;
+    return Math.max(minimum, Math.min(maximum, normalized));
+}
+function stringValue(value, maxLength) {
+    return typeof value === "string" ? value.trim().slice(0, maxLength) : "";
+}
+function httpUrl(value) {
+    if (typeof value !== "string")
+        return undefined;
+    try {
+        const url = new URL(value);
+        if (url.protocol !== "http:" && url.protocol !== "https:")
+            return undefined;
+        return url.toString();
+    }
+    catch {
+        return undefined;
+    }
+}
+function normalizeSearchItems(payload, limit) {
+    if (payload.data === undefined || payload.data === null || typeof payload.data !== "object" || !Array.isArray(payload.data.web))
+        return [];
+    return payload.data.web.slice(0, limit).flatMap((entry) => {
+        if (entry === null || typeof entry !== "object")
+            return [];
+        const item = entry;
+        const url = httpUrl(item.url);
+        if (url === undefined)
+            return [];
+        return [
+            {
+                title: stringValue(item.title, 500) || url,
+                url,
+                snippet: stringValue(item.description, 4_000),
+                source: new URL(url).hostname,
+                ...(stringValue(item.publishedDate, 100) === "" ? {} : { publishedAt: stringValue(item.publishedDate, 100) }),
+            },
+        ];
+    });
+}
+async function readBoundedText(response) {
+    const declaredLength = Number(response.headers.get("content-length"));
+    if (Number.isFinite(declaredLength) && declaredLength > maxResponseBytes)
+        throw new Error("Web research response exceeded the 1 MiB limit");
+    if (response.body === null)
+        throw new Error("Web research returned an empty response");
+    const reader = response.body.getReader();
+    const chunks = [];
+    let bytes = 0;
+    try {
+        while (true) {
+            const next = await reader.read();
+            if (next.done)
+                break;
+            bytes += next.value.byteLength;
+            if (bytes > maxResponseBytes) {
+                await reader.cancel();
+                throw new Error("Web research response exceeded the 1 MiB limit");
+            }
+            chunks.push(next.value);
+        }
+    }
+    finally {
+        reader.releaseLock();
+    }
+    return Buffer.concat(chunks.map((chunk) => Buffer.from(chunk))).toString("utf8");
+}
+async function readBoundedJson(response) {
+    const text = await readBoundedText(response);
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch {
+        throw new Error("Web research returned invalid JSON");
+    }
+    if (parsed === null || typeof parsed !== "object")
+        throw new Error("Web research returned an invalid payload");
+    return parsed;
+}
+function redactSecret(value, secret) {
+    return secret === "" ? value : value.split(secret).join("[REDACTED]");
+}
+function sanitizedCause(error, secret) {
+    const message = redactSecret(error instanceof Error ? error.message : String(error), secret);
+    if (!(error instanceof Error))
+        return new Error(message);
+    const sanitized = new Error(message);
+    sanitized.name = error.name;
+    if (error.stack !== undefined)
+        sanitized.stack = redactSecret(error.stack, secret);
+    return sanitized;
+}
+function searchError(message, cause) {
+    return new Error(message, { cause });
+}
+function validateApiKeyTransport(baseUrl, apiKey) {
+    if (apiKey === "")
+        return;
+    const url = new URL(baseUrl);
+    const loopback = url.hostname === "localhost" || url.hostname === "127.0.0.1" || url.hostname === "[::1]";
+    if (url.protocol !== "https:" && !loopback)
+        throw new Error("Web research requires HTTPS when an API key is configured");
+}
+export const Config = z.object({
+    baseUrl: z.string().default(defaultBaseUrl),
+    apiKey: z.string().default(""),
+    maxResults: z.number().default(8),
+    timeoutMs: z.number().default(20_000),
+});
+export default {
+    name: "pi-web-research",
+    inject: ["piPluginUi", "piTools"],
+    Config,
+    apply(context, config) {
+        const baseUrl = normalizeBaseUrl(config.baseUrl);
+        const apiKey = config.apiKey?.trim() || process.env.FIRECRAWL_API_KEY?.trim() || "";
+        validateApiKeyTransport(baseUrl, apiKey);
+        const maxResults = boundedInteger(config.maxResults, 8, 1, 20);
+        const timeoutMs = boundedInteger(config.timeoutMs, 20_000, 1_000, 120_000);
+        let latest;
+        const unregisterSearch = context.piTools.register(defineTool({
+            name: "web_search",
+            label: "Web search",
+            description: "Search the public web and return bounded, structured source evidence with direct URLs.",
+            promptSnippet: "search the public web for current source evidence",
+            parameters: Type.Object({ query: Type.String({ description: "Search query" }) }),
+            async execute(_toolCallId, params, signal) {
+                const query = params.query.trim();
+                if (query.length < 2 || query.length > maxQueryLength)
+                    throw new Error(`Web search query must contain 2-${maxQueryLength} characters`);
+                if (signal?.aborted === true)
+                    throw new Error("Web search was cancelled");
+                const controller = new AbortController();
+                let timedOut = false;
+                const abortFromCaller = () => controller.abort(signal?.reason);
+                signal?.addEventListener("abort", abortFromCaller, { once: true });
+                const timer = setTimeout(() => {
+                    timedOut = true;
+                    controller.abort();
+                }, timeoutMs);
+                timer.unref();
+                const startedAt = Date.now();
+                try {
+                    const response = await fetch(`${baseUrl}/v2/search`, {
+                        method: "POST",
+                        signal: controller.signal,
+                        headers: { "content-type": "application/json", ...(apiKey === "" ? {} : { authorization: `Bearer ${apiKey}` }) },
+                        body: JSON.stringify({ query, limit: maxResults, sources: ["web"], timeout: timeoutMs }),
+                    });
+                    if (!response.ok) {
+                        const detail = redactSecret((await readBoundedText(response)).trim().slice(0, 1_000), apiKey);
+                        throw new Error(`Web search returned HTTP ${response.status}${detail === "" ? "" : `: ${detail}`}`);
+                    }
+                    const payload = await readBoundedJson(response);
+                    const items = normalizeSearchItems(payload, maxResults);
+                    const status = payload.success === false || items.length === 0 ? "degraded" : "ok";
+                    latest = {
+                        query,
+                        source: "firecrawl",
+                        status,
+                        summary: items.length === 0
+                            ? `No web results found for ${query}.`
+                            : `Found ${items.length} ranked web result${items.length === 1 ? "" : "s"} for ${query}.`,
+                        items,
+                        uncertainty: items.length === 0 ? ["The provider returned no usable public HTTP or HTTPS results."] : [],
+                        durationMs: Date.now() - startedAt,
+                    };
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: items.length === 0
+                                    ? latest.summary
+                                    : items.map((item, index) => `[${index + 1}] ${item.title}\n${item.url}${item.snippet === "" ? "" : `\n${item.snippet}`}`).join("\n\n"),
+                            },
+                        ],
+                        details: latest,
+                    };
+                }
+                catch (error) {
+                    const cause = sanitizedCause(error, apiKey);
+                    if (timedOut)
+                        throw searchError(`Web search timed out after ${timeoutMs} ms`, cause);
+                    if (controller.signal.aborted)
+                        throw searchError("Web search was cancelled", cause);
+                    if (cause.message.startsWith("Web search returned") || cause.message.startsWith("Web research"))
+                        throw searchError(cause.message, cause);
+                    throw searchError(`Web search request failed: ${cause.message}`, cause);
+                }
+                finally {
+                    clearTimeout(timer);
+                    signal?.removeEventListener("abort", abortFromCaller);
+                }
+            },
+        }));
+        let unregisterRead;
+        let disposePanel;
+        try {
+            unregisterRead = context.piTools.register(defineTool({
+                name: "read_page",
+                label: "Read page",
+                description: "Read a public page with the existing bounded browser fetch tool, optionally recording a research focus.",
+                promptSnippet: "read one public source page for focused evidence",
+                parameters: Type.Object({
+                    url: Type.String({ description: "Public HTTP or HTTPS page URL" }),
+                    focus: Type.Optional(Type.String({ description: "Question or topic to focus on while reading" })),
+                }),
+                async execute(toolCallId, params, signal, onUpdate, toolContext) {
+                    const browserFetch = context.piTools.snapshot().customTools.find((tool) => tool.name === "browser_fetch");
+                    if (browserFetch === undefined)
+                        throw new Error("read_page requires the Browser Fetch plugin to be enabled");
+                    const result = await browserFetch.execute(toolCallId, { url: params.url }, signal, onUpdate, toolContext);
+                    return {
+                        ...result,
+                        details: {
+                            ...(result.details !== null && typeof result.details === "object" ? result.details : {}),
+                            focus: params.focus?.trim() || null,
+                        },
+                    };
+                },
+            }));
+            disposePanel = context.piPluginUi.register({
+                id: "web-research-panel",
+                pluginId: "@pi-harness/core/plugins/web-research",
+                title: "Web Research",
+                description: "搜索公开网页并返回带直达链接的结构化证据；单页读取复用 Browser Fetch。",
+                icon: "⌕",
+                read: () => ({
+                    source: "firecrawl",
+                    keyless: apiKey === "",
+                    maxResults,
+                    timeoutMs,
+                    readPageAvailable: context.piTools.snapshot().customTools.some((tool) => tool.name === "browser_fetch"),
+                    latest: latest ?? null,
+                }),
+            });
+        }
+        catch (error) {
+            disposePanel?.();
+            unregisterRead?.();
+            unregisterSearch();
+            throw error;
+        }
+        context.effect(() => () => {
+            unregisterSearch();
+            unregisterRead?.();
+            disposePanel?.();
+        });
+    },
+};
+//# sourceMappingURL=web-research.js.map

package/packages/core/dist/plugins/web-research.js.map

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

package/packages/core/dist/plugins/workspace-navigator.d.ts

@@ -0,0 +1,36 @@
+import type { Context } from "@deepseek-ai/cordis";
+export type WorkspaceNode = {
+    kind: "directory" | "file";
+    name: string;
+    path: string;
+    depth: number;
+};
+export type WorkspaceNodeOptions = {
+    maxDepth?: number;
+    maxNodes?: number;
+};
+export type WorkspaceNodeReport = {
+    nodes: WorkspaceNode[];
+    directoryCount: number;
+    fileCount: number;
+    truncated: boolean;
+};
+export type WorkspaceGitStatusEntry = {
+    path: string;
+    status: string;
+};
+export type WorkspaceGitStatus = {
+    available: boolean;
+    branch: string | null;
+    clean: boolean;
+    entries: WorkspaceGitStatusEntry[];
+};
+export declare function readWorkspaceGitStatus(root: string): Promise<WorkspaceGitStatus>;
+export declare function listWorkspaceNodes(root: string, options?: WorkspaceNodeOptions): Promise<WorkspaceNodeReport>;
+declare const _default: {
+    name: string;
+    inject: string[];
+    apply(context: Context): void;
+};
+export default _default;
+//# sourceMappingURL=workspace-navigator.d.ts.map

package/packages/core/dist/plugins/workspace-navigator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-navigator.d.ts","sourceRoot":"","sources":["../../src/plugins/workspace-navigator.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AASnD,MAAM,MAAM,aAAa,GAAG;IAAE,IAAI,EAAE,WAAW,GAAG,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AACtG,MAAM,MAAM,oBAAoB,GAAG;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAC5E,MAAM,MAAM,mBAAmB,GAAG;IAAE,KAAK,EAAE,aAAa,EAAE,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAAC;AAC5H,MAAM,MAAM,uBAAuB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AACvE,MAAM,MAAM,kBAAkB,GAAG;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,uBAAuB,EAAE,CAAA;CAAE,CAAC;AAInI,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CActF;AASD,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAqCvH;;;;mBAKgB,OAAO;;AAHxB,wBAgFE"}

package/packages/core/dist/plugins/workspace-navigator.js

@@ -0,0 +1,150 @@
+import { lstat, readdir } from "node:fs/promises";
+import { execFile } from "node:child_process";
+import { relative, resolve } from "node:path";
+import { promisify } from "node:util";
+import { Type } from "@earendil-works/pi-ai";
+import { defineTool } from "@earendil-works/pi-coding-agent";
+import { resolveExistingWorkspacePath } from "../workspace-path.js";
+const maxDepthLimit = 8;
+const maxNodesLimit = 500;
+const ignoredDirectories = new Set([".git", "node_modules", ".pi", "dist", "build"]);
+const execFileAsync = promisify(execFile);
+export async function readWorkspaceGitStatus(root) {
+    try {
+        const [branchResult, statusResult] = await Promise.all([
+            execFileAsync("git", ["-C", root, "branch", "--show-current"], { maxBuffer: 1024 * 1024 }),
+            execFileAsync("git", ["-C", root, "status", "--short", "--untracked-files=all"], { maxBuffer: 4 * 1024 * 1024 }),
+        ]);
+        const entries = statusResult.stdout
+            .split("\n")
+            .filter((line) => line.length >= 4)
+            .map((line) => ({ status: line.slice(0, 2), path: line.slice(3) }));
+        return { available: true, branch: branchResult.stdout.trim() || null, clean: entries.length === 0, entries };
+    }
+    catch {
+        return { available: false, branch: null, clean: false, entries: [] };
+    }
+}
+function normalizeOptions(options) {
+    return {
+        maxDepth: Math.max(1, Math.min(maxDepthLimit, Math.trunc(options.maxDepth ?? 4))),
+        maxNodes: Math.max(1, Math.min(maxNodesLimit, Math.trunc(options.maxNodes ?? 200))),
+    };
+}
+export async function listWorkspaceNodes(root, options = {}) {
+    const workspace = resolve(root);
+    const { maxDepth, maxNodes } = normalizeOptions(options);
+    const nodes = [];
+    let truncated = false;
+    const visit = async (directory, depth) => {
+        if (depth > maxDepth || nodes.length >= maxNodes) {
+            if (nodes.length >= maxNodes)
+                truncated = true;
+            return;
+        }
+        const entries = (await readdir(directory, { withFileTypes: true })).sort((left, right) => left.name.localeCompare(right.name));
+        for (const entry of entries) {
+            if (nodes.length >= maxNodes) {
+                truncated = true;
+                return;
+            }
+            if (entry.isDirectory() && ignoredDirectories.has(entry.name))
+                continue;
+            const target = resolve(directory, entry.name);
+            if (!relative(workspace, target) || relative(workspace, target).startsWith(`..${"/"}`))
+                continue;
+            const metadata = await lstat(target);
+            if (metadata.isSymbolicLink())
+                continue;
+            const path = relative(workspace, target);
+            if (metadata.isDirectory()) {
+                nodes.push({ kind: "directory", name: entry.name, path, depth });
+                await visit(target, depth + 1);
+            }
+            else if (metadata.isFile()) {
+                nodes.push({ kind: "file", name: entry.name, path, depth });
+            }
+        }
+    };
+    await visit(workspace, 1);
+    return {
+        nodes,
+        directoryCount: nodes.filter((node) => node.kind === "directory").length,
+        fileCount: nodes.filter((node) => node.kind === "file").length,
+        truncated,
+    };
+}
+export default {
+    name: "pi-workspace-navigator",
+    inject: ["piHarnessLaunch", "piPluginUi", "piTools"],
+    apply(context) {
+        let latest;
+        let latestGit;
+        const inspect = async (requestedPath, requestedDepth, requestedNodes) => {
+            const requested = requestedPath?.trim() ?? ".";
+            if (requested.length > 512 || requested.includes("\\"))
+                throw new Error("Workspace navigator path must be a relative POSIX path of at most 512 characters");
+            const resolved = await resolveExistingWorkspacePath(context.piHarnessLaunch.cwd, requested, "Workspace navigator path must stay inside the current workspace");
+            const root = resolved.root;
+            const target = resolved.target;
+            const options = normalizeOptions({
+                ...(requestedDepth === undefined ? {} : { maxDepth: requestedDepth }),
+                ...(requestedNodes === undefined ? {} : { maxNodes: requestedNodes }),
+            });
+            const report = await listWorkspaceNodes(target, options);
+            latest = { ...report, path: relative(root, target) || ".", ...options };
+            return latest;
+        };
+        const unregister = context.piTools.register(defineTool({
+            name: "workspace_tree",
+            label: "Workspace tree",
+            description: "Show a bounded, read-only workspace tree while skipping dependency and build directories.",
+            promptSnippet: "inspect the workspace directory tree",
+            parameters: Type.Object({
+                path: Type.Optional(Type.String({ description: "Relative directory path" })),
+                maxDepth: Type.Optional(Type.Number({ description: "Tree depth, 1-8" })),
+                maxNodes: Type.Optional(Type.Number({ description: "Maximum nodes, 1-500" })),
+            }),
+            async execute(_toolCallId, params) {
+                const report = await inspect(params.path, params.maxDepth, params.maxNodes);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: report.nodes.map((node) => `${node.kind === "directory" ? "[dir]" : "[file]"} ${node.path}`).join("\n") || "Workspace is empty.",
+                        },
+                    ],
+                    details: report,
+                };
+            },
+        }));
+        const unregisterGit = context.piTools.register(defineTool({
+            name: "workspace_status",
+            label: "Workspace status",
+            description: "Show the current workspace Git branch and changed files without modifying the repository.",
+            promptSnippet: "inspect the workspace Git status",
+            parameters: Type.Object({}),
+            async execute() {
+                latestGit = await readWorkspaceGitStatus(context.piHarnessLaunch.cwd);
+                const summary = latestGit.available
+                    ? `${latestGit.branch ?? "detached HEAD"}: ${latestGit.clean ? "clean" : `${latestGit.entries.length} changed file(s)`}`
+                    : "Not a Git workspace.";
+                return { content: [{ type: "text", text: summary }], details: latestGit };
+            },
+        }));
+        const disposePanel = context.piPluginUi.register({
+            id: "workspace-navigator-panel",
+            pluginId: "@pi-harness/core/plugins/workspace-navigator",
+            title: "Workspace Navigator",
+            description: "以受限目录树快速浏览当前工作区，不执行写操作。",
+            icon: "⌘",
+            read: () => ({ latest: latest ?? null, git: latestGit ?? null, nodeCount: latest?.nodes.length ?? 0 }),
+        });
+        context.effect(() => () => {
+            unregister();
+            unregisterGit();
+            disposePanel();
+        });
+    },
+};
+//# sourceMappingURL=workspace-navigator.js.map

package/packages/core/dist/plugins/workspace-navigator.js.map

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

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

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

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

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

@@ -0,0 +1,134 @@
+import { lstat, readdir, readFile, realpath, 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 maxQueryLength = 256;
+const maxPathLength = 512;
+const maxFileBytes = 2 * 1024 * 1024;
+const maxFiles = 2_000;
+const maxResults = 100;
+const ignoredDirectories = new Set([".git", "node_modules", ".pi", "dist", "build"]);
+function inside(root, target) {
+    const remainder = relative(root, target);
+    return remainder === "" || (remainder !== ".." && !remainder.startsWith(`..${"/"}`) && !remainder.startsWith("/"));
+}
+function workspacePath(root, requested) {
+    if (requested.length > maxPathLength || requested.includes("\\"))
+        throw new Error("Workspace search path must be a relative POSIX path of at most 512 characters");
+    const target = resolve(root, requested || ".");
+    if (!inside(root, target))
+        throw new Error("Workspace search path must stay inside the current workspace");
+    return target;
+}
+async function filesUnder(target, root, files) {
+    if (files.length >= maxFiles)
+        return;
+    const metadata = await lstat(target);
+    if (metadata.isSymbolicLink())
+        return;
+    if (metadata.isFile()) {
+        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);
+        if (!inside(root, child))
+            continue;
+        await filesUnder(child, root, files);
+    }
+}
+export default {
+    name: "pi-workspace-search",
+    inject: ["piHarnessLaunch", "piPluginUi", "piTools"],
+    apply(context) {
+        let latest;
+        const search = async (query, requestedPath, caseSensitive, requestedLimit) => {
+            const normalizedQuery = query.trim();
+            if (normalizedQuery.length === 0 || normalizedQuery.length > maxQueryLength)
+                throw new Error(`Workspace search query must contain 1-${maxQueryLength} characters`);
+            const root = await realpath(context.piHarnessLaunch.cwd);
+            const target = workspacePath(root, requestedPath?.trim() ?? ".");
+            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 needle = caseSensitive ? normalizedQuery : normalizedQuery.toLocaleLowerCase();
+            const matches = [];
+            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);
+                if (source.includes(0)) {
+                    skippedFiles += 1;
+                    continue;
+                }
+                scannedFiles += 1;
+                const lines = source.toString("utf8").split(/\r?\n/u);
+                for (const [index, line] of lines.entries()) {
+                    if ((caseSensitive ? line : line.toLocaleLowerCase()).includes(needle)) {
+                        matches.push({ path: relative(root, file), line: index + 1, text: line });
+                        if (matches.length >= limit)
+                            break;
+                    }
+                }
+            }
+            const report = {
+                query: normalizedQuery,
+                path: relative(root, target) || ".",
+                matches,
+                matchCount: matches.length,
+                scannedFiles,
+                skippedFiles,
+                truncated: matches.length >= limit && files.length > scannedFiles,
+            };
+            latest = report;
+            return report;
+        };
+        const unregisterTool = context.piTools.register(defineTool({
+            name: "workspace_search",
+            label: "Search workspace",
+            description: "Search bounded UTF-8 text files in the current workspace without modifying files or invoking a shell.",
+            promptSnippet: "search the workspace for a text pattern",
+            parameters: Type.Object({
+                query: Type.String(),
+                path: Type.Optional(Type.String()),
+                caseSensitive: Type.Optional(Type.Boolean()),
+                maxResults: Type.Optional(Type.Number()),
+            }),
+            async execute(_toolCallId, params) {
+                const report = await search(params.query, params.path, params.caseSensitive === true, params.maxResults);
+                return {
+                    content: [{ type: "text", text: report.matches.map((match) => `${match.path}:${match.line}: ${match.text}`).join("\n") || "No matches found." }],
+                    details: report,
+                };
+            },
+        }));
+        const disposePanel = context.piPluginUi.register({
+            id: "workspace-search-panel",
+            pluginId: "@pi-harness/core/plugins/workspace-search",
+            title: "Workspace Search",
+            description: "在工作区内安全检索文本，跳过依赖、构建产物和版本库目录。",
+            icon: "⌕",
+            read: () => ({ latest: latest ?? null, query: latest?.query ?? null, matchCount: latest?.matchCount ?? 0, scannedFiles: latest?.scannedFiles ?? 0 }),
+        });
+        context.effect(() => () => {
+            unregisterTool();
+            disposePanel();
+        });
+    },
+};
+//# sourceMappingURL=workspace-search.js.map