psyclaw 0.28.0 → 0.28.2

package/dist/src/index.js.map

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

package/dist/src/orchestration/bundled-personas.d.ts

@@ -0,0 +1,16 @@
+import type { AgentRole, TaskNode } from "./contracts.js";
+export type BundledPersonaPack = "literature" | "review";
+export interface BundledPersonaDefinition {
+    id: string;
+    label: string;
+    role: AgentRole;
+    pack: BundledPersonaPack;
+    stage: string;
+    description: string;
+    instructions: string;
+}
+/** Built-in read-only research subagents (Claude-style), selectable via `/agents --agent`. */
+export declare const BUNDLED_PERSONAS: readonly BundledPersonaDefinition[];
+export declare function bundledPersonasForPack(pack: BundledPersonaPack): readonly BundledPersonaDefinition[];
+export declare function personaMarkdown(persona: Pick<BundledPersonaDefinition, "id" | "label" | "role" | "instructions">): string;
+export declare function bundledPersonaAsTaskRole(persona: BundledPersonaDefinition): TaskNode["role"];

package/dist/src/orchestration/bundled-personas.js

@@ -0,0 +1,101 @@
+/** Built-in read-only research subagents (Claude-style), selectable via `/agents --agent`. */
+export const BUNDLED_PERSONAS = [
+    {
+        id: "landscape-mapper",
+        label: "研究版图分析者",
+        role: "researcher",
+        pack: "literature",
+        stage: "文献多智能体",
+        description: "梳理研究主题、年代分布、代表性论文和研究方向。",
+        instructions: "梳理研究主题、年代分布、代表性论文和研究方向。只依据提供的可核验元数据与摘要，不得补造论文内容。",
+    },
+    {
+        id: "methods-scout",
+        label: "方法学分析者",
+        role: "analyst",
+        pack: "literature",
+        stage: "文献多智能体",
+        description: "识别研究设计、测量与分析线索，区分元数据可判断与不可判断之处。",
+        instructions: "识别文献中的研究设计、测量与分析线索，指出仅凭元数据无法判断之处，不得把推测写成研究事实。",
+    },
+    {
+        id: "evidence-critic",
+        label: "证据批判者",
+        role: "critic",
+        pack: "literature",
+        stage: "文献多智能体",
+        description: "检查证据强弱、偏倚、冲突与因果边界。",
+        instructions: "检查证据强弱、潜在偏倚、相互冲突与因果边界，明确区分检索结果、摘要信息和进一步需要全文核验的主张。",
+    },
+    {
+        id: "gap-finder",
+        label: "研究缺口分析者",
+        role: "verifier",
+        pack: "literature",
+        stage: "文献多智能体",
+        description: "寻找尚未充分覆盖的问题、对象、情境和方法。",
+        instructions: "寻找尚未充分覆盖的问题、对象、情境和方法，并把真正的证据缺口与单纯的检索缺口分开。",
+    },
+    {
+        id: "theory-reviewer",
+        label: "理论与贡献审稿人",
+        role: "critic",
+        pack: "review",
+        stage: "同行评审多智能体",
+        description: "检查问题重要性、理论定位、创新性与主张—证据一致性。",
+        instructions: "以匿名同行评审标准检查问题重要性、理论定位、创新性、主张与证据的一致性。给出带稿件定位的主要与次要意见。",
+    },
+    {
+        id: "methods-reviewer",
+        label: "研究设计审稿人",
+        role: "analyst",
+        pack: "review",
+        stage: "同行评审多智能体",
+        description: "检查抽样、设计、测量、效度与因果推断边界。",
+        instructions: "检查抽样、设计、测量、效度、探索与确证边界、因果推断边界以及方法与问题的适配性。",
+    },
+    {
+        id: "statistics-reviewer",
+        label: "统计与可复现性审稿人",
+        role: "verifier",
+        pack: "review",
+        stage: "同行评审多智能体",
+        description: "检查分析策略、效应量、置信区间与可复现信息（不重算统计）。",
+        instructions: "检查分析策略、效应量、置信区间、缺失值、稳健性、图表和可复现信息。不得重新计算或虚构任何统计量。",
+    },
+    {
+        id: "ethics-editorial-reviewer",
+        label: "伦理与编辑审稿人",
+        role: "writer",
+        pack: "review",
+        stage: "同行评审多智能体",
+        description: "检查伦理、透明报告、引用表达与可读性。",
+        instructions: "检查伦理、隐私、透明报告、引用表达、结构与可读性，并给出可执行但不直接改稿的建议。",
+    },
+];
+export function bundledPersonasForPack(pack) {
+    return BUNDLED_PERSONAS.filter((persona) => persona.pack === pack);
+}
+export function personaMarkdown(persona) {
+    return [
+        "---",
+        "schemaVersion: psyclaw/agent-persona/v1",
+        `id: ${persona.id}`,
+        `label: ${persona.label}`,
+        `role: ${persona.role}`,
+        "allowedEffects:",
+        "  - read",
+        "---",
+        "",
+        `# ${persona.label}`,
+        "",
+        persona.instructions,
+        "",
+        "所有判断必须标明依据和不确定性；不得虚构引用、数据、统计结果或稿件中不存在的内容。",
+        "",
+    ].join("\n");
+}
+export function bundledPersonaAsTaskRole(persona) {
+    return persona.role;
+}
+//# sourceMappingURL=bundled-personas.js.map

package/dist/src/orchestration/bundled-personas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundled-personas.js","sourceRoot":"","sources":["../../../src/orchestration/bundled-personas.ts"],"names":[],"mappings":"AAcA,8FAA8F;AAC9F,MAAM,CAAC,MAAM,gBAAgB,GAAwC;IACnE;QACE,EAAE,EAAE,kBAAkB;QACtB,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,YAAY;QAClB,IAAI,EAAE,YAAY;QAClB,KAAK,EAAE,QAAQ;QACf,WAAW,EAAE,yBAAyB;QACtC,YAAY,EAAE,kDAAkD;KACjE;IACD;QACE,EAAE,EAAE,eAAe;QACnB,KAAK,EAAE,QAAQ;QACf,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,YAAY;QAClB,KAAK,EAAE,QAAQ;QACf,WAAW,EAAE,iCAAiC;QAC9C,YAAY,EAAE,+CAA+C;KAC9D;IACD;QACE,EAAE,EAAE,iBAAiB;QACrB,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,YAAY;QAClB,KAAK,EAAE,QAAQ;QACf,WAAW,EAAE,oBAAoB;QACjC,YAAY,EAAE,mDAAmD;KAClE;IACD;QACE,EAAE,EAAE,YAAY;QAChB,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,YAAY;QAClB,KAAK,EAAE,QAAQ;QACf,WAAW,EAAE,uBAAuB;QACpC,YAAY,EAAE,2CAA2C;KAC1D;IACD;QACE,EAAE,EAAE,iBAAiB;QACrB,KAAK,EAAE,UAAU;QACjB,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,UAAU;QACjB,WAAW,EAAE,4BAA4B;QACzC,YAAY,EAAE,sDAAsD;KACrE;IACD;QACE,EAAE,EAAE,kBAAkB;QACtB,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,UAAU;QACjB,WAAW,EAAE,uBAAuB;QACpC,YAAY,EAAE,0CAA0C;KACzD;IACD;QACE,EAAE,EAAE,qBAAqB;QACzB,KAAK,EAAE,YAAY;QACnB,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,UAAU;QACjB,WAAW,EAAE,+BAA+B;QAC5C,YAAY,EAAE,kDAAkD;KACjE;IACD;QACE,EAAE,EAAE,2BAA2B;QAC/B,KAAK,EAAE,UAAU;QACjB,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,UAAU;QACjB,WAAW,EAAE,qBAAqB;QAClC,YAAY,EAAE,2CAA2C;KAC1D;CACO,CAAC;AAEX,MAAM,UAAU,sBAAsB,CAAC,IAAwB;IAC7D,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAiF;IAC/G,OAAO;QACL,KAAK;QACL,yCAAyC;QACzC,OAAO,OAAO,CAAC,EAAE,EAAE;QACnB,UAAU,OAAO,CAAC,KAAK,EAAE;QACzB,SAAS,OAAO,CAAC,IAAI,EAAE;QACvB,iBAAiB;QACjB,UAAU;QACV,KAAK;QACL,EAAE;QACF,KAAK,OAAO,CAAC,KAAK,EAAE;QACpB,EAAE;QACF,OAAO,CAAC,YAAY;QACpB,EAAE;QACF,2CAA2C;QAC3C,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,OAAiC;IACxE,OAAO,OAAO,CAAC,IAAI,CAAC;AACtB,CAAC"}

package/dist/src/orchestration/effects.d.ts

@@ -0,0 +1,8 @@
+import type { Effect } from "../core/contracts.js";
+export declare function isEffect(value: unknown): value is Effect;
+/** Normalize declared effects: always include read, drop unknowns/duplicates, stable order. */
+export declare function normalizeEffects(raw: readonly unknown[] | undefined): Effect[];
+export declare function elevatedEffects(effects: readonly Effect[]): Effect[];
+export declare function hasElevatedEffects(effects: readonly Effect[]): boolean;
+export declare function toolsForEffects(effects: readonly Effect[]): string[];
+export declare function formatEffects(effects: readonly Effect[]): string;

package/dist/src/orchestration/effects.js

@@ -0,0 +1,39 @@
+const EFFECT_ORDER = ["read", "write", "network", "destructive"];
+const EFFECT_SET = new Set(EFFECT_ORDER);
+/** Pi tools granted per effect class after explicit user approval. */
+const TOOLS_BY_EFFECT = {
+    read: ["read", "grep", "find", "ls"],
+    write: ["write", "edit"],
+    network: ["bash"],
+    destructive: ["bash"],
+};
+export function isEffect(value) {
+    return typeof value === "string" && EFFECT_SET.has(value);
+}
+/** Normalize declared effects: always include read, drop unknowns/duplicates, stable order. */
+export function normalizeEffects(raw) {
+    const selected = new Set(["read"]);
+    for (const item of raw ?? []) {
+        if (isEffect(item))
+            selected.add(item);
+    }
+    return EFFECT_ORDER.filter((effect) => selected.has(effect));
+}
+export function elevatedEffects(effects) {
+    return effects.filter((effect) => effect !== "read");
+}
+export function hasElevatedEffects(effects) {
+    return elevatedEffects(effects).length > 0;
+}
+export function toolsForEffects(effects) {
+    const tools = new Set();
+    for (const effect of normalizeEffects(effects)) {
+        for (const tool of TOOLS_BY_EFFECT[effect])
+            tools.add(tool);
+    }
+    return [...tools];
+}
+export function formatEffects(effects) {
+    return normalizeEffects(effects).join(", ");
+}
+//# sourceMappingURL=effects.js.map

package/dist/src/orchestration/effects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"effects.js","sourceRoot":"","sources":["../../../src/orchestration/effects.ts"],"names":[],"mappings":"AAEA,MAAM,YAAY,GAAsB,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;AACpF,MAAM,UAAU,GAAG,IAAI,GAAG,CAAS,YAAY,CAAC,CAAC;AAEjD,sEAAsE;AACtE,MAAM,eAAe,GAAsC;IACzD,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC;IACpC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,CAAC,MAAM,CAAC;IACjB,WAAW,EAAE,CAAC,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,UAAU,CAAC,GAAG,CAAC,KAAe,CAAC,CAAC;AACtE,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,gBAAgB,CAAC,GAAmC;IAClE,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAS,CAAC,MAAM,CAAC,CAAC,CAAC;IAC3C,KAAK,MAAM,IAAI,IAAI,GAAG,IAAI,EAAE,EAAE,CAAC;QAC7B,IAAI,QAAQ,CAAC,IAAI,CAAC;YAAE,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAA0B;IACxD,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,OAA0B;IAC3D,OAAO,eAAe,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAA0B;IACxD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,KAAK,MAAM,MAAM,IAAI,gBAAgB,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/C,KAAK,MAAM,IAAI,IAAI,eAAe,CAAC,MAAM,CAAC;YAAE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAA0B;IACtD,OAAO,gBAAgB,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC9C,CAAC"}

package/dist/src/orchestration/personas.d.ts

@@ -1,3 +1,4 @@
+import type { Effect } from "../core/contracts.js";
 import type { AgentRole, Plan } from "./contracts.js";
 export interface CustomPersona {
     id: string;
@@ -5,7 +6,7 @@ export interface CustomPersona {
     role: AgentRole;
     prompt: string;
     path: string;
-    allowedEffects: readonly ["read"];
+    allowedEffects: Effect[];
 }
 export declare function loadCustomPersonas(root: string): Promise<CustomPersona[]>;
 export declare function customPersonaPlan(runId: string, objective: string, personas: readonly CustomPersona[]): Plan;

package/dist/src/orchestration/personas.js

@@ -2,6 +2,7 @@ import { lstat, readFile, readdir } from "node:fs/promises";
 import { join } from "node:path";
 import { parseCreatedFrontmatter } from "../creation/service.js";
 import { assertSafeProjectPath } from "../project/paths.js";
+import { normalizeEffects } from "./effects.js";
 const ROLES = new Set(["planner", "researcher", "analyst", "critic", "writer", "verifier"]);
 export async function loadCustomPersonas(root) {
     const directory = await assertSafeProjectPath(root, ".psyclaw/agents/custom");
@@ -20,13 +21,11 @@ export async function loadCustomPersonas(root) {
             const id = metadata.id;
             const label = metadata.label;
             const role = metadata.role;
-            const effects = metadata.allowedEffects;
             if (metadata.schemaVersion !== "psyclaw/agent-persona/v1" || typeof id !== "string" || typeof label !== "string" || typeof role !== "string" || !ROLES.has(role))
                 continue;
-            if (!Array.isArray(effects) || effects.length !== 1 || effects[0] !== "read")
-                continue;
+            const allowedEffects = normalizeEffects(Array.isArray(metadata.allowedEffects) ? metadata.allowedEffects : ["read"]);
             const prompt = text.replace(/^---\s*\n[\s\S]*?\n---\s*/, "").trim();
-            personas.push({ id, label, role: role, prompt, path, allowedEffects: ["read"] });
+            personas.push({ id, label, role: role, prompt, path, allowedEffects });
         }
         catch { /* malformed or raced optional persona: skip this file only */ }
     }
@@ -36,10 +35,24 @@ export function customPersonaPlan(runId, objective, personas) {
     if (personas.length < 1 || personas.length > 4)
         throw new Error("select between one and four custom subagents");
     const tasks = personas.map((persona) => ({
-        id: persona.id, role: persona.role, objective: `${persona.prompt}\n\nBounded task: ${objective}`, deps: [], ownedPaths: [], parallelSafe: true,
-        inputs: [], outputs: [], allowedEffects: ["read"], completionContract: { requiredArtifacts: [], requiredReceiptEffects: [], mustPassGates: [] },
+        id: persona.id,
+        role: persona.role,
+        objective: `${persona.prompt}\n\nBounded task: ${objective}`,
+        deps: [],
+        ownedPaths: [],
+        parallelSafe: true,
+        inputs: [],
+        outputs: [],
+        allowedEffects: [...persona.allowedEffects],
+        completionContract: { requiredArtifacts: [], requiredReceiptEffects: [], mustPassGates: [] },
     }));
-    return { schemaVersion: "psyclaw/plan/v1", runId, tasks, budget: { maxTurns: tasks.length, maxWorkers: tasks.length }, horizon: { strategy: "hierarchical-plan-act-reflect", maxIterations: tasks.length, reflectionEvery: 1 } };
+    return {
+        schemaVersion: "psyclaw/plan/v1",
+        runId,
+        tasks,
+        budget: { maxTurns: tasks.length, maxWorkers: tasks.length },
+        horizon: { strategy: "hierarchical-plan-act-reflect", maxIterations: tasks.length, reflectionEvery: 1 },
+    };
 }
 export function parseAgentsRequest(input) {
     const trimmed = input.trim();

package/dist/src/orchestration/personas.js.map

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

package/dist/src/orchestration/pi-executor.d.ts

@@ -8,16 +8,20 @@ export interface PiExecutorOptions {
     agentDir?: string;
     env?: Record<string, string>;
     timeoutMs?: number;
-    tools?: readonly ("read" | "grep" | "find" | "ls")[];
+    tools?: readonly string[];
+    /** Host ceilings after interactive approval. */
+    allowWrites?: boolean;
+    allowNetwork?: boolean;
+    allowDestructive?: boolean;
     onEvent?: (event: RunnerEvent) => void | Promise<void>;
     pauseRequested?: () => boolean | Promise<boolean>;
 }
 /**
- * Execute one task in a separate Pi process with extensions, skills, context
- * files and all mutating tools disabled. This is a process boundary, not a
- * complete OS sandbox; deployments needing hostile-code isolation must add a
- * container or equivalent runtime policy.
+ * Execute one task in a separate Pi process. Mutating tools are available only
+ * when the host options explicitly approve matching effects after user confirm.
  */
+export declare function createPiWorkerExecutor(options: PiExecutorOptions): WorkerExecutor;
+/** @deprecated Prefer createPiWorkerExecutor; kept as the read-only default alias. */
 export declare function createPiReadOnlyExecutor(options: PiExecutorOptions): WorkerExecutor;
 export declare function runPlanWithPi(plan: Parameters<BoundedOrchestrator["run"]>[0], options?: PiExecutorOptions & {
     root?: string;

package/dist/src/orchestration/pi-executor.js

@@ -1,5 +1,6 @@
 import { BoundedOrchestrator, } from "./runner.js";
 import { PiRpcClient } from "../adapters/pi/rpc.js";
+import { formatEffects, hasElevatedEffects, normalizeEffects, toolsForEffects } from "./effects.js";
 function blockedReport(task, context, summary) {
     return {
         schemaVersion: "psyclaw/worker-report/v1",
@@ -44,7 +45,7 @@ function extractJson(text) {
         }
     }
 }
-function parseWorkerReport(value, task, context) {
+function parseWorkerReport(value, task, context, allowFilesModified) {
     if (!value || typeof value !== "object")
         return undefined;
     const record = value;
@@ -62,7 +63,7 @@ function parseWorkerReport(value, task, context) {
         return undefined;
     if (!Array.isArray(record.verification))
         return undefined;
-    if (record.filesModified.length > 0)
+    if (!allowFilesModified && record.filesModified.length > 0)
         return undefined;
     return {
         schemaVersion: "psyclaw/worker-report/v1",
@@ -70,7 +71,7 @@ function parseWorkerReport(value, task, context) {
         dispatchId: context.dispatchId,
         outcome: record.outcome,
         summary: record.summary,
-        filesModified: [],
+        filesModified: record.filesModified,
         verification: record.verification.filter((item) => {
             if (!item || typeof item !== "object")
                 return false;
@@ -92,31 +93,54 @@ function lastAssistantText(events) {
     }
     return undefined;
 }
-function taskPrompt(task, context) {
+function taskPrompt(task, context, effects) {
+    const elevated = hasElevatedEffects(effects);
     return [
-        "You are a read-only psyclaw research worker.",
-        "Do not write, edit, delete, execute shell commands, access network services, or modify credentials.",
-        "Inspect only the supplied task inputs and project files with read/grep/find/ls.",
+        elevated
+            ? `You are a psyclaw research worker with explicitly approved effects: ${formatEffects(effects)}.`
+            : "You are a read-only psyclaw research worker.",
+        elevated
+            ? "Stay within the approved effects. Do not read credentials or bypass project gates."
+            : "Do not write, edit, delete, execute shell commands, access network services, or modify credentials.",
+        elevated
+            ? "Use only the tools enabled for this run."
+            : "Inspect only the supplied task inputs and project files with read/grep/find/ls.",
         "At the end return ONLY one JSON object matching this schema:",
         '{"schemaVersion":"psyclaw/worker-report/v1","taskId":"...","dispatchId":"...","outcome":"succeeded|blocked|failed","summary":"...","filesModified":[],"verification":[{"command":"...","exitCode":0}],"blockers":[]}',
         `taskId=${task.id}`,
         `dispatchId=${context.dispatchId}`,
         `objective=${task.objective}`,
         `inputs=${JSON.stringify(task.inputs)}`,
+        `allowedEffects=${JSON.stringify(effects)}`,
     ].join("\n");
 }
+function hostAllowsTaskEffects(effects, options) {
+    for (const effect of effects) {
+        if (effect === "read")
+            continue;
+        if (effect === "write" && options.allowWrites !== true)
+            return false;
+        if (effect === "network" && options.allowNetwork !== true)
+            return false;
+        if (effect === "destructive" && options.allowDestructive !== true)
+            return false;
+    }
+    return true;
+}
 /**
- * Execute one task in a separate Pi process with extensions, skills, context
- * files and all mutating tools disabled. This is a process boundary, not a
- * complete OS sandbox; deployments needing hostile-code isolation must add a
- * container or equivalent runtime policy.
+ * Execute one task in a separate Pi process. Mutating tools are available only
+ * when the host options explicitly approve matching effects after user confirm.
  */
-export function createPiReadOnlyExecutor(options) {
+export function createPiWorkerExecutor(options) {
     return async (task, context) => {
-        const effects = task.allowedEffects ?? ["read"];
-        if (effects.some((effect) => effect !== "read")) {
-            return { report: blockedReport(task, context, "Pi read-only executor cannot run side-effecting tasks") };
+        const effects = normalizeEffects(task.allowedEffects);
+        if (!hostAllowsTaskEffects(effects, options)) {
+            return {
+                report: blockedReport(task, context, `Task effects [${formatEffects(effects)}] exceed approved host ceilings`),
+            };
         }
+        const elevated = hasElevatedEffects(effects);
+        const tools = options.tools ?? toolsForEffects(effects);
         const client = new PiRpcClient({
             cwd: options.cwd,
             ...(options.cliPath === undefined ? {} : { cliPath: options.cliPath }),
@@ -126,12 +150,13 @@ export function createPiReadOnlyExecutor(options) {
             ...(options.agentDir === undefined ? {} : { agentDir: options.agentDir }),
             ...(options.env === undefined ? {} : { env: options.env }),
             ...(options.timeoutMs === undefined ? {} : { timeoutMs: options.timeoutMs }),
-            tools: options.tools ?? ["read", "grep", "find", "ls"],
+            tools,
+            ...(elevated ? { allowElevatedTools: true } : {}),
         });
         try {
             await client.start();
-            const events = await client.promptAndWait(taskPrompt(task, context), options.timeoutMs);
-            const report = parseWorkerReport(extractJson(lastAssistantText(events) ?? ""), task, context);
+            const events = await client.promptAndWait(taskPrompt(task, context, effects), options.timeoutMs);
+            const report = parseWorkerReport(extractJson(lastAssistantText(events) ?? ""), task, context, effects.includes("write"));
             if (!report)
                 return { report: blockedReport(task, context, "Worker did not return a valid structured report") };
             return { report };
@@ -144,24 +169,32 @@ export function createPiReadOnlyExecutor(options) {
         }
     };
 }
+/** @deprecated Prefer createPiWorkerExecutor; kept as the read-only default alias. */
+export function createPiReadOnlyExecutor(options) {
+    return createPiWorkerExecutor({ ...options, allowWrites: false, allowNetwork: false, allowDestructive: false });
+}
 export async function runPlanWithPi(plan, options = { cwd: process.cwd() }) {
-    const executor = createPiReadOnlyExecutor(options);
+    const executor = createPiWorkerExecutor(options);
     return new BoundedOrchestrator({
         executor,
         root: options.root ?? options.cwd,
         ...(options.maxWorkers === undefined ? {} : { maxWorkers: options.maxWorkers }),
-        allowWrites: false,
+        allowWrites: options.allowWrites === true,
+        allowNetwork: options.allowNetwork === true,
+        allowDestructive: options.allowDestructive === true,
         ...(options.pauseRequested === undefined ? {} : { pauseRequested: options.pauseRequested }),
         ...(options.onEvent === undefined ? {} : { onEvent: options.onEvent }),
     }).run(plan);
 }
 export async function resumePlanWithPi(plan, options = { cwd: process.cwd() }) {
-    const executor = createPiReadOnlyExecutor(options);
+    const executor = createPiWorkerExecutor(options);
     return new BoundedOrchestrator({
         executor,
         root: options.root ?? options.cwd,
         ...(options.maxWorkers === undefined ? {} : { maxWorkers: options.maxWorkers }),
-        allowWrites: false,
+        allowWrites: options.allowWrites === true,
+        allowNetwork: options.allowNetwork === true,
+        allowDestructive: options.allowDestructive === true,
         ...(options.pauseRequested === undefined ? {} : { pauseRequested: options.pauseRequested }),
         ...(options.onEvent === undefined ? {} : { onEvent: options.onEvent }),
     }).resume(plan);

package/dist/src/orchestration/pi-executor.js.map

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

package/dist/src/orchestration/research-agents.d.ts

@@ -1,13 +1,9 @@
 import type { ResearchProject } from "../core/contracts.js";
-import type { TaskNode, WorkerReport } from "./contracts.js";
+import type { WorkerReport } from "./contracts.js";
 import { type PiExecutorOptions } from "./pi-executor.js";
+import { type BundledPersonaDefinition } from "./bundled-personas.js";
 export type ResearchAgentMode = "literature" | "review";
-interface PersonaDefinition {
-    id: string;
-    label: string;
-    role: TaskNode["role"];
-    instructions: string;
-}
+type PersonaDefinition = BundledPersonaDefinition;
 export interface MultiAgentRunOptions extends Pick<PiExecutorOptions, "provider" | "model" | "env" | "timeoutMs"> {
     root: string;
     project: ResearchProject;

package/dist/src/orchestration/research-agents.js

@@ -5,77 +5,13 @@ import { assertSafeProjectPath, projectPaths } from "../project/paths.js";
 import { readManuscript } from "../project/manuscript.js";
 import { searchOpenAlex } from "../workflows/meta-analysis.js";
 import { runPlanWithPi } from "./pi-executor.js";
-const LITERATURE_PERSONAS = [
-    {
-        id: "landscape-mapper",
-        label: "研究版图分析者",
-        role: "researcher",
-        instructions: "梳理研究主题、年代分布、代表性论文和研究方向。只依据提供的可核验元数据与摘要，不得补造论文内容。",
-    },
-    {
-        id: "methods-scout",
-        label: "方法学分析者",
-        role: "analyst",
-        instructions: "识别文献中的研究设计、测量与分析线索，指出仅凭元数据无法判断之处，不得把推测写成研究事实。",
-    },
-    {
-        id: "evidence-critic",
-        label: "证据批判者",
-        role: "critic",
-        instructions: "检查证据强弱、潜在偏倚、相互冲突与因果边界，明确区分检索结果、摘要信息和进一步需要全文核验的主张。",
-    },
-    {
-        id: "gap-finder",
-        label: "研究缺口分析者",
-        role: "verifier",
-        instructions: "寻找尚未充分覆盖的问题、对象、情境和方法，并把真正的证据缺口与单纯的检索缺口分开。",
-    },
-];
-const REVIEW_PERSONAS = [
-    {
-        id: "theory-reviewer",
-        label: "理论与贡献审稿人",
-        role: "critic",
-        instructions: "以匿名同行评审标准检查问题重要性、理论定位、创新性、主张与证据的一致性。给出带稿件定位的主要与次要意见。",
-    },
-    {
-        id: "methods-reviewer",
-        label: "研究设计审稿人",
-        role: "analyst",
-        instructions: "检查抽样、设计、测量、效度、探索与确证边界、因果推断边界以及方法与问题的适配性。",
-    },
-    {
-        id: "statistics-reviewer",
-        label: "统计与可复现性审稿人",
-        role: "verifier",
-        instructions: "检查分析策略、效应量、置信区间、缺失值、稳健性、图表和可复现信息。不得重新计算或虚构任何统计量。",
-    },
-    {
-        id: "ethics-editorial-reviewer",
-        label: "伦理与编辑审稿人",
-        role: "writer",
-        instructions: "检查伦理、隐私、透明报告、引用表达、结构与可读性，并给出可执行但不直接改稿的建议。",
-    },
-];
-function personaMarkdown(persona) {
-    return [
-        "---",
-        "schemaVersion: psyclaw/agent-persona/v1",
-        `id: ${persona.id}`,
-        `label: ${persona.label}`,
-        "---",
-        "",
-        `# ${persona.label}`,
-        "",
-        persona.instructions,
-        "",
-        "所有判断必须标明依据和不确定性；不得虚构引用、数据、统计结果或稿件中不存在的内容。",
-        "",
-    ].join("\n");
+import { bundledPersonasForPack, personaMarkdown, } from "./bundled-personas.js";
+function personaFile(persona) {
+    return personaMarkdown(persona);
 }
 /** Create only the personas needed for the requested workflow. Existing files are user-owned and remain unchanged. */
 export async function ensureResearchAgentPersonas(root, mode) {
-    const definitions = mode === "literature" ? LITERATURE_PERSONAS : REVIEW_PERSONAS;
+    const definitions = bundledPersonasForPack(mode);
     const directory = await assertSafeProjectPath(root, `.psyclaw/agents/${mode}`);
     await mkdir(directory, { recursive: true });
     const loaded = [];
@@ -88,7 +24,7 @@ export async function ensureResearchAgentPersonas(root, mode) {
         catch (error) {
             if (error.code !== "ENOENT")
                 throw error;
-            const prompt = personaMarkdown(persona);
+            const prompt = personaFile(persona);
             await atomicWriteFile(path, prompt);
             loaded.push({ ...persona, prompt });
         }