lightman-agent 1.0.5 → 1.0.6

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 (115) hide show
  1. package/agent.config.template.json +30 -30
  2. package/package.json +52 -52
  3. package/public/assets/index-CcBNCz6h.css +1 -1
  4. package/public/assets/index-D9QHMG8k.js +1 -0
  5. package/public/assets/index-H-8HDl46.js +1 -1
  6. package/public/assets/index-YodeiCia.css +1 -0
  7. package/public/assets/index-legacy-DWtNM8y7.js +41 -0
  8. package/public/assets/museum-map-CwVDA2z1.svg +4182 -0
  9. package/public/assets/polyfills-legacy-DyVYWHbW.js +4 -0
  10. package/public/index.html +7 -2
  11. package/public/templates/custom08/elements/back-button.svg +20 -0
  12. package/public/templates/custom08/elements/base-map-background.svg +37 -0
  13. package/public/templates/custom08/elements/base-map.svg +1191 -0
  14. package/public/templates/custom08/elements/gallery-1-2-3-info-panel.svg +236 -0
  15. package/public/templates/custom08/elements/gallery-4-5-6-7-info-panel.svg +266 -0
  16. package/public/templates/custom08/elements/gallery-8-9-info-panel.svg +274 -0
  17. package/public/templates/custom08/elements/gallery-labels/_nav-map-styles.css +554 -0
  18. package/public/templates/custom08/elements/gallery-labels/_styles.css +556 -0
  19. package/public/templates/custom08/elements/gallery-labels/gallery-1.svg +35 -0
  20. package/public/templates/custom08/elements/gallery-labels/gallery-2.svg +34 -0
  21. package/public/templates/custom08/elements/gallery-labels/gallery-3.svg +34 -0
  22. package/public/templates/custom08/elements/gallery-labels/gallery-4.svg +37 -0
  23. package/public/templates/custom08/elements/gallery-labels/gallery-5.svg +34 -0
  24. package/public/templates/custom08/elements/gallery-labels/gallery-6.svg +34 -0
  25. package/public/templates/custom08/elements/gallery-labels/gallery-7.svg +34 -0
  26. package/public/templates/custom08/elements/gallery-labels/gallery-8.svg +37 -0
  27. package/public/templates/custom08/elements/gallery-labels/gallery-9.svg +34 -0
  28. package/public/templates/custom08/elements/hand-hint.png +0 -0
  29. package/public/templates/custom08/elements/idle-screen-bg.svg +5 -0
  30. package/public/templates/custom08/elements/idle-screen-map.svg +627 -0
  31. package/public/templates/custom08/elements/idle-screen-text.svg +350 -0
  32. package/public/templates/custom08/elements/key-map-1.svg +986 -0
  33. package/public/templates/custom08/elements/key-map-2.svg +1018 -0
  34. package/public/templates/custom08/elements/key-map-3.svg +1019 -0
  35. package/public/templates/custom08/elements/key-map-combined.svg +1001 -0
  36. package/public/templates/custom08/elements/map-highlight-marker.svg +11 -0
  37. package/public/templates/custom08/elements/map-pin-marker.svg +15 -0
  38. package/public/templates/custom08/elements/map-teardrop-star-marker.svg +13 -0
  39. package/public/templates/custom08/elements/nav-circle-galleries-1-3.svg +21 -0
  40. package/public/templates/custom08/elements/nav-circle-galleries-4-7.svg +24 -0
  41. package/public/templates/custom08/elements/nav-circle-galleries-8-9.svg +20 -0
  42. package/public/templates/custom08/elements/section1-map.svg +1435 -0
  43. package/public/templates/custom08/elements/section2-map.svg +1724 -0
  44. package/public/templates/custom08/elements/section3-map.svg +1295 -0
  45. package/public/templates/custom08/fonts/CabinetGrotesk-Variable.ttf +0 -0
  46. package/public/templates/custom08/images/highlights/Screenshot_2026-03-05_at_7.23.12_PM.png +0 -0
  47. package/public/templates/custom08/images/highlights/Screenshot_2026-03-05_at_7.23.56_PM.png +0 -0
  48. package/public/templates/custom08/images/highlights/Screenshot_2026-03-05_at_7.24.24_PM.png +0 -0
  49. package/public/templates/custom08/images/highlights/Screenshot_2026-03-24_at_11.31.58_PM.jpg +0 -0
  50. package/public/templates/custom08/images/highlights/Screenshot_2026-03-24_at_11.32.11_PM.jpg +0 -0
  51. package/public/templates/custom08/images/highlights/Screenshot_2026-03-24_at_11.32.36_PM.jpg +0 -0
  52. package/public/templates/custom08/images/highlights/Screenshot_2026-03-24_at_11.32.48_PM.jpg +0 -0
  53. package/public/templates/custom08/images/highlights/Screenshot_2026-03-24_at_11.32.59_PM.jpg +0 -0
  54. package/public/templates/custom08/images/highlights/Screenshot_2026-03-24_at_11.33.15_PM.jpg +0 -0
  55. package/public/templates/custom08/images/highlights/Screenshot_2026-03-24_at_11.33.27_PM.jpg +0 -0
  56. package/public/templates/custom08/images/highlights/Screenshot_2026-03-24_at_11.33.34_PM.jpg +0 -0
  57. package/public/templates/custom08/images/highlights/Screenshot_2026-03-24_at_11.33.42_PM.jpg +0 -0
  58. package/public/templates/custom08/images/highlights/Screenshot_2026-03-24_at_11.33.50_PM.jpg +0 -0
  59. package/public/templates/custom08/images/highlights/Screenshot_2026-03-24_at_11.33.58_PM.jpg +0 -0
  60. package/public/templates/custom08/images/highlights/Screenshot_2026-03-24_at_11.34.04_PM.jpg +0 -0
  61. package/public/templates/custom08/images/highlights/Screenshot_2026-03-24_at_11.34.11_PM.jpg +0 -0
  62. package/public/templates/custom08/images/highlights/Screenshot_2026-03-24_at_11.34.20_PM.jpg +0 -0
  63. package/public/templates/custom08/images/highlights/Screenshot_2026-03-24_at_11.34.57_PM.jpg +0 -0
  64. package/public/templates/custom08/images/highlights/Screenshot_2026-03-24_at_11.35.03_PM.jpg +0 -0
  65. package/public/templates/custom08/images/highlights/Screenshot_2026-03-24_at_11.35.16_PM.jpg +0 -0
  66. package/public/templates/custom08/images/highlights/Screenshot_2026-03-24_at_11.35.23_PM.jpg +0 -0
  67. package/public/templates/custom08/images/highlights/prologue-highlight.png +0 -0
  68. package/scripts/guardian.ps1 +75 -75
  69. package/scripts/install-linux.sh +134 -134
  70. package/scripts/install-rpi.sh +117 -117
  71. package/scripts/install-windows.ps1 +505 -505
  72. package/scripts/launch-kiosk.vbs +101 -101
  73. package/scripts/lightman-agent.logrotate +12 -12
  74. package/scripts/lightman-agent.service +38 -38
  75. package/scripts/lightman-shell.bat +107 -107
  76. package/scripts/reinstall-windows.ps1 +26 -26
  77. package/scripts/restore-desktop.ps1 +32 -32
  78. package/scripts/setup.ps1 +116 -116
  79. package/scripts/setup.sh +115 -115
  80. package/scripts/sync-display.mjs +20 -0
  81. package/scripts/uninstall-linux.sh +50 -50
  82. package/scripts/uninstall-windows.ps1 +54 -54
  83. package/src/commands/display.ts +177 -177
  84. package/src/commands/kiosk.ts +113 -113
  85. package/src/commands/maintenance.ts +106 -106
  86. package/src/commands/network.ts +129 -129
  87. package/src/commands/power.ts +163 -163
  88. package/src/commands/rpi.ts +45 -45
  89. package/src/commands/screenshot.ts +166 -166
  90. package/src/commands/serial.ts +17 -17
  91. package/src/commands/update.ts +124 -124
  92. package/src/index.ts +652 -652
  93. package/src/lib/config.ts +69 -69
  94. package/src/lib/identity.ts +40 -40
  95. package/src/lib/logger.ts +137 -137
  96. package/src/lib/platform.ts +10 -10
  97. package/src/lib/rpi.ts +180 -180
  98. package/src/lib/screens.ts +128 -128
  99. package/src/lib/types.ts +176 -176
  100. package/src/services/commands.ts +107 -107
  101. package/src/services/health.ts +161 -161
  102. package/src/services/kiosk.ts +384 -384
  103. package/src/services/localEvents.ts +60 -60
  104. package/src/services/logForwarder.ts +72 -72
  105. package/src/services/multiScreenKiosk.ts +324 -324
  106. package/src/services/oscBridge.ts +186 -186
  107. package/src/services/powerScheduler.ts +260 -260
  108. package/src/services/provisioning.ts +120 -120
  109. package/src/services/serialBridge.ts +230 -230
  110. package/src/services/serviceLauncher.ts +183 -183
  111. package/src/services/staticServer.ts +226 -226
  112. package/src/services/updater.ts +249 -249
  113. package/src/services/watchdog.ts +310 -310
  114. package/src/services/websocket.ts +152 -152
  115. 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
+ }