@nettee/beacon 0.4.9 → 0.4.10

package/dist/daemon/outcome/server.d.ts

@@ -8,6 +8,8 @@ export type OutcomeSubmission = {
     take(): FinalOutcomeContent;
     takeFeedback(): FeedbackRecord | undefined;
     takeObservabilityFeedback(): ObservabilityFeedbackRecord | undefined;
+    /** True when Agent already submitted reply_text / reply_card / no_reply. */
+    hasReply(): boolean;
     cancel(): void;
 };
 export type OutcomeSink = {

package/dist/daemon/outcome/server.js

@@ -127,6 +127,9 @@ export async function startOutcomeServer(options = {}) {
                         submittedAt: record.observabilityFeedbackSubmittedAt,
                     };
                 },
+                hasReply() {
+                    return record.outcome?.reply !== undefined;
+                },
                 cancel() {
                     submissions.delete(runToken);
                 },

package/dist/daemon/run/orchestrator.js

@@ -2,7 +2,7 @@ import { randomUUID } from "node:crypto";
 import { isAbsolute, join } from "node:path";
 import { isMissingReplyOutcomeError, MISSING_REPLY_OUTCOME_SUMMARY, } from "../outcome/content.js";
 import { inboundOutOfRoleReply } from "../outcome/instructions.js";
-import { PiRuntimeError } from "../runtime/pi-rpc.js";
+import { PiRuntimeError, RUNTIME_TIMEOUT_OUTCOME_MISSING_NOTE, RUNTIME_TIMEOUT_OUTCOME_SUBMITTED_NOTE, } from "../runtime/pi-rpc.js";
 import { agentSystemPromptTrigger, buildAgentSystemPrompt, profilePromptDigest, } from "../runtime/system-prompt.js";
 function promptFor(input) {
     if (input.kind === "event") {
@@ -79,6 +79,34 @@ function detailBeyondMissingSummary(summaryText) {
     }
     return clipForFeishu(summaryText, FAILURE_DETAIL_LIMIT);
 }
+function formatRuntimeTimeoutReplyText(runId, summaryText) {
+    const duration = summaryText.match(/after\s+([^:]+?):\s*Pi process/i)?.[1]?.trim() ??
+        summaryText
+            .match(/after\s+(\d+min \(\d+ms\)|\d+s \(\d+ms\)|\d+ms)/i)?.[1]
+            ?.trim() ??
+        "configured limit";
+    const parts = [
+        `处理失败（run_id=${runId}，code=runtime_timeout）：`,
+        `Beacon Run 硬超时（${duration}）：Pi 进程未在限时内退出。`,
+    ];
+    if (/Final Outcome was already submitted before timeout/i.test(summaryText)) {
+        parts.push("超时前 Agent 已提交 Final Outcome，但仍因 Pi 未退出被超时失败路径覆盖。");
+    }
+    else if (/No Final Outcome was submitted before timeout/i.test(summaryText)) {
+        parts.push("超时前未提交 Final Outcome。");
+    }
+    const remainingRaw = summaryText.match(/Remaining stderr:\s*([\s\S]+)/i)?.[1];
+    if (remainingRaw) {
+        const remaining = remainingRaw
+            .replace(/\.\s*Final Outcome was already submitted[\s\S]*$/i, "")
+            .replace(/\.\s*No Final Outcome was submitted[\s\S]*$/i, "")
+            .trim();
+        if (remaining) {
+            parts.push(`附加诊断：${clipForFeishu(remaining, FAILURE_DETAIL_LIMIT)}`);
+        }
+    }
+    return parts.join("");
+}
 /** User-visible (Feishu/admin) failure text. Keep codes stable; prefer concrete reasons. */
 export function formatFailureReplyText(runId, failure) {
     if (failure?.code === "outcome_missing") {
@@ -93,6 +121,9 @@ export function formatFailureReplyText(runId, failure) {
             parts.push(`详情：${detail}`);
         return parts.join("");
     }
+    if (failure?.code === "runtime_timeout" && failure.summary?.trim()) {
+        return formatRuntimeTimeoutReplyText(runId, failure.summary);
+    }
     if (failure?.summary?.trim()) {
         return `处理失败（run_id=${runId}，code=${failure.code}）：${clipForFeishu(failure.summary, FAILURE_DETAIL_LIMIT)}`;
     }
@@ -365,13 +396,21 @@ export class RunOrchestrator {
         catch (error) {
             const submitted = submission.takeFeedback();
             const submittedObservability = submission.takeObservabilityFeedback();
+            const replySubmitted = submission.hasReply();
             submission.cancel();
-            const code = error instanceof PiRuntimeError
-                ? error.code
-                : isMissingReplyOutcomeError(error)
+            let failError = error;
+            if (error instanceof PiRuntimeError && error.code === "runtime_timeout") {
+                const note = replySubmitted
+                    ? RUNTIME_TIMEOUT_OUTCOME_SUBMITTED_NOTE
+                    : RUNTIME_TIMEOUT_OUTCOME_MISSING_NOTE;
+                failError = new PiRuntimeError("runtime_timeout", `${error.message}. ${note}`);
+            }
+            const code = failError instanceof PiRuntimeError
+                ? failError.code
+                : isMissingReplyOutcomeError(failError)
                     ? "outcome_missing"
                     : "runtime_exit_failed";
-            await this.fail(triggerKey, runId, code, error, submitted, submittedObservability, settle);
+            await this.fail(triggerKey, runId, code, failError, submitted, submittedObservability, settle);
         }
     }
     async process(triggerKey, normalize) {

package/dist/daemon/runtime/pi-rpc.d.ts

@@ -43,6 +43,23 @@ export declare class PiRuntimeError extends Error {
 export declare function collectThinking(content: unknown[]): string;
 /** Exported for unit tests that assert argv without spawning a real Pi. */
 export declare function buildArguments(request: PiRunRequest): string[];
+/**
+ * Drop known-benign Pi stderr lines (e.g. "No project session found… creating
+ * a new session") so they are not pasted into failure summaries as if they were
+ * the root cause.
+ */
+export declare function sanitizePiStderr(stderr: string): string;
+/** Human-readable timeout budget for operator-facing messages. */
+export declare function formatTimeoutDuration(timeoutMs: number): string;
+/** Stable English note when Outcome was submitted before hard timeout. */
+export declare const RUNTIME_TIMEOUT_OUTCOME_SUBMITTED_NOTE = "Final Outcome was already submitted before timeout; Beacon still marked the Run failed because the Pi process did not exit in time";
+/** Stable English note when Outcome was missing at hard timeout. */
+export declare const RUNTIME_TIMEOUT_OUTCOME_MISSING_NOTE = "No Final Outcome was submitted before timeout";
+/**
+ * Beacon-owned hard timeout summary. Makes clear this is Beacon's Run limit,
+ * not a Pi "session not found" failure.
+ */
+export declare function formatRuntimeTimeoutMessage(timeoutMs: number, stderr: string): string;
 /**
  * Read NDJSON frames from Pi stdout with a hard per-frame byte cap.
  *

package/dist/daemon/runtime/pi-rpc.js

@@ -142,8 +142,57 @@ function buildPiEnvironment(outcome, configured = {}, runtimeEnvironment = {}) {
     }
     return environment;
 }
+/** Pi stderr that is normal session bootstrap, not a failure cause. */
+const BENIGN_PI_STDERR_PATTERNS = [
+    /^Warning:\s*No project session found with id '[^']+'; creating a new session with that id\.?\s*$/i,
+];
+/**
+ * Drop known-benign Pi stderr lines (e.g. "No project session found… creating
+ * a new session") so they are not pasted into failure summaries as if they were
+ * the root cause.
+ */
+export function sanitizePiStderr(stderr) {
+    return stderr
+        .split(/\r?\n/)
+        .map((line) => line.trimEnd())
+        .filter((line) => {
+        const trimmed = line.trim();
+        if (!trimmed)
+            return false;
+        return !BENIGN_PI_STDERR_PATTERNS.some((pattern) => pattern.test(trimmed));
+    })
+        .join("\n")
+        .trim();
+}
+/** Human-readable timeout budget for operator-facing messages. */
+export function formatTimeoutDuration(timeoutMs) {
+    if (Number.isSafeInteger(timeoutMs) &&
+        timeoutMs > 0 &&
+        timeoutMs % 60_000 === 0) {
+        return `${timeoutMs / 60_000}min (${timeoutMs}ms)`;
+    }
+    if (Number.isSafeInteger(timeoutMs) &&
+        timeoutMs > 0 &&
+        timeoutMs % 1_000 === 0) {
+        return `${timeoutMs / 1_000}s (${timeoutMs}ms)`;
+    }
+    return `${timeoutMs}ms`;
+}
+/** Stable English note when Outcome was submitted before hard timeout. */
+export const RUNTIME_TIMEOUT_OUTCOME_SUBMITTED_NOTE = "Final Outcome was already submitted before timeout; Beacon still marked the Run failed because the Pi process did not exit in time";
+/** Stable English note when Outcome was missing at hard timeout. */
+export const RUNTIME_TIMEOUT_OUTCOME_MISSING_NOTE = "No Final Outcome was submitted before timeout";
+/**
+ * Beacon-owned hard timeout summary. Makes clear this is Beacon's Run limit,
+ * not a Pi "session not found" failure.
+ */
+export function formatRuntimeTimeoutMessage(timeoutMs, stderr) {
+    const duration = formatTimeoutDuration(timeoutMs);
+    const detail = sanitizePiStderr(stderr);
+    return `Beacon Run hard timeout after ${duration}: Pi process did not exit in time${detail ? `. Remaining stderr: ${detail}` : ""}`;
+}
 function describeExit(code, signal, stderr) {
-    const detail = stderr.trim();
+    const detail = sanitizePiStderr(stderr);
     return new PiRuntimeError("runtime_exit_failed", `Pi process exited before the Run settled (code=${String(code)} signal=${String(signal)})${detail ? `: ${detail}` : ""}`);
 }
 async function stopProcess(child, terminateGraceMs) {
@@ -298,7 +347,7 @@ export async function runPiAgent(request, options = {}) {
                 clearTimeout(timer);
                 reject(error);
             };
-            const timer = setTimeout(() => fail(new PiRuntimeError("runtime_timeout", `Pi Run timed out after ${timeoutMs}ms${stderr.trim() ? `: ${stderr.trim()}` : ""}`)), timeoutMs);
+            const timer = setTimeout(() => fail(new PiRuntimeError("runtime_timeout", formatRuntimeTimeoutMessage(timeoutMs, stderr))), timeoutMs);
             const handleFrame = (line) => {
                 if (finished)
                     return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nettee/beacon",
-  "version": "0.4.9",
+  "version": "0.4.10",
   "description": "A single-host bridge from messaging and schedules to isolated agent runs",
   "license": "Apache-2.0",
   "repository": {