@nettee/beacon 0.2.5 → 0.2.7

package/dist/feishu/intake.js

@@ -1,3 +1,4 @@
+import { shouldProcessFeishuInbound } from "./mentions.js";
 import { buildFeishuTriggerInput, } from "./trigger-input.js";
 export class FeishuIntake {
     options;
@@ -10,6 +11,16 @@ export class FeishuIntake {
             (event.message.chat_type !== "p2p" && event.message.chat_type !== "group")) {
             return "ignored";
         }
+        // Temporary hard cut: group @All (without a direct bot @) never claims or runs.
+        if (!shouldProcessFeishuInbound({
+            chatType: event.message.chat_type,
+            mentions: event.message.mentions,
+            messageType: event.message.message_type,
+            content: event.message.content,
+        })) {
+            console.log(`[beacon] ignored group event without direct bot mention message_id=${event.message.message_id}`);
+            return "ignored";
+        }
         if (!event.event_id)
             throw new Error("Feishu event_id is required");
         const claim = await this.options.store.claim({

package/dist/feishu/mentions.js

@@ -0,0 +1,102 @@
+/**
+ * Temporary hard cut: group @All must not start a Beacon run.
+ * Prefer Feishu `message.mentions`; fall back to content placeholders.
+ */
+function normalize(value) {
+    return value?.trim().toLowerCase() ?? "";
+}
+/** True when a Feishu mention entry is @All / @所有人 / @_all. */
+export function isFeishuAtAllMention(mention) {
+    const key = normalize(mention.key);
+    if (key === "@_all" || key === "@all")
+        return true;
+    const name = mention.name?.trim() ?? "";
+    const nameLower = name.toLowerCase();
+    if (name === "所有人" || nameLower === "all" || nameLower === "@all") {
+        return true;
+    }
+    const userId = normalize(mention.id?.user_id);
+    if (userId === "all" || userId === "@_all")
+        return true;
+    const openId = mention.id?.open_id?.trim() ?? "";
+    const unionId = mention.id?.union_id?.trim() ?? "";
+    // Empty-identity @_all-shaped rows sometimes omit a clean key.
+    if (!openId &&
+        !unionId &&
+        !userId &&
+        (key.includes("all") || name.includes("所有人"))) {
+        return true;
+    }
+    return false;
+}
+function walkForAtAll(value) {
+    if (typeof value === "string") {
+        const trimmed = value.trim().toLowerCase();
+        return (trimmed === "@_all" ||
+            trimmed === "@all" ||
+            trimmed === "all" ||
+            /@_all\b/i.test(value));
+    }
+    if (Array.isArray(value)) {
+        return value.some((entry) => walkForAtAll(entry));
+    }
+    if (value && typeof value === "object") {
+        const record = value;
+        if (record.tag === "at") {
+            const userId = normalize(typeof record.user_id === "string" ? record.user_id : undefined);
+            if (userId === "all" || userId === "@_all")
+                return true;
+        }
+        return Object.values(record).some((entry) => walkForAtAll(entry));
+    }
+    return false;
+}
+/** Detect @_all / at-all markers inside raw Feishu message content JSON. */
+export function contentIndicatesFeishuAtAll(content) {
+    if (!content)
+        return false;
+    if (/@_all\b/i.test(content))
+        return true;
+    try {
+        return walkForAtAll(JSON.parse(content));
+    }
+    catch {
+        return /@_all\b/i.test(content);
+    }
+}
+/**
+ * A direct bot (or other entity) @mention — anything in `mentions` that is not @All.
+ * With mention-only Feishu scopes, non-@All mentions are the bot itself.
+ */
+export function hasDirectFeishuMention(mentions) {
+    if (!mentions?.length)
+        return false;
+    return mentions.some((mention) => {
+        if (isFeishuAtAllMention(mention))
+            return false;
+        if (mention.mentioned_type === "bot")
+            return true;
+        // Explicit user @ is not a bot mention.
+        if (mention.mentioned_type === "user")
+            return false;
+        const openId = mention.id?.open_id?.trim() ?? "";
+        const userId = mention.id?.user_id?.trim() ?? "";
+        const unionId = mention.id?.union_id?.trim() ?? "";
+        // mentioned_type omitted: any non-@All identity counts (mention-only bots).
+        return Boolean(openId || userId || unionId);
+    });
+}
+/**
+ * Beacon-layer gate for inbound Feishu events.
+ * - DM (p2p): always process
+ * - Group: process only when a non-@All mention is present
+ * - Pure @All (with or without @_all content): ignore
+ * - @All + @bot together: process (direct mention wins)
+ */
+export function shouldProcessFeishuInbound(input) {
+    if (input.chatType === "p2p")
+        return true;
+    if (input.chatType !== "group")
+        return false;
+    return hasDirectFeishuMention(input.mentions);
+}

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.7",
   "description": "A single-host bridge from messaging and schedules to isolated agent runs",
   "license": "Apache-2.0",
   "repository": {