@camstack/server 1.2.708 → 1.2.710

package/CHANGELOG.md

@@ -7,6 +7,19 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.2.710] - 2026-10-31
+
+### Changed
+
+- The schedulers capability is served over the API (list, create, update, delete, enable, preview, conflicts, status, traces)
+
+## [1.2.709] - 2026-10-31
+
+### Changed
+
+- A wedged agent shutdown now ends with a self-SIGKILL so exit-time teardown cannot keep the process alive after an update.
+- getSiteLocation also returns the site's IANA time zone
+
 ## [1.2.708] - 2026-10-31
 
 ### Changed

package/dist/agent/agent-shutdown.js

@@ -1,9 +1,74 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SHUTDOWN_DEADLINE_MS = exports.SHUTDOWN_STEP_TIMEOUT_MS = void 0;
+exports.killSelfHard = killSelfHard;
 exports.createAgentShutdown = createAgentShutdown;
+/**
+ * The agent's graceful shutdown, as a testable sequence.
+ *
+ * A SIGTERM once started a shutdown that awaited one addon's `shutdown()` for 9.5 minutes: the node
+ * stayed alive but deregistered, and its desktop shell never noticed. So the pass is re-entry guarded
+ * (a second signal forces the exit instead of starting a second pass), every step is bounded, the
+ * whole pass has a hard deadline that ends in a non-zero `exit`, and every step logs its elapsed time
+ * next to the reason the shutdown started.
+ */
+const fs = __importStar(require("node:fs"));
 exports.SHUTDOWN_STEP_TIMEOUT_MS = 5_000;
 exports.SHUTDOWN_DEADLINE_MS = 15_000;
+/**
+ * End this process WITHOUT running exit-time teardown. `process.exit` joins the threadpool and tears
+ * down workers and native addons, and on a node that is already wedged that join can itself hang
+ * (observed: a desktop agent alive for minutes after its shutdown deadline). A SIGKILL to ourselves
+ * cannot be waited on. The last line is written synchronously first, because a buffered log write
+ * would be lost.
+ */
+function killSelfHard(finalLine, deps = {}) {
+    const write = deps.write ??
+        ((line) => {
+            fs.writeSync(2, `${line}\n`);
+        });
+    try {
+        write(finalLine);
+    }
+    catch {
+        /* a closed stderr must not stop the kill */
+    }
+    const kill = deps.kill ?? ((pid, signal) => void process.kill(pid, signal));
+    kill(process.pid, 'SIGKILL');
+}
 function errMessage(err) {
     return err instanceof Error ? err.message : String(err);
 }
@@ -28,7 +93,7 @@ function createAgentShutdown(deps) {
     return async (reason) => {
         if (startedAt !== null) {
             logger.error(`shutdown already in progress for ${Date.now() - startedAt}ms; ${reason} forces exit`);
-            deps.exit(1);
+            deps.hardExit(1, `shutdown already in progress; ${reason} forces exit`);
             return;
         }
         const began = Date.now();
@@ -36,7 +101,7 @@ function createAgentShutdown(deps) {
         logger.info(`shutdown started by ${reason}`);
         const deadline = setTimeout(() => {
             logger.error(`shutdown deadline of ${deadlineMs}ms exceeded (started by ${reason}); exiting 1`);
-            deps.exit(1);
+            deps.hardExit(1, `shutdown deadline of ${deadlineMs}ms exceeded (started by ${reason}); SIGKILL`);
         }, deadlineMs);
         for (const step of deps.steps) {
             const stepStart = Date.now();

package/dist/agent/agent-update-service.js

@@ -73,6 +73,7 @@ const update_availability_store_js_1 = require("../core/update-availability-stor
 const index_js_1 = require("../server-root/index.js");
 const node_update_announcement_js_1 = require("../core/updates/node-update-announcement.js");
 const restart_marker_js_1 = require("../core/updates/restart-marker.js");
+const agent_shutdown_js_1 = require("./agent-shutdown.js");
 /**
  * The synthetic addonId the agent's OWN runtime registers infra providers
  * under (no addon owns them — the bootstrap does). Appears in the agent's
@@ -145,7 +146,7 @@ function scheduleAgentRestart(logger, requestedBy, dataDir) {
     });
     const grace = setTimeout(() => {
         process.kill(process.pid, 'SIGTERM');
-        const hard = setTimeout(() => process.exit(0), 15_000);
+        const hard = setTimeout(() => (0, agent_shutdown_js_1.killSelfHard)('agent restart: shutdown did not finish in 15000ms; SIGKILL'), 15_000);
         hard.unref();
     }, exports.AGENT_RESTART_GRACE_MS);
     grace.unref();

package/dist/agent/main.js

@@ -1076,6 +1076,7 @@ async function startAgent(configPath) {
     const shutdown = (0, agent_shutdown_js_1.createAgentShutdown)({
         logger: consoleLogger,
         exit: (code) => process.exit(code),
+        hardExit: (_code, finalLine) => (0, agent_shutdown_js_1.killSelfHard)(finalLine),
         steps: [
             {
                 name: 'abort-registration',

package/dist/api/core/site-location.js

@@ -48,6 +48,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SiteLocationService = exports.GEO_IP_ENDPOINTS = exports.GEO_IP_TIMEOUT_MS = exports.SITE_LOCATION_KEY = void 0;
 exports.isUsableCoordinate = isUsableCoordinate;
+exports.hubTimeZone = hubTimeZone;
 exports.toStatus = toStatus;
 exports.parseGeoIpPayload = parseGeoIpPayload;
 exports.geolocatePublicIp = geolocatePublicIp;
@@ -98,10 +99,15 @@ function isUsableCoordinate(lat, lng) {
         return false;
     return lat !== 0 || lng !== 0;
 }
+/** The hub's own IANA zone, `UTC` when the runtime cannot name one. */
+function hubTimeZone() {
+    const zone = Intl.DateTimeFormat().resolvedOptions().timeZone;
+    return typeof zone === 'string' && zone.length > 0 ? zone : 'UTC';
+}
 /** Project a stored row onto the wire shape. */
-function toStatus(record) {
+function toStatus(record, timeZone = hubTimeZone()) {
     if (record === null) {
-        return { location: null, derivationAttemptedAt: null, derivationError: null };
+        return { location: null, timeZone, derivationAttemptedAt: null, derivationError: null };
     }
     const attempted = typeof record.derivationAttemptedAt === 'number';
     const status = {
@@ -117,6 +123,7 @@ function toStatus(record) {
                 ...(record.label !== undefined ? { label: record.label } : {}),
             }
             : null,
+        timeZone,
         derivationAttemptedAt: attempted ? Number(record.derivationAttemptedAt) : null,
         derivationError: typeof record.derivationError === 'string' ? record.derivationError : null,
     };

package/dist/api/trpc/generated-cap-mounts.js

@@ -2,7 +2,7 @@
 // AUTO-GENERATED by scripts/generate-cap-mounts.ts — DO NOT EDIT
 // Re-run: npx tsx scripts/generate-cap-mounts.ts
 //
-// Mounted: 190    Skipped (legacy): 3
+// Mounted: 191    Skipped (legacy): 3
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.LEGACY_SHAPE_SKIP = void 0;
 exports.mountAllCaps = mountAllCaps;
@@ -549,6 +549,7 @@ function mountAllCaps(services) {
         }, remoteCapProxy),
         runningState: (0, generated_cap_routers_js_1.createCapRouter_runningState)((_ctx) => (0, cap_mount_helpers_js_1.requireDeviceScoped)(reg, 'running-state'), remoteCapProxy),
         sceneMonitor: (0, generated_cap_routers_js_1.createCapRouter_sceneMonitor)((_ctx) => (0, cap_mount_helpers_js_1.requireDeviceScoped)(reg, 'scene-monitor'), remoteCapProxy),
+        schedulers: (0, generated_cap_routers_js_1.createCapRouter_schedulers)((_ctx) => reg?.getSingleton('schedulers') ?? null, remoteCapProxy),
         scriptRunner: (0, generated_cap_routers_js_1.createCapRouter_scriptRunner)((_ctx) => (0, cap_mount_helpers_js_1.requireDeviceScoped)(reg, 'script-runner'), remoteCapProxy),
         serverManagement: (0, generated_cap_routers_js_1.createCapRouter_serverManagement)((_ctx) => reg?.getSingleton('server-management') ??
             null, remoteCapProxy),