feat(hub): raise agent turns/time limits and notify teachers on failure

Defaults and silo env go to 150 turns / 1800s wall clock. Run completion
appends a clear Feishu notice for max-turns, timeout, and other failures
(partial answer kept). Startup process-restart kills notify the bound chat.
Release v0.0.38.

hub/src/feishu/card/streaming-card.ts

@@ -129,11 +129,16 @@ export class StreamingAgentCard {
 
   async finish(
     fallbackText: string,
-    options: { readonly interrupted?: boolean; readonly footerText?: string | undefined } = {},
+    options: {
+      readonly interrupted?: boolean;
+      readonly footerText?: string | undefined;
+      readonly isError?: boolean;
+    } = {},
   ): Promise<void> {
     await this.flushChain;
     this.interrupted = options.interrupted === true;
     const footerText = options.footerText ?? "";
+    const isError = options.isError === true;
     const fallbackWithFooter = appendFooter(fallbackText, footerText);
     try {
       let answerText =
@@ -155,11 +160,10 @@ export class StreamingAgentCard {
 
       let updated = true;
       if (answerText.length > 0 || segments.length > 0) {
-        updated = await this.flushCard("complete", answerText, false, segments);
+        updated = await this.flushCard("complete", answerText, isError, segments);
       } else if (this.currentMessageId !== null) {
-        updated = await this.flushCard("complete", "", false, []);
+        updated = await this.flushCard("complete", "", isError, []);
       }
-
       if (!updated) {
         // Card path failed (e.g. residual content policy). Deliver text + standalone images.
         updated = await this.deliverPlainFallback(segments, answerText);

hub/src/feishu/runOutcomeNotice.ts

@@ -0,0 +1,106 @@
+/**
+ * User-visible run termination copy for Feishu teachers.
+ * Keep messages short, actionable, and free of stack traces.
+ */
+
+export interface RunOutcomeNoticeInput {
+  readonly wallTimeExceeded: boolean;
+  readonly interrupted: boolean;
+  readonly resultStatus: string;
+  readonly resultError: string | undefined;
+  readonly maxTurns: number;
+  readonly maxRunSeconds: number;
+  readonly hasPartialText: boolean;
+}
+
+export interface RunOutcomeNotice {
+  /** Mark the streaming card as failed (red footer). */
+  readonly isError: boolean;
+  /**
+   * Teacher-facing explanation. Appended after any partial answer text so the
+   * cause of a stop is never silent.
+   */
+  readonly notice: string | undefined;
+}
+
+export function teacherFacingRunOutcome(input: RunOutcomeNoticeInput): RunOutcomeNotice {
+  if (input.wallTimeExceeded) {
+    return {
+      isError: true,
+      notice: noticeLine(
+        input.hasPartialText,
+        `\u23F1 \u4EFB\u52A1\u8D85\u65F6\uFF1A\u5DF2\u8FBE\u5230\u5355\u6B21\u8FD0\u884C\u65F6\u95F4\u4E0A\u9650\uFF08${input.maxRunSeconds} \u79D2\uFF09\u3002\u8BF7\u62C6\u5206\u4EFB\u52A1\u540E\u91CD\u8BD5\uFF0C\u6216\u8054\u7CFB\u7BA1\u7406\u5458\u8C03\u9AD8\u8FD0\u884C\u65F6\u957F\u4E0A\u9650\u3002`,
+      ),
+    };
+  }
+
+  if (input.interrupted) {
+    return { isError: false, notice: undefined };
+  }
+
+  if (input.resultStatus === "completed") {
+    return { isError: false, notice: undefined };
+  }
+
+  const err = input.resultError ?? "";
+  if (isMaxTurnsError(err) || input.resultStatus === "length") {
+    return {
+      isError: true,
+      notice: noticeLine(
+        input.hasPartialText,
+        `\u26A0\uFE0F \u4EFB\u52A1\u4E2D\u65AD\uFF1A\u5DF2\u8FBE\u5230\u6700\u5927\u6B65\u9AA4\u6570\uFF08${input.maxTurns} \u8F6E\uFF09\u3002\u8BF7\u62C6\u5206\u4EFB\u52A1\u540E\u7EE7\u7EED\uFF0C\u6216\u8054\u7CFB\u7BA1\u7406\u5458\u8C03\u9AD8\u6B65\u9AA4\u4E0A\u9650\u3002`,
+      ),
+    };
+  }
+
+  if (err.trim() !== "") {
+    const brief = sanitizeErrorBrief(err);
+    return {
+      isError: true,
+      notice: noticeLine(
+        input.hasPartialText,
+        `\u274C \u4EFB\u52A1\u5931\u8D25\uFF1A${brief}\u3002\u8BF7\u91CD\u8BD5\uFF1B\u82E5\u591A\u6B21\u51FA\u73B0\u8BF7\u8054\u7CFB\u7BA1\u7406\u5458\u3002`,
+      ),
+    };
+  }
+
+  return {
+    isError: true,
+    notice: noticeLine(
+      input.hasPartialText,
+      "\u274C \u4EFB\u52A1\u672A\u6B63\u5E38\u5B8C\u6210\u3002\u8BF7\u91CD\u8BD5\uFF1B\u82E5\u591A\u6B21\u51FA\u73B0\u8BF7\u8054\u7CFB\u7BA1\u7406\u5458\u3002",
+    ),
+  };
+}
+
+export function appendTeacherNotice(body: string, notice: string | undefined): string {
+  if (notice === undefined || notice === "") return body;
+  if (body.trim() === "") return notice;
+  return `${body.trimEnd()}\n\n${notice}`;
+}
+
+export function isMaxTurnsError(error: string): boolean {
+  const lower = error.toLowerCase();
+  return (
+    lower.includes("maximum number of turns") ||
+    lower.includes("max_turns") ||
+    lower.includes("error_max_turns") ||
+    lower.includes("result_error_max_turns") ||
+    (lower.includes("result_error_during_execution") && lower.includes("turn"))
+  );
+}
+
+function noticeLine(hasPartialText: boolean, message: string): string {
+  if (!hasPartialText) return message;
+  return `${message}\n\uFF08\u4E0A\u65B9\u4E3A\u5DF2\u751F\u6210\u7684\u90E8\u5206\u7ED3\u679C\u3002\uFF09`;
+}
+
+function sanitizeErrorBrief(error: string): string {
+  const oneLine = error.replace(/\s+/g, " ").trim();
+  // Drop common SDK prefixes for readability.
+  const stripped = oneLine
+    .replace(/^Claude Code returned an error result:\s*/i, "")
+    .replace(/^Error:\s*/i, "");
+  if (stripped.length <= 160) return stripped;
+  return `${stripped.slice(0, 157)}...`;
+}

hub/src/feishu/trigger.ts

@@ -40,6 +40,7 @@ import { createAgentSdkStderrSink } from "../agent/diagnostics.js";
 import { InactiveOrganizationError, lockActiveOrganization } from "../org/status.js";
 import { StreamingAgentCard } from "./card/streaming-card.js";
 import { createFileDeliveryMcpServer } from "./fileDeliveryTool.js";
+import { appendTeacherNotice, teacherFacingRunOutcome } from "./runOutcomeNotice.js";
 import { readFeishuContext } from "./read.js";
 import { MessageBatcher, messageBatchKey, type MessageBatcherOptions } from "./messageBatcher.js";
 import { ApprovalManager } from "./approval.js";
@@ -598,13 +599,24 @@ export function makeTriggerHandler(deps: TriggerDeps): TriggerHandler {
     agentExecution
       .then(async (result) => {
         const interrupted = result.status === "interrupted" && !wallTimeExceeded;
-        const finalText =
+        const hasPartialText = result.text.trim() !== "";
+        const outcome = teacherFacingRunOutcome({
+          wallTimeExceeded,
+          interrupted,
+          resultStatus: result.status,
+          resultError: result.error,
+          maxTurns: runPolicy.maxTurns,
+          maxRunSeconds: runPolicy.maxRunSeconds,
+          hasPartialText,
+        });
+        const baseText =
           result.text !== ""
             ? result.text
-            : result.status === "failed" && result.error !== undefined
+            : result.status === "failed" && result.error !== undefined && outcome.notice === undefined
               ? `\u5904\u7406\u5931\u8D25: ${result.error}`
               : result.text;
-        await card.finish(finalText, { interrupted });
+        const finalText = appendTeacherNotice(baseText, outcome.notice);
+        await card.finish(finalText, { interrupted, isError: outcome.isError });
         const metadataPatch = sessionMetadataPatch(result.sdkSessionId);
         if (metadataPatch !== null) {
           await deps.prisma.agentSession.update({
@@ -675,7 +687,20 @@ export function makeTriggerHandler(deps: TriggerDeps): TriggerHandler {
         if (removedProcessingReaction) {
           await addReaction(rt, msg.message_id, "CrossMark");
         }
-        await card.fail(e instanceof Error ? e.message : String(e));
+        await card.fail(
+          appendTeacherNotice(
+            "",
+            teacherFacingRunOutcome({
+              wallTimeExceeded: false,
+              interrupted: false,
+              resultStatus: "failed",
+              resultError: e instanceof Error ? e.message : String(e),
+              maxTurns: runPolicy.maxTurns,
+              maxRunSeconds: runPolicy.maxRunSeconds,
+              hasPartialText: false,
+            }).notice ?? `\u274C \u4EFB\u52A1\u5931\u8D25\uFF1A${e instanceof Error ? e.message : String(e)}`,
+          ),
+        );
         try {
           await deps.prisma.agentRun.update({
             where: { id: run.id },