@sfmc-bds/cli 0.1.0 → 0.2.0-beta.0

package/dist/registry.js

@@ -1,125 +1,92 @@
-/**
- * registry.ts — first-party sfmc-modules index resolution, shared between
- * the module CLI and the startup unknown-source warning.
- *
- * Talks to https://raw.githubusercontent.com/Tanya7z/sfmc-modules/main/index.json
- * (the registry lives in a separate repo to keep this one free of "what
- * modules exist" governance). Caches to <sfmc/src/.sfmc-registry-cache.json>
- * with a 1h TTL so a brief network blip doesn't degrade the CLI.
- *
- * Both helpers are best-effort: failures are surfaced as `null` and a
- * console warning, never an exception, because the SEA must still boot
- * when the registry is unreachable.
- */
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import path from "node:path";
 import process from "node:process";
 import { fileURLToPath } from "node:url";
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const CACHE_PATH = path.join(__dirname, ".sfmc-registry-cache.json");
-const TTL_MS = 60 * 60 * 1000;
+const TTL_MS = 60 * 60 * 1e3;
 const DEFAULT_REGISTRY_REPO = "Tanya7z/sfmc-modules";
 const DEFAULT_REGISTRY_TAG = "main";
 const INDEX_URL = `https://raw.githubusercontent.com/${DEFAULT_REGISTRY_REPO}/${DEFAULT_REGISTRY_TAG}/index.json`;
 function readCache() {
-    try {
-        if (!existsSync(CACHE_PATH))
-            return null;
-        return JSON.parse(readFileSync(CACHE_PATH, "utf8"));
-    }
-    catch {
-        return null;
-    }
+  try {
+    if (!existsSync(CACHE_PATH)) return null;
+    return JSON.parse(readFileSync(CACHE_PATH, "utf8"));
+  } catch {
+    return null;
+  }
 }
 function writeCache(cache) {
-    try {
-        mkdirSync(path.dirname(CACHE_PATH), { recursive: true });
-        writeFileSync(CACHE_PATH, JSON.stringify(cache, null, 2));
-    }
-    catch {
-        /* cache write is best-effort */
-    }
+  try {
+    mkdirSync(path.dirname(CACHE_PATH), { recursive: true });
+    writeFileSync(CACHE_PATH, JSON.stringify(cache, null, 2));
+  } catch {
+  }
 }
-/**
- * 解析 first-party index.json。
- * 契约与 tools/lib/registry-index.mjs#parseRegistryIndex 保持一致：
- * `{ modules: { <folder>: { repo, tag } } }`。忽略 `_` 前缀元数据键。
- */
-export function parseRegistryIndex(json) {
-    if (typeof json !== "object" || json === null || Array.isArray(json)) {
-        throw new Error("registry index must be a JSON object with a 'modules' field");
-    }
-    const root = json;
-    const modulesRaw = root.modules;
-    if (typeof modulesRaw !== "object" || modulesRaw === null || Array.isArray(modulesRaw)) {
-        throw new Error("registry index must have a 'modules' object mapping id → { repo, tag }");
-    }
-    const filtered = {};
-    for (const [k, v] of Object.entries(modulesRaw)) {
-        if (k.startsWith("_"))
-            continue;
-        if (typeof v !== "object" || v === null || Array.isArray(v))
-            continue;
-        const entry = v;
-        if (typeof entry.repo !== "string" || typeof entry.tag !== "string")
-            continue;
-        filtered[k] = { repo: entry.repo, tag: entry.tag };
-    }
-    return filtered;
+function parseRegistryIndex(json) {
+  if (typeof json !== "object" || json === null || Array.isArray(json)) {
+    throw new Error("registry index must be a JSON object with a 'modules' field");
+  }
+  const root = json;
+  const modulesRaw = root.modules;
+  if (typeof modulesRaw !== "object" || modulesRaw === null || Array.isArray(modulesRaw)) {
+    throw new Error("registry index must have a 'modules' object mapping id \u2192 { repo, tag }");
+  }
+  const filtered = {};
+  for (const [k, v] of Object.entries(modulesRaw)) {
+    if (k.startsWith("_")) continue;
+    if (typeof v !== "object" || v === null || Array.isArray(v)) continue;
+    const entry = v;
+    if (typeof entry.repo !== "string" || typeof entry.tag !== "string") continue;
+    filtered[k] = { repo: entry.repo, tag: entry.tag };
+  }
+  return filtered;
 }
 async function fetchFresh() {
-    const res = await fetch(INDEX_URL, { headers: { "User-Agent": "sfmc-cli" } });
-    if (!res.ok)
-        throw new Error(`HTTP ${res.status} for ${INDEX_URL}`);
-    return parseRegistryIndex(await res.json());
+  const res = await fetch(INDEX_URL, { headers: { "User-Agent": "sfmc-cli" } });
+  if (!res.ok) throw new Error(`HTTP ${res.status} for ${INDEX_URL}`);
+  return parseRegistryIndex(await res.json());
 }
-/**
- * Resolve the first-party index.
- *
- * Order:
- *   1. If the cache is fresh (< TTL): return it without trying the network.
- *   2. Otherwise attempt a live fetch.
- *      - success → write cache, return fresh.
- *      - failure + cache exists → return cache with `stale: true` and a warning.
- *      - failure + no cache → return `{ index: {}, stale: true }` and warn.
- *
- * Never throws: the unknown-source warning is best-effort.
- */
-export async function resolveRegistryIndex() {
-    const cache = readCache();
-    if (cache && Date.now() - cache.fetchedAt < TTL_MS) {
-        return { index: cache.index, stale: false };
-    }
-    try {
-        const fresh = await fetchFresh();
-        writeCache({ fetchedAt: Date.now(), index: fresh });
-        return { index: fresh, stale: false };
-    }
-    catch (err) {
-        if (cache) {
-            const msg = err instanceof Error ? err.message : String(err);
-            process.stderr.write(`[sfmc] registry offline (${msg}); using cached index from ${new Date(cache.fetchedAt).toISOString()}\n`);
-            return { index: cache.index, stale: true };
-        }
-        const msg = err instanceof Error ? err.message : String(err);
-        process.stderr.write(`[sfmc] registry unreachable and no cache: ${msg}\n`);
-        return { index: {}, stale: true };
+async function resolveRegistryIndex(opts) {
+  const cache = readCache();
+  if (!opts?.force && cache && Date.now() - cache.fetchedAt < TTL_MS) {
+    return { index: cache.index, stale: false };
+  }
+  try {
+    const fresh = await fetchFresh();
+    writeCache({ fetchedAt: Date.now(), index: fresh });
+    return { index: fresh, stale: false };
+  } catch (err) {
+    if (cache) {
+      const msg2 = err instanceof Error ? err.message : String(err);
+      process.stderr.write(`[sfmc] registry offline (${msg2}); using cached index from ${new Date(cache.fetchedAt).toISOString()}
+`);
+      return { index: cache.index, stale: true };
     }
+    const msg = err instanceof Error ? err.message : String(err);
+    process.stderr.write(`[sfmc] registry unreachable and no cache: ${msg}
+`);
+    return { index: {}, stale: true };
+  }
 }
-/**
- * Compare a set of installed module ids to the registry and return the
- * subset that isn't published in the first-party index. The "best-effort"
- * guarantee: this returns an empty array when the registry can't be reached
- * (we don't want a network outage to mark every local module as unknown).
- */
-export async function findUnknownModules(installedIds) {
-    const { index, stale } = await resolveRegistryIndex();
-    if (stale && Object.keys(index).length === 0) {
-        /* No cache either — silently treat every module as "we couldn't tell".
-         * Otherwise an offline SEA would scream warnings at every boot. */
-        return [];
-    }
-    return installedIds.filter((id) => !index[id]);
+function listRegistryModuleIdsSync() {
+  const cache = readCache();
+  if (!cache) return [];
+  return Object.keys(cache.index).sort((a, b) => a.localeCompare(b));
+}
+async function findUnknownModules(installedIds) {
+  const { index, stale } = await resolveRegistryIndex();
+  if (stale && Object.keys(index).length === 0) {
+    return [];
+  }
+  return installedIds.filter((id) => !index[id]);
 }
-export { DEFAULT_REGISTRY_REPO, DEFAULT_REGISTRY_TAG };
-//# sourceMappingURL=registry.js.map
+export {
+  DEFAULT_REGISTRY_REPO,
+  DEFAULT_REGISTRY_TAG,
+  findUnknownModules,
+  listRegistryModuleIdsSync,
+  parseRegistryIndex,
+  resolveRegistryIndex
+};
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -1 +1,7 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"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"}
+{
+  "version": 3,
+  "sources": ["../src/registry.ts"],
+  "sourcesContent": ["/**\n * registry.ts \u2014 first-party sfmc-modules index resolution, shared between\n * the module CLI and the startup unknown-source warning.\n *\n * Talks to https://raw.githubusercontent.com/Tanya7z/sfmc-modules/main/index.json\n * (the registry lives in a separate repo to keep this one free of \"what\n * modules exist\" governance). Caches to <sfmc/src/.sfmc-registry-cache.json>\n * with a 1h TTL so a brief network blip doesn't degrade the CLI.\n *\n * Both helpers are best-effort: failures are surfaced as `null` and a\n * console warning, never an exception, because the CLI must still boot\n * when the registry is unreachable.\n */\n\nimport { existsSync, mkdirSync, readFileSync, writeFileSync } from \"node:fs\";\nimport path from \"node:path\";\nimport process from \"node:process\";\nimport { fileURLToPath } from \"node:url\";\n\nconst __dirname = path.dirname(fileURLToPath(import.meta.url));\nconst CACHE_PATH = path.join(__dirname, \".sfmc-registry-cache.json\");\nconst TTL_MS = 60 * 60 * 1000;\n\nconst DEFAULT_REGISTRY_REPO = \"Tanya7z/sfmc-modules\";\nconst DEFAULT_REGISTRY_TAG = \"main\";\nconst INDEX_URL = `https://raw.githubusercontent.com/${DEFAULT_REGISTRY_REPO}/${DEFAULT_REGISTRY_TAG}/index.json`;\n\nexport interface RegistryEntry {\n  repo: string;\n  tag: string;\n}\nexport type RegistryIndex = Record<string, RegistryEntry>;\n\ninterface RegistryCache {\n  fetchedAt: number;\n  index: RegistryIndex;\n}\n\nfunction readCache(): RegistryCache | null {\n  try {\n    if (!existsSync(CACHE_PATH)) return null;\n    return JSON.parse(readFileSync(CACHE_PATH, \"utf8\")) as RegistryCache;\n  } catch {\n    return null;\n  }\n}\n\nfunction writeCache(cache: RegistryCache): void {\n  try {\n    mkdirSync(path.dirname(CACHE_PATH), { recursive: true });\n    writeFileSync(CACHE_PATH, JSON.stringify(cache, null, 2));\n  } catch {\n    /* cache write is best-effort */\n  }\n}\n\n/**\n * \u89E3\u6790 first-party index.json\u3002\n * \u5951\u7EA6\u4E0E tools/lib/registry-index.mjs#parseRegistryIndex \u4FDD\u6301\u4E00\u81F4\uFF1A\n * `{ modules: { <folder>: { repo, tag } } }`\u3002\u5FFD\u7565 `_` \u524D\u7F00\u5143\u6570\u636E\u952E\u3002\n */\nexport function parseRegistryIndex(json: unknown): RegistryIndex {\n  if (typeof json !== \"object\" || json === null || Array.isArray(json)) {\n    throw new Error(\"registry index must be a JSON object with a 'modules' field\");\n  }\n  const root = json as Record<string, unknown>;\n  const modulesRaw = root.modules;\n  if (typeof modulesRaw !== \"object\" || modulesRaw === null || Array.isArray(modulesRaw)) {\n    throw new Error(\"registry index must have a 'modules' object mapping id \u2192 { repo, tag }\");\n  }\n  const filtered: RegistryIndex = {};\n  for (const [k, v] of Object.entries(modulesRaw as Record<string, unknown>)) {\n    if (k.startsWith(\"_\")) continue;\n    if (typeof v !== \"object\" || v === null || Array.isArray(v)) continue;\n    const entry = v as Record<string, unknown>;\n    if (typeof entry.repo !== \"string\" || typeof entry.tag !== \"string\") continue;\n    filtered[k] = { repo: entry.repo, tag: entry.tag };\n  }\n  return filtered;\n}\n\nasync function fetchFresh(): Promise<RegistryIndex> {\n  const res = await fetch(INDEX_URL, { headers: { \"User-Agent\": \"sfmc-cli\" } });\n  if (!res.ok) throw new Error(`HTTP ${res.status} for ${INDEX_URL}`);\n  return parseRegistryIndex(await res.json());\n}\n\nexport interface RegistryResult {\n  index: RegistryIndex;\n  /** True when the index came from a stale cache because the live fetch failed. */\n  stale: boolean;\n}\n\n/**\n * Resolve the first-party index.\n *\n * Order (default):\n *   1. If the cache is fresh (< TTL): return it without trying the network.\n *   2. Otherwise attempt a live fetch.\n *      - success \u2192 write cache, return fresh.\n *      - failure + cache exists \u2192 return cache with `stale: true` and a warning.\n *      - failure + no cache \u2192 return `{ index: {}, stale: true }` and warn.\n *\n * `force: true` \u8DF3\u8FC7 TTL \u65E9\u9000,\u59CB\u7EC8\u5C1D\u8BD5\u62C9\u7F51(\u4F9B `mod search` \u4E3B\u52A8\u5237\u65B0\u5217\u8868)\u3002\n * \u5931\u8D25\u65F6\u4ECD\u56DE\u9000\u5230\u7F13\u5B58,\u6C38\u4E0D\u629B\u5F02\u5E38\u3002\n */\nexport async function resolveRegistryIndex(opts?: { force?: boolean }): Promise<RegistryResult> {\n  const cache = readCache();\n  if (!opts?.force && cache && Date.now() - cache.fetchedAt < TTL_MS) {\n    return { index: cache.index, stale: false };\n  }\n  try {\n    const fresh = await fetchFresh();\n    writeCache({ fetchedAt: Date.now(), index: fresh });\n    return { index: fresh, stale: false };\n  } catch (err) {\n    if (cache) {\n      const msg = err instanceof Error ? err.message : String(err);\n      process.stderr.write(`[sfmc] registry offline (${msg}); using cached index from ${new Date(cache.fetchedAt).toISOString()}\\n`);\n      return { index: cache.index, stale: true };\n    }\n    const msg = err instanceof Error ? err.message : String(err);\n    process.stderr.write(`[sfmc] registry unreachable and no cache: ${msg}\\n`);\n    return { index: {}, stale: true };\n  }\n}\n\n/**\n * \u4ECE\u672C\u5730\u7F13\u5B58\u540C\u6B65\u8BFB\u51FA registry \u6A21\u5757 id(\u4F9B Tab \u8865\u5168)\u3002\n * \u65E0\u7F13\u5B58\u65F6\u8FD4\u56DE\u7A7A\u6570\u7EC4,\u4E0D\u89E6\u53D1\u7F51\u7EDC\u3002\n */\nexport function listRegistryModuleIdsSync(): string[] {\n  const cache = readCache();\n  if (!cache) return [];\n  return Object.keys(cache.index).sort((a, b) => a.localeCompare(b));\n}\n\n/**\n * Compare a set of installed module ids to the registry and return the\n * subset that isn't published in the first-party index. The \"best-effort\"\n * guarantee: this returns an empty array when the registry can't be reached\n * (we don't want a network outage to mark every local module as unknown).\n */\nexport async function findUnknownModules(installedIds: string[]): Promise<string[]> {\n  const { index, stale } = await resolveRegistryIndex();\n  if (stale && Object.keys(index).length === 0) {\n    /* No cache either \u2014 silently treat every module as \"we couldn't tell\".\n     * Otherwise offline mode would scream warnings at every boot. */\n    return [];\n  }\n  return installedIds.filter((id) => !index[id]);\n}\n\nexport { DEFAULT_REGISTRY_REPO, DEFAULT_REGISTRY_TAG };"],
+  "mappings": "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",
+  "names": ["msg"]
+}

package/dist/remote-agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"remote-agent.d.ts","sourceRoot":"","sources":["../src/remote-agent.ts"],"names":[],"mappings":"AAcA,KAAK,YAAY,GAAG;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAwFF,0EAA0E;AAC1E,wBAAgB,eAAe,IAAI,IAAI,CAetC;AAED,wFAAwF;AACxF,wBAAgB,gBAAgB,IAAI,IAAI,CAgEvC;AAED,wBAAsB,iBAAiB,CAAC,aAAa,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAWrH;AAED,6EAA6E;AAC7E,wBAAgB,kBAAkB,IAAI,IAAI,CAOzC;AAED,wBAAgB,YAAY,IAAI,YAAY,CAW3C"}
+{"version":3,"file":"remote-agent.d.ts","sourceRoot":"","sources":["../src/remote-agent.ts"],"names":[],"mappings":"AAqBA,KAAK,YAAY,GAAG;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AA6FF,0EAA0E;AAC1E,wBAAgB,eAAe,IAAI,IAAI,CAetC;AAED,wFAAwF;AACxF,wBAAgB,gBAAgB,IAAI,IAAI,CAgEvC;AAED,wBAAsB,iBAAiB,CAAC,aAAa,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAWrH;AAED,6EAA6E;AAC7E,wBAAgB,kBAAkB,IAAI,IAAI,CAOzC;AAED,wBAAgB,YAAY,IAAI,YAAY,CAW3C"}

package/dist/remote-agent.js

@@ -1,212 +1,196 @@
 import { WebSocket } from "ws";
-import { configPath, ensureJson, writeJson } from "@sfmc-bds/sdk/node/config";
+import {
+  configPath,
+  DEFAULT_REMOTE_CONFIG,
+  loadEnsuredConfig,
+  writeJson,
+  withConfigSchema
+} from "@sfmc-bds/sdk/node/config";
 import { cmdRestart, cmdSend, cmdStart, cmdStop } from "./commands.js";
 import { ROOT } from "./runtime.js";
 import { SERVICE_NAMES, serviceStatus } from "./services.js";
 let socket = null;
 let retryTimer = null;
-let retryDelay = 1000;
+let retryDelay = 1e3;
 let heartbeatTimer = null;
 let lastError = "";
 let warnedMissingConfig = false;
 let stopping = false;
-const HEARTBEAT_INTERVAL_MS = 20_000;
-/** 启动时确保 remote.json 存在,返回现有或空配置。 */
+const HEARTBEAT_INTERVAL_MS = 2e4;
 function loadConfig() {
-    return ensureJson(configPath(ROOT, "remote.json"), {});
+  return loadEnsuredConfig(
+    ROOT,
+    "remote.json",
+    "remote",
+    { ...DEFAULT_REMOTE_CONFIG }
+  );
 }
 function writeConfig(config) {
-    writeJson(configPath(ROOT, "remote.json"), config);
+  writeJson(configPath(ROOT, "remote.json"), withConfigSchema({ ...config }, "remote"));
 }
 function isService(value) {
-    return !!value && SERVICE_NAMES.includes(value);
+  return !!value && SERVICE_NAMES.includes(value);
 }
 function isAction(value) {
-    return value === "status" || value === "start" || value === "stop" || value === "restart" || value === "send";
+  return value === "status" || value === "start" || value === "stop" || value === "restart" || value === "send";
 }
 function websocketUrl(controllerUrl, agentId) {
-    const url = new URL(controllerUrl);
-    url.protocol = url.protocol === "https:" ? "wss:" : "ws:";
-    url.pathname = "/v1/agent";
-    url.search = new URLSearchParams({ id: agentId }).toString();
-    return url.toString();
+  const url = new URL(controllerUrl);
+  url.protocol = url.protocol === "https:" ? "wss:" : "ws:";
+  url.pathname = "/v1/agent";
+  url.search = new URLSearchParams({ id: agentId }).toString();
+  return url.toString();
 }
 function send(payload) {
-    if (socket?.readyState === WebSocket.OPEN)
-        socket.send(JSON.stringify(payload));
+  if (socket?.readyState === WebSocket.OPEN) socket.send(JSON.stringify(payload));
 }
 function startHeartbeat() {
-    stopHeartbeat();
-    heartbeatTimer = setInterval(() => send({ type: "ping" }), HEARTBEAT_INTERVAL_MS);
+  stopHeartbeat();
+  heartbeatTimer = setInterval(() => send({ type: "ping" }), HEARTBEAT_INTERVAL_MS);
 }
 function stopHeartbeat() {
-    if (heartbeatTimer) {
-        clearInterval(heartbeatTimer);
-        heartbeatTimer = null;
-    }
+  if (heartbeatTimer) {
+    clearInterval(heartbeatTimer);
+    heartbeatTimer = null;
+  }
 }
 async function execute(task) {
-    if (!isAction(task.action))
-        throw new Error("invalid task action");
-    if (task.action === "status")
-        return { services: serviceStatus() };
-    if (!isService(task.service))
-        throw new Error("service is required and must be one of: " + SERVICE_NAMES.join(", "));
-    if (task.action === "send") {
-        if (!task.message)
-            throw new Error("message is required for send action");
-        return { output: await cmdSend(task.service, task.message), services: serviceStatus() };
-    }
-    const output = task.action === "start"
-        ? await cmdStart(task.service)
-        : task.action === "stop"
-            ? await cmdStop(task.service)
-            : await cmdRestart(task.service);
-    return { output, services: serviceStatus() };
+  if (!isAction(task.action)) throw new Error("invalid task action");
+  if (task.action === "status") return { services: serviceStatus() };
+  if (!isService(task.service)) throw new Error("service is required and must be one of: " + SERVICE_NAMES.join(", "));
+  if (task.action === "send") {
+    if (!task.message) throw new Error("message is required for send action");
+    return { output: await cmdSend(task.service, task.message), services: serviceStatus() };
+  }
+  const output = task.action === "start" ? await cmdStart(task.service) : task.action === "stop" ? await cmdStop(task.service) : await cmdRestart(task.service);
+  return { output, services: serviceStatus() };
 }
 function scheduleReconnect() {
-    if (retryTimer || stopping)
-        return;
-    const delay = retryDelay;
-    retryTimer = setTimeout(() => {
-        retryTimer = null;
-        startRemoteAgent();
-    }, delay);
+  if (retryTimer || stopping) return;
+  const delay = retryDelay;
+  retryTimer = setTimeout(() => {
+    retryTimer = null;
+    startRemoteAgent();
+  }, delay);
 }
 function resetReconnect(reason) {
-    retryDelay = 1000;
-    if (reason) {
-        lastError = reason;
-        console.warn(`[remote-agent] ${reason} — will retry in ${retryDelay}ms`);
-    }
-}
-/** Close the active socket (if any) and stop reconnecting. Idempotent. */
-export function stopRemoteAgent() {
-    stopping = true;
-    stopHeartbeat();
-    if (retryTimer) {
-        clearTimeout(retryTimer);
-        retryTimer = null;
-    }
-    if (socket) {
-        try {
-            socket.close(1000, "client_shutdown");
-        }
-        catch {
-            /* ignore */
-        }
-        socket = null;
-    }
-}
-/** Start one outbound-only remote-management connection for this supervisor process. */
-export function startRemoteAgent() {
-    if (stopping)
-        return;
-    if (socket || retryTimer)
-        return;
-    const config = loadConfig();
-    if (!config.enabled || !config.controller_url || !config.agent_id || !config.agent_secret) {
-        if (!warnedMissingConfig) {
-            const missing = [];
-            if (!config.enabled)
-                missing.push("enabled");
-            if (!config.controller_url)
-                missing.push("controller_url");
-            if (!config.agent_id)
-                missing.push("agent_id");
-            if (!config.agent_secret)
-                missing.push("agent_secret");
-            if (missing.length) {
-                console.warn(`[remote-agent] disabled — missing remote.json fields: ${missing.join(", ")} (run \`sfmc remote enroll\`)`);
-            }
-            warnedMissingConfig = true;
-        }
-        return;
-    }
-    warnedMissingConfig = true;
-    let ws;
+  retryDelay = 1e3;
+  if (reason) {
+    lastError = reason;
+    console.warn(`[remote-agent] ${reason} \u2014 will retry in ${retryDelay}ms`);
+  }
+}
+function stopRemoteAgent() {
+  stopping = true;
+  stopHeartbeat();
+  if (retryTimer) {
+    clearTimeout(retryTimer);
+    retryTimer = null;
+  }
+  if (socket) {
     try {
-        ws = new WebSocket(websocketUrl(config.controller_url, config.agent_id));
+      socket.close(1e3, "client_shutdown");
+    } catch {
     }
-    catch (e) {
-        resetReconnect(`failed to construct websocket: ${e.message}`);
-        scheduleReconnect();
-        return;
+    socket = null;
+  }
+}
+function startRemoteAgent() {
+  if (stopping) return;
+  if (socket || retryTimer) return;
+  const config = loadConfig();
+  if (!config.enabled || !config.controller_url || !config.agent_id || !config.agent_secret) {
+    if (!warnedMissingConfig) {
+      const missing = [];
+      if (!config.enabled) missing.push("enabled");
+      if (!config.controller_url) missing.push("controller_url");
+      if (!config.agent_id) missing.push("agent_id");
+      if (!config.agent_secret) missing.push("agent_secret");
+      if (missing.length) {
+        console.warn(`[remote-agent] disabled \u2014 missing remote.json fields: ${missing.join(", ")} (run \`sfmc remote enroll\`)`);
+      }
+      warnedMissingConfig = true;
     }
-    socket = ws;
-    ws.on("open", () => {
-        retryDelay = 1000;
-        lastError = "";
-        send({ type: "hello", agentId: config.agent_id, secret: config.agent_secret, status: serviceStatus() });
-        startHeartbeat();
-    });
-    ws.on("message", (raw) => {
-        let msg;
-        try {
-            msg = JSON.parse(raw.toString());
-        }
-        catch {
-            return;
-        }
-        if (msg.type === "ping") {
-            send({ type: "pong" });
-            return;
-        }
-        if (msg.type !== "task")
-            return;
-        const task = msg;
-        void execute(task)
-            .then((result) => send({ type: "task_result", taskId: task.taskId, ok: true, result }))
-            .catch((error) => send({ type: "task_result", taskId: task.taskId, ok: false, error: error.message }));
-    });
-    ws.on("close", (code, reason) => {
-        if (socket === ws)
-            socket = null;
-        stopHeartbeat();
-        if (stopping)
-            return;
-        resetReconnect(`disconnected (code=${code} ${reason.toString() || "no_reason"})`);
-        scheduleReconnect();
-    });
-    ws.on("error", (e) => {
-        resetReconnect(`socket error: ${e.message}`);
-        /* close event will follow and trigger reconnect */
-    });
-}
-export async function enrollRemoteAgent(controllerUrl, enrollmentToken, name) {
-    const response = await fetch(new URL("/v1/enroll", controllerUrl), {
-        method: "POST",
-        headers: { "content-type": "application/json", authorization: `Bearer ${enrollmentToken}` },
-        body: JSON.stringify({ name }),
-    });
-    const result = (await response.json());
-    if (!response.ok || !result.agentId || !result.agentSecret)
-        throw new Error(result.error ?? "enrollment failed");
-    writeConfig({ enabled: true, controller_url: controllerUrl, agent_id: result.agentId, agent_secret: result.agentSecret });
-    return result.agentId;
-}
-/** Disable the remote agent: clear enabled flag and close the connection. */
-export function disableRemoteAgent() {
-    const config = loadConfig();
-    if (config.agent_id || config.agent_secret) {
-        writeConfig({ ...config, enabled: false });
+    return;
+  }
+  warnedMissingConfig = true;
+  let ws;
+  try {
+    ws = new WebSocket(websocketUrl(config.controller_url, config.agent_id));
+  } catch (e) {
+    resetReconnect(`failed to construct websocket: ${e.message}`);
+    scheduleReconnect();
+    return;
+  }
+  socket = ws;
+  ws.on("open", () => {
+    retryDelay = 1e3;
+    lastError = "";
+    send({ type: "hello", agentId: config.agent_id, secret: config.agent_secret, status: serviceStatus() });
+    startHeartbeat();
+  });
+  ws.on("message", (raw) => {
+    let msg;
+    try {
+      msg = JSON.parse(raw.toString());
+    } catch {
+      return;
     }
-    stopRemoteAgent();
-    stopping = false;
-}
-export function remoteStatus() {
-    const config = loadConfig();
-    const result = { connected: socket?.readyState === WebSocket.OPEN };
-    if (config.enabled !== undefined)
-        result.enabled = config.enabled;
-    if (config.controller_url)
-        result.controller_url = config.controller_url;
-    if (config.agent_id)
-        result.agent_id = config.agent_id;
-    if (lastError) {
-        result.last_error = lastError;
-        result.retry_in_ms = retryDelay;
+    if (msg.type === "ping") {
+      send({ type: "pong" });
+      return;
     }
-    return result;
-}
-//# sourceMappingURL=remote-agent.js.map
+    if (msg.type !== "task") return;
+    const task = msg;
+    void execute(task).then((result) => send({ type: "task_result", taskId: task.taskId, ok: true, result })).catch((error) => send({ type: "task_result", taskId: task.taskId, ok: false, error: error.message }));
+  });
+  ws.on("close", (code, reason) => {
+    if (socket === ws) socket = null;
+    stopHeartbeat();
+    if (stopping) return;
+    resetReconnect(`disconnected (code=${code} ${reason.toString() || "no_reason"})`);
+    scheduleReconnect();
+  });
+  ws.on("error", (e) => {
+    resetReconnect(`socket error: ${e.message}`);
+  });
+}
+async function enrollRemoteAgent(controllerUrl, enrollmentToken, name) {
+  const response = await fetch(new URL("/v1/enroll", controllerUrl), {
+    method: "POST",
+    headers: { "content-type": "application/json", authorization: `Bearer ${enrollmentToken}` },
+    body: JSON.stringify({ name })
+  });
+  const result = await response.json();
+  if (!response.ok || !result.agentId || !result.agentSecret) throw new Error(result.error ?? "enrollment failed");
+  writeConfig({ enabled: true, controller_url: controllerUrl, agent_id: result.agentId, agent_secret: result.agentSecret });
+  return result.agentId;
+}
+function disableRemoteAgent() {
+  const config = loadConfig();
+  if (config.agent_id || config.agent_secret) {
+    writeConfig({ ...config, enabled: false });
+  }
+  stopRemoteAgent();
+  stopping = false;
+}
+function remoteStatus() {
+  const config = loadConfig();
+  const result = { connected: socket?.readyState === WebSocket.OPEN };
+  if (config.enabled !== void 0) result.enabled = config.enabled;
+  if (config.controller_url) result.controller_url = config.controller_url;
+  if (config.agent_id) result.agent_id = config.agent_id;
+  if (lastError) {
+    result.last_error = lastError;
+    result.retry_in_ms = retryDelay;
+  }
+  return result;
+}
+export {
+  disableRemoteAgent,
+  enrollRemoteAgent,
+  remoteStatus,
+  startRemoteAgent,
+  stopRemoteAgent
+};
+//# sourceMappingURL=remote-agent.js.map