psyclaw 0.25.2 → 0.26.1

package/dist/src/panel/extension.js

@@ -0,0 +1,115 @@
+import { spawn } from "node:child_process";
+import { createPanelServer } from "./server.js";
+import { PiRpcClient } from "../adapters/pi/rpc.js";
+const BROWSER_ASSISTANT_PROMPT = [
+    "You are the PsyClaw browser research assistant.",
+    "Work in a read-only mode. You may inspect project files with read, grep, find, and ls only.",
+    "Do not claim a statistical result, citation, or completed action without evidence.",
+    "When the user asks for a change or side effect, explain the proposed plan and state that approval is required.",
+].join("\n");
+function assistantEnv(provider) {
+    const envName = provider === "deepseek" ? "DEEPSEEK_API_KEY" : provider === "openai" ? "OPENAI_API_KEY" : provider === "anthropic" ? "ANTHROPIC_API_KEY" : provider === "google" ? "GEMINI_API_KEY" : undefined;
+    const value = envName === undefined ? undefined : process.env[envName];
+    return envName !== undefined && value !== undefined ? { [envName]: value } : {};
+}
+function assistantText(events) {
+    for (let index = events.length - 1; index >= 0; index -= 1) {
+        const event = events[index];
+        if (event?.type !== "message_end" || !event.message || typeof event.message !== "object")
+            continue;
+        const content = event.message.content;
+        if (!Array.isArray(content))
+            continue;
+        const text = content.filter((part) => Boolean(part && typeof part === "object" && part.type === "text" && typeof part.text === "string")).map((part) => part.text).join("");
+        if (text.trim())
+            return text.trim();
+    }
+    return "没有收到可显示的研究答复。";
+}
+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) {
+    const command = process.platform === "win32" ? "cmd" : process.platform === "darwin" ? "open" : "xdg-open";
+    const args = process.platform === "win32" ? ["/c", "start", "", url] : [url];
+    const child = spawn(command, args, { detached: true, stdio: "ignore", windowsHide: true });
+    child.on("error", () => undefined);
+    child.unref();
+}
+/**
+ * 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.
+ */
+export default function psyclawPanelExtension(pi) {
+    let server;
+    let workbenchUrl;
+    let assistant;
+    const close = async () => {
+        const current = server;
+        server = undefined;
+        workbenchUrl = undefined;
+        const currentAssistant = assistant;
+        assistant = undefined;
+        await currentAssistant?.stop();
+        if (!current)
+            return;
+        await new Promise((resolve) => current.close(() => resolve()));
+    };
+    pi.registerCommand("panel", {
+        description: "Open the psyclaw research workbench in your browser",
+        handler: async (args, ctx) => {
+            if (args.trim() !== "") {
+                ctx.ui.notify("直接输入 /panel 即可打开科研工作台", "info");
+                return;
+            }
+            try {
+                if (server === undefined || workbenchUrl === undefined) {
+                    const next = createPanelServer(ctx.cwd, { assistant: async (message) => {
+                            if (!assistant) {
+                                assistant = new PiRpcClient({
+                                    cwd: ctx.cwd,
+                                    ...(ctx.model?.provider === undefined ? {} : { provider: ctx.model.provider }),
+                                    ...(ctx.model?.id === undefined ? {} : { model: ctx.model.id }),
+                                    env: assistantEnv(ctx.model?.provider),
+                                    tools: ["read", "grep", "find", "ls"],
+                                    systemPrompt: BROWSER_ASSISTANT_PROMPT,
+                                });
+                                try {
+                                    await assistant.start();
+                                }
+                                catch (error) {
+                                    await assistant.stop().catch(() => undefined);
+                                    assistant = undefined;
+                                    throw error;
+                                }
+                            }
+                            const current = assistant;
+                            const events = await current.promptAndWait(message);
+                            return { text: assistantText(events) };
+                        } });
+                    const actualPort = await listen(next, 0);
+                    server = next;
+                    workbenchUrl = `http://127.0.0.1:${actualPort}`;
+                }
+                openWorkbench(workbenchUrl);
+                ctx.ui.notify(`科研工作台已在浏览器中打开：${workbenchUrl}`, "info");
+            }
+            catch (error) {
+                server = undefined;
+                workbenchUrl = undefined;
+                ctx.ui.notify(error instanceof Error ? error.message : "科研工作台暂时无法打开", "error");
+            }
+        },
+    });
+    pi.on("session_shutdown", async () => {
+        await close();
+    });
+}
+//# sourceMappingURL=extension.js.map

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

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

package/dist/src/panel/literature-map.d.ts

@@ -0,0 +1,26 @@
+import type { Claim, ClaimEvidenceLink, Evidence } from "../core/contracts.js";
+/**
+ * Claim-centric literature context: for every claim, the sources that support,
+ * contradict, or contextualize it, with their evidence level and locator. This
+ * is the "文献脉络" view — where a claim came from and whether anything argues
+ * against it.
+ */
+export interface ClaimLiteratureMap {
+    schemaVersion: "psyclaw/literature-map/v1";
+    generatedAt: string;
+    claims: Array<{
+        id: string;
+        text: string;
+        kind: Claim["kind"];
+        status: Claim["status"];
+        sources: Array<{
+            relation: "supports" | "contradicts" | "context";
+            evidenceId: string;
+            title: string;
+            locator?: string;
+            level: Evidence["level"];
+            sha256?: string;
+        }>;
+    }>;
+}
+export declare function buildClaimLiteratureMap(claims: readonly Claim[], evidence: readonly Evidence[], links: readonly ClaimEvidenceLink[], now?: string): ClaimLiteratureMap;

package/dist/src/panel/literature-map.js

@@ -0,0 +1,34 @@
+export function buildClaimLiteratureMap(claims, evidence, links, now = new Date().toISOString()) {
+    const evidenceById = new Map(evidence.map((item) => [item.id, item]));
+    return {
+        schemaVersion: "psyclaw/literature-map/v1",
+        generatedAt: now,
+        claims: claims.map((claim) => {
+            const sources = links
+                .filter((link) => link.claimId === claim.id)
+                .map((link) => {
+                const item = evidenceById.get(link.evidenceId);
+                return {
+                    relation: link.relation,
+                    evidenceId: link.evidenceId,
+                    title: item?.source.title ?? item?.source.locator ?? link.evidenceId,
+                    ...(item?.source.locator === undefined ? {} : { locator: item.source.locator }),
+                    level: item?.level ?? "metadata",
+                    ...(item?.sha256 === undefined ? {} : { sha256: item.sha256 }),
+                };
+            })
+                .sort((left, right) => {
+                const order = { contradicts: 0, supports: 1, context: 2 };
+                return order[left.relation] - order[right.relation];
+            });
+            return {
+                id: claim.id,
+                text: claim.text,
+                kind: claim.kind,
+                status: claim.status,
+                sources,
+            };
+        }),
+    };
+}
+//# sourceMappingURL=literature-map.js.map

package/dist/src/panel/literature-map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"literature-map.js","sourceRoot":"","sources":["../../../src/panel/literature-map.ts"],"names":[],"mappings":"AA2BA,MAAM,UAAU,uBAAuB,CACrC,MAAwB,EACxB,QAA6B,EAC7B,KAAmC,EACnC,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;IAE9B,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IACtE,OAAO;QACL,aAAa,EAAE,2BAA2B;QAC1C,WAAW,EAAE,GAAG;QAChB,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;YAC3B,MAAM,OAAO,GAAG,KAAK;iBAClB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,KAAK,KAAK,CAAC,EAAE,CAAC;iBAC3C,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;gBACZ,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;gBAC/C,OAAO;oBACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;oBACvB,UAAU,EAAE,IAAI,CAAC,UAAU;oBAC3B,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,IAAI,IAAI,EAAE,MAAM,CAAC,OAAO,IAAI,IAAI,CAAC,UAAU;oBACpE,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;oBAC/E,KAAK,EAAE,IAAI,EAAE,KAAK,IAAK,UAAoB;oBAC3C,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;iBAC/D,CAAC;YACJ,CAAC,CAAC;iBACD,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;gBACpB,MAAM,KAAK,GAAG,EAAE,WAAW,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAW,CAAC;gBACnE,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YACtD,CAAC,CAAC,CAAC;YACL,OAAO;gBACL,EAAE,EAAE,KAAK,CAAC,EAAE;gBACZ,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,OAAO;aACR,CAAC;QACJ,CAAC,CAAC;KACH,CAAC;AACJ,CAAC"}

package/dist/src/panel/projection.d.ts

@@ -0,0 +1,51 @@
+import { Type, type Static } from "typebox";
+export declare const RunSnapshotSchema: Type.TObject<{
+    schemaVersion: Type.TLiteral<"psyclaw/run-snapshot/v1">;
+    runId: Type.TString;
+    projectId: Type.TString;
+    goal: Type.TString;
+    paradigm: Type.TString;
+    phase: Type.TUnion<[Type.TLiteral<"planned">, Type.TLiteral<"executing">, Type.TLiteral<"verifying">, Type.TLiteral<"completed">, Type.TLiteral<"paused">, Type.TLiteral<"blocked">, Type.TLiteral<"unknown">]>;
+    blocked: Type.TBoolean;
+    waitingOnHuman: Type.TArray<Type.TString>;
+    gates: Type.TArray<Type.TObject<{
+        gateId: Type.TString;
+        ok: Type.TBoolean;
+        severity: Type.TString;
+        reason: Type.TString;
+    }>>;
+    artifacts: Type.TArray<Type.TString>;
+    tasks: Type.TArray<Type.TObject<{
+        id: Type.TString;
+        status: Type.TUnion<[Type.TLiteral<"pending">, Type.TLiteral<"running">, Type.TLiteral<"succeeded">, Type.TLiteral<"failed">, Type.TLiteral<"blocked">]>;
+        attempt: Type.TInteger;
+        summary: Type.TString;
+        blockers: Type.TArray<Type.TString>;
+        artifacts: Type.TArray<Type.TString>;
+        receiptCount: Type.TInteger;
+        passedGates: Type.TArray<Type.TString>;
+    }>>;
+    evidenceCoverage: Type.TObject<{
+        totalClaims: Type.TInteger;
+        supportedClaims: Type.TInteger;
+        totalEvidence: Type.TInteger;
+    }>;
+    eventCount: Type.TInteger;
+    updatedAt: Type.TString;
+    nextStep: Type.TString;
+}>;
+export type RunSnapshot = Static<typeof RunSnapshotSchema>;
+export declare function asRunSnapshot(value: unknown): RunSnapshot;
+export interface RunListing {
+    runId: string;
+    phase: RunSnapshot["phase"];
+    eventCount: number;
+}
+/** List run ids discovered from the append-only run event log. */
+export declare function listRuns(root: string): Promise<RunListing[]>;
+/**
+ * Read-only projection of a run's facts. It derives a redacted snapshot from
+ * the JSONL event log, checkpoint, project, and evidence ledger. The panel
+ * consumes this and never mutates state or reaches the filesystem/MCP itself.
+ */
+export declare function projectRunSnapshot(root: string, runId: string): Promise<RunSnapshot>;

package/dist/src/panel/projection.js

@@ -0,0 +1,288 @@
+import { lstat, readFile, readdir } from "node:fs/promises";
+import { join } from "node:path";
+import { Type } from "typebox";
+import { Compile } from "typebox/compile";
+import { checkEvidenceSufficiency } from "../core/evidence-policy.js";
+import { redactSecrets } from "../core/redact.js";
+import { readJsonl } from "../project/jsonl.js";
+import { projectPaths } from "../project/paths.js";
+import { assertSafeRunEventPath } from "./events.js";
+import { loadLedger, readProject } from "../research/ledger.js";
+export const RunSnapshotSchema = Type.Object({
+    schemaVersion: Type.Literal("psyclaw/run-snapshot/v1"),
+    runId: Type.String(),
+    projectId: Type.String(),
+    goal: Type.String(),
+    paradigm: Type.String(),
+    phase: Type.Union([
+        Type.Literal("planned"),
+        Type.Literal("executing"),
+        Type.Literal("verifying"),
+        Type.Literal("completed"),
+        Type.Literal("paused"),
+        Type.Literal("blocked"),
+        Type.Literal("unknown"),
+    ]),
+    blocked: Type.Boolean(),
+    waitingOnHuman: Type.Array(Type.String()),
+    gates: Type.Array(Type.Object({
+        gateId: Type.String(),
+        ok: Type.Boolean(),
+        severity: Type.String(),
+        reason: Type.String(),
+    })),
+    artifacts: Type.Array(Type.String()),
+    tasks: Type.Array(Type.Object({
+        id: Type.String(),
+        status: Type.Union([
+            Type.Literal("pending"),
+            Type.Literal("running"),
+            Type.Literal("succeeded"),
+            Type.Literal("failed"),
+            Type.Literal("blocked"),
+        ]),
+        attempt: Type.Integer({ minimum: 0 }),
+        summary: Type.String(),
+        blockers: Type.Array(Type.String()),
+        artifacts: Type.Array(Type.String()),
+        receiptCount: Type.Integer({ minimum: 0 }),
+        passedGates: Type.Array(Type.String()),
+    }, { additionalProperties: false })),
+    evidenceCoverage: Type.Object({
+        totalClaims: Type.Integer(),
+        supportedClaims: Type.Integer(),
+        totalEvidence: Type.Integer(),
+    }),
+    eventCount: Type.Integer(),
+    updatedAt: Type.String(),
+    nextStep: Type.String(),
+}, { additionalProperties: false });
+const compiled = Compile(RunSnapshotSchema);
+export function asRunSnapshot(value) {
+    if (!compiled.Check(value)) {
+        const errors = [...compiled.Errors(value)].map((error) => {
+            const path = "path" in error && typeof error.path === "string" ? error.path : "/";
+            return `${path}: ${error.message}`;
+        });
+        throw new Error(`run snapshot schema invalid: ${errors.join("; ")}`);
+    }
+    return value;
+}
+function isRunEvent(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const event = value;
+    return event.schemaVersion === "psyclaw/run-event/v1" &&
+        typeof event.runId === "string" &&
+        typeof event.at === "string" &&
+        typeof event.type === "string";
+}
+function phaseFromEvents(events) {
+    const first = events[0];
+    const last = events.at(-1);
+    if (!last)
+        return "planned";
+    // A run must open with a `planned` event; a terminal or progress event
+    // without that opener is a forged or corrupt log, reported as unknown rather
+    // than trusted as a completed/blocked state.
+    if (first?.type !== "planned")
+        return "unknown";
+    switch (last.type) {
+        case "completed":
+            return "completed";
+        case "blocked":
+            return "blocked";
+        case "checkpoint":
+            return "paused";
+        case "gate":
+            return "verifying";
+        case "started":
+        case "receipt":
+            return "executing";
+        default:
+            return "planned";
+    }
+}
+/** One concrete next action for the researcher, derived from the run state. */
+function nextStepFor(phase, blocked, waitingReasons, corrupt) {
+    if (corrupt)
+        return "运行事件或检查点不可用，先修复再继续";
+    const waiting = waitingReasons.filter((item) => !item.includes("corrupt"));
+    if (blocked || phase === "blocked") {
+        return waiting.length > 0 ? `有 ${waiting.length} 项门禁需要你确认后再继续` : "门禁未通过，检查证据与 Claim";
+    }
+    if (waiting.length > 0)
+        return `有 ${waiting.length} 项待你确认`;
+    switch (phase) {
+        case "paused": return "批准从 checkpoint 恢复运行";
+        case "completed": return "检查产物，按 APA7 导出 DOCX（图片已内嵌）";
+        case "executing": return "模型正在后台执行，无需操作";
+        case "verifying": return "模型正在核验门禁";
+        case "planned": return "导入证据并登记 Claim 后开始分析";
+        default: return "等待运行状态";
+    }
+}
+async function readEvents(root, runId) {
+    const path = await assertSafeRunEventPath(root, runId);
+    const stat = await lstat(path).catch((error) => {
+        if (error.code === "ENOENT")
+            return undefined;
+        throw error;
+    });
+    if (stat !== undefined && (stat.isSymbolicLink() || !stat.isFile())) {
+        throw new Error("Run event path must be a regular file");
+    }
+    const rows = await readJsonl(path);
+    return rows.map((row, index) => {
+        if (!isRunEvent(row) || row.runId !== runId) {
+            throw new Error(`Invalid run event at ${path}:${index + 1}`);
+        }
+        return row;
+    });
+}
+async function readCheckpoint(root, runId) {
+    const path = join(projectPaths(root).runs, `${runId}.checkpoint.json`);
+    try {
+        const stat = await lstat(path);
+        if (!stat.isFile() || stat.isSymbolicLink())
+            return { kind: "corrupt", artifacts: [], tasks: [] };
+        const text = await readFile(path, "utf8");
+        const value = JSON.parse(text);
+        if (value.schemaVersion !== "psyclaw/orchestrator-checkpoint/v1" || value.runId !== runId ||
+            value.tasks === null || typeof value.tasks !== "object" || Array.isArray(value.tasks)) {
+            return { kind: "corrupt", artifacts: [], tasks: [] };
+        }
+        const tasks = value.tasks;
+        const artifacts = [];
+        const taskProjections = [];
+        for (const [id, task] of Object.entries(tasks)) {
+            if (task === null || typeof task !== "object" || Array.isArray(task))
+                return { kind: "corrupt", artifacts: [], tasks: [] };
+            const item = task;
+            const taskArtifacts = item.artifacts;
+            const validStatus = item.status === "pending" || item.status === "running" || item.status === "succeeded" || item.status === "failed" || item.status === "blocked";
+            if (!validStatus || !Number.isInteger(item.attempt) || item.attempt < 0 ||
+                !Array.isArray(taskArtifacts) || !taskArtifacts.every((entry) => typeof entry === "string") ||
+                !Array.isArray(item.receipts) || !Array.isArray(item.passedGates) || !item.passedGates.every((entry) => typeof entry === "string")) {
+                return { kind: "corrupt", artifacts: [], tasks: [] };
+            }
+            artifacts.push(...taskArtifacts);
+            const report = item.report && typeof item.report === "object" && !Array.isArray(item.report)
+                ? item.report
+                : undefined;
+            if (report !== undefined && (typeof report.summary !== "string" || !Array.isArray(report.blockers) || !report.blockers.every((entry) => typeof entry === "string"))) {
+                return { kind: "corrupt", artifacts: [], tasks: [] };
+            }
+            const taskArtifactPaths = taskArtifacts;
+            const taskPassedGates = item.passedGates;
+            taskProjections.push({
+                id,
+                status: item.status,
+                attempt: item.attempt,
+                summary: redactSecrets(typeof report?.summary === "string" ? report.summary : ""),
+                blockers: (Array.isArray(report?.blockers) ? report.blockers : []).map((entry) => redactSecrets(entry)),
+                artifacts: taskArtifactPaths,
+                receiptCount: item.receipts.length,
+                passedGates: taskPassedGates,
+            });
+        }
+        return {
+            kind: "valid",
+            ...(typeof value.status === "string" ? { status: value.status } : {}),
+            artifacts,
+            tasks: taskProjections.sort((left, right) => left.id.localeCompare(right.id)),
+        };
+    }
+    catch (error) {
+        return error.code === "ENOENT"
+            ? { kind: "missing", artifacts: [], tasks: [] }
+            : { kind: "corrupt", artifacts: [], tasks: [] };
+    }
+}
+/** List run ids discovered from the append-only run event log. */
+export async function listRuns(root) {
+    const runsDir = projectPaths(root).runs;
+    let entries;
+    try {
+        entries = await readdir(runsDir);
+    }
+    catch {
+        return [];
+    }
+    const listings = [];
+    for (const entry of entries) {
+        if (!entry.endsWith(".jsonl") || entry.endsWith(".checkpoint.json"))
+            continue;
+        const runId = entry.slice(0, -".jsonl".length);
+        try {
+            const events = await readEvents(root, runId);
+            listings.push({ runId, phase: phaseFromEvents(events), eventCount: events.length });
+        }
+        catch {
+            continue;
+        }
+    }
+    return listings.sort((left, right) => left.runId.localeCompare(right.runId));
+}
+/**
+ * Read-only projection of a run's facts. It derives a redacted snapshot from
+ * the JSONL event log, checkpoint, project, and evidence ledger. The panel
+ * consumes this and never mutates state or reaches the filesystem/MCP itself.
+ */
+export async function projectRunSnapshot(root, runId) {
+    if (!/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/.test(runId)) {
+        throw new Error("Run id contains unsupported path characters");
+    }
+    const project = await readProject(root);
+    const ledger = await loadLedger(root);
+    const gates = checkEvidenceSufficiency({ ...ledger, paradigm: project.paradigm });
+    const checkpoint = await readCheckpoint(root, runId);
+    let events = [];
+    let eventCorrupt = false;
+    try {
+        events = await readEvents(root, runId);
+    }
+    catch {
+        eventCorrupt = true;
+    }
+    const gateBlocked = gates.filter((gate) => !gate.ok);
+    const checkpointCorrupt = checkpoint.kind === "corrupt";
+    const phase = eventCorrupt || checkpointCorrupt
+        ? "unknown"
+        : checkpoint.kind === "valid" && checkpoint.status === "paused"
+            ? "paused"
+            : phaseFromEvents(events);
+    const snapshot = {
+        schemaVersion: "psyclaw/run-snapshot/v1",
+        runId,
+        projectId: project.id,
+        goal: redactSecrets(project.goal),
+        paradigm: project.paradigm,
+        phase,
+        blocked: gateBlocked.length > 0 || phase === "blocked",
+        waitingOnHuman: [
+            ...(eventCorrupt ? ["run event log is corrupt or unavailable"] : []),
+            ...(checkpointCorrupt ? ["run checkpoint is corrupt or unavailable"] : []),
+            ...gateBlocked.map((gate) => redactSecrets(gate.reason)),
+        ],
+        gates: gates.map((gate) => ({
+            gateId: gate.gateId,
+            ok: gate.ok,
+            severity: gate.severity,
+            reason: redactSecrets(gate.reason),
+        })),
+        artifacts: checkpoint.kind === "valid" ? checkpoint.artifacts : [],
+        tasks: checkpoint.kind === "valid" ? checkpoint.tasks : [],
+        evidenceCoverage: {
+            totalClaims: ledger.claims.length,
+            supportedClaims: ledger.claims.filter((claim) => claim.status === "supported").length,
+            totalEvidence: ledger.evidence.length,
+        },
+        eventCount: events.length,
+        updatedAt: new Date().toISOString(),
+        nextStep: nextStepFor(phase, gateBlocked.length > 0, gateBlocked.map((gate) => redactSecrets(gate.reason)), checkpointCorrupt || eventCorrupt),
+    };
+    asRunSnapshot(snapshot);
+    return snapshot;
+}
+//# sourceMappingURL=projection.js.map

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

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

package/dist/src/panel/server.d.ts

@@ -0,0 +1,46 @@
+import { type Server } from "node:http";
+export { verifyDoi } from "../core/doi.js";
+export interface ProjectDocument {
+    path: string;
+    format: string;
+    kind: "manuscript" | "reference" | "data" | "report" | "document";
+    bytes: number;
+    sha256: string;
+    imported: boolean;
+    isManuscript: boolean;
+}
+/**
+ * Download the open-access PDF for a DOI into literature/<slug>.pdf. Only
+ * https/http URLs returned by OpenAlex are accepted; size is capped at 40 MB.
+ */
+export declare function downloadReferencePdf(root: string, doi: string, fetchFn?: typeof fetch): Promise<{
+    ok: true;
+    path: string;
+    bytes: number;
+    oaUrl: string;
+    evidenceId: string;
+} | {
+    ok: false;
+    reason: string;
+    doi: string;
+}>;
+export interface PanelServerOptions {
+    /** Absolute or cwd-relative path to the panel HTML file. */
+    panelHtmlPath?: string;
+    /** Optional browser assistant. The callback owns the Pi/model boundary. */
+    assistant?: (message: string) => Promise<{
+        text: string;
+    }>;
+}
+/**
+ * When the panel message references claims by id (e.g. the 追问此论断 flow),
+ * attach the real ledger context (.psyclaw) so the spawned read-only assistant
+ * answers grounded instead of fumbling for the claim.
+ */
+export declare function enrichAssistantMessage(root: string, message: string): Promise<string>;
+/**
+ * Narrow local panel server. Run facts and catalog endpoints are read-only;
+ * provider configuration is the one explicit POST action and delegates key
+ * persistence to Pi's auth storage.
+ */
+export declare function createPanelServer(root: string, options?: PanelServerOptions): Server;