@downcity/city 1.1.4 → 1.1.5

package/bin/process/registry/CityRegistry.js

@@ -0,0 +1,217 @@
+/**
+ * CityRegistry：city 后台维护的 agent registry（`~/.downcity/main/agents.json`）。
+ *
+ * 关键点（中文）
+ * - registry 只维护“city 认知到的 agent 项目列表”，用于统一观测与批量管理。
+ * - registry 不承载实时健康检查：status/list 会读取每个项目的 daemon pid 并判活。
+ * - agent daemon 启动成功后必须登记到 city 后台（强约束）。
+ */
+import fs from "fs-extra";
+import path from "node:path";
+import { getManagedAgentRegistryPath, getCityRuntimeDirPath } from "./CityPaths.js";
+import { isCityRunning } from "./CityRuntime.js";
+const CONSOLE_DIR = getCityRuntimeDirPath();
+const MANAGED_AGENTS_FILE = getManagedAgentRegistryPath();
+function buildEmptyRegistry() {
+    return {
+        v: 1,
+        updatedAt: new Date().toISOString(),
+        agents: [],
+    };
+}
+function normalizeProjectRoot(projectRoot) {
+    const resolved = path.resolve(String(projectRoot || "").trim());
+    if (!resolved)
+        throw new Error("projectRoot is required");
+    return resolved;
+}
+function normalizePid(pid) {
+    if (!Number.isFinite(pid) || Number.isNaN(pid) || !Number.isInteger(pid) || pid < 1) {
+        throw new Error(`Invalid pid: ${pid}`);
+    }
+    return pid;
+}
+function normalizeIsoTime(input) {
+    const value = String(input || "").trim();
+    if (!value)
+        return new Date().toISOString();
+    const ms = Date.parse(value);
+    if (!Number.isFinite(ms))
+        return new Date().toISOString();
+    return new Date(ms).toISOString();
+}
+function normalizeRegistryEntry(entry) {
+    try {
+        const projectRoot = normalizeProjectRoot(String(entry.projectRoot || ""));
+        const pid = normalizePid(Number(entry.pid));
+        const startedAt = normalizeIsoTime(typeof entry.startedAt === "string" ? entry.startedAt : undefined);
+        const updatedAt = normalizeIsoTime(typeof entry.updatedAt === "string" ? entry.updatedAt : undefined);
+        return {
+            projectRoot,
+            pid,
+            startedAt,
+            updatedAt,
+            status: entry.status === "stopped"
+                ? "stopped"
+                : "running",
+            stoppedAt: entry.status === "stopped"
+                ? normalizeIsoTime(typeof entry.stoppedAt === "string"
+                    ? entry.stoppedAt
+                    : undefined)
+                : undefined,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+function normalizeRegistry(value) {
+    if (!value || typeof value !== "object")
+        return buildEmptyRegistry();
+    const source = Array.isArray(value.agents) ? value.agents : [];
+    const normalizedAgents = [];
+    for (const item of source) {
+        if (!item || typeof item !== "object")
+            continue;
+        const normalized = normalizeRegistryEntry(item);
+        if (!normalized)
+            continue;
+        const existingIndex = normalizedAgents.findIndex((entry) => entry.projectRoot === normalized.projectRoot);
+        if (existingIndex >= 0) {
+            normalizedAgents[existingIndex] = normalized;
+            continue;
+        }
+        normalizedAgents.push(normalized);
+    }
+    return {
+        v: 1,
+        updatedAt: normalizeIsoTime(typeof value.updatedAt === "string" ? value.updatedAt : undefined),
+        agents: normalizedAgents.sort((a, b) => a.projectRoot.localeCompare(b.projectRoot)),
+    };
+}
+async function writeManagedAgentRegistry(registry) {
+    await fs.ensureDir(CONSOLE_DIR);
+    await fs.writeJson(MANAGED_AGENTS_FILE, normalizeRegistry(registry), {
+        spaces: 2,
+    });
+}
+/**
+ * 确保 city agent registry 文件存在。
+ *
+ * 关键点（中文）
+ * - 空 city 运行态也应拥有显式的空 registry，避免 Console 将“尚未启动任何 agent”误判为异常。
+ * - 若文件已存在则不覆盖，保持历史记录不丢失。
+ */
+export async function ensureManagedAgentRegistry() {
+    await fs.ensureDir(CONSOLE_DIR);
+    if (await fs.pathExists(MANAGED_AGENTS_FILE)) {
+        return;
+    }
+    await writeManagedAgentRegistry(buildEmptyRegistry());
+}
+/**
+ * 获取 city agent registry 文件路径。
+ */
+export function getManagedAgentsRegistryPath() {
+    return MANAGED_AGENTS_FILE;
+}
+/**
+ * 读取 city agent registry（容错）。
+ *
+ * 关键点（中文）
+ * - 文件不存在或损坏时返回空 registry，避免影响主流程。
+ */
+export async function readManagedAgentRegistry() {
+    try {
+        if (!(await fs.pathExists(MANAGED_AGENTS_FILE))) {
+            return buildEmptyRegistry();
+        }
+        const raw = (await fs.readJson(MANAGED_AGENTS_FILE));
+        return normalizeRegistry(raw);
+    }
+    catch {
+        return buildEmptyRegistry();
+    }
+}
+/**
+ * 列出 city registry 中记录的 agent（按 projectRoot 排序）。
+ */
+export async function listManagedAgentEntries() {
+    const registry = await readManagedAgentRegistry();
+    return [...registry.agents].sort((a, b) => a.projectRoot.localeCompare(b.projectRoot));
+}
+/**
+ * 新增或更新一条 city agent 记录。
+ */
+export async function upsertManagedAgentEntry(input) {
+    // 关键点（中文）：agent 必须登记到 city 后台才“有效”，因此 city 未启动时拒绝写入 registry。
+    if (!(await isCityRunning())) {
+        throw new Error("city runtime is not running");
+    }
+    const projectRoot = normalizeProjectRoot(input.projectRoot);
+    const pid = normalizePid(input.pid);
+    const nowIso = new Date().toISOString();
+    const registry = await readManagedAgentRegistry();
+    const index = registry.agents.findIndex((entry) => entry.projectRoot === projectRoot);
+    if (index >= 0) {
+        const existing = registry.agents[index];
+        registry.agents[index] = {
+            projectRoot,
+            pid,
+            startedAt: normalizeIsoTime(existing.startedAt || input.startedAt),
+            updatedAt: nowIso,
+            status: input.status === "stopped" ? "stopped" : "running",
+            stoppedAt: input.status === "stopped"
+                ? normalizeIsoTime(input.stoppedAt || nowIso)
+                : undefined,
+        };
+    }
+    else {
+        registry.agents.push({
+            projectRoot,
+            pid,
+            startedAt: normalizeIsoTime(input.startedAt),
+            updatedAt: nowIso,
+            status: input.status === "stopped" ? "stopped" : "running",
+            stoppedAt: input.status === "stopped"
+                ? normalizeIsoTime(input.stoppedAt || nowIso)
+                : undefined,
+        });
+    }
+    registry.updatedAt = nowIso;
+    await writeManagedAgentRegistry(registry);
+}
+/**
+ * 标记 agent 为 stopped（保留历史记录，不删除）。
+ */
+export async function markManagedAgentStopped(projectRoot) {
+    const key = normalizeProjectRoot(projectRoot);
+    const registry = await readManagedAgentRegistry();
+    const index = registry.agents.findIndex((entry) => entry.projectRoot === key);
+    if (index < 0)
+        return;
+    const nowIso = new Date().toISOString();
+    const current = registry.agents[index];
+    registry.agents[index] = {
+        ...current,
+        status: "stopped",
+        stoppedAt: nowIso,
+        updatedAt: nowIso,
+    };
+    registry.updatedAt = nowIso;
+    await writeManagedAgentRegistry(registry);
+}
+/**
+ * 按 projectRoot 移除一条 agent 记录。
+ */
+export async function removeManagedAgentEntry(projectRoot) {
+    const key = normalizeProjectRoot(projectRoot);
+    const registry = await readManagedAgentRegistry();
+    const nextAgents = registry.agents.filter((entry) => entry.projectRoot !== key);
+    if (nextAgents.length === registry.agents.length)
+        return;
+    registry.agents = nextAgents;
+    registry.updatedAt = new Date().toISOString();
+    await writeManagedAgentRegistry(registry);
+}
+//# sourceMappingURL=CityRegistry.js.map

package/bin/process/registry/CityRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CityRegistry.js","sourceRoot":"","sources":["../../../src/process/registry/CityRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,IAAI,MAAM,WAAW,CAAC;AAK7B,OAAO,EAAE,2BAA2B,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACpF,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,MAAM,WAAW,GAAG,qBAAqB,EAAE,CAAC;AAC5C,MAAM,mBAAmB,GAAG,2BAA2B,EAAE,CAAC;AAE1D,SAAS,kBAAkB;IACzB,OAAO;QACL,CAAC,EAAE,CAAC;QACJ,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,MAAM,EAAE,EAAE;KACX,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB,CAAC,WAAmB;IAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAChE,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC1D,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,YAAY,CAAC,GAAW;IAC/B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,EAAE,CAAC;QACpF,MAAM,IAAI,KAAK,CAAC,gBAAgB,GAAG,EAAE,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAyB;IACjD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACzC,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC5C,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC7B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QAAE,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC1D,OAAO,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;AACpC,CAAC;AAED,SAAS,sBAAsB,CAC7B,KAAyC;IAEzC,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,oBAAoB,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,CAAC;QAC1E,MAAM,GAAG,GAAG,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5C,MAAM,SAAS,GAAG,gBAAgB,CAChC,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAClE,CAAC;QACF,MAAM,SAAS,GAAG,gBAAgB,CAChC,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAClE,CAAC;QACF,OAAO;YACL,WAAW;YACX,GAAG;YACH,SAAS;YACT,SAAS;YACT,MAAM,EACJ,KAAK,CAAC,MAAM,KAAK,SAAS;gBACxB,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,SAAS;YACf,SAAS,EACP,KAAK,CAAC,MAAM,KAAK,SAAS;gBACxB,CAAC,CAAC,gBAAgB,CACd,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ;oBACjC,CAAC,CAAC,KAAK,CAAC,SAAS;oBACjB,CAAC,CAAC,SAAS,CACd;gBACH,CAAC,CAAC,SAAS;SAChB,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CACxB,KAAyD;IAEzD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,kBAAkB,EAAE,CAAC;IACrE,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/D,MAAM,gBAAgB,GAAgC,EAAE,CAAC;IACzD,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;QAC1B,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,SAAS;QAChD,MAAM,UAAU,GAAG,sBAAsB,CAAC,IAAiC,CAAC,CAAC;QAC7E,IAAI,CAAC,UAAU;YAAE,SAAS;QAC1B,MAAM,aAAa,GAAG,gBAAgB,CAAC,SAAS,CAC9C,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,KAAK,UAAU,CAAC,WAAW,CACxD,CAAC;QACF,IAAI,aAAa,IAAI,CAAC,EAAE,CAAC;YACvB,gBAAgB,CAAC,aAAa,CAAC,GAAG,UAAU,CAAC;YAC7C,SAAS;QACX,CAAC;QACD,gBAAgB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACpC,CAAC;IACD,OAAO;QACL,CAAC,EAAE,CAAC;QACJ,SAAS,EAAE,gBAAgB,CACzB,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAClE;QACD,MAAM,EAAE,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACrC,CAAC,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,CAAC,WAAW,CAAC,CAC3C;KACF,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,yBAAyB,CACtC,QAAgC;IAEhC,MAAM,EAAE,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAChC,MAAM,EAAE,CAAC,SAAS,CAAC,mBAAmB,EAAE,iBAAiB,CAAC,QAAQ,CAAC,EAAE;QACnE,MAAM,EAAE,CAAC;KACV,CAAC,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B;IAC9C,MAAM,EAAE,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IAChC,IAAI,MAAM,EAAE,CAAC,UAAU,CAAC,mBAAmB,CAAC,EAAE,CAAC;QAC7C,OAAO;IACT,CAAC;IACD,MAAM,yBAAyB,CAAC,kBAAkB,EAAE,CAAC,CAAC;AACxD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,4BAA4B;IAC1C,OAAO,mBAAmB,CAAC;AAC7B,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB;IAC5C,IAAI,CAAC;QACH,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC,EAAE,CAAC;YAChD,OAAO,kBAAkB,EAAE,CAAC;QAC9B,CAAC;QACD,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAoC,CAAC;QACxF,OAAO,iBAAiB,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,kBAAkB,EAAE,CAAC;IAC9B,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB;IAC3C,MAAM,QAAQ,GAAG,MAAM,wBAAwB,EAAE,CAAC;IAClD,OAAO,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC;AACzF,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,KAM7C;IACC,8DAA8D;IAC9D,IAAI,CAAC,CAAC,MAAM,aAAa,EAAE,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACjD,CAAC;IAED,MAAM,WAAW,GAAG,oBAAoB,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAC5D,MAAM,GAAG,GAAG,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACpC,MAAM,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAExC,MAAM,QAAQ,GAAG,MAAM,wBAAwB,EAAE,CAAC;IAClD,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,KAAK,WAAW,CAAC,CAAC;IACtF,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QACf,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACxC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG;YACvB,WAAW;YACX,GAAG;YACH,SAAS,EAAE,gBAAgB,CAAC,QAAQ,CAAC,SAAS,IAAI,KAAK,CAAC,SAAS,CAAC;YAClE,SAAS,EAAE,MAAM;YACjB,MAAM,EAAE,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;YAC1D,SAAS,EACP,KAAK,CAAC,MAAM,KAAK,SAAS;gBACxB,CAAC,CAAC,gBAAgB,CAAC,KAAK,CAAC,SAAS,IAAI,MAAM,CAAC;gBAC7C,CAAC,CAAC,SAAS;SAChB,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC;YACnB,WAAW;YACX,GAAG;YACH,SAAS,EAAE,gBAAgB,CAAC,KAAK,CAAC,SAAS,CAAC;YAC5C,SAAS,EAAE,MAAM;YACjB,MAAM,EAAE,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;YAC1D,SAAS,EACP,KAAK,CAAC,MAAM,KAAK,SAAS;gBACxB,CAAC,CAAC,gBAAgB,CAAC,KAAK,CAAC,SAAS,IAAI,MAAM,CAAC;gBAC7C,CAAC,CAAC,SAAS;SAChB,CAAC,CAAC;IACL,CAAC;IAED,QAAQ,CAAC,SAAS,GAAG,MAAM,CAAC;IAC5B,MAAM,yBAAyB,CAAC,QAAQ,CAAC,CAAC;AAC5C,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,WAAmB;IAC/D,MAAM,GAAG,GAAG,oBAAoB,CAAC,WAAW,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,MAAM,wBAAwB,EAAE,CAAC;IAClD,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,KAAK,GAAG,CAAC,CAAC;IAC9E,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO;IACtB,MAAM,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACxC,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG;QACvB,GAAG,OAAO;QACV,MAAM,EAAE,SAAS;QACjB,SAAS,EAAE,MAAM;QACjB,SAAS,EAAE,MAAM;KAClB,CAAC;IACF,QAAQ,CAAC,SAAS,GAAG,MAAM,CAAC;IAC5B,MAAM,yBAAyB,CAAC,QAAQ,CAAC,CAAC;AAC5C,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,WAAmB;IAC/D,MAAM,GAAG,GAAG,oBAAoB,CAAC,WAAW,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,MAAM,wBAAwB,EAAE,CAAC;IAClD,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,KAAK,GAAG,CAAC,CAAC;IAChF,IAAI,UAAU,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM,CAAC,MAAM;QAAE,OAAO;IACzD,QAAQ,CAAC,MAAM,GAAG,UAAU,CAAC;IAC7B,QAAQ,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC9C,MAAM,yBAAyB,CAAC,QAAQ,CAAC,CAAC;AAC5C,CAAC"}

package/bin/process/registry/CityRuntime.d.ts

@@ -0,0 +1,21 @@
+/**
+ * CityRuntime：city 后台进程状态工具。
+ *
+ * 关键点（中文）
+ * - city 后台负责统一管理/观测多个 agent daemon。
+ * - 这里处理的是 city 后台自身的 pid 与判活，不涉及 control plane 进程。
+ * - agent daemon 启动前必须确保 city 后台已启动（强约束）。
+ */
+/**
+ * 读取 city 后台 pid（读取失败或内容非法返回 null）。
+ */
+export declare function readCityPid(): Promise<number | null>;
+/**
+ * 判断 city 后台进程是否存活。
+ */
+export declare function isCityProcessAlive(pid: number): boolean;
+/**
+ * 判断 city 后台是否在运行（基于 pid file + 判活）。
+ */
+export declare function isCityRunning(): Promise<boolean>;
+//# sourceMappingURL=CityRuntime.d.ts.map

package/bin/process/registry/CityRuntime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CityRuntime.d.ts","sourceRoot":"","sources":["../../../src/process/registry/CityRuntime.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH;;GAEG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQ1D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAOvD;AAED;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC,CAItD"}

package/bin/process/registry/CityRuntime.js

@@ -0,0 +1,45 @@
+/**
+ * CityRuntime：city 后台进程状态工具。
+ *
+ * 关键点（中文）
+ * - city 后台负责统一管理/观测多个 agent daemon。
+ * - 这里处理的是 city 后台自身的 pid 与判活，不涉及 control plane 进程。
+ * - agent daemon 启动前必须确保 city 后台已启动（强约束）。
+ */
+import fs from "fs-extra";
+import { getCityPidPath } from "./CityPaths.js";
+/**
+ * 读取 city 后台 pid（读取失败或内容非法返回 null）。
+ */
+export async function readCityPid() {
+    try {
+        const raw = await fs.readFile(getCityPidPath(), "utf-8");
+        const pid = Number.parseInt(String(raw).trim(), 10);
+        return Number.isFinite(pid) && pid > 0 ? pid : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 判断 city 后台进程是否存活。
+ */
+export function isCityProcessAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * 判断 city 后台是否在运行（基于 pid file + 判活）。
+ */
+export async function isCityRunning() {
+    const pid = await readCityPid();
+    if (!pid)
+        return false;
+    return isCityProcessAlive(pid);
+}
+//# sourceMappingURL=CityRuntime.js.map

package/bin/process/registry/CityRuntime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CityRuntime.js","sourceRoot":"","sources":["../../../src/process/registry/CityRuntime.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,cAAc,EAAE,EAAE,OAAO,CAAC,CAAC;QACzD,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QACpD,OAAO,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;IACtD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,MAAM,GAAG,GAAG,MAAM,WAAW,EAAE,CAAC;IAChC,IAAI,CAAC,GAAG;QAAE,OAAO,KAAK,CAAC;IACvB,OAAO,kBAAkB,CAAC,GAAG,CAAC,CAAC;AACjC,CAAC"}

package/bin/process/registry/PluginRuntime.d.ts

@@ -0,0 +1,24 @@
+/**
+ * PluginRuntime：city 级 plugin 运行时注入模块。
+ *
+ * 关键点（中文）
+ * - PluginRegistry / PluginManager 属于 city runtime，不应直接反向 import agent AgentContext 单例。
+ * - 当前模块只负责保存“当前执行上下文 resolver”的注入入口。
+ * - agent runtime 仅作为 context provider 注册方，不再成为 plugin manager 的宿主。
+ */
+import type { AgentContext } from "@downcity/agent";
+type AgentContextResolver = () => AgentContext;
+/**
+ * 设置当前 city plugin runtime 的执行上下文 resolver。
+ */
+export declare function setPluginRuntimeContextResolver(resolver: AgentContextResolver): void;
+/**
+ * 清理当前 city plugin runtime 的执行上下文 resolver。
+ */
+export declare function clearPluginRuntimeContextResolver(): void;
+/**
+ * 读取当前 city plugin runtime 的执行上下文 resolver。
+ */
+export declare function getPluginRuntimeContextResolver(): AgentContextResolver;
+export {};
+//# sourceMappingURL=PluginRuntime.d.ts.map

package/bin/process/registry/PluginRuntime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginRuntime.d.ts","sourceRoot":"","sources":["../../../src/process/registry/PluginRuntime.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,KAAK,oBAAoB,GAAG,MAAM,YAAY,CAAC;AAI/C;;GAEG;AACH,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,oBAAoB,GAC7B,IAAI,CAEN;AAED;;GAEG;AACH,wBAAgB,iCAAiC,IAAI,IAAI,CAExD;AAED;;GAEG;AACH,wBAAgB,+BAA+B,IAAI,oBAAoB,CAOtE"}

package/bin/process/registry/PluginRuntime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginRuntime.js","sourceRoot":"","sources":["../../../src/process/registry/PluginRuntime.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,IAAI,wBAAwB,GAAgC,IAAI,CAAC;AAEjE;;GAEG;AACH,MAAM,UAAU,+BAA+B,CAC7C,QAA8B;IAE9B,wBAAwB,GAAG,QAAQ,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iCAAiC;IAC/C,wBAAwB,GAAG,IAAI,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,+BAA+B;IAC7C,IAAI,CAAC,wBAAwB,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CACb,8GAA8G,CAC/G,CAAC;IACJ,CAAC;IACD,OAAO,wBAAwB,CAAC;AAClC,CAAC"}

package/bin/process/registry/ProcessSweep.d.ts

@@ -0,0 +1,76 @@
+/**
+ * 孤儿进程清扫工具。
+ *
+ * 关键点（中文）
+ * - 处理“pid 文件不存在，但旧的 detached 进程还活着”的场景。
+ * - 仅匹配 Downcity CLI 自己拉起的 `run` / `console run` / `agent start --foreground true`。
+ * - 作为 stop/start 的兜底清理层，避免旧版本进程占住端口却无法被当前 pid 文件追踪。
+ * - `run` 指 city 后台，`console run` 指 control plane 命令，二者需要明确区分。
+ */
+/**
+ * 构建 detached 进程停机时的信号目标。
+ *
+ * 关键点（中文）
+ * - POSIX 下 `detached: true` 会让子进程成为新的进程组 leader。
+ * - `-pid` 表示向整个进程组发信号，可覆盖 ACP、shell、watcher 等孙进程。
+ * - Windows 不支持负 pid 进程组语义，只能回退到单 pid。
+ */
+export declare function buildDetachedProcessSignalTargets(pid: number): number[];
+/**
+ * 向 detached 进程发送信号。
+ *
+ * 关键点（中文）
+ * - 优先发送到进程组；失败后再尝试单 pid。
+ * - 返回值只表示至少有一个目标接收到了信号，不代表进程已经退出。
+ */
+export declare function signalDetachedProcess(pid: number, signal: NodeJS.Signals): boolean;
+export declare function isDowncityCliCommand(command: string): boolean;
+/**
+ * 判断命令行是否属于本次清扫目标。
+ *
+ * 关键点（中文）
+ * - `Index.js run` 是 city runtime。
+ * - `Index.js console run` 是 control plane runtime。
+ * - 两者都包含 `run`，因此必须按完整子命令匹配，不能只查 `run` 词元。
+ */
+export declare function shouldSweepDetachedCityCommand(command: string, params: {
+    includeConsole?: boolean;
+    includeUi?: boolean;
+    includeAgent?: boolean;
+}): boolean;
+/**
+ * 只探测失联的 Downcity detached 进程，不执行停止动作。
+ */
+export declare function findDetachedCityProcesses(params?: {
+    includeConsole?: boolean;
+    includeUi?: boolean;
+    includeAgent?: boolean;
+    excludePids?: number[];
+}): Promise<Array<{
+    pid: number;
+    command: string;
+}>>;
+/**
+ * 清扫失联的 Downcity detached 进程。
+ */
+export declare function sweepDetachedCityProcesses(params?: {
+    includeConsole?: boolean;
+    includeUi?: boolean;
+    includeAgent?: boolean;
+    timeoutMs?: number;
+    excludePids?: number[];
+}): Promise<{
+    matched: Array<{
+        pid: number;
+        command: string;
+    }>;
+    stopped: Array<{
+        pid: number;
+        command: string;
+    }>;
+    alive: Array<{
+        pid: number;
+        command: string;
+    }>;
+}>;
+//# sourceMappingURL=ProcessSweep.d.ts.map

package/bin/process/registry/ProcessSweep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProcessSweep.d.ts","sourceRoot":"","sources":["../../../src/process/registry/ProcessSweep.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAoBH;;;;;;;GAOG;AACH,wBAAgB,iCAAiC,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAIvE;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,CAAC,OAAO,GACrB,OAAO,CAUT;AAkBD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED;;;;;;;GAOG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,MAAM,EACf,MAAM,EAAE;IACN,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,GACA,OAAO,CAuBT;AAqCD;;GAEG;AACH,wBAAsB,yBAAyB,CAAC,MAAM,CAAC,EAAE;IACvD,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB,GAAG,OAAO,CAAC,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAYnD;AAgCD;;GAEG;AACH,wBAAsB,0BAA0B,CAAC,MAAM,CAAC,EAAE;IACxD,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB,GAAG,OAAO,CAAC;IACV,OAAO,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjD,OAAO,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjD,KAAK,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD,CAAC,CA+BD"}

package/bin/process/registry/ProcessSweep.js

@@ -0,0 +1,202 @@
+/**
+ * 孤儿进程清扫工具。
+ *
+ * 关键点（中文）
+ * - 处理“pid 文件不存在，但旧的 detached 进程还活着”的场景。
+ * - 仅匹配 Downcity CLI 自己拉起的 `run` / `console run` / `agent start --foreground true`。
+ * - 作为 stop/start 的兜底清理层，避免旧版本进程占住端口却无法被当前 pid 文件追踪。
+ * - `run` 指 city 后台，`console run` 指 control plane 命令，二者需要明确区分。
+ */
+import { execFile as execFileCb } from "node:child_process";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFileCb);
+function isProcessAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function normalizeCommand(command) {
+    return String(command || "").replace(/\s+/g, " ").trim();
+}
+/**
+ * 构建 detached 进程停机时的信号目标。
+ *
+ * 关键点（中文）
+ * - POSIX 下 `detached: true` 会让子进程成为新的进程组 leader。
+ * - `-pid` 表示向整个进程组发信号，可覆盖 ACP、shell、watcher 等孙进程。
+ * - Windows 不支持负 pid 进程组语义，只能回退到单 pid。
+ */
+export function buildDetachedProcessSignalTargets(pid) {
+    if (!Number.isInteger(pid) || pid <= 0)
+        return [];
+    if (process.platform === "win32")
+        return [pid];
+    return [-pid, pid];
+}
+/**
+ * 向 detached 进程发送信号。
+ *
+ * 关键点（中文）
+ * - 优先发送到进程组；失败后再尝试单 pid。
+ * - 返回值只表示至少有一个目标接收到了信号，不代表进程已经退出。
+ */
+export function signalDetachedProcess(pid, signal) {
+    for (const target of buildDetachedProcessSignalTargets(pid)) {
+        try {
+            process.kill(target, signal);
+            return true;
+        }
+        catch {
+            // 尝试下一个目标。
+        }
+    }
+    return false;
+}
+function parseDowncityCliArgs(command) {
+    const normalized = normalizeCommand(command);
+    const match = normalized.match(/(?:^|\s)(\S*[\\/]Index\.js)(?:\s+(.+)|$)/);
+    if (!match)
+        return null;
+    const entryPath = String(match[1] || "");
+    const isKnownEntry = /[\\/]bin[\\/]cli[\\/]Index\.js$/.test(entryPath) ||
+        /[\\/]bin[\\/]main[\\/]modules[\\/]cli[\\/]Index\.js$/.test(entryPath);
+    if (!isKnownEntry)
+        return null;
+    const args = String(match[2] || "").trim();
+    return args;
+}
+export function isDowncityCliCommand(command) {
+    return parseDowncityCliArgs(command) !== null;
+}
+/**
+ * 判断命令行是否属于本次清扫目标。
+ *
+ * 关键点（中文）
+ * - `Index.js run` 是 city runtime。
+ * - `Index.js console run` 是 control plane runtime。
+ * - 两者都包含 `run`，因此必须按完整子命令匹配，不能只查 `run` 词元。
+ */
+export function shouldSweepDetachedCityCommand(command, params) {
+    const args = parseDowncityCliArgs(command);
+    if (args === null)
+        return false;
+    if (params.includeConsole &&
+        /^run(?:\s|$)/.test(args)) {
+        return true;
+    }
+    if (params.includeUi &&
+        /^console\s+run(?:\s|$)/.test(args)) {
+        return true;
+    }
+    if (params.includeAgent &&
+        /^agent\s+start(?:\s|$)/.test(args) &&
+        /--foreground\s+true\b/.test(args)) {
+        return true;
+    }
+    return false;
+}
+async function listDetachedCityProcesses(params) {
+    if (process.platform === "win32") {
+        return [];
+    }
+    try {
+        const { stdout } = await execFileAsync("ps", ["-axo", "pid=,command="], {
+            maxBuffer: 1024 * 1024,
+        });
+        return String(stdout || "")
+            .split("\n")
+            .map((line) => line.match(/^\s*(\d+)\s+(.*)$/))
+            .filter((item) => Boolean(item))
+            .map((item) => ({
+            pid: Number.parseInt(item[1] || "", 10),
+            command: normalizeCommand(item[2] || ""),
+        }))
+            .filter((item) => Number.isInteger(item.pid) && item.pid > 0)
+            .filter((item) => !params.excludePids.has(item.pid))
+            .filter((item) => shouldSweepDetachedCityCommand(item.command, params));
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * 只探测失联的 Downcity detached 进程，不执行停止动作。
+ */
+export async function findDetachedCityProcesses(params) {
+    const excludePids = new Set([
+        process.pid,
+        ...(Array.isArray(params?.excludePids) ? params.excludePids : []),
+    ]);
+    return listDetachedCityProcesses({
+        includeConsole: params?.includeConsole,
+        includeUi: params?.includeUi,
+        includeAgent: params?.includeAgent,
+        excludePids,
+    });
+}
+async function stopPid(pid, timeoutMs) {
+    if (!isProcessAlive(pid))
+        return true;
+    if (!signalDetachedProcess(pid, "SIGTERM")) {
+        return !isProcessAlive(pid);
+    }
+    const termStart = Date.now();
+    while (Date.now() - termStart < timeoutMs) {
+        if (!isProcessAlive(pid))
+            return true;
+        await new Promise((resolve) => setTimeout(resolve, 200));
+    }
+    try {
+        if (isProcessAlive(pid)) {
+            signalDetachedProcess(pid, "SIGKILL");
+        }
+    }
+    catch {
+        return !isProcessAlive(pid);
+    }
+    const killStart = Date.now();
+    while (Date.now() - killStart < 2_000) {
+        if (!isProcessAlive(pid))
+            return true;
+        await new Promise((resolve) => setTimeout(resolve, 100));
+    }
+    return !isProcessAlive(pid);
+}
+/**
+ * 清扫失联的 Downcity detached 进程。
+ */
+export async function sweepDetachedCityProcesses(params) {
+    const timeoutMs = params?.timeoutMs ?? 8_000;
+    const excludePids = new Set([
+        process.pid,
+        ...(Array.isArray(params?.excludePids) ? params.excludePids : []),
+    ]);
+    const matched = await listDetachedCityProcesses({
+        includeConsole: params?.includeConsole,
+        includeUi: params?.includeUi,
+        includeAgent: params?.includeAgent,
+        excludePids,
+    });
+    const stopped = [];
+    const alive = [];
+    for (const item of matched) {
+        // 关键点（中文）：逐个停止，避免并发 kill 时输出与状态难以对应。
+        const ok = await stopPid(item.pid, timeoutMs);
+        if (ok) {
+            stopped.push(item);
+        }
+        else {
+            alive.push(item);
+        }
+    }
+    return {
+        matched,
+        stopped,
+        alive,
+    };
+}
+//# sourceMappingURL=ProcessSweep.js.map

package/bin/process/registry/ProcessSweep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProcessSweep.js","sourceRoot":"","sources":["../../../src/process/registry/ProcessSweep.ts"],"names":[],"mappings":"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"}

package/bin/process/rpc/Client.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Local RPC 客户端。
+ *
+ * 关键点（中文）
+ * - 只用于本机受信任 IPC，不附加 HTTP Bearer 鉴权。
+ * - 返回结构与 HTTP `callServer()` 对齐，便于上层透明切换 transport。
+ */
+import type { DaemonJsonApiCallParams, DaemonJsonApiCallResult } from "../../process/daemon/Api.js";
+/**
+ * 通过本地 IPC 调用 agent runtime。
+ */
+export declare function callLocalServer<T>(params: DaemonJsonApiCallParams): Promise<DaemonJsonApiCallResult<T>>;
+//# sourceMappingURL=Client.d.ts.map

package/bin/process/rpc/Client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Client.d.ts","sourceRoot":"","sources":["../../../src/process/rpc/Client.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EACV,uBAAuB,EACvB,uBAAuB,EACxB,MAAM,yBAAyB,CAAC;AAejC;;GAEG;AACH,wBAAsB,eAAe,CAAC,CAAC,EACrC,MAAM,EAAE,uBAAuB,GAC9B,OAAO,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC,CA+ErC"}

package/bin/process/rpc/Client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Client.js","sourceRoot":"","sources":["../../../src/process/rpc/Client.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,GAAG,MAAM,UAAU,CAAC;AAC3B,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAMhC,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,oBAAoB,GAAG,KAAK,CAAC;AAEnC,SAAS,iBAAiB,CAAC,MAA+B;IACxD,OAAO;QACL,SAAS,EAAE,MAAM,EAAE;QACnB,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;QACtC,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,KAAK;QAC9B,GAAG,CAAC,MAAM,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC5D,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAA+B;IAE/B,MAAM,QAAQ,GAAG,mBAAmB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IACzD,MAAM,OAAO,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC1C,MAAM,SAAS,GACb,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ;QACpC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC;QACjC,MAAM,CAAC,SAAS,GAAG,CAAC;QAClB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC;QAC9B,CAAC,CAAC,oBAAoB,CAAC;IAE3B,OAAO,MAAM,IAAI,OAAO,CAA6B,CAAC,OAAO,EAAE,EAAE;QAC/D,MAAM,MAAM,GAAG,GAAG,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAC9C,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,IAAI,QAAQ,GAAG,EAAE,CAAC;QAElB,MAAM,MAAM,GAAG,CAAC,MAAkC,EAAQ,EAAE;YAC1D,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,MAAM,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO,CAAC,MAAM,CAAC,CAAC;QAClB,CAAC,CAAC;QAEF,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAC3B,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QAE7B,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;YACxB,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;YAC1B,QAAQ,IAAI,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;YAChC,MAAM,YAAY,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC5C,IAAI,YAAY,GAAG,CAAC;gBAAE,OAAO;YAC7B,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,IAAI,EAAE,CAAC;YACnD,IAAI,CAAC,GAAG,EAAE,CAAC;gBACT,MAAM,CAAC;oBACL,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE,yCAAyC,QAAQ,EAAE;iBAC3D,CAAC,CAAC;gBACH,OAAO;YACT,CAAC;YACD,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAqB,CAAC;gBACrD,MAAM,CAAC;oBACL,OAAO,EAAE,QAAQ,CAAC,OAAO;oBACzB,MAAM,EAAE,QAAQ,CAAC,MAAM;oBACvB,GAAG,CAAC,QAAQ,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACpE,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACrD,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC;oBACL,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE,wCAAwC,QAAQ,KAAK,MAAM,CAAC,KAAK,CAAC,EAAE;iBAC5E,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;YACxB,MAAM,CAAC;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,6BAA6B,SAAS,OAAO,QAAQ,GAAG;aAChE,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YAC3B,MAAM,CAAC;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,4BAA4B,QAAQ,KAAK,MAAM,CAAC,KAAK,CAAC,EAAE;aAChE,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;YACpB,IAAI,OAAO;gBAAE,OAAO;YACpB,MAAM,CAAC;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,sCAAsC,QAAQ,GAAG;aACzD,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/bin/process/rpc/Paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Paths.d.ts","sourceRoot":"","sources":["../../../src/process/rpc/Paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAuBH;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAQ/D"}