@sleep2agi/commhub-server 0.9.0-preview.7 → 0.9.0-preview.71

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.
Files changed (170) hide show
  1. package/README.md +130 -10
  2. package/bin/commhub.ts +10 -2
  3. package/package.json +5 -5
  4. package/src/ack-create-request-transport.test.ts +159 -0
  5. package/src/ack-create-request.test.ts +331 -0
  6. package/src/admin-delete-network-http.test.ts +177 -0
  7. package/src/admin-networks-http.test.ts +88 -0
  8. package/src/agent-access.ts +461 -0
  9. package/src/agent-acl-groups-http.test.ts +247 -0
  10. package/src/agent-acl-http.test.ts +510 -0
  11. package/src/agent-acl-slice3-http.test.ts +267 -0
  12. package/src/agent-groups-perf.test.ts +167 -0
  13. package/src/alias-filter.test.ts +72 -0
  14. package/src/alias-filter.ts +32 -0
  15. package/src/api-host-supervisors-can-create-nodes.test.ts +350 -0
  16. package/src/api-host-supervisors-fallback.test.ts +271 -0
  17. package/src/api-nodes-shape.test.ts +26 -10
  18. package/src/auth-sessions-http.test.ts +250 -0
  19. package/src/auth-validate.test.ts +5 -1
  20. package/src/auth.ts +423 -29
  21. package/src/avatar-validate.test.ts +163 -0
  22. package/src/avatar-validate.ts +103 -0
  23. package/src/blocked-exit-on-reply.test.ts +122 -0
  24. package/src/boot-side-effect.test.ts +124 -0
  25. package/src/config-apply-sec1.test.ts +107 -0
  26. package/src/config-apply-validate.test.ts +92 -0
  27. package/src/config-apply-validate.ts +81 -3
  28. package/src/create-node-blocked-gate.test.ts +356 -0
  29. package/src/create-node-tool-schema.test.ts +39 -0
  30. package/src/create-node-validate.test.ts +89 -1
  31. package/src/create-node-validate.ts +89 -7
  32. package/src/create-node-workdir.test.ts +255 -0
  33. package/src/create-node.ts +51 -1
  34. package/src/dashboard-slash-routing-http.test.ts +107 -0
  35. package/src/db-adapter-guard.test.ts +85 -0
  36. package/src/db-adapter-translate.test.ts +112 -0
  37. package/src/db-adapter.ts +246 -83
  38. package/src/db-timestamp.test.ts +38 -0
  39. package/src/db-timestamp.ts +15 -0
  40. package/src/db.ts +799 -33
  41. package/src/delivered-without-push.test.ts +140 -0
  42. package/src/desktop-message-seam.test.ts +150 -0
  43. package/src/desktop-message.test.ts +368 -0
  44. package/src/ext-token-shared.test.ts +60 -0
  45. package/src/ext-validation-regression.test.ts +131 -0
  46. package/src/external-schedule-edits-http.test.ts +321 -0
  47. package/src/external-schedule-edits-timestamps.test.ts +64 -0
  48. package/src/external-schedule-edits.ts +327 -0
  49. package/src/file-download-authz-dev-open.test.ts +135 -0
  50. package/src/file-download-authz.test.ts +404 -0
  51. package/src/file-download-date-bucket.test.ts +436 -0
  52. package/src/file-network-scope-dev-open.test.ts +97 -0
  53. package/src/file-network-scope.test.ts +732 -0
  54. package/src/health-redaction.test.ts +642 -0
  55. package/src/http-gzip.test.ts +73 -0
  56. package/src/http-gzip.ts +60 -0
  57. package/src/hub-timestamp.test.ts +38 -0
  58. package/src/hub-timestamp.ts +27 -0
  59. package/src/human-dm.ts +149 -0
  60. package/src/inbox-count-sse.test.ts +310 -0
  61. package/src/inbox-count.ts +29 -0
  62. package/src/index.ts +15 -2331
  63. package/src/lifecycle-guard.ts +50 -0
  64. package/src/mcp-write-network-resolution.test.ts +429 -0
  65. package/src/messages-ack-by-agent-http.test.ts +142 -0
  66. package/src/network-name-http.test.ts +75 -0
  67. package/src/network-scope.ts +224 -0
  68. package/src/node-attrs-validate.ts +88 -0
  69. package/src/node-attrs.test.ts +217 -0
  70. package/src/node-create-request-status-http.test.ts +92 -0
  71. package/src/node-files-transport.test.ts +344 -0
  72. package/src/node-id-alias.test.ts +188 -0
  73. package/src/node-lifecycle-controllable.test.ts +64 -0
  74. package/src/node-lifecycle-controllable.ts +51 -0
  75. package/src/node-logs-transport.test.ts +263 -0
  76. package/src/node-request-retention.test.ts +281 -0
  77. package/src/node-request-retention.ts +120 -0
  78. package/src/node-skills-transport.test.ts +209 -0
  79. package/src/node-token-privilege-http.test.ts +149 -0
  80. package/src/observer-avatar-http.test.ts +429 -0
  81. package/src/observer-push.test.ts +252 -0
  82. package/src/package-version-consistency.test.ts +25 -0
  83. package/src/peer-reply-atomic.test.ts +455 -0
  84. package/src/peer-reply-capability.test.ts +70 -0
  85. package/src/pg-worker.ts +87 -0
  86. package/src/push.ts +204 -7
  87. package/src/redact-tokens.test.ts +65 -0
  88. package/src/redact-tokens.ts +40 -0
  89. package/src/rename.ts +7 -2
  90. package/src/reply-target-derivation.test.ts +96 -0
  91. package/src/report-status-host-schema.test.ts +211 -0
  92. package/src/report-status-resume-id-handover.test.ts +150 -0
  93. package/src/require-explicit-test-db.ts +9 -0
  94. package/src/requirement-tags.ts +16 -0
  95. package/src/requirements-etag-http.test.ts +91 -0
  96. package/src/requirements-http.test.ts +708 -0
  97. package/src/requirements-mcp.test.ts +142 -0
  98. package/src/requirements-migrate.ts +83 -0
  99. package/src/requirements-priority-lowest.test.ts +114 -0
  100. package/src/requirements-start-date.test.ts +125 -0
  101. package/src/requirements-upgrade-e2e.test.ts +126 -0
  102. package/src/requirements-upgrade-migration.test.ts +85 -0
  103. package/src/requirements.ts +899 -0
  104. package/src/resolve-port.test.ts +57 -0
  105. package/src/resolve-port.ts +44 -0
  106. package/src/response-charset.test.ts +130 -0
  107. package/src/rest-explicit-columns-http.test.ts +216 -0
  108. package/src/rest-identity.test.ts +129 -0
  109. package/src/rest-identity.ts +100 -0
  110. package/src/rest-projections.ts +68 -0
  111. package/src/rest-write-network-resolution.test.ts +133 -0
  112. package/src/restricted-files.ts +73 -0
  113. package/src/retention.ts +10 -1
  114. package/src/rules-file-duplicate-alias.test.ts +234 -0
  115. package/src/rules-file-session-target.test.ts +207 -0
  116. package/src/rules-file-transport.test.ts +237 -0
  117. package/src/runtime-label.test.ts +22 -0
  118. package/src/runtime-label.ts +21 -0
  119. package/src/scheduled-doorbell-nodeless-session.test.ts +130 -0
  120. package/src/scheduled-run-terminal.test.ts +268 -0
  121. package/src/scheduled-skip-blocking-task.test.ts +120 -0
  122. package/src/scheduled-tasks-http.test.ts +625 -0
  123. package/src/scheduled-tasks.ts +597 -0
  124. package/src/send-dedup-request-id.test.ts +229 -0
  125. package/src/send-reply-agent-warning.test.ts +202 -0
  126. package/src/send-reply-alias-optional.test.ts +131 -0
  127. package/src/send-reply-attachments.test.ts +458 -0
  128. package/src/send_dedup.test.ts +54 -0
  129. package/src/send_dedup.ts +52 -6
  130. package/src/serve-error.test.ts +38 -0
  131. package/src/serve-error.ts +27 -0
  132. package/src/server.ts +4385 -0
  133. package/src/shared/external-schedule-contract.ts +60 -0
  134. package/src/side-thread-command-transport.test.ts +302 -0
  135. package/src/side-thread-command-transport.ts +318 -0
  136. package/src/side-thread-http-integration.test.ts +233 -0
  137. package/src/side-thread-http.ts +504 -0
  138. package/src/side-thread-production.test.ts +72 -0
  139. package/src/side-thread-production.ts +118 -0
  140. package/src/side-thread.test.ts +1067 -0
  141. package/src/side-thread.ts +2495 -0
  142. package/src/skillhub-http.test.ts +92 -0
  143. package/src/start-node.test.ts +109 -0
  144. package/src/status-alias-filter-http.test.ts +106 -0
  145. package/src/stop-delete-node.test.ts +1164 -0
  146. package/src/task-auth-origin-http.test.ts +91 -0
  147. package/src/task-auth-origin.test.ts +24 -0
  148. package/src/task-auth-origin.ts +7 -0
  149. package/src/task-consumption.test.ts +482 -0
  150. package/src/task-diagnostic-http.test.ts +149 -0
  151. package/src/task-diagnostic.test.ts +115 -0
  152. package/src/task-diagnostic.ts +118 -0
  153. package/src/task-idempotency-mcp.test.ts +142 -0
  154. package/src/task-idempotency.test.ts +60 -0
  155. package/src/task-idempotency.ts +75 -0
  156. package/src/task-lifecycle-watcher.test.ts +204 -0
  157. package/src/task-lifecycle-watcher.ts +49 -0
  158. package/src/task-network-resolution-http.test.ts +141 -0
  159. package/src/tasks-pagination-http.test.ts +141 -0
  160. package/src/tools-list-json-schema.test.ts +66 -0
  161. package/src/tools.ts +3446 -257
  162. package/src/update-provider.test.ts +65 -0
  163. package/src/upload-early-reject-guard.test.ts +155 -0
  164. package/src/uploads-http.test.ts +97 -15
  165. package/src/uploads.test.ts +66 -0
  166. package/src/uploads.ts +130 -5
  167. package/src/user-inbox-by-agent-http.test.ts +161 -0
  168. package/src/user-inbox-netid-notnull.test.ts +122 -0
  169. package/src/user-inbox-read-http.test.ts +223 -0
  170. package/src/user-inbox-schema.test.ts +54 -0
@@ -0,0 +1,92 @@
1
+ import { afterAll, beforeAll, describe, expect, test } from "bun:test";
2
+ import { mkdtempSync, rmSync } from "node:fs";
3
+ import { join } from "node:path";
4
+ import { tmpdir } from "node:os";
5
+ import { createNetworkTokenForNode, register } from "./auth.js";
6
+ import { db } from "./db.js";
7
+
8
+ const dir = mkdtempSync(join(tmpdir(), "anet-skillhub-"));
9
+ let server: any;
10
+ let base = "";
11
+ let ownerToken = "";
12
+ let nodeToken = "";
13
+ let foreignToken = "";
14
+ let networkId = "";
15
+
16
+ async function tool(token: string, name: string, args: Record<string, unknown>) {
17
+ const res = await fetch(`${base}/mcp`, {
18
+ method: "POST",
19
+ headers: { Authorization: `Bearer ${token}`, "Content-Type": "application/json", Accept: "application/json, text/event-stream", "MCP-Protocol-Version": "2025-03-26" },
20
+ body: JSON.stringify({ jsonrpc: "2.0", id: 1, method: "tools/call", params: { name, arguments: args } }),
21
+ });
22
+ expect(res.status).toBe(200);
23
+ const raw = await res.text();
24
+ const dataLines = raw.split("\n").filter(x => x.startsWith("data:"));
25
+ const payload = dataLines.length
26
+ ? JSON.parse(dataLines.at(-1)!.slice(5).trim())
27
+ : JSON.parse(raw);
28
+ return JSON.parse(payload.result.content[0].text);
29
+ }
30
+
31
+ // 30s 而不是 bun 默认的 5s:这个 hook 跑 register()(KDF)+bootServer(),
32
+ // 本机空载基线 ~620ms,而 2026-08-17 与 2026-08-31 两次 CI 上它被 5s 上限打死
33
+ // (0 pass / 1 fail / Ran 1 test —— 见 #928、#1627)。5247ms 是**被截断的下界**,
34
+ // 不是测量值,所以余量按基线的 ~48x 取,而不是按那个数取。
35
+ beforeAll(async () => {
36
+ process.env.COMMHUB_DB ||= join(dir, "hub.db");
37
+ const owner = register(`skill_owner_${Date.now()}`, "SkillHubOwner123!", undefined, "seed");
38
+ expect(owner.ok).toBe(true);
39
+ ownerToken = owner.token!; networkId = owner.network_id!;
40
+ const ownerId = db.get<{ user_id: string }>("SELECT owner_id AS user_id FROM networks WHERE network_id = ?1", networkId)!.user_id;
41
+ const node = createNetworkTokenForNode(ownerId, networkId, "skill-writer");
42
+ expect(node.ok).toBe(true); nodeToken = node.token!;
43
+ const foreign = register(`skill_foreign_${Date.now()}`, "SkillHubForeign123!", undefined, "seed");
44
+ expect(foreign.ok).toBe(true); foreignToken = foreign.token!;
45
+ const mod: any = await import("./server.js");
46
+ server = mod.bootServer({ port: 0, hostname: "127.0.0.1" });
47
+ base = `http://127.0.0.1:${server.port}`;
48
+ }, 30_000);
49
+
50
+ afterAll(() => { try { server?.stop?.(true); } catch {} try { rmSync(dir, { recursive: true, force: true }); } catch {} });
51
+
52
+ describe("SkillHub real Hub + SQLite", () => {
53
+ let skillId = "";
54
+ test("node submit is token-attributed, pending and immutable/idempotent", async () => {
55
+ const input = { network_id: networkId, slug: "incident-handoff", name: "Incident handoff", version: "1.0.0", description: "handoff", content: "# Incident handoff\n\nVerify facts." };
56
+ const first = await tool(nodeToken, "submit_skill", { ...input, source_alias: "forged-admin" });
57
+ expect(first.ok).toBe(true); expect(first.status).toBe("pending"); expect(first.source_alias).toBe("skill-writer"); skillId = first.skill_id;
58
+ const retry = await tool(nodeToken, "submit_skill", input);
59
+ expect(retry.idempotent).toBe(true); expect(retry.skill_id).toBe(skillId);
60
+ const conflict = await tool(nodeToken, "submit_skill", { ...input, content: "changed" });
61
+ expect(conflict.error).toBe("skill_version_conflict");
62
+ const raceBase = { ...input, slug: "concurrent-version", version: "2.0.0" };
63
+ const raced = await Promise.all([
64
+ tool(nodeToken, "submit_skill", { ...raceBase, content: "winner-a" }),
65
+ tool(nodeToken, "submit_skill", { ...raceBase, content: "winner-b" }),
66
+ ]);
67
+ expect(raced.filter(x => x.ok).length).toBe(1);
68
+ expect(raced.filter(x => x.error === "skill_version_conflict").length).toBe(1);
69
+ });
70
+
71
+ test("pending is reviewer-only; owner publishes; published becomes visible", async () => {
72
+ const nodeList = await tool(nodeToken, "list_skills", { network_id: networkId, include_pending: true });
73
+ expect(nodeList.skills).toHaveLength(0);
74
+ expect((await tool(nodeToken, "get_skill", { network_id: networkId, skill_id: skillId })).error).toBe("skill_not_found");
75
+ const ownerList = await tool(ownerToken, "list_skills", { network_id: networkId, include_pending: true });
76
+ expect(ownerList.reviewer).toBe(true); expect(ownerList.skills.map((x: any) => x.skill_id)).toContain(skillId);
77
+ expect((await tool(ownerToken, "get_skill", { network_id: networkId, skill_id: skillId })).skill.content).toContain("Verify facts");
78
+ const reviewed = await tool(ownerToken, "review_skill", { network_id: networkId, skill_id: skillId, decision: "published" });
79
+ expect(reviewed.status).toBe("published");
80
+ const published = await tool(nodeToken, "list_skills", { network_id: networkId });
81
+ expect(published.skills.map((x: any) => x.skill_id)).toContain(skillId);
82
+ expect((await tool(nodeToken, "get_skill", { network_id: networkId, skill_id: skillId })).skill.skill_id).toBe(skillId);
83
+ const detail = (await tool(nodeToken, "get_skill", { network_id: networkId, skill_id: skillId })).skill;
84
+ expect(detail.created_by_user).toBeUndefined(); expect(detail.reviewed_by_user).toBeUndefined(); expect(detail.content_hash).toBeUndefined();
85
+ });
86
+
87
+ test("foreign user cannot read or review another network", async () => {
88
+ expect((await tool(foreignToken, "list_skills", { network_id: networkId })).ok).toBe(false);
89
+ const review = await tool(foreignToken, "review_skill", { network_id: networkId, skill_id: skillId, decision: "rejected" });
90
+ expect(review.ok).toBe(false);
91
+ });
92
+ });
@@ -0,0 +1,109 @@
1
+ import { afterAll, beforeEach, describe, expect, test } from "bun:test";
2
+ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
3
+ import { db } from "./db.js";
4
+ import { registerTools } from "./tools.js";
5
+
6
+ const NET = "net_start_node"; const USER = "u_start_node";
7
+ const DAEMON = "node_start_daemon"; const DAEMON_ALIAS = "start-daemon";
8
+ const CHILD = "node_start_child"; const CHILD_ALIAS = "start-child";
9
+
10
+ function cleanup() {
11
+ for (const table of ["node_start_requests", "node_create_requests", "audit_log", "nodes", "api_tokens", "network_members", "networks"]) {
12
+ try { db.run(`DELETE FROM ${table} WHERE network_id = ?1`, [NET]); } catch {}
13
+ }
14
+ try { db.run("DELETE FROM users WHERE user_id=?1", USER); } catch {}
15
+ }
16
+ beforeEach(() => { cleanup();
17
+ db.run(`INSERT INTO users(user_id,username,password_hash,role,created_at) VALUES(?1,?1,'x','user',datetime('now'))`, USER);
18
+ db.run(`INSERT INTO networks(network_id,network_name,owner_id,created_at) VALUES(?1,?1,?2,datetime('now'))`, [NET, USER]);
19
+ db.run(`INSERT INTO network_members(user_id,network_id,role,joined_at) VALUES(?1,?2,'owner',datetime('now'))`, [USER, NET]);
20
+ db.run(`INSERT INTO nodes(node_id,node_name,alias,network_id,config_snapshot,hostname,created_at,updated_at,lifecycle_state) VALUES(?1,?2,?2,?3,'{}','h',datetime('now'),datetime('now'),'active')`, [DAEMON, DAEMON_ALIAS, NET]);
21
+ db.run(`INSERT INTO nodes(node_id,node_name,alias,network_id,config_snapshot,hostname,created_at,updated_at,lifecycle_state) VALUES(?1,?2,?2,?3,'{}','h',datetime('now'),datetime('now'),'stopped')`, [CHILD, CHILD_ALIAS, NET]);
22
+ db.run(`INSERT INTO api_tokens(token_id,user_id,network_id,scope,name,token_hash) VALUES('tok_start_daemon',?1,?2,'network',?3,'h')`, [USER, NET, `node:${DAEMON_ALIAS}`]);
23
+ db.run(`INSERT INTO node_create_requests(request_id,daemon_node_id,child_name,network_id,runtime,model,flags_json,env_keys,status,created_at,created_by_token,child_node_id) VALUES('cr_start_child',?1,?2,?3,'codex-sdk','x','{}','[]','succeeded',1,'t',?4)`, [DAEMON, CHILD_ALIAS, NET, CHILD]);
24
+ });
25
+ afterAll(cleanup);
26
+
27
+ function handlers(user: string | null, daemon = false) {
28
+ const s = new McpServer({ name: "t", version: "0" }) as any; const out: any = {};
29
+ const orig = s.tool.bind(s); s.tool = (n: string, d: string, schema: any, h: any) => { out[n] = h; return orig(n,d,schema,h); };
30
+ registerTools(s, undefined, daemon ? NET : null, user, null, daemon, daemon ? "tok_start_daemon" : null); return out;
31
+ }
32
+ async function call(h: any, args: any) { return JSON.parse((await h(args)).content[0].text); }
33
+
34
+ describe("start_node Hub -> daemon lifecycle", () => {
35
+ test("dispatch, authenticated pull, ack transitions stopped -> starting -> active", async () => {
36
+ const u = handlers(USER); const dispatch = await call(u.start_node, { child_node_id: CHILD, network_id: NET });
37
+ expect(dispatch.ok).toBe(true); expect(dispatch.lifecycle_state).toBe("starting");
38
+ const d = handlers(null, true); const pulled = await call(d.get_start_request, { request_id: dispatch.request_id });
39
+ expect(pulled).toMatchObject({ ok: true, child_node_id: CHILD, child_alias: CHILD_ALIAS });
40
+ const ack = await call(d.ack_start_request, { request_id: dispatch.request_id, status: "started", child_pid: 4321 });
41
+ expect(ack.ok).toBe(true);
42
+ expect(db.get<any>(`SELECT lifecycle_state FROM nodes WHERE node_id=?1`, CHILD)?.lifecycle_state).toBe("active");
43
+ expect(db.all<any>(`SELECT action FROM audit_log WHERE target_id=?1 ORDER BY id`, dispatch.request_id).map((x:any)=>x.action)).toEqual(["start_node_dispatched", "start_node_completed"]);
44
+ });
45
+ test("active child and caller-supplied wrong daemon fail closed", async () => {
46
+ const u = handlers(USER);
47
+ db.run(`UPDATE nodes SET lifecycle_state='active' WHERE node_id=?1`, CHILD);
48
+ expect((await call(u.start_node, { child_node_id: CHILD, network_id: NET })).error).toBe("node_not_stopped");
49
+ db.run(`UPDATE nodes SET lifecycle_state='stopped' WHERE node_id=?1`, CHILD);
50
+ expect((await call(u.start_node, { child_node_id: CHILD, daemon_node_id: "node_wrong", network_id: NET })).error).toBe("daemon_child_mismatch");
51
+ });
52
+ });
53
+
54
+ // #1448 finding-2 — stale-starting reaper(对齐 update_node_config/restart_node 的 60s
55
+ // single-flight stale-supersede)。start 只受理 stopped;卡在 starting 的节点(门铃丢 /
56
+ // daemon 在 UPDATE starting 后死)改前永远 start 不了(gate 返 node_not_stopped)、也无
57
+ // reaper 拉回 → 永久卡死。改后:in-flight start 请求晾过 60s ⇒ 标 timeout 超越 + 放行
58
+ // 重派;未过阈值 ⇒ 拒 node_already_starting。
59
+ describe("start_node — stale-starting reaper (#1448 finding-2)", () => {
60
+ function seedStartReq(reqId: string, status: string, ageMs: number) {
61
+ db.run(
62
+ `INSERT INTO node_start_requests(request_id,network_id,daemon_node_id,child_node_id,child_alias,created_by_token,status,created_at)
63
+ VALUES(?1,?2,?3,?4,?5,'t',?6,?7)`,
64
+ [reqId, NET, DAEMON, CHILD, CHILD_ALIAS, status, Date.now() - ageMs],
65
+ );
66
+ }
67
+
68
+ test("starting + FRESH in-flight start (< 60s) → refused node_already_starting (not superseded)", async () => {
69
+ db.run(`UPDATE nodes SET lifecycle_state='starting' WHERE node_id=?1`, CHILD);
70
+ seedStartReq("str_fresh", "delivered", 5_000); // 5s old — within threshold
71
+ const u = handlers(USER);
72
+ const r = await call(u.start_node, { child_node_id: CHILD, network_id: NET });
73
+ expect(r.ok).toBe(false);
74
+ expect(r.error).toBe("node_already_starting");
75
+ expect(r.existing_request_id).toBe("str_fresh");
76
+ expect(typeof r.age_ms).toBe("number");
77
+ // old request untouched, no new dispatch
78
+ expect(db.get<any>(`SELECT status FROM node_start_requests WHERE request_id='str_fresh'`)?.status).toBe("delivered");
79
+ });
80
+
81
+ // witnessed-red:改前 gate 直接 `!== 'stopped' → node_not_stopped`,一个 stale 的
82
+ // 'starting' 节点返回 node_not_stopped、永远卡死。改后应超越重派(ok:true)。
83
+ test("starting + STALE in-flight start (> 60s) → supersede old + re-dispatch (converges)", async () => {
84
+ db.run(`UPDATE nodes SET lifecycle_state='starting' WHERE node_id=?1`, CHILD);
85
+ seedStartReq("str_stale", "delivered", 61_000); // 61s old — past 60s threshold
86
+ const u = handlers(USER);
87
+ const r = await call(u.start_node, { child_node_id: CHILD, network_id: NET });
88
+ expect(r.ok).toBe(true);
89
+ expect(r.lifecycle_state).toBe("starting");
90
+ expect(typeof r.request_id).toBe("string");
91
+ expect(r.request_id).not.toBe("str_stale"); // fresh request
92
+ // old stale request superseded → terminal, unblocks the child-inflight unique index
93
+ expect(db.get<any>(`SELECT status FROM node_start_requests WHERE request_id='str_stale'`)?.status).toBe("timeout");
94
+ // exactly one non-terminal start request now (the new one)
95
+ const live = db.all<any>(`SELECT request_id FROM node_start_requests WHERE child_node_id=?1 AND status IN ('pending','delivered')`, CHILD);
96
+ expect(live.map((x:any)=>x.request_id)).toEqual([r.request_id]);
97
+ // audit records the real prior state
98
+ const aud = db.get<any>(`SELECT detail FROM audit_log WHERE target_id=?1`, r.request_id);
99
+ expect(JSON.parse(aud.detail).lifecycle_state_before).toBe("starting");
100
+ });
101
+
102
+ test("starting + NO in-flight row (orphaned state) → self-heals by re-dispatching", async () => {
103
+ db.run(`UPDATE nodes SET lifecycle_state='starting' WHERE node_id=?1`, CHILD);
104
+ const u = handlers(USER);
105
+ const r = await call(u.start_node, { child_node_id: CHILD, network_id: NET });
106
+ expect(r.ok).toBe(true);
107
+ expect(r.lifecycle_state).toBe("starting");
108
+ });
109
+ });
@@ -0,0 +1,106 @@
1
+ // GET /api/status?alias=<name> — one agent's rows instead of the whole network.
2
+ // The app's chat info / node detail read the FULL projection for a single agent; unfiltered that
3
+ // was every session (533 KB raw / 94 KB gzip on the production network) per open and per 10 s poll.
4
+ // Old hubs ignore the parameter, so the app keeps picking its row by alias; this suite pins that
5
+ // the filter narrows, never widens (network scope still applies), and that no/blank alias is the
6
+ // old response.
7
+
8
+ import { describe, expect, test, beforeAll, afterAll } from "bun:test";
9
+ import { mkdtempSync, rmSync } from "fs";
10
+ import { join } from "path";
11
+ import { tmpdir } from "os";
12
+ import { register } from "./auth.js";
13
+ import { db } from "./db.js";
14
+
15
+ const DIR = mkdtempSync(join(tmpdir(), "anet-status-alias-"));
16
+ let BASE = "";
17
+ let hub: any = null;
18
+ const PW = "StatusAliasPassw0rd!";
19
+ let aToken = "", aId = "", NET_A = "";
20
+ let bToken = "", bId = "", NET_B = "";
21
+
22
+ async function get(token: string, path: string) {
23
+ const res = await fetch(`${BASE}${path}`, { headers: { Authorization: `Bearer ${token}` } });
24
+ return { status: res.status, body: await res.json().catch(() => null) as any };
25
+ }
26
+ function seed(alias: string, node: string, net: string, owner: string, minutesAgo: number) {
27
+ db.run(`INSERT INTO nodes (node_id, node_name, alias, network_id, owner_user_id) VALUES (?1, ?2, ?2, ?3, ?4)`, [node, alias, net, owner]);
28
+ db.run(
29
+ `INSERT INTO sessions (resume_id, alias, node_id, status, network_id, task, updated_at, last_seen_at) VALUES (?1, ?2, ?3, 'idle', ?4, ?5, datetime('now', ?6), datetime('now'))`,
30
+ [`r_${node}`, alias, node, net, `task of ${alias}`, `-${minutesAgo} minutes`],
31
+ );
32
+ }
33
+ const aliases = (rows: any[]) => rows.map(r => r.alias);
34
+
35
+ beforeAll(async () => {
36
+ process.env.COMMHUB_DB ||= join(DIR, "hub.db");
37
+ process.env.COMMHUB_UPLOADS_DIR = join(DIR, "uploads");
38
+ process.env.HOST = "127.0.0.1";
39
+ const a = register(`sa_owner_a_${Date.now()}`, PW);
40
+ aToken = a.token!; aId = a.user!.user_id; NET_A = a.network_id!;
41
+ const b = register(`sa_owner_b_${Date.now()}`, PW);
42
+ bToken = b.token!; bId = b.user!.user_id; NET_B = b.network_id!;
43
+ seed("sa-one", "node_sa_one", NET_A, aId, 1);
44
+ seed("sa-two", "node_sa_two", NET_A, aId, 2);
45
+ seed("sa-three", "node_sa_three", NET_A, aId, 3);
46
+ // Same alias in someone else's network: the filter must not reach it.
47
+ seed("sa-two", "node_sa_two_b", NET_B, bId, 0);
48
+ const mod: any = await import("./server.js");
49
+ hub = mod.bootServer({ port: 0, hostname: "127.0.0.1" });
50
+ BASE = `http://127.0.0.1:${hub.port}`;
51
+ }, 30_000);
52
+
53
+ afterAll(() => {
54
+ try { hub?.stop?.(true); } catch {}
55
+ try { rmSync(DIR, { recursive: true, force: true }); } catch {}
56
+ });
57
+
58
+ describe("/api/status?alias=", () => {
59
+ test("no alias: every session in scope, newest first (unchanged)", async () => {
60
+ const r = await get(aToken, `/api/status?network_id=${NET_A}`);
61
+ expect(r.status).toBe(200);
62
+ expect(aliases(r.body.sessions)).toEqual(["sa-one", "sa-two", "sa-three"]);
63
+ expect(r.body.summary.total).toBe(3);
64
+ });
65
+
66
+ test("alias narrows the full projection to that agent", async () => {
67
+ const r = await get(aToken, `/api/status?network_id=${NET_A}&alias=sa-two`);
68
+ expect(r.status).toBe(200);
69
+ expect(aliases(r.body.sessions)).toEqual(["sa-two"]);
70
+ expect(r.body.sessions[0].node_id).toBe("node_sa_two");
71
+ // still the full projection (capability bits / host block), not the light one
72
+ expect(typeof r.body.sessions[0].rules_file_capable).toBe("boolean");
73
+ expect(r.body.sessions[0].host).toBeDefined();
74
+ expect(r.body.summary.total).toBe(1);
75
+ });
76
+
77
+ test("alias narrows the light projection too", async () => {
78
+ const r = await get(aToken, `/api/status?light=1&network_id=${NET_A}&alias=sa-three`);
79
+ expect(aliases(r.body.sessions)).toEqual(["sa-three"]);
80
+ expect(r.body.sessions[0].host).toBeUndefined();
81
+ });
82
+
83
+ test("the filter never widens scope: same alias in another network stays invisible", async () => {
84
+ const scoped = await get(aToken, `/api/status?network_id=${NET_A}&alias=sa-two`);
85
+ expect(scoped.body.sessions.map((s: any) => s.node_id)).toEqual(["node_sa_two"]);
86
+ // Unscoped: whatever the caller's scope already shows (the first registered user is an admin
87
+ // here, so that is both networks) — the filter only picks rows out of it, never adds any.
88
+ const all = await get(aToken, `/api/status`);
89
+ const unscoped = await get(aToken, `/api/status?alias=sa-two`);
90
+ expect(unscoped.body.sessions.map((s: any) => s.node_id)).toEqual(all.body.sessions.filter((s: any) => s.alias === "sa-two").map((s: any) => s.node_id));
91
+ });
92
+
93
+ test("a non-admin member only ever gets their own network's row for a shared alias", async () => {
94
+ const r = await get(bToken, `/api/status?alias=sa-two`);
95
+ expect(r.body.sessions.map((s: any) => s.node_id)).toEqual(["node_sa_two_b"]);
96
+ const other = await get(bToken, `/api/status?alias=sa-one`);
97
+ expect(other.body.sessions).toEqual([]);
98
+ });
99
+
100
+ test("blank alias is ignored; unknown alias is an empty list, not an error", async () => {
101
+ expect(aliases((await get(aToken, `/api/status?network_id=${NET_A}&alias=%20`)).body.sessions)).toEqual(["sa-one", "sa-two", "sa-three"]);
102
+ const none = await get(aToken, `/api/status?network_id=${NET_A}&alias=nobody`);
103
+ expect(none.status).toBe(200);
104
+ expect(none.body.sessions).toEqual([]);
105
+ });
106
+ });