@nettee/beacon 0.2.5 → 0.2.6

package/dist/outcome/content.js

@@ -117,9 +117,20 @@ export function mergeOutcome(current, patch) {
             : {}),
     };
 }
+/** Stable English summary when the Agent settles without closing reply/no_reply. */
+export const MISSING_REPLY_OUTCOME_SUMMARY = "Expected exactly one of `reply` or `no_reply`, but the Agent Runtime settled without submitting either";
+export function isMissingReplyOutcomeError(error) {
+    if (!(error instanceof Error))
+        return false;
+    if (error.message === MISSING_REPLY_OUTCOME_SUMMARY)
+        return true;
+    // Legacy summaries from earlier Beacon builds
+    return (/settled without submitting reply or no_reply/i.test(error.message) ||
+        /submitting a (Final Outcome|reply or no_reply)/i.test(error.message));
+}
 export function completeOutcome(partial) {
     if (!partial.reply) {
-        throw new Error("Agent Runtime settled without submitting reply or no_reply");
+        throw new Error(MISSING_REPLY_OUTCOME_SUMMARY);
     }
     return {
         reply: partial.reply,

package/dist/run/orchestrator.js

@@ -1,5 +1,6 @@
 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 { agentSystemPromptTrigger, buildAgentSystemPrompt, profilePromptDigest, } from "../runtime/system-prompt.js";
@@ -39,11 +40,24 @@ function summary(error) {
     const value = error instanceof Error ? error.message : String(error);
     return value.slice(0, 4096) || "unknown failure";
 }
-function failureOutcome(runId) {
+/** User-visible (Feishu/admin) failure text. Keep codes stable; explain missing outcomes. */
+export function formatFailureReplyText(runId, failure) {
+    if (failure?.code === "outcome_missing") {
+        return [
+            `处理失败（run_id=${runId}，code=outcome_missing）：`,
+            "期望恰好调用一次 `reply` 或 `no_reply`，但 Agent 已结束且两者均未提交。",
+        ].join("");
+    }
+    if (failure) {
+        return `处理失败（run_id=${runId}，code=${failure.code}），请查看 Beacon 本地记录。`;
+    }
+    return `处理失败（run_id=${runId}），请查看 Beacon 本地记录。`;
+}
+function failureOutcome(runId, failure) {
     return {
         reply: {
             kind: "text",
-            text: `处理失败（run_id=${runId}），请查看 Beacon 本地记录。`,
+            text: formatFailureReplyText(runId, failure),
         },
     };
 }
@@ -169,7 +183,10 @@ export class RunOrchestrator {
         }
     }
     async fail(triggerKey, runId, code, error, submitted) {
-        const detail = summary(error);
+        const detail = isMissingReplyOutcomeError(error)
+            ? MISSING_REPLY_OUTCOME_SUMMARY
+            : summary(error);
+        const failure = { code, summary: detail };
         await this.options.store.update(triggerKey, (current) => ({
             ...current,
             run: {
@@ -177,11 +194,11 @@ export class RunOrchestrator {
                     this.newRun(runId, "queued", this.triggerFor(current))),
                 state: "failed",
                 finishedAt: this.timestamp(),
-                failure: { code, summary: detail },
+                failure,
             },
             finalOutcome: {
                 origin: "beacon_failure",
-                content: failureOutcome(runId),
+                content: failureOutcome(runId, failure),
                 submittedAt: this.timestamp(),
             },
             ...(submitted ? { feedback: submitted } : {}),
@@ -258,8 +275,7 @@ export class RunOrchestrator {
             submission.cancel();
             const code = error instanceof PiRuntimeError
                 ? error.code
-                : error instanceof Error &&
-                    /submitting a (Final Outcome|reply or no_reply)/.test(error.message)
+                : isMissingReplyOutcomeError(error)
                     ? "outcome_missing"
                     : "runtime_exit_failed";
             await this.fail(triggerKey, runId, code, error, submitted);
@@ -272,15 +288,16 @@ export class RunOrchestrator {
             input = await normalize();
         }
         catch (error) {
+            const failure = {
+                code: "trigger_normalization_failed",
+                summary: summary(error),
+            };
             await this.options.store.update(triggerKey, (current) => ({
                 ...current,
-                run: this.newRun(runId, "failed", this.triggerFor(current), {
-                    code: "trigger_normalization_failed",
-                    summary: summary(error),
-                }),
+                run: this.newRun(runId, "failed", this.triggerFor(current), failure),
                 finalOutcome: {
                     origin: "beacon_failure",
-                    content: failureOutcome(runId),
+                    content: failureOutcome(runId, failure),
                     submittedAt: this.timestamp(),
                 },
             }));

package/dist/schedule-trigger.js

@@ -49,7 +49,8 @@ export async function triggerScheduleOnce(options) {
     if (record.run.state !== "succeeded" || !record.finalOutcome) {
         const failure = record.run.failure?.code ??
             (!record.finalOutcome ? "outcome_missing" : "unknown");
-        throw new Error(`Schedule Trigger failed (run_id=${record.run.runId}): ${failure}`);
+        const detail = record.run.failure?.summary;
+        throw new Error(`Schedule Trigger failed (run_id=${record.run.runId}): ${failure}${detail ? ` — ${detail}` : ""}`);
     }
     return record;
 }

package/package.json

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