psyclaw 0.29.3 → 0.29.5

package/dist/src/panel/extension.js

@@ -1,110 +1,34 @@
-import { spawn } from "node:child_process";
-import { DefaultPackageManager, getAgentDir, SettingsManager } from "@earendil-works/pi-coding-agent";
-import { createPanelServer } from "./server.js";
-async function listen(server, port) {
-    await new Promise((resolve, reject) => {
-        server.once("error", reject);
-        server.listen(port, "127.0.0.1", () => resolve());
-    });
-    const address = server.address();
-    return typeof address === "object" && address !== null ? address.port : port;
-}
-function openWorkbench(url) {
-    return new Promise((resolve) => {
-        const command = process.platform === "win32" ? "cmd" : process.platform === "darwin" ? "open" : "xdg-open";
-        const args = process.platform === "win32" ? ["/c", "start", "", url] : [url];
-        let child;
-        try {
-            child = spawn(command, args, { detached: true, stdio: "ignore", windowsHide: true });
-        }
-        catch {
-            resolve(false);
-            return;
-        }
-        child.once("error", () => resolve(false));
-        child.once("spawn", () => resolve(true));
-        child.unref();
-    });
-}
+import { closeResearchWorkbench, openResearchWorkbench } from "./workbench.js";
 /**
- * Optional Pi extension for the local, read-only web projection. The core
- * psyclaw package does not load this extension by default; `/agents` remains a
- * native core command. Binding is always loopback and the panel has no write
- * endpoint.
+ * Optional Pi extension for the local web projection. Binding is always loopback.
  */
 export default function psyclawPanelExtension(pi) {
-    let server;
-    let workbenchUrl;
-    const close = async () => {
-        const current = server;
-        server = undefined;
-        workbenchUrl = undefined;
-        if (!current)
-            return;
-        await new Promise((resolve) => current.close(() => resolve()));
-    };
     pi.registerCommand("panel", {
-        description: "Open the psyclaw research workbench in your browser",
+        description: "打开科研工作台（浏览器）",
         handler: async (args, ctx) => {
-            if (args.trim() !== "") {
-                ctx.ui.notify("直接输入 /panel 即可打开科研工作台", "info");
+            const trimmed = args.trim().toLowerCase();
+            if (trimmed && trimmed !== "help" && !trimmed.startsWith("view=")) {
+                ctx.ui.notify("用法：/panel 或 /panel help", "info");
                 return;
             }
+            const view = trimmed === "help" || trimmed === "view=help" ? "help" : undefined;
             try {
-                if (server === undefined || workbenchUrl === undefined) {
-                    const packageManager = () => new DefaultPackageManager({
-                        cwd: ctx.cwd,
-                        agentDir: getAgentDir(),
-                        settingsManager: SettingsManager.create(ctx.cwd, getAgentDir(), { projectTrusted: ctx.isProjectTrusted() }),
-                    });
-                    const next = createPanelServer(ctx.cwd, {
-                        assistant: async (message) => {
-                            pi.sendUserMessage(message, ctx.isIdle() ? {} : { deliverAs: "followUp" });
-                            return { text: "✓ 指令/提问已转入当前 PsyClaw 智能体并在终端会话中执行。" };
-                        },
-                        installSkill: async (task) => {
-                            pi.sendUserMessage(task, ctx.isIdle() ? {} : { deliverAs: "followUp" });
-                        },
-                        installExternalTool: async (task) => {
-                            pi.sendUserMessage(task, ctx.isIdle() ? {} : { deliverAs: "followUp" });
-                        },
-                        installPlugin: async (source, scope) => {
-                            await packageManager().installAndPersist(source, { local: scope === "project" });
-                        },
-                        listPlugins: () => packageManager().listConfiguredPackages().map(({ source, scope, filtered, installedPath }) => ({
-                            source,
-                            scope,
-                            filtered,
-                            installed: installedPath !== undefined,
-                        })),
-                    });
-                    const actualPort = await listen(next, 0);
-                    server = next;
-                    workbenchUrl = `http://127.0.0.1:${actualPort}`;
-                }
-                openWorkbench(workbenchUrl).then((opened) => {
-                    if (opened) {
-                        ctx.ui.notify(`科研工作台已在浏览器中打开：${workbenchUrl}`, "info");
-                    }
-                    else {
-                        // The local server is up regardless; give the user a reachable
-                        // fallback instead of leaving them with a dead-end error.
-                        ctx.ui.notify(`科研工作台已启动，但未能自动打开浏览器。请手动访问：${workbenchUrl}`, "warning");
-                    }
-                }).catch((error) => {
-                    ctx.ui.notify(`科研工作台已启动，但自动打开失败：${error instanceof Error ? error.message : String(error)}。请手动访问：${workbenchUrl}`, "warning");
-                });
+                const { url, opened } = await openResearchWorkbench({
+                    cwd: ctx.cwd,
+                    isProjectTrusted: () => ctx.isProjectTrusted(),
+                    isIdle: () => ctx.isIdle(),
+                    sendUserMessage: (message, options) => pi.sendUserMessage(message, options ?? {}),
+                }, view ? { view } : {});
+                ctx.ui.notify(opened ? `科研工作台已打开：${url}` : `工作台已启动，请手动访问：${url}`, opened ? "info" : "warning");
             }
             catch (error) {
-                server = undefined;
-                workbenchUrl = undefined;
                 const detail = error instanceof Error ? error.message : String(error);
                 ctx.ui.notify(`科研工作台启动失败：${detail}`, "error");
             }
         },
     });
     pi.on("session_shutdown", async () => {
-        await close();
+        await closeResearchWorkbench();
     });
 }
 //# sourceMappingURL=extension.js.map

package/dist/src/panel/extension.js.map

@@ -1 +1 @@
-{"version":3,"file":"extension.js","sourceRoot":"","sources":["../../../src/panel/extension.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"extension.js","sourceRoot":"","sources":["../../../src/panel/extension.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAE/E;;GAEG;AACH,MAAM,CAAC,OAAO,UAAU,qBAAqB,CAAC,EAAgB;IAC5D,EAAE,CAAC,eAAe,CAAC,OAAO,EAAE;QAC1B,WAAW,EAAE,cAAc;QAC3B,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;YAC3B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YAC1C,IAAI,OAAO,IAAI,OAAO,KAAK,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;gBAClE,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,yBAAyB,EAAE,MAAM,CAAC,CAAC;gBACjD,OAAO;YACT,CAAC;YACD,MAAM,IAAI,GAAG,OAAO,KAAK,MAAM,IAAI,OAAO,KAAK,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;YAChF,IAAI,CAAC;gBACH,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,qBAAqB,CAAC;oBAClD,GAAG,EAAE,GAAG,CAAC,GAAG;oBACZ,gBAAgB,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,gBAAgB,EAAE;oBAC9C,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE;oBAC1B,eAAe,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC,eAAe,CAAC,OAAO,EAAE,OAAO,IAAI,EAAE,CAAC;iBAClF,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBACzB,GAAG,CAAC,EAAE,CAAC,MAAM,CACX,MAAM,CAAC,CAAC,CAAC,YAAY,GAAG,EAAE,CAAC,CAAC,CAAC,gBAAgB,GAAG,EAAE,EAClD,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAC5B,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACtE,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,aAAa,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;YAChD,CAAC;QACH,CAAC;KACF,CAAC,CAAC;IAEH,EAAE,CAAC,EAAE,CAAC,kBAAkB,EAAE,KAAK,IAAI,EAAE;QACnC,MAAM,sBAAsB,EAAE,CAAC;IACjC,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/src/panel/server.js

@@ -30,9 +30,10 @@ export { verifyDoi } from "../core/doi.js";
 import { resumePlanWithPi } from "../orchestration/pi-executor.js";
 import { RunEventLog } from "./events.js";
 import { PSYCLAW_IDENTITY_PROMPT } from "../branding.js";
+import { sessionHelpDocument } from "../session/help.js";
 import { recommendedSkillTarget } from "../skills/recommended.js";
 import { readUserSkillState, scanLocalSkills, setLocalSkillEnabled, userSkillId, } from "../skills/user-skills.js";
-import { loadVerifyChecklist } from "../verify/checklist.js";
+import { loadVerifyChecklist, markVerifyItem, skipUnverifiedItems } from "../verify/checklist.js";
 import { readActiveAnalysisPlan } from "../analysis/plan.js";
 const activePanelRuns = new Set();
 async function readRecommendationState(root) {
@@ -864,6 +865,11 @@ export function createPanelServer(root, options = {}) {
                 response.end(JSON.stringify(await panelStats(root)));
                 return;
             }
+            if (url.pathname === "/api/help") {
+                response.writeHead(200, { "content-type": "application/json" });
+                response.end(JSON.stringify({ schemaVersion: "psyclaw/panel-help/v1", ...sessionHelpDocument() }));
+                return;
+            }
             if (url.pathname === "/api/files") {
                 response.writeHead(200, { "content-type": "application/json" });
                 response.end(JSON.stringify({ schemaVersion: "psyclaw/panel-files/v1", files: await listProjectFiles(root) }));
@@ -983,6 +989,36 @@ export function createPanelServer(root, options = {}) {
                 }));
                 return;
             }
+            if (url.pathname === "/api/crosscheck") {
+                if (request.method === "GET") {
+                    const checklist = await loadVerifyChecklist(root);
+                    response.writeHead(200, { "content-type": "application/json" });
+                    response.end(JSON.stringify({ schemaVersion: "psyclaw/crosscheck/v1", checklist }));
+                    return;
+                }
+                if (request.method !== "POST")
+                    throw new Error("method not allowed");
+                const body = await readJsonBody(request);
+                if (body.action === "skip") {
+                    const checklist = await skipUnverifiedItems(root, typeof body.reason === "string" ? body.reason : undefined);
+                    response.writeHead(200, { "content-type": "application/json" });
+                    response.end(JSON.stringify({ schemaVersion: "psyclaw/crosscheck/v1", checklist }));
+                    return;
+                }
+                const id = String(body.id ?? "").trim();
+                const status = String(body.status ?? "verified");
+                if (!id)
+                    throw new Error("id is required");
+                if (status !== "verified" && status !== "unverified" && status !== "flagged" && status !== "skipped") {
+                    throw new Error("status must be verified|unverified|flagged|skipped");
+                }
+                const kind = typeof body.kind === "string" ? body.kind : undefined;
+                const notes = typeof body.notes === "string" ? body.notes : undefined;
+                const checklist = await markVerifyItem(root, id, status, notes, kind);
+                response.writeHead(200, { "content-type": "application/json" });
+                response.end(JSON.stringify({ schemaVersion: "psyclaw/crosscheck/v1", checklist }));
+                return;
+            }
             if (url.pathname === "/api/active-provider") {
                 if (request.method === "GET") {
                     const settings = await readAgentSettings();