@pi-harness/pi-harness 0.1.2 → 0.1.3

package/packages/core/dist/plugins/undo-savepoint.js

@@ -0,0 +1,247 @@
+import { createHash, randomUUID } from "node:crypto";
+import { lstat, mkdir, readFile, readdir, rename, writeFile } from "node:fs/promises";
+import { basename, extname, join, relative, resolve, sep } from "node:path";
+import z from "@deepseek-ai/schemastery";
+import { Type } from "@earendil-works/pi-ai";
+import { defineTool } from "@earendil-works/pi-coding-agent";
+import { isPathInside, prepareWorkspaceFile, resolveExistingWorkspacePath } from "../workspace-path.js";
+const defaultStoreName = "undo-savepoints";
+const defaultTrackedPaths = ["."];
+const maxSnapshotBytes = 2 * 1024 * 1024;
+const sensitiveNames = new Set([".env", ".env.local", ".env.production", ".credentials", ".credentials.yaml", ".credentials.json"]);
+const ignoredDirectories = new Set([".git", "node_modules", "dist", "build", ".next", ".turbo"]);
+export const Config = z.object({
+    storeName: z.string().default(defaultStoreName),
+    trackedPaths: z.array(z.string()).default(defaultTrackedPaths),
+    maxFiles: z.number().default(400),
+    maxFileBytes: z.number().default(256 * 1024),
+});
+function safeStoreName(value) {
+    const name = (value ?? defaultStoreName).trim();
+    if (name === "" || basename(name) !== name || name.includes(sep) || name === "." || name === "..")
+        throw new Error("storeName must be a single directory name");
+    return name;
+}
+function withinRoot(root, candidate) {
+    return isPathInside(root, candidate);
+}
+async function normalizedTrackedPaths(cwd, paths) {
+    const values = paths.length === 0 ? defaultTrackedPaths : paths;
+    const resolved = await Promise.all(values.map((item) => resolveExistingWorkspacePath(cwd, item, "Tracked paths must stay inside the current workspace")));
+    return [...new Set(resolved.map((item) => item.target))];
+}
+function relativePath(cwd, path) {
+    return relative(cwd, path).split(sep).join("/");
+}
+function isSensitivePath(path) {
+    const name = basename(path).toLowerCase();
+    return sensitiveNames.has(name) || name.endsWith(".pem") || name.endsWith(".key") || name.endsWith(".p12");
+}
+function isIgnoredPath(path) {
+    return path.split(sep).some((part) => ignoredDirectories.has(part));
+}
+function hash(content) {
+    return createHash("sha256").update(content).digest("hex");
+}
+async function collectFiles(root, trackedPaths, maxFiles, maxFileBytes) {
+    const files = [];
+    const seen = new Set();
+    const visit = async (path) => {
+        if (files.length >= maxFiles || isIgnoredPath(path) || isSensitivePath(path))
+            return;
+        const info = await lstat(path).catch(() => undefined);
+        if (info === undefined)
+            return;
+        if (info.isSymbolicLink())
+            return;
+        if (info.isDirectory()) {
+            for (const entry of await readdir(path, { withFileTypes: true })) {
+                if (entry.isSymbolicLink())
+                    continue;
+                await visit(join(path, entry.name));
+                if (files.length >= maxFiles)
+                    return;
+            }
+            return;
+        }
+        if (!info.isFile() || info.size > maxFileBytes)
+            return;
+        const content = await readFile(path);
+        if (content.includes(0))
+            return;
+        const relativeName = relativePath(root, path);
+        if (relativeName === "" || seen.has(relativeName))
+            return;
+        seen.add(relativeName);
+        files.push({ path: relativeName, bytes: content.byteLength, sha256: hash(content), content: content.toString("base64") });
+    };
+    for (const path of trackedPaths) {
+        await visit(path);
+        if (files.length >= maxFiles)
+            break;
+    }
+    return files.sort((left, right) => left.path.localeCompare(right.path));
+}
+async function readManifest(path) {
+    const parsed = JSON.parse(await readFile(path, "utf8"));
+    if (parsed.version !== 1 || typeof parsed.id !== "string" || !Array.isArray(parsed.files))
+        throw new Error(`Invalid savepoint: ${basename(path)}`);
+    return {
+        version: 1,
+        id: parsed.id,
+        reason: typeof parsed.reason === "string" ? parsed.reason : "",
+        createdAt: typeof parsed.createdAt === "string" ? parsed.createdAt : "",
+        files: parsed.files.filter((file) => typeof file === "object" &&
+            file !== null &&
+            typeof file.path === "string" &&
+            typeof file.bytes === "number" &&
+            typeof file.sha256 === "string" &&
+            typeof file.content === "string"),
+    };
+}
+async function listManifests(directory) {
+    const names = (await readdir(directory).catch(() => []))
+        .filter((name) => extname(name) === ".json")
+        .sort()
+        .reverse();
+    const summaries = [];
+    for (const name of names) {
+        const manifest = await readManifest(join(directory, name)).catch(() => undefined);
+        if (manifest !== undefined)
+            summaries.push({ id: manifest.id, reason: manifest.reason, createdAt: manifest.createdAt, fileCount: manifest.files.length });
+    }
+    return summaries;
+}
+async function diffManifest(root, manifest) {
+    const changed = [];
+    const missing = [];
+    let unchanged = 0;
+    for (const file of manifest.files) {
+        const path = await resolveExistingWorkspacePath(root, file.path, "Savepoint path must stay inside the workspace").catch(() => undefined);
+        if (path === undefined) {
+            missing.push(file.path);
+            continue;
+        }
+        const content = await readFile(path.target).catch(() => undefined);
+        if (content === undefined) {
+            missing.push(file.path);
+        }
+        else if (hash(content) === file.sha256) {
+            unchanged += 1;
+        }
+        else {
+            changed.push(file.path);
+        }
+    }
+    return { id: manifest.id, changed, missing, unchanged };
+}
+export default {
+    name: "pi-undo-savepoint",
+    inject: ["piHarnessLaunch", "piPluginUi", "piTools"],
+    Config,
+    async apply(context, config) {
+        const cwd = (await resolveExistingWorkspacePath(context.piHarnessLaunch.cwd, ".", "Workspace path is invalid")).root;
+        const store = join(context.piHarnessLaunch.agentDir, safeStoreName(config.storeName));
+        const trackedPaths = await normalizedTrackedPaths(cwd, config.trackedPaths ?? defaultTrackedPaths);
+        const maxFiles = Math.max(1, Math.min(2_000, Math.trunc(config.maxFiles ?? 400)));
+        const maxFileBytes = Math.max(1, Math.min(maxSnapshotBytes, Math.trunc(config.maxFileBytes ?? 256 * 1024)));
+        const manifestPath = (id) => {
+            if (!/^\d{17}-[0-9a-f]{8}$/u.test(id))
+                throw new Error("Invalid savepoint id");
+            return join(store, `${id}.json`);
+        };
+        const load = async (id) => readManifest(manifestPath(id));
+        const save = async (reason) => {
+            const createdAt = new Date().toISOString();
+            const id = `${createdAt.replace(/[-:.TZ]/gu, "").slice(0, 17)}-${randomUUID().slice(0, 8)}`;
+            const manifest = {
+                version: 1,
+                id,
+                reason: reason.trim() || "manual savepoint",
+                createdAt,
+                files: await collectFiles(cwd, trackedPaths, maxFiles, maxFileBytes),
+            };
+            await mkdir(store, { recursive: true });
+            const temporary = join(store, `.${id}.tmp`);
+            await writeFile(temporary, JSON.stringify(manifest, null, 2), { encoding: "utf8", mode: 0o600 });
+            await rename(temporary, manifestPath(id));
+            return manifest;
+        };
+        const restore = async (manifest) => {
+            const restored = [];
+            for (const file of manifest.files) {
+                const lexicalPath = resolve(cwd, ...file.path.split("/"));
+                if (!withinRoot(cwd, lexicalPath) || isSensitivePath(lexicalPath))
+                    continue;
+                const content = Buffer.from(file.content, "base64");
+                if (hash(content) !== file.sha256)
+                    throw new Error(`Savepoint integrity check failed: ${file.path}`);
+                const prepared = await prepareWorkspaceFile(cwd, file.path, `Savepoint path must stay inside the workspace and target a regular file: ${file.path}`);
+                const temporary = `${prepared.target}.${randomUUID()}.tmp`;
+                await writeFile(temporary, content, { mode: 0o600 });
+                await rename(temporary, prepared.target);
+                restored.push(file.path);
+            }
+            return restored;
+        };
+        const report = async () => {
+            const savepoints = await listManifests(store);
+            return { store, trackedPaths: trackedPaths.map((path) => relativePath(cwd, path) || "."), count: savepoints.length, savepoints };
+        };
+        const unregisterTool = context.piTools.register(defineTool({
+            name: "undo_savepoint",
+            label: "Undo savepoint",
+            description: "Create, inspect, diff, list, and explicitly restore safe local workspace savepoints.",
+            promptSnippet: "save or restore a workspace savepoint before risky changes",
+            parameters: Type.Object({
+                action: Type.Union([Type.Literal("save"), Type.Literal("list"), Type.Literal("diff"), Type.Literal("restore")]),
+                id: Type.Optional(Type.String({ description: "Savepoint id for diff or restore" })),
+                reason: Type.Optional(Type.String({ description: "Why this savepoint is being created" })),
+                confirm: Type.Optional(Type.Boolean({ description: "Must be true before restoring files" })),
+            }),
+            async execute(_toolCallId, params) {
+                if (params.action === "save") {
+                    const manifest = await save(params.reason ?? "manual savepoint");
+                    return {
+                        content: [{ type: "text", text: `Savepoint ${manifest.id} saved (${manifest.files.length} files).` }],
+                        details: { action: "save", id: manifest.id, fileCount: manifest.files.length },
+                    };
+                }
+                if (params.action === "list") {
+                    const details = await report();
+                    return { content: [{ type: "text", text: `${details.savepoints.length} savepoints available.` }], details: { action: "list", ...details } };
+                }
+                if (params.id === undefined || params.id.trim() === "")
+                    throw new Error(`action ${params.action} requires id`);
+                const manifest = await load(params.id);
+                if (params.action === "diff") {
+                    const details = await diffManifest(cwd, manifest);
+                    return {
+                        content: [{ type: "text", text: `${details.changed.length} changed, ${details.missing.length} missing, ${details.unchanged} unchanged.` }],
+                        details: { action: "diff", ...details },
+                    };
+                }
+                if (params.confirm !== true)
+                    throw new Error("Restoring a savepoint requires confirm=true");
+                const restored = await restore(manifest);
+                return {
+                    content: [{ type: "text", text: `Restored ${restored.length} files from ${manifest.id}.` }],
+                    details: { action: "restore", id: manifest.id, restored },
+                };
+            },
+        }));
+        const disposePanel = context.piPluginUi.register({
+            id: "undo-savepoint-panel",
+            pluginId: "@pi-harness/core/plugins/undo-savepoint",
+            title: "Undo Savepoints",
+            description: "保存工作区文件快照，查看列表与变更，并在确认后恢复。",
+            icon: "↶",
+            read: report,
+        });
+        context.effect(() => () => {
+            unregisterTool();
+            disposePanel();
+        });
+    },
+};
+//# sourceMappingURL=undo-savepoint.js.map

package/packages/core/dist/plugins/undo-savepoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"undo-savepoint.js","sourceRoot":"","sources":["../../src/plugins/undo-savepoint.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACtF,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAE5E,OAAO,CAAC,MAAM,0BAA0B,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAwB,MAAM,iCAAiC,CAAC;AACnF,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAC;AAExG,MAAM,gBAAgB,GAAG,iBAAiB,CAAC;AAC3C,MAAM,mBAAmB,GAAG,CAAC,GAAG,CAAC,CAAC;AAClC,MAAM,gBAAgB,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AACzC,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,mBAAmB,EAAE,mBAAmB,CAAC,CAAC,CAAC;AACpI,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;AASjG,MAAM,CAAC,MAAM,MAAM,GAAiC,CAAC,CAAC,MAAM,CAAC;IAC3D,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,gBAAgB,CAAC;IAC/C,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,mBAAmB,CAAC;IAC9D,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC;IACjC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC;CAC7C,CAAC,CAAC;AA+BH,SAAS,aAAa,CAAC,KAAyB;IAC9C,MAAM,IAAI,GAAG,CAAC,KAAK,IAAI,gBAAgB,CAAC,CAAC,IAAI,EAAE,CAAC;IAChD,IAAI,IAAI,KAAK,EAAE,IAAI,QAAQ,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,IAAI;QAC/F,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,UAAU,CAAC,IAAY,EAAE,SAAiB;IACjD,OAAO,YAAY,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;AACvC,CAAC;AAED,KAAK,UAAU,sBAAsB,CAAC,GAAW,EAAE,KAAwB;IACzE,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,KAAK,CAAC;IAChE,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,4BAA4B,CAAC,GAAG,EAAE,IAAI,EAAE,sDAAsD,CAAC,CAAC,CAAC,CAAC;IAC1J,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,SAAS,YAAY,CAAC,GAAW,EAAE,IAAY;IAC7C,OAAO,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,CAAC;AAED,SAAS,eAAe,CAAC,IAAY;IACnC,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;IAC1C,OAAO,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AAC7G,CAAC;AAED,SAAS,aAAa,CAAC,IAAY;IACjC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;AACtE,CAAC;AAED,SAAS,IAAI,CAAC,OAAe;IAC3B,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC5D,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,IAAY,EAAE,YAA+B,EAAE,QAAgB,EAAE,YAAoB;IAC/G,MAAM,KAAK,GAAoB,EAAE,CAAC;IAClC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,KAAK,GAAG,KAAK,EAAE,IAAY,EAAiB,EAAE;QAClD,IAAI,KAAK,CAAC,MAAM,IAAI,QAAQ,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,eAAe,CAAC,IAAI,CAAC;YAAE,OAAO;QACrF,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QACtD,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO;QAC/B,IAAI,IAAI,CAAC,cAAc,EAAE;YAAE,OAAO;QAClC,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACvB,KAAK,MAAM,KAAK,IAAI,MAAM,OAAO,CAAC,IAAI,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;gBACjE,IAAI,KAAK,CAAC,cAAc,EAAE;oBAAE,SAAS;gBACrC,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;gBACpC,IAAI,KAAK,CAAC,MAAM,IAAI,QAAQ;oBAAE,OAAO;YACvC,CAAC;YACD,OAAO;QACT,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,IAAI,GAAG,YAAY;YAAE,OAAO;QACvD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;YAAE,OAAO;QAChC,MAAM,YAAY,GAAG,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC9C,IAAI,YAAY,KAAK,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC;YAAE,OAAO;QAC1D,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC5H,CAAC,CAAC;IACF,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;QAChC,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;QAClB,IAAI,KAAK,CAAC,MAAM,IAAI,QAAQ;YAAE,MAAM;IACtC,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;AAC1E,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,IAAY;IACtC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAA+B,CAAC;IACtF,IAAI,MAAM,CAAC,OAAO,KAAK,CAAC,IAAI,OAAO,MAAM,CAAC,EAAE,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACnJ,OAAO;QACL,OAAO,EAAE,CAAC;QACV,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,MAAM,EAAE,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;QAC9D,SAAS,EAAE,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE;QACvE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CACxB,CAAC,IAAI,EAAyB,EAAE,CAC9B,OAAO,IAAI,KAAK,QAAQ;YACxB,IAAI,KAAK,IAAI;YACb,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ;YAC7B,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ;YAC9B,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ;YAC/B,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,CACnC;KACF,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,SAAiB;IAC5C,MAAM,KAAK,GAAG,CAAC,MAAM,OAAO,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAc,CAAC,CAAC;SACjE,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC;SAC3C,IAAI,EAAE;SACN,OAAO,EAAE,CAAC;IACb,MAAM,SAAS,GAAuB,EAAE,CAAC;IACzC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAClF,IAAI,QAAQ,KAAK,SAAS;YAAE,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5J,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,IAAY,EAAE,QAA2B;IACnE,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;QAClC,MAAM,IAAI,GAAG,MAAM,4BAA4B,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,+CAA+C,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QACzI,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACxB,SAAS;QACX,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QACnE,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;aAAM,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;YACzC,SAAS,IAAI,CAAC,CAAC;QACjB,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;AAC1D,CAAC;AAED,eAAe;IACb,IAAI,EAAE,mBAAmB;IACzB,MAAM,EAAE,CAAC,iBAAiB,EAAE,YAAY,EAAE,SAAS,CAAC;IACpD,MAAM;IACN,KAAK,CAAC,KAAK,CAAC,OAAgB,EAAE,MAAiC;QAC7D,MAAM,GAAG,GAAG,CAAC,MAAM,4BAA4B,CAAC,OAAO,CAAC,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,2BAA2B,CAAC,CAAC,CAAC,IAAI,CAAC;QACrH,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;QACtF,MAAM,YAAY,GAAG,MAAM,sBAAsB,CAAC,GAAG,EAAE,MAAM,CAAC,YAAY,IAAI,mBAAmB,CAAC,CAAC;QACnG,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;QAClF,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,gBAAgB,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,YAAY,IAAI,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAC5G,MAAM,YAAY,GAAG,CAAC,EAAU,EAAU,EAAE;YAC1C,IAAI,CAAC,uBAAuB,CAAC,IAAI,CAAC,EAAE,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;YAC/E,OAAO,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;QACnC,CAAC,CAAC;QACF,MAAM,IAAI,GAAG,KAAK,EAAE,EAAU,EAA8B,EAAE,CAAC,YAAY,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC;QAC9F,MAAM,IAAI,GAAG,KAAK,EAAE,MAAc,EAA8B,EAAE;YAChE,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YAC3C,MAAM,EAAE,GAAG,GAAG,SAAS,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;YAC5F,MAAM,QAAQ,GAAsB;gBAClC,OAAO,EAAE,CAAC;gBACV,EAAE;gBACF,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,kBAAkB;gBAC3C,SAAS;gBACT,KAAK,EAAE,MAAM,YAAY,CAAC,GAAG,EAAE,YAAY,EAAE,QAAQ,EAAE,YAAY,CAAC;aACrE,CAAC;YACF,MAAM,KAAK,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACxC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;YAC5C,MAAM,SAAS,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YACjG,MAAM,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC;YAC1C,OAAO,QAAQ,CAAC;QAClB,CAAC,CAAC;QACF,MAAM,OAAO,GAAG,KAAK,EAAE,QAA2B,EAAqB,EAAE;YACvE,MAAM,QAAQ,GAAa,EAAE,CAAC;YAC9B,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;gBAClC,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC1D,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,WAAW,CAAC,IAAI,eAAe,CAAC,WAAW,CAAC;oBAAE,SAAS;gBAC5E,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;gBACpD,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,MAAM;oBAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;gBACrG,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,4EAA4E,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;gBACrJ,MAAM,SAAS,GAAG,GAAG,QAAQ,CAAC,MAAM,IAAI,UAAU,EAAE,MAAM,CAAC;gBAC3D,MAAM,SAAS,CAAC,SAAS,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;gBACrD,MAAM,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;gBACzC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC3B,CAAC;YACD,OAAO,QAAQ,CAAC;QAClB,CAAC,CAAC;QACF,MAAM,MAAM,GAAG,KAAK,IAAuG,EAAE;YAC3H,MAAM,UAAU,GAAG,MAAM,aAAa,CAAC,KAAK,CAAC,CAAC;YAC9C,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,GAAG,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC;QACnI,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,sFAAsF;YACnG,aAAa,EAAE,4DAA4D;YAC3E,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC;gBACtB,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;gBAC/G,EAAE,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,kCAAkC,EAAE,CAAC,CAAC;gBACnF,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,qCAAqC,EAAE,CAAC,CAAC;gBAC1F,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,qCAAqC,EAAE,CAAC,CAAC;aAC7F,CAAC;YACF,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM;gBAC/B,IAAI,MAAM,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;oBAC7B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,kBAAkB,CAAC,CAAC;oBACjE,OAAO;wBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,QAAQ,CAAC,EAAE,WAAW,QAAQ,CAAC,KAAK,CAAC,MAAM,UAAU,EAAE,CAAC;wBACrG,OAAO,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE;qBAC/E,CAAC;gBACJ,CAAC;gBACD,IAAI,MAAM,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;oBAC7B,MAAM,OAAO,GAAG,MAAM,MAAM,EAAE,CAAC;oBAC/B,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC,MAAM,wBAAwB,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,EAAE,CAAC;gBAC9I,CAAC;gBACD,IAAI,MAAM,CAAC,EAAE,KAAK,SAAS,IAAI,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE;oBAAE,MAAM,IAAI,KAAK,CAAC,UAAU,MAAM,CAAC,MAAM,cAAc,CAAC,CAAC;gBAC/G,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBACvC,IAAI,MAAM,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;oBAC7B,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;oBAClD,OAAO;wBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,aAAa,OAAO,CAAC,OAAO,CAAC,MAAM,aAAa,OAAO,CAAC,SAAS,aAAa,EAAE,CAAC;wBAC1I,OAAO,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE;qBACxC,CAAC;gBACJ,CAAC;gBACD,IAAI,MAAM,CAAC,OAAO,KAAK,IAAI;oBAAE,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;gBAC5F,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,CAAC;gBACzC,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,QAAQ,CAAC,MAAM,eAAe,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAC;oBAC3F,OAAO,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAE,QAAQ,EAAE;iBAC1D,CAAC;YACJ,CAAC;SACF,CAAC,CACH,CAAC;QACF,MAAM,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC;YAC/C,EAAE,EAAE,sBAAsB;YAC1B,QAAQ,EAAE,yCAAyC;YACnD,KAAK,EAAE,iBAAiB;YACxB,WAAW,EAAE,4BAA4B;YACzC,IAAI,EAAE,GAAG;YACT,IAAI,EAAE,MAAM;SACb,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/vision-toolkit.d.ts

@@ -0,0 +1,17 @@
+import type { Context } from "@deepseek-ai/cordis";
+export interface VisionAsset {
+    path: string;
+    mimeType: string;
+    bytes: number;
+    width: number | null;
+    height: number | null;
+}
+export declare function imageInfo(root: string, requested: string): Promise<VisionAsset>;
+export declare function catalogImages(root: string): Promise<VisionAsset[]>;
+declare const _default: {
+    name: string;
+    inject: string[];
+    apply(context: Context): void;
+};
+export default _default;
+//# sourceMappingURL=vision-toolkit.d.ts.map

package/packages/core/dist/plugins/vision-toolkit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vision-toolkit.d.ts","sourceRoot":"","sources":["../../src/plugins/vision-toolkit.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAgBnD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAuCD,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CASrF;AAiBD,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAIxE;;;;mBAKgB,OAAO;;AAHxB,wBAyDE"}

package/packages/core/dist/plugins/vision-toolkit.js

@@ -0,0 +1,145 @@
+import { readdir, readFile, stat } from "node:fs/promises";
+import { extname, 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 maxImages = 100;
+const maxImageBytes = 20 * 1024 * 1024;
+const mimeByExtension = {
+    ".gif": "image/gif",
+    ".jpeg": "image/jpeg",
+    ".jpg": "image/jpeg",
+    ".png": "image/png",
+    ".webp": "image/webp",
+};
+const skippedDirectories = new Set([".git", "node_modules"]);
+function dimensions(data, mimeType) {
+    if (mimeType === "image/png" && data.length >= 24 && data.subarray(0, 8).equals(Buffer.from("\x89PNG\r\n\x1a\n", "binary")))
+        return { width: data.readUInt32BE(16), height: data.readUInt32BE(20) };
+    if (mimeType === "image/gif" && data.length >= 10 && data.subarray(0, 3).toString("ascii") === "GIF")
+        return { width: data.readUInt16LE(6), height: data.readUInt16LE(8) };
+    if (mimeType === "image/webp" && data.length >= 30 && data.subarray(0, 4).toString("ascii") === "RIFF" && data.subarray(8, 12).toString("ascii") === "WEBP") {
+        const chunk = data.subarray(12, 16).toString("ascii");
+        if (chunk === "VP8X")
+            return { width: 1 + data.readUIntLE(24, 3), height: 1 + data.readUIntLE(27, 3) };
+    }
+    if (mimeType !== "image/jpeg" || data.length < 4 || data.readUInt16BE(0) !== 0xffd8)
+        return undefined;
+    let offset = 2;
+    while (offset + 9 < data.length) {
+        if (data[offset] !== 0xff) {
+            offset += 1;
+            continue;
+        }
+        const marker = data[offset + 1] ?? 0;
+        offset += 2;
+        if (marker === 0xd8 || marker === 0xd9)
+            continue;
+        if (offset + 2 > data.length)
+            return undefined;
+        const segmentLength = data.readUInt16BE(offset);
+        if (segmentLength < 2 || offset + segmentLength > data.length)
+            return undefined;
+        const isSof = (marker >= 0xc0 && marker <= 0xc3) || (marker >= 0xc5 && marker <= 0xc7) || (marker >= 0xc9 && marker <= 0xcb) || (marker >= 0xcd && marker <= 0xcf);
+        if (isSof && segmentLength >= 7)
+            return { width: data.readUInt16BE(offset + 5), height: data.readUInt16BE(offset + 3) };
+        offset += segmentLength;
+    }
+    return undefined;
+}
+async function imagePath(root, requested) {
+    const resolved = await resolveExistingWorkspacePath(root, requested, "Image path must stay inside the workspace");
+    const mimeType = mimeByExtension[extname(resolved.target).toLowerCase()];
+    if (mimeType === undefined)
+        throw new Error("Unsupported image type; use png, jpeg, gif, or webp");
+    return { absolute: resolved.target, relativePath: resolved.relativePath };
+}
+export async function imageInfo(root, requested) {
+    const { absolute, relativePath } = await imagePath(root, requested);
+    const mimeType = mimeByExtension[extname(absolute).toLowerCase()];
+    const metadata = await stat(absolute);
+    if (!metadata.isFile())
+        throw new Error("Image path is not a file");
+    if (metadata.size > maxImageBytes)
+        throw new Error("Image exceeds the 20 MiB inspection limit");
+    const data = await readFile(absolute);
+    const size = dimensions(data, mimeType);
+    return { path: relativePath, mimeType, bytes: metadata.size, width: size?.width ?? null, height: size?.height ?? null };
+}
+async function walkImages(root, directory, prefix, output) {
+    if (output.length >= maxImages)
+        return;
+    const entries = (await readdir(directory, { withFileTypes: true })).sort((left, right) => left.name.localeCompare(right.name));
+    for (const entry of entries) {
+        if (output.length >= maxImages)
+            return;
+        if (entry.isDirectory() && !skippedDirectories.has(entry.name)) {
+            await walkImages(root, resolve(directory, entry.name), prefix ? `${prefix}/${entry.name}` : entry.name, output);
+            continue;
+        }
+        if (!entry.isFile() || mimeByExtension[extname(entry.name).toLowerCase()] === undefined)
+            continue;
+        const item = await imageInfo(root, prefix ? `${prefix}/${entry.name}` : entry.name);
+        output.push(item);
+    }
+}
+export async function catalogImages(root) {
+    const output = [];
+    await walkImages(resolve(root), resolve(root), "", output);
+    return output;
+}
+export default {
+    name: "pi-vision-toolkit",
+    inject: ["piHarnessLaunch", "piTools", "piPluginUi"],
+    apply(context) {
+        let latest = { root: context.piHarnessLaunch.cwd, assets: [] };
+        const unregisterCatalog = context.piTools.register(defineTool({
+            name: "vision_catalog",
+            label: "Vision catalog",
+            description: "List local workspace images with safe relative paths, MIME types, byte sizes, and dimensions.",
+            promptSnippet: "catalog the images in the current workspace",
+            parameters: Type.Object({}),
+            async execute() {
+                latest = { root: context.piHarnessLaunch.cwd, assets: await catalogImages(context.piHarnessLaunch.cwd) };
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: latest.assets.map((asset) => `${asset.path} ${asset.width ?? "?"}x${asset.height ?? "?"}`).join("\n") || "No supported images found.",
+                        },
+                    ],
+                    details: latest,
+                };
+            },
+        }));
+        const unregisterInfo = context.piTools.register(defineTool({
+            name: "vision_image_info",
+            label: "Image info",
+            description: "Inspect one workspace image without exposing its contents or reading outside the workspace.",
+            promptSnippet: "inspect the dimensions and type of a local image",
+            parameters: Type.Object({ path: Type.String({ description: "Image path relative to the workspace" }) }),
+            async execute(_toolCallId, params) {
+                const asset = await imageInfo(context.piHarnessLaunch.cwd, params.path);
+                latest = { root: context.piHarnessLaunch.cwd, assets: [asset] };
+                return {
+                    content: [{ type: "text", text: `${asset.path}: ${asset.mimeType}, ${asset.bytes} bytes, ${asset.width ?? "?"}x${asset.height ?? "?"}` }],
+                    details: asset,
+                };
+            },
+        }));
+        const disposePanel = context.piPluginUi.register({
+            id: "vision-toolkit-panel",
+            pluginId: "@pi-harness/core/plugins/vision-toolkit",
+            title: "视觉素材",
+            description: "盘点工作区图片的类型、尺寸和大小，再交由视觉模型分析内容。",
+            icon: "◉",
+            read: () => ({ root: latest.root, count: latest.assets.length, assets: [...latest.assets] }),
+        });
+        context.effect(() => () => {
+            unregisterCatalog();
+            unregisterInfo();
+            disposePanel();
+        });
+    },
+};
+//# sourceMappingURL=vision-toolkit.js.map

package/packages/core/dist/plugins/vision-toolkit.js.map

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

package/packages/core/dist/plugins/web-research.d.ts

@@ -0,0 +1,17 @@
+import type { Context } from "@deepseek-ai/cordis";
+import z from "@deepseek-ai/schemastery";
+export interface WebResearchPluginConfig {
+    baseUrl?: string;
+    apiKey?: string;
+    maxResults?: number;
+    timeoutMs?: number;
+}
+export declare const Config: z<WebResearchPluginConfig>;
+declare const _default: {
+    name: string;
+    inject: string[];
+    Config: z<WebResearchPluginConfig>;
+    apply(context: Context, config: WebResearchPluginConfig): void;
+};
+export default _default;
+//# sourceMappingURL=web-research.d.ts.map

package/packages/core/dist/plugins/web-research.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-research.d.ts","sourceRoot":"","sources":["../../src/plugins/web-research.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,CAAC,MAAM,0BAA0B,CAAC;AAwIzC,MAAM,WAAW,uBAAuB;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,MAAM,EAAE,CAAC,CAAC,uBAAuB,CAK5C,CAAC;;;;;mBAMc,OAAO,UAAU,uBAAuB;;AAJzD,wBAyIE"}