aegiscode 7.0.14 → 7.0.15
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/SOURCE-OFFER.txt +9 -0
- package/package.json +3 -2
- package/scripts/check.mjs +1 -52
- package/scripts/demo.mjs +1 -94
- package/scripts/predist.mjs +1 -75
- package/scripts/runtests.mjs +1 -56
- package/scripts/seal-gate.mjs +1 -74
- package/src/agents.js +1 -139
- package/src/app.js +1 -2932
- package/src/art.js +1 -289
- package/src/chatflow.js +1 -3020
- package/src/checkpoint.js +1 -90
- package/src/clipboard.js +1 -424
- package/src/cloudsync.js +1 -528
- package/src/commands.js +1 -4003
- package/src/config.js +1 -581
- package/src/connect.js +1 -349
- package/src/credentials.js +1 -33
- package/src/deps.js +1 -232
- package/src/devrun.js +1 -187
- package/src/diff.js +1 -333
- package/src/diffview.js +1 -296
- package/src/engine.js +1 -297
- package/src/entitlement.js +1 -355
- package/src/events.js +1 -707
- package/src/export.js +1 -67
- package/src/fingerprint.js +1 -592
- package/src/format.js +1 -259
- package/src/fuzzy.js +1 -119
- package/src/history.js +1 -401
- package/src/init.js +1 -175
- package/src/input.js +1 -139
- package/src/keys.js +1 -183
- package/src/markdown.js +1 -306
- package/src/models.js +1 -487
- package/src/naming.js +1 -229
- package/src/overlays.js +1 -461
- package/src/panels.js +1 -1418
- package/src/ping.js +1 -226
- package/src/presence.js +1 -238
- package/src/render.js +1 -515
- package/src/screen.js +1 -518
- package/src/screens.js +1 -896
- package/src/secret.js +1 -59
- package/src/securefs.js +1 -359
- package/src/settings.js +1 -155
- package/src/shared.js +1 -52
- package/src/sharedpaths.js +1 -53
- package/src/signup.js +1 -156
- package/src/summarize.js +1 -95
- package/src/sysdiag.js +1 -585
- package/src/system.js +1 -40
- package/src/theme.js +1 -570
- package/src/title.js +1 -220
- package/src/todos.js +1 -115
- package/src/tokens.js +1 -263
- package/src/topup.js +1 -210
- package/src/update.js +1 -181
- package/vendor/client/aegis.js +1 -2179
- package/vendor/client/attest.js +1 -442
- package/vendor/client/authorship-key.js +1 -410
- package/vendor/client/auto-provision.js +1 -134
- package/vendor/client/brain-catalog.js +1 -268
- package/vendor/client/byok-catalog.js +1 -230
- package/vendor/client/credentials.js +1 -494
- package/vendor/client/device-fingerprint.js +1 -141
- package/vendor/client/drive-connect.js +1 -110
- package/vendor/client/drive-upload.js +1 -174
- package/vendor/client/env-file.js +1 -1273
- package/vendor/client/fingerprint.js +1 -1064
- package/vendor/client/foreign-memory.js +1 -669
- package/vendor/client/google-signin.js +1 -133
- package/vendor/client/hooks.js +1 -430
- package/vendor/client/model-discovery.js +1 -373
- package/vendor/client/platform.js +1 -937
- package/vendor/client/prefs.js +1 -351
- package/vendor/client/presence-constants.js +1 -107
- package/vendor/client/presence.js +1 -438
- package/vendor/client/record-vault.js +3 -1055
- package/vendor/client/session-store.js +1 -548
- package/vendor/client/topup.js +1 -297
- package/vendor/client/touch.js +1 -458
- package/vendor/client/update.js +1 -704
- package/vendor/client/user-models.js +1 -381
- package/vendor/desktop/lib/local/agents.js +1 -105
- package/vendor/desktop/lib/local/autonomous.js +1 -1045
- package/vendor/desktop/lib/local/claude-pro.js +1 -993
- package/vendor/desktop/lib/local/context.js +1 -95
- package/vendor/desktop/lib/local/engine.js +1 -3301
- package/vendor/desktop/lib/local/entitlement.js +1 -660
- package/vendor/desktop/lib/local/git-scope.js +1 -228
- package/vendor/desktop/lib/local/local.js +1 -2135
- package/vendor/desktop/lib/local/prompt.js +1 -275
- package/vendor/desktop/lib/local/queue.js +1 -560
- package/vendor/desktop/lib/local/session-rounds.js +1 -208
- package/vendor/desktop/lib/local/shell.js +1 -680
- package/vendor/desktop/lib/local/tools.js +1 -1238
- package/vendor/desktop/lib/local/turn-guard.js +1 -300
- package/vendor/desktop/lib/local/worktree-lock.js +1 -235
- package/vendor/desktop/lib/settings.js +1 -890
- package/vendor/desktop/renderer/usage.js +1 -1239
- package/vendor/hosts/install.js +1 -638
- package/vendor/hosts/openai-shim.js +1 -515
- package/vendor/hosts/spec.js +1 -164
- package/vendor/hosts/targets.js +1 -346
- package/vendor/mcp/server.js +1 -221
- package/vendor/mcp/tools.js +1 -408
- package/vendor/one/src/child.js +1 -285
- 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
|
-
|
|
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
|
-
|
|
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};
|