aegiscode 7.0.14 → 7.0.16

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 (109) hide show
  1. package/SOURCE-OFFER.txt +9 -0
  2. package/package.json +4 -7
  3. package/scripts/check.mjs +1 -52
  4. package/scripts/demo.mjs +1 -94
  5. package/scripts/predist.mjs +1 -75
  6. package/scripts/runtests.mjs +1 -56
  7. package/scripts/seal-gate.mjs +1 -74
  8. package/src/agents.js +1 -139
  9. package/src/app.js +1 -2932
  10. package/src/art.js +1 -289
  11. package/src/chatflow.js +1 -3020
  12. package/src/checkpoint.js +1 -90
  13. package/src/clipboard.js +1 -424
  14. package/src/cloudsync.js +1 -528
  15. package/src/commands.js +1 -4003
  16. package/src/config.js +1 -581
  17. package/src/connect.js +1 -349
  18. package/src/credentials.js +1 -33
  19. package/src/deps.js +1 -232
  20. package/src/devrun.js +1 -187
  21. package/src/diff.js +1 -333
  22. package/src/diffview.js +1 -296
  23. package/src/engine.js +1 -297
  24. package/src/entitlement.js +1 -355
  25. package/src/events.js +1 -707
  26. package/src/export.js +1 -67
  27. package/src/fingerprint.js +1 -592
  28. package/src/format.js +1 -259
  29. package/src/fuzzy.js +1 -119
  30. package/src/history.js +1 -401
  31. package/src/init.js +1 -175
  32. package/src/input.js +1 -139
  33. package/src/keys.js +1 -183
  34. package/src/markdown.js +1 -306
  35. package/src/models.js +1 -487
  36. package/src/naming.js +1 -229
  37. package/src/overlays.js +1 -461
  38. package/src/panels.js +1 -1418
  39. package/src/ping.js +1 -226
  40. package/src/presence.js +1 -238
  41. package/src/render.js +1 -515
  42. package/src/screen.js +1 -518
  43. package/src/screens.js +1 -896
  44. package/src/secret.js +1 -59
  45. package/src/securefs.js +1 -359
  46. package/src/settings.js +1 -155
  47. package/src/shared.js +1 -52
  48. package/src/sharedpaths.js +1 -53
  49. package/src/signup.js +1 -156
  50. package/src/summarize.js +1 -95
  51. package/src/sysdiag.js +1 -585
  52. package/src/system.js +1 -40
  53. package/src/theme.js +1 -570
  54. package/src/title.js +1 -220
  55. package/src/todos.js +1 -115
  56. package/src/tokens.js +1 -263
  57. package/src/topup.js +1 -210
  58. package/src/update.js +1 -181
  59. package/vendor/client/aegis.js +1 -2179
  60. package/vendor/client/attest.js +1 -442
  61. package/vendor/client/authorship-key.js +1 -410
  62. package/vendor/client/auto-provision.js +1 -134
  63. package/vendor/client/brain-catalog.js +1 -268
  64. package/vendor/client/byok-catalog.js +1 -230
  65. package/vendor/client/credentials.js +1 -494
  66. package/vendor/client/device-fingerprint.js +1 -141
  67. package/vendor/client/drive-connect.js +1 -110
  68. package/vendor/client/drive-upload.js +1 -174
  69. package/vendor/client/env-file.js +1 -1273
  70. package/vendor/client/fingerprint.js +1 -1064
  71. package/vendor/client/foreign-memory.js +1 -669
  72. package/vendor/client/google-signin.js +1 -133
  73. package/vendor/client/hooks.js +1 -430
  74. package/vendor/client/model-discovery.js +1 -373
  75. package/vendor/client/platform.js +1 -937
  76. package/vendor/client/prefs.js +1 -351
  77. package/vendor/client/presence-constants.js +1 -107
  78. package/vendor/client/presence.js +1 -438
  79. package/vendor/client/record-vault.js +3 -1055
  80. package/vendor/client/session-store.js +1 -548
  81. package/vendor/client/topup.js +1 -297
  82. package/vendor/client/touch.js +1 -458
  83. package/vendor/client/update.js +1 -704
  84. package/vendor/client/user-models.js +1 -381
  85. package/vendor/desktop/lib/local/agents.js +1 -105
  86. package/vendor/desktop/lib/local/autonomous.js +1 -1045
  87. package/vendor/desktop/lib/local/claude-pro.js +1 -993
  88. package/vendor/desktop/lib/local/context.js +1 -95
  89. package/vendor/desktop/lib/local/engine.js +1 -3301
  90. package/vendor/desktop/lib/local/entitlement.js +1 -660
  91. package/vendor/desktop/lib/local/git-scope.js +1 -228
  92. package/vendor/desktop/lib/local/local.js +1 -2135
  93. package/vendor/desktop/lib/local/prompt.js +1 -275
  94. package/vendor/desktop/lib/local/queue.js +1 -560
  95. package/vendor/desktop/lib/local/session-rounds.js +1 -208
  96. package/vendor/desktop/lib/local/shell.js +1 -680
  97. package/vendor/desktop/lib/local/tools.js +1 -1238
  98. package/vendor/desktop/lib/local/turn-guard.js +1 -300
  99. package/vendor/desktop/lib/local/worktree-lock.js +1 -235
  100. package/vendor/desktop/lib/settings.js +1 -890
  101. package/vendor/desktop/renderer/usage.js +1 -1239
  102. package/vendor/hosts/install.js +1 -638
  103. package/vendor/hosts/openai-shim.js +1 -515
  104. package/vendor/hosts/spec.js +1 -164
  105. package/vendor/hosts/targets.js +1 -346
  106. package/vendor/mcp/server.js +1 -221
  107. package/vendor/mcp/tools.js +1 -408
  108. package/vendor/one/src/child.js +1 -285
  109. package/vendor/one/src/permissions.js +1 -369
package/src/ping.js CHANGED
@@ -1,228 +1,3 @@
1
1
  // SPDX-License-Identifier: AGPL-3.0-or-later
2
2
  // Copyright (C) 2026 Niklas Borneklint — AEGIS Code (aegiscode) / Aegiscloud.
3
- // AEGIS Code (aegiscode) — source: https://github.com/aegisinfo/aegiscode-plugin
4
- // Conveying a modified copy, or running one as a network service, owes the
5
- // corresponding source under this licence (§5/§13) — see LICENSING.md.
6
- 'use strict';
7
-
8
- /**
9
- * /ping — the terminal's "reply ready" alert.
10
- *
11
- * WHAT IT IS, AND WHY HERE. aegis-desktop already tells the user a turn landed
12
- * when they are looking somewhere else: `notifyReplyIfUnfocused()` in
13
- * desktop/main.js raises a native Notification from the one place every chat
14
- * call resolves, and only when the window is minimized, hidden or unfocused — a
15
- * foregrounded chat needs no OS-level nudge. The terminal has no `isFocused()`,
16
- * so the two things that function reads have to be re-derived:
17
- *
18
- * * "the window is not in front" — approximate it with TIME. A turn that took
19
- * less than `pingMinSeconds` ran while the user was still watching the
20
- * spinner; one that took longer is a turn they plausibly walked away from.
21
- * That is the only honest proxy a TUI has, and it is why the threshold
22
- * exists at all rather than pinging on every reply.
23
- * * "the window can show a notification" — check `process.stdout.isTTY`
24
- * instead of `Notification.isSupported()`. A `-p` headless run, a piped
25
- * transcript or an autonomous queue worker has no user to notify, and
26
- * writing escape sequences into a file is not a notice.
27
- *
28
- * WHAT IT SENDS. Terminal notification escapes, the only channel a CLI has:
29
- * OSC 9 (iTerm2, WezTerm, Windows Terminal, conhost) and OSC 777
30
- * (`notify;title;body` — VTE/GNOME Terminal, kitty, urxvt), each BEL-terminated,
31
- * plus optionally the plain BEL bell for terminals that implement neither
32
- * (macOS Terminal.app) — what the user hears is then whatever their terminal's
33
- * bell setting says. Modes are one word on purpose: `off`, `bell`, `notify`,
34
- * `both`.
35
- *
36
- * Ported verbatim in behaviour from the upstream engine's `src/ping.js`, ESM →
37
- * CommonJS, dependency-free: no TTY, no config file, no app.js import, so the
38
- * decision and the byte sequence are both unit-testable. It keeps all four of
39
- * the properties that module is built around:
40
- *
41
- * 1. It cannot break the host. `writePing()` returns a boolean and never
42
- * throws, whatever the stream does (a closed stdout, an EPIPE, a stub with
43
- * no `write`). A notice that can take down a session is worse than none.
44
- * 2. It cannot corrupt the terminal. Both payloads are free text written
45
- * INSIDE an escape sequence: a BEL in the text would end the OSC early, an
46
- * ESC would start a new escape, a newline would break a WM's rendering.
47
- * `sanitizePingText()` strips every control byte before anything is
48
- * written — the same reasoning as `flattenTitle` at the OSC 0 edge in
49
- * this host's `title.js`.
50
- * 3. It cannot lie about what happened. The notice row is only pushed when a
51
- * sequence was actually written; `off` writes nothing and says nothing
52
- * rather than reporting a ping it did not send.
53
- * 4. It cannot nag. An aborted turn never pings — the user pressed Escape, so
54
- * they are demonstrably looking at the screen.
55
- */
56
-
57
- /** The one-word modes, in the order `/ping` lists them. */
58
- const PING_MODES = Object.freeze(['off', 'bell', 'notify', 'both']);
59
-
60
- /** Default mode. On, like the desktop's own notification — it is the whole
61
- * point of the feature, and the threshold below is what keeps it quiet. */
62
- const DEFAULT_PING_MODE = 'both';
63
-
64
- /** The desktop's rule is "unfocused", not "slow". 30s is where a terminal turn
65
- * stops reading as one the user is still watching, and it is the floor under
66
- * the noise: a two-second reply never pings. */
67
- const DEFAULT_PING_SECONDS = 30;
68
-
69
- /** One hour. Past this the duration is a story, not a threshold. */
70
- const MAX_PING_SECONDS = 3600;
71
-
72
- /** The title every notification carries, matching desktop/main.js's own. */
73
- const PING_TITLE = 'AEGIS Code';
74
-
75
- /** Longest payload the sanitizer will pass through. A title is a short line; a
76
- * notification daemon truncates anyway, so a cap here only bounds what this
77
- * module can be made to write. */
78
- const PING_TEXT_MAX = 120;
79
-
80
- const BEL = '\u0007';
81
- const ESC = '\u001b';
82
- const BODY = 'Reply ready';
83
-
84
- /**
85
- * One of PING_MODES, or the default. An unknown string is NOT an error here —
86
- * the config file is user-editable and a typo must not disable the feature
87
- * silently, so it reads as "unset" and takes the default. `/ping` refuses the
88
- * same strings out loud, which is where a typo is actually seen.
89
- */
90
- function normalizePingMode(value) {
91
- const v = String(value == null ? '' : value).trim().toLowerCase();
92
- return PING_MODES.includes(v) ? v : DEFAULT_PING_MODE;
93
- }
94
-
95
- /**
96
- * Seconds, clamped to [0, MAX_PING_SECONDS]. 0 is legal and means "ping every
97
- * turn, however short". Anything unparseable falls back to the default rather
98
- * than to 0, so a corrupt config cannot turn the notice into a per-turn nag.
99
- */
100
- function normalizePingSeconds(value) {
101
- // `Number('')` is 0 and `Number(' ')` is 0, so an ABSENT value would read as
102
- // "ping every turn" — the loudest setting from the weakest input. Unset is
103
- // separated from zero before anything is parsed.
104
- const raw = typeof value === 'number' ? value : String(value == null ? '' : value).trim();
105
- if (raw === '') return DEFAULT_PING_SECONDS;
106
- const n = typeof raw === 'number' ? raw : Number(raw);
107
- if (!Number.isFinite(n) || n < 0) return DEFAULT_PING_SECONDS;
108
- return Math.min(MAX_PING_SECONDS, Math.floor(n));
109
- }
110
-
111
- /** Strip every byte that could end or re-open the escape sequence, collapse to
112
- * one printable line, cap the length. */
113
- function sanitizePingText(text, max = PING_TEXT_MAX) {
114
- const flat = String(text == null ? '' : text)
115
- .replace(/[\u0000-\u001f\u007f]/g, ' ')
116
- .replace(/\s+/g, ' ')
117
- .trim();
118
- const limit = Number.isFinite(max) && max > 0 ? Math.floor(max) : PING_TEXT_MAX;
119
- return flat.length > limit ? `${flat.slice(0, Math.max(0, limit - 1))}…` : flat;
120
- }
121
-
122
- /**
123
- * The decision, in one place so it can be tested without a TTY:
124
- *
125
- * off → never. "Off is off" is the rule /yolo and /confirm follow.
126
- * aborted → never. Escape means the user was looking at the screen.
127
- * !isTTY → never. Headless/piped: there is no one to ping.
128
- * short turn → never, until the threshold.
129
- */
130
- function shouldPing({ mode, elapsedMs, minSeconds, isTTY, aborted } = {}) {
131
- if (normalizePingMode(mode) === 'off') return false;
132
- if (aborted) return false;
133
- if (!isTTY) return false;
134
- // `Number(null)` is 0 and 0 is a legal duration, so an ABSENT elapsed time
135
- // would read as "this turn just finished" and ping on a caller's bug. Only a
136
- // real number (or a non-empty numeric string) counts.
137
- const raw = typeof elapsedMs === 'number' ? elapsedMs : String(elapsedMs == null ? '' : elapsedMs).trim();
138
- if (raw === '') return false;
139
- const elapsed = Number(raw);
140
- if (!Number.isFinite(elapsed) || elapsed < 0) return false;
141
- return elapsed >= normalizePingSeconds(minSeconds) * 1000;
142
- }
143
-
144
- /**
145
- * The bytes to write. Empty string when the mode is off, so a caller cannot
146
- * accidentally send something "off" did not mean. Both payloads are sanitized
147
- * into locals first, so no branch can write an unsanitized string.
148
- */
149
- function buildPing({ mode = DEFAULT_PING_MODE, title = PING_TITLE, body = BODY } = {}) {
150
- const m = normalizePingMode(mode);
151
- if (m === 'off') return '';
152
- const t = sanitizePingText(title);
153
- const b = sanitizePingText(body);
154
- const parts = [];
155
- if (m === 'notify' || m === 'both') {
156
- // OSC 9: "notification with this body" — no title field, so it carries the
157
- // body only. OSC 777: the form that DOES take a title, and the one VTE and
158
- // kitty implement. Both are BEL-terminated; both are ignored harmlessly by
159
- // a terminal that knows neither.
160
- parts.push(`${ESC}]9;${b}${BEL}`);
161
- parts.push(`${ESC}]777;notify;${t};${b}${BEL}`);
162
- }
163
- if (m === 'bell' || m === 'both') parts.push(BEL);
164
- return parts.join('');
165
- }
166
-
167
- /**
168
- * Write it, or do not — never throws. Returns whether anything was written, and
169
- * the caller pushes its notice row only on `true` (property 3 above).
170
- */
171
- function writePing(stream, text) {
172
- if (!text) return false;
173
- if (!stream || typeof stream.write !== 'function') return false;
174
- try {
175
- stream.write(text);
176
- return true;
177
- } catch {
178
- return false;
179
- }
180
- }
181
-
182
- /** "45s" / "3m12s" / "1h02m" — the compact shape the turn's own timing row
183
- * uses. Seconds in, one short string out. */
184
- function formatPingDuration(seconds) {
185
- const s = Math.max(0, Math.floor(Number(seconds) || 0));
186
- if (s < 60) return `${s}s`;
187
- const m = Math.floor(s / 60);
188
- if (m < 60) return `${m}m${String(s % 60).padStart(2, '0')}s`;
189
- return `${Math.floor(m / 60)}h${String(m % 60).padStart(2, '0')}m`;
190
- }
191
-
192
- /** The transcript row: the duration, which channel fired, and the one switch a
193
- * user needs at that moment. */
194
- function pingNoticeText({ seconds, mode } = {}) {
195
- const m = normalizePingMode(mode);
196
- const how = m === 'bell' ? 'bell rung' : m === 'notify' ? 'notification sent' : 'bell rung, notification sent';
197
- return `[ping] reply ready after ${formatPingDuration(seconds)} — ${how}; /ping off silences this`;
198
- }
199
-
200
- /**
201
- * The whole act, in one call the session loop can make: decide, write, and
202
- * describe. Returns the notice text to push, or null when nothing was sent
203
- * (off, aborted, not a TTY, under the threshold, or a stream that refused).
204
- */
205
- function pingTurn({ stream, mode, minSeconds, elapsedMs, isTTY, aborted } = {}) {
206
- if (!shouldPing({ mode, minSeconds, elapsedMs, isTTY, aborted })) return null;
207
- const text = buildPing({ mode });
208
- if (!writePing(stream, text)) return null;
209
- return pingNoticeText({ seconds: Number(elapsedMs) / 1000, mode });
210
- }
211
-
212
- module.exports = {
213
- PING_MODES,
214
- DEFAULT_PING_MODE,
215
- DEFAULT_PING_SECONDS,
216
- MAX_PING_SECONDS,
217
- PING_TITLE,
218
- PING_TEXT_MAX,
219
- normalizePingMode,
220
- normalizePingSeconds,
221
- sanitizePingText,
222
- shouldPing,
223
- buildPing,
224
- writePing,
225
- formatPingDuration,
226
- pingNoticeText,
227
- pingTurn,
228
- };
3
+ "use strict";const PING_MODES=Object.freeze(["off","bell","notify","both"]),DEFAULT_PING_MODE="both",DEFAULT_PING_SECONDS=30,MAX_PING_SECONDS=3600,PING_TITLE="AEGIS Code",PING_TEXT_MAX=120,BEL="",ESC="",BODY="Reply ready";function normalizePingMode(n){const i=String(null==n?"":n).trim().toLowerCase();return PING_MODES.includes(i)?i:DEFAULT_PING_MODE}function normalizePingSeconds(n){const i="number"==typeof n?n:String(null==n?"":n).trim();if(""===i)return DEFAULT_PING_SECONDS;const e="number"==typeof i?i:Number(i);return!Number.isFinite(e)||e<0?DEFAULT_PING_SECONDS:Math.min(MAX_PING_SECONDS,Math.floor(e))}function sanitizePingText(n,i=PING_TEXT_MAX){const e=String(null==n?"":n).replace(/[\u0000-\u001f\u007f]/g," ").replace(/\s+/g," ").trim(),t=Number.isFinite(i)&&i>0?Math.floor(i):PING_TEXT_MAX;return e.length>t?`${e.slice(0,Math.max(0,t-1))}…`:e}function shouldPing({mode:n,elapsedMs:i,minSeconds:e,isTTY:t,aborted:o}={}){if("off"===normalizePingMode(n))return!1;if(o)return!1;if(!t)return!1;const r="number"==typeof i?i:String(null==i?"":i).trim();if(""===r)return!1;const u=Number(r);return!(!Number.isFinite(u)||u<0)&&u>=1e3*normalizePingSeconds(e)}function buildPing({mode:n=DEFAULT_PING_MODE,title:i=PING_TITLE,body:e=BODY}={}){const t=normalizePingMode(n);if("off"===t)return"";const o=sanitizePingText(i),r=sanitizePingText(e),u=[];return"notify"!==t&&"both"!==t||(u.push(`${ESC}]9;${r}${BEL}`),u.push(`${ESC}]777;notify;${o};${r}${BEL}`)),"bell"!==t&&"both"!==t||u.push(BEL),u.join("")}function writePing(n,i){if(!i)return!1;if(!n||"function"!=typeof n.write)return!1;try{return n.write(i),!0}catch{return!1}}function formatPingDuration(n){const i=Math.max(0,Math.floor(Number(n)||0));if(i<60)return`${i}s`;const e=Math.floor(i/60);return e<60?`${e}m${String(i%60).padStart(2,"0")}s`:`${Math.floor(e/60)}h${String(e%60).padStart(2,"0")}m`}function pingNoticeText({seconds:n,mode:i}={}){const e=normalizePingMode(i),t="bell"===e?"bell rung":"notify"===e?"notification sent":"bell rung, notification sent";return`[ping] reply ready after ${formatPingDuration(n)} — ${t}; /ping off silences this`}function pingTurn({stream:n,mode:i,minSeconds:e,elapsedMs:t,isTTY:o,aborted:r}={}){return shouldPing({mode:i,minSeconds:e,elapsedMs:t,isTTY:o,aborted:r})&&writePing(n,buildPing({mode:i}))?pingNoticeText({seconds:Number(t)/1e3,mode:i}):null}module.exports={PING_MODES:PING_MODES,DEFAULT_PING_MODE:DEFAULT_PING_MODE,DEFAULT_PING_SECONDS:DEFAULT_PING_SECONDS,MAX_PING_SECONDS:MAX_PING_SECONDS,PING_TITLE:PING_TITLE,PING_TEXT_MAX:PING_TEXT_MAX,normalizePingMode:normalizePingMode,normalizePingSeconds:normalizePingSeconds,sanitizePingText:sanitizePingText,shouldPing:shouldPing,buildPing:buildPing,writePing:writePing,formatPingDuration:formatPingDuration,pingNoticeText:pingNoticeText,pingTurn:pingTurn};
package/src/presence.js CHANGED
@@ -1,240 +1,3 @@
1
1
  // SPDX-License-Identifier: AGPL-3.0-or-later
2
2
  // Copyright (C) 2026 Niklas Borneklint — AEGIS Code (aegiscode) / Aegiscloud.
3
- // AEGIS Code (aegiscode) — source: https://github.com/aegisinfo/aegiscode-plugin
4
- // Conveying a modified copy, or running one as a network service, owes the
5
- // corresponding source under this licence (§5/§13) — see LICENSING.md.
6
- 'use strict';
7
-
8
- /**
9
- * The CLI's presence beacon — the `aegiscode` half of `client/presence.js`.
10
- *
11
- * `client/presence.js` owns the protocol (the route, the cadence the server
12
- * asks for, the backoff ladder, the body allowlist). This file owns the three
13
- * things only the CLI can know:
14
- *
15
- * - WHICH key. The credential store resolution (env → credentials.json →
16
- * config.json) is the CLI's, not the shared transport's, and it is the same
17
- * resolution every other CLI call uses. A host with no key does not beacon:
18
- * `presence.js` returns an inert store rather than 401-looping, and this
19
- * module simply reports that it is off.
20
- * - WHICH build. `cli/package.json` at require time, so the panel shows the
21
- * version the user actually installed rather than a constant that drifts
22
- * from the release.
23
- * - HOW BUSY. `autonomous: true` while `aegiscode autonomous` is draining a
24
- * queue, and the pending depth at send time, so the panel can tell "an idle
25
- * terminal is open" from "this machine is working through a queue".
26
- *
27
- * A module-level singleton, because a beacon is a process-wide fact and the
28
- * lifecycle hooks that start and stop it are in `bin/aegiscode.js` — argument
29
- * parsing and process lifecycle, which is not testable — while everything
30
- * below is driven directly by `test/cli-presence.test.mjs`.
31
- *
32
- * Kill switch: `AEGIS_NO_PRESENCE=1` (or `0`/`false` for the settings-file
33
- * equivalent is NOT read here — this host has no settings store). An operator
34
- * debugging a network stack, or a CI runner that must make no outbound calls,
35
- * gets to turn the beacon off without a code change.
36
- */
37
-
38
- const path = require('node:path');
39
- const { resolveShared } = require('./sharedpaths.js');
40
-
41
- /** `AEGIS_NO_PRESENCE` truthy ⇒ never beacon from this host. Anything else
42
- * (unset, '', '0', 'false', 'no') leaves the beacon on: the default has to be
43
- * "beacon", because a presence panel that is off unless someone remembers to
44
- * switch it on is a panel with no rows in it. */
45
- const KILL_ENV = 'AEGIS_NO_PRESENCE';
46
-
47
- function presenceDisabled(env) {
48
- try {
49
- const raw = env && env[KILL_ENV];
50
- if (raw == null || String(raw).trim() === '') return false;
51
- return /^(1|true|on|yes)$/i.test(String(raw).trim());
52
- } catch {
53
- return false;
54
- }
55
- }
56
-
57
- /** Lazily required so `--help`, `--version` and `key status` stay instant and
58
- * dependency-free: a beacon is for a *session*, not for a subcommand. */
59
- function loadShared() {
60
- const presence = require(resolveShared(path.join('client', 'presence.js')));
61
- const fingerprint = require(resolveShared(path.join('client', 'device-fingerprint.js')));
62
- return { presence, fingerprint };
63
- }
64
-
65
- /** The CLI's own build string. A missing/unreadable package.json is not a
66
- * reason to skip the beacon: the fields are individually optional server-side. */
67
- function cliVersion() {
68
- try {
69
- return require(path.join(__dirname, '..', 'package.json')).version || null;
70
- } catch {
71
- return null;
72
- }
73
- }
74
-
75
- let current = null;
76
-
77
- /**
78
- * Start (or restart) the CLI beacon. Idempotent by replacement: calling it
79
- * twice stops the first store, so the timer count cannot grow with the number
80
- * of calls. Never throws — a beacon that cannot start is a beacon that is off,
81
- * and the session proceeds.
82
- *
83
- * @param {object} [opts]
84
- * @param {object} [opts.client] an already-built aegis client (its apiKey wins)
85
- * @param {object} [opts.credentials] the credential store to resolve a key from
86
- * @param {boolean} [opts.autonomous] this process is draining a queue
87
- * @param {number|function} [opts.queueDepth] pending tasks, or a reader for them
88
- * @param {object} [opts.env] override process.env (tests)
89
- * @param {object} [opts.io] { stdout, stderr } — never used today, kept
90
- * so a future `--verbose` can narrate a beat
91
- * @returns {{enabled: boolean, reason: string|null, stop: () => void, state: () => object}}
92
- */
93
- function start(opts = {}) {
94
- stop();
95
- const env = opts.env || process.env;
96
- if (presenceDisabled(env)) {
97
- return (current = inert('kill-switch'));
98
- }
99
-
100
- let apiKey = '';
101
- try {
102
- if (opts.client && typeof opts.client.apiKey === 'string') apiKey = opts.client.apiKey;
103
- if (!apiKey && opts.credentials && typeof opts.credentials.resolveApiKey === 'function') {
104
- const resolved = opts.credentials.resolveApiKey({ env });
105
- apiKey = (resolved && (resolved.key || resolved.apiKey)) || '';
106
- }
107
- } catch {
108
- apiKey = '';
109
- }
110
- if (!apiKey) return (current = inert('no-api-key'));
111
-
112
- try {
113
- const { presence, fingerprint } = loadShared();
114
- const store = presence.createPresence({
115
- apiKey,
116
- // 'cli', not 'aegiscode': aegis1 keeps only the names in its own
117
- // PRESENCE_APPS tuple (app.py) and stores anything else as 'other', so a
118
- // product name here would make every terminal session unidentifiable in
119
- // the admin panel while still answering 200. See
120
- // client/presence-constants.js — a test parses the server's tuple and
121
- // fails if the two lists drift.
122
- app: 'cli',
123
- version: cliVersion(),
124
- platform: process.platform,
125
- // The SAME identity the device-registration path uses — see the header of
126
- // client/presence.js for why the beacon must carry the machine, not a
127
- // per-run random token. Computed here rather than inside presence.js so a
128
- // fingerprint failure is visible at the call site.
129
- install: fingerprint.machineFingerprint(),
130
- queueDepth: opts.queueDepth,
131
- autonomous: Boolean(opts.autonomous),
132
- log: opts.log,
133
- fetchImpl: opts.fetchImpl,
134
- now: opts.now,
135
- setTimer: opts.setTimer,
136
- clearTimer: opts.clearTimer,
137
- });
138
- store.start();
139
- return (current = store);
140
- } catch (err) {
141
- // A require failure here is a packaging bug, not a user-facing one: stay
142
- // quiet, keep the session working, and leave `state().reason` for a test.
143
- return (current = inert(`load-failed:${String((err && err.message) || err).slice(0, 80)}`));
144
- }
145
- }
146
-
147
- function inert(reason) {
148
- return {
149
- enabled: false,
150
- reason,
151
- install: null,
152
- stop: () => true,
153
- state: () => ({ enabled: false, reason, beats: 0, failures: 0, running: false }),
154
- };
155
- }
156
-
157
- /** Stop the beacon. Idempotent; safe when `start()` never ran. */
158
- function stop() {
159
- if (!current) return false;
160
- try {
161
- current.stop();
162
- } catch {
163
- /* an already-dead beacon is not an error */
164
- }
165
- current = null;
166
- return true;
167
- }
168
-
169
- /** The active store (or null). For tests and for a host that wants to read
170
- * `state()` — `{beats, failures, lastSeenAt, intervalMs}` — after a beat. */
171
- function active() {
172
- return current;
173
- }
174
-
175
- /**
176
- * How many tasks are waiting, read at SEND time.
177
- *
178
- * Resolved through the shared-path resolver (`sharedpaths.js`) rather than by
179
- * re-implementing a queue counter, so there is exactly one queue file and one
180
- * definition of "pending" in this repo — the same `desktop/lib/local/queue.js`
181
- * the desktop drains. A missing module, an unreadable file or a malformed line
182
- * is 0: the beacon reports presence, not bookkeeping, and a broken queue must
183
- * not silence the beacon that would have shown the machine was alive.
184
- */
185
- function queueDepthReader() {
186
- let queue = null;
187
- try {
188
- queue = require(resolveShared(path.join('desktop', 'lib', 'local', 'queue.js')));
189
- } catch {
190
- queue = null;
191
- }
192
- return () => {
193
- try {
194
- if (!queue || typeof queue.readQueue !== 'function' || typeof queue.queuePath !== 'function') return 0;
195
- const items = queue.readQueue(queue.queuePath());
196
- return (Array.isArray(items) ? items : []).filter((t) => t && t.status === 'pending').length;
197
- } catch {
198
- return 0;
199
- }
200
- };
201
- }
202
-
203
- /**
204
- * Let an in-flight beat finish before the process exits.
205
- *
206
- * This is not optional politeness — it is the difference between a beat and no
207
- * beat. `bin/aegiscode.js` ends with `process.exit()`, and a one-shot run
208
- * (`aegiscode -p "…"`, `aegiscode autonomous run`) reaches it in tens of
209
- * milliseconds, so the first beat posted at startup would be killed mid-flight
210
- * and the machine would never appear in the panel. Bounded, because a beacon
211
- * must never be the reason a CLI hangs: if the request has not answered within
212
- * `timeoutMs`, the process exits and that beat is simply lost.
213
- *
214
- * @param {number} [timeoutMs] default 1500 — the beacon's own request timeout
215
- * is 20 s, far too long to hold an exit open.
216
- * @returns {Promise<'drained'|'none'|'timeout'>}
217
- */
218
- function flush(timeoutMs = 1500) {
219
- try {
220
- if (!current || typeof current.pending !== 'function') return Promise.resolve('none');
221
- const inflight = current.pending();
222
- if (!inflight) return Promise.resolve('none');
223
- const limit = Number.isFinite(Number(timeoutMs)) && Number(timeoutMs) > 0 ? Number(timeoutMs) : 1500;
224
- return Promise.race([
225
- Promise.resolve(inflight).then(() => 'drained', () => 'drained'),
226
- new Promise((resolve) => {
227
- // Deliberately NOT unref'd, unlike every other timer in this module: the
228
- // caller is already in its exit path and has asked for a bounded wait, so
229
- // this timer is the thing that must be allowed to keep the loop alive
230
- // long enough to fire. An unref'd timer here would leave the process with
231
- // an empty event loop and a `flush()` promise that never settles.
232
- setTimeout(() => resolve('timeout'), limit);
233
- }),
234
- ]);
235
- } catch {
236
- return Promise.resolve('none');
237
- }
238
- }
239
-
240
- module.exports = { start, stop, active, flush, presenceDisabled, queueDepthReader, cliVersion, KILL_ENV };
3
+ "use strict";const path=require("node:path"),{resolveShared:resolveShared}=require("./sharedpaths.js"),KILL_ENV="AEGIS_NO_PRESENCE";function presenceDisabled(e){try{const r=e&&e[KILL_ENV];return null!=r&&""!==String(r).trim()&&/^(1|true|on|yes)$/i.test(String(r).trim())}catch{return!1}}function loadShared(){return{presence:require(resolveShared(path.join("client","presence.js"))),fingerprint:require(resolveShared(path.join("client","device-fingerprint.js")))}}function cliVersion(){try{return require(path.join(__dirname,"..","package.json")).version||null}catch{return null}}let current=null;function start(e={}){stop();const r=e.env||process.env;if(presenceDisabled(r))return current=inert("kill-switch");let t="";try{if(e.client&&"string"==typeof e.client.apiKey&&(t=e.client.apiKey),!t&&e.credentials&&"function"==typeof e.credentials.resolveApiKey){const n=e.credentials.resolveApiKey({env:r});t=n&&(n.key||n.apiKey)||""}}catch{t=""}if(!t)return current=inert("no-api-key");try{const{presence:r,fingerprint:n}=loadShared(),i=r.createPresence({apiKey:t,app:"cli",version:cliVersion(),platform:process.platform,install:n.machineFingerprint(),queueDepth:e.queueDepth,autonomous:Boolean(e.autonomous),log:e.log,fetchImpl:e.fetchImpl,now:e.now,setTimer:e.setTimer,clearTimer:e.clearTimer});return i.start(),current=i}catch(e){return current=inert(`load-failed:${String(e&&e.message||e).slice(0,80)}`)}}function inert(e){return{enabled:!1,reason:e,install:null,stop:()=>!0,state:()=>({enabled:!1,reason:e,beats:0,failures:0,running:!1})}}function stop(){if(!current)return!1;try{current.stop()}catch{}return current=null,!0}function active(){return current}function queueDepthReader(){let e=null;try{e=require(resolveShared(path.join("desktop","lib","local","queue.js")))}catch{e=null}return()=>{try{if(!e||"function"!=typeof e.readQueue||"function"!=typeof e.queuePath)return 0;const r=e.readQueue(e.queuePath());return(Array.isArray(r)?r:[]).filter((e=>e&&"pending"===e.status)).length}catch{return 0}}}function flush(e=1500){try{if(!current||"function"!=typeof current.pending)return Promise.resolve("none");const r=current.pending();if(!r)return Promise.resolve("none");const t=Number.isFinite(Number(e))&&Number(e)>0?Number(e):1500;return Promise.race([Promise.resolve(r).then((()=>"drained"),(()=>"drained")),new Promise((e=>{setTimeout((()=>e("timeout")),t)}))])}catch{return Promise.resolve("none")}}module.exports={start:start,stop:stop,active:active,flush:flush,presenceDisabled:presenceDisabled,queueDepthReader:queueDepthReader,cliVersion:cliVersion,KILL_ENV:KILL_ENV};