@nowcrew/daemon 0.5.19 → 0.5.21

package/dist/computer-profile.js

@@ -1,10 +1,13 @@
 import { access, chmod, mkdir, readFile, readdir, rename, rm, stat, writeFile } from "node:fs/promises";
 import { constants } from "node:fs";
+import { realpathSync } from "node:fs";
 import { homedir } from "node:os";
-import { dirname, resolve } from "node:path";
+import { dirname, posix, resolve, win32 } from "node:path";
 import { randomUUID } from "node:crypto";
 import { spawn } from "node:child_process";
 import { z } from "zod";
+import { acquireProfileSaveLock, } from "./computer-profile-lock.js";
+import { formatDaemonText } from "./i18n.js";
 const PROFILE_NAME = /^[a-z0-9][a-z0-9_-]{0,47}$/;
 const ServerUrlSchema = z.string().url().max(2048).refine((value) => {
     const url = new URL(value);
@@ -18,6 +21,11 @@ const ProfileSchema = z.object({
     agentsRoot: z.string().min(1).optional(),
     runtimePath: z.string().min(1).max(32768).refine((value) => !value.includes("\0") && !value.includes("\n") && !value.includes("\r"), "runtimePath must be a single line").optional(),
 }).strict();
+const ProfileAgentsRootCandidateSchema = ProfileSchema.pick({
+    name: true,
+    serverUrl: true,
+    agentsRoot: true,
+}).strict();
 const StoredPlainProfileSchema = ProfileSchema;
 const StoredProtectedProfileSchema = ProfileSchema.omit({ machineToken: true }).extend({
     machineTokenProtected: z.object({
@@ -26,9 +34,93 @@ const StoredProtectedProfileSchema = ProfileSchema.omit({ machineToken: true }).
     }).strict(),
 }).strict();
 const StoredProfileSchema = z.union([StoredPlainProfileSchema, StoredProtectedProfileSchema]);
+export const PROFILE_AGENTS_ROOT_CONFLICT_MESSAGE = "Profile '{{profile}}' conflicts with profile '{{conflict}}': both resolve to agents root '{{agentsRoot}}'. Save it with a unique root, for example: {{command}}";
+export class ProfileAgentsRootConflictError extends Error {
+    profile;
+    conflict;
+    agentsRoot;
+    command;
+    constructor(input) {
+        const quote = input.platform === "win32" ? quotePowerShellArgument : quotePosixArgument;
+        const pathApi = input.platform === "win32" ? win32 : posix;
+        const suggestedRoot = resolveAgentsRoot(pathApi.join(input.userHome, ".crew", `agents-${input.profile}`), input.userHome, input.platform);
+        const command = [
+            "crew-daemon profile save",
+            quote(input.profile),
+            "--server-url",
+            quote(input.serverUrl),
+            "--agents-root",
+            quote(suggestedRoot),
+            "--token-stdin",
+        ].join(" ");
+        super(formatDaemonText("en", PROFILE_AGENTS_ROOT_CONFLICT_MESSAGE, {
+            profile: input.profile,
+            conflict: input.conflict,
+            agentsRoot: input.agentsRoot,
+            command,
+        }));
+        this.name = "ProfileAgentsRootConflictError";
+        this.profile = input.profile;
+        this.conflict = input.conflict;
+        this.agentsRoot = input.agentsRoot;
+        this.command = command;
+    }
+}
+const quotePosixArgument = (value) => `'${value.replaceAll("'", `'"'"'`)}'`;
+const quotePowerShellArgument = (value) => `'${value.replaceAll("'", "''")}'`;
 export function daemonHome(env = process.env) {
     return resolve(env.CREW_DAEMON_HOME ?? resolve(homedir(), ".crew/daemon"));
 }
+export function resolveAgentsRoot(configured, userHome = homedir(), platform = process.platform) {
+    const pathApi = platform === "win32" ? win32 : posix;
+    const normalizedHome = pathApi.resolve(userHome);
+    if (configured === undefined)
+        return canonicalizeRoot(pathApi.resolve(normalizedHome, ".crew", "agents"), platform);
+    const expanded = configured === "~"
+        ? normalizedHome
+        : configured.startsWith("~/") || (platform === "win32" && configured.startsWith("~\\"))
+            ? pathApi.resolve(normalizedHome, configured.slice(2))
+            : configured;
+    return canonicalizeRoot(pathApi.resolve(expanded), platform);
+}
+function canonicalizeRoot(path, platform) {
+    const compatibleHost = (platform === "win32") === (process.platform === "win32");
+    if (!compatibleHost)
+        return path;
+    try {
+        return realpathSync.native(path);
+    }
+    catch (error) {
+        const code = error.code;
+        if (code === "ENOTDIR")
+            return path;
+        if (code !== "ENOENT")
+            throw error;
+    }
+    const pathApi = platform === "win32" ? win32 : posix;
+    const missingSegments = [];
+    let ancestor = path;
+    for (;;) {
+        const parent = pathApi.dirname(ancestor);
+        if (parent === ancestor)
+            return path;
+        missingSegments.unshift(pathApi.basename(ancestor));
+        ancestor = parent;
+        try {
+            return pathApi.resolve(realpathSync.native(ancestor), ...missingSegments);
+        }
+        catch (error) {
+            const code = error.code;
+            if (code === "ENOTDIR")
+                return path;
+            if (code !== "ENOENT")
+                throw error;
+        }
+    }
+}
+function comparableAgentsRoot(path, platform) {
+    return platform === "win32" ? win32.normalize(path).toLocaleLowerCase("en-US") : path;
+}
 export function validateProfileName(name) {
     if (!PROFILE_NAME.test(name)) {
         throw new Error("profile name must match [a-z0-9][a-z0-9_-]{0,47}");
@@ -87,29 +179,74 @@ function storageOptions(options) {
         ...(options.harden ? { harden: options.harden } : {}),
     };
 }
+function attachCleanupError(primaryError, cleanupError) {
+    try {
+        if (!(primaryError instanceof Error)
+            || !Object.isExtensible(primaryError)
+            || Object.prototype.hasOwnProperty.call(primaryError, "cleanupError"))
+            return;
+        Object.defineProperty(primaryError, "cleanupError", {
+            configurable: true,
+            value: cleanupError,
+        });
+    }
+    catch {
+        // Preserve the primary error even when it cannot accept diagnostics.
+    }
+}
 export async function saveProfile(input, home = daemonHome(), options = {}) {
     const profile = ProfileSchema.parse({ version: 1, ...input });
     const configured = storageOptions(options);
-    if (configured.platform === "win32") {
-        if (!configured.protector)
-            throw new Error("Windows profile storage requires CurrentUser DPAPI");
-        if (!configured.harden)
-            throw new Error("Windows profile storage requires ACL hardening");
-        const ciphertext = await configured.protector.protect(profile.machineToken);
-        if (!ciphertext)
-            throw new Error("Windows DPAPI returned an empty ciphertext");
-        const stored = StoredProtectedProfileSchema.parse({
-            version: 1,
-            name: profile.name,
-            serverUrl: profile.serverUrl,
-            ...(profile.agentsRoot ? { agentsRoot: profile.agentsRoot } : {}),
-            ...(profile.runtimePath ? { runtimePath: profile.runtimePath } : {}),
-            machineTokenProtected: { scheme: "dpapi-current-user", ciphertext },
-        });
-        await atomicPrivateWrite(profilePath(profile.name, home), `${JSON.stringify(stored, null, 2)}\n`, configured.harden);
+    const release = await acquireProfileSaveLock(resolve(home, "profiles"), {
+        ...(options.lockTimeoutMs === undefined ? {} : { timeoutMs: options.lockTimeoutMs }),
+        ...(options.lockRetryMs === undefined ? {} : { retryMs: options.lockRetryMs }),
+        ...(options.lockNow === undefined ? {} : { now: options.lockNow }),
+        ...(options.lockWait === undefined ? {} : { wait: options.lockWait }),
+        ...(options.lockProcessController === undefined
+            ? {}
+            : { processController: options.lockProcessController }),
+        ...(options.lockHooks === undefined ? {} : { hooks: options.lockHooks }),
+    });
+    let bodyFailed = false;
+    let bodyError;
+    try {
+        await assertProfileAgentsRootUnique(profile, home, options.userHome ?? homedir(), options);
+        if (configured.platform === "win32") {
+            if (!configured.protector)
+                throw new Error("Windows profile storage requires CurrentUser DPAPI");
+            if (!configured.harden)
+                throw new Error("Windows profile storage requires ACL hardening");
+            const ciphertext = await configured.protector.protect(profile.machineToken);
+            if (!ciphertext)
+                throw new Error("Windows DPAPI returned an empty ciphertext");
+            const stored = StoredProtectedProfileSchema.parse({
+                version: 1,
+                name: profile.name,
+                serverUrl: profile.serverUrl,
+                ...(profile.agentsRoot ? { agentsRoot: profile.agentsRoot } : {}),
+                ...(profile.runtimePath ? { runtimePath: profile.runtimePath } : {}),
+                machineTokenProtected: { scheme: "dpapi-current-user", ciphertext },
+            });
+            await atomicPrivateWrite(profilePath(profile.name, home), `${JSON.stringify(stored, null, 2)}\n`, configured.harden);
+        }
+        else {
+            await atomicPrivateWrite(profilePath(profile.name, home), `${JSON.stringify(profile, null, 2)}\n`);
+        }
     }
-    else {
-        await atomicPrivateWrite(profilePath(profile.name, home), `${JSON.stringify(profile, null, 2)}\n`);
+    catch (error) {
+        bodyFailed = true;
+        bodyError = error;
+        throw error;
+    }
+    finally {
+        try {
+            await release();
+        }
+        catch (cleanupError) {
+            if (!bodyFailed)
+                throw cleanupError;
+            attachCleanupError(bodyError, cleanupError);
+        }
     }
     return profile;
 }
@@ -161,6 +298,38 @@ export async function listProfiles(home = daemonHome()) {
         throw error;
     }
 }
+export async function inspectProfileAgentsRoot(profile, home = daemonHome(), userHome = homedir(), options = {}) {
+    const platform = storageOptions(options).platform;
+    const agentsRoot = resolveAgentsRoot(profile.agentsRoot, userHome, platform);
+    const comparableRoot = comparableAgentsRoot(agentsRoot, platform);
+    const names = (await listProfiles(home)).filter((name) => name !== profile.name);
+    const profiles = await Promise.all(names.map((name) => loadProfile(name, home, options)));
+    return {
+        agentsRoot,
+        duplicateProfiles: profiles
+            .filter((candidate) => comparableAgentsRoot(resolveAgentsRoot(candidate.agentsRoot, userHome, platform), platform) === comparableRoot)
+            .map((candidate) => candidate.name),
+    };
+}
+export async function assertProfileAgentsRootUnique(profile, home = daemonHome(), userHome = homedir(), options = {}) {
+    const candidate = ProfileAgentsRootCandidateSchema.parse({
+        name: profile.name,
+        serverUrl: profile.serverUrl,
+        ...(profile.agentsRoot === undefined ? {} : { agentsRoot: profile.agentsRoot }),
+    });
+    const inspection = await inspectProfileAgentsRoot(candidate, home, userHome, options);
+    const conflict = inspection.duplicateProfiles[0];
+    if (conflict === undefined)
+        return;
+    throw new ProfileAgentsRootConflictError({
+        profile: candidate.name,
+        conflict,
+        agentsRoot: inspection.agentsRoot,
+        serverUrl: candidate.serverUrl,
+        userHome,
+        platform: storageOptions(options).platform,
+    });
+}
 export async function removeProfile(name, home = daemonHome()) {
     await rm(profilePath(name, home), { force: true });
 }

package/dist/config.js

@@ -4,6 +4,7 @@ import { dirname, resolve } from "node:path";
 import { homedir } from "node:os";
 import { createRequire } from "node:module";
 import { detectDaemonLang, translateDaemon } from "./i18n.js";
+import { resolveAgentsRoot } from "./computer-profile.js";
 export const DEFAULT_EXECUTION_LIMITS = Object.freeze({
     maxPromptBytes: 256_000,
     maxTimeoutMs: 3_600_000,
@@ -65,7 +66,7 @@ export function loadConfig(env = process.env) {
     return {
         serverUrl,
         machineToken,
-        agentsRoot: env.CREW_AGENTS_ROOT ?? resolve(homedir(), ".crew/agents"),
+        agentsRoot: resolveAgentsRoot(env.CREW_AGENTS_ROOT, homedir()),
         cliPath: env.CREW_CLI_PATH ?? defaultCliPath(),
         runtimeBin: env.CREW_RUNTIME ?? "claude",
         dangerous: env.CREW_RUNTIME_SAFE !== "1", // 默认开启 (headless agent 在自有 workspace 内运行)

package/dist/console.js

@@ -5,14 +5,24 @@
  * 做**原文透传**——保留思考文本、工具调用、工具返回正文,尽量还原原生 claude CLI 的观感。
  * 纯函数,无 IO,完整单测。
  *
- * 注:本转换器针对 claude 的 stream-json。codex 的 stream 格式不同,后续按 runtime 分派扩展;
- * 前端/server 消费的 ConsoleChunk 形状是 runtime 无关的。
+ * 除纯文本 text 外,可识别的工具调用(Edit/Write/Bash/TodoWrite/ExitPlanMode/Task…)
+ * 会附带结构化 payload(diff/命令/todo 清单/计划…),供前端做富渲染(红绿 diff、清单勾选);
+ * 前端不识别 payload.kind 时降级为纯文本行,协议向后兼容。
+ *
+ * 覆盖三种 runtime 的流:claude(stream-json)、codex(exec --json 的 item.* 事件)、
+ * kimi(OpenAI 消息风格行)。
  */
 import { detectDaemonLang, translateDaemon } from "./i18n.js";
 /** 单条工具返回正文上限(超出截断并标注),避免单条把终端/DB 撑爆。 */
 export const TOOL_RESULT_CAP = 4000;
 /** 工具输入摘要上限(标题行那一段)。 */
 const TOOL_INPUT_CAP = 160;
+/** payload 里单段文本(diff 单侧/plan/命令)上限:富渲染要保留足够内容,但不能无界。 */
+export const PAYLOAD_TEXT_CAP = 4000;
+/** todo 清单条数上限。 */
+const TODOS_MAX = 50;
+/** MultiEdit 拆分出的 diff 块上限。 */
+const MULTI_EDIT_MAX = 20;
 /** kimi 工具 arguments(JSON 字符串)容错解析为对象;失败返回 undefined。 */
 function parseKimiToolArgs(args) {
     if (!args)
@@ -25,19 +35,106 @@ function parseKimiToolArgs(args) {
         return undefined;
     }
 }
-/** 把工具输入压成一行摘要:Bash 取 command,其它取首个字符串字段或紧凑 JSON。 */
+/** 把工具输入压成一行摘要:Bash 取 command,文件类工具取路径,其它取首个字符串字段或紧凑 JSON。 */
 function summarizeToolInput(name, input) {
     if (!input)
         return `⏺ ${name}`;
     if (name === "Bash" && typeof input.command === "string") {
         return `⏺ Bash(${clip(input.command.replace(/\s+/g, " "), TOOL_INPUT_CAP)})`;
     }
+    // 文件编辑类:old/new 全文在 payload 里富渲染,摘要只报文件路径,不把整段代码挤进标题行。
+    if ((name === "Edit" || name === "Write" || name === "MultiEdit") && typeof input.file_path === "string") {
+        return `⏺ ${name}(${clip(input.file_path, TOOL_INPUT_CAP)})`;
+    }
+    if (name === "TodoWrite" && Array.isArray(input.todos)) {
+        return `⏺ TodoWrite(${input.todos.length})`;
+    }
+    if (name === "ExitPlanMode")
+        return `⏺ ExitPlanMode`;
     const entries = Object.entries(input);
     const head = entries
         .map(([k, v]) => `${k}: ${typeof v === "string" ? v : JSON.stringify(v)}`)
         .join(", ");
     return `⏺ ${name}(${clip(head.replace(/\s+/g, " "), TOOL_INPUT_CAP)})`;
 }
+const TODO_STATUSES = new Set(["pending", "in_progress", "completed"]);
+/** claude TodoWrite 的 todos 数组归一为 ConsoleTodo[](脏数据条目丢弃)。 */
+function normalizeTodos(raw) {
+    if (!Array.isArray(raw))
+        return [];
+    const out = [];
+    for (const t of raw.slice(0, TODOS_MAX)) {
+        if (!t || typeof t !== "object")
+            continue;
+        const rec = t;
+        const text = typeof rec.content === "string" && rec.content.trim()
+            ? rec.content.trim()
+            : typeof rec.subject === "string" ? rec.subject.trim() : "";
+        if (!text)
+            continue;
+        const status = typeof rec.status === "string" && TODO_STATUSES.has(rec.status)
+            ? rec.status
+            : "pending";
+        out.push({ text: clip(text, TOOL_INPUT_CAP), status });
+    }
+    return out;
+}
+function diffPayload(file, oldText, newText) {
+    return {
+        kind: "diff",
+        file,
+        oldText: clip(typeof oldText === "string" ? oldText : "", PAYLOAD_TEXT_CAP),
+        newText: clip(typeof newText === "string" ? newText : "", PAYLOAD_TEXT_CAP),
+    };
+}
+/** 已识别工具 → 结构化 payload;其余返回 undefined(仅纯文本摘要)。 */
+function toolPayload(name, input) {
+    if (!input)
+        return undefined;
+    if (name === "Bash" && typeof input.command === "string") {
+        return { kind: "command", command: clip(input.command, PAYLOAD_TEXT_CAP) };
+    }
+    if (name === "Edit" && typeof input.file_path === "string") {
+        return diffPayload(input.file_path, input.old_string, input.new_string);
+    }
+    if (name === "Write" && typeof input.file_path === "string" && typeof input.content === "string") {
+        return diffPayload(input.file_path, "", input.content);
+    }
+    if (name === "TodoWrite") {
+        const todos = normalizeTodos(input.todos);
+        if (todos.length)
+            return { kind: "todos", todos };
+    }
+    if (name === "ExitPlanMode" && typeof input.plan === "string" && input.plan.trim()) {
+        return { kind: "plan", plan: clip(input.plan.trim(), PAYLOAD_TEXT_CAP) };
+    }
+    if ((name === "Task" || name === "Agent") && typeof input.description === "string" && input.description.trim()) {
+        return { kind: "subagent", description: clip(input.description.trim(), TOOL_INPUT_CAP) };
+    }
+    return undefined;
+}
+/** 一个 tool_use 块 → 1..N 条 console 行(MultiEdit 拆成每处编辑一块 diff)。 */
+function toolUseChunks(name, input) {
+    if (name === "MultiEdit" && input && typeof input.file_path === "string" && Array.isArray(input.edits)) {
+        const file = input.file_path;
+        const chunks = [];
+        for (const ed of input.edits.slice(0, MULTI_EDIT_MAX)) {
+            if (!ed || typeof ed !== "object")
+                continue;
+            const rec = ed;
+            chunks.push({
+                stream: "tool",
+                text: `⏺ Edit(${clip(file, TOOL_INPUT_CAP)})`,
+                payload: diffPayload(file, rec.old_string, rec.new_string),
+            });
+        }
+        if (chunks.length)
+            return chunks;
+    }
+    const text = summarizeToolInput(name, input);
+    const payload = toolPayload(name, input);
+    return [payload ? { stream: "tool", text, payload } : { stream: "tool", text }];
+}
 /** 把 tool_result 的 content(string | block[])抽成纯文本。 */
 function extractToolResult(content) {
     if (typeof content === "string")
@@ -53,6 +150,72 @@ function extractToolResult(content) {
 function clip(s, cap) {
     return s.length > cap ? s.slice(0, cap) + `… (+${s.length - cap})` : s;
 }
+/** codex exec --json 的 item.completed → console 行(agent_message/reasoning/命令/文件变更/todo…)。 */
+function codexItemChunks(item, td) {
+    if (item.type === "agent_message" && item.text?.trim()) {
+        return [{ stream: "text", text: item.text.trim() }];
+    }
+    if (item.type === "reasoning" && item.text?.trim()) {
+        return [{ stream: "thinking", text: item.text.trim() }];
+    }
+    if (item.type === "command_execution" && item.command?.trim()) {
+        const command = item.command.trim();
+        const out = [{
+                stream: "tool",
+                text: `⏺ Bash(${clip(command.replace(/\s+/g, " "), TOOL_INPUT_CAP)})`,
+                payload: {
+                    kind: "command",
+                    command: clip(command, PAYLOAD_TEXT_CAP),
+                    ...(typeof item.exit_code === "number" ? { exitCode: item.exit_code } : {}),
+                },
+            }];
+        const output = item.aggregated_output?.trim();
+        if (output)
+            out.push({ stream: "tool_result", text: clip(output, TOOL_RESULT_CAP) });
+        return out;
+    }
+    if (item.type === "file_change" && Array.isArray(item.changes)) {
+        const files = item.changes
+            .filter((c) => !!c && typeof c === "object")
+            .map((c) => ({
+            path: typeof c.path === "string" ? c.path : "",
+            change: typeof c.kind === "string" ? c.kind : "update",
+        }))
+            .filter((f) => f.path);
+        if (!files.length)
+            return [];
+        return [{
+                stream: "tool",
+                text: `⏺ ${td("Files changed")}: ${clip(files.map((f) => f.path).join(", "), TOOL_INPUT_CAP)}`,
+                payload: { kind: "files", files },
+            }];
+    }
+    if (item.type === "todo_list" && Array.isArray(item.items)) {
+        const todos = item.items
+            .filter((t) => !!t && typeof t === "object")
+            .slice(0, TODOS_MAX)
+            .map((t) => ({
+            text: clip(typeof t.text === "string" ? t.text.trim() : "", TOOL_INPUT_CAP),
+            status: (t.completed === true ? "completed" : "pending"),
+        }))
+            .filter((t) => t.text);
+        if (!todos.length)
+            return [];
+        const done = todos.filter((t) => t.status === "completed").length;
+        return [{ stream: "tool", text: `⏺ Todos(${done}/${todos.length})`, payload: { kind: "todos", todos } }];
+    }
+    if (item.type === "web_search" && item.query?.trim()) {
+        return [{ stream: "tool", text: `⏺ WebSearch(${clip(item.query.trim(), TOOL_INPUT_CAP)})` }];
+    }
+    if (item.type === "mcp_tool_call" && (item.tool || item.server)) {
+        const label = [item.server, item.tool].filter(Boolean).join(".");
+        return [{ stream: "tool", text: `⏺ MCP(${clip(label, TOOL_INPUT_CAP)})` }];
+    }
+    if (item.type === "error" && item.message?.trim()) {
+        return [{ stream: "error", text: item.message.trim() }];
+    }
+    return [];
+}
 /** 把一个 stream-json 事件转成 0..N 条 console 行(完全透传)。 */
 export function toConsoleLines(event) {
     const e = (event ?? {});
@@ -72,13 +235,16 @@ export function toConsoleLines(event) {
         return [{ stream: "system", text: `● ${td("Claude session started")}` }];
     }
     if (e.type === "thread.started") {
-        return [{ stream: "system", text: "● codex 会话启动" }];
+        return [{ stream: "system", text: `● ${td("Codex session started")}` }];
     }
-    if (e.type === "item.completed" && e.item?.type === "agent_message" && e.item.text?.trim()) {
-        return [{ stream: "text", text: e.item.text.trim() }];
+    if (e.type === "item.completed" && e.item) {
+        return codexItemChunks(e.item, td);
     }
     if (e.type === "turn.completed") {
-        return [{ stream: "result", text: "本轮结束" }];
+        return [{ stream: "result", text: td("Run finished") }];
+    }
+    if (e.type === "turn.failed") {
+        return [{ stream: "error", text: e.error?.message?.trim() || td("Run failed") }];
     }
     if (e.type === "result") {
         const text = e.result?.trim() || (e.is_error ? td("Run failed") : td("Run finished"));
@@ -94,7 +260,7 @@ export function toConsoleLines(event) {
                 out.push({ stream: "text", text: block.text.trim() });
             }
             else if (block.type === "tool_use" && block.name) {
-                out.push({ stream: "tool", text: summarizeToolInput(block.name, block.input) });
+                out.push(...toolUseChunks(block.name, block.input));
             }
         }
         return out;
@@ -119,7 +285,7 @@ export function toConsoleLines(event) {
         for (const call of Array.isArray(e.tool_calls) ? e.tool_calls : []) {
             const name = call.function?.name;
             if (name)
-                out.push({ stream: "tool", text: summarizeToolInput(name, parseKimiToolArgs(call.function?.arguments)) });
+                out.push(...toolUseChunks(name, parseKimiToolArgs(call.function?.arguments)));
         }
         return out;
     }

package/dist/daemon-startup-error.js

@@ -0,0 +1,30 @@
+import { formatDaemonText, } from "./i18n.js";
+const PROFILE_MESSAGE = "Daemon is already running (PID={{ownerPid}}) for agents root '{{agentsRoot}}'. Journal: '{{journalPath}}'. Do not delete the active journal lock. Stop the existing daemon before retrying. If this profile is managed as a service, use 'crew-daemon stop --profile {{profileName}}' or 'crew-daemon restart --profile {{profileName}}'.";
+const MANUAL_MESSAGE = "Daemon is already running (PID={{ownerPid}}) for agents root '{{agentsRoot}}'. Journal: '{{journalPath}}'. Do not delete the active journal lock. Stop the existing daemon before retrying. If it is managed as a service, use 'crew-daemon stop --profile <name>' or 'crew-daemon restart --profile <name>'.";
+export class DaemonAlreadyRunningError extends Error {
+    ownerPid;
+    agentsRoot;
+    journalPath;
+    serverUrl;
+    profileName;
+    constructor(details) {
+        super(`Daemon is already running (PID=${details.ownerPid})`, { cause: details.cause });
+        this.name = "DaemonAlreadyRunningError";
+        this.ownerPid = details.ownerPid;
+        this.agentsRoot = details.agentsRoot;
+        this.journalPath = details.journalPath;
+        this.serverUrl = details.serverUrl;
+        if (details.profileName !== undefined)
+            this.profileName = details.profileName;
+    }
+}
+export function formatDaemonStartupError(error, lang) {
+    if (!(error instanceof DaemonAlreadyRunningError))
+        return null;
+    return formatDaemonText(lang, error.profileName === undefined ? MANUAL_MESSAGE : PROFILE_MESSAGE, {
+        ownerPid: error.ownerPid,
+        agentsRoot: error.agentsRoot,
+        journalPath: error.journalPath,
+        ...(error.profileName === undefined ? {} : { profileName: error.profileName }),
+    });
+}

package/dist/execution-backend.js

@@ -1,11 +1,44 @@
+import { isJobObjectSupported } from "./win32-job-object.js";
+/** 灰度开关:默认关。只有显式打开且运行时探测成功,win32 才翻为 supported。 */
+const GRAYSCALE_ENV = "CREW_WINDOWS_JOB_OBJECT";
+function grayscaleEnabled() {
+    const flag = process.env[GRAYSCALE_ENV];
+    return flag === "1" || flag === "true";
+}
+let cachedProbe;
+/**
+ * 默认探测:灰度关 → 一律 false(行为与今日一致)。灰度开 → 同步探测 koffi/kernel32 一次并缓存。
+ * 同步实现(createRequire),因此 `executionBackendCapability` 保持同步,不波及 serve.ts 的同步调用链。
+ */
+function defaultJobObjectProbe() {
+    if (!grayscaleEnabled())
+        return false;
+    if (cachedProbe === undefined)
+        cachedProbe = isJobObjectSupported();
+    return cachedProbe;
+}
+const WINDOWS_UNAVAILABLE_REASON = "protocol-v1 is disabled until a Windows Job Object backend owns every runtime process";
 /** Durable execution needs ownership that survives daemon crashes, not only a best-effort kill. */
-export function executionBackendCapability(platform = process.platform) {
+export function executionBackendCapability(platform = process.platform, probe = defaultJobObjectProbe) {
     if (platform === "win32") {
+        if (probe())
+            return { supported: true, backend: "windows-job-object" };
         return {
             supported: false,
             backend: "windows-job-object-unavailable",
-            reason: "protocol-v1 is disabled until a Windows Job Object backend owns every runtime process",
+            reason: WINDOWS_UNAVAILABLE_REASON,
         };
     }
     return { supported: true, backend: "posix-process-group" };
 }
+/**
+ * supervisor child 是否应通过 Job Object 拥有 runtime 树。仅当 durable + win32 + Job Object 后端已选中时为真。
+ * legacy(process-lifetime)恒为 false —— 保证灰度关/koffi 不可用时 Windows legacy 执行完全不碰 Job,
+ * 维持今日的 taskkill 语义与 fail-closed 降级承诺。
+ */
+export function ownsRuntimeViaJobObject(ownershipMode, platform = process.platform, probe) {
+    if (ownershipMode !== "durable")
+        return false;
+    const backend = executionBackendCapability(platform, probe);
+    return backend.supported && backend.backend === "windows-job-object";
+}