lightman-agent 1.0.18 → 1.0.21

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 (52) hide show
  1. package/agent.config.json +22 -23
  2. package/agent.config.template.json +30 -31
  3. package/bin/cms-agent.js +269 -248
  4. package/package.json +1 -1
  5. package/public/assets/index-CcBNCz6h.css +1 -1
  6. package/public/assets/index-D9QHMG8k.js +1 -1
  7. package/public/assets/index-H-8HDl46.js +1 -1
  8. package/public/assets/index-YodeiCia.css +1 -1
  9. package/public/assets/index-legacy-DWtNM8y7.js +41 -41
  10. package/public/assets/polyfills-legacy-DyVYWHbW.js +4 -4
  11. package/scripts/guardian.ps1 +50 -124
  12. package/scripts/install-windows.ps1 +60 -116
  13. package/scripts/lightman-agent.logrotate +12 -12
  14. package/scripts/lightman-agent.service +38 -38
  15. package/scripts/reinstall-windows.ps1 +26 -26
  16. package/scripts/restore-desktop.ps1 +32 -32
  17. package/scripts/setup.ps1 +17 -22
  18. package/scripts/sync-display.mjs +20 -20
  19. package/scripts/uninstall-windows.ps1 +54 -54
  20. package/src/commands/display.ts +177 -177
  21. package/src/commands/kiosk.ts +113 -113
  22. package/src/commands/maintenance.ts +106 -106
  23. package/src/commands/network.ts +129 -129
  24. package/src/commands/power.ts +163 -163
  25. package/src/commands/rpi.ts +45 -45
  26. package/src/commands/screenshot.ts +166 -166
  27. package/src/commands/serial.ts +17 -17
  28. package/src/commands/update.ts +124 -124
  29. package/src/index.ts +173 -90
  30. package/src/lib/config.ts +2 -3
  31. package/src/lib/identity.ts +40 -40
  32. package/src/lib/logger.ts +137 -137
  33. package/src/lib/platform.ts +10 -10
  34. package/src/lib/rpi.ts +180 -180
  35. package/src/lib/screenMap.ts +135 -0
  36. package/src/lib/screens.ts +128 -128
  37. package/src/lib/types.ts +176 -177
  38. package/src/services/commands.ts +107 -107
  39. package/src/services/health.ts +161 -161
  40. package/src/services/localEvents.ts +60 -60
  41. package/src/services/logForwarder.ts +72 -72
  42. package/src/services/multiScreenKiosk.ts +116 -83
  43. package/src/services/oscBridge.ts +186 -186
  44. package/src/services/powerScheduler.ts +260 -260
  45. package/src/services/provisioning.ts +120 -122
  46. package/src/services/serialBridge.ts +230 -230
  47. package/src/services/serviceLauncher.ts +183 -183
  48. package/src/services/staticServer.ts +226 -226
  49. package/src/services/updater.ts +249 -249
  50. package/src/services/watchdog.ts +310 -310
  51. package/src/services/websocket.ts +152 -152
  52. package/tsconfig.json +28 -28
@@ -1,129 +1,129 @@
1
- import net from 'net';
2
- import dns from 'dns';
3
- import { URL } from 'url';
4
- import si from 'systeminformation';
5
- import type { CommandHandler } from '../lib/types.js';
6
- import type { Logger } from '../lib/logger.js';
7
-
8
- export function registerNetworkCommands(
9
- register: (command: string, handler: CommandHandler) => void,
10
- logger: Logger,
11
- serverUrl: string
12
- ): void {
13
- // network:ping — TCP connect to CMS server, measure round-trip
14
- register('network:ping', async () => {
15
- const url = new URL(serverUrl);
16
- const host = url.hostname;
17
- const port = parseInt(url.port, 10) || 3001;
18
-
19
- const start = Date.now();
20
- const reachable = await tcpPing(host, port, 5000);
21
- const latencyMs = Date.now() - start;
22
-
23
- logger.info(`Network ping: ${host}:${port} → ${reachable ? 'OK' : 'FAIL'} (${latencyMs}ms)`);
24
- return { latency_ms: latencyMs, reachable, host, port };
25
- });
26
-
27
- // network:bandwidth — Download 1MB test file, measure speed
28
- register('network:bandwidth', async () => {
29
- const url = `${serverUrl}/api/agent/bandwidth-test`;
30
- logger.info(`Bandwidth test: downloading from ${url}`);
31
-
32
- const start = Date.now();
33
- try {
34
- const response = await fetch(url);
35
- if (!response.ok) {
36
- throw new Error(`HTTP ${response.status}`);
37
- }
38
- const buffer = await response.arrayBuffer();
39
- const durationMs = Date.now() - start;
40
- const sizeMb = buffer.byteLength / (1024 * 1024);
41
- const speedMbps = (sizeMb * 8) / (durationMs / 1000);
42
-
43
- logger.info(`Bandwidth: ${speedMbps.toFixed(2)} Mbps (${buffer.byteLength} bytes in ${durationMs}ms)`);
44
- return {
45
- speed_mbps: Math.round(speedMbps * 100) / 100,
46
- duration_ms: durationMs,
47
- bytes: buffer.byteLength,
48
- };
49
- } catch (err) {
50
- const message = err instanceof Error ? err.message : String(err);
51
- logger.error('Bandwidth test failed:', message);
52
- throw new Error(`Bandwidth test failed: ${message}`);
53
- }
54
- });
55
-
56
- // network:dns — Resolve CMS hostname
57
- register('network:dns', async () => {
58
- const url = new URL(serverUrl);
59
- const hostname = url.hostname;
60
-
61
- logger.info(`DNS resolve: ${hostname}`);
62
- const start = Date.now();
63
-
64
- try {
65
- const addresses = await new Promise<string[]>((resolve, reject) => {
66
- dns.resolve(hostname, (err, addrs) => {
67
- if (err) reject(err);
68
- else resolve(addrs);
69
- });
70
- });
71
- const timeMs = Date.now() - start;
72
-
73
- logger.info(`DNS resolved: ${hostname} → ${addresses.join(', ')} (${timeMs}ms)`);
74
- return { resolved: true, addresses, time_ms: timeMs, hostname };
75
- } catch (err) {
76
- const timeMs = Date.now() - start;
77
- // If it's an IP address, DNS resolve will fail — that's OK
78
- if (net.isIP(hostname)) {
79
- return { resolved: true, addresses: [hostname], time_ms: timeMs, hostname, note: 'IP address (no DNS needed)' };
80
- }
81
- const message = err instanceof Error ? err.message : String(err);
82
- logger.error('DNS resolve failed:', message);
83
- return { resolved: false, addresses: [], time_ms: timeMs, hostname, error: message };
84
- }
85
- });
86
-
87
- // network:interfaces — List network interfaces
88
- register('network:interfaces', async () => {
89
- const ifaces = await si.networkInterfaces();
90
- const ifaceList = Array.isArray(ifaces) ? ifaces : [ifaces];
91
-
92
- const interfaces = ifaceList
93
- .filter((iface) => !iface.internal && iface.ip4)
94
- .map((iface) => ({
95
- name: iface.iface,
96
- ip4: iface.ip4,
97
- mac: iface.mac,
98
- speed: iface.speed,
99
- type: iface.type,
100
- }));
101
-
102
- logger.info(`Network interfaces: ${interfaces.length} found`);
103
- return { interfaces };
104
- });
105
- }
106
-
107
- /**
108
- * TCP ping: attempt a TCP connection and measure latency.
109
- * Returns true if connection succeeds within timeout.
110
- */
111
- function tcpPing(host: string, port: number, timeoutMs: number): Promise<boolean> {
112
- return new Promise((resolve) => {
113
- const socket = new net.Socket();
114
- let resolved = false;
115
-
116
- const done = (result: boolean) => {
117
- if (resolved) return;
118
- resolved = true;
119
- socket.destroy();
120
- resolve(result);
121
- };
122
-
123
- socket.setTimeout(timeoutMs);
124
- socket.on('connect', () => done(true));
125
- socket.on('timeout', () => done(false));
126
- socket.on('error', () => done(false));
127
- socket.connect(port, host);
128
- });
129
- }
1
+ import net from 'net';
2
+ import dns from 'dns';
3
+ import { URL } from 'url';
4
+ import si from 'systeminformation';
5
+ import type { CommandHandler } from '../lib/types.js';
6
+ import type { Logger } from '../lib/logger.js';
7
+
8
+ export function registerNetworkCommands(
9
+ register: (command: string, handler: CommandHandler) => void,
10
+ logger: Logger,
11
+ serverUrl: string
12
+ ): void {
13
+ // network:ping — TCP connect to CMS server, measure round-trip
14
+ register('network:ping', async () => {
15
+ const url = new URL(serverUrl);
16
+ const host = url.hostname;
17
+ const port = parseInt(url.port, 10) || 3001;
18
+
19
+ const start = Date.now();
20
+ const reachable = await tcpPing(host, port, 5000);
21
+ const latencyMs = Date.now() - start;
22
+
23
+ logger.info(`Network ping: ${host}:${port} → ${reachable ? 'OK' : 'FAIL'} (${latencyMs}ms)`);
24
+ return { latency_ms: latencyMs, reachable, host, port };
25
+ });
26
+
27
+ // network:bandwidth — Download 1MB test file, measure speed
28
+ register('network:bandwidth', async () => {
29
+ const url = `${serverUrl}/api/agent/bandwidth-test`;
30
+ logger.info(`Bandwidth test: downloading from ${url}`);
31
+
32
+ const start = Date.now();
33
+ try {
34
+ const response = await fetch(url);
35
+ if (!response.ok) {
36
+ throw new Error(`HTTP ${response.status}`);
37
+ }
38
+ const buffer = await response.arrayBuffer();
39
+ const durationMs = Date.now() - start;
40
+ const sizeMb = buffer.byteLength / (1024 * 1024);
41
+ const speedMbps = (sizeMb * 8) / (durationMs / 1000);
42
+
43
+ logger.info(`Bandwidth: ${speedMbps.toFixed(2)} Mbps (${buffer.byteLength} bytes in ${durationMs}ms)`);
44
+ return {
45
+ speed_mbps: Math.round(speedMbps * 100) / 100,
46
+ duration_ms: durationMs,
47
+ bytes: buffer.byteLength,
48
+ };
49
+ } catch (err) {
50
+ const message = err instanceof Error ? err.message : String(err);
51
+ logger.error('Bandwidth test failed:', message);
52
+ throw new Error(`Bandwidth test failed: ${message}`);
53
+ }
54
+ });
55
+
56
+ // network:dns — Resolve CMS hostname
57
+ register('network:dns', async () => {
58
+ const url = new URL(serverUrl);
59
+ const hostname = url.hostname;
60
+
61
+ logger.info(`DNS resolve: ${hostname}`);
62
+ const start = Date.now();
63
+
64
+ try {
65
+ const addresses = await new Promise<string[]>((resolve, reject) => {
66
+ dns.resolve(hostname, (err, addrs) => {
67
+ if (err) reject(err);
68
+ else resolve(addrs);
69
+ });
70
+ });
71
+ const timeMs = Date.now() - start;
72
+
73
+ logger.info(`DNS resolved: ${hostname} → ${addresses.join(', ')} (${timeMs}ms)`);
74
+ return { resolved: true, addresses, time_ms: timeMs, hostname };
75
+ } catch (err) {
76
+ const timeMs = Date.now() - start;
77
+ // If it's an IP address, DNS resolve will fail — that's OK
78
+ if (net.isIP(hostname)) {
79
+ return { resolved: true, addresses: [hostname], time_ms: timeMs, hostname, note: 'IP address (no DNS needed)' };
80
+ }
81
+ const message = err instanceof Error ? err.message : String(err);
82
+ logger.error('DNS resolve failed:', message);
83
+ return { resolved: false, addresses: [], time_ms: timeMs, hostname, error: message };
84
+ }
85
+ });
86
+
87
+ // network:interfaces — List network interfaces
88
+ register('network:interfaces', async () => {
89
+ const ifaces = await si.networkInterfaces();
90
+ const ifaceList = Array.isArray(ifaces) ? ifaces : [ifaces];
91
+
92
+ const interfaces = ifaceList
93
+ .filter((iface) => !iface.internal && iface.ip4)
94
+ .map((iface) => ({
95
+ name: iface.iface,
96
+ ip4: iface.ip4,
97
+ mac: iface.mac,
98
+ speed: iface.speed,
99
+ type: iface.type,
100
+ }));
101
+
102
+ logger.info(`Network interfaces: ${interfaces.length} found`);
103
+ return { interfaces };
104
+ });
105
+ }
106
+
107
+ /**
108
+ * TCP ping: attempt a TCP connection and measure latency.
109
+ * Returns true if connection succeeds within timeout.
110
+ */
111
+ function tcpPing(host: string, port: number, timeoutMs: number): Promise<boolean> {
112
+ return new Promise((resolve) => {
113
+ const socket = new net.Socket();
114
+ let resolved = false;
115
+
116
+ const done = (result: boolean) => {
117
+ if (resolved) return;
118
+ resolved = true;
119
+ socket.destroy();
120
+ resolve(result);
121
+ };
122
+
123
+ socket.setTimeout(timeoutMs);
124
+ socket.on('connect', () => done(true));
125
+ socket.on('timeout', () => done(false));
126
+ socket.on('error', () => done(false));
127
+ socket.connect(port, host);
128
+ });
129
+ }
@@ -1,163 +1,163 @@
1
- import { execFile } from 'child_process';
2
- import { z } from 'zod';
3
- import type { CommandHandler } from '../lib/types.js';
4
- import { getPlatform } from '../lib/platform.js';
5
- import type { Logger } from '../lib/logger.js';
6
-
7
- // --- Zod Schemas ---
8
- const ShutdownDelayedArgsSchema = z.object({
9
- delayMs: z.number().finite().optional(),
10
- });
11
-
12
- let pendingShutdown: ReturnType<typeof setTimeout> | null = null;
13
-
14
- interface ExecCommand {
15
- readonly bin: string;
16
- readonly args: readonly string[];
17
- }
18
-
19
- function execCommand(cmd: ExecCommand, logger: Logger): void {
20
- execFile(cmd.bin, [...cmd.args], (err, stdout, stderr) => {
21
- if (err) {
22
- logger.error(`Exec failed: ${cmd.bin}`, err.message);
23
- }
24
- if (stderr) {
25
- logger.warn(`Exec stderr: ${cmd.bin}`, stderr);
26
- }
27
- if (stdout) {
28
- logger.debug(`Exec stdout: ${cmd.bin}`, stdout);
29
- }
30
- });
31
- }
32
-
33
- function getShutdownCommand(): ExecCommand {
34
- const platform = getPlatform();
35
- switch (platform) {
36
- case 'windows':
37
- return { bin: 'shutdown', args: ['/s', '/t', '0'] };
38
- case 'darwin':
39
- case 'linux':
40
- default:
41
- return { bin: 'shutdown', args: ['-h', 'now'] };
42
- }
43
- }
44
-
45
- function getRebootCommand(): ExecCommand {
46
- const platform = getPlatform();
47
- switch (platform) {
48
- case 'windows':
49
- return { bin: 'shutdown', args: ['/r', '/t', '0'] };
50
- case 'darwin':
51
- case 'linux':
52
- default:
53
- return { bin: 'shutdown', args: ['-r', 'now'] };
54
- }
55
- }
56
-
57
- function getSuspendCommand(): ExecCommand {
58
- const platform = getPlatform();
59
- switch (platform) {
60
- case 'linux':
61
- return { bin: 'systemctl', args: ['suspend'] };
62
- case 'windows':
63
- return { bin: 'rundll32.exe', args: ['powrprof.dll,SetSuspendState', '0,1,0'] };
64
- case 'darwin':
65
- return { bin: 'pmset', args: ['sleepnow'] };
66
- default:
67
- return { bin: 'systemctl', args: ['suspend'] };
68
- }
69
- }
70
-
71
- export function registerPowerCommands(
72
- register: (command: string, handler: CommandHandler) => void,
73
- logger: Logger
74
- ): void {
75
- // system:shutdown — graceful shutdown with 5s delay
76
- register('system:shutdown', async () => {
77
- const cmd = getShutdownCommand();
78
- logger.info(`Scheduling shutdown in 5000ms: ${cmd}`);
79
-
80
- setTimeout(() => {
81
- try {
82
- execCommand(cmd, logger);
83
- } catch (err) {
84
- logger.error('Shutdown exec error', err instanceof Error ? err.message : String(err));
85
- }
86
- }, 5000);
87
-
88
- return { delayed: true, delayMs: 5000 };
89
- });
90
-
91
- // system:reboot — graceful reboot with 5s delay
92
- register('system:reboot', async () => {
93
- const cmd = getRebootCommand();
94
- logger.info(`Scheduling reboot in 5000ms: ${cmd}`);
95
-
96
- setTimeout(() => {
97
- try {
98
- execCommand(cmd, logger);
99
- } catch (err) {
100
- logger.error('Reboot exec error', err instanceof Error ? err.message : String(err));
101
- }
102
- }, 5000);
103
-
104
- return { delayed: true, delayMs: 5000 };
105
- });
106
-
107
- // system:suspend — immediate suspend
108
- register('system:suspend', async () => {
109
- const cmd = getSuspendCommand();
110
- logger.info(`Executing suspend: ${cmd}`);
111
-
112
- try {
113
- execCommand(cmd, logger);
114
- } catch (err) {
115
- logger.error('Suspend exec error', err instanceof Error ? err.message : String(err));
116
- }
117
-
118
- return { suspended: true };
119
- });
120
-
121
- // system:shutdown-delayed — shutdown after configurable delay (5s to 24h)
122
- register('system:shutdown-delayed', async (args) => {
123
- const parsed = ShutdownDelayedArgsSchema.safeParse(args ?? {});
124
- if (!parsed.success) {
125
- throw new Error(`Invalid args: ${parsed.error.issues.map((i) => i.message).join(', ')}`);
126
- }
127
- const rawDelay = parsed.data.delayMs ?? 60000;
128
- const delayMs = Math.max(5000, Math.min(rawDelay, 86_400_000));
129
- const cmd = getShutdownCommand();
130
-
131
- logger.info(`Scheduling delayed shutdown in ${delayMs}ms: ${cmd}`);
132
-
133
- // Clear any existing pending shutdown
134
- if (pendingShutdown !== null) {
135
- clearTimeout(pendingShutdown);
136
- logger.info('Cleared previous pending shutdown');
137
- }
138
-
139
- pendingShutdown = setTimeout(() => {
140
- try {
141
- execCommand(cmd, logger);
142
- } catch (err) {
143
- logger.error('Delayed shutdown exec error', err instanceof Error ? err.message : String(err));
144
- }
145
- pendingShutdown = null;
146
- }, delayMs);
147
-
148
- return { delayed: true, delayMs };
149
- });
150
-
151
- // system:cancel-shutdown — cancel a pending delayed shutdown
152
- register('system:cancel-shutdown', async () => {
153
- if (pendingShutdown !== null) {
154
- clearTimeout(pendingShutdown);
155
- pendingShutdown = null;
156
- logger.info('Pending shutdown cancelled');
157
- return { cancelled: true };
158
- }
159
-
160
- logger.info('No pending shutdown to cancel');
161
- return { cancelled: false, reason: 'no pending shutdown' };
162
- });
163
- }
1
+ import { execFile } from 'child_process';
2
+ import { z } from 'zod';
3
+ import type { CommandHandler } from '../lib/types.js';
4
+ import { getPlatform } from '../lib/platform.js';
5
+ import type { Logger } from '../lib/logger.js';
6
+
7
+ // --- Zod Schemas ---
8
+ const ShutdownDelayedArgsSchema = z.object({
9
+ delayMs: z.number().finite().optional(),
10
+ });
11
+
12
+ let pendingShutdown: ReturnType<typeof setTimeout> | null = null;
13
+
14
+ interface ExecCommand {
15
+ readonly bin: string;
16
+ readonly args: readonly string[];
17
+ }
18
+
19
+ function execCommand(cmd: ExecCommand, logger: Logger): void {
20
+ execFile(cmd.bin, [...cmd.args], (err, stdout, stderr) => {
21
+ if (err) {
22
+ logger.error(`Exec failed: ${cmd.bin}`, err.message);
23
+ }
24
+ if (stderr) {
25
+ logger.warn(`Exec stderr: ${cmd.bin}`, stderr);
26
+ }
27
+ if (stdout) {
28
+ logger.debug(`Exec stdout: ${cmd.bin}`, stdout);
29
+ }
30
+ });
31
+ }
32
+
33
+ function getShutdownCommand(): ExecCommand {
34
+ const platform = getPlatform();
35
+ switch (platform) {
36
+ case 'windows':
37
+ return { bin: 'shutdown', args: ['/s', '/t', '0'] };
38
+ case 'darwin':
39
+ case 'linux':
40
+ default:
41
+ return { bin: 'shutdown', args: ['-h', 'now'] };
42
+ }
43
+ }
44
+
45
+ function getRebootCommand(): ExecCommand {
46
+ const platform = getPlatform();
47
+ switch (platform) {
48
+ case 'windows':
49
+ return { bin: 'shutdown', args: ['/r', '/t', '0'] };
50
+ case 'darwin':
51
+ case 'linux':
52
+ default:
53
+ return { bin: 'shutdown', args: ['-r', 'now'] };
54
+ }
55
+ }
56
+
57
+ function getSuspendCommand(): ExecCommand {
58
+ const platform = getPlatform();
59
+ switch (platform) {
60
+ case 'linux':
61
+ return { bin: 'systemctl', args: ['suspend'] };
62
+ case 'windows':
63
+ return { bin: 'rundll32.exe', args: ['powrprof.dll,SetSuspendState', '0,1,0'] };
64
+ case 'darwin':
65
+ return { bin: 'pmset', args: ['sleepnow'] };
66
+ default:
67
+ return { bin: 'systemctl', args: ['suspend'] };
68
+ }
69
+ }
70
+
71
+ export function registerPowerCommands(
72
+ register: (command: string, handler: CommandHandler) => void,
73
+ logger: Logger
74
+ ): void {
75
+ // system:shutdown — graceful shutdown with 5s delay
76
+ register('system:shutdown', async () => {
77
+ const cmd = getShutdownCommand();
78
+ logger.info(`Scheduling shutdown in 5000ms: ${cmd}`);
79
+
80
+ setTimeout(() => {
81
+ try {
82
+ execCommand(cmd, logger);
83
+ } catch (err) {
84
+ logger.error('Shutdown exec error', err instanceof Error ? err.message : String(err));
85
+ }
86
+ }, 5000);
87
+
88
+ return { delayed: true, delayMs: 5000 };
89
+ });
90
+
91
+ // system:reboot — graceful reboot with 5s delay
92
+ register('system:reboot', async () => {
93
+ const cmd = getRebootCommand();
94
+ logger.info(`Scheduling reboot in 5000ms: ${cmd}`);
95
+
96
+ setTimeout(() => {
97
+ try {
98
+ execCommand(cmd, logger);
99
+ } catch (err) {
100
+ logger.error('Reboot exec error', err instanceof Error ? err.message : String(err));
101
+ }
102
+ }, 5000);
103
+
104
+ return { delayed: true, delayMs: 5000 };
105
+ });
106
+
107
+ // system:suspend — immediate suspend
108
+ register('system:suspend', async () => {
109
+ const cmd = getSuspendCommand();
110
+ logger.info(`Executing suspend: ${cmd}`);
111
+
112
+ try {
113
+ execCommand(cmd, logger);
114
+ } catch (err) {
115
+ logger.error('Suspend exec error', err instanceof Error ? err.message : String(err));
116
+ }
117
+
118
+ return { suspended: true };
119
+ });
120
+
121
+ // system:shutdown-delayed — shutdown after configurable delay (5s to 24h)
122
+ register('system:shutdown-delayed', async (args) => {
123
+ const parsed = ShutdownDelayedArgsSchema.safeParse(args ?? {});
124
+ if (!parsed.success) {
125
+ throw new Error(`Invalid args: ${parsed.error.issues.map((i) => i.message).join(', ')}`);
126
+ }
127
+ const rawDelay = parsed.data.delayMs ?? 60000;
128
+ const delayMs = Math.max(5000, Math.min(rawDelay, 86_400_000));
129
+ const cmd = getShutdownCommand();
130
+
131
+ logger.info(`Scheduling delayed shutdown in ${delayMs}ms: ${cmd}`);
132
+
133
+ // Clear any existing pending shutdown
134
+ if (pendingShutdown !== null) {
135
+ clearTimeout(pendingShutdown);
136
+ logger.info('Cleared previous pending shutdown');
137
+ }
138
+
139
+ pendingShutdown = setTimeout(() => {
140
+ try {
141
+ execCommand(cmd, logger);
142
+ } catch (err) {
143
+ logger.error('Delayed shutdown exec error', err instanceof Error ? err.message : String(err));
144
+ }
145
+ pendingShutdown = null;
146
+ }, delayMs);
147
+
148
+ return { delayed: true, delayMs };
149
+ });
150
+
151
+ // system:cancel-shutdown — cancel a pending delayed shutdown
152
+ register('system:cancel-shutdown', async () => {
153
+ if (pendingShutdown !== null) {
154
+ clearTimeout(pendingShutdown);
155
+ pendingShutdown = null;
156
+ logger.info('Pending shutdown cancelled');
157
+ return { cancelled: true };
158
+ }
159
+
160
+ logger.info('No pending shutdown to cancel');
161
+ return { cancelled: false, reason: 'no pending shutdown' };
162
+ });
163
+ }