@nextclaw/service 0.2.12 → 0.2.14

package/dist/utils/cli.utils.d.ts

@@ -0,0 +1,32 @@
+import { getPackageVersion } from "./package/package-manifest.utils.js";
+import { Config } from "@nextclaw/core";
+import { Interface } from "node:readline";
+
+//#region src/utils/cli.utils.d.ts
+declare function resolveUiConfig(config: Config, overrides?: Partial<Config["ui"]>): Config["ui"];
+declare function resolveUiApiBase(host: string, port: number): string;
+declare function isLoopbackHost(host: string): boolean;
+declare function resolvePublicIp(timeoutMs?: number): Promise<string | null>;
+declare function resolveServiceLogPath(): string;
+declare function isProcessRunning(pid: number): boolean;
+declare function waitForExit(pid: number, timeoutMs: number): Promise<boolean>;
+type ListeningProcessInfo = {
+  pid: number;
+  command: string | null;
+};
+declare function findListeningProcessByPort(port: number): ListeningProcessInfo | null;
+declare function resolveUiStaticDir(packagedUiDistDir?: string | null): string | null;
+declare function openBrowser(url: string): boolean;
+type ExecutableLookupEnv = {
+  [key: string]: string | undefined;
+  PATH?: string;
+  Path?: string;
+  path?: string;
+  PATHEXT?: string;
+};
+declare function findExecutableOnPath(binary: string, env?: ExecutableLookupEnv, platform?: NodeJS.Platform): string | null;
+declare function printAgentResponse(response: string): void;
+declare function prompt(rl: Interface, question: string): Promise<string>;
+//#endregion
+export { ExecutableLookupEnv, ListeningProcessInfo, findExecutableOnPath, findListeningProcessByPort, getPackageVersion, isLoopbackHost, isProcessRunning, openBrowser, printAgentResponse, prompt, resolvePublicIp, resolveServiceLogPath, resolveUiApiBase, resolveUiConfig, resolveUiStaticDir, waitForExit };
+//# sourceMappingURL=cli.utils.d.ts.map

package/dist/utils/cli.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.utils.d.ts","names":[],"sources":["../../src/utils/cli.utils.ts"],"mappings":";;;;;iBAcgB,eAAA,CAAgB,MAAA,EAAQ,MAAA,EAAQ,SAAA,GAAY,OAAA,CAAQ,MAAA,UAAgB,MAAA;AAAA,iBAKpE,gBAAA,CAAiB,IAAA,UAAc,IAAA;AAAA,iBAI/B,cAAA,CAAe,IAAA;AAAA,iBA6BT,eAAA,CAAgB,SAAA,YAAmB,OAAA;AAAA,iBAUzC,qBAAA,CAAA;AAAA,iBAIA,gBAAA,CAAiB,GAAA;AAAA,iBASX,WAAA,CAAY,GAAA,UAAa,SAAA,WAAoB,OAAA;AAAA,KAWvD,oBAAA;EACV,GAAA;EACA,OAAA;AAAA;AAAA,iBA2Fc,0BAAA,CAA2B,IAAA,WAAe,oBAAA;AAAA,iBA8B1C,kBAAA,CAAmB,iBAAA;AAAA,iBAgBnB,WAAA,CAAY,GAAA;AAAA,KA+BhB,mBAAA;EAAA,CACT,GAAA;EACD,IAAA;EACA,IAAA;EACA,IAAA;EACA,OAAA;AAAA;AAAA,iBA0Bc,oBAAA,CACd,MAAA,UACA,GAAA,GAAK,mBAAA,EACL,QAAA,GAAU,MAAA,CAAO,QAAA;AAAA,iBA0CH,kBAAA,CAAmB,QAAA;AAAA,iBAIb,MAAA,CAAO,EAAA,EAAI,SAAA,EAAW,QAAA,WAAmB,OAAA"}

package/dist/utils/cli.utils.js

@@ -0,0 +1,254 @@
+import { getPackageVersion } from "./package/package-manifest.utils.js";
+import { createExternalCommandEnv, getRuntimeLogsPath, resolveLocalUiBaseUrl } from "@nextclaw/core";
+import { existsSync } from "node:fs";
+import { spawn, spawnSync } from "node:child_process";
+import { join, resolve } from "node:path";
+import { isIP } from "node:net";
+//#region src/utils/cli.utils.ts
+function resolveUiConfig(config, overrides) {
+	return {
+		...config.ui ?? {
+			enabled: false,
+			host: "127.0.0.1",
+			port: 55667,
+			open: false
+		},
+		...overrides ?? {}
+	};
+}
+function resolveUiApiBase(host, port) {
+	return resolveLocalUiBaseUrl({
+		host,
+		port
+	});
+}
+function isLoopbackHost(host) {
+	const normalized = host.trim().toLowerCase();
+	return normalized === "127.0.0.1" || normalized === "localhost" || normalized === "::1";
+}
+const PUBLIC_IP_CHECK_URLS = ["https://api.ipify.org", "https://ifconfig.me/ip"];
+async function fetchPublicIpFrom(url, timeoutMs) {
+	const controller = new AbortController();
+	const timer = setTimeout(() => controller.abort(), timeoutMs);
+	try {
+		const response = await fetch(url, {
+			signal: controller.signal,
+			headers: { Accept: "text/plain" }
+		});
+		if (!response.ok) return null;
+		const text = (await response.text()).trim();
+		return isIP(text) ? text : null;
+	} catch {
+		return null;
+	} finally {
+		clearTimeout(timer);
+	}
+}
+async function resolvePublicIp(timeoutMs = 1500) {
+	for (const endpoint of PUBLIC_IP_CHECK_URLS) {
+		const candidate = await fetchPublicIpFrom(endpoint, timeoutMs);
+		if (candidate) return candidate;
+	}
+	return null;
+}
+function resolveServiceLogPath() {
+	return resolve(getRuntimeLogsPath(), "service.log");
+}
+function isProcessRunning(pid) {
+	try {
+		process.kill(pid, 0);
+		return true;
+	} catch {
+		return false;
+	}
+}
+async function waitForExit(pid, timeoutMs) {
+	const start = Date.now();
+	while (Date.now() - start < timeoutMs) {
+		if (!isProcessRunning(pid)) return true;
+		await new Promise((resolve) => setTimeout(resolve, 200));
+	}
+	return !isProcessRunning(pid);
+}
+function runLookupCommand(command, args) {
+	try {
+		const result = spawnSync(command, args, {
+			encoding: "utf8",
+			env: createExternalCommandEnv(process.env)
+		});
+		if (result.error || result.status !== 0) return {
+			ok: false,
+			stdout: ""
+		};
+		return {
+			ok: true,
+			stdout: result.stdout ?? ""
+		};
+	} catch {
+		return {
+			ok: false,
+			stdout: ""
+		};
+	}
+}
+function parseListeningPidFromLsof(raw) {
+	for (const line of raw.split("\n")) {
+		if (!line.startsWith("p")) continue;
+		const pid = Number(line.slice(1));
+		if (Number.isFinite(pid) && pid > 0) return pid;
+	}
+	return null;
+}
+function parseListeningPidFromNetstat(raw, port) {
+	const portSuffix = `:${port}`;
+	for (const line of raw.split("\n")) {
+		const trimmed = line.trim();
+		if (!trimmed || !trimmed.includes("LISTEN")) continue;
+		const columns = trimmed.split(/\s+/);
+		if (columns.length < 5) continue;
+		if (!(columns[1] ?? "").endsWith(portSuffix)) continue;
+		const pid = Number(columns[4]);
+		if (Number.isFinite(pid) && pid > 0) return pid;
+	}
+	return null;
+}
+function lookupProcessCommandByPid(pid) {
+	if (!Number.isFinite(pid) || pid <= 0) return null;
+	if (process.platform === "win32") {
+		const result = runLookupCommand("powershell", [
+			"-NoProfile",
+			"-Command",
+			`(Get-CimInstance Win32_Process -Filter "ProcessId = ${pid}").CommandLine`
+		]);
+		if (!result.ok) return null;
+		const command = result.stdout.trim();
+		return command.length > 0 ? command : null;
+	}
+	const result = runLookupCommand("ps", [
+		"-p",
+		String(pid),
+		"-o",
+		"command="
+	]);
+	if (!result.ok) return null;
+	const command = result.stdout.trim();
+	return command.length > 0 ? command : null;
+}
+function findListeningProcessByPort(port) {
+	if (!Number.isFinite(port) || port <= 0) return null;
+	let pid = null;
+	if (process.platform === "win32") {
+		const result = runLookupCommand("netstat", [
+			"-ano",
+			"-p",
+			"tcp"
+		]);
+		if (!result.ok) return null;
+		pid = parseListeningPidFromNetstat(result.stdout, port);
+	} else {
+		const result = runLookupCommand("lsof", [
+			"-nP",
+			`-iTCP:${port}`,
+			"-sTCP:LISTEN",
+			"-F",
+			"p"
+		]);
+		if (!result.ok) return null;
+		pid = parseListeningPidFromLsof(result.stdout);
+	}
+	if (!pid) return null;
+	return {
+		pid,
+		command: lookupProcessCommandByPid(pid)
+	};
+}
+function resolveUiStaticDir(packagedUiDistDir) {
+	if (process.env.NEXTCLAW_DISABLE_STATIC_UI === "1") return null;
+	const envDir = process.env.NEXTCLAW_UI_STATIC_DIR;
+	if (envDir) return existsSync(join(envDir, "index.html")) ? envDir : null;
+	if (!packagedUiDistDir) return null;
+	return existsSync(join(packagedUiDistDir, "index.html")) ? packagedUiDistDir : null;
+}
+function openBrowser(url) {
+	const platform = process.platform;
+	let command;
+	let args;
+	if (platform === "darwin") {
+		command = "open";
+		args = [url];
+	} else if (platform === "win32") {
+		command = "cmd";
+		args = [
+			"/c",
+			"start",
+			"",
+			url
+		];
+	} else {
+		command = "xdg-open";
+		args = [url];
+	}
+	if (!findExecutableOnPath(command)) return false;
+	try {
+		spawn(command, args, {
+			stdio: "ignore",
+			detached: true,
+			env: createExternalCommandEnv(process.env),
+			windowsHide: true
+		}).unref();
+		return true;
+	} catch {
+		return false;
+	}
+}
+function normalizePathEntries(rawPath, platform) {
+	const delimiter = platform === "win32" ? ";" : ":";
+	return rawPath.split(delimiter).map((entry) => entry.trim().replace(/^"+|"+$/g, "")).filter(Boolean);
+}
+function normalizeWindowsPathExt(rawPathExt) {
+	const source = rawPathExt && rawPathExt.trim().length > 0 ? rawPathExt : ".COM;.EXE;.BAT;.CMD";
+	const unique = /* @__PURE__ */ new Set();
+	for (const ext of source.split(";")) {
+		const trimmed = ext.trim();
+		if (!trimmed) continue;
+		const normalized = trimmed.startsWith(".") ? trimmed : `.${trimmed}`;
+		unique.add(normalized.toUpperCase());
+	}
+	return [...unique];
+}
+function hasFileExtension(binary) {
+	return binary.lastIndexOf(".") > Math.max(binary.lastIndexOf("/"), binary.lastIndexOf("\\"));
+}
+function findExecutableOnPath(binary, env = process.env, platform = process.platform) {
+	const target = binary.trim();
+	if (!target) return null;
+	if (target.includes("/") || target.includes("\\")) return existsSync(target) ? target : null;
+	const rawPath = env.PATH ?? env.Path ?? env.path ?? "";
+	if (!rawPath.trim()) return null;
+	const entries = normalizePathEntries(rawPath, platform);
+	if (entries.length === 0) return null;
+	for (const dir of entries) {
+		const direct = join(dir, target);
+		if (existsSync(direct)) return direct;
+		if (platform !== "win32" || hasFileExtension(target)) continue;
+		for (const ext of normalizeWindowsPathExt(env.PATHEXT)) {
+			const withExt = join(dir, `${target}${ext}`);
+			if (existsSync(withExt)) return withExt;
+		}
+	}
+	return null;
+}
+function printAgentResponse(response) {
+	console.log("\n" + response + "\n");
+}
+async function prompt(rl, question) {
+	rl.setPrompt(question);
+	rl.prompt();
+	return new Promise((resolve) => {
+		rl.once("line", (line) => resolve(line));
+	});
+}
+//#endregion
+export { findExecutableOnPath, findListeningProcessByPort, getPackageVersion, isLoopbackHost, isProcessRunning, openBrowser, printAgentResponse, prompt, resolvePublicIp, resolveServiceLogPath, resolveUiApiBase, resolveUiConfig, resolveUiStaticDir, waitForExit };
+
+//# sourceMappingURL=cli.utils.js.map

package/dist/utils/cli.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.utils.js","names":[],"sources":["../../src/utils/cli.utils.ts"],"sourcesContent":["import { existsSync } from \"node:fs\";\nimport { join, resolve } from \"node:path\";\nimport { spawn, spawnSync } from \"node:child_process\";\nimport { isIP } from \"node:net\";\nimport type { Interface } from \"node:readline\";\nimport {\n  createExternalCommandEnv,\n  getRuntimeLogsPath,\n  resolveLocalUiBaseUrl,\n  type Config\n} from \"@nextclaw/core\";\n\nexport { getPackageVersion } from \"./package/package-manifest.utils.js\";\n\nexport function resolveUiConfig(config: Config, overrides?: Partial<Config[\"ui\"]>): Config[\"ui\"] {\n  const base = config.ui ?? { enabled: false, host: \"127.0.0.1\", port: 55667, open: false };\n  return { ...base, ...(overrides ?? {}) };\n}\n\nexport function resolveUiApiBase(host: string, port: number): string {\n  return resolveLocalUiBaseUrl({ host, port });\n}\n\nexport function isLoopbackHost(host: string): boolean {\n  const normalized = host.trim().toLowerCase();\n  return normalized === \"127.0.0.1\" || normalized === \"localhost\" || normalized === \"::1\";\n}\n\nconst PUBLIC_IP_CHECK_URLS = [\"https://api.ipify.org\", \"https://ifconfig.me/ip\"];\n\nasync function fetchPublicIpFrom(url: string, timeoutMs: number): Promise<string | null> {\n  const controller = new AbortController();\n  const timer = setTimeout(() => controller.abort(), timeoutMs);\n  try {\n    const response = await fetch(url, {\n      signal: controller.signal,\n      headers: {\n        Accept: \"text/plain\"\n      }\n    });\n    if (!response.ok) {\n      return null;\n    }\n    const text = (await response.text()).trim();\n    return isIP(text) ? text : null;\n  } catch {\n    return null;\n  } finally {\n    clearTimeout(timer);\n  }\n}\n\nexport async function resolvePublicIp(timeoutMs = 1500): Promise<string | null> {\n  for (const endpoint of PUBLIC_IP_CHECK_URLS) {\n    const candidate = await fetchPublicIpFrom(endpoint, timeoutMs);\n    if (candidate) {\n      return candidate;\n    }\n  }\n  return null;\n}\n\nexport function resolveServiceLogPath(): string {\n  return resolve(getRuntimeLogsPath(), \"service.log\");\n}\n\nexport function isProcessRunning(pid: number): boolean {\n  try {\n    process.kill(pid, 0);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nexport async function waitForExit(pid: number, timeoutMs: number): Promise<boolean> {\n  const start = Date.now();\n  while (Date.now() - start < timeoutMs) {\n    if (!isProcessRunning(pid)) {\n      return true;\n    }\n    await new Promise((resolve) => setTimeout(resolve, 200));\n  }\n  return !isProcessRunning(pid);\n}\n\nexport type ListeningProcessInfo = {\n  pid: number;\n  command: string | null;\n};\n\ntype CommandResult = {\n  ok: boolean;\n  stdout: string;\n};\n\nfunction runLookupCommand(command: string, args: string[]): CommandResult {\n  try {\n    const result = spawnSync(command, args, {\n      encoding: \"utf8\",\n      env: createExternalCommandEnv(process.env)\n    });\n    if (result.error || result.status !== 0) {\n      return {\n        ok: false,\n        stdout: \"\"\n      };\n    }\n    return {\n      ok: true,\n      stdout: result.stdout ?? \"\"\n    };\n  } catch {\n    return {\n      ok: false,\n      stdout: \"\"\n    };\n  }\n}\n\nfunction parseListeningPidFromLsof(raw: string): number | null {\n  for (const line of raw.split(\"\\n\")) {\n    if (!line.startsWith(\"p\")) {\n      continue;\n    }\n    const pid = Number(line.slice(1));\n    if (Number.isFinite(pid) && pid > 0) {\n      return pid;\n    }\n  }\n  return null;\n}\n\nfunction parseListeningPidFromNetstat(raw: string, port: number): number | null {\n  const portSuffix = `:${port}`;\n  for (const line of raw.split(\"\\n\")) {\n    const trimmed = line.trim();\n    if (!trimmed || !trimmed.includes(\"LISTEN\")) {\n      continue;\n    }\n    const columns = trimmed.split(/\\s+/);\n    if (columns.length < 5) {\n      continue;\n    }\n    const localAddress = columns[1] ?? \"\";\n    if (!localAddress.endsWith(portSuffix)) {\n      continue;\n    }\n    const pid = Number(columns[4]);\n    if (Number.isFinite(pid) && pid > 0) {\n      return pid;\n    }\n  }\n  return null;\n}\n\nfunction lookupProcessCommandByPid(pid: number): string | null {\n  if (!Number.isFinite(pid) || pid <= 0) {\n    return null;\n  }\n\n  if (process.platform === \"win32\") {\n    const script = `(Get-CimInstance Win32_Process -Filter \"ProcessId = ${pid}\").CommandLine`;\n    const result = runLookupCommand(\"powershell\", [\"-NoProfile\", \"-Command\", script]);\n    if (!result.ok) {\n      return null;\n    }\n    const command = result.stdout.trim();\n    return command.length > 0 ? command : null;\n  }\n\n  const result = runLookupCommand(\"ps\", [\"-p\", String(pid), \"-o\", \"command=\"]);\n  if (!result.ok) {\n    return null;\n  }\n  const command = result.stdout.trim();\n  return command.length > 0 ? command : null;\n}\n\nexport function findListeningProcessByPort(port: number): ListeningProcessInfo | null {\n  if (!Number.isFinite(port) || port <= 0) {\n    return null;\n  }\n\n  let pid: number | null = null;\n  if (process.platform === \"win32\") {\n    const result = runLookupCommand(\"netstat\", [\"-ano\", \"-p\", \"tcp\"]);\n    if (!result.ok) {\n      return null;\n    }\n    pid = parseListeningPidFromNetstat(result.stdout, port);\n  } else {\n    const result = runLookupCommand(\"lsof\", [\"-nP\", `-iTCP:${port}`, \"-sTCP:LISTEN\", \"-F\", \"p\"]);\n    if (!result.ok) {\n      return null;\n    }\n    pid = parseListeningPidFromLsof(result.stdout);\n  }\n\n  if (!pid) {\n    return null;\n  }\n\n  return {\n    pid,\n    command: lookupProcessCommandByPid(pid)\n  };\n}\n\nexport function resolveUiStaticDir(packagedUiDistDir?: string | null): string | null {\n  if (process.env.NEXTCLAW_DISABLE_STATIC_UI === \"1\") {\n    return null;\n  }\n\n  const envDir = process.env.NEXTCLAW_UI_STATIC_DIR;\n  if (envDir) {\n    return existsSync(join(envDir, \"index.html\")) ? envDir : null;\n  }\n\n  if (!packagedUiDistDir) {\n    return null;\n  }\n  return existsSync(join(packagedUiDistDir, \"index.html\")) ? packagedUiDistDir : null;\n}\n\nexport function openBrowser(url: string): boolean {\n  const platform = process.platform;\n  let command: string;\n  let args: string[];\n  if (platform === \"darwin\") {\n    command = \"open\";\n    args = [url];\n  } else if (platform === \"win32\") {\n    command = \"cmd\";\n    args = [\"/c\", \"start\", \"\", url];\n  } else {\n    command = \"xdg-open\";\n    args = [url];\n  }\n  if (!findExecutableOnPath(command)) {\n    return false;\n  }\n  try {\n    const child = spawn(command, args, {\n      stdio: \"ignore\",\n      detached: true,\n      env: createExternalCommandEnv(process.env),\n      windowsHide: true\n    });\n    child.unref();\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nexport type ExecutableLookupEnv = {\n  [key: string]: string | undefined;\n  PATH?: string;\n  Path?: string;\n  path?: string;\n  PATHEXT?: string;\n};\n\nfunction normalizePathEntries(rawPath: string, platform: NodeJS.Platform): string[] {\n  const delimiter = platform === \"win32\" ? \";\" : \":\";\n  return rawPath.split(delimiter).map((entry) => entry.trim().replace(/^\"+|\"+$/g, \"\")).filter(Boolean);\n}\n\nfunction normalizeWindowsPathExt(rawPathExt: string | undefined): string[] {\n  const source = (rawPathExt && rawPathExt.trim().length > 0) ? rawPathExt : \".COM;.EXE;.BAT;.CMD\";\n  const unique = new Set<string>();\n  for (const ext of source.split(\";\")) {\n    const trimmed = ext.trim();\n    if (!trimmed) {\n      continue;\n    }\n    const normalized = trimmed.startsWith(\".\") ? trimmed : `.${trimmed}`;\n    unique.add(normalized.toUpperCase());\n  }\n  return [...unique];\n}\n\nfunction hasFileExtension(binary: string): boolean {\n  return binary.lastIndexOf(\".\") > Math.max(binary.lastIndexOf(\"/\"), binary.lastIndexOf(\"\\\\\"));\n}\n\nexport function findExecutableOnPath(\n  binary: string,\n  env: ExecutableLookupEnv = process.env,\n  platform: NodeJS.Platform = process.platform\n): string | null {\n  const target = binary.trim();\n  if (!target) {\n    return null;\n  }\n\n  if (target.includes(\"/\") || target.includes(\"\\\\\")) {\n    return existsSync(target) ? target : null;\n  }\n\n  const rawPath = env.PATH ?? env.Path ?? env.path ?? \"\";\n  if (!rawPath.trim()) {\n    return null;\n  }\n\n  const entries = normalizePathEntries(rawPath, platform);\n  if (entries.length === 0) {\n    return null;\n  }\n\n  for (const dir of entries) {\n    const direct = join(dir, target);\n    if (existsSync(direct)) {\n      return direct;\n    }\n\n    if (platform !== \"win32\" || hasFileExtension(target)) {\n      continue;\n    }\n\n    for (const ext of normalizeWindowsPathExt(env.PATHEXT)) {\n      const withExt = join(dir, `${target}${ext}`);\n      if (existsSync(withExt)) {\n        return withExt;\n      }\n    }\n  }\n\n  return null;\n}\n\nexport function printAgentResponse(response: string): void {\n  console.log(\"\\n\" + response + \"\\n\");\n}\n\nexport async function prompt(rl: Interface, question: string): Promise<string> {\n  rl.setPrompt(question);\n  rl.prompt();\n  return new Promise((resolve) => {\n    rl.once(\"line\", (line) => resolve(line));\n  });\n}\n"],"mappings":";;;;;;;AAcA,SAAgB,gBAAgB,QAAgB,WAAiD;AAE/F,QAAO;EAAE,GADI,OAAO,MAAM;GAAE,SAAS;GAAO,MAAM;GAAa,MAAM;GAAO,MAAM;GAAO;EACvE,GAAI,aAAa,EAAE;EAAG;;AAG1C,SAAgB,iBAAiB,MAAc,MAAsB;AACnE,QAAO,sBAAsB;EAAE;EAAM;EAAM,CAAC;;AAG9C,SAAgB,eAAe,MAAuB;CACpD,MAAM,aAAa,KAAK,MAAM,CAAC,aAAa;AAC5C,QAAO,eAAe,eAAe,eAAe,eAAe,eAAe;;AAGpF,MAAM,uBAAuB,CAAC,yBAAyB,yBAAyB;AAEhF,eAAe,kBAAkB,KAAa,WAA2C;CACvF,MAAM,aAAa,IAAI,iBAAiB;CACxC,MAAM,QAAQ,iBAAiB,WAAW,OAAO,EAAE,UAAU;AAC7D,KAAI;EACF,MAAM,WAAW,MAAM,MAAM,KAAK;GAChC,QAAQ,WAAW;GACnB,SAAS,EACP,QAAQ,cACT;GACF,CAAC;AACF,MAAI,CAAC,SAAS,GACZ,QAAO;EAET,MAAM,QAAQ,MAAM,SAAS,MAAM,EAAE,MAAM;AAC3C,SAAO,KAAK,KAAK,GAAG,OAAO;SACrB;AACN,SAAO;WACC;AACR,eAAa,MAAM;;;AAIvB,eAAsB,gBAAgB,YAAY,MAA8B;AAC9E,MAAK,MAAM,YAAY,sBAAsB;EAC3C,MAAM,YAAY,MAAM,kBAAkB,UAAU,UAAU;AAC9D,MAAI,UACF,QAAO;;AAGX,QAAO;;AAGT,SAAgB,wBAAgC;AAC9C,QAAO,QAAQ,oBAAoB,EAAE,cAAc;;AAGrD,SAAgB,iBAAiB,KAAsB;AACrD,KAAI;AACF,UAAQ,KAAK,KAAK,EAAE;AACpB,SAAO;SACD;AACN,SAAO;;;AAIX,eAAsB,YAAY,KAAa,WAAqC;CAClF,MAAM,QAAQ,KAAK,KAAK;AACxB,QAAO,KAAK,KAAK,GAAG,QAAQ,WAAW;AACrC,MAAI,CAAC,iBAAiB,IAAI,CACxB,QAAO;AAET,QAAM,IAAI,SAAS,YAAY,WAAW,SAAS,IAAI,CAAC;;AAE1D,QAAO,CAAC,iBAAiB,IAAI;;AAa/B,SAAS,iBAAiB,SAAiB,MAA+B;AACxE,KAAI;EACF,MAAM,SAAS,UAAU,SAAS,MAAM;GACtC,UAAU;GACV,KAAK,yBAAyB,QAAQ,IAAI;GAC3C,CAAC;AACF,MAAI,OAAO,SAAS,OAAO,WAAW,EACpC,QAAO;GACL,IAAI;GACJ,QAAQ;GACT;AAEH,SAAO;GACL,IAAI;GACJ,QAAQ,OAAO,UAAU;GAC1B;SACK;AACN,SAAO;GACL,IAAI;GACJ,QAAQ;GACT;;;AAIL,SAAS,0BAA0B,KAA4B;AAC7D,MAAK,MAAM,QAAQ,IAAI,MAAM,KAAK,EAAE;AAClC,MAAI,CAAC,KAAK,WAAW,IAAI,CACvB;EAEF,MAAM,MAAM,OAAO,KAAK,MAAM,EAAE,CAAC;AACjC,MAAI,OAAO,SAAS,IAAI,IAAI,MAAM,EAChC,QAAO;;AAGX,QAAO;;AAGT,SAAS,6BAA6B,KAAa,MAA6B;CAC9E,MAAM,aAAa,IAAI;AACvB,MAAK,MAAM,QAAQ,IAAI,MAAM,KAAK,EAAE;EAClC,MAAM,UAAU,KAAK,MAAM;AAC3B,MAAI,CAAC,WAAW,CAAC,QAAQ,SAAS,SAAS,CACzC;EAEF,MAAM,UAAU,QAAQ,MAAM,MAAM;AACpC,MAAI,QAAQ,SAAS,EACnB;AAGF,MAAI,EADiB,QAAQ,MAAM,IACjB,SAAS,WAAW,CACpC;EAEF,MAAM,MAAM,OAAO,QAAQ,GAAG;AAC9B,MAAI,OAAO,SAAS,IAAI,IAAI,MAAM,EAChC,QAAO;;AAGX,QAAO;;AAGT,SAAS,0BAA0B,KAA4B;AAC7D,KAAI,CAAC,OAAO,SAAS,IAAI,IAAI,OAAO,EAClC,QAAO;AAGT,KAAI,QAAQ,aAAa,SAAS;EAEhC,MAAM,SAAS,iBAAiB,cAAc;GAAC;GAAc;GAD9C,uDAAuD,IAAI;GACM,CAAC;AACjF,MAAI,CAAC,OAAO,GACV,QAAO;EAET,MAAM,UAAU,OAAO,OAAO,MAAM;AACpC,SAAO,QAAQ,SAAS,IAAI,UAAU;;CAGxC,MAAM,SAAS,iBAAiB,MAAM;EAAC;EAAM,OAAO,IAAI;EAAE;EAAM;EAAW,CAAC;AAC5E,KAAI,CAAC,OAAO,GACV,QAAO;CAET,MAAM,UAAU,OAAO,OAAO,MAAM;AACpC,QAAO,QAAQ,SAAS,IAAI,UAAU;;AAGxC,SAAgB,2BAA2B,MAA2C;AACpF,KAAI,CAAC,OAAO,SAAS,KAAK,IAAI,QAAQ,EACpC,QAAO;CAGT,IAAI,MAAqB;AACzB,KAAI,QAAQ,aAAa,SAAS;EAChC,MAAM,SAAS,iBAAiB,WAAW;GAAC;GAAQ;GAAM;GAAM,CAAC;AACjE,MAAI,CAAC,OAAO,GACV,QAAO;AAET,QAAM,6BAA6B,OAAO,QAAQ,KAAK;QAClD;EACL,MAAM,SAAS,iBAAiB,QAAQ;GAAC;GAAO,SAAS;GAAQ;GAAgB;GAAM;GAAI,CAAC;AAC5F,MAAI,CAAC,OAAO,GACV,QAAO;AAET,QAAM,0BAA0B,OAAO,OAAO;;AAGhD,KAAI,CAAC,IACH,QAAO;AAGT,QAAO;EACL;EACA,SAAS,0BAA0B,IAAI;EACxC;;AAGH,SAAgB,mBAAmB,mBAAkD;AACnF,KAAI,QAAQ,IAAI,+BAA+B,IAC7C,QAAO;CAGT,MAAM,SAAS,QAAQ,IAAI;AAC3B,KAAI,OACF,QAAO,WAAW,KAAK,QAAQ,aAAa,CAAC,GAAG,SAAS;AAG3D,KAAI,CAAC,kBACH,QAAO;AAET,QAAO,WAAW,KAAK,mBAAmB,aAAa,CAAC,GAAG,oBAAoB;;AAGjF,SAAgB,YAAY,KAAsB;CAChD,MAAM,WAAW,QAAQ;CACzB,IAAI;CACJ,IAAI;AACJ,KAAI,aAAa,UAAU;AACzB,YAAU;AACV,SAAO,CAAC,IAAI;YACH,aAAa,SAAS;AAC/B,YAAU;AACV,SAAO;GAAC;GAAM;GAAS;GAAI;GAAI;QAC1B;AACL,YAAU;AACV,SAAO,CAAC,IAAI;;AAEd,KAAI,CAAC,qBAAqB,QAAQ,CAChC,QAAO;AAET,KAAI;AACY,QAAM,SAAS,MAAM;GACjC,OAAO;GACP,UAAU;GACV,KAAK,yBAAyB,QAAQ,IAAI;GAC1C,aAAa;GACd,CAAC,CACI,OAAO;AACb,SAAO;SACD;AACN,SAAO;;;AAYX,SAAS,qBAAqB,SAAiB,UAAqC;CAClF,MAAM,YAAY,aAAa,UAAU,MAAM;AAC/C,QAAO,QAAQ,MAAM,UAAU,CAAC,KAAK,UAAU,MAAM,MAAM,CAAC,QAAQ,YAAY,GAAG,CAAC,CAAC,OAAO,QAAQ;;AAGtG,SAAS,wBAAwB,YAA0C;CACzE,MAAM,SAAU,cAAc,WAAW,MAAM,CAAC,SAAS,IAAK,aAAa;CAC3E,MAAM,yBAAS,IAAI,KAAa;AAChC,MAAK,MAAM,OAAO,OAAO,MAAM,IAAI,EAAE;EACnC,MAAM,UAAU,IAAI,MAAM;AAC1B,MAAI,CAAC,QACH;EAEF,MAAM,aAAa,QAAQ,WAAW,IAAI,GAAG,UAAU,IAAI;AAC3D,SAAO,IAAI,WAAW,aAAa,CAAC;;AAEtC,QAAO,CAAC,GAAG,OAAO;;AAGpB,SAAS,iBAAiB,QAAyB;AACjD,QAAO,OAAO,YAAY,IAAI,GAAG,KAAK,IAAI,OAAO,YAAY,IAAI,EAAE,OAAO,YAAY,KAAK,CAAC;;AAG9F,SAAgB,qBACd,QACA,MAA2B,QAAQ,KACnC,WAA4B,QAAQ,UACrB;CACf,MAAM,SAAS,OAAO,MAAM;AAC5B,KAAI,CAAC,OACH,QAAO;AAGT,KAAI,OAAO,SAAS,IAAI,IAAI,OAAO,SAAS,KAAK,CAC/C,QAAO,WAAW,OAAO,GAAG,SAAS;CAGvC,MAAM,UAAU,IAAI,QAAQ,IAAI,QAAQ,IAAI,QAAQ;AACpD,KAAI,CAAC,QAAQ,MAAM,CACjB,QAAO;CAGT,MAAM,UAAU,qBAAqB,SAAS,SAAS;AACvD,KAAI,QAAQ,WAAW,EACrB,QAAO;AAGT,MAAK,MAAM,OAAO,SAAS;EACzB,MAAM,SAAS,KAAK,KAAK,OAAO;AAChC,MAAI,WAAW,OAAO,CACpB,QAAO;AAGT,MAAI,aAAa,WAAW,iBAAiB,OAAO,CAClD;AAGF,OAAK,MAAM,OAAO,wBAAwB,IAAI,QAAQ,EAAE;GACtD,MAAM,UAAU,KAAK,KAAK,GAAG,SAAS,MAAM;AAC5C,OAAI,WAAW,QAAQ,CACrB,QAAO;;;AAKb,QAAO;;AAGT,SAAgB,mBAAmB,UAAwB;AACzD,SAAQ,IAAI,OAAO,WAAW,KAAK;;AAGrC,eAAsB,OAAO,IAAe,UAAmC;AAC7E,IAAG,UAAU,SAAS;AACtB,IAAG,QAAQ;AACX,QAAO,IAAI,SAAS,YAAY;AAC9B,KAAG,KAAK,SAAS,SAAS,QAAQ,KAAK,CAAC;GACxC"}

package/dist/utils/config-path.utils.d.ts

@@ -0,0 +1,16 @@
+import { ConfigSetOptions } from "../types/cli.types.js";
+
+//#region src/utils/config-path.utils.d.ts
+declare function isIndexSegment(raw: string): boolean;
+declare function parseConfigPath(raw: string): string[];
+declare function parseRequiredConfigPath(raw: string): string[];
+declare function parseConfigSetValue(raw: string, opts: ConfigSetOptions): unknown;
+declare function getAtConfigPath(root: unknown, pathSegments: string[]): {
+  found: boolean;
+  value?: unknown;
+};
+declare function setAtConfigPath(root: Record<string, unknown>, pathSegments: string[], value: unknown): void;
+declare function unsetAtConfigPath(root: Record<string, unknown>, pathSegments: string[]): boolean;
+//#endregion
+export { getAtConfigPath, isIndexSegment, parseConfigPath, parseConfigSetValue, parseRequiredConfigPath, setAtConfigPath, unsetAtConfigPath };
+//# sourceMappingURL=config-path.utils.d.ts.map

package/dist/utils/config-path.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-path.utils.d.ts","names":[],"sources":["../../src/utils/config-path.utils.ts"],"mappings":";;;iBAEgB,cAAA,CAAe,GAAA;AAAA,iBAIf,eAAA,CAAgB,GAAA;AAAA,iBAwDhB,uBAAA,CAAwB,GAAA;AAAA,iBAQxB,mBAAA,CAAoB,GAAA,UAAa,IAAA,EAAM,gBAAA;AAAA,iBAYvC,eAAA,CAAgB,IAAA,WAAe,YAAA;EAA2B,KAAA;EAAgB,KAAA;AAAA;AAAA,iBA6B1E,eAAA,CAAgB,IAAA,EAAM,MAAA,mBAAyB,YAAA,YAAwB,KAAA;AAAA,iBA6FvE,iBAAA,CAAkB,IAAA,EAAM,MAAA,mBAAyB,YAAA"}

package/dist/utils/config-path.utils.js

@@ -0,0 +1,169 @@
+//#region src/utils/config-path.utils.ts
+function isIndexSegment(raw) {
+	return /^[0-9]+$/.test(raw);
+}
+function parseConfigPath(raw) {
+	const trimmed = raw.trim();
+	if (!trimmed) return [];
+	const parts = [];
+	let current = "";
+	let i = 0;
+	while (i < trimmed.length) {
+		const ch = trimmed[i];
+		if (ch === "\\") {
+			const next = trimmed[i + 1];
+			if (next) current += next;
+			i += 2;
+			continue;
+		}
+		if (ch === ".") {
+			if (current) parts.push(current);
+			current = "";
+			i += 1;
+			continue;
+		}
+		if (ch === "[") {
+			if (current) parts.push(current);
+			current = "";
+			const close = trimmed.indexOf("]", i);
+			if (close === -1) throw new Error(`Invalid path (missing "]"): ${raw}`);
+			const inside = trimmed.slice(i + 1, close).trim();
+			if (!inside) throw new Error(`Invalid path (empty "[]"): ${raw}`);
+			parts.push(inside);
+			i = close + 1;
+			continue;
+		}
+		current += ch;
+		i += 1;
+	}
+	if (current) parts.push(current);
+	return parts.map((part) => part.trim()).filter(Boolean);
+}
+function parseRequiredConfigPath(raw) {
+	const parsedPath = parseConfigPath(raw);
+	if (parsedPath.length === 0) throw new Error("Path is empty.");
+	return parsedPath;
+}
+function parseConfigSetValue(raw, opts) {
+	const trimmed = raw.trim();
+	if (opts.json) return JSON.parse(trimmed);
+	try {
+		return JSON.parse(trimmed);
+	} catch {
+		return raw;
+	}
+}
+function getAtConfigPath(root, pathSegments) {
+	let current = root;
+	for (const segment of pathSegments) {
+		if (!current || typeof current !== "object") return { found: false };
+		if (Array.isArray(current)) {
+			if (!isIndexSegment(segment)) return { found: false };
+			const index = Number.parseInt(segment, 10);
+			if (!Number.isFinite(index) || index < 0 || index >= current.length) return { found: false };
+			current = current[index];
+			continue;
+		}
+		const record = current;
+		if (!Object.prototype.hasOwnProperty.call(record, segment)) return { found: false };
+		current = record[segment];
+	}
+	return {
+		found: true,
+		value: current
+	};
+}
+function setAtConfigPath(root, pathSegments, value) {
+	let current = root;
+	for (let i = 0; i < pathSegments.length - 1; i += 1) {
+		const segment = pathSegments[i];
+		const next = pathSegments[i + 1];
+		const nextIsIndex = Boolean(next && isIndexSegment(next));
+		if (Array.isArray(current)) {
+			current = getOrCreateArraySegment(current, segment, nextIsIndex, pathSegments.slice(0, i));
+			continue;
+		}
+		current = getOrCreateObjectSegment(current, segment, nextIsIndex);
+	}
+	setConfigPathValue(current, pathSegments[pathSegments.length - 1], value, pathSegments.slice(0, -1));
+}
+function ensureWritableArrayIndex(current, index, parentPath) {
+	if (!Number.isFinite(index) || index < 0) throw new Error(`Invalid array index "${index}"`);
+	if (index <= current.length) return;
+	const parentPathExpr = formatConfigPath(parentPath);
+	const parentLabel = parentPathExpr ? `"${parentPathExpr}"` : "the root array";
+	throw new Error(`Cannot set sparse array index ${index} under ${parentLabel}. Set indices in order.`);
+}
+function getOrCreateArraySegment(current, segment, nextIsIndex, parentPath) {
+	const index = parseArrayIndexSegment(segment);
+	ensureWritableArrayIndex(current, index, parentPath);
+	const existing = current[index];
+	if (!existing || typeof existing !== "object") current[index] = nextIsIndex ? [] : {};
+	return current[index];
+}
+function getOrCreateObjectSegment(current, segment, nextIsIndex) {
+	if (!current || typeof current !== "object") throw new Error(`Cannot traverse into "${segment}" (not an object)`);
+	const record = current;
+	const existing = record[segment];
+	if (!existing || typeof existing !== "object") record[segment] = nextIsIndex ? [] : {};
+	return record[segment];
+}
+function setConfigPathValue(current, last, value, parentPath) {
+	if (Array.isArray(current)) {
+		const index = parseArrayIndexSegment(last);
+		ensureWritableArrayIndex(current, index, parentPath);
+		current[index] = value;
+		return;
+	}
+	if (!current || typeof current !== "object") throw new Error(`Cannot set "${last}" (parent is not an object)`);
+	current[last] = value;
+}
+function parseArrayIndexSegment(segment) {
+	if (!isIndexSegment(segment)) throw new Error(`Expected numeric index for array segment "${segment}"`);
+	return Number.parseInt(segment, 10);
+}
+function formatConfigPath(pathSegments) {
+	let expr = "";
+	for (const segment of pathSegments) {
+		if (isIndexSegment(segment)) {
+			expr += `[${segment}]`;
+			continue;
+		}
+		expr += expr ? `.${segment}` : segment;
+	}
+	return expr;
+}
+function unsetAtConfigPath(root, pathSegments) {
+	let current = root;
+	for (let i = 0; i < pathSegments.length - 1; i += 1) {
+		const segment = pathSegments[i];
+		if (!current || typeof current !== "object") return false;
+		if (Array.isArray(current)) {
+			if (!isIndexSegment(segment)) return false;
+			const index = Number.parseInt(segment, 10);
+			if (!Number.isFinite(index) || index < 0 || index >= current.length) return false;
+			current = current[index];
+			continue;
+		}
+		const record = current;
+		if (!Object.prototype.hasOwnProperty.call(record, segment)) return false;
+		current = record[segment];
+	}
+	const last = pathSegments[pathSegments.length - 1];
+	if (Array.isArray(current)) {
+		if (!isIndexSegment(last)) return false;
+		const index = Number.parseInt(last, 10);
+		if (!Number.isFinite(index) || index < 0 || index >= current.length) return false;
+		current.splice(index, 1);
+		return true;
+	}
+	if (!current || typeof current !== "object") return false;
+	const record = current;
+	if (!Object.prototype.hasOwnProperty.call(record, last)) return false;
+	delete record[last];
+	return true;
+}
+//#endregion
+export { getAtConfigPath, isIndexSegment, parseConfigPath, parseConfigSetValue, parseRequiredConfigPath, setAtConfigPath, unsetAtConfigPath };
+
+//# sourceMappingURL=config-path.utils.js.map

package/dist/utils/config-path.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-path.utils.js","names":[],"sources":["../../src/utils/config-path.utils.ts"],"sourcesContent":["import type { ConfigSetOptions } from \"../types/cli.types.js\";\n\nexport function isIndexSegment(raw: string): boolean {\n  return /^[0-9]+$/.test(raw);\n}\n\nexport function parseConfigPath(raw: string): string[] {\n  const trimmed = raw.trim();\n  if (!trimmed) {\n    return [];\n  }\n\n  const parts: string[] = [];\n  let current = \"\";\n  let i = 0;\n\n  while (i < trimmed.length) {\n    const ch = trimmed[i];\n    if (ch === \"\\\\\") {\n      const next = trimmed[i + 1];\n      if (next) {\n        current += next;\n      }\n      i += 2;\n      continue;\n    }\n    if (ch === \".\") {\n      if (current) {\n        parts.push(current);\n      }\n      current = \"\";\n      i += 1;\n      continue;\n    }\n    if (ch === \"[\") {\n      if (current) {\n        parts.push(current);\n      }\n      current = \"\";\n      const close = trimmed.indexOf(\"]\", i);\n      if (close === -1) {\n        throw new Error(`Invalid path (missing \"]\"): ${raw}`);\n      }\n      const inside = trimmed.slice(i + 1, close).trim();\n      if (!inside) {\n        throw new Error(`Invalid path (empty \"[]\"): ${raw}`);\n      }\n      parts.push(inside);\n      i = close + 1;\n      continue;\n    }\n    current += ch;\n    i += 1;\n  }\n\n  if (current) {\n    parts.push(current);\n  }\n\n  return parts.map((part) => part.trim()).filter(Boolean);\n}\n\nexport function parseRequiredConfigPath(raw: string): string[] {\n  const parsedPath = parseConfigPath(raw);\n  if (parsedPath.length === 0) {\n    throw new Error(\"Path is empty.\");\n  }\n  return parsedPath;\n}\n\nexport function parseConfigSetValue(raw: string, opts: ConfigSetOptions): unknown {\n  const trimmed = raw.trim();\n  if (opts.json) {\n    return JSON.parse(trimmed);\n  }\n  try {\n    return JSON.parse(trimmed);\n  } catch {\n    return raw;\n  }\n}\n\nexport function getAtConfigPath(root: unknown, pathSegments: string[]): { found: boolean; value?: unknown } {\n  let current: unknown = root;\n  for (const segment of pathSegments) {\n    if (!current || typeof current !== \"object\") {\n      return { found: false };\n    }\n\n    if (Array.isArray(current)) {\n      if (!isIndexSegment(segment)) {\n        return { found: false };\n      }\n      const index = Number.parseInt(segment, 10);\n      if (!Number.isFinite(index) || index < 0 || index >= current.length) {\n        return { found: false };\n      }\n      current = current[index];\n      continue;\n    }\n\n    const record = current as Record<string, unknown>;\n    if (!Object.prototype.hasOwnProperty.call(record, segment)) {\n      return { found: false };\n    }\n    current = record[segment];\n  }\n\n  return { found: true, value: current };\n}\n\nexport function setAtConfigPath(root: Record<string, unknown>, pathSegments: string[], value: unknown): void {\n  let current: unknown = root;\n\n  for (let i = 0; i < pathSegments.length - 1; i += 1) {\n    const segment = pathSegments[i];\n    const next = pathSegments[i + 1];\n    const nextIsIndex = Boolean(next && isIndexSegment(next));\n\n    if (Array.isArray(current)) {\n      current = getOrCreateArraySegment(current, segment, nextIsIndex, pathSegments.slice(0, i));\n      continue;\n    }\n\n    current = getOrCreateObjectSegment(current, segment, nextIsIndex);\n  }\n\n  setConfigPathValue(current, pathSegments[pathSegments.length - 1], value, pathSegments.slice(0, -1));\n}\n\nfunction ensureWritableArrayIndex(current: unknown[], index: number, parentPath: string[]): void {\n  if (!Number.isFinite(index) || index < 0) {\n    throw new Error(`Invalid array index \"${index}\"`);\n  }\n  if (index <= current.length) {\n    return;\n  }\n  const parentPathExpr = formatConfigPath(parentPath);\n  const parentLabel = parentPathExpr ? `\"${parentPathExpr}\"` : \"the root array\";\n  throw new Error(`Cannot set sparse array index ${index} under ${parentLabel}. Set indices in order.`);\n}\n\nfunction getOrCreateArraySegment(\n  current: unknown[],\n  segment: string,\n  nextIsIndex: boolean,\n  parentPath: string[]\n): unknown {\n  const index = parseArrayIndexSegment(segment);\n  ensureWritableArrayIndex(current, index, parentPath);\n  const existing = current[index];\n  if (!existing || typeof existing !== \"object\") {\n    current[index] = nextIsIndex ? [] : {};\n  }\n  return current[index];\n}\n\nfunction getOrCreateObjectSegment(current: unknown, segment: string, nextIsIndex: boolean): unknown {\n  if (!current || typeof current !== \"object\") {\n    throw new Error(`Cannot traverse into \"${segment}\" (not an object)`);\n  }\n\n  const record = current as Record<string, unknown>;\n  const existing = record[segment];\n  if (!existing || typeof existing !== \"object\") {\n    record[segment] = nextIsIndex ? [] : {};\n  }\n  return record[segment];\n}\n\nfunction setConfigPathValue(current: unknown, last: string, value: unknown, parentPath: string[]): void {\n  if (Array.isArray(current)) {\n    const index = parseArrayIndexSegment(last);\n    ensureWritableArrayIndex(current, index, parentPath);\n    current[index] = value;\n    return;\n  }\n\n  if (!current || typeof current !== \"object\") {\n    throw new Error(`Cannot set \"${last}\" (parent is not an object)`);\n  }\n\n  (current as Record<string, unknown>)[last] = value;\n}\n\nfunction parseArrayIndexSegment(segment: string): number {\n  if (!isIndexSegment(segment)) {\n    throw new Error(`Expected numeric index for array segment \"${segment}\"`);\n  }\n  return Number.parseInt(segment, 10);\n}\n\nfunction formatConfigPath(pathSegments: string[]): string {\n  let expr = \"\";\n  for (const segment of pathSegments) {\n    if (isIndexSegment(segment)) {\n      expr += `[${segment}]`;\n      continue;\n    }\n    expr += expr ? `.${segment}` : segment;\n  }\n  return expr;\n}\n\nexport function unsetAtConfigPath(root: Record<string, unknown>, pathSegments: string[]): boolean {\n  let current: unknown = root;\n\n  for (let i = 0; i < pathSegments.length - 1; i += 1) {\n    const segment = pathSegments[i];\n    if (!current || typeof current !== \"object\") {\n      return false;\n    }\n\n    if (Array.isArray(current)) {\n      if (!isIndexSegment(segment)) {\n        return false;\n      }\n      const index = Number.parseInt(segment, 10);\n      if (!Number.isFinite(index) || index < 0 || index >= current.length) {\n        return false;\n      }\n      current = current[index];\n      continue;\n    }\n\n    const record = current as Record<string, unknown>;\n    if (!Object.prototype.hasOwnProperty.call(record, segment)) {\n      return false;\n    }\n    current = record[segment];\n  }\n\n  const last = pathSegments[pathSegments.length - 1];\n  if (Array.isArray(current)) {\n    if (!isIndexSegment(last)) {\n      return false;\n    }\n    const index = Number.parseInt(last, 10);\n    if (!Number.isFinite(index) || index < 0 || index >= current.length) {\n      return false;\n    }\n    current.splice(index, 1);\n    return true;\n  }\n\n  if (!current || typeof current !== \"object\") {\n    return false;\n  }\n\n  const record = current as Record<string, unknown>;\n  if (!Object.prototype.hasOwnProperty.call(record, last)) {\n    return false;\n  }\n  delete record[last];\n  return true;\n}\n"],"mappings":";AAEA,SAAgB,eAAe,KAAsB;AACnD,QAAO,WAAW,KAAK,IAAI;;AAG7B,SAAgB,gBAAgB,KAAuB;CACrD,MAAM,UAAU,IAAI,MAAM;AAC1B,KAAI,CAAC,QACH,QAAO,EAAE;CAGX,MAAM,QAAkB,EAAE;CAC1B,IAAI,UAAU;CACd,IAAI,IAAI;AAER,QAAO,IAAI,QAAQ,QAAQ;EACzB,MAAM,KAAK,QAAQ;AACnB,MAAI,OAAO,MAAM;GACf,MAAM,OAAO,QAAQ,IAAI;AACzB,OAAI,KACF,YAAW;AAEb,QAAK;AACL;;AAEF,MAAI,OAAO,KAAK;AACd,OAAI,QACF,OAAM,KAAK,QAAQ;AAErB,aAAU;AACV,QAAK;AACL;;AAEF,MAAI,OAAO,KAAK;AACd,OAAI,QACF,OAAM,KAAK,QAAQ;AAErB,aAAU;GACV,MAAM,QAAQ,QAAQ,QAAQ,KAAK,EAAE;AACrC,OAAI,UAAU,GACZ,OAAM,IAAI,MAAM,+BAA+B,MAAM;GAEvD,MAAM,SAAS,QAAQ,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM;AACjD,OAAI,CAAC,OACH,OAAM,IAAI,MAAM,8BAA8B,MAAM;AAEtD,SAAM,KAAK,OAAO;AAClB,OAAI,QAAQ;AACZ;;AAEF,aAAW;AACX,OAAK;;AAGP,KAAI,QACF,OAAM,KAAK,QAAQ;AAGrB,QAAO,MAAM,KAAK,SAAS,KAAK,MAAM,CAAC,CAAC,OAAO,QAAQ;;AAGzD,SAAgB,wBAAwB,KAAuB;CAC7D,MAAM,aAAa,gBAAgB,IAAI;AACvC,KAAI,WAAW,WAAW,EACxB,OAAM,IAAI,MAAM,iBAAiB;AAEnC,QAAO;;AAGT,SAAgB,oBAAoB,KAAa,MAAiC;CAChF,MAAM,UAAU,IAAI,MAAM;AAC1B,KAAI,KAAK,KACP,QAAO,KAAK,MAAM,QAAQ;AAE5B,KAAI;AACF,SAAO,KAAK,MAAM,QAAQ;SACpB;AACN,SAAO;;;AAIX,SAAgB,gBAAgB,MAAe,cAA6D;CAC1G,IAAI,UAAmB;AACvB,MAAK,MAAM,WAAW,cAAc;AAClC,MAAI,CAAC,WAAW,OAAO,YAAY,SACjC,QAAO,EAAE,OAAO,OAAO;AAGzB,MAAI,MAAM,QAAQ,QAAQ,EAAE;AAC1B,OAAI,CAAC,eAAe,QAAQ,CAC1B,QAAO,EAAE,OAAO,OAAO;GAEzB,MAAM,QAAQ,OAAO,SAAS,SAAS,GAAG;AAC1C,OAAI,CAAC,OAAO,SAAS,MAAM,IAAI,QAAQ,KAAK,SAAS,QAAQ,OAC3D,QAAO,EAAE,OAAO,OAAO;AAEzB,aAAU,QAAQ;AAClB;;EAGF,MAAM,SAAS;AACf,MAAI,CAAC,OAAO,UAAU,eAAe,KAAK,QAAQ,QAAQ,CACxD,QAAO,EAAE,OAAO,OAAO;AAEzB,YAAU,OAAO;;AAGnB,QAAO;EAAE,OAAO;EAAM,OAAO;EAAS;;AAGxC,SAAgB,gBAAgB,MAA+B,cAAwB,OAAsB;CAC3G,IAAI,UAAmB;AAEvB,MAAK,IAAI,IAAI,GAAG,IAAI,aAAa,SAAS,GAAG,KAAK,GAAG;EACnD,MAAM,UAAU,aAAa;EAC7B,MAAM,OAAO,aAAa,IAAI;EAC9B,MAAM,cAAc,QAAQ,QAAQ,eAAe,KAAK,CAAC;AAEzD,MAAI,MAAM,QAAQ,QAAQ,EAAE;AAC1B,aAAU,wBAAwB,SAAS,SAAS,aAAa,aAAa,MAAM,GAAG,EAAE,CAAC;AAC1F;;AAGF,YAAU,yBAAyB,SAAS,SAAS,YAAY;;AAGnE,oBAAmB,SAAS,aAAa,aAAa,SAAS,IAAI,OAAO,aAAa,MAAM,GAAG,GAAG,CAAC;;AAGtG,SAAS,yBAAyB,SAAoB,OAAe,YAA4B;AAC/F,KAAI,CAAC,OAAO,SAAS,MAAM,IAAI,QAAQ,EACrC,OAAM,IAAI,MAAM,wBAAwB,MAAM,GAAG;AAEnD,KAAI,SAAS,QAAQ,OACnB;CAEF,MAAM,iBAAiB,iBAAiB,WAAW;CACnD,MAAM,cAAc,iBAAiB,IAAI,eAAe,KAAK;AAC7D,OAAM,IAAI,MAAM,iCAAiC,MAAM,SAAS,YAAY,yBAAyB;;AAGvG,SAAS,wBACP,SACA,SACA,aACA,YACS;CACT,MAAM,QAAQ,uBAAuB,QAAQ;AAC7C,0BAAyB,SAAS,OAAO,WAAW;CACpD,MAAM,WAAW,QAAQ;AACzB,KAAI,CAAC,YAAY,OAAO,aAAa,SACnC,SAAQ,SAAS,cAAc,EAAE,GAAG,EAAE;AAExC,QAAO,QAAQ;;AAGjB,SAAS,yBAAyB,SAAkB,SAAiB,aAA+B;AAClG,KAAI,CAAC,WAAW,OAAO,YAAY,SACjC,OAAM,IAAI,MAAM,yBAAyB,QAAQ,mBAAmB;CAGtE,MAAM,SAAS;CACf,MAAM,WAAW,OAAO;AACxB,KAAI,CAAC,YAAY,OAAO,aAAa,SACnC,QAAO,WAAW,cAAc,EAAE,GAAG,EAAE;AAEzC,QAAO,OAAO;;AAGhB,SAAS,mBAAmB,SAAkB,MAAc,OAAgB,YAA4B;AACtG,KAAI,MAAM,QAAQ,QAAQ,EAAE;EAC1B,MAAM,QAAQ,uBAAuB,KAAK;AAC1C,2BAAyB,SAAS,OAAO,WAAW;AACpD,UAAQ,SAAS;AACjB;;AAGF,KAAI,CAAC,WAAW,OAAO,YAAY,SACjC,OAAM,IAAI,MAAM,eAAe,KAAK,6BAA6B;AAGlE,SAAoC,QAAQ;;AAG/C,SAAS,uBAAuB,SAAyB;AACvD,KAAI,CAAC,eAAe,QAAQ,CAC1B,OAAM,IAAI,MAAM,6CAA6C,QAAQ,GAAG;AAE1E,QAAO,OAAO,SAAS,SAAS,GAAG;;AAGrC,SAAS,iBAAiB,cAAgC;CACxD,IAAI,OAAO;AACX,MAAK,MAAM,WAAW,cAAc;AAClC,MAAI,eAAe,QAAQ,EAAE;AAC3B,WAAQ,IAAI,QAAQ;AACpB;;AAEF,UAAQ,OAAO,IAAI,YAAY;;AAEjC,QAAO;;AAGT,SAAgB,kBAAkB,MAA+B,cAAiC;CAChG,IAAI,UAAmB;AAEvB,MAAK,IAAI,IAAI,GAAG,IAAI,aAAa,SAAS,GAAG,KAAK,GAAG;EACnD,MAAM,UAAU,aAAa;AAC7B,MAAI,CAAC,WAAW,OAAO,YAAY,SACjC,QAAO;AAGT,MAAI,MAAM,QAAQ,QAAQ,EAAE;AAC1B,OAAI,CAAC,eAAe,QAAQ,CAC1B,QAAO;GAET,MAAM,QAAQ,OAAO,SAAS,SAAS,GAAG;AAC1C,OAAI,CAAC,OAAO,SAAS,MAAM,IAAI,QAAQ,KAAK,SAAS,QAAQ,OAC3D,QAAO;AAET,aAAU,QAAQ;AAClB;;EAGF,MAAM,SAAS;AACf,MAAI,CAAC,OAAO,UAAU,eAAe,KAAK,QAAQ,QAAQ,CACxD,QAAO;AAET,YAAU,OAAO;;CAGnB,MAAM,OAAO,aAAa,aAAa,SAAS;AAChD,KAAI,MAAM,QAAQ,QAAQ,EAAE;AAC1B,MAAI,CAAC,eAAe,KAAK,CACvB,QAAO;EAET,MAAM,QAAQ,OAAO,SAAS,MAAM,GAAG;AACvC,MAAI,CAAC,OAAO,SAAS,MAAM,IAAI,QAAQ,KAAK,SAAS,QAAQ,OAC3D,QAAO;AAET,UAAQ,OAAO,OAAO,EAAE;AACxB,SAAO;;AAGT,KAAI,CAAC,WAAW,OAAO,YAAY,SACjC,QAAO;CAGT,MAAM,SAAS;AACf,KAAI,CAAC,OAAO,UAAU,eAAe,KAAK,QAAQ,KAAK,CACrD,QAAO;AAET,QAAO,OAAO;AACd,QAAO"}

package/dist/utils/cron/cron-job.utils.d.ts

@@ -0,0 +1,28 @@
+//#region src/utils/cron/cron-job.utils.d.ts
+type CronSchedule = {
+  kind: "every";
+  everyMs?: number | null;
+} | {
+  kind: "cron";
+  expr?: string | null;
+} | {
+  kind: "at";
+  atMs?: number | null;
+};
+type CronPayload = {
+  message: string;
+  agentId?: string | null;
+  sessionId?: string | null;
+};
+type CronJobView = {
+  id: string;
+  name: string;
+  enabled: boolean;
+  schedule: CronSchedule;
+  payload: CronPayload;
+};
+declare function formatCronSchedule(schedule: CronSchedule): string;
+declare function printCronJobs(jobs: CronJobView[]): void;
+//#endregion
+export { CronJobView, CronPayload, CronSchedule, formatCronSchedule, printCronJobs };
+//# sourceMappingURL=cron-job.utils.d.ts.map

package/dist/utils/cron/cron-job.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron-job.utils.d.ts","names":[],"sources":["../../../src/utils/cron/cron-job.utils.ts"],"mappings":";KAAY,YAAA;EACN,IAAA;EAAe,OAAA;AAAA;EACf,IAAA;EAAc,IAAA;AAAA;EACd,IAAA;EAAY,IAAA;AAAA;AAAA,KAEN,WAAA;EACV,OAAA;EACA,OAAA;EACA,SAAA;AAAA;AAAA,KAGU,WAAA;EACV,EAAA;EACA,IAAA;EACA,OAAA;EACA,QAAA,EAAU,YAAA;EACV,OAAA,EAAS,WAAA;AAAA;AAAA,iBAGK,kBAAA,CAAmB,QAAA,EAAU,YAAA;AAAA,iBAU7B,aAAA,CAAc,IAAA,EAAM,WAAA"}

package/dist/utils/cron/cron-job.utils.js

@@ -0,0 +1,17 @@
+//#region src/utils/cron/cron-job.utils.ts
+function formatCronSchedule(schedule) {
+	if (schedule.kind === "every") return `every ${Math.round((schedule.everyMs ?? 0) / 1e3)}s`;
+	if (schedule.kind === "cron") return schedule.expr ?? "";
+	return schedule.atMs ? new Date(schedule.atMs).toISOString() : "";
+}
+function printCronJobs(jobs) {
+	if (!jobs.length) {
+		console.log("No scheduled jobs.");
+		return;
+	}
+	for (const job of jobs) console.log(`${job.id} [${job.enabled ? "enabled" : "disabled"}] ${job.name} ${formatCronSchedule(job.schedule)}`);
+}
+//#endregion
+export { formatCronSchedule, printCronJobs };
+
+//# sourceMappingURL=cron-job.utils.js.map

package/dist/utils/cron/cron-job.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron-job.utils.js","names":[],"sources":["../../../src/utils/cron/cron-job.utils.ts"],"sourcesContent":["export type CronSchedule =\n  | { kind: \"every\"; everyMs?: number | null }\n  | { kind: \"cron\"; expr?: string | null }\n  | { kind: \"at\"; atMs?: number | null };\n\nexport type CronPayload = {\n  message: string;\n  agentId?: string | null;\n  sessionId?: string | null;\n};\n\nexport type CronJobView = {\n  id: string;\n  name: string;\n  enabled: boolean;\n  schedule: CronSchedule;\n  payload: CronPayload;\n};\n\nexport function formatCronSchedule(schedule: CronSchedule): string {\n  if (schedule.kind === \"every\") {\n    return `every ${Math.round((schedule.everyMs ?? 0) / 1000)}s`;\n  }\n  if (schedule.kind === \"cron\") {\n    return schedule.expr ?? \"\";\n  }\n  return schedule.atMs ? new Date(schedule.atMs).toISOString() : \"\";\n}\n\nexport function printCronJobs(jobs: CronJobView[]): void {\n  if (!jobs.length) {\n    console.log(\"No scheduled jobs.\");\n    return;\n  }\n  for (const job of jobs) {\n    console.log(`${job.id} [${job.enabled ? \"enabled\" : \"disabled\"}] ${job.name} ${formatCronSchedule(job.schedule)}`);\n  }\n}\n"],"mappings":";AAmBA,SAAgB,mBAAmB,UAAgC;AACjE,KAAI,SAAS,SAAS,QACpB,QAAO,SAAS,KAAK,OAAO,SAAS,WAAW,KAAK,IAAK,CAAC;AAE7D,KAAI,SAAS,SAAS,OACpB,QAAO,SAAS,QAAQ;AAE1B,QAAO,SAAS,OAAO,IAAI,KAAK,SAAS,KAAK,CAAC,aAAa,GAAG;;AAGjE,SAAgB,cAAc,MAA2B;AACvD,KAAI,CAAC,KAAK,QAAQ;AAChB,UAAQ,IAAI,qBAAqB;AACjC;;AAEF,MAAK,MAAM,OAAO,KAChB,SAAQ,IAAI,GAAG,IAAI,GAAG,IAAI,IAAI,UAAU,YAAY,WAAW,IAAI,IAAI,KAAK,GAAG,mBAAmB,IAAI,SAAS,GAAG"}

package/dist/utils/diagnostics/diagnostics-render.utils.d.ts

@@ -0,0 +1,24 @@
+import { RuntimeStatusReport } from "../../types/cli.types.js";
+
+//#region src/utils/diagnostics/diagnostics-render.utils.d.ts
+type DoctorCheck = {
+  name: string;
+  status: "pass" | "warn" | "fail";
+  detail: string;
+};
+declare function printStatusReport(params: {
+  logo: string;
+  report: RuntimeStatusReport;
+  verbose: boolean;
+}): void;
+declare function printDoctorReport(params: {
+  logo: string;
+  generatedAt: string;
+  checks: DoctorCheck[];
+  recommendations: string[];
+  verbose: boolean;
+  logTail: string[];
+}): void;
+//#endregion
+export { DoctorCheck, printDoctorReport, printStatusReport };
+//# sourceMappingURL=diagnostics-render.utils.d.ts.map

package/dist/utils/diagnostics/diagnostics-render.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics-render.utils.d.ts","names":[],"sources":["../../../src/utils/diagnostics/diagnostics-render.utils.ts"],"mappings":";;;KAGY,WAAA;EACV,IAAA;EACA,MAAA;EACA,MAAA;AAAA;AAAA,iBAGc,iBAAA,CAAkB,MAAA;EAChC,IAAA;EACA,MAAA,EAAQ,mBAAA;EACR,OAAA;AAAA;AAAA,iBA0Ec,iBAAA,CAAkB,MAAA;EAChC,IAAA;EACA,WAAA;EACA,MAAA,EAAQ,WAAA;EACR,eAAA;EACA,OAAA;EACA,OAAA;AAAA"}