@nettee/beacon 0.4.8 → 0.4.10

package/dist/daemon/config/profile.d.ts

@@ -3,8 +3,6 @@ import { type ChannelRegistry } from "./channels.js";
 export declare const profilePersonaFile = "persona.md";
 export declare const profileTaskFile = "task.md";
 export declare const playbookProfileDirectoryName = ".beacon-profile";
-/** @deprecated Use playbookProfileDirectoryName. */
-export declare const workspaceProfileDirectoryName = ".beacon-profile";
 export type DeliveryDestination = {
     chatId: string;
     name?: string | undefined;
@@ -43,8 +41,6 @@ export type LoadProfileOptions = {
     channelsPath?: string;
 };
 export declare function playbookProfileDirectory(playbook: string): string;
-/** @deprecated Use playbookProfileDirectory. */
-export declare function workspaceProfileDirectory(playbook: string): string;
 /** Expand `~` / `$HOME` and resolve relative paths against the Profile playbook. */
 export declare function resolveSkillPath(rawPath: string, playbook: string): string;
 export declare function loadProfile(profileId: string, profilesDirectory?: string, options?: LoadProfileOptions): Promise<Profile>;

package/dist/daemon/config/profile.js

@@ -10,8 +10,6 @@ const profileIdPattern = /^[a-z0-9](?:[a-z0-9_-]{0,62})$/;
 export const profilePersonaFile = "persona.md";
 export const profileTaskFile = "task.md";
 export const playbookProfileDirectoryName = ".beacon-profile";
-/** @deprecated Use playbookProfileDirectoryName. */
-export const workspaceProfileDirectoryName = playbookProfileDirectoryName;
 /** Admin DM: raw Feishu chat_id only (bot×person DMs are not channel registry entries). */
 const adminDestinationSchema = z
     .object({ chat_id: z.string().trim().min(1) })
@@ -63,12 +61,9 @@ const skillsSchema = z
     paths: z.array(z.string().trim().min(1)).default([]),
 })
     .strict();
-const profileDocumentFieldsSchema = z
+const profileDocumentSchema = z
     .object({
-    /** Preferred config key for the Profile playbook directory. */
-    playbook: z.string().min(1).optional(),
-    /** Legacy alias for `playbook`. Dual-read during rename; prefer `playbook`. */
-    workspace: z.string().min(1).optional(),
+    playbook: z.string().min(1),
     runtime: z.literal("pi"),
     model: z
         .object({
@@ -90,34 +85,6 @@ const profileDocumentFieldsSchema = z
     skills: skillsSchema.optional(),
 })
     .strict();
-const profileDocumentSchema = profileDocumentFieldsSchema
-    .superRefine((document, context) => {
-    if (!document.playbook && !document.workspace) {
-        context.addIssue({
-            code: "custom",
-            message: "Profile must declare playbook (legacy key: workspace)",
-            path: ["playbook"],
-        });
-        return;
-    }
-    if (document.playbook &&
-        document.workspace &&
-        document.playbook !== document.workspace) {
-        context.addIssue({
-            code: "custom",
-            message: "Profile playbook and legacy workspace must match when both are set",
-            path: ["playbook"],
-        });
-    }
-})
-    .transform((document) => {
-    const playbook = document.playbook ?? document.workspace;
-    if (!playbook) {
-        throw new Error("Profile must declare playbook (legacy key: workspace)");
-    }
-    const { workspace: _legacy, playbook: _preferred, ...rest } = document;
-    return { ...rest, playbook };
-});
 function assertProfileId(profileId) {
     if (!profileIdPattern.test(profileId)) {
         throw new Error(`Invalid Profile ID: ${JSON.stringify(profileId)}`);
@@ -130,10 +97,6 @@ function isWithin(parent, child) {
 export function playbookProfileDirectory(playbook) {
     return join(playbook, playbookProfileDirectoryName);
 }
-/** @deprecated Use playbookProfileDirectory. */
-export function workspaceProfileDirectory(playbook) {
-    return playbookProfileDirectory(playbook);
-}
 async function isExistingFile(path) {
     try {
         return (await stat(path)).isFile();

package/dist/daemon/dashboard/profiles.js

@@ -39,8 +39,7 @@ const skillsSchema = z
     .strict();
 const profileDocumentSchema = z
     .object({
-    playbook: z.string().min(1).optional(),
-    workspace: z.string().min(1).optional(),
+    playbook: z.string().min(1),
     runtime: z.literal("pi"),
     model: z
         .object({
@@ -60,34 +59,7 @@ const profileDocumentSchema = z
         .optional(),
     skills: skillsSchema.optional(),
 })
-    .strict()
-    .superRefine((document, context) => {
-    if (!document.playbook && !document.workspace) {
-        context.addIssue({
-            code: "custom",
-            message: "Profile must declare playbook (legacy key: workspace)",
-            path: ["playbook"],
-        });
-        return;
-    }
-    if (document.playbook &&
-        document.workspace &&
-        document.playbook !== document.workspace) {
-        context.addIssue({
-            code: "custom",
-            message: "Profile playbook and legacy workspace must match when both are set",
-            path: ["playbook"],
-        });
-    }
-})
-    .transform((document) => {
-    const playbook = document.playbook ?? document.workspace;
-    if (!playbook) {
-        throw new Error("Profile must declare playbook (legacy key: workspace)");
-    }
-    const { workspace: _legacy, playbook: _preferred, ...rest } = document;
-    return { ...rest, playbook };
-});
+    .strict();
 function toNotifyView(notify) {
     if (!notify)
         return null;

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/dist/daemon/state/trigger-store.js

@@ -44,24 +44,7 @@ const inputSchema = z.discriminatedUnion("kind", [
         .strict(),
     z.object({ kind: z.literal("manual"), text: z.string().min(1) }).strict(),
 ]);
-const runSchema = z.preprocess((value) => {
-    if (typeof value !== "object" || value === null || Array.isArray(value)) {
-        return value;
-    }
-    const record = value;
-    if (typeof record.playbook === "string") {
-        if ("workspace" in record) {
-            const { workspace: _legacy, ...rest } = record;
-            return rest;
-        }
-        return record;
-    }
-    if (typeof record.workspace === "string") {
-        const { workspace, ...rest } = record;
-        return { ...rest, playbook: workspace };
-    }
-    return record;
-}, z
+const runSchema = z
     .object({
     runId: z.string().min(1),
     sessionId: z
@@ -84,7 +67,7 @@ const runSchema = z.preprocess((value) => {
     systemPrompt: z.string().min(1).optional(),
     failure: failureSchema.optional(),
 })
-    .strict());
+    .strict();
 const outcomeSchema = z.union([
     z
         .object({

package/package.json

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