agent-lyceum 0.9.2 → 0.11.0

package/README.md

@@ -65,7 +65,7 @@ claude --plugin-dir /path/to/agent-lyceum/plugins/status-monitor
 
 **Use it.**
 - **Toasts:** a message pops up when a run finishes, is interrupted, or an agent's wake fails (prefixed `[project]` when several are watched). Nothing to do.
-- **`/status-monitor`:** type it to open (or, if already open, close) the pane. It is off at session start unless `autoOpen` is set. In the **fullscreen layout** (`"tui": "fullscreen"` in `~/.claude/settings.json`, restart the session to apply; `/tui fullscreen` does the same) from 110 terminal columns it docks on the right at half the terminal width, and tabs and **關閉** (Close) can be clicked. Otherwise it shows above the prompt; the layout is fixed when the session starts, so a session started on the main screen stays that way. Keyboard (works in both): `x` closes, `1`-`9` or Tab/Enter switch task, Esc returns to the prompt, running the command again also closes. It shows, per project: the run id and state, task, progress and checklist, the agents working now and the queued mail, blocked integrations, notes and result summary, output tokens per runtime, per-agent wake statistics, the last 8 wakes. Each running task is a tab, newest first; finished and interrupted runs are not listed. It refreshes with the polling interval while open.
+- **`/status-monitor`:** type it to open (or, if already open, close) the pane. It is off at session start unless `autoOpen` is set. In the **fullscreen layout** (`"tui": "fullscreen"` in `~/.claude/settings.json`, restart the session to apply; `/tui fullscreen` does the same) from 110 terminal columns it docks on the right at half the terminal width, and tabs and **關閉** (Close) can be clicked. Otherwise it shows above the prompt; the layout is fixed when the session starts, so a session started on the main screen stays that way. Keyboard (works in both): `x` closes, `v` switches graph/text, `1`-`9` or Tab/Enter switch task, Esc returns to the prompt, running the command again also closes. It draws one block per agent, with the links between the lead and each member taken from `can_message` (`▼` the lead may write to the member, `▲` the member to the lead, `↕` both; yellow marks the latest hand-off). Each block shows what that agent is doing now, the mail it is handling and the mail queued for it as short readable sections by type (task: goal and acceptance criteria; reply: changes, verification, open items, risks; done: result and what is not done), and its wake count and output tokens. Above the graph: the run id and state, task, progress bar and checklist; below it: blocked integrations, notes and the result summary. `v` switches to the plain text list (per-runtime tokens, per-agent statistics, the last 8 wakes). Every block lists the agents it may message in a "→" line, with the latest hand-off marked "●" (this also covers member-to-member targets, which get no glyph). When the graph area is narrower than 70 columns (compared with the pane's own width, as the host reports it), the blocks stack in one column and the link glyphs are left out. Each running task is a tab, newest first; finished and interrupted runs are not listed. It refreshes with the polling interval while open.
 
 **Configure it.** In `~/.claude/settings.json` under `pluginConfigs."status-monitor@inline"` (`options`):
 

package/README.zh-TW.md

@@ -65,7 +65,7 @@ claude --plugin-dir /path/to/agent-lyceum/plugins/status-monitor
 
 **操作。**
 - **通知：** 執行完成、被中斷或某個 agent 喚醒失敗時會跳出訊息（監看多個專案時前面加 `[專案名]`），不需要任何操作。
-- **`/status-monitor`：** 輸入即開啟面板（已開著則關閉）。session 啟動時預設不開，除非設定 `autoOpen`。在 **fullscreen 版面**（`~/.claude/settings.json` 設 `"tui": "fullscreen"` 後重開 session；`/tui fullscreen` 效果相同）且終端寬度 110 欄以上時，面板會靠右 dock 在終端寬度的一半，分頁與 **關閉** 都可以用滑鼠點。否則顯示在輸入框上方；版面在 session 啟動時就固定，從主畫面啟動的 session 不會變。鍵盤操作兩種版面都能用：`x` 關閉，`1`-`9` 或 Tab/Enter 切換任務，Esc 回到輸入框，再執行一次指令也會關閉。每個專案顯示：執行 id 與狀態、任務、進度與清單、正在工作的 agent 與排隊中的信件、受阻的整合、備註與結果摘要、各 runtime 的 output tokens、各 agent 的喚醒統計、最近 8 次喚醒。每個執行中的任務是一個分頁，最新的排最前面；已結束或已中斷的不列出。面板開著時會依輪詢間隔自動更新。
+- **`/status-monitor`：** 輸入即開啟面板（已開著則關閉）。session 啟動時預設不開，除非設定 `autoOpen`。在 **fullscreen 版面**（`~/.claude/settings.json` 設 `"tui": "fullscreen"` 後重開 session；`/tui fullscreen` 效果相同）且終端寬度 110 欄以上時，面板會靠右 dock 在終端寬度的一半，分頁與 **關閉** 都可以用滑鼠點。否則顯示在輸入框上方；版面在 session 啟動時就固定，從主畫面啟動的 session 不會變。鍵盤操作兩種版面都能用：`x` 關閉，`v` 切換圖形／文字，`1`-`9` 或 Tab/Enter 切換任務，Esc 回到輸入框，再執行一次指令也會關閉。面板為每個 agent 畫一個區塊，並依 `can_message` 在 lead 與各成員之間畫出連結（`▼` lead 可寄給成員、`▲` 成員可寄給 lead、`↕` 雙向；黃色表示最近一次寄信的那條邊）。每個區塊顯示該 agent 現在在做什麼、正在處理與排隊中的信（依信種整理成可讀的重點：task 看目標與驗收，reply 看變更、驗證、待辦與風險，done 看結果與未完成），以及喚醒次數與輸出 token。圖形上方是執行 id 與狀態、任務、進度條與清單；下方是受阻的整合、備註與結果摘要。按 `v` 切換成純文字清單（各 runtime 的 token、各 agent 統計、最近 8 次喚醒）。每個區塊以「→」一行列出它可以寄信的對象，最近一次寄信的對象標 「●」（成員之間的對象也在此，不畫符號）。當圖形區域寬度少於 70 欄（以面板本身的寬度比較，由 host 回報），區塊改成單欄堆疊，不畫連結符號。每個執行中的任務是一個分頁，最新的排最前面；已結束或已中斷的不列出。面板開著時會依輪詢間隔自動更新。
 
 **設定。** 在 `~/.claude/settings.json` 的 `pluginConfigs."status-monitor@inline"`（`options`）：
 

package/dist/format.d.ts

@@ -31,3 +31,14 @@ export interface DoneContract {
  * (the report's own `## Steps`, else the run's latest `stateSteps`).
  */
 export declare function doneContract(meta: Record<string, unknown>, body: string, stateSteps?: Step[]): DoneContract;
+export interface DigestSection {
+    label: string;
+    lines: string[];
+}
+/**
+ * What a message is about, as short readable sections for the status panel: by type, the lines under the
+ * sections that matter (task: Goal, Acceptance criteria; reply: Changes, Verification, Open items, Risks;
+ * done: Result, Not done; ask: each question; failure: the first paragraph). With none of those, the one-line brief.
+ * Never throws: a body it cannot read gives [].
+ */
+export declare function digestOf(type: string, body: string): DigestSection[];

package/dist/format.js

@@ -100,3 +100,83 @@ export function doneContract(meta, body, stateSteps) {
         : undefined;
     return { outcome, missing, verification };
 }
+const DIGEST_MAX_LINES = 3;
+const DIGEST_MAX_CHARS = 80;
+/** Which `##` sections say what a message of each type is about, and the label the panel shows for them. */
+const DIGEST_SECTIONS = {
+    task: [
+        { name: "Goal", label: "目標" },
+        { name: "Acceptance criteria", label: "驗收" },
+    ],
+    reply: [
+        { name: "Changes", label: "變更" },
+        { name: "Verification", label: "驗證" },
+        { name: "Open items", label: "待辦" },
+        { name: "Risks", label: "風險" },
+    ],
+    done: [
+        { name: "Result", label: "結果" },
+        { name: "Not done", label: "未完成" },
+    ],
+};
+function digestLine(l) {
+    const t = l
+        .trim()
+        .replace(/^[-*]\s+(\[[ xX]\]\s+)?/, "")
+        .replace(/\*\*|`/g, "")
+        .trim();
+    return t.length > DIGEST_MAX_CHARS ? `${t.slice(0, DIGEST_MAX_CHARS - 1)}…` : t;
+}
+/** Readable lines of a block of text: markdown marks gone, empty / heading / warning / `None` lines dropped, at most 3 lines. */
+function digestLines(text) {
+    const lines = text
+        .split(/\r?\n/)
+        .map(digestLine)
+        .filter((l) => l !== "" && !/^#+\s/.test(l) && !l.startsWith("[agent-lyceum]") && !/^none\.?$/i.test(l));
+    if (lines.length <= DIGEST_MAX_LINES)
+        return lines;
+    const last = lines[DIGEST_MAX_LINES - 1] ?? "";
+    const cut = last.endsWith("…") ? last : `${last.slice(0, last.length >= DIGEST_MAX_CHARS ? DIGEST_MAX_CHARS - 1 : last.length)}…`;
+    return [...lines.slice(0, DIGEST_MAX_LINES - 1), cut];
+}
+/**
+ * What a message is about, as short readable sections for the status panel: by type, the lines under the
+ * sections that matter (task: Goal, Acceptance criteria; reply: Changes, Verification, Open items, Risks;
+ * done: Result, Not done; ask: each question; failure: the first paragraph). With none of those, the one-line brief.
+ * Never throws: a body it cannot read gives [].
+ */
+export function digestOf(type, body) {
+    try {
+        const out = [];
+        if (type === "ask") {
+            for (const m of body.matchAll(/<question\b[^>]*?\bid="([^"]*)"[^>]*>[\s\S]*?<text>([\s\S]*?)<\/text>/g)) {
+                const lines = digestLines(m[2] ?? "");
+                if (lines.length)
+                    out.push({ label: m[1] ?? "問題", lines });
+            }
+        }
+        else if (type === "failure") {
+            const first = body
+                .split(/\n[ \t]*\n/)
+                .map(digestLines)
+                .find((l) => l.length);
+            if (first)
+                out.push({ label: "訊息", lines: first });
+        }
+        else {
+            for (const s of DIGEST_SECTIONS[type] ?? []) {
+                const text = sectionText(body, s.name);
+                const lines = text === undefined ? [] : digestLines(text);
+                if (lines.length)
+                    out.push({ label: s.label, lines });
+            }
+        }
+        if (out.length)
+            return out;
+        const brief = briefOf(body);
+        return brief ? [{ label: "摘要", lines: [digestLine(brief)] }] : [];
+    }
+    catch {
+        return [];
+    }
+}

package/dist/run-session.js

@@ -1,7 +1,7 @@
 import fs from "node:fs";
 import path from "node:path";
 import { realInvoker } from "./adapters/index.js";
-import { briefOf, doneContract, parseSteps } from "./format.js";
+import { briefOf, digestOf, doneContract, parseSteps } from "./format.js";
 import { ProtectedGuard } from "./guard.js";
 import { addBatch, askersWithAnswers, askReplyPath, checkAnswers, describeCheck, isComplete, markDelivered, parseAskBody, readAskReply, renderAnswers, writeAskReply } from "./ask-reply.js";
 import { deliver, deliverOnce, ensureProjectDirs, finishDone, listUnread, rejectDone, routeOutboxes, unreadFiles } from "./mailbox.js";
@@ -222,7 +222,7 @@ export class RunSession {
             const att = beginAttempt(runDir, claim.id);
             say(`[round ${state.rounds}/${cfg.max_rounds}] waking ${agent.name} (${agent.runtime})${attempt ? ` — retry ${attempt}` : ""}`);
             const sessionId = agent.resume ? state.sessions[agent.name] : undefined;
-            const handling = unread.map((m) => ({ from: m.meta.from, type: m.meta.type, subject: m.meta.subject, brief: briefOf(m.body) }));
+            const handling = unread.map((m) => ({ from: m.meta.from, type: m.meta.type, subject: m.meta.subject, brief: briefOf(m.body), digest: digestOf(m.meta.type, m.body) }));
             state.active[agent.name] = { round, since: new Date(started).toISOString(), handling };
             this.saveState();
             result = await invoke({ ...base, signal: opts.signal, logDir: attemptLogDir(runDir, att.id), userPrompt: attempt ? retryPrompt(base.userPrompt, result?.error) : base.userPrompt, sessionId }).catch((e) => ({

package/dist/run-store.d.ts

@@ -1,5 +1,5 @@
 import type { ResolvedProject } from "./config.js";
-import type { Step } from "./format.js";
+import type { DigestSection, Step } from "./format.js";
 import type { RunOutcome } from "./schema.js";
 export declare const STATE_FILE = "state.json";
 export declare const STATE_SCHEMA_VERSION = 2;
@@ -11,6 +11,8 @@ export interface WakeTopic {
     subject: string;
     /** What the message is about, in one line. */
     brief?: string;
+    /** The same, as short readable sections by message type (see `digestOf`). */
+    digest?: DigestSection[];
 }
 export interface SentTopic {
     to: string;

package/dist/status.d.ts

@@ -1,7 +1,7 @@
 import { type ActiveWake, type EndReason, type RunState, type WakeRecord } from "./run-store.js";
 import type { RunOutcome } from "./schema.js";
 import type { ResolvedProject } from "./config.js";
-import type { Step } from "./format.js";
+import { type DigestSection, type Step } from "./format.js";
 export declare function latestRun(project: ResolvedProject): {
     dir: string;
     state: RunState;
@@ -39,6 +39,8 @@ export interface QueueItem {
     from: string;
     type: string;
     subject: string;
+    brief?: string;
+    digest?: DigestSection[];
 }
 export interface RunReport {
     run_id: string;
@@ -95,6 +97,8 @@ export interface AgentReport {
     runtime?: string;
     lead: boolean;
     unread: number;
+    /** Who this agent may send mail to (`all` expanded, itself left out). */
+    can_message: string[];
     last_wake?: {
         at: string;
         ok: boolean;

package/dist/status.js

@@ -3,6 +3,7 @@ import path from "node:path";
 import { askReplyPath, readAskReply } from "./ask-reply.js";
 import { RESULT_FILE } from "./dispatcher.js";
 import { bindRunProject, loadRunState, outcomeOf } from "./run-store.js";
+import { briefOf, digestOf } from "./format.js";
 import { listUnread } from "./mailbox.js";
 import { tidyAdvice } from "./memory-tidy.js";
 import { inspectProjectLock, lockHolderAlive } from "./project-lock.js";
@@ -147,7 +148,14 @@ function queueOf(project) {
             return x.agent === project.lead ? -1 : 1;
         return path.basename(x.msg.file).localeCompare(path.basename(y.msg.file));
     });
-    return rows.map((r) => ({ agent: r.agent, from: r.msg.meta.from, type: r.msg.meta.type, subject: r.msg.meta.subject }));
+    return rows.map((r) => ({
+        agent: r.agent,
+        from: r.msg.meta.from,
+        type: r.msg.meta.type,
+        subject: r.msg.meta.subject,
+        brief: briefOf(r.msg.body),
+        digest: digestOf(r.msg.meta.type, r.msg.body),
+    }));
 }
 /** One run as `status` sees it. Without `project`, liveness falls back to the recorded pid and there is no queue. */
 export function buildRunReport(run, project, opts = {}) {
@@ -236,6 +244,7 @@ export function buildStatusReport(base, runId) {
             runtime: a.runtime,
             lead: a.name === project.lead,
             unread: listUnread(project, a.name).length,
+            can_message: (a.canMessage === "all" ? Object.keys(project.agents) : a.canMessage).filter((n) => n !== a.name),
             last_wake: run?.state.last_wake[a.name],
         })),
         run: report,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-lyceum",
-  "version": "0.9.2",
+  "version": "0.11.0",
   "description": "Config + dispatcher for teams of Claude Code / Codex agents with scoped context and file-based mailboxes",
   "keywords": [
     "ai",