@tmhs/homelab-mcp 0.15.3 → 0.16.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (140) hide show
  1. package/README.md +9 -4
  2. package/dist/index.js +1 -1
  3. package/dist/tools/adguardFilters.d.ts.map +1 -1
  4. package/dist/tools/adguardFilters.js +7 -26
  5. package/dist/tools/adguardFilters.js.map +1 -1
  6. package/dist/tools/adguardQueryLog.d.ts.map +1 -1
  7. package/dist/tools/adguardQueryLog.js +8 -26
  8. package/dist/tools/adguardQueryLog.js.map +1 -1
  9. package/dist/tools/adguardStats.d.ts.map +1 -1
  10. package/dist/tools/adguardStats.js +7 -26
  11. package/dist/tools/adguardStats.js.map +1 -1
  12. package/dist/tools/alertList.d.ts +5 -0
  13. package/dist/tools/alertList.d.ts.map +1 -1
  14. package/dist/tools/alertList.js +16 -17
  15. package/dist/tools/alertList.js.map +1 -1
  16. package/dist/tools/aptHistory.d.ts +6 -0
  17. package/dist/tools/aptHistory.d.ts.map +1 -1
  18. package/dist/tools/aptHistory.js +14 -4
  19. package/dist/tools/aptHistory.js.map +1 -1
  20. package/dist/tools/aptUpdate.d.ts.map +1 -1
  21. package/dist/tools/aptUpdate.js +20 -5
  22. package/dist/tools/aptUpdate.js.map +1 -1
  23. package/dist/tools/backupDiff.d.ts.map +1 -1
  24. package/dist/tools/backupDiff.js +2 -1
  25. package/dist/tools/backupDiff.js.map +1 -1
  26. package/dist/tools/backupList.d.ts.map +1 -1
  27. package/dist/tools/backupList.js +7 -4
  28. package/dist/tools/backupList.js.map +1 -1
  29. package/dist/tools/backupRestore.d.ts.map +1 -1
  30. package/dist/tools/backupRestore.js +4 -3
  31. package/dist/tools/backupRestore.js.map +1 -1
  32. package/dist/tools/backupRun.d.ts.map +1 -1
  33. package/dist/tools/backupRun.js +10 -2
  34. package/dist/tools/backupRun.js.map +1 -1
  35. package/dist/tools/backupStatus.d.ts.map +1 -1
  36. package/dist/tools/backupStatus.js +8 -4
  37. package/dist/tools/backupStatus.js.map +1 -1
  38. package/dist/tools/certList.d.ts.map +1 -1
  39. package/dist/tools/certList.js +25 -18
  40. package/dist/tools/certList.js.map +1 -1
  41. package/dist/tools/certRenew.js +2 -2
  42. package/dist/tools/certRenew.js.map +1 -1
  43. package/dist/tools/composeDown.d.ts.map +1 -1
  44. package/dist/tools/composeDown.js +3 -10
  45. package/dist/tools/composeDown.js.map +1 -1
  46. package/dist/tools/composePs.d.ts.map +1 -1
  47. package/dist/tools/composePs.js +2 -2
  48. package/dist/tools/composePs.js.map +1 -1
  49. package/dist/tools/composePull.d.ts.map +1 -1
  50. package/dist/tools/composePull.js +3 -10
  51. package/dist/tools/composePull.js.map +1 -1
  52. package/dist/tools/composeUp.d.ts.map +1 -1
  53. package/dist/tools/composeUp.js +5 -11
  54. package/dist/tools/composeUp.js.map +1 -1
  55. package/dist/tools/containerScan.d.ts.map +1 -1
  56. package/dist/tools/containerScan.js +14 -6
  57. package/dist/tools/containerScan.js.map +1 -1
  58. package/dist/tools/diagnostics.d.ts +5 -0
  59. package/dist/tools/diagnostics.d.ts.map +1 -1
  60. package/dist/tools/diagnostics.js +26 -19
  61. package/dist/tools/diagnostics.js.map +1 -1
  62. package/dist/tools/diskUsage.d.ts.map +1 -1
  63. package/dist/tools/diskUsage.js +4 -3
  64. package/dist/tools/diskUsage.js.map +1 -1
  65. package/dist/tools/grafanaSnapshot.d.ts.map +1 -1
  66. package/dist/tools/grafanaSnapshot.js +11 -34
  67. package/dist/tools/grafanaSnapshot.js.map +1 -1
  68. package/dist/tools/healthCheck.d.ts +8 -0
  69. package/dist/tools/healthCheck.d.ts.map +1 -1
  70. package/dist/tools/healthCheck.js +56 -21
  71. package/dist/tools/healthCheck.js.map +1 -1
  72. package/dist/tools/journalLogs.d.ts.map +1 -1
  73. package/dist/tools/journalLogs.js +1 -0
  74. package/dist/tools/journalLogs.js.map +1 -1
  75. package/dist/tools/logSearch.d.ts.map +1 -1
  76. package/dist/tools/logSearch.js +20 -6
  77. package/dist/tools/logSearch.js.map +1 -1
  78. package/dist/tools/nodeList.d.ts.map +1 -1
  79. package/dist/tools/nodeList.js +22 -11
  80. package/dist/tools/nodeList.js.map +1 -1
  81. package/dist/tools/npmCerts.d.ts.map +1 -1
  82. package/dist/tools/npmCerts.js +6 -38
  83. package/dist/tools/npmCerts.js.map +1 -1
  84. package/dist/tools/npmProxyHosts.d.ts.map +1 -1
  85. package/dist/tools/npmProxyHosts.js +6 -38
  86. package/dist/tools/npmProxyHosts.js.map +1 -1
  87. package/dist/tools/ntfySend.d.ts.map +1 -1
  88. package/dist/tools/ntfySend.js +6 -16
  89. package/dist/tools/ntfySend.js.map +1 -1
  90. package/dist/tools/ntfyTopics.d.ts +4 -0
  91. package/dist/tools/ntfyTopics.d.ts.map +1 -1
  92. package/dist/tools/ntfyTopics.js +26 -17
  93. package/dist/tools/ntfyTopics.js.map +1 -1
  94. package/dist/tools/prometheusQuery.d.ts.map +1 -1
  95. package/dist/tools/prometheusQuery.js +8 -16
  96. package/dist/tools/prometheusQuery.js.map +1 -1
  97. package/dist/tools/serviceLogs.d.ts.map +1 -1
  98. package/dist/tools/serviceLogs.js +5 -1
  99. package/dist/tools/serviceLogs.js.map +1 -1
  100. package/dist/tools/speedtestResults.d.ts.map +1 -1
  101. package/dist/tools/speedtestResults.js +7 -16
  102. package/dist/tools/speedtestResults.js.map +1 -1
  103. package/dist/tools/sshTest.js +4 -4
  104. package/dist/tools/sshTest.js.map +1 -1
  105. package/dist/tools/uptimeKumaStatus.d.ts +4 -0
  106. package/dist/tools/uptimeKumaStatus.d.ts.map +1 -1
  107. package/dist/tools/uptimeKumaStatus.js +30 -16
  108. package/dist/tools/uptimeKumaStatus.js.map +1 -1
  109. package/dist/tools/volumeBackup.d.ts.map +1 -1
  110. package/dist/tools/volumeBackup.js +4 -3
  111. package/dist/tools/volumeBackup.js.map +1 -1
  112. package/dist/utils/compose.d.ts +27 -0
  113. package/dist/utils/compose.d.ts.map +1 -0
  114. package/dist/utils/compose.js +92 -0
  115. package/dist/utils/compose.js.map +1 -0
  116. package/dist/utils/config.d.ts +4 -0
  117. package/dist/utils/config.d.ts.map +1 -0
  118. package/dist/utils/config.js +7 -0
  119. package/dist/utils/config.js.map +1 -0
  120. package/dist/utils/errors.d.ts +2 -2
  121. package/dist/utils/errors.d.ts.map +1 -1
  122. package/dist/utils/errors.js +8 -4
  123. package/dist/utils/errors.js.map +1 -1
  124. package/dist/utils/restic.d.ts +13 -0
  125. package/dist/utils/restic.d.ts.map +1 -0
  126. package/dist/utils/restic.js +21 -0
  127. package/dist/utils/restic.js.map +1 -0
  128. package/dist/utils/service-http.d.ts +82 -0
  129. package/dist/utils/service-http.d.ts.map +1 -0
  130. package/dist/utils/service-http.js +104 -0
  131. package/dist/utils/service-http.js.map +1 -0
  132. package/dist/utils/since-param.d.ts +13 -0
  133. package/dist/utils/since-param.d.ts.map +1 -0
  134. package/dist/utils/since-param.js +21 -0
  135. package/dist/utils/since-param.js.map +1 -0
  136. package/dist/utils/ssh-api.d.ts +54 -3
  137. package/dist/utils/ssh-api.d.ts.map +1 -1
  138. package/dist/utils/ssh-api.js +222 -33
  139. package/dist/utils/ssh-api.js.map +1 -1
  140. package/package.json +1 -1
@@ -1 +1 @@
1
- {"version":3,"file":"ntfyTopics.js","sourceRoot":"","sources":["../../src/tools/ntfyTopics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEnD,MAAM,YAAY,GAAG,IAAI,CAAC;AAC1B,MAAM,YAAY,GAAG,MAAM,CAAC;AAE5B,MAAM,WAAW,GAAG;IAClB,GAAG,SAAS;IACZ,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,+DAA+D,CAAC;IAC5E,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,CAAC,0DAA0D,CAAC;CACxE,CAAC;AAEF,SAAS,OAAO;IACd,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;IAC/C,OAAO,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,oBAAoB,EACpB,sCAAsC,EACtC,WAAW,EACX,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;QACvB,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,IAAI,GAAG,CAAC;YACpC,MAAM,GAAG,GAAG,8BAA8B,IAAI,IAAI,SAAS,eAAe,IAAI,CAAC,KAAK,UAAU,CAAC;YAC/F,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YAC7C,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,IAAI,2BAA2B,EAAE,CAAC,EAAE,CAAC;QAC/F,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,kBAAkB,EAAE,CAAC;gBACxC,IAAI,KAAK,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;oBACzB,OAAO,aAAa,CAClB,IAAI,KAAK,CACP,wBAAwB,YAAY,YAAY,IAAI,mBAAmB;wBACrE,oDAAoD,CACvD,CACF,CAAC;gBACJ,CAAC;YACH,CAAC;YACD,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}
1
+ {"version":3,"file":"ntfyTopics.js","sourceRoot":"","sources":["../../src/tools/ntfyTopics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7F,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC;AAE9B,gFAAgF;AAChF,MAAM,CAAC,MAAM,aAAa,GAAG,8CAA8C,CAAC;AAE5E,uEAAuE;AACvE,MAAM,UAAU,aAAa,CAAC,KAAc,EAAE,IAAa;IACzD,MAAM,SAAS,GAAG,CAAC,KAAK,IAAI,OAAO,CAAC,IAAI,EAAE,qBAAqB,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC5F,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IAC5B,OAAO,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;AAC1D,CAAC;AAED,MAAM,WAAW,GAAG;IAClB,GAAG,SAAS;IACZ,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,KAAK,CAAC,aAAa,EAAE,oFAAoF,CAAC;SAC1G,QAAQ,EAAE;SACV,QAAQ,CACP,6FAA6F;QAC3F,0EAA0E,CAC7E;IACH,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,CAAC,0DAA0D,CAAC;CACxE,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,oBAAoB,EACpB,sCAAsC,EACtC,WAAW,EACX,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC;QAC/B,IAAI,SAAS,GAAkB,IAAI,CAAC;QACpC,IAAI,CAAC;YACH,IAAI,GAAG,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YACvC,SAAS,GAAG,aAAa,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YACjD,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,OAAO,aAAa,CAClB,IAAI,KAAK,CACP,iFAAiF;oBAC/E,iGAAiG,CACpG,CACF,CAAC;YACJ,CAAC;YACD,MAAM,GAAG,GAAG,8BAA8B,IAAI,IAAI,SAAS,eAAe,IAAI,CAAC,KAAK,UAAU,CAAC;YAC/F,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YAC7C,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,IAAI,2BAA2B,EAAE,CAAC,EAAE,CAAC;QAC/F,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE;gBAC7C,SAAS,EACP,GAAG,OAAO,CAAC,IAAI,yCAAyC,SAAS,qBAAqB;oBACtF,iFAAiF;aACpF,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"prometheusQuery.d.ts","sourceRoot":"","sources":["../../src/tools/prometheusQuery.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAsBzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA+BhD"}
1
+ {"version":3,"file":"prometheusQuery.d.ts","sourceRoot":"","sources":["../../src/tools/prometheusQuery.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAgBzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAwBhD"}
@@ -1,9 +1,8 @@
1
1
  import { z } from "zod";
2
- import { execSSH, errorResponse } from "../utils/ssh-api.js";
3
- import { CommandFailedError } from "../utils/errors.js";
2
+ import { execSSH } from "../utils/ssh-api.js";
4
3
  import { nodeParam } from "../utils/node-param.js";
5
- const DEFAULT_PORT = 9090;
6
- const SERVICE_NAME = "Prometheus";
4
+ import { SERVICES, servicePort, curlErrorResponse } from "../utils/service-http.js";
5
+ const SERVICE = SERVICES.prometheus;
7
6
  const inputSchema = {
8
7
  ...nodeParam,
9
8
  query: z.string().min(1).describe("PromQL expression to evaluate"),
@@ -12,27 +11,20 @@ const inputSchema = {
12
11
  .optional()
13
12
  .describe("Evaluation timestamp (RFC3339 or Unix). Defaults to current time"),
14
13
  };
15
- function getPort() {
16
- const override = process.env.HOMELAB_PROMETHEUS_PORT;
17
- return override ? parseInt(override, 10) : DEFAULT_PORT;
18
- }
19
14
  export function register(server) {
20
15
  server.tool("homelab_prometheusQuery", "Run a PromQL query against Prometheus and return the result", inputSchema, async (args) => {
21
- const port = getPort();
16
+ let port = SERVICE.defaultPort;
22
17
  try {
18
+ port = servicePort(SERVICE, args.node);
23
19
  const encoded = encodeURIComponent(args.query);
24
20
  const timeParam = args.time ? `&time=${encodeURIComponent(args.time)}` : "";
25
21
  const output = await execSSH(`curl -sf 'http://localhost:${port}/api/v1/query?query=${encoded}${timeParam}'`, args.node);
26
22
  return { content: [{ type: "text", text: output }] };
27
23
  }
28
24
  catch (error) {
29
- if (error instanceof CommandFailedError) {
30
- if (error.exitCode === 7) {
31
- return errorResponse(new Error(`Could not reach ${SERVICE_NAME} on port ${port}. Is it running? ` +
32
- `Set HOMELAB_PROMETHEUS_PORT if using a non-default port.`));
33
- }
34
- }
35
- return errorResponse(error);
25
+ return curlErrorResponse(error, SERVICE, port, {
26
+ httpError: `${SERVICE.name} on port ${port} returned an HTTP error. Check the PromQL expression and time value.`,
27
+ });
36
28
  }
37
29
  });
38
30
  }
@@ -1 +1 @@
1
- {"version":3,"file":"prometheusQuery.js","sourceRoot":"","sources":["../../src/tools/prometheusQuery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEnD,MAAM,YAAY,GAAG,IAAI,CAAC;AAC1B,MAAM,YAAY,GAAG,YAAY,CAAC;AAElC,MAAM,WAAW,GAAG;IAClB,GAAG,SAAS;IACZ,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,+BAA+B,CAAC;IAClE,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,kEAAkE,CAAC;CAChF,CAAC;AAEF,SAAS,OAAO;IACd,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC;IACrD,OAAO,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,yBAAyB,EACzB,6DAA6D,EAC7D,WAAW,EACX,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;QACvB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC/C,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5E,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,8BAA8B,IAAI,uBAAuB,OAAO,GAAG,SAAS,GAAG,EAC/E,IAAI,CAAC,IAAI,CACV,CAAC;YAEF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;QAChE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,kBAAkB,EAAE,CAAC;gBACxC,IAAI,KAAK,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;oBACzB,OAAO,aAAa,CAClB,IAAI,KAAK,CACP,mBAAmB,YAAY,YAAY,IAAI,mBAAmB;wBAChE,0DAA0D,CAC7D,CACF,CAAC;gBACJ,CAAC;YACH,CAAC;YACD,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}
1
+ {"version":3,"file":"prometheusQuery.js","sourceRoot":"","sources":["../../src/tools/prometheusQuery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAEpF,MAAM,OAAO,GAAG,QAAQ,CAAC,UAAU,CAAC;AAEpC,MAAM,WAAW,GAAG;IAClB,GAAG,SAAS;IACZ,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,+BAA+B,CAAC;IAClE,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,kEAAkE,CAAC;CAChF,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,yBAAyB,EACzB,6DAA6D,EAC7D,WAAW,EACX,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC;QAC/B,IAAI,CAAC;YACH,IAAI,GAAG,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YACvC,MAAM,OAAO,GAAG,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC/C,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5E,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,8BAA8B,IAAI,uBAAuB,OAAO,GAAG,SAAS,GAAG,EAC/E,IAAI,CAAC,IAAI,CACV,CAAC;YAEF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;QAChE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE;gBAC7C,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,YAAY,IAAI,sEAAsE;aACjH,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"serviceLogs.d.ts","sourceRoot":"","sources":["../../src/tools/serviceLogs.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAgBzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAuBhD"}
1
+ {"version":3,"file":"serviceLogs.d.ts","sourceRoot":"","sources":["../../src/tools/serviceLogs.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAmBzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAwBhD"}
@@ -1,6 +1,7 @@
1
1
  import { z } from "zod";
2
2
  import { execSSH, errorResponse } from "../utils/ssh-api.js";
3
3
  import { nodeParam } from "../utils/node-param.js";
4
+ import { sinceSchema, toDockerSince } from "../utils/since-param.js";
4
5
  const inputSchema = {
5
6
  ...nodeParam,
6
7
  service: z.string().min(1).describe("Container name to get logs from"),
@@ -8,14 +9,17 @@ const inputSchema = {
8
9
  .number()
9
10
  .int()
10
11
  .positive()
12
+ .max(5000)
11
13
  .optional()
12
14
  .default(50)
13
15
  .describe("Number of recent log lines to return"),
16
+ since: sinceSchema("Only show logs newer than this (e.g. 30m, 2h, 7d, or an ISO date)").optional(),
14
17
  };
15
18
  export function register(server) {
16
19
  server.tool("homelab_serviceLogs", "Tail recent logs from a Docker container on the Pi", inputSchema, async (args) => {
17
20
  try {
18
- const output = await execSSH(`docker logs --tail ${args.lines} ${args.service} 2>&1`, args.node);
21
+ const since = args.since ? ` --since ${toDockerSince(args.since)}` : "";
22
+ const output = await execSSH(`docker logs --tail ${args.lines}${since} ${args.service} 2>&1`, args.node);
19
23
  return {
20
24
  content: [{
21
25
  type: "text",
@@ -1 +1 @@
1
- {"version":3,"file":"serviceLogs.js","sourceRoot":"","sources":["../../src/tools/serviceLogs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEnD,MAAM,WAAW,GAAG;IAClB,GAAG,SAAS;IACZ,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,iCAAiC,CAAC;IACtE,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,QAAQ,EAAE;SACV,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CAAC,sCAAsC,CAAC;CACpD,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,qBAAqB,EACrB,oDAAoD,EACpD,WAAW,EACX,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,sBAAsB,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,OAAO,OAAO,EACvD,IAAI,CAAC,IAAI,CACV,CAAC;YAEF,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,MAAM,IAAI,qBAAqB,IAAI,CAAC,OAAO,GAAG;qBACrD,CAAC;aACH,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}
1
+ {"version":3,"file":"serviceLogs.js","sourceRoot":"","sources":["../../src/tools/serviceLogs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAErE,MAAM,WAAW,GAAG;IAClB,GAAG,SAAS;IACZ,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,iCAAiC,CAAC;IACtE,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,GAAG,CAAC,IAAI,CAAC;SACT,QAAQ,EAAE;SACV,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CAAC,sCAAsC,CAAC;IACnD,KAAK,EAAE,WAAW,CAAC,mEAAmE,CAAC,CAAC,QAAQ,EAAE;CACnG,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,qBAAqB,EACrB,oDAAoD,EACpD,WAAW,EACX,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACxE,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,sBAAsB,IAAI,CAAC,KAAK,GAAG,KAAK,IAAI,IAAI,CAAC,OAAO,OAAO,EAC/D,IAAI,CAAC,IAAI,CACV,CAAC;YAEF,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,MAAM,IAAI,qBAAqB,IAAI,CAAC,OAAO,GAAG;qBACrD,CAAC;aACH,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"speedtestResults.d.ts","sourceRoot":"","sources":["../../src/tools/speedtestResults.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAwBzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA6BhD"}
1
+ {"version":3,"file":"speedtestResults.d.ts","sourceRoot":"","sources":["../../src/tools/speedtestResults.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAmBzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAoBhD"}
@@ -1,38 +1,29 @@
1
1
  import { z } from "zod";
2
- import { execSSH, errorResponse } from "../utils/ssh-api.js";
3
- import { CommandFailedError } from "../utils/errors.js";
2
+ import { execSSH } from "../utils/ssh-api.js";
4
3
  import { nodeParam } from "../utils/node-param.js";
5
- const DEFAULT_PORT = 8765;
6
- const SERVICE_NAME = "Speedtest Tracker";
4
+ import { SERVICES, servicePort, curlErrorResponse } from "../utils/service-http.js";
5
+ const SERVICE = SERVICES.speedtest;
7
6
  const inputSchema = {
8
7
  ...nodeParam,
9
8
  count: z
10
9
  .number()
11
10
  .int()
12
11
  .positive()
12
+ .max(100)
13
13
  .optional()
14
14
  .default(5)
15
15
  .describe("Number of recent speedtest results to return"),
16
16
  };
17
- function getPort() {
18
- const override = process.env.HOMELAB_SPEEDTEST_PORT;
19
- return override ? parseInt(override, 10) : DEFAULT_PORT;
20
- }
21
17
  export function register(server) {
22
18
  server.tool("homelab_speedtestResults", "Get recent speedtest results from Speedtest Tracker", inputSchema, async (args) => {
23
- const port = getPort();
19
+ let port = SERVICE.defaultPort;
24
20
  try {
21
+ port = servicePort(SERVICE, args.node);
25
22
  const output = await execSSH(`curl -sf 'http://localhost:${port}/api/speedtest/latest?limit=${args.count}'`, args.node);
26
23
  return { content: [{ type: "text", text: output }] };
27
24
  }
28
25
  catch (error) {
29
- if (error instanceof CommandFailedError) {
30
- if (error.exitCode === 7) {
31
- return errorResponse(new Error(`Could not connect to ${SERVICE_NAME} on port ${port}. Is it running? ` +
32
- `Set HOMELAB_SPEEDTEST_PORT if using a non-default port.`));
33
- }
34
- }
35
- return errorResponse(error);
26
+ return curlErrorResponse(error, SERVICE, port);
36
27
  }
37
28
  });
38
29
  }
@@ -1 +1 @@
1
- {"version":3,"file":"speedtestResults.js","sourceRoot":"","sources":["../../src/tools/speedtestResults.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEnD,MAAM,YAAY,GAAG,IAAI,CAAC;AAC1B,MAAM,YAAY,GAAG,mBAAmB,CAAC;AAEzC,MAAM,WAAW,GAAG;IAClB,GAAG,SAAS;IACZ,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,QAAQ,EAAE;SACV,OAAO,CAAC,CAAC,CAAC;SACV,QAAQ,CAAC,8CAA8C,CAAC;CAC5D,CAAC;AAEF,SAAS,OAAO;IACd,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC;IACpD,OAAO,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,0BAA0B,EAC1B,qDAAqD,EACrD,WAAW,EACX,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;QACvB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,8BAA8B,IAAI,+BAA+B,IAAI,CAAC,KAAK,GAAG,EAC9E,IAAI,CAAC,IAAI,CACV,CAAC;YAEF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;QAChE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,kBAAkB,EAAE,CAAC;gBACxC,IAAI,KAAK,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;oBACzB,OAAO,aAAa,CAClB,IAAI,KAAK,CACP,wBAAwB,YAAY,YAAY,IAAI,mBAAmB;wBACrE,yDAAyD,CAC5D,CACF,CAAC;gBACJ,CAAC;YACH,CAAC;YACD,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}
1
+ {"version":3,"file":"speedtestResults.js","sourceRoot":"","sources":["../../src/tools/speedtestResults.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAEpF,MAAM,OAAO,GAAG,QAAQ,CAAC,SAAS,CAAC;AAEnC,MAAM,WAAW,GAAG;IAClB,GAAG,SAAS;IACZ,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,EAAE;SACV,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,EAAE;SACV,OAAO,CAAC,CAAC,CAAC;SACV,QAAQ,CAAC,8CAA8C,CAAC;CAC5D,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,0BAA0B,EAC1B,qDAAqD,EACrD,WAAW,EACX,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC;QAC/B,IAAI,CAAC;YACH,IAAI,GAAG,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YACvC,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,8BAA8B,IAAI,+BAA+B,IAAI,CAAC,KAAK,GAAG,EAC9E,IAAI,CAAC,IAAI,CACV,CAAC;YAEF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;QAChE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QACjD,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}
@@ -1,10 +1,10 @@
1
- import { execSSH, errorResponse } from "../utils/ssh-api.js";
1
+ import { execSSH, errorResponse, getNodeConfig } from "../utils/ssh-api.js";
2
2
  import { nodeParam } from "../utils/node-param.js";
3
3
  export function register(server) {
4
- server.tool("homelab_sshTest", "Test SSH connectivity to the Raspberry Pi", { ...nodeParam }, async (args) => {
4
+ server.tool("homelab_sshTest", "Test SSH connectivity to the Raspberry Pi (or another registered node)", { ...nodeParam }, async (args) => {
5
5
  try {
6
- const host = process.env.HOMELAB_PI_HOST || "raspberrypi.local";
7
- const user = process.env.HOMELAB_PI_USER || "pi";
6
+ // Report the node that was actually tested, not the default Pi.
7
+ const { host, username: user } = getNodeConfig(args.node);
8
8
  const output = await execSSH("echo ok && hostname && uptime -p", args.node);
9
9
  const lines = output.split("\n");
10
10
  return {
@@ -1 +1 @@
1
- {"version":3,"file":"sshTest.js","sourceRoot":"","sources":["../../src/tools/sshTest.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEnD,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,iBAAiB,EACjB,2CAA2C,EAC3C,EAAE,GAAG,SAAS,EAAE,EAChB,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,mBAAmB,CAAC;YAChE,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,IAAI,CAAC;YAEjD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,kCAAkC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YAC5E,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAEjC,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE;4BACJ,qBAAqB,IAAI,IAAI,IAAI,MAAM;4BACvC,aAAa,KAAK,CAAC,CAAC,CAAC,IAAI,SAAS,EAAE;4BACpC,WAAW,KAAK,CAAC,CAAC,CAAC,IAAI,SAAS,EAAE;yBACnC,CAAC,IAAI,CAAC,IAAI,CAAC;qBACb,CAAC;aACH,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}
1
+ {"version":3,"file":"sshTest.js","sourceRoot":"","sources":["../../src/tools/sshTest.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC5E,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEnD,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,iBAAiB,EACjB,wEAAwE,EACxE,EAAE,GAAG,SAAS,EAAE,EAChB,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC;YACH,gEAAgE;YAChE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAE1D,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,kCAAkC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YAC5E,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAEjC,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE;4BACJ,qBAAqB,IAAI,IAAI,IAAI,MAAM;4BACvC,aAAa,KAAK,CAAC,CAAC,CAAC,IAAI,SAAS,EAAE;4BACpC,WAAW,KAAK,CAAC,CAAC,CAAC,IAAI,SAAS,EAAE;yBACnC,CAAC,IAAI,CAAC,IAAI,CAAC;qBACb,CAAC;aACH,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}
@@ -1,3 +1,7 @@
1
1
  import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
+ /** Uptime Kuma status page slugs: lowercase letters, digits and dashes. */
3
+ export declare const SLUG_RE: RegExp;
4
+ /** Slug from the argument, then HOMELAB_UPTIME_KUMA_SLUG, then "default". */
5
+ export declare function resolveSlug(slug?: string, node?: string): string;
2
6
  export declare function register(server: McpServer): void;
3
7
  //# sourceMappingURL=uptimeKumaStatus.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"uptimeKumaStatus.d.ts","sourceRoot":"","sources":["../../src/tools/uptimeKumaStatus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAazE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA6BhD"}
1
+ {"version":3,"file":"uptimeKumaStatus.d.ts","sourceRoot":"","sources":["../../src/tools/uptimeKumaStatus.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAOzE,2EAA2E;AAC3E,eAAO,MAAM,OAAO,QAAiB,CAAC;AAEtC,6EAA6E;AAC7E,wBAAgB,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAEhE;AAWD,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAkChD"}
@@ -1,27 +1,41 @@
1
+ import { z } from "zod";
1
2
  import { execSSH, errorResponse } from "../utils/ssh-api.js";
2
- import { CommandFailedError } from "../utils/errors.js";
3
3
  import { nodeParam } from "../utils/node-param.js";
4
- const DEFAULT_PORT = 3001;
5
- const SERVICE_NAME = "Uptime Kuma";
6
- function getPort() {
7
- const override = process.env.HOMELAB_UPTIME_KUMA_PORT;
8
- return override ? parseInt(override, 10) : DEFAULT_PORT;
4
+ import { SERVICES, servicePort, setting, curlErrorResponse } from "../utils/service-http.js";
5
+ const SERVICE = SERVICES.uptimeKuma;
6
+ /** Uptime Kuma status page slugs: lowercase letters, digits and dashes. */
7
+ export const SLUG_RE = /^[a-z0-9-]+$/;
8
+ /** Slug from the argument, then HOMELAB_UPTIME_KUMA_SLUG, then "default". */
9
+ export function resolveSlug(slug, node) {
10
+ return slug || setting(node, "HOMELAB_UPTIME_KUMA_SLUG", "default");
9
11
  }
12
+ const inputSchema = {
13
+ ...nodeParam,
14
+ slug: z
15
+ .string()
16
+ .regex(SLUG_RE, "Slug may only contain lowercase letters, digits and '-'")
17
+ .optional()
18
+ .describe("Status page slug (default: HOMELAB_UPTIME_KUMA_SLUG or 'default')"),
19
+ };
10
20
  export function register(server) {
11
- server.tool("homelab_uptimeKumaStatus", "Get the status of all Uptime Kuma monitors", { ...nodeParam }, async (args) => {
12
- const port = getPort();
21
+ server.tool("homelab_uptimeKumaStatus", "Get the status of all Uptime Kuma monitors", inputSchema, async (args) => {
22
+ let port = SERVICE.defaultPort;
23
+ let slug = "default";
13
24
  try {
14
- const output = await execSSH(`curl -sf 'http://localhost:${port}/api/status-page/heartbeat/default'`, args.node);
25
+ port = servicePort(SERVICE, args.node);
26
+ slug = resolveSlug(args.slug, args.node);
27
+ if (!SLUG_RE.test(slug)) {
28
+ return errorResponse(new Error(`Invalid Uptime Kuma status page slug "${slug}" (HOMELAB_UPTIME_KUMA_SLUG). ` +
29
+ "Use lowercase letters, digits and '-'."));
30
+ }
31
+ const output = await execSSH(`curl -sf 'http://localhost:${port}/api/status-page/heartbeat/${slug}'`, args.node);
15
32
  return { content: [{ type: "text", text: output }] };
16
33
  }
17
34
  catch (error) {
18
- if (error instanceof CommandFailedError) {
19
- if (error.exitCode === 7) {
20
- return errorResponse(new Error(`Could not connect to ${SERVICE_NAME} on port ${port}. Is it running? ` +
21
- `Set HOMELAB_UPTIME_KUMA_PORT if using a non-default port.`));
22
- }
23
- }
24
- return errorResponse(error);
35
+ return curlErrorResponse(error, SERVICE, port, {
36
+ httpError: `${SERVICE.name} returned an HTTP error for status page "${slug}". Check that the ` +
37
+ "status page exists, or pass `slug` / set HOMELAB_UPTIME_KUMA_SLUG.",
38
+ });
25
39
  }
26
40
  });
27
41
  }
@@ -1 +1 @@
1
- {"version":3,"file":"uptimeKumaStatus.js","sourceRoot":"","sources":["../../src/tools/uptimeKumaStatus.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEnD,MAAM,YAAY,GAAG,IAAI,CAAC;AAC1B,MAAM,YAAY,GAAG,aAAa,CAAC;AAEnC,SAAS,OAAO;IACd,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC;IACtD,OAAO,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,0BAA0B,EAC1B,4CAA4C,EAC5C,EAAE,GAAG,SAAS,EAAE,EAChB,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;QACvB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,8BAA8B,IAAI,qCAAqC,EACvE,IAAI,CAAC,IAAI,CACV,CAAC;YAEF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;QAChE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,kBAAkB,EAAE,CAAC;gBACxC,IAAI,KAAK,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;oBACzB,OAAO,aAAa,CAClB,IAAI,KAAK,CACP,wBAAwB,YAAY,YAAY,IAAI,mBAAmB;wBACrE,2DAA2D,CAC9D,CACF,CAAC;gBACJ,CAAC;YACH,CAAC;YACD,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}
1
+ {"version":3,"file":"uptimeKumaStatus.js","sourceRoot":"","sources":["../../src/tools/uptimeKumaStatus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7F,MAAM,OAAO,GAAG,QAAQ,CAAC,UAAU,CAAC;AAEpC,2EAA2E;AAC3E,MAAM,CAAC,MAAM,OAAO,GAAG,cAAc,CAAC;AAEtC,6EAA6E;AAC7E,MAAM,UAAU,WAAW,CAAC,IAAa,EAAE,IAAa;IACtD,OAAO,IAAI,IAAI,OAAO,CAAC,IAAI,EAAE,0BAA0B,EAAE,SAAS,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,WAAW,GAAG;IAClB,GAAG,SAAS;IACZ,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,KAAK,CAAC,OAAO,EAAE,yDAAyD,CAAC;SACzE,QAAQ,EAAE;SACV,QAAQ,CAAC,mEAAmE,CAAC;CACjF,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,0BAA0B,EAC1B,4CAA4C,EAC5C,WAAW,EACX,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC;QAC/B,IAAI,IAAI,GAAG,SAAS,CAAC;QACrB,IAAI,CAAC;YACH,IAAI,GAAG,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YACvC,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YACzC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACxB,OAAO,aAAa,CAClB,IAAI,KAAK,CACP,yCAAyC,IAAI,gCAAgC;oBAC3E,wCAAwC,CAC3C,CACF,CAAC;YACJ,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,8BAA8B,IAAI,8BAA8B,IAAI,GAAG,EACvE,IAAI,CAAC,IAAI,CACV,CAAC;YAEF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;QAChE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE;gBAC7C,SAAS,EACP,GAAG,OAAO,CAAC,IAAI,4CAA4C,IAAI,oBAAoB;oBACnF,oEAAoE;aACvE,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"volumeBackup.d.ts","sourceRoot":"","sources":["../../src/tools/volumeBackup.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAWzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAyBhD"}
1
+ {"version":3,"file":"volumeBackup.d.ts","sourceRoot":"","sources":["../../src/tools/volumeBackup.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAYzE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA0BhD"}
@@ -1,6 +1,7 @@
1
1
  import { z } from "zod";
2
- import { execSSH, errorResponse } from "../utils/ssh-api.js";
2
+ import { execSSH, errorResponse, TIMEOUTS } from "../utils/ssh-api.js";
3
3
  import { nodeParam } from "../utils/node-param.js";
4
+ import { backupRepo } from "../utils/config.js";
4
5
  import { confirmParam, confirmCancelled } from "../utils/confirm-param.js";
5
6
  const inputSchema = {
6
7
  ...nodeParam,
@@ -13,9 +14,9 @@ export function register(server) {
13
14
  return confirmCancelled("Volume backup");
14
15
  }
15
16
  try {
16
- const repo = process.env.HOMELAB_BACKUP_REPO || "/mnt/backup/restic";
17
+ const repo = backupRepo(args.node);
17
18
  const volumePath = `/var/lib/docker/volumes/${args.volume}/_data`;
18
- const output = await execSSH(`sudo restic -r ${repo} backup '${volumePath}' --tag docker-volume --tag '${args.volume}' 2>&1`, args.node);
19
+ const output = await execSSH(`sudo restic -r ${repo} backup '${volumePath}' --tag docker-volume --tag '${args.volume}' 2>&1`, args.node, { timeoutMs: TIMEOUTS.backup });
19
20
  return { content: [{ type: "text", text: output }] };
20
21
  }
21
22
  catch (error) {
@@ -1 +1 @@
1
- {"version":3,"file":"volumeBackup.js","sourceRoot":"","sources":["../../src/tools/volumeBackup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAE3E,MAAM,WAAW,GAAG;IAClB,GAAG,SAAS;IACZ,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,+BAA+B,CAAC;IACnE,GAAG,YAAY;CAChB,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,sBAAsB,EACtB,2DAA2D,EAC3D,WAAW,EACX,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,OAAO,gBAAgB,CAAC,eAAe,CAAC,CAAC;QAC3C,CAAC;QAED,IAAI,CAAC;YAEH,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,oBAAoB,CAAC;YACrE,MAAM,UAAU,GAAG,2BAA2B,IAAI,CAAC,MAAM,QAAQ,CAAC;YAClE,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,kBAAkB,IAAI,YAAY,UAAU,gCAAgC,IAAI,CAAC,MAAM,QAAQ,EAC/F,IAAI,CAAC,IAAI,CACV,CAAC;YAEF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;QAChE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}
1
+ {"version":3,"file":"volumeBackup.js","sourceRoot":"","sources":["../../src/tools/volumeBackup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAE3E,MAAM,WAAW,GAAG;IAClB,GAAG,SAAS;IACZ,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,+BAA+B,CAAC;IACnE,GAAG,YAAY;CAChB,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,sBAAsB,EACtB,2DAA2D,EAC3D,WAAW,EACX,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,OAAO,gBAAgB,CAAC,eAAe,CAAC,CAAC;QAC3C,CAAC;QAED,IAAI,CAAC;YAEH,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnC,MAAM,UAAU,GAAG,2BAA2B,IAAI,CAAC,MAAM,QAAQ,CAAC;YAClE,MAAM,MAAM,GAAG,MAAM,OAAO,CAC1B,kBAAkB,IAAI,YAAY,UAAU,gCAAgC,IAAI,CAAC,MAAM,QAAQ,EAC/F,IAAI,CAAC,IAAI,EACT,EAAE,SAAS,EAAE,QAAQ,CAAC,MAAM,EAAE,CAC/B,CAAC;YAEF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;QAChE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}
@@ -0,0 +1,27 @@
1
+ /**
2
+ * Shared compose file selection for composeUp, composeDown, composePull and
3
+ * composePs.
4
+ *
5
+ * Resolution order when no `stacks` are passed:
6
+ * 1. HOMELAB_COMPOSE_FILES (comma-separated, used in the given order)
7
+ * 2. Discovery in the compose directory on the node: compose.base.yml first,
8
+ * then the reference stack files in their historical order (monitoring,
9
+ * network, apps, security, storage, tools) when present, then any other
10
+ * compose.*.yml alphabetically. If none exist, the first of compose.yaml,
11
+ * compose.yml, docker-compose.yaml, docker-compose.yml is used.
12
+ */
13
+ export declare const DEFAULT_COMPOSE_DIR = "/opt/homelab/docker";
14
+ /** Reference layout, in the order the files were always passed. */
15
+ export declare const KNOWN_STACK_FILES: readonly ["compose.base.yml", "compose.monitoring.yml", "compose.network.yml", "compose.apps.yml", "compose.security.yml", "compose.storage.yml", "compose.tools.yml"];
16
+ export declare function composeDir(node?: string): string;
17
+ /** Parse HOMELAB_COMPOSE_FILES; returns null when unset or empty. */
18
+ export declare function configuredComposeFiles(node?: string): string[] | null;
19
+ /**
20
+ * Build the full remote command: cd into the compose dir, pick the files,
21
+ * and run `docker compose <files> <action>`.
22
+ *
23
+ * When `stacks` is given, compose.base.yml is passed first followed by each
24
+ * requested file (unchanged behavior).
25
+ */
26
+ export declare function buildComposeCommand(action: string, stacks?: string[], node?: string): string;
27
+ //# sourceMappingURL=compose.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"compose.d.ts","sourceRoot":"","sources":["../../src/utils/compose.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AAEH,eAAO,MAAM,mBAAmB,wBAAwB,CAAC;AAEzD,mEAAmE;AACnE,eAAO,MAAM,iBAAiB,wKAQpB,CAAC;AAYX,wBAAgB,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,qEAAqE;AACrE,wBAAgB,sBAAsB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAgBrE;AAqBD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAgB5F"}
@@ -0,0 +1,92 @@
1
+ import { nodeSetting } from "./ssh-api.js";
2
+ /**
3
+ * Shared compose file selection for composeUp, composeDown, composePull and
4
+ * composePs.
5
+ *
6
+ * Resolution order when no `stacks` are passed:
7
+ * 1. HOMELAB_COMPOSE_FILES (comma-separated, used in the given order)
8
+ * 2. Discovery in the compose directory on the node: compose.base.yml first,
9
+ * then the reference stack files in their historical order (monitoring,
10
+ * network, apps, security, storage, tools) when present, then any other
11
+ * compose.*.yml alphabetically. If none exist, the first of compose.yaml,
12
+ * compose.yml, docker-compose.yaml, docker-compose.yml is used.
13
+ */
14
+ export const DEFAULT_COMPOSE_DIR = "/opt/homelab/docker";
15
+ /** Reference layout, in the order the files were always passed. */
16
+ export const KNOWN_STACK_FILES = [
17
+ "compose.base.yml",
18
+ "compose.monitoring.yml",
19
+ "compose.network.yml",
20
+ "compose.apps.yml",
21
+ "compose.security.yml",
22
+ "compose.storage.yml",
23
+ "compose.tools.yml",
24
+ ];
25
+ const SINGLE_FILE_FALLBACKS = [
26
+ "compose.yaml",
27
+ "compose.yml",
28
+ "docker-compose.yaml",
29
+ "docker-compose.yml",
30
+ ];
31
+ /** Allowed characters for file names configured via HOMELAB_COMPOSE_FILES. */
32
+ const COMPOSE_FILE_RE = /^[A-Za-z0-9._/-]+$/;
33
+ export function composeDir(node) {
34
+ return nodeSetting(node, "HOMELAB_COMPOSE_DIR") || DEFAULT_COMPOSE_DIR;
35
+ }
36
+ /** Parse HOMELAB_COMPOSE_FILES; returns null when unset or empty. */
37
+ export function configuredComposeFiles(node) {
38
+ const raw = nodeSetting(node, "HOMELAB_COMPOSE_FILES");
39
+ if (!raw || !raw.trim())
40
+ return null;
41
+ const files = raw
42
+ .split(",")
43
+ .map((f) => f.trim())
44
+ .filter(Boolean);
45
+ for (const f of files) {
46
+ if (!COMPOSE_FILE_RE.test(f)) {
47
+ throw new Error(`Invalid entry "${f}" in HOMELAB_COMPOSE_FILES. Use file names relative to ` +
48
+ "HOMELAB_COMPOSE_DIR (letters, digits, '.', '_', '-', '/').");
49
+ }
50
+ }
51
+ return files.length > 0 ? files : null;
52
+ }
53
+ /**
54
+ * Shell snippet that sets $files to the discovered "-f <file>" list, or exits
55
+ * non-zero with a clear message when no compose file is found.
56
+ */
57
+ function discoverySnippet(dir) {
58
+ const known = KNOWN_STACK_FILES.join(" ");
59
+ const fallbacks = SINGLE_FILE_FALLBACKS.join(" ");
60
+ return [
61
+ `files=""`,
62
+ `for f in ${known}; do if [ -f "$f" ]; then files="$files -f $f"; fi; done`,
63
+ `for f in compose.*.yml; do case " ${known} " in *" $f "*) continue;; esac; ` +
64
+ `if [ -f "$f" ]; then files="$files -f $f"; fi; done`,
65
+ `if [ -z "$files" ]; then for f in ${fallbacks}; do ` +
66
+ `if [ -f "$f" ]; then files="-f $f"; break; fi; done; fi`,
67
+ `if [ -z "$files" ]; then echo "No compose files found in ${dir}. ` +
68
+ `Set HOMELAB_COMPOSE_FILES or HOMELAB_COMPOSE_DIR." >&2; exit 1; fi`,
69
+ ].join("; ");
70
+ }
71
+ /**
72
+ * Build the full remote command: cd into the compose dir, pick the files,
73
+ * and run `docker compose <files> <action>`.
74
+ *
75
+ * When `stacks` is given, compose.base.yml is passed first followed by each
76
+ * requested file (unchanged behavior).
77
+ */
78
+ export function buildComposeCommand(action, stacks, node) {
79
+ const dir = composeDir(node);
80
+ const cd = `cd ${dir} || exit 1`;
81
+ if (stacks && stacks.length > 0) {
82
+ const files = ["-f compose.base.yml", ...stacks.map((s) => `-f ${s}`)].join(" ");
83
+ return `${cd}; docker compose ${files} ${action}`;
84
+ }
85
+ const configured = configuredComposeFiles(node);
86
+ if (configured) {
87
+ const files = configured.map((f) => `-f ${f}`).join(" ");
88
+ return `${cd}; docker compose ${files} ${action}`;
89
+ }
90
+ return `${cd}; ${discoverySnippet(dir)}; docker compose $files ${action}`;
91
+ }
92
+ //# sourceMappingURL=compose.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"compose.js","sourceRoot":"","sources":["../../src/utils/compose.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C;;;;;;;;;;;GAWG;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG,qBAAqB,CAAC;AAEzD,mEAAmE;AACnE,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,kBAAkB;IAClB,wBAAwB;IACxB,qBAAqB;IACrB,kBAAkB;IAClB,sBAAsB;IACtB,qBAAqB;IACrB,mBAAmB;CACX,CAAC;AAEX,MAAM,qBAAqB,GAAG;IAC5B,cAAc;IACd,aAAa;IACb,qBAAqB;IACrB,oBAAoB;CACrB,CAAC;AAEF,8EAA8E;AAC9E,MAAM,eAAe,GAAG,oBAAoB,CAAC;AAE7C,MAAM,UAAU,UAAU,CAAC,IAAa;IACtC,OAAO,WAAW,CAAC,IAAI,EAAE,qBAAqB,CAAC,IAAI,mBAAmB,CAAC;AACzE,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,sBAAsB,CAAC,IAAa;IAClD,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,EAAE,uBAAuB,CAAC,CAAC;IACvD,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE;QAAE,OAAO,IAAI,CAAC;IACrC,MAAM,KAAK,GAAG,GAAG;SACd,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,OAAO,CAAC,CAAC;IACnB,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CACb,kBAAkB,CAAC,yDAAyD;gBAC1E,4DAA4D,CAC/D,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AACzC,CAAC;AAED;;;GAGG;AACH,SAAS,gBAAgB,CAAC,GAAW;IACnC,MAAM,KAAK,GAAG,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1C,MAAM,SAAS,GAAG,qBAAqB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClD,OAAO;QACL,UAAU;QACV,YAAY,KAAK,0DAA0D;QAC3E,qCAAqC,KAAK,mCAAmC;YAC3E,qDAAqD;QACvD,qCAAqC,SAAS,OAAO;YACnD,yDAAyD;QAC3D,4DAA4D,GAAG,IAAI;YACjE,oEAAoE;KACvE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAc,EAAE,MAAiB,EAAE,IAAa;IAClF,MAAM,GAAG,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAC7B,MAAM,EAAE,GAAG,MAAM,GAAG,YAAY,CAAC;IAEjC,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,MAAM,KAAK,GAAG,CAAC,qBAAqB,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACjF,OAAO,GAAG,EAAE,oBAAoB,KAAK,IAAI,MAAM,EAAE,CAAC;IACpD,CAAC;IAED,MAAM,UAAU,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC;IAChD,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACzD,OAAO,GAAG,EAAE,oBAAoB,KAAK,IAAI,MAAM,EAAE,CAAC;IACpD,CAAC;IAED,OAAO,GAAG,EAAE,KAAK,gBAAgB,CAAC,GAAG,CAAC,2BAA2B,MAAM,EAAE,CAAC;AAC5E,CAAC"}
@@ -0,0 +1,4 @@
1
+ export declare const DEFAULT_BACKUP_REPO = "/mnt/backup/restic";
2
+ /** Restic repository for a node (HOMELAB_BACKUP_REPO, per-node overridable). */
3
+ export declare function backupRepo(node?: string): string;
4
+ //# sourceMappingURL=config.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,mBAAmB,uBAAuB,CAAC;AAExD,gFAAgF;AAChF,wBAAgB,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAEhD"}
@@ -0,0 +1,7 @@
1
+ import { nodeSetting } from "./ssh-api.js";
2
+ export const DEFAULT_BACKUP_REPO = "/mnt/backup/restic";
3
+ /** Restic repository for a node (HOMELAB_BACKUP_REPO, per-node overridable). */
4
+ export function backupRepo(node) {
5
+ return nodeSetting(node, "HOMELAB_BACKUP_REPO") || DEFAULT_BACKUP_REPO;
6
+ }
7
+ //# sourceMappingURL=config.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,MAAM,CAAC,MAAM,mBAAmB,GAAG,oBAAoB,CAAC;AAExD,gFAAgF;AAChF,MAAM,UAAU,UAAU,CAAC,IAAa;IACtC,OAAO,WAAW,CAAC,IAAI,EAAE,qBAAqB,CAAC,IAAI,mBAAmB,CAAC;AACzE,CAAC"}
@@ -6,10 +6,10 @@ export declare class SSHConnectionError extends SSHError {
6
6
  constructor(host: string);
7
7
  }
8
8
  export declare class SSHAuthError extends SSHError {
9
- constructor();
9
+ constructor(message?: string);
10
10
  }
11
11
  export declare class SSHTimeoutError extends SSHError {
12
- constructor(timeoutMs: number);
12
+ constructor(timeoutMs: number, commandStarted?: boolean);
13
13
  }
14
14
  export declare class CommandFailedError extends SSHError {
15
15
  readonly exitCode: number;
@@ -1 +1 @@
1
- {"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,QAAS,SAAQ,KAAK;IACjC,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC;gBAErB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAK9C;AAED,qBAAa,kBAAmB,SAAQ,QAAQ;gBAClC,IAAI,EAAE,MAAM;CAIzB;AAED,qBAAa,YAAa,SAAQ,QAAQ;;CAOzC;AAED,qBAAa,eAAgB,SAAQ,QAAQ;gBAC/B,SAAS,EAAE,MAAM;CAI9B;AAED,qBAAa,kBAAmB,SAAQ,QAAQ;IAC9C,SAAgB,QAAQ,EAAE,MAAM,CAAC;gBAErB,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAK9D;AAED,qBAAa,kBAAmB,SAAQ,QAAQ;gBAClC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAQ7C"}
1
+ {"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,QAAS,SAAQ,KAAK;IACjC,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC;gBAErB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAK9C;AAED,qBAAa,kBAAmB,SAAQ,QAAQ;gBAClC,IAAI,EAAE,MAAM;CAIzB;AAED,qBAAa,YAAa,SAAQ,QAAQ;gBAC5B,OAAO,CAAC,EAAE,MAAM;CAO7B;AAED,qBAAa,eAAgB,SAAQ,QAAQ;gBAC/B,SAAS,EAAE,MAAM,EAAE,cAAc,UAAQ;CAStD;AAED,qBAAa,kBAAmB,SAAQ,QAAQ;IAC9C,SAAgB,QAAQ,EAAE,MAAM,CAAC;gBAErB,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAK9D;AAED,qBAAa,kBAAmB,SAAQ,QAAQ;gBAClC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAQ7C"}
@@ -13,14 +13,18 @@ export class SSHConnectionError extends SSHError {
13
13
  }
14
14
  }
15
15
  export class SSHAuthError extends SSHError {
16
- constructor() {
17
- super("SSH authentication failed. Check your key path (HOMELAB_PI_KEY_PATH) and username (HOMELAB_PI_USER).");
16
+ constructor(message) {
17
+ super(message ??
18
+ "SSH authentication failed. Check your key path (HOMELAB_PI_KEY_PATH) and username (HOMELAB_PI_USER).");
18
19
  this.name = "SSHAuthError";
19
20
  }
20
21
  }
21
22
  export class SSHTimeoutError extends SSHError {
22
- constructor(timeoutMs) {
23
- super(`SSH connection timed out after ${timeoutMs}ms.`);
23
+ constructor(timeoutMs, commandStarted = false) {
24
+ super(commandStarted
25
+ ? `SSH command timed out after ${timeoutMs}ms. The remote command may still be running; ` +
26
+ "check the host before retrying a state-changing operation."
27
+ : `SSH connection timed out after ${timeoutMs}ms.`);
24
28
  this.name = "SSHTimeoutError";
25
29
  }
26
30
  }
@@ -1 +1 @@
1
- {"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,QAAS,SAAQ,KAAK;IACjB,OAAO,CAAU;IAEjC,YAAY,OAAe,EAAE,OAAgB;QAC3C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,QAAQ;IAC9C,YAAY,IAAY;QACtB,KAAK,CAAC,qBAAqB,IAAI,oDAAoD,CAAC,CAAC;QACrF,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,MAAM,OAAO,YAAa,SAAQ,QAAQ;IACxC;QACE,KAAK,CACH,sGAAsG,CACvG,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,QAAQ;IAC3C,YAAY,SAAiB;QAC3B,KAAK,CAAC,kCAAkC,SAAS,KAAK,CAAC,CAAC;QACxD,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,QAAQ;IAC9B,QAAQ,CAAS;IAEjC,YAAY,OAAe,EAAE,QAAgB,EAAE,MAAc;QAC3D,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,4BAA4B,QAAQ,EAAE,EAAE,OAAO,CAAC,CAAC;QACxE,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,QAAQ;IAC9C,YAAY,OAAe,EAAE,OAAe;QAC1C,KAAK,CACH,gEAAgE,OAAO,KAAK;YAC1E,wDAAwD,EAC1D,OAAO,CACR,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF"}
1
+ {"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,QAAS,SAAQ,KAAK;IACjB,OAAO,CAAU;IAEjC,YAAY,OAAe,EAAE,OAAgB;QAC3C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,QAAQ;IAC9C,YAAY,IAAY;QACtB,KAAK,CAAC,qBAAqB,IAAI,oDAAoD,CAAC,CAAC;QACrF,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,MAAM,OAAO,YAAa,SAAQ,QAAQ;IACxC,YAAY,OAAgB;QAC1B,KAAK,CACH,OAAO;YACL,sGAAsG,CACzG,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,QAAQ;IAC3C,YAAY,SAAiB,EAAE,cAAc,GAAG,KAAK;QACnD,KAAK,CACH,cAAc;YACZ,CAAC,CAAC,+BAA+B,SAAS,+CAA+C;gBACrF,4DAA4D;YAChE,CAAC,CAAC,kCAAkC,SAAS,KAAK,CACrD,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,QAAQ;IAC9B,QAAQ,CAAS;IAEjC,YAAY,OAAe,EAAE,QAAgB,EAAE,MAAc;QAC3D,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,4BAA4B,QAAQ,EAAE,EAAE,OAAO,CAAC,CAAC;QACxE,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,QAAQ;IAC9C,YAAY,OAAe,EAAE,OAAe;QAC1C,KAAK,CACH,gEAAgE,OAAO,KAAK;YAC1E,wDAAwD,EAC1D,OAAO,CACR,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF"}
@@ -0,0 +1,13 @@
1
+ /**
2
+ * Map restic failures to an error response. A missing repository gets a
3
+ * pointer to HOMELAB_BACKUP_REPO; every other failure (wrong password,
4
+ * locked repo, sudo refusal) keeps restic's own message.
5
+ */
6
+ export declare function resticErrorResponse(error: unknown, repo: string): {
7
+ content: {
8
+ type: "text";
9
+ text: string;
10
+ }[];
11
+ isError: true;
12
+ };
13
+ //# sourceMappingURL=restic.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"restic.d.ts","sourceRoot":"","sources":["../../src/utils/restic.ts"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM;;;;;;EAW/D"}
@@ -0,0 +1,21 @@
1
+ import { errorResponse } from "./ssh-api.js";
2
+ import { CommandFailedError } from "./errors.js";
3
+ const MISSING_REPO = /does not exist|unable to open config file|Is there a repository at the following location/i;
4
+ /**
5
+ * Map restic failures to an error response. A missing repository gets a
6
+ * pointer to HOMELAB_BACKUP_REPO; every other failure (wrong password,
7
+ * locked repo, sudo refusal) keeps restic's own message.
8
+ */
9
+ export function resticErrorResponse(error, repo) {
10
+ if (error instanceof CommandFailedError && MISSING_REPO.test(error.message)) {
11
+ return {
12
+ content: [{
13
+ type: "text",
14
+ text: `No restic repository found at ${repo}. Check HOMELAB_BACKUP_REPO.\n\n${error.message}`,
15
+ }],
16
+ isError: true,
17
+ };
18
+ }
19
+ return errorResponse(error);
20
+ }
21
+ //# sourceMappingURL=restic.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"restic.js","sourceRoot":"","sources":["../../src/utils/restic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,YAAY,GAAG,4FAA4F,CAAC;AAElH;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAc,EAAE,IAAY;IAC9D,IAAI,KAAK,YAAY,kBAAkB,IAAI,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5E,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,iCAAiC,IAAI,mCAAmC,KAAK,CAAC,OAAO,EAAE;iBAC9F,CAAC;YACF,OAAO,EAAE,IAAa;SACvB,CAAC;IACJ,CAAC;IACD,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC"}