@memnexus-ai/mx-agent-cli 0.1.293 → 0.1.294-next.0

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 (215) hide show
  1. package/dist/__tests__/config-sync.test.js +54 -1
  2. package/dist/__tests__/config-sync.test.js.map +1 -1
  3. package/dist/__tests__/decision-check.test.d.ts +2 -0
  4. package/dist/__tests__/decision-check.test.d.ts.map +1 -0
  5. package/dist/__tests__/decision-check.test.js +105 -0
  6. package/dist/__tests__/decision-check.test.js.map +1 -0
  7. package/dist/__tests__/harness-extract.test.d.ts +19 -0
  8. package/dist/__tests__/harness-extract.test.d.ts.map +1 -0
  9. package/dist/__tests__/harness-extract.test.js +566 -0
  10. package/dist/__tests__/harness-extract.test.js.map +1 -0
  11. package/dist/__tests__/harness-wiring.test.d.ts +16 -0
  12. package/dist/__tests__/harness-wiring.test.d.ts.map +1 -0
  13. package/dist/__tests__/harness-wiring.test.js +469 -0
  14. package/dist/__tests__/harness-wiring.test.js.map +1 -0
  15. package/dist/__tests__/report-format.test.d.ts +2 -0
  16. package/dist/__tests__/report-format.test.d.ts.map +1 -0
  17. package/dist/__tests__/report-format.test.js +219 -0
  18. package/dist/__tests__/report-format.test.js.map +1 -0
  19. package/dist/__tests__/standards-injection.test.d.ts +2 -0
  20. package/dist/__tests__/standards-injection.test.d.ts.map +1 -0
  21. package/dist/__tests__/standards-injection.test.js +157 -0
  22. package/dist/__tests__/standards-injection.test.js.map +1 -0
  23. package/dist/agent-config/hooks/auto-capture-precompact.sh +74 -4
  24. package/dist/agent-config/hooks/auto-capture-session-end.sh +106 -4
  25. package/dist/agent-config/hooks/auto-checkpoint.sh +75 -5
  26. package/dist/agent-config/hooks/observability-sync.sh +46 -9
  27. package/dist/commands/config-sync.d.ts +37 -0
  28. package/dist/commands/config-sync.d.ts.map +1 -1
  29. package/dist/commands/config-sync.js +36 -18
  30. package/dist/commands/config-sync.js.map +1 -1
  31. package/dist/commands/dashboard.d.ts.map +1 -1
  32. package/dist/commands/dashboard.js +10 -2
  33. package/dist/commands/dashboard.js.map +1 -1
  34. package/dist/commands/decision.d.ts +20 -0
  35. package/dist/commands/decision.d.ts.map +1 -0
  36. package/dist/commands/decision.js +54 -0
  37. package/dist/commands/decision.js.map +1 -0
  38. package/dist/commands/monitor.d.ts.map +1 -1
  39. package/dist/commands/monitor.js +8 -2
  40. package/dist/commands/monitor.js.map +1 -1
  41. package/dist/commands/report.d.ts +33 -0
  42. package/dist/commands/report.d.ts.map +1 -0
  43. package/dist/commands/report.js +73 -0
  44. package/dist/commands/report.js.map +1 -0
  45. package/dist/commands/start.d.ts +4 -0
  46. package/dist/commands/start.d.ts.map +1 -1
  47. package/dist/commands/start.js +6 -0
  48. package/dist/commands/start.js.map +1 -1
  49. package/dist/commands/update.d.ts +13 -1
  50. package/dist/commands/update.d.ts.map +1 -1
  51. package/dist/commands/update.js +50 -1
  52. package/dist/commands/update.js.map +1 -1
  53. package/dist/index.d.ts.map +1 -1
  54. package/dist/index.js +67 -3
  55. package/dist/index.js.map +1 -1
  56. package/dist/lib/agent-session.d.ts +12 -0
  57. package/dist/lib/agent-session.d.ts.map +1 -1
  58. package/dist/lib/agent-session.js +183 -41
  59. package/dist/lib/agent-session.js.map +1 -1
  60. package/dist/lib/claude.d.ts +12 -0
  61. package/dist/lib/claude.d.ts.map +1 -1
  62. package/dist/lib/claude.js +29 -2
  63. package/dist/lib/claude.js.map +1 -1
  64. package/dist/lib/decision-check.d.ts +48 -0
  65. package/dist/lib/decision-check.d.ts.map +1 -0
  66. package/dist/lib/decision-check.js +149 -0
  67. package/dist/lib/decision-check.js.map +1 -0
  68. package/dist/lib/harness/console/announce.d.ts +45 -0
  69. package/dist/lib/harness/console/announce.d.ts.map +1 -0
  70. package/dist/lib/harness/console/announce.js +48 -0
  71. package/dist/lib/harness/console/announce.js.map +1 -0
  72. package/dist/lib/harness/console/announce.test.d.ts +2 -0
  73. package/dist/lib/harness/console/announce.test.d.ts.map +1 -0
  74. package/dist/lib/harness/console/announce.test.js +104 -0
  75. package/dist/lib/harness/console/announce.test.js.map +1 -0
  76. package/dist/lib/harness/console/by-session.d.ts +50 -0
  77. package/dist/lib/harness/console/by-session.d.ts.map +1 -0
  78. package/dist/lib/harness/console/by-session.js +83 -0
  79. package/dist/lib/harness/console/by-session.js.map +1 -0
  80. package/dist/lib/harness/console/by-session.test.d.ts +2 -0
  81. package/dist/lib/harness/console/by-session.test.d.ts.map +1 -0
  82. package/dist/lib/harness/console/by-session.test.js +86 -0
  83. package/dist/lib/harness/console/by-session.test.js.map +1 -0
  84. package/dist/lib/harness/console/console.d.ts +67 -0
  85. package/dist/lib/harness/console/console.d.ts.map +1 -0
  86. package/dist/lib/harness/console/console.js +373 -0
  87. package/dist/lib/harness/console/console.js.map +1 -0
  88. package/dist/lib/harness/console/console.test.d.ts +2 -0
  89. package/dist/lib/harness/console/console.test.d.ts.map +1 -0
  90. package/dist/lib/harness/console/console.test.js +269 -0
  91. package/dist/lib/harness/console/console.test.js.map +1 -0
  92. package/dist/lib/harness/console/decision-request.d.ts +32 -0
  93. package/dist/lib/harness/console/decision-request.d.ts.map +1 -0
  94. package/dist/lib/harness/console/decision-request.js +112 -0
  95. package/dist/lib/harness/console/decision-request.js.map +1 -0
  96. package/dist/lib/harness/console/decision-request.test.d.ts +2 -0
  97. package/dist/lib/harness/console/decision-request.test.d.ts.map +1 -0
  98. package/dist/lib/harness/console/decision-request.test.js +75 -0
  99. package/dist/lib/harness/console/decision-request.test.js.map +1 -0
  100. package/dist/lib/harness/console/fixtures.d.ts +16 -0
  101. package/dist/lib/harness/console/fixtures.d.ts.map +1 -0
  102. package/dist/lib/harness/console/fixtures.js +49 -0
  103. package/dist/lib/harness/console/fixtures.js.map +1 -0
  104. package/dist/lib/harness/console/index.d.ts +15 -0
  105. package/dist/lib/harness/console/index.d.ts.map +1 -0
  106. package/dist/lib/harness/console/index.js +14 -0
  107. package/dist/lib/harness/console/index.js.map +1 -0
  108. package/dist/lib/harness/console/rank.d.ts +73 -0
  109. package/dist/lib/harness/console/rank.d.ts.map +1 -0
  110. package/dist/lib/harness/console/rank.js +113 -0
  111. package/dist/lib/harness/console/rank.js.map +1 -0
  112. package/dist/lib/harness/console/rank.test.d.ts +2 -0
  113. package/dist/lib/harness/console/rank.test.d.ts.map +1 -0
  114. package/dist/lib/harness/console/rank.test.js +124 -0
  115. package/dist/lib/harness/console/rank.test.js.map +1 -0
  116. package/dist/lib/harness/console/render.d.ts +22 -0
  117. package/dist/lib/harness/console/render.d.ts.map +1 -0
  118. package/dist/lib/harness/console/render.js +65 -0
  119. package/dist/lib/harness/console/render.js.map +1 -0
  120. package/dist/lib/harness/console/render.test.d.ts +2 -0
  121. package/dist/lib/harness/console/render.test.d.ts.map +1 -0
  122. package/dist/lib/harness/console/render.test.js +96 -0
  123. package/dist/lib/harness/console/render.test.js.map +1 -0
  124. package/dist/lib/harness/console/replay-cli.test.d.ts +2 -0
  125. package/dist/lib/harness/console/replay-cli.test.d.ts.map +1 -0
  126. package/dist/lib/harness/console/replay-cli.test.js +96 -0
  127. package/dist/lib/harness/console/replay-cli.test.js.map +1 -0
  128. package/dist/lib/harness/console/replay.d.ts +36 -0
  129. package/dist/lib/harness/console/replay.d.ts.map +1 -0
  130. package/dist/lib/harness/console/replay.js +59 -0
  131. package/dist/lib/harness/console/replay.js.map +1 -0
  132. package/dist/lib/harness/console/replay.test.d.ts +2 -0
  133. package/dist/lib/harness/console/replay.test.d.ts.map +1 -0
  134. package/dist/lib/harness/console/replay.test.js +81 -0
  135. package/dist/lib/harness/console/replay.test.js.map +1 -0
  136. package/dist/lib/harness/console/turn-reader.d.ts +50 -0
  137. package/dist/lib/harness/console/turn-reader.d.ts.map +1 -0
  138. package/dist/lib/harness/console/turn-reader.js +184 -0
  139. package/dist/lib/harness/console/turn-reader.js.map +1 -0
  140. package/dist/lib/harness/console/turn-reader.test.d.ts +2 -0
  141. package/dist/lib/harness/console/turn-reader.test.d.ts.map +1 -0
  142. package/dist/lib/harness/console/turn-reader.test.js +108 -0
  143. package/dist/lib/harness/console/turn-reader.test.js.map +1 -0
  144. package/dist/lib/harness/console/types.d.ts +109 -0
  145. package/dist/lib/harness/console/types.d.ts.map +1 -0
  146. package/dist/lib/harness/console/types.js +2 -0
  147. package/dist/lib/harness/console/types.js.map +1 -0
  148. package/dist/lib/harness/contract.d.ts +229 -0
  149. package/dist/lib/harness/contract.d.ts.map +1 -0
  150. package/dist/lib/harness/contract.js +22 -0
  151. package/dist/lib/harness/contract.js.map +1 -0
  152. package/dist/lib/harness/credential.d.ts +23 -0
  153. package/dist/lib/harness/credential.d.ts.map +1 -0
  154. package/dist/lib/harness/credential.js +81 -0
  155. package/dist/lib/harness/credential.js.map +1 -0
  156. package/dist/lib/harness/credential.test.d.ts +2 -0
  157. package/dist/lib/harness/credential.test.d.ts.map +1 -0
  158. package/dist/lib/harness/credential.test.js +74 -0
  159. package/dist/lib/harness/credential.test.js.map +1 -0
  160. package/dist/lib/harness/evaluate.d.ts +390 -0
  161. package/dist/lib/harness/evaluate.d.ts.map +1 -0
  162. package/dist/lib/harness/evaluate.js +988 -0
  163. package/dist/lib/harness/evaluate.js.map +1 -0
  164. package/dist/lib/harness/evaluate.test.d.ts +2 -0
  165. package/dist/lib/harness/evaluate.test.d.ts.map +1 -0
  166. package/dist/lib/harness/evaluate.test.js +621 -0
  167. package/dist/lib/harness/evaluate.test.js.map +1 -0
  168. package/dist/lib/harness/extract.d.ts +152 -0
  169. package/dist/lib/harness/extract.d.ts.map +1 -0
  170. package/dist/lib/harness/extract.js +1601 -0
  171. package/dist/lib/harness/extract.js.map +1 -0
  172. package/dist/lib/harness/gate.d.ts +48 -0
  173. package/dist/lib/harness/gate.d.ts.map +1 -0
  174. package/dist/lib/harness/gate.js +60 -0
  175. package/dist/lib/harness/gate.js.map +1 -0
  176. package/dist/lib/harness/gate.test.d.ts +2 -0
  177. package/dist/lib/harness/gate.test.d.ts.map +1 -0
  178. package/dist/lib/harness/gate.test.js +111 -0
  179. package/dist/lib/harness/gate.test.js.map +1 -0
  180. package/dist/lib/harness/self-check.d.ts +59 -0
  181. package/dist/lib/harness/self-check.d.ts.map +1 -0
  182. package/dist/lib/harness/self-check.js +56 -0
  183. package/dist/lib/harness/self-check.js.map +1 -0
  184. package/dist/lib/harness/self-check.test.d.ts +2 -0
  185. package/dist/lib/harness/self-check.test.d.ts.map +1 -0
  186. package/dist/lib/harness/self-check.test.js +43 -0
  187. package/dist/lib/harness/self-check.test.js.map +1 -0
  188. package/dist/lib/harness/transcript.d.ts +65 -0
  189. package/dist/lib/harness/transcript.d.ts.map +1 -0
  190. package/dist/lib/harness/transcript.js +144 -0
  191. package/dist/lib/harness/transcript.js.map +1 -0
  192. package/dist/lib/harness/transcript.test.d.ts +2 -0
  193. package/dist/lib/harness/transcript.test.d.ts.map +1 -0
  194. package/dist/lib/harness/transcript.test.js +118 -0
  195. package/dist/lib/harness/transcript.test.js.map +1 -0
  196. package/dist/lib/harness-wiring.d.ts +145 -0
  197. package/dist/lib/harness-wiring.d.ts.map +1 -0
  198. package/dist/lib/harness-wiring.js +280 -0
  199. package/dist/lib/harness-wiring.js.map +1 -0
  200. package/dist/lib/report-format.d.ts +132 -0
  201. package/dist/lib/report-format.d.ts.map +1 -0
  202. package/dist/lib/report-format.js +317 -0
  203. package/dist/lib/report-format.js.map +1 -0
  204. package/dist/lib/standards.d.ts +90 -0
  205. package/dist/lib/standards.d.ts.map +1 -0
  206. package/dist/lib/standards.js +194 -0
  207. package/dist/lib/standards.js.map +1 -0
  208. package/dist/lib/terminal-ui.d.ts.map +1 -1
  209. package/dist/lib/terminal-ui.js +12 -1
  210. package/dist/lib/terminal-ui.js.map +1 -1
  211. package/dist/standards/decision-request.md +90 -0
  212. package/dist/standards/fail-loud-standard.md +495 -0
  213. package/dist/standards/report-format.md +120 -0
  214. package/dist/standards/writing-standard.md +240 -0
  215. package/package.json +3 -2
@@ -0,0 +1,48 @@
1
+ const clip = (s, n = 110) => {
2
+ const line = String(s ?? '').replace(/\s+/g, ' ').trim();
3
+ return line.length > n ? line.slice(0, n).trimEnd() + '…' : line;
4
+ };
5
+ /** One item, as two lines: what it is, and the evidence for it. */
6
+ export function renderAnnouncement(item) {
7
+ const mark = item.lowConfidence ? ' (unverified, read from the agent\'s own words)' : '';
8
+ const lines = [` NEEDS YOU ${item.kind} ${item.principal.team}${mark}`];
9
+ lines.push(` ${clip(item.headline, 120)}`);
10
+ // Two detail lines, not one. For a refusal the first is the rule and the
11
+ // second is the reason, and the reason is the half a person needs to decide
12
+ // whether the rule was wrong or the attempt was.
13
+ for (const d of (item.detail ?? []).slice(0, 2))
14
+ lines.push(` ${clip(d)}`);
15
+ return lines;
16
+ }
17
+ /**
18
+ * Subscribe to a console and print what appears.
19
+ *
20
+ * Returns the unsubscribe function, so a session can stop announcing without
21
+ * tearing down the console that other sessions are still feeding.
22
+ */
23
+ export function attachAnnouncer(fleet, options) {
24
+ const { write } = options;
25
+ const includeLow = options.includeLowConfidence !== false;
26
+ const maxPerChange = options.maxPerChange ?? 3;
27
+ return fleet.subscribe((change) => {
28
+ const added = change.added.filter((i) => includeLow || i.lowConfidence !== true);
29
+ if (added.length > 0) {
30
+ write('');
31
+ const shown = added.slice(0, maxPerChange);
32
+ for (const item of shown)
33
+ for (const line of renderAnnouncement(item))
34
+ write(line);
35
+ if (added.length > shown.length) {
36
+ write(` and ${added.length - shown.length} more. Run \`mx-agent console\` for the list.`);
37
+ }
38
+ write('');
39
+ return;
40
+ }
41
+ // Nothing new. A cleared item is worth one line, because an operator who
42
+ // was told about something is owed the news that it went away.
43
+ if (change.removed.length > 0) {
44
+ write(` cleared: ${change.removed.length} item(s) no longer need you.`);
45
+ }
46
+ });
47
+ }
48
+ //# sourceMappingURL=announce.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"announce.js","sourceRoot":"","sources":["../../../../src/lib/harness/console/announce.ts"],"names":[],"mappings":"AAqCA,MAAM,IAAI,GAAG,CAAC,CAAS,EAAE,CAAC,GAAG,GAAG,EAAU,EAAE;IAC1C,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACzD,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AACnE,CAAC,CAAC;AAEF,mEAAmE;AACnE,MAAM,UAAU,kBAAkB,CAAC,IAAiB;IAClD,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,iDAAiD,CAAC,CAAC,CAAC,EAAE,CAAC;IACzF,MAAM,KAAK,GAAG,CAAC,gBAAgB,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,SAAS,CAAC,IAAI,GAAG,IAAI,EAAE,CAAC,CAAC;IAC3E,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;IAC9C,yEAAyE;IACzE,4EAA4E;IAC5E,iDAAiD;IACjD,KAAK,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC9E,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,KAAmB,EAAE,OAAwB;IAC3E,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;IAC1B,MAAM,UAAU,GAAG,OAAO,CAAC,oBAAoB,KAAK,KAAK,CAAC;IAC1D,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,CAAC,CAAC;IAE/C,OAAO,KAAK,CAAC,SAAS,CAAC,CAAC,MAAqB,EAAE,EAAE;QAC/C,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,IAAI,CAAC,CAAC,aAAa,KAAK,IAAI,CAAC,CAAC;QAEjF,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,KAAK,CAAC,EAAE,CAAC,CAAC;YACV,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;YAC3C,KAAK,MAAM,IAAI,IAAI,KAAK;gBAAE,KAAK,MAAM,IAAI,IAAI,kBAAkB,CAAC,IAAI,CAAC;oBAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACnF,IAAI,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;gBAChC,KAAK,CAAC,SAAS,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,+CAA+C,CAAC,CAAC;YAC7F,CAAC;YACD,KAAK,CAAC,EAAE,CAAC,CAAC;YACV,OAAO;QACT,CAAC;QAED,yEAAyE;QACzE,+DAA+D;QAC/D,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,KAAK,CAAC,cAAc,MAAM,CAAC,OAAO,CAAC,MAAM,8BAA8B,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=announce.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"announce.test.d.ts","sourceRoot":"","sources":["../../../../src/lib/harness/console/announce.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,104 @@
1
+ import { describe, it, expect } from 'vitest';
2
+ import { FleetConsole } from './console.js';
3
+ import { attachAnnouncer, renderAnnouncement } from './announce.js';
4
+ const principal = { team: 'product', role: 'lead', subagentId: null, sessionId: 's1' };
5
+ const at = (n) => new Date(Date.UTC(2026, 7, 18, 10, n)).toISOString();
6
+ const refusal = (n, session = 's1') => ({
7
+ type: 'decision',
8
+ at: at(n),
9
+ principal: { ...principal, sessionId: session },
10
+ attrs: { operation: 'write', writes: ['/workspace/other/x.ts'], reads: [], uncertain: false },
11
+ decision: { effect: 'deny', matchedRules: ['no-write-outside'], reason: 'outside the worktree' },
12
+ });
13
+ function harness() {
14
+ const lines = [];
15
+ const fleet = new FleetConsole();
16
+ const stop = attachAnnouncer(fleet, { write: (l) => lines.push(l) });
17
+ return { fleet, lines, stop, out: () => lines.join('\n') };
18
+ }
19
+ describe('attachAnnouncer', () => {
20
+ it('says nothing until something needs a person', () => {
21
+ const h = harness();
22
+ h.fleet.emit({ type: 'session-start', at: at(0), principal, credential: { kind: 'subscription', source: 'x' } });
23
+ h.fleet.emit({ type: 'turn', at: at(1), principal, text: 'working on it', turnIndex: 1 });
24
+ expect(h.out()).toBe('');
25
+ });
26
+ it('announces a refusal without anybody asking', () => {
27
+ const h = harness();
28
+ h.fleet.emit(refusal(2));
29
+ expect(h.out()).toContain('NEEDS YOU');
30
+ expect(h.out()).toContain('product');
31
+ expect(h.out()).toContain('outside the worktree');
32
+ });
33
+ it('does not repeat an item it has already announced', () => {
34
+ const h = harness();
35
+ h.fleet.emit(refusal(2));
36
+ const first = h.lines.length;
37
+ h.fleet.emit({ type: 'turn', at: at(3), principal, text: 'still going', turnIndex: 2 });
38
+ expect(h.lines.length).toBe(first);
39
+ });
40
+ // The console notifies per event, so `added` holds one item almost always and
41
+ // the burst path is defensive rather than routine. Asserted through the
42
+ // subscriber directly, because driving six events produces six changes of one
43
+ // rather than one change of six.
44
+ it('summarises a burst rather than printing a wall', () => {
45
+ const lines = [];
46
+ const fleet = new FleetConsole();
47
+ let captured = null;
48
+ const original = fleet.subscribe.bind(fleet);
49
+ fleet.subscribe = ((fn) => { captured = fn; return original(fn); });
50
+ attachAnnouncer(fleet, { write: (l) => lines.push(l) });
51
+ const item = (n) => ({
52
+ id: `i${n}`, kind: 'refusal', sessionId: `s${n}`, principal, at: at(n), score: 900,
53
+ headline: `refusal ${n}`, detail: [], repeats: 1,
54
+ });
55
+ captured({ items: [], added: [1, 2, 3, 4, 5, 6].map(item), removed: [] });
56
+ expect(lines.join('\n')).toContain('more. Run `mx-agent console`');
57
+ });
58
+ // A session ending adds a `stopped` item, which is itself something a person
59
+ // may need. So the correct behaviour after session-end is a new announcement
60
+ // about the stop, not silence. The property that matters is that the original
61
+ // refusal is not announced a second time.
62
+ it('announces a stop as its own item, without repeating what it already said', () => {
63
+ const h = harness();
64
+ h.fleet.emit(refusal(2));
65
+ expect(h.out()).toContain('outside the worktree');
66
+ h.lines.length = 0;
67
+ h.fleet.emit({ type: 'session-end', at: at(9), principal, reason: 'finished' });
68
+ expect(h.out()).not.toContain('outside the worktree');
69
+ });
70
+ it('stops when unsubscribed', () => {
71
+ const h = harness();
72
+ h.stop();
73
+ h.fleet.emit(refusal(2));
74
+ expect(h.out()).toBe('');
75
+ });
76
+ it('can withhold items the console cannot vouch for', () => {
77
+ const lines = [];
78
+ const fleet = new FleetConsole();
79
+ attachAnnouncer(fleet, { write: (l) => lines.push(l), includeLowConfidence: false });
80
+ fleet.emit({
81
+ type: 'turn', at: at(2), principal,
82
+ text: 'This one needs your decision, and I did not ask.', turnIndex: 1,
83
+ });
84
+ expect(lines.join('\n')).not.toContain('NEEDS YOU');
85
+ });
86
+ });
87
+ describe('renderAnnouncement', () => {
88
+ it('marks an item read from prose as unverified', () => {
89
+ const out = renderAnnouncement({
90
+ id: 'x', kind: 'prose', sessionId: 's1', principal, at: at(1), score: 100,
91
+ headline: 'the agent says a decision is needed', detail: ['turn 12'], repeats: 1,
92
+ lowConfidence: true,
93
+ }).join('\n');
94
+ expect(out).toContain('unverified');
95
+ });
96
+ it('does not mark a guard refusal as unverified', () => {
97
+ const out = renderAnnouncement({
98
+ id: 'y', kind: 'refusal', sessionId: 's1', principal, at: at(1), score: 900,
99
+ headline: 'a guard refused a write', detail: ['rule: no-write-outside'], repeats: 1,
100
+ }).join('\n');
101
+ expect(out).not.toContain('unverified');
102
+ });
103
+ });
104
+ //# sourceMappingURL=announce.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"announce.test.js","sourceRoot":"","sources":["../../../../src/lib/harness/console/announce.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,50 @@
1
+ /**
2
+ * One row per session instead of one per moment.
3
+ *
4
+ * A week of real fleet work produced 411 ranked items across 47 sessions. As a
5
+ * list of moments that is unreadable, and one session appeared nine times, once
6
+ * with a repeat count of 44. The operator's question is not "what happened",
7
+ * it is "does this team need me", and that question has one answer per team.
8
+ *
9
+ * So a row is a session, showing its worst open item and a count of the rest.
10
+ * The detail stays reachable rather than discarded, because the moment the
11
+ * operator decides a team needs them, the next thing they want is everything
12
+ * that team is holding.
13
+ *
14
+ * Chosen on 2026-08-18 with the product owner's agreement to pick and iterate.
15
+ * The alternative, one row per moment, is still available: it is the ungrouped
16
+ * `snapshot()` this builds on.
17
+ */
18
+ import type { ConsoleItem, ItemKind } from './types.js';
19
+ export interface SessionRow {
20
+ sessionId: string;
21
+ team: string;
22
+ /** Highest-consequence open item. The row is sorted by this item's score. */
23
+ top: ConsoleItem;
24
+ /** Everything else this session is holding, worst first. */
25
+ rest: ConsoleItem[];
26
+ /** How many items in total, including `top`. */
27
+ total: number;
28
+ /** Counts by kind, so a row can say what shape the backlog is. */
29
+ byKind: Partial<Record<ItemKind, number>>;
30
+ /** The most recent item's timestamp, for age. */
31
+ latest: string;
32
+ /** True when every item is one the console cannot vouch for. */
33
+ allLowConfidence: boolean;
34
+ }
35
+ /**
36
+ * Group ranked items into one row per session.
37
+ *
38
+ * Order is by the worst item in each session, not by the count. A session with
39
+ * one refusal outranks a session with nine pieces of prose, because ranking by
40
+ * volume would put the noisiest team at the top rather than the one in trouble.
41
+ */
42
+ export declare function groupBySession(items: ConsoleItem[]): SessionRow[];
43
+ export interface SessionRenderOptions {
44
+ limit?: number;
45
+ /** Show the other items under each row. Off by default: the point of the row
46
+ * is to be scannable, and the detail is one keystroke away in a real UI. */
47
+ expand?: boolean;
48
+ }
49
+ export declare function renderSessions(rows: SessionRow[], options?: SessionRenderOptions): string;
50
+ //# sourceMappingURL=by-session.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"by-session.d.ts","sourceRoot":"","sources":["../../../../src/lib/harness/console/by-session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAExD,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,6EAA6E;IAC7E,GAAG,EAAE,WAAW,CAAC;IACjB,4DAA4D;IAC5D,IAAI,EAAE,WAAW,EAAE,CAAC;IACpB,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,kEAAkE;IAClE,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;IAC1C,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,UAAU,EAAE,CA0BjE;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;iFAC6E;IAC7E,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAcD,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,OAAO,GAAE,oBAAyB,GAAG,MAAM,CAiC7F"}
@@ -0,0 +1,83 @@
1
+ /**
2
+ * Group ranked items into one row per session.
3
+ *
4
+ * Order is by the worst item in each session, not by the count. A session with
5
+ * one refusal outranks a session with nine pieces of prose, because ranking by
6
+ * volume would put the noisiest team at the top rather than the one in trouble.
7
+ */
8
+ export function groupBySession(items) {
9
+ const bySession = new Map();
10
+ for (const item of items) {
11
+ const list = bySession.get(item.sessionId);
12
+ if (list)
13
+ list.push(item);
14
+ else
15
+ bySession.set(item.sessionId, [item]);
16
+ }
17
+ const rows = [];
18
+ for (const [sessionId, group] of bySession) {
19
+ const sorted = [...group].sort((a, b) => b.score - a.score || b.at.localeCompare(a.at));
20
+ const byKind = {};
21
+ for (const i of sorted)
22
+ byKind[i.kind] = (byKind[i.kind] ?? 0) + 1;
23
+ rows.push({
24
+ sessionId,
25
+ team: sorted[0].principal.team,
26
+ top: sorted[0],
27
+ rest: sorted.slice(1),
28
+ total: sorted.length,
29
+ byKind,
30
+ latest: sorted.reduce((m, i) => (i.at > m ? i.at : m), sorted[0].at),
31
+ allLowConfidence: sorted.every((i) => i.lowConfidence === true),
32
+ });
33
+ }
34
+ return rows.sort((a, b) => b.top.score - a.top.score || b.latest.localeCompare(a.latest));
35
+ }
36
+ /**
37
+ * Render the rows.
38
+ *
39
+ * Empty string when there is nothing, for the same reason the item renderer
40
+ * does it: a console that prints a header over an empty list trains the reader
41
+ * to skip the header.
42
+ */
43
+ const clip = (s, n = 150) => {
44
+ const oneLine = s.replace(/\s+/g, ' ').trim();
45
+ return oneLine.length > n ? oneLine.slice(0, n).trimEnd() + '…' : oneLine;
46
+ };
47
+ export function renderSessions(rows, options = {}) {
48
+ if (rows.length === 0)
49
+ return '';
50
+ const limit = options.limit ?? 20;
51
+ const shown = rows.slice(0, limit);
52
+ const lines = [`TEAMS NEEDING YOU (${rows.length})`, ''];
53
+ shown.forEach((r, n) => {
54
+ const others = r.total - 1;
55
+ const tail = others > 0 ? ` +${others} more` : '';
56
+ const doubt = r.allLowConfidence ? ' (all unverified)' : '';
57
+ lines.push(`${String(n + 1).padStart(2)} ${r.team.padEnd(22)} ${r.top.kind.padEnd(9)}${tail}${doubt}`);
58
+ lines.push(` ${clip(r.top.headline, 120)}`);
59
+ // Detail is for scanning. One recorded hook message ran to several thousand
60
+ // words of forwarded queue traffic, which pushed every other row off the
61
+ // screen. A row that cannot be scanned is not a row.
62
+ for (const d of r.top.detail.slice(0, 2))
63
+ lines.push(` ${clip(d)}`);
64
+ if (others > 0) {
65
+ const summary = Object.entries(r.byKind)
66
+ .filter(([k]) => k !== r.top.kind || (r.byKind[r.top.kind] ?? 0) > 1)
67
+ .map(([k, n2]) => `${n2} ${k}`)
68
+ .join(', ');
69
+ if (summary)
70
+ lines.push(` also holding: ${summary}`);
71
+ }
72
+ if (options.expand) {
73
+ for (const item of r.rest)
74
+ lines.push(` - ${item.kind}: ${clip(item.headline, 110)}`);
75
+ }
76
+ lines.push('');
77
+ });
78
+ if (rows.length > shown.length) {
79
+ lines.push(` ${rows.length - shown.length} more teams not shown.`);
80
+ }
81
+ return lines.join('\n');
82
+ }
83
+ //# sourceMappingURL=by-session.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"by-session.js","sourceRoot":"","sources":["../../../../src/lib/harness/console/by-session.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=by-session.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"by-session.test.d.ts","sourceRoot":"","sources":["../../../../src/lib/harness/console/by-session.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,86 @@
1
+ import { describe, it, expect } from 'vitest';
2
+ import { groupBySession, renderSessions } from './by-session.js';
3
+ let seq = 0;
4
+ const item = (over) => ({
5
+ id: `i${seq++}`,
6
+ principal: { team: 'product', role: 'unknown', subagentId: null, sessionId: over.sessionId },
7
+ at: '2026-08-05T10:00:00.000Z',
8
+ headline: 'something happened',
9
+ detail: [],
10
+ repeats: 1,
11
+ ...over,
12
+ });
13
+ describe('groupBySession', () => {
14
+ it('collapses many moments into one row per session', () => {
15
+ const rows = groupBySession([
16
+ item({ sessionId: 'a', score: 100, kind: 'prose' }),
17
+ item({ sessionId: 'a', score: 200, kind: 'refusal' }),
18
+ item({ sessionId: 'a', score: 50, kind: 'prose' }),
19
+ item({ sessionId: 'b', score: 90, kind: 'stopped' }),
20
+ ]);
21
+ expect(rows).toHaveLength(2);
22
+ expect(rows[0].sessionId).toBe('a');
23
+ expect(rows[0].total).toBe(3);
24
+ expect(rows[0].rest).toHaveLength(2);
25
+ });
26
+ it('shows the worst item in the session, not the newest', () => {
27
+ const rows = groupBySession([
28
+ item({ sessionId: 'a', score: 100, kind: 'prose', at: '2026-08-05T12:00:00.000Z' }),
29
+ item({ sessionId: 'a', score: 900, kind: 'refusal', at: '2026-08-05T09:00:00.000Z' }),
30
+ ]);
31
+ expect(rows[0].top.kind).toBe('refusal');
32
+ });
33
+ // The ordering decision that matters: one bad thing outranks nine mild ones.
34
+ it('ranks a session by its worst item rather than by how many it has', () => {
35
+ const rows = groupBySession([
36
+ item({ sessionId: 'loud', score: 100, kind: 'prose' }),
37
+ item({ sessionId: 'loud', score: 100, kind: 'prose' }),
38
+ item({ sessionId: 'loud', score: 100, kind: 'prose' }),
39
+ item({ sessionId: 'loud', score: 100, kind: 'prose' }),
40
+ item({ sessionId: 'quiet', score: 900, kind: 'refusal' }),
41
+ ]);
42
+ expect(rows[0].sessionId).toBe('quiet');
43
+ expect(rows[0].total).toBe(1);
44
+ expect(rows[1].total).toBe(4);
45
+ });
46
+ it('counts by kind so a row can say what it is holding', () => {
47
+ const rows = groupBySession([
48
+ item({ sessionId: 'a', score: 900, kind: 'refusal' }),
49
+ item({ sessionId: 'a', score: 100, kind: 'prose' }),
50
+ item({ sessionId: 'a', score: 90, kind: 'prose' }),
51
+ ]);
52
+ expect(rows[0].byKind).toEqual({ refusal: 1, prose: 2 });
53
+ });
54
+ it('marks a session whose every item is unverified', () => {
55
+ const rows = groupBySession([
56
+ item({ sessionId: 'a', score: 100, kind: 'prose', lowConfidence: true }),
57
+ item({ sessionId: 'b', score: 100, kind: 'prose', lowConfidence: true }),
58
+ item({ sessionId: 'b', score: 200, kind: 'refusal' }),
59
+ ]);
60
+ expect(rows.find((r) => r.sessionId === 'a').allLowConfidence).toBe(true);
61
+ expect(rows.find((r) => r.sessionId === 'b').allLowConfidence).toBe(false);
62
+ });
63
+ });
64
+ describe('renderSessions', () => {
65
+ it('says nothing when there is nothing', () => {
66
+ expect(renderSessions([])).toBe('');
67
+ });
68
+ it('shows the team, the worst item and how much else it is holding', () => {
69
+ const out = renderSessions(groupBySession([
70
+ item({ sessionId: 'a', score: 900, kind: 'refusal', headline: 'a guard refused a push' }),
71
+ item({ sessionId: 'a', score: 100, kind: 'prose' }),
72
+ item({ sessionId: 'a', score: 90, kind: 'prose' }),
73
+ ]));
74
+ expect(out).toContain('TEAMS NEEDING YOU (1)');
75
+ expect(out).toContain('a guard refused a push');
76
+ expect(out).toContain('+2 more');
77
+ expect(out).toContain('2 prose');
78
+ });
79
+ it('does not claim more rows than it printed', () => {
80
+ const many = Array.from({ length: 30 }, (_, i) => item({ sessionId: `s${i}`, score: 100 - i, kind: 'prose' }));
81
+ const out = renderSessions(groupBySession(many), { limit: 5 });
82
+ expect(out).toContain('TEAMS NEEDING YOU (30)');
83
+ expect(out).toContain('25 more teams not shown');
84
+ });
85
+ });
86
+ //# sourceMappingURL=by-session.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"by-session.test.js","sourceRoot":"","sources":["../../../../src/lib/harness/console/by-session.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,67 @@
1
+ /**
2
+ * The fleet console: an `EventSink` that tells the operator what needs them.
3
+ *
4
+ * POC-3 measured the thing this is built on. A program in the message path
5
+ * notices a refusal or a block in 0 to 1 ms; a person rotating through five
6
+ * panes at a 15-second dwell took 5.6 to 67.4 seconds for the same events, and
7
+ * that number grows linearly with team count. So the console does not poll and
8
+ * is not polled. `emit` classifies, ranks, and notifies subscribers inside the
9
+ * same call, which is why time-to-notice is the cost of a function call.
10
+ *
11
+ * POC-3's larger finding shapes what it holds. At five sessions it produced 8
12
+ * items of which 3 mattered, because 5 were informational. Meanwhile two of the
13
+ * five sessions made consequential decisions nobody saw. The binding constraint
14
+ * is the noise ratio, not capacity, so this drops the informational classes
15
+ * outright and reads turn prose for the quiet ones.
16
+ *
17
+ * It is silent when nothing needs a person, and it never says that nothing
18
+ * needs a person. Those are different. A console reporting quiet while teams
19
+ * decide things unseen is worse than no console, and this one cannot see
20
+ * enough to make that claim. `describeLimits` is what it says instead.
21
+ */
22
+ import type { EventSink, HarnessEvent } from '../contract.js';
23
+ import type { ConsoleChange, ConsoleItem, ConsoleOptions } from './types.js';
24
+ export declare function endedAbnormally(reason: string): boolean;
25
+ export declare class FleetConsole implements EventSink {
26
+ private readonly sessions;
27
+ private readonly subscribers;
28
+ private readonly reader;
29
+ private readonly silentAfterMs;
30
+ /** `id:score` pairs at the last notification, so a rescore is a change too. */
31
+ private lastSignature;
32
+ constructor(options?: ConsoleOptions);
33
+ emit(event: HarnessEvent): void;
34
+ /**
35
+ * The ranked list, most consequential first.
36
+ *
37
+ * `nowIso` decides which live sessions count as silent and nothing else. Left
38
+ * out, no session is called silent, which is the right default for replaying
39
+ * a recording: a finished recording has no live sessions to be silent.
40
+ */
41
+ snapshot(nowIso?: string): ConsoleItem[];
42
+ /** Called on every change to the list. Never called to report quiet. */
43
+ subscribe(fn: (change: ConsoleChange) => void): () => void;
44
+ /** Sessions the console has seen, for a caller that wants to say how many. */
45
+ get sessionCount(): number;
46
+ private onSessionStart;
47
+ private onDecision;
48
+ private onTurn;
49
+ private onSessionEnd;
50
+ /** A session the console never saw start still gets watched. */
51
+ private session;
52
+ private upsert;
53
+ private dropRecentProse;
54
+ private silentItem;
55
+ private build;
56
+ private notify;
57
+ }
58
+ /**
59
+ * What the console cannot see.
60
+ *
61
+ * Printed instead of an all-clear. POC-3 enumerated 8 moments needing a person
62
+ * across five sessions and the runtime announced 3 of them; the other 5 were
63
+ * decisions taken quietly. The prose reader exists for that class and is not
64
+ * measured, so an empty list is not a statement about the fleet.
65
+ */
66
+ export declare function describeLimits(): string[];
67
+ //# sourceMappingURL=console.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"console.d.ts","sourceRoot":"","sources":["../../../../src/lib/harness/console/console.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,KAAK,EAIV,SAAS,EACT,YAAY,EAEb,MAAM,gBAAgB,CAAC;AAUxB,OAAO,KAAK,EACV,aAAa,EACb,WAAW,EACX,cAAc,EAIf,MAAM,YAAY,CAAC;AAmDpB,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAKvD;AAED,qBAAa,YAAa,YAAW,SAAS;IAC5C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmC;IAC5D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA8C;IAC1E,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAC3C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,+EAA+E;IAC/E,OAAO,CAAC,aAAa,CAAM;gBAEf,OAAO,GAAE,cAAmB;IAKxC,IAAI,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAkB/B;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,WAAW,EAAE;IAYxC,wEAAwE;IACxE,SAAS,CAAC,EAAE,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI,GAAG,MAAM,IAAI;IAK1D,8EAA8E;IAC9E,IAAI,YAAY,IAAI,MAAM,CAEzB;IAID,OAAO,CAAC,cAAc;IAoBtB,OAAO,CAAC,UAAU;IA6ClB,OAAO,CAAC,MAAM;IAuBd,OAAO,CAAC,YAAY;IAyBpB,gEAAgE;IAChE,OAAO,CAAC,OAAO;IAkBf,OAAO,CAAC,MAAM;IAcd,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,UAAU;IA0BlB,OAAO,CAAC,KAAK;IAyDb,OAAO,CAAC,MAAM;CAmBf;AA+BD;;;;;;;GAOG;AACH,wBAAgB,cAAc,IAAI,MAAM,EAAE,CAUzC"}