@sleep2agi/commhub-server 0.9.0-preview.219 → 0.9.0-preview.220
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/package.json +1 -1
- package/src/agent-acl-slice3-http.test.ts +388 -1
- package/src/config-apply-validate.test.ts +68 -0
- package/src/config-apply-validate.ts +69 -0
- package/src/cors-origins.test.ts +40 -0
- package/src/create-node-network-id.test.ts +12 -0
- package/src/department-heads-http.test.ts +20 -0
- package/src/departments-agent-count.test.ts +3 -0
- package/src/etag-of.test.ts +57 -0
- package/src/event-loop-lag.ts +20 -0
- package/src/health-anon-readers.ts +59 -0
- package/src/health-host-disk-2756.test.ts +23 -1
- package/src/health-redaction.test.ts +1063 -0
- package/src/hub-catalog-read-http.test.ts +79 -0
- package/src/hub-provider-config.test.ts +17 -0
- package/src/hub-provider-config.ts +19 -0
- package/src/license-state.test.ts +56 -0
- package/src/license-state.ts +48 -0
- package/src/list-host-supervisors.test.ts +10 -0
- package/src/mcp-projects-events-http.test.ts +3 -0
- package/src/mcp-write-network-resolution.test.ts +3 -0
- package/src/node-caller-identity-http.test.ts +9 -1
- package/src/node-health-dispatch-http.test.ts +58 -2
- package/src/node-health-guard.ts +16 -0
- package/src/node-skills-transport.test.ts +3 -0
- package/src/opencode-v2-catalog.ts +4 -0
- package/src/redact-tokens.test.ts +22 -1
- package/src/redact-tokens.ts +4 -1
- package/src/rejection-counters.test.ts +72 -0
- package/src/rejection-counters.ts +173 -0
- package/src/requirement-events-http.test.ts +27 -0
- package/src/route-callers-http.test.ts +1 -1
- package/src/serve-error.test.ts +35 -0
- package/src/serve-error.ts +33 -4
- package/src/server.ts +913 -17
- package/src/shared/probe-host-allowlist-drift.test.ts +45 -0
- package/src/skillhub-http.test.ts +35 -1
- package/src/status-read-cache.ts +8 -1
- package/src/task-late-reply-http.test.ts +7 -0
- package/src/task-rejection-log.ts +10 -1
- package/src/tmux-allowlist.test.ts +48 -0
- package/src/tool-audience.ts +10 -3
- package/src/tools.ts +99 -15
|
@@ -326,5 +326,25 @@ describe("department_id filter and the read-only node list", () => {
|
|
|
326
326
|
expect((await dept(U.owner.token, "GET", `/${D.rd}/nodes`)).body.nodes.length).toBe(1);
|
|
327
327
|
expect((await dept(U.head.token, "POST", `/${D.fe}/nodes`, {})).status).toBe(405);
|
|
328
328
|
expect((await send(NODE_TOKEN, "GET", `/api/networks/${NET}/departments/${D.fe}/nodes`)).body.error).toBe("department_scope_denied");
|
|
329
|
+
|
|
330
|
+
// 2026-10-31 —— `status` 与 `degraded[].reason` 同形:**两个生产者,同一个字符串**。
|
|
331
|
+
// 节点自报的 status 里本来就有 "offline"(report_status 的 enum 含它),
|
|
332
|
+
// 而 Hub 在没有 session 行时也兜底写 "offline"。
|
|
333
|
+
// ⇒ 「它说自己下线了」与「我们从没听到过它」在响应里一字不差,
|
|
334
|
+
// 唯一能分开的是兄弟字段 last_seen_at(null = 从没上报过)。
|
|
335
|
+
expect(r.body.nodes[0].status).toBe("offline");
|
|
336
|
+
expect(r.body.nodes[0].last_seen_at).toBeNull();
|
|
337
|
+
|
|
338
|
+
// must-fire 的另一支:节点**上报过**并声明 offline ⇒ 同一个 status 字符串、last_seen_at 非空。
|
|
339
|
+
// 没有这一支,「null 能代替兜底」只是一句注释。
|
|
340
|
+
db.run(
|
|
341
|
+
"INSERT INTO sessions (resume_id, alias, status, node_id, network_id, last_seen_at, updated_at) VALUES ('rid_dept_offline', ?, 'offline', 'node_dh_m', ?, ?, datetime('now'))",
|
|
342
|
+
["示例-成员节点", NET, new Date().toISOString()],
|
|
343
|
+
);
|
|
344
|
+
const declared = (await dept(U.head.token, "GET", `/${D.fe}/nodes`)).body.nodes[0];
|
|
345
|
+
expect(declared.status).toBe("offline");
|
|
346
|
+
expect(typeof declared.last_seen_at).toBe("string");
|
|
347
|
+
expect(declared.last_seen_at.length).toBeGreaterThan(0);
|
|
348
|
+
db.run("DELETE FROM sessions WHERE resume_id = 'rid_dept_offline'");
|
|
329
349
|
});
|
|
330
350
|
});
|
|
@@ -116,6 +116,9 @@ describe("#2822 部门 → Agent 计数走 nodes.department_id(轴2)", () =>
|
|
|
116
116
|
try {
|
|
117
117
|
const raw: any = await client.callTool({ name: "departments", arguments: { action: "list" } });
|
|
118
118
|
const mcp = JSON.parse(String(raw.content?.[0]?.text ?? "{}"));
|
|
119
|
+
// 2026-10-31 —— **精确键集**(#3171):紧挨调用写,且单行(键集断言被任何换行拆开时,
|
|
120
|
+
// 静态计数器就读不到它 —— 而读不到与没写同形)。实际五键,我第一版只写了三个。
|
|
121
|
+
expect(Object.keys(mcp).sort()).toEqual(["agents", "departments", "network_id", "ok", "unassigned_agents"]);
|
|
119
122
|
const http = (await send(TOKEN, "GET", D())).body;
|
|
120
123
|
const httpByName = new Map<string, any>((http.departments as any[]).map((d) => [d.name, d]));
|
|
121
124
|
expect(mcp.departments.length).toBeGreaterThan(0);
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
// 2026-10-31 —— ETag 函数的两个方向。
|
|
2
|
+
//
|
|
3
|
+
// 只测「内容变 ⇒ ETag 变」是不够的:那一条挡的是「退化得更松」(按长度、按份数、按前缀)。
|
|
4
|
+
// 还要一条「内容不变 ⇒ ETag 不变」,它挡的是「退化得更严」(改成随机数、加时间戳、加自增)——
|
|
5
|
+
// 后者会让每个响应都「变了」,304 永远不命中,而现象是「客户端还是能收到 200」,没人会报错。
|
|
6
|
+
//
|
|
7
|
+
// ⚠️ 口径(2026-10-31 自查后修正):本文件共 5 条断言,但**独立维度只有 4 个** ——
|
|
8
|
+
// 「只差末位」与「只差首位」同属「内容差」这一维,它们不是两种独立输入。
|
|
9
|
+
// 所以对外只说「4 个维度」,不说「5 种输入」:断言数好数,独立输入数要靠「删掉一个维度是否仍有覆盖」来判。
|
|
10
|
+
//
|
|
11
|
+
// 差异的位置也有讲究:必须有一条把差异放在**最后一个字符**,
|
|
12
|
+
// 因为任何截断式比较(前缀 / 前 N 位 hash)在差异靠后时仍然判等。
|
|
13
|
+
import { describe, expect, test } from "bun:test";
|
|
14
|
+
import { etagOf } from "./status-read-cache.js";
|
|
15
|
+
|
|
16
|
+
describe("etagOf: 两个方向 + 差异位置", () => {
|
|
17
|
+
test("内容不变 ⇒ ETag 不变(纯函数;否则 304 永远不命中)", () => {
|
|
18
|
+
const body = JSON.stringify({ sessions: [{ alias: "a" }], n: 1 });
|
|
19
|
+
expect(etagOf(body)).toBe(etagOf(body));
|
|
20
|
+
// 逐字节相同的两个字符串(构造方式不同)也必须同值
|
|
21
|
+
expect(etagOf("x" + "y")).toBe(etagOf("xy"));
|
|
22
|
+
});
|
|
23
|
+
|
|
24
|
+
test("只差**最后一个字符** ⇒ ETag 必须不同(挡前缀 / 短 hash 比较)", () => {
|
|
25
|
+
const a = `{"sessions":[{"alias":"node-a"}],"total":10}`;
|
|
26
|
+
const b = `{"sessions":[{"alias":"node-b"}],"total":11}`; // 长度相同、末位不同
|
|
27
|
+
expect(a.length).toBe(b.length);
|
|
28
|
+
expect(a.slice(0, -1)).not.toBe(b.slice(0, -1)); // 中部也有差,先声明
|
|
29
|
+
expect(etagOf(a)).not.toBe(etagOf(b));
|
|
30
|
+
// 更严格的一条:**只有**最后一个字符不同。
|
|
31
|
+
// ⚠️ 我第一版写成 `{"x":"aaaaaaa1"}` vs `{"x":"aaaaaaa2"}` —— 那是倒数第二个字符不同
|
|
32
|
+
// (最后一个是 `}`),而 `slice(0,-1)` 当场把这件事说出来。断言写的是「只差末位」,
|
|
33
|
+
// 样本却不是「只差末位」—— 这类样本错误比断言错误更难发现,因为它照样是绿的。
|
|
34
|
+
const c = "aaaaaaa1";
|
|
35
|
+
const d = "aaaaaaa2";
|
|
36
|
+
expect(c.slice(0, -1)).toBe(d.slice(0, -1));
|
|
37
|
+
expect(etagOf(c)).not.toBe(etagOf(d));
|
|
38
|
+
});
|
|
39
|
+
|
|
40
|
+
test("只差第一个字符 ⇒ ETag 也必须不同(方向对称,防「只比后缀」)", () => {
|
|
41
|
+
expect(etagOf("1abcdefg")).not.toBe(etagOf("2abcdefg"));
|
|
42
|
+
});
|
|
43
|
+
|
|
44
|
+
test("长度写进 ETag 不该让「同长度不同内容」判等", () => {
|
|
45
|
+
const a = "abcdefgh";
|
|
46
|
+
const b = "abcdefgi";
|
|
47
|
+
expect(a.length).toBe(b.length);
|
|
48
|
+
expect(etagOf(a)).not.toBe(etagOf(b));
|
|
49
|
+
// 反向:相同内容、不同长度 ⇒ 必然不同(长度是 ETag 的一部分,这是有意的)
|
|
50
|
+
expect(etagOf("ab")).not.toBe(etagOf("ab "));
|
|
51
|
+
});
|
|
52
|
+
|
|
53
|
+
test("形状:带引号的强 ETag(If-None-Match 才能按原样回送)", () => {
|
|
54
|
+
expect(etagOf("{}")).toMatch(/^"s-[0-9a-z]+-[0-9a-z]+"$/);
|
|
55
|
+
expect(etagOf("")).toMatch(/^"s-[0-9a-z]+-0"$/);
|
|
56
|
+
});
|
|
57
|
+
});
|
package/src/event-loop-lag.ts
CHANGED
|
@@ -80,6 +80,19 @@ export function recordGap(
|
|
|
80
80
|
return stallMs;
|
|
81
81
|
}
|
|
82
82
|
|
|
83
|
+
/**
|
|
84
|
+
* 2026-10-31 —— 窗口两端必须跟着读数一起走(#3174)。
|
|
85
|
+
*
|
|
86
|
+
* 原来 event_loop 给了 stall_count / last_stall_at,却没有窗口起点:
|
|
87
|
+
* 计数器随进程重启归零,而「归零」与「从未发生」在读数上同值 ⇒
|
|
88
|
+
* 单独引用 stall_count 的读者会把它读成「从上线以来没卡过」。
|
|
89
|
+
*
|
|
90
|
+
* ⇒ 现在两个时刻戳都在这对象里:`since`(起点,模块初始化时冻结)与 `observed_at`(读的时刻)。
|
|
91
|
+
* 引用者不必再去 /health 顶层猜窗口,窗口与读数同域。
|
|
92
|
+
* 判据:分子分母各要自己的时刻戳;**被声明的那个永远不算**。
|
|
93
|
+
*/
|
|
94
|
+
let sinceIso = new Date().toISOString();
|
|
95
|
+
|
|
83
96
|
export function eventLoopStats(): {
|
|
84
97
|
max_gap_ms: number;
|
|
85
98
|
last_gap_ms: number;
|
|
@@ -87,6 +100,10 @@ export function eventLoopStats(): {
|
|
|
87
100
|
last_stall_ms: number;
|
|
88
101
|
last_stall_at: string | null;
|
|
89
102
|
recent_stalls: EventLoopStall[];
|
|
103
|
+
/** 窗口起点(本进程 event-loop 观察开始时刻)。 */
|
|
104
|
+
since: string;
|
|
105
|
+
/** 这次读的时刻。与 `since` 一起才构成窗口;单独任一个都不构成。 */
|
|
106
|
+
observed_at: string;
|
|
90
107
|
} {
|
|
91
108
|
return {
|
|
92
109
|
max_gap_ms: Math.round(maxGapMs),
|
|
@@ -95,6 +112,8 @@ export function eventLoopStats(): {
|
|
|
95
112
|
last_stall_ms: Math.round(lastStallMs),
|
|
96
113
|
last_stall_at: lastStallAt,
|
|
97
114
|
recent_stalls: [...stalls].reverse(),
|
|
115
|
+
since: sinceIso,
|
|
116
|
+
observed_at: new Date().toISOString(),
|
|
98
117
|
};
|
|
99
118
|
}
|
|
100
119
|
|
|
@@ -106,6 +125,7 @@ export function resetEventLoopLagForTests(): void {
|
|
|
106
125
|
lastStallAt = null;
|
|
107
126
|
lastStallMs = 0;
|
|
108
127
|
stalls.length = 0;
|
|
128
|
+
sinceIso = new Date().toISOString(); // 重置窗口起点 —— 否则测试里「归零」与「没归零」同形
|
|
109
129
|
}
|
|
110
130
|
|
|
111
131
|
function envMs(name: string, fallback: number): number {
|
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 匿名 `/health` 字段的**读者登记表**。
|
|
3
|
+
*
|
|
4
|
+
* 2026-10-31 —— 外部复核 ⑤ 的第 ②′ 问:
|
|
5
|
+
* 「这条信息对匿名读者是**路标**还是**仪表**?路标(往哪打)⇒ 一律不给;仪表(忙不忙)⇒ 可以给聚合。」
|
|
6
|
+
*
|
|
7
|
+
* 本仓已有三分类(landmark / gauge / credential)回答「该不该给」,
|
|
8
|
+
* 但没有回答「**谁在读**」。于是白名单可以无限增长,每一行都写着「watchdog 需要」而没人验证过。
|
|
9
|
+
*
|
|
10
|
+
* ⇒ 每个匿名键必须登记一个读者,且读者是可机械核对的一类:
|
|
11
|
+
*
|
|
12
|
+
* cli 本仓客户端真的读它(**测试会在 agent-network/src 里逐字找这个名字**)
|
|
13
|
+
* probe 探针/自检脚本读它(同上,在 scripts/ 里找)
|
|
14
|
+
* external 仓外读者(监控、负载均衡健康检查、运维手册)—— 仓内无法验证,
|
|
15
|
+
* 所以必须写明「是哪一类外部系统」,并接受「未验」这个事实
|
|
16
|
+
*
|
|
17
|
+
* 判据:**一个白名单条目,如果连读者都指不出来,它就不是「仪表」,而是没人看的暴露面。**
|
|
18
|
+
*/
|
|
19
|
+
// 2026-10-31 —— 第四档是今晚查出来的:
|
|
20
|
+
// `mcp_inflight` / `mcp_inflight_peak` / `event_loop` 在仓内**没有任何代码读**,
|
|
21
|
+
// 只出现在注释(引用生产实测数值)与历史报告里 —— 读它们的是**人**(运维手工 curl)。
|
|
22
|
+
// 「程序读」与「人读」是两件事:前者能跨源核对,后者只能登记谁在什么场合看。
|
|
23
|
+
// 把它们混进 external(外部程序)会让「有读者」这句话虚高。
|
|
24
|
+
export type AnonReader = "cli" | "probe" | "external" | "operator";
|
|
25
|
+
|
|
26
|
+
export interface AnonReaderEntry {
|
|
27
|
+
reader: AnonReader;
|
|
28
|
+
/** 为什么要给匿名读者;external 的必须写清是哪一类系统 */
|
|
29
|
+
why: string;
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
export const PUBLIC_HEALTH_KEY_READERS: Readonly<Record<string, AnonReaderEntry>> = {
|
|
33
|
+
ok: { reader: "cli", why: "CLI/客户端判断「Hub 是否在」的第一位" },
|
|
34
|
+
status: { reader: "cli", why: "客户端展示 Hub 的细分状态(ok / degraded)" },
|
|
35
|
+
status_reasons: { reader: "cli", why: "anet status 把 status_reasons 拼成一行原因给用户看(bin/cli.ts)" },
|
|
36
|
+
version: { reader: "cli", why: "版本不一致提示(anet 与 hub 的版本对齐)" },
|
|
37
|
+
version_role: { reader: "external", why: "docs/release-hub-runbook.md 描述的仓外 dashboard 读它区分构建;仓内无消费者,未验" },
|
|
38
|
+
api_version: { reader: "cli", why: "客户端与 Hub 协商协议版本,不匹配时给出升级提示" },
|
|
39
|
+
transport: { reader: "cli", why: "协议协商(streamable-http)" },
|
|
40
|
+
uptime: { reader: "cli", why: "`anet status` 展示" },
|
|
41
|
+
startedAt: { reader: "cli", why: "展示启动时刻(粗粒度,不是 landmark 的 git_commit)" },
|
|
42
|
+
sessions_count: { reader: "cli", why: "状态面板的连接数" },
|
|
43
|
+
sse_connections: { reader: "cli", why: "状态面板展示当前 SSE 长连接数量" },
|
|
44
|
+
mcp_inflight: { reader: "operator", why: "运维手工 curl 看实时在途数;仓内无代码读,仅注释引用过生产数值" },
|
|
45
|
+
mcp_inflight_peak: { reader: "operator", why: "运维手工看**峰值**,用于判断重连风暴是否发生过;无程序读者" },
|
|
46
|
+
event_loop: { reader: "operator", why: "停顿指标只出现在历史发布报告里,仓内无代码读;靠人看" },
|
|
47
|
+
auth: { reader: "cli", why: "客户端据此决定登录方式" },
|
|
48
|
+
security: { reader: "cli", why: "客户端据此提示是否需要 TLS/密钥配置" },
|
|
49
|
+
tmux: { reader: "cli", why: "共存 TUI 的前置检查" },
|
|
50
|
+
v3_auth: { reader: "external", why: "老客户端兼容位;仓内无消费者,未验" },
|
|
51
|
+
multi_network: { reader: "cli", why: "多网络客户端据此决定是否显示网络切换" },
|
|
52
|
+
license: { reader: "cli", why: "兼容字段,展示用(判据请用 license_state)" },
|
|
53
|
+
license_state: { reader: "external", why: "监控/合规只读;仓内无消费者,未验" },
|
|
54
|
+
limits: { reader: "cli", why: "上传代理在开流前读它决定单次上传上限" },
|
|
55
|
+
capabilities: { reader: "cli", why: "客户端据此隐藏未实现的功能入口" },
|
|
56
|
+
probe_nonce: { reader: "probe", why: "探针回显:只在带 X-Probe-Nonce 时出现,用于验证同一次请求" },
|
|
57
|
+
served_at: { reader: "probe", why: "响应时刻:探针用它判断两次读数是不是同一次处理的产物" },
|
|
58
|
+
build_identified: { reader: "operator", why: "按 release-hub-runbook.md 由人核对构建是否可识别;无程序读者" },
|
|
59
|
+
};
|
|
@@ -12,7 +12,7 @@
|
|
|
12
12
|
// Run: COMMHUB_DB=/tmp/2756-health-disk.db bun test src/health-host-disk-2756.test.ts
|
|
13
13
|
|
|
14
14
|
import { describe, expect, test } from "bun:test";
|
|
15
|
-
import { hostDiskState } from "./server.js";
|
|
15
|
+
import { hostDiskState, redactHomeInPath } from "./server.js";
|
|
16
16
|
|
|
17
17
|
describe("#2756 /health.host_disk", () => {
|
|
18
18
|
test("形状完整且数值自洽", () => {
|
|
@@ -47,3 +47,25 @@ describe("#2756 /health.host_disk", () => {
|
|
|
47
47
|
expect(Math.abs(d.used_pct - pct)).toBeLessThan(10);
|
|
48
48
|
});
|
|
49
49
|
});
|
|
50
|
+
|
|
51
|
+
describe("#2756 /health 暴露面:家目录不进免鉴权响应", () => {
|
|
52
|
+
test("redactHomeInPath 把家目录换成 ~,其余路径不动", () => {
|
|
53
|
+
const home = process.env.HOME || "";
|
|
54
|
+
if (!home || home === "/") return;
|
|
55
|
+
const red = redactHomeInPath({ path: home + "/.commhub/" });
|
|
56
|
+
expect(red!.path).toBe("~/.commhub/");
|
|
57
|
+
expect(red!.path.includes(home)).toBe(false);
|
|
58
|
+
// 非家目录路径保持原样
|
|
59
|
+
expect(redactHomeInPath({ path: "/var/lib/commhub/" })!.path).toBe("/var/lib/commhub/");
|
|
60
|
+
// null 透传
|
|
61
|
+
expect(redactHomeInPath(null)).toBeNull();
|
|
62
|
+
});
|
|
63
|
+
|
|
64
|
+
test("真实 /health 响应里的 host_disk.path 不含家目录", () => {
|
|
65
|
+
const d = redactHomeInPath(hostDiskState());
|
|
66
|
+
const home = process.env.HOME || "";
|
|
67
|
+
if (d && home && home !== "/") {
|
|
68
|
+
expect(d.path.startsWith(home)).toBe(false);
|
|
69
|
+
}
|
|
70
|
+
});
|
|
71
|
+
});
|