@pi-harness/pi-harness 0.1.2 → 0.1.3

package/packages/core/dist/plugins/mcp-panel.js

@@ -0,0 +1,180 @@
+import { randomUUID } from "node:crypto";
+import { lstat, mkdir, readFile, rename, unlink, writeFile } from "node:fs/promises";
+import { basename, dirname, isAbsolute, resolve } from "node:path";
+import z from "@deepseek-ai/schemastery";
+import { Type } from "@earendil-works/pi-ai";
+import { defineTool } from "@earendil-works/pi-coding-agent";
+export const Config = z.object({ patchPath: z.string().default("") });
+function mcpToolPrefix(serverId) {
+    return `mcp__${serverId}__`;
+}
+function serverTools(serverId, tools) {
+    const prefix = mcpToolPrefix(serverId);
+    return tools.filter((tool) => tool.name.startsWith(prefix));
+}
+function healthFor(server) {
+    if (server === undefined)
+        throw new Error("MCP server was not found");
+    if (server.status === "running")
+        return { serverId: server.id, status: server.status, severity: "ok", suggestions: [] };
+    return { serverId: server.id, status: server.status, severity: "warning", suggestions: ["使用 mcp_server_start 启动该服务器，再重新检查健康状态。"] };
+}
+function validateServerId(serverId) {
+    const normalized = serverId.trim();
+    if (!/^[a-z0-9][a-z0-9_-]{0,63}$/iu.test(normalized))
+        throw new Error("MCP server id must use letters, numbers, _ or -");
+    return normalized;
+}
+function validateCommand(command) {
+    if (command.length === 0 || command.length > 32 || command.some((part) => part.trim() === "" || part.length > 4096))
+        throw new Error("MCP command must contain 1-32 non-empty arguments");
+    return [...command];
+}
+function patchFragment(serverId, command, autoStart) {
+    const rowId = `mcp-${serverId}`;
+    const commandRows = command.map((part) => `          - ${JSON.stringify(part)}`).join("\n");
+    return [
+        `- id: ${rowId}`,
+        `  name: "@pi-harness/core/plugins/mcp-client"`,
+        "  config:",
+        "    servers:",
+        `      - id: ${JSON.stringify(serverId)}`,
+        "        command:",
+        commandRows,
+        `        autoStart: ${autoStart ? "true" : "false"}`,
+        "",
+    ].join("\n");
+}
+export default {
+    name: "pi-mcp-panel",
+    inject: ["piHarnessLaunch", "piMcp", "piPluginUi", "piTools"],
+    Config,
+    apply(context, config) {
+        const configuredPatchPath = config.patchPath?.trim() ?? "";
+        const patchTarget = configuredPatchPath === ""
+            ? undefined
+            : isAbsolute(configuredPatchPath)
+                ? resolve(configuredPatchPath)
+                : resolve(context.piHarnessLaunch.agentDir, configuredPatchPath);
+        const snapshot = () => {
+            const customTools = context.piTools.snapshot().customTools;
+            return context.piMcp.snapshot().servers.map((server) => ({
+                id: server.id,
+                status: server.status,
+                startedAt: server.startedAt,
+                executable: basename(server.command[0] ?? ""),
+                toolCount: serverTools(server.id, customTools).length,
+                statusSource: "runtime",
+            }));
+        };
+        const buildPatch = (serverId, command, autoStart) => patchFragment(validateServerId(serverId), validateCommand(command), autoStart);
+        let patchWriteQueue = Promise.resolve();
+        const applyPatch = async (fragment, serverId) => {
+            const write = patchWriteQueue.then(async () => {
+                if (patchTarget === undefined)
+                    throw new Error("MCP profile writes are disabled; configure patchPath first");
+                await mkdir(dirname(patchTarget), { recursive: true });
+                const metadata = await lstat(patchTarget).catch((error) => {
+                    if (error instanceof Error && "code" in error && error.code === "ENOENT")
+                        return undefined;
+                    throw error;
+                });
+                if (metadata?.isSymbolicLink() || (metadata !== undefined && !metadata.isFile()))
+                    throw new Error("MCP profile patch target must be a regular file and cannot be a symbolic link");
+                const existing = metadata === undefined ? "" : await readFile(patchTarget, "utf8");
+                const rowPattern = new RegExp(`^- id: mcp-${serverId}\\s*$`, "mu");
+                if (rowPattern.test(existing))
+                    throw new Error(`MCP server patch already exists: ${serverId}`);
+                const backup = `${patchTarget}.bak`;
+                await writeFile(backup, existing, { encoding: "utf8", mode: 0o600, flag: "wx" }).catch((error) => {
+                    if (!(error instanceof Error && "code" in error && error.code === "EEXIST"))
+                        throw error;
+                });
+                const temporary = `${patchTarget}.${randomUUID()}.tmp`;
+                let renamed = false;
+                try {
+                    await writeFile(temporary, `${existing.trimEnd()}${existing.trimEnd() === "" ? "" : "\n"}${fragment}`, { encoding: "utf8", mode: 0o600, flag: "wx" });
+                    await rename(temporary, patchTarget);
+                    renamed = true;
+                }
+                finally {
+                    if (!renamed)
+                        await unlink(temporary).catch(() => { });
+                }
+                return patchTarget;
+            });
+            patchWriteQueue = write.then(() => undefined, () => undefined);
+            return write;
+        };
+        const unregister = context.piTools.register(defineTool({
+            name: "mcp_panel",
+            label: "MCP panel",
+            description: "Inspect MCP status and tools, derive health suggestions, and preview or explicitly apply a backed-up profile patch.",
+            promptSnippet: "inspect MCP status or preview a server profile patch",
+            parameters: Type.Object({
+                action: Type.Union([Type.Literal("status"), Type.Literal("tools"), Type.Literal("health"), Type.Literal("preview"), Type.Literal("apply")]),
+                serverId: Type.Optional(Type.String({ description: "Configured or running MCP server id" })),
+                command: Type.Optional(Type.Array(Type.String(), { description: "MCP server executable and arguments" })),
+                autoStart: Type.Optional(Type.Boolean({ description: "Start the configured server with the runtime" })),
+                confirm: Type.Optional(Type.Boolean({ description: "Must be true before applying a patch" })),
+            }),
+            async execute(_toolCallId, params) {
+                await Promise.resolve();
+                const servers = snapshot();
+                if (params.action === "status") {
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: servers.map((server) => `${server.id}: ${server.status} · ${server.toolCount} tools`).join("\n") || "No MCP servers configured.",
+                            },
+                        ],
+                        details: { action: "status", servers },
+                    };
+                }
+                if (params.serverId === undefined || params.serverId.trim() === "")
+                    throw new Error(`action ${params.action} requires serverId`);
+                if (params.action === "preview" || params.action === "apply") {
+                    if (params.command === undefined)
+                        throw new Error(`action ${params.action} requires command`);
+                    const serverId = validateServerId(params.serverId);
+                    const fragment = buildPatch(serverId, params.command, params.autoStart === true);
+                    if (params.action === "preview")
+                        return { content: [{ type: "text", text: fragment }], details: { action: "preview", serverId, path: patchTarget ?? null, fragment } };
+                    if (params.confirm !== true)
+                        throw new Error("Applying an MCP profile patch requires confirm=true");
+                    const path = await applyPatch(fragment, serverId);
+                    return {
+                        content: [{ type: "text", text: `MCP server patch appended to ${path}.` }],
+                        details: { action: "apply", serverId, path, backup: `${path}.bak` },
+                    };
+                }
+                const server = servers.find((item) => item.id === params.serverId);
+                if (params.action === "health") {
+                    const health = healthFor(server);
+                    return { content: [{ type: "text", text: `${health.serverId}: ${health.status} (${health.severity})` }], details: { action: "health", ...health } };
+                }
+                if (server === undefined)
+                    throw new Error(`MCP server was not found: ${params.serverId}`);
+                const tools = serverTools(server.id, context.piTools.snapshot().customTools).map((tool) => ({ name: tool.name, description: tool.description }));
+                return {
+                    content: [{ type: "text", text: tools.map((tool) => `${tool.name}: ${tool.description ?? ""}`).join("\n") || "No bridged tools." }],
+                    details: { action: "tools", serverId: server.id, tools },
+                };
+            },
+        }));
+        const disposePanel = context.piPluginUi.register({
+            id: "mcp-panel",
+            pluginId: "@pi-harness/core/plugins/mcp-panel",
+            title: "MCP Console",
+            description: "查看 MCP 服务器状态、桥接工具和健康建议。",
+            icon: "⌘",
+            read: () => ({ servers: snapshot(), statusSource: "runtime", writesEnabled: patchTarget !== undefined, patchPath: patchTarget ?? null }),
+        });
+        context.effect(() => () => {
+            unregister();
+            disposePanel();
+        });
+    },
+};
+//# sourceMappingURL=mcp-panel.js.map

package/packages/core/dist/plugins/mcp-panel.js.map

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

package/packages/core/dist/plugins/memory.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/plugins/memory.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,CAAC,MAAM,0BAA0B,CAAC;AAezC,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,MAAM,EAAE,CAAC,CAAC,kBAAkB,CAA2G,CAAC;;;;;mBA+BpI,OAAO,UAAU,kBAAkB;;AAJpD,wBA4HE"}

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

@@ -0,0 +1,161 @@
+import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
+import { randomUUID } from "node:crypto";
+import { basename, dirname, join, resolve } from "node:path";
+import z from "@deepseek-ai/schemastery";
+import { Type } from "@earendil-works/pi-ai";
+import { defineTool } from "@earendil-works/pi-coding-agent";
+const defaultFileName = "memory.json";
+const maxKeyLength = 128;
+const maxValueBytes = 64 * 1024;
+const maxTagLength = 64;
+const maxTags = 16;
+const maxEntries = 500;
+export const Config = z.object({ fileName: z.string().default(defaultFileName), maxEntries: z.number().default(maxEntries) });
+function normalizeFilePath(agentDir, fileName) {
+    const name = (fileName ?? defaultFileName).trim();
+    if (name === "" || basename(name) !== name || !name.toLowerCase().endsWith(".json"))
+        throw new Error("Memory fileName must be a single .json filename");
+    return resolve(agentDir, name);
+}
+function normalizeKey(key) {
+    const value = key.trim();
+    if (value.length === 0 || value.length > maxKeyLength)
+        throw new Error(`Memory key must contain 1-${maxKeyLength} characters`);
+    return value;
+}
+function normalizeValue(value) {
+    if (value.trim() === "" || Buffer.byteLength(value, "utf8") > maxValueBytes)
+        throw new Error(`Memory value must be non-empty and at most ${maxValueBytes} bytes`);
+    return value;
+}
+function normalizeTags(tags) {
+    const values = [...new Set((tags ?? []).map((tag) => tag.trim()).filter(Boolean))];
+    if (values.length > maxTags || values.some((tag) => tag.length > maxTagLength))
+        throw new Error(`Memory tags must contain at most ${maxTags} entries of ${maxTagLength} characters`);
+    return values;
+}
+export default {
+    name: "pi-memory",
+    inject: ["piHarnessLaunch", "piPluginUi", "piTools"],
+    Config,
+    apply(context, config) {
+        const filePath = normalizeFilePath(context.piHarnessLaunch.agentDir, config.fileName);
+        const entryLimit = Math.max(1, Math.min(maxEntries, Math.trunc(config.maxEntries ?? maxEntries)));
+        let memories = [];
+        let loaded = false;
+        let loading;
+        let writeQueue = Promise.resolve();
+        let last;
+        const load = async () => {
+            if (loaded)
+                return;
+            if (loading !== undefined)
+                return loading;
+            loading = (async () => {
+                try {
+                    const parsed = JSON.parse(await readFile(filePath, "utf8"));
+                    if (parsed.version !== 1 || !Array.isArray(parsed.memories))
+                        throw new Error("Memory file has an unsupported format");
+                    memories = parsed.memories.filter((item) => typeof item === "object" && item !== null && typeof item.key === "string" && typeof item.value === "string");
+                }
+                catch (error) {
+                    if (error.code !== "ENOENT")
+                        throw error;
+                    memories = [];
+                }
+                loaded = true;
+            })();
+            return loading;
+        };
+        const persist = async () => {
+            const payload = JSON.stringify({ version: 1, memories }, null, 2);
+            writeQueue = writeQueue.then(async () => {
+                await mkdir(dirname(filePath), { recursive: true });
+                const temporary = join(dirname(filePath), `.${basename(filePath)}.${randomUUID()}.tmp`);
+                await writeFile(temporary, payload, { encoding: "utf8", mode: 0o600 });
+                await rename(temporary, filePath);
+            });
+            await writeQueue;
+        };
+        const unregisterSet = context.piTools.register(defineTool({
+            name: "memory_set",
+            label: "Remember fact",
+            description: "Persist one explicit fact in the Pi Harness memory store, replacing an existing value with the same key.",
+            promptSnippet: "save an explicit fact for future sessions",
+            parameters: Type.Object({ key: Type.String(), value: Type.String(), tags: Type.Optional(Type.Array(Type.String())) }),
+            async execute(_toolCallId, params) {
+                await load();
+                const key = normalizeKey(params.key);
+                const value = normalizeValue(params.value);
+                const tags = normalizeTags(params.tags);
+                const now = new Date().toISOString();
+                const existing = memories.find((item) => item.key === key);
+                const memory = existing === undefined ? { id: randomUUID(), key, value, tags, createdAt: now, updatedAt: now } : { ...existing, value, tags, updatedAt: now };
+                memories = [memory, ...memories.filter((item) => item.key !== key)].slice(0, entryLimit);
+                await persist();
+                return { content: [{ type: "text", text: `Memory saved: ${key}` }], details: memory };
+            },
+        }));
+        const unregisterSearch = context.piTools.register(defineTool({
+            name: "memory_search",
+            label: "Search memories",
+            description: "Search explicit cross-session memories by key, value, or tag.",
+            promptSnippet: "search remembered facts from earlier sessions",
+            parameters: Type.Object({ query: Type.String() }),
+            async execute(_toolCallId, params) {
+                await load();
+                const query = params.query.trim().toLocaleLowerCase();
+                if (query.length < 2 || query.length > maxKeyLength)
+                    throw new Error(`Memory search query must contain 2-${maxKeyLength} characters`);
+                const results = memories.filter((item) => [item.key, item.value, ...item.tags].some((field) => field.toLocaleLowerCase().includes(query)));
+                last = { query: params.query.trim(), total: results.length, memories: results };
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: results.length === 0 ? `No memories found for ${params.query.trim()}.` : results.map((item) => `${item.key}: ${item.value}`).join("\n"),
+                        },
+                    ],
+                    details: last,
+                };
+            },
+        }));
+        const unregisterDelete = context.piTools.register(defineTool({
+            name: "memory_delete",
+            label: "Forget memory",
+            description: "Delete one explicit memory by key. Confirmation is required.",
+            promptSnippet: "forget a stored memory after confirmation",
+            parameters: Type.Object({ key: Type.String(), confirm: Type.Boolean() }),
+            async execute(_toolCallId, params) {
+                await load();
+                const key = normalizeKey(params.key);
+                if (params.confirm !== true)
+                    throw new Error("Deleting a memory requires confirm=true");
+                const before = memories.length;
+                memories = memories.filter((item) => item.key !== key);
+                const removed = memories.length !== before;
+                if (removed)
+                    await persist();
+                return { content: [{ type: "text", text: removed ? `Memory deleted: ${key}` : `Memory not found: ${key}` }], details: { key, removed } };
+            },
+        }));
+        const disposePanel = context.piPluginUi.register({
+            id: "memory-panel",
+            pluginId: "@pi-harness/core/plugins/memory",
+            title: "Memory",
+            description: "只保存 Agent 明确写入的事实，跨会话持久化并支持检索与删除。",
+            icon: "▣",
+            read: async () => {
+                await load();
+                return { filePath, count: memories.length, last: last ?? null, memories: memories.slice(0, 8) };
+            },
+        });
+        context.effect(() => () => {
+            unregisterSet();
+            unregisterSearch();
+            unregisterDelete();
+            disposePanel();
+        });
+    },
+};
+//# sourceMappingURL=memory.js.map

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

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

package/packages/core/dist/plugins/mirage-bridge.d.ts

@@ -0,0 +1,23 @@
+import type { Context } from "@deepseek-ai/cordis";
+import z from "@deepseek-ai/schemastery";
+export interface MirageBridgeConfig {
+    executable?: string;
+    workspaceId?: string;
+    timeoutMs?: number;
+}
+export type MirageRun = {
+    workspaceId: string;
+    command: string;
+    exitCode: number | null;
+    durationMs: number;
+    output: string;
+};
+export declare const Config: z<MirageBridgeConfig>;
+declare const _default: {
+    name: string;
+    inject: string[];
+    Config: z<MirageBridgeConfig>;
+    apply(context: Context, config: MirageBridgeConfig): void;
+};
+export default _default;
+//# sourceMappingURL=mirage-bridge.d.ts.map

package/packages/core/dist/plugins/mirage-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mirage-bridge.d.ts","sourceRoot":"","sources":["../../src/plugins/mirage-bridge.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,CAAC,MAAM,0BAA0B,CAAC;AAUzC,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,SAAS,GAAG;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAWF,eAAO,MAAM,MAAM,EAAE,CAAC,CAAC,kBAAkB,CAIvC,CAAC;;;;;mBA+Bc,OAAO,UAAU,kBAAkB;;AAJpD,wBA+GE"}

package/packages/core/dist/plugins/mirage-bridge.js

@@ -0,0 +1,149 @@
+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 defaultExecutable = "mirage";
+const defaultTimeoutMs = 60_000;
+const maxCommandLength = 4_000;
+const maxOutputBytes = 128 * 1024;
+export const Config = z.object({
+    executable: z.string().default(defaultExecutable),
+    workspaceId: z.string().default(""),
+    timeoutMs: z.number().default(defaultTimeoutMs),
+});
+function normalizeExecutable(input) {
+    const executable = (input ?? defaultExecutable).trim();
+    if (executable.length < 1 || executable.length > 512 || executable.includes("\0"))
+        throw new Error("Mirage executable must contain 1-512 characters");
+    return executable;
+}
+function normalizeWorkspaceId(input) {
+    const workspaceId = input?.trim() ?? "";
+    if (workspaceId === "")
+        return null;
+    if (!/^[a-z0-9][a-z0-9._-]{0,127}$/iu.test(workspaceId))
+        throw new Error("Mirage workspaceId must contain 1-128 letters, numbers, dots, underscores, or hyphens");
+    return workspaceId;
+}
+function normalizeCommand(input) {
+    const command = input.trim();
+    if (command.length < 1 || command.length > maxCommandLength)
+        throw new Error(`Mirage command must contain 1-${maxCommandLength} characters`);
+    return command;
+}
+function errorMessage(error) {
+    if (error instanceof Error)
+        return error.message;
+    return String(error);
+}
+export default {
+    name: "pi-mirage-bridge",
+    inject: ["piHarnessLaunch", "piPluginUi", "piTools"],
+    Config,
+    apply(context, config) {
+        const executable = normalizeExecutable(config.executable);
+        const workspaceId = normalizeWorkspaceId(config.workspaceId);
+        const timeoutMs = Math.max(1_000, Math.min(120_000, Math.trunc(config.timeoutMs ?? defaultTimeoutMs)));
+        let state = { executable, workspaceId, available: null, version: null, lastError: null, lastRun: null };
+        const doctor = async () => {
+            try {
+                const result = await execFileAsync(executable, ["--version"], {
+                    cwd: context.piHarnessLaunch.cwd,
+                    timeout: Math.min(timeoutMs, 10_000),
+                    maxBuffer: maxOutputBytes,
+                });
+                const version = `${result.stdout}${result.stderr}`.trim().split(/\r?\n/u)[0]?.slice(0, 256) || "Mirage CLI detected";
+                state = { ...state, available: true, version, lastError: null };
+            }
+            catch (error) {
+                state = { ...state, available: false, version: null, lastError: errorMessage(error).slice(0, 1_000) };
+            }
+            return state;
+        };
+        const run = async (commandInput) => {
+            if (workspaceId === null)
+                throw new Error("Mirage workspaceId is not configured");
+            const command = normalizeCommand(commandInput);
+            const startedAt = Date.now();
+            try {
+                const result = await execFileAsync(executable, ["execute", "--workspace_id", workspaceId, "--command", command], {
+                    cwd: context.piHarnessLaunch.cwd,
+                    timeout: timeoutMs,
+                    maxBuffer: maxOutputBytes,
+                });
+                state = {
+                    ...state,
+                    available: true,
+                    lastError: null,
+                    lastRun: { workspaceId, command, exitCode: 0, durationMs: Date.now() - startedAt, output: `${result.stdout}${result.stderr}`.slice(-maxOutputBytes) },
+                };
+            }
+            catch (error) {
+                const failure = error;
+                const unavailable = failure.code === "ENOENT";
+                const output = `${failure.stdout ?? ""}${failure.stderr ?? failure.message ?? ""}`.slice(-maxOutputBytes);
+                state = {
+                    ...state,
+                    available: unavailable ? false : state.available,
+                    lastError: unavailable ? output : null,
+                    lastRun: {
+                        workspaceId,
+                        command,
+                        exitCode: typeof failure.code === "number" ? failure.code : null,
+                        durationMs: Date.now() - startedAt,
+                        output,
+                    },
+                };
+            }
+            return state.lastRun;
+        };
+        const unregisterDoctor = context.piTools.register(defineTool({
+            name: "mirage_doctor",
+            label: "Check Mirage CLI",
+            description: "Check whether the official Mirage virtual-terminal CLI is available and report its configured workspace.",
+            promptSnippet: "check the official Mirage virtual terminal integration",
+            parameters: Type.Object({}),
+            async execute() {
+                const details = await doctor();
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: details.available
+                                ? `${details.version}; workspace ${details.workspaceId ?? "not configured"}`
+                                : `Mirage unavailable: ${details.lastError}`,
+                        },
+                    ],
+                    details,
+                };
+            },
+        }));
+        const unregisterExecute = context.piTools.register(defineTool({
+            name: "mirage_execute",
+            label: "Execute in Mirage",
+            description: "Pass one command to the official Mirage virtual terminal in the configured virtual workspace.",
+            promptSnippet: "run a command inside the configured Mirage virtual workspace",
+            parameters: Type.Object({ command: Type.String({ description: "Command interpreted by Mirage, not the host shell" }) }),
+            async execute(_toolCallId, params) {
+                const details = await run(params.command);
+                return { content: [{ type: "text", text: `Mirage exited with ${details.exitCode ?? "unknown"}.\n${details.output}` }], details };
+            },
+        }));
+        const disposePanel = context.piPluginUi.register({
+            id: "mirage-bridge-panel",
+            pluginId: "@pi-harness/core/plugins/mirage-bridge",
+            title: "Mirage Bridge",
+            description: "连接官方 Mirage 虚拟终端，在配置的虚拟工作区中执行命令。",
+            icon: "◇",
+            read: () => ({ ...state, timeoutMs }),
+        });
+        context.effect(() => () => {
+            unregisterDoctor();
+            unregisterExecute();
+            disposePanel();
+        });
+    },
+};
+//# sourceMappingURL=mirage-bridge.js.map

package/packages/core/dist/plugins/mirage-bridge.js.map

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

package/packages/core/dist/plugins/mock-server.d.ts

@@ -0,0 +1,22 @@
+import type { Context } from "@deepseek-ai/cordis";
+import z from "@deepseek-ai/schemastery";
+type MockRoute = {
+    path: string;
+    method?: string;
+    status?: number;
+    headers?: Record<string, string>;
+    body?: string;
+};
+export interface MockServerPluginConfig {
+    port?: number;
+    routes?: MockRoute[];
+}
+export declare const Config: z<MockServerPluginConfig>;
+declare const _default: {
+    name: string;
+    inject: string[];
+    Config: z<MockServerPluginConfig>;
+    apply(context: Context, config: MockServerPluginConfig): void;
+};
+export default _default;
+//# sourceMappingURL=mock-server.d.ts.map

package/packages/core/dist/plugins/mock-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-server.d.ts","sourceRoot":"","sources":["../../src/plugins/mock-server.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,CAAC,MAAM,0BAA0B,CAAC;AAIzC,KAAK,SAAS,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAOrH,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;CACtB;AAUD,eAAO,MAAM,MAAM,EAAE,CAAC,CAAC,sBAAsB,CAAuF,CAAC;;;;;mBA0BpH,OAAO,UAAU,sBAAsB;;AAJxD,wBA6GE"}