@nowcrew/daemon 0.6.98-beta.3 → 0.6.98

package/dist/local-executor.js

@@ -962,17 +962,22 @@ async function executeLocalUnlocked(input, callbacks, dependencies) {
                 await writeFile(legacyCwdMarker, "1", "utf8");
             }
         }
+        const externalAnswer = runtime.name === "pi"
+            ? externalOutput.lastClosedBlock
+            : externalOutput.lastClosedBlock
+                ?? (finalText === null ? null : extractExternalAnswer(finalText));
+        const reportFinalText = runtime.name === "pi" && externalAnswer === null
+            ? null
+            : finalText;
         const cloudReportResult = exitCode === 0
             ? await deliverCloudReports({
-                facts: cloudReportUpload, ...reportRoots, before: reportSnapshot, finalText,
+                facts: cloudReportUpload, ...reportRoots, before: reportSnapshot, finalText: reportFinalText,
                 receiptFile: reportContext.receiptFile,
-                externalAnswer: externalOutput.lastClosedBlock
-                    ?? (finalText === null ? null : extractExternalAnswer(finalText)),
+                externalAnswer,
                 captureFinal: input.captureFinal, executionId: input.executionId, agentHandle: input.handle,
                 ...(dependencies.uploadCloudReports === undefined ? {} : { upload: dependencies.uploadCloudReports }),
             })
-            : { finalText, externalAnswer: externalOutput.lastClosedBlock
-                    ?? (finalText === null ? null : extractExternalAnswer(finalText)) };
+            : { finalText: reportFinalText, externalAnswer };
         memoryPruneExecutorCompleted = true;
         localMemoryTelemetry?.markExecutorCompleted();
         return {
@@ -988,7 +993,9 @@ async function executeLocalUnlocked(input, callbacks, dependencies) {
             errorMessage: errorTail || null,
             ...(providerError === undefined ? {} : { providerError }),
             finalText: input.captureFinal && cloudReportResult.finalText !== null
-                ? stripExternalAnswerMarkers(cloudReportResult.finalText)
+                ? runtime.name === "pi" && cloudReportResult.externalAnswer === null
+                    ? null
+                    : stripExternalAnswerMarkers(cloudReportResult.finalText)
                 : null,
             externalAnswer: input.captureFinal ? cloudReportResult.externalAnswer : null,
             sentViaCrew,

package/dist/machine-info.js

@@ -1,3 +1,4 @@
+import { MAINTENANCE_CAPABILITY } from "./marketplace-maintenance-protocol.js";
 import { retryHarnessProbe } from "./runtimes/harness-probe-retry.js";
 import { MARKETPLACE_CAPABILITY } from "./marketplace-protocol.js";
 /**
@@ -33,13 +34,13 @@ export const SELF_TRAINING_EXECUTION_CAPABILITY = "self_training_execution_v1";
 export const EXECUTION_LARGE_ATTACHMENTS_CAPABILITY = "execution_attachments_300m_v1";
 export const PROJECT_SKILL_PROJECTION_CAPABILITY = "project_skill_projection_v2";
 export const MACHINE_ENVIRONMENT_CAPABILITY = "machine_environment_v1";
-export const MACHINE_HELLO_ACK_CAPABILITY = "machine_hello_ack_v1";
 export const NATIVE_PROJECT_WORKSPACE_READINESS = Object.freeze({
     resolverReady: true,
     nativeRuntimeAdaptersReady: true,
 });
 export const DAEMON_CAPABILITIES = Object.freeze([
     MARKETPLACE_CAPABILITY,
+    MAINTENANCE_CAPABILITY,
     "scheduled_job_v1",
     "reply_origin_v1",
     "origin_decision_v1",
@@ -63,7 +64,6 @@ export const DAEMON_CAPABILITIES = Object.freeze([
     "agent_ability_runtime_assets_v1",
     "agent_environments_v1",
     MACHINE_ENVIRONMENT_CAPABILITY,
-    MACHINE_HELLO_ACK_CAPABILITY,
 ]);
 /** 能力只按平台过滤,进程存活期间静态(CLAUDE.md 红线)。Windows 在 junction/copy 真机 smoke 通过前不宣告 Project Skills。 */
 export const daemonCapabilities = (runtimePlatform = process.platform, readiness = NATIVE_PROJECT_WORKSPACE_READINESS) => {
@@ -72,7 +72,7 @@ export const daemonCapabilities = (runtimePlatform = process.platform, readiness
     const nativeWorkspaceReady = nativeWorkspacePlatform
         && readiness.resolverReady
         && readiness.nativeRuntimeAdaptersReady;
-    return Object.freeze(DAEMON_CAPABILITIES.filter((capability) => ((capability !== MARKETPLACE_CAPABILITY || nativeWorkspacePlatform)
+    return Object.freeze(DAEMON_CAPABILITIES.filter((capability) => (((capability !== MARKETPLACE_CAPABILITY && capability !== MAINTENANCE_CAPABILITY) || nativeWorkspacePlatform)
         && (capability !== PROJECT_WORKSPACES_CAPABILITY || nativeWorkspaceReady)
         && (capability !== "message_file_preview_v1" || nativeWorkspacePlatform)
         && (nativeWorkspacePlatform

package/dist/marketplace-controller.js

@@ -1,3 +1,4 @@
+import { MaintenanceRequestSchema, MaintenanceReportSchema } from "./marketplace-maintenance-protocol.js";
 import { MarketplaceRequestSchema, marketplaceActive } from "./marketplace-protocol.js";
 import { resolveMarketplaceScopes, runMarketplaceScope } from "./marketplace-runner.js";
 export function createMarketplaceController(deps) {
@@ -11,22 +12,31 @@ export function createMarketplaceController(deps) {
         const deadline = now() + 10 * 60_000;
         let lease = null;
         try {
-            const scopes = await (deps.resolve ?? resolveMarketplaceScopes)(request.targets, deps.agentsRoot);
+            const scopes = request.type === "marketplace:operation" ? await (deps.resolve ?? resolveMarketplaceScopes)(request.targets, deps.agentsRoot) : [];
             // 查询不使用任务执行槽；只有写入运行时共用市场/插件目录时才等待独占保护。
-            if (request.mode === "update") {
+            if (request.type === "marketplace:maintenance" || request.mode === "update") {
                 while (!stopped && now() < deadline && lease === null) {
                     lease = await deps.acquire();
                     if (!lease)
                         await wait();
                 }
                 if (!lease || stopped) {
-                    operations.set(id, { operationId: id, status: "failed", results: [], errorCode: "runtime_busy" });
+                    operations.set(id, { ...operations.get(id), status: "failed", errorCode: "runtime_busy" });
                     return;
                 }
             }
             if (stopped || now() >= deadline)
                 throw new Error("operation_deadline");
-            operations.set(id, { operationId: id, status: "running", results: [], errorCode: null });
+            operations.set(id, { ...operations.get(id), status: "running" });
+            if (request.type === "marketplace:maintenance") {
+                if (!deps.maintain)
+                    throw new Error("maintenance_unavailable");
+                const result = MaintenanceReportSchema.parse(await deps.maintain(request));
+                if (result.operationId !== id)
+                    throw new Error("operation_mismatch");
+                operations.set(id, result);
+                return;
+            }
             const results = [];
             for (const scope of scopes) {
                 if (stopped || now() >= deadline)
@@ -41,7 +51,9 @@ export function createMarketplaceController(deps) {
         }
         catch {
             const previous = operations.get(id);
-            operations.set(id, { ...previous, status: previous.results.some(x => !x.errorCode) ? "partial" : "failed", errorCode: "execution_failed" });
+            operations.set(id, request.type === "marketplace:maintenance"
+                ? { ...previous, status: "unknown", errorCode: "operation_unknown" }
+                : { ...previous, status: previous.results.some(x => !x.errorCode) ? "partial" : "failed", errorCode: "execution_failed" });
         }
         finally {
             try {
@@ -55,22 +67,23 @@ export function createMarketplaceController(deps) {
     };
     return {
         handle(raw) {
-            const parsed = MarketplaceRequestSchema.safeParse(raw);
+            const parsed = MarketplaceRequestSchema.or(MaintenanceRequestSchema).safeParse(raw);
             if (!parsed.success || stopped)
                 return { ok: false, error: "invalid_request" };
             const request = parsed.data;
+            const version = request.type === "marketplace:maintenance" ? { version: 2 } : {};
             const existing = operations.get(request.operationId);
             if (existing)
                 return { ok: true, data: existing };
             if (request.action === "status")
-                return { ok: true, data: { operationId: request.operationId, status: "unknown", results: [], errorCode: "operation_unknown" } };
+                return { ok: true, data: { ...version, operationId: request.operationId, status: "unknown", results: [], errorCode: "operation_unknown" } };
             if (process.platform !== "darwin" && process.platform !== "linux")
                 return { ok: false, error: "unsupported_platform" };
             if (current !== null || [...operations.values()].some(x => marketplaceActive(x.status)))
                 return { ok: false, error: "runtime_busy" };
             if (operations.size >= 100)
                 operations.delete(operations.keys().next().value);
-            const accepted = { operationId: request.operationId, status: "queued", results: [], errorCode: null };
+            const accepted = { ...version, operationId: request.operationId, status: "queued", results: [], errorCode: null };
             operations.set(request.operationId, accepted);
             current = execute(request).finally(() => { current = null; });
             return { ok: true, data: accepted };

package/dist/marketplace-maintenance-bridge.js

@@ -0,0 +1,79 @@
+import { createHash } from "node:crypto";
+import { mkdtemp, readFile, rm, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { spawn } from "node:child_process";
+import { augmentedPath } from "./runtime-path.js";
+import { MaintenanceReportSchema } from "./marketplace-maintenance-protocol.js";
+export function maintenanceEnvironment(env) {
+    // Keep the machine user's login/config, never forward control-plane credentials.
+    return Object.fromEntries(Object.entries(env).filter(([key]) => !/^(CREW_|NOWCREW_|NOWWORK_)/i.test(key)));
+}
+async function supervise(file, id, cwd, env) {
+    await new Promise((resolve, reject) => {
+        const child = spawn(process.execPath, [file, "--run", id], { cwd, env, detached: true, stdio: "ignore" });
+        let expired = false;
+        const kill = () => { if (child.pid) {
+            try {
+                process.kill(-child.pid, "SIGKILL");
+            }
+            catch { /* already gone */ }
+        } };
+        const timer = setTimeout(() => { expired = true; kill(); }, 18 * 60_000);
+        child.once("error", () => { clearTimeout(timer); kill(); reject(new Error("worker_failed")); });
+        child.once("close", code => {
+            clearTimeout(timer);
+            // Never release the machine lock while descendants can still write shared configuration.
+            kill();
+            if (expired || code !== 0)
+                reject(new Error("worker_failed"));
+            else
+                resolve();
+        });
+    });
+}
+export async function runMaintenanceBridge(config, request, acquireEnv) {
+    const fail = (errorCode) => ({ version: 2, operationId: request.operationId, status: "failed", results: [], errorCode });
+    let dir;
+    let started = false;
+    try {
+        const response = await fetch(`${config.serverUrl.replace(/\/+$/, "")}/machine/marketplace-maintenance/${request.operationId}/runner/${request.plan.runner.releaseId}`, {
+            headers: { authorization: `Bearer ${config.machineToken}` }, redirect: "error", signal: AbortSignal.timeout(15_000),
+        });
+        if (!response.ok)
+            return fail("runner_unavailable");
+        // Bound even a malformed server response before buffering or executing it.
+        if (!response.body)
+            return fail("runner_unavailable");
+        const chunks = [];
+        let bytes = 0;
+        for await (const chunk of response.body) {
+            bytes += chunk.length;
+            if (bytes > 256_000)
+                return fail("runner_unavailable");
+            chunks.push(chunk);
+        }
+        const content = Buffer.concat(chunks);
+        if (createHash("sha256").update(content).digest("hex") !== request.plan.runner.sha256)
+            return fail("runner_unavailable");
+        const env = maintenanceEnvironment(await acquireEnv());
+        env.PATH = augmentedPath(env, {}, process.platform, "append");
+        dir = await mkdtemp(join(tmpdir(), "nowwork-maintenance-"));
+        const file = join(dir, "runner.mjs");
+        await writeFile(file, content, { mode: 0o600 });
+        started = true;
+        await supervise(file, request.operationId, dir, env);
+        const report = MaintenanceReportSchema.parse(JSON.parse(await readFile(join(dir, "report.json"), "utf8")));
+        if (report.operationId !== request.operationId)
+            throw new Error("operation_mismatch");
+        return report;
+    }
+    catch {
+        // A killed worker may have changed files: require readback/manual confirmation before another write.
+        return started ? { ...fail("operation_unknown"), status: "unknown" } : fail("runner_unavailable");
+    }
+    finally {
+        if (dir)
+            await rm(dir, { recursive: true, force: true });
+    }
+}

package/dist/marketplace-maintenance-protocol.js

@@ -0,0 +1,40 @@
+import { z } from "zod";
+// 与 daemon 同名文件逐字一致；这是独立于旧单插件协议的版本化契约。
+export const MAINTENANCE_CAPABILITY = "marketplace_codex_maintenance_v1";
+export const MaintenancePlanSchema = z.object({
+    marketplace: z.literal("nowwork-pm"),
+    actions: z.tuple([z.literal("install-missing"), z.literal("update-installed")]),
+    hosts: z.tuple([z.literal("claude"), z.literal("codex"), z.literal("pi")]),
+    runner: z.object({ releaseId: z.string().regex(/^[a-f0-9]{64}$/), sha256: z.string().regex(/^[a-f0-9]{64}$/) }).strict(),
+}).strict();
+export const MaintenanceRequestSchema = z.discriminatedUnion("action", [
+    z.object({ type: z.literal("marketplace:maintenance"), action: z.literal("start"), operationId: z.string().uuid(), plan: MaintenancePlanSchema }).strict(),
+    z.object({ type: z.literal("marketplace:maintenance"), action: z.literal("status"), operationId: z.string().uuid() }).strict(),
+]);
+export const MaintenanceErrorSchema = z.enum(["runtime_busy", "execution_failed", "operation_unknown", "runner_unavailable",
+    "manager_missing", "cli_missing", "command_failed", "verification_failed", "source_conflict", "unsupported_platform"]);
+const Version = z.string().regex(/^[A-Za-z0-9][A-Za-z0-9._+-]{0,79}$/).nullable();
+export const MaintenanceResultSchema = z.object({
+    runtime: z.enum(["claude", "codex", "pi"]), plugin: z.string().regex(/^[a-z0-9][a-z0-9_-]{0,127}$/).nullable(),
+    status: z.enum(["installed", "updated", "unchanged", "empty", "missing_cli", "failed"]),
+    beforeVersion: Version, afterVersion: Version, targetVersion: Version,
+    activation: z.enum(["reload_required", "not_changed", "unverified"]), errorCode: MaintenanceErrorSchema.nullable(),
+}).strict();
+export const MaintenanceReportSchema = z.object({
+    version: z.literal(2), operationId: z.string().uuid(),
+    status: z.enum(["queued", "running", "completed", "partial", "failed", "unknown"]),
+    results: z.array(MaintenanceResultSchema).max(1500), errorCode: MaintenanceErrorSchema.nullable(),
+}).strict().superRefine((r, ctx) => {
+    const keys = r.results.map(x => `${x.runtime}:${x.plugin}`);
+    if (new Set(keys).size !== keys.length)
+        ctx.addIssue({ code: z.ZodIssueCode.custom, message: "Duplicate plugin result" });
+    for (const x of r.results) {
+        if (["installed", "updated", "unchanged"].includes(x.status) && (!x.plugin || !x.targetVersion || x.targetVersion !== x.afterVersion || x.errorCode)) {
+            ctx.addIssue({ code: z.ZodIssueCode.custom, message: "Successful plugin result requires a verified target version" });
+        }
+    }
+    if (r.status === "completed" && (r.errorCode || ["claude", "codex", "pi"].some(host => !r.results.some(x => x.runtime === host))
+        || r.results.some(x => x.errorCode || x.status === "failed" || x.status === "missing_cli"))) {
+        ctx.addIssue({ code: z.ZodIssueCode.custom, message: "Completion requires verified coverage of every host" });
+    }
+});

package/dist/marketplace-serve.js

@@ -1,7 +1,9 @@
+import { runMaintenanceBridge } from "./marketplace-maintenance-bridge.js";
 import { createMarketplaceController } from "./marketplace-controller.js";
 import { prepareDaemonRestart } from "./daemon-updater.js";
-export function createServeMarketplace(config, localSlots, hostCoordinator) {
+export function createServeMarketplace(config, localSlots, hostCoordinator, acquireEnv = async () => ({ ...process.env })) {
     const controller = createMarketplaceController({ agentsRoot: config.agentsRoot,
+        maintain: request => runMaintenanceBridge(config, request, acquireEnv),
         acquire: async () => {
             // Marketplace updates can mutate shared Codex/Claude homes across profiles.
             const local = await prepareDaemonRestart({ localSlots });
@@ -29,7 +31,7 @@ export function createServeMarketplace(config, localSlots, hostCoordinator) {
         } });
     return {
         handle(raw, send) {
-            if (!raw || typeof raw !== "object" || !("type" in raw) || raw.type !== "marketplace:operation")
+            if (!raw || typeof raw !== "object" || !("type" in raw) || (raw.type !== "marketplace:operation" && raw.type !== "marketplace:maintenance"))
                 return false;
             const { reqId, ...request } = raw;
             if (typeof reqId === "string")

package/dist/npm-command.js

@@ -1,9 +1,9 @@
 import { posix, win32 } from "node:path";
-/** Execute npm through its owning Node binary so PATH and cmd.exe quoting are irrelevant. */
+/** Execute POSIX npm through its owning Node binary so service PATH is irrelevant. */
 export function npmInvocation(platform, nodePath = process.execPath) {
     const paths = platform === "win32" ? win32 : posix;
-    const npmPath = platform === "win32"
-        ? paths.join(paths.dirname(nodePath), "node_modules", "npm", "bin", "npm-cli.js")
-        : paths.join(paths.dirname(nodePath), "npm");
-    return { command: nodePath, argsPrefix: [npmPath] };
+    const npmPath = paths.join(paths.dirname(nodePath), platform === "win32" ? "npm.cmd" : "npm");
+    return platform === "win32"
+        ? { command: npmPath, argsPrefix: [] }
+        : { command: nodePath, argsPrefix: [npmPath] };
 }

package/dist/project-skills/machine-hello-publisher.js

@@ -1,109 +1,20 @@
 import { WebSocket } from "ws";
-const HELLO_RETRY_DELAYS_MS = [1_000, 2_000, 4_000];
 /** 记住最近一次 hello 与 socket,便于存储身份变化后重发;Project Skills 状态恒为 ready。 */
 export function createMachineHelloPublisher(input) {
     let latest = null;
     let latestSocket = null;
-    let acknowledged = false;
-    let attempts = 0;
-    // 发送代次:每开一轮新发送(attach/publish/republish)自增,随帧发出并要求 ack 回显。
-    let generation = 0;
-    let retryTimer;
-    const clearRetry = () => {
-        if (retryTimer !== undefined) {
-            clearTimeout(retryTimer);
-            retryTimer = undefined;
-        }
-    };
-    const scheduleRetry = () => {
-        clearRetry();
-        if (acknowledged || latest === null || latestSocket?.readyState !== WebSocket.OPEN)
-            return;
-        // 当前 server 不支持 ack → 不排重试(否则永远等不到确认,白跑满退避)。
-        if (input.ackSupported && !input.ackSupported())
-            return;
-        const delay = HELLO_RETRY_DELAYS_MS[attempts - 1];
-        if (delay === undefined) {
-            // 退避跑满仍未 ack:期待 ack(ackSupported 已声明支持)才升级为断连重连,避免旧行为下反复重连。
-            if (input.ackSupported !== undefined && latestSocket !== null)
-                input.onExhausted?.(latestSocket);
-            return;
-        }
-        retryTimer = setTimeout(() => {
-            retryTimer = undefined;
-            sendCurrent();
-        }, delay);
-    };
-    function sendCurrent() {
-        if (latest === null || latestSocket?.readyState !== WebSocket.OPEN || acknowledged)
+    const republish = () => {
+        if (latest === null || latestSocket?.readyState !== WebSocket.OPEN)
             return;
-        // helloSeq 随帧发出;同一代次的多次重试复用同一 seq,ack 回显该 seq 即视为确认。
-        const hello = input.effective({ ...latest, projectSkillsStatus: "ready", helloSeq: generation });
-        const attempt = attempts + 1;
-        attempts = attempt;
+        const hello = input.effective({ ...latest, projectSkillsStatus: "ready" });
         try {
             latestSocket.send(JSON.stringify(hello));
-            input.onSent(hello, attempt);
-        }
-        catch (error) {
-            input.onSendFailed?.(hello, attempt, error);
+            input.onSent(hello);
         }
-        scheduleRetry();
-    }
-    const attach = (socket) => {
-        clearRetry();
-        latestSocket = socket;
-        acknowledged = false;
-        attempts = 0;
-        generation += 1;
-        sendCurrent();
-    };
-    const detach = (socket) => {
-        if (latestSocket !== socket)
-            return;
-        clearRetry();
-        latestSocket = null;
-        acknowledged = false;
-        attempts = 0;
-    };
-    const republish = () => {
-        if (latest === null || latestSocket === null)
-            return;
-        clearRetry();
-        acknowledged = false;
-        attempts = 0;
-        generation += 1;
-        sendCurrent();
-    };
-    const acknowledge = (socket, seq) => {
-        // 非当前 socket / 已确认 / 该 socket 已在关闭(close 后迟到的 ack)一律忽略:
-        // 后者会错误触发 onAck→清零强制重连计数,削弱重连上限。
-        if (latestSocket !== socket || latest === null || acknowledged || socket.readyState !== WebSocket.OPEN)
-            return;
-        // 代次校验:只接受回显当前代次的 ack,忽略上一代次迟到的 ack(否则会误停新代次的重试)。
-        // seq 缺省(老 server 不回显)时退回仅按 socket 匹配,保持兼容。
-        if (seq !== undefined && seq !== generation)
-            return;
-        acknowledged = true;
-        clearRetry();
-        input.onAck?.(input.effective({ ...latest, projectSkillsStatus: "ready" }));
+        catch { /* 非 OPEN,忽略 */ }
     };
     return Object.freeze({
-        publish: (hello, socket) => {
-            latest = hello;
-            if (latestSocket !== socket) {
-                attach(socket);
-                return;
-            }
-            acknowledged = false;
-            attempts = 0;
-            generation += 1;
-            clearRetry();
-            sendCurrent();
-        },
-        attach,
-        detach,
+        publish: (hello, socket) => { latest = hello; latestSocket = socket; republish(); },
         republish,
-        acknowledge,
     });
 }

package/dist/runtimes/pi.js

@@ -1,17 +1,85 @@
-export function buildPiArgs(options) { return ["--mode", "json", "--print", "--no-session", "--system-prompt", options.systemPrompt, ...(options.model ? ["--model", options.model] : []), ...(options.reasoning && options.reasoning !== "default" ? ["--thinking", options.reasoning] : [])]; }
-export function createPiEventDecoder() { let sessionId = null; let finalText = ""; let error = null; let sawTurnEnd = false; let usage; return { push(raw) { const e = (raw ?? {}); const out = []; if (e.type === "session" && typeof e.id === "string") {
-        sessionId = e.id;
-        out.push({ type: "thread.started", thread_id: e.id });
-    } const ae = e.assistantMessageEvent; if (e.type === "message_update" && ae?.type === "text_delta" && typeof ae.delta === "string") {
-        finalText += ae.delta;
-        out.push({ type: "pi.text_delta", text: ae.delta });
-    } if (e.type === "message_update" && typeof ae?.type === "string" && /tool(call|_call)/iu.test(ae.type))
-        out.push({ type: "pi.tool_call", ...(ae.name ? { title: ae.name } : {}) }); if (e.type === "message_end" && e.message?.role === "assistant")
-        usage = e.message.usage; if (e.type === "turn_end") {
-        sawTurnEnd = true;
-        const u = usage;
-        out.push({ type: "turn.completed", ...(u ? { usage: { input_tokens: u.input ?? 0, output_tokens: u.output ?? 0, cache_read_input_tokens: u.cacheRead ?? 0, cache_creation_input_tokens: u.cacheWrite ?? 0 } } : {}) });
-    } if (e.type === "error" || e.type === "agent_error") {
-        error = typeof e.error === "string" ? e.error : (e.error?.message ?? "Pi error");
-        out.push({ type: "pi.error", message: error });
-    } return out; }, finish() { return { ok: error === null && sawTurnEnd, ...(error === null && sawTurnEnd ? {} : { error: error ?? "Pi stream ended without turn completion" }), finalText, sessionId, usage }; } }; }
+export function buildPiArgs(options) {
+    return ["--mode", "json", "--print", "--no-session", "--system-prompt", options.systemPrompt,
+        ...(options.model ? ["--model", options.model] : []),
+        ...(options.reasoning && options.reasoning !== "default" ? ["--thinking", options.reasoning] : [])];
+}
+// 保留稳定的原因标识供 server 本地化；不要用 token 数量猜测结束原因。
+function failureReason(message) {
+    const reason = message?.stopReason;
+    return reason === "stop" || reason === "toolUse" ? null : `pi_runtime_failed: ${reason ?? "incomplete"}`;
+}
+export function createPiEventDecoder() {
+    let sessionId = null;
+    let finalText = "";
+    let error = null;
+    let lastAssistant = null;
+    let assistantOpen = false;
+    let sawTurnEnd = false;
+    let usage;
+    return {
+        push(raw) {
+            const e = (raw ?? {});
+            const out = [];
+            if (e.type === "session" && typeof e.id === "string") {
+                sessionId = e.id;
+                out.push({ type: "thread.started", thread_id: e.id });
+            }
+            if (e.type === "turn_start")
+                sawTurnEnd = false;
+            if ((e.type === "message_start" || e.type === "message_update") && e.message?.role === "assistant") {
+                assistantOpen = true;
+                sawTurnEnd = false;
+            }
+            const ae = e.assistantMessageEvent;
+            if (e.type === "message_update" && ae?.type === "text_delta" && typeof ae.delta === "string") {
+                finalText += ae.delta;
+                out.push({ type: "pi.text_delta", text: ae.delta });
+            }
+            if (e.type === "message_update" && ae?.type === "thinking_delta" && typeof ae.delta === "string") {
+                out.push({ type: "pi.thinking_delta", text: ae.delta });
+            }
+            if (e.type === "message_update" && typeof ae?.type === "string" && /tool(call|_call)/iu.test(ae.type)) {
+                out.push({ type: "pi.tool_call", ...(ae.name ? { title: ae.name } : {}) });
+            }
+            if (e.type === "message_end" && e.message?.role === "assistant") {
+                lastAssistant = e.message;
+                usage = e.message.usage;
+                assistantOpen = false;
+                sawTurnEnd = false;
+            }
+            if (e.type === "turn_end") {
+                // 原生 turn_end 自带本轮消息，不能把工具调用轮的结束当成整次执行成功。
+                if (e.message?.role === "assistant") {
+                    lastAssistant = e.message;
+                    usage = e.message.usage;
+                    assistantOpen = false;
+                }
+                else if (e.message) {
+                    lastAssistant = null;
+                }
+                sawTurnEnd = true;
+                const normalizedUsage = usage ? { usage: {
+                        input_tokens: usage.input ?? 0, output_tokens: usage.output ?? 0,
+                        cache_read_input_tokens: usage.cacheRead ?? 0, cache_creation_input_tokens: usage.cacheWrite ?? 0,
+                    } } : {};
+                const failure = failureReason(lastAssistant);
+                out.push(failure
+                    ? { type: "result", is_error: true, result: failure, ...normalizedUsage }
+                    : { type: "turn.completed", ...normalizedUsage });
+            }
+            if (e.type === "error" || e.type === "agent_error") {
+                error = typeof e.error === "string" ? e.error : (e.error?.message ?? "Pi error");
+                out.push({ type: "pi.error", message: error });
+            }
+            return out;
+        },
+        finish() {
+            // 正常 stop 可为空（任务可能要求静默）；length/error/aborted 必须明确失败。
+            const failure = error ?? (assistantOpen
+                ? "pi_runtime_failed: incomplete"
+                : failureReason(lastAssistant)
+                    ?? (!sawTurnEnd || lastAssistant?.stopReason === "toolUse" ? "pi_runtime_failed: incomplete" : null));
+            return { ok: failure === null, ...(failure ? { error: failure } : {}), finalText, sessionId, usage };
+        },
+    };
+}