@downcity/city 1.1.4 → 1.1.6

package/bin/cli/service/ServiceScheduleCommand.js

@@ -0,0 +1,271 @@
+/**
+ * `city service schedule` 命令。
+ *
+ * 关键点（中文）
+ * - schedule 管理命令只依赖项目本地 schedule SQLite，不要求 runtime 在线。
+ * - 这里同时承载 schedule 子命令注册与本地存储读写流程。
+ */
+import { ServiceScheduleStore } from "@downcity/agent";
+import { printResult } from "../../utils/cli/CliOutput.js";
+import { addServiceScheduleOptions, normalizeScheduledJobStatus, parsePositiveIntOption, resolveScheduleProjectRoot, validateAgentProjectRoot, } from "./ServiceCommandSupport.js";
+/**
+ * 执行 `service schedule list`。
+ */
+export async function runServiceScheduleListCommand(params) {
+    const resolved = await resolveScheduleProjectRoot(params.options);
+    if (!resolved.projectRoot) {
+        printResult({
+            asJson: params.options.json,
+            success: false,
+            title: "service schedule list failed",
+            payload: {
+                error: resolved.error || "Failed to resolve agent project path",
+            },
+        });
+        return;
+    }
+    const projectRoot = resolved.projectRoot;
+    const pathError = validateAgentProjectRoot(projectRoot);
+    if (pathError) {
+        printResult({
+            asJson: params.options.json,
+            success: false,
+            title: "service schedule list failed",
+            payload: {
+                error: pathError,
+            },
+        });
+        return;
+    }
+    try {
+        const status = normalizeScheduledJobStatus(params.statusRaw);
+        const limit = params.limitRaw
+            ? parsePositiveIntOption(params.limitRaw, "limit")
+            : 100;
+        const store = new ServiceScheduleStore(projectRoot);
+        try {
+            const jobs = store.listJobs({ status, limit });
+            printResult({
+                asJson: params.options.json,
+                success: true,
+                title: "service schedule listed",
+                payload: {
+                    ...(status ? { status } : {}),
+                    limit,
+                    count: jobs.length,
+                    jobs,
+                },
+            });
+        }
+        finally {
+            store.close();
+        }
+    }
+    catch (error) {
+        printResult({
+            asJson: params.options.json,
+            success: false,
+            title: "service schedule list failed",
+            payload: {
+                error: String(error),
+            },
+        });
+    }
+}
+/**
+ * 执行 `service schedule info`。
+ */
+export async function runServiceScheduleInfoCommand(params) {
+    const resolved = await resolveScheduleProjectRoot(params.options);
+    if (!resolved.projectRoot) {
+        printResult({
+            asJson: params.options.json,
+            success: false,
+            title: "service schedule info failed",
+            payload: {
+                error: resolved.error || "Failed to resolve agent project path",
+            },
+        });
+        return;
+    }
+    const projectRoot = resolved.projectRoot;
+    const pathError = validateAgentProjectRoot(projectRoot);
+    if (pathError) {
+        printResult({
+            asJson: params.options.json,
+            success: false,
+            title: "service schedule info failed",
+            payload: {
+                error: pathError,
+            },
+        });
+        return;
+    }
+    const jobId = String(params.jobId || "").trim();
+    if (!jobId) {
+        printResult({
+            asJson: params.options.json,
+            success: false,
+            title: "service schedule info failed",
+            payload: {
+                error: "jobId is required",
+            },
+        });
+        return;
+    }
+    const store = new ServiceScheduleStore(projectRoot);
+    try {
+        const job = store.getJobById(jobId);
+        if (!job) {
+            printResult({
+                asJson: params.options.json,
+                success: false,
+                title: "service schedule info failed",
+                payload: {
+                    error: `Scheduled job not found: ${jobId}`,
+                },
+            });
+            return;
+        }
+        printResult({
+            asJson: params.options.json,
+            success: true,
+            title: "service schedule info ok",
+            payload: {
+                job,
+            },
+        });
+    }
+    finally {
+        store.close();
+    }
+}
+/**
+ * 执行 `service schedule cancel`。
+ */
+export async function runServiceScheduleCancelCommand(params) {
+    const resolved = await resolveScheduleProjectRoot(params.options);
+    if (!resolved.projectRoot) {
+        printResult({
+            asJson: params.options.json,
+            success: false,
+            title: "service schedule cancel failed",
+            payload: {
+                error: resolved.error || "Failed to resolve agent project path",
+            },
+        });
+        return;
+    }
+    const projectRoot = resolved.projectRoot;
+    const pathError = validateAgentProjectRoot(projectRoot);
+    if (pathError) {
+        printResult({
+            asJson: params.options.json,
+            success: false,
+            title: "service schedule cancel failed",
+            payload: {
+                error: pathError,
+            },
+        });
+        return;
+    }
+    const jobId = String(params.jobId || "").trim();
+    if (!jobId) {
+        printResult({
+            asJson: params.options.json,
+            success: false,
+            title: "service schedule cancel failed",
+            payload: {
+                error: "jobId is required",
+            },
+        });
+        return;
+    }
+    const store = new ServiceScheduleStore(projectRoot);
+    try {
+        const current = store.getJobById(jobId);
+        if (!current) {
+            printResult({
+                asJson: params.options.json,
+                success: false,
+                title: "service schedule cancel failed",
+                payload: {
+                    error: `Scheduled job not found: ${jobId}`,
+                },
+            });
+            return;
+        }
+        if (current.status !== "pending") {
+            printResult({
+                asJson: params.options.json,
+                success: false,
+                title: "service schedule cancel failed",
+                payload: {
+                    error: `Only pending jobs can be cancelled. Current status: ${current.status}`,
+                    job: current,
+                },
+            });
+            return;
+        }
+        const cancelled = store.cancelPendingJob(jobId);
+        if (!cancelled) {
+            printResult({
+                asJson: params.options.json,
+                success: false,
+                title: "service schedule cancel failed",
+                payload: {
+                    error: `Failed to cancel scheduled job: ${jobId}`,
+                },
+            });
+            return;
+        }
+        printResult({
+            asJson: params.options.json,
+            success: true,
+            title: "service schedule cancelled",
+            payload: {
+                job: store.getJobById(jobId),
+            },
+        });
+    }
+    finally {
+        store.close();
+    }
+}
+/**
+ * 注册 `service schedule` 子命令组。
+ */
+export function registerServiceScheduleCommands(service) {
+    const schedule = service
+        .command("schedule")
+        .description("查看和管理持久化 schedule 任务")
+        .helpOption("--help", "display help for command");
+    addServiceScheduleOptions(schedule
+        .command("list")
+        .description("列出当前 agent 的调度任务")
+        .option("--status <status>", "状态过滤（pending|running|succeeded|failed|cancelled）")
+        .option("--limit <n>", "返回条数（默认 100）")).action(async (opts) => {
+        await runServiceScheduleListCommand({
+            options: opts,
+            statusRaw: opts.status,
+            limitRaw: opts.limit,
+        });
+    });
+    addServiceScheduleOptions(schedule
+        .command("info <jobId>")
+        .description("查看单个调度任务详情")).action(async (jobId, opts) => {
+        await runServiceScheduleInfoCommand({
+            jobId,
+            options: opts,
+        });
+    });
+    addServiceScheduleOptions(schedule
+        .command("cancel <jobId>")
+        .description("取消一个尚未执行的调度任务")).action(async (jobId, opts) => {
+        await runServiceScheduleCancelCommand({
+            jobId,
+            options: opts,
+        });
+    });
+}
+//# sourceMappingURL=ServiceScheduleCommand.js.map

package/bin/cli/service/ServiceScheduleCommand.js.map

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

package/bin/cli/service/Services.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Services.d.ts","sourceRoot":"","sources":["../../../src/cli/service/Services.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwEzC;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAwG9D"}

package/bin/cli/service/Services.js

@@ -0,0 +1,154 @@
+/**
+ * `city service` 命令组。
+ *
+ * 关键点（中文）
+ * - `city service` 现在承担 console 侧静态 service catalog 入口。
+ * - `list/status` 不依赖 agent，仅展示已注册 service 的静态能力。
+ * - 具体 agent runtime lifecycle 应优先通过 `city <service>` 命令访问。
+ */
+import { listRegisteredServices } from "@downcity/agent";
+import { printResult } from "../../utils/cli/CliOutput.js";
+import { runServiceCommandBridge, runServiceControlCommand, } from "./ServiceCommandRemote.js";
+import { registerServiceScheduleCommands } from "./ServiceScheduleCommand.js";
+import { parseBoolean, parsePort } from "../shared/IndexSupport.js";
+function toStaticServiceView(service) {
+    return {
+        name: service.name,
+        scope: "agent",
+        supportsLifecycle: Boolean(service.lifecycle?.start || service.lifecycle?.stop),
+        supportsCommand: Object.keys(service.actions || {}).length > 0 || Boolean(service.lifecycle?.command),
+        actions: Object.keys(service.actions || {}).sort((left, right) => left.localeCompare(right)),
+    };
+}
+function printStaticServiceList(params) {
+    const services = listRegisteredServices()
+        .map((service) => toStaticServiceView(service))
+        .sort((left, right) => left.name.localeCompare(right.name));
+    printResult({
+        asJson: params?.asJson,
+        success: true,
+        title: "service catalog",
+        payload: {
+            count: services.length,
+            services,
+        },
+    });
+}
+function printStaticServiceStatus(params) {
+    const service = listRegisteredServices().find((item) => item.name === params.serviceName);
+    if (!service) {
+        printResult({
+            asJson: params.asJson,
+            success: false,
+            title: "service status failed",
+            payload: {
+                error: `Unknown service: ${params.serviceName}`,
+            },
+        });
+        return;
+    }
+    printResult({
+        asJson: params.asJson,
+        success: true,
+        title: "service status",
+        payload: {
+            service: toStaticServiceView(service),
+        },
+    });
+}
+/**
+ * 注册 `service` 命令组。
+ */
+export function registerServicesCommand(program) {
+    const service = program
+        .command("service")
+        .description("查看 service catalog，并提供高级 agent 定向入口")
+        .helpOption("--help", "display help for command");
+    service
+        .command("list")
+        .description("列出全部已注册 service 的静态能力")
+        .option("--json [enabled]", "以 JSON 输出", parseBoolean, true)
+        .action(async (opts) => {
+        printStaticServiceList({
+            asJson: opts.json !== false,
+        });
+    });
+    service
+        .command("status <serviceName>")
+        .description("查看单个 service 的静态能力")
+        .option("--json [enabled]", "以 JSON 输出", parseBoolean, true)
+        .action(async (serviceName, opts) => {
+        printStaticServiceStatus({
+            serviceName,
+            asJson: opts.json !== false,
+        });
+    });
+    service
+        .command("start <serviceName>")
+        .description("高级用法：按 agent 目标启动 service")
+        .option("--path <path>", "项目根目录（默认当前目录）", ".")
+        .option("--agent <name>", "agent 名称（从 managed agent registry 解析）")
+        .option("--host <host>", "Server host（覆盖自动解析）")
+        .option("--port <port>", "Server port（覆盖自动解析）", parsePort)
+        .option("--token <token>", "覆盖 Bearer Token（仅远程 HTTP 调用需要；默认本地走 IPC）")
+        .option("--json [enabled]", "以 JSON 输出", parseBoolean, true)
+        .action(async (serviceName, opts) => {
+        await runServiceControlCommand({
+            serviceName,
+            action: "start",
+            options: opts,
+        });
+    });
+    service
+        .command("stop <serviceName>")
+        .description("高级用法：按 agent 目标停止 service")
+        .option("--path <path>", "项目根目录（默认当前目录）", ".")
+        .option("--agent <name>", "agent 名称（从 managed agent registry 解析）")
+        .option("--host <host>", "Server host（覆盖自动解析）")
+        .option("--port <port>", "Server port（覆盖自动解析）", parsePort)
+        .option("--token <token>", "覆盖 Bearer Token（仅远程 HTTP 调用需要；默认本地走 IPC）")
+        .option("--json [enabled]", "以 JSON 输出", parseBoolean, true)
+        .action(async (serviceName, opts) => {
+        await runServiceControlCommand({
+            serviceName,
+            action: "stop",
+            options: opts,
+        });
+    });
+    service
+        .command("restart <serviceName>")
+        .description("高级用法：按 agent 目标重启 service")
+        .option("--path <path>", "项目根目录（默认当前目录）", ".")
+        .option("--agent <name>", "agent 名称（从 managed agent registry 解析）")
+        .option("--host <host>", "Server host（覆盖自动解析）")
+        .option("--port <port>", "Server port（覆盖自动解析）", parsePort)
+        .option("--token <token>", "覆盖 Bearer Token（仅远程 HTTP 调用需要；默认本地走 IPC）")
+        .option("--json [enabled]", "以 JSON 输出", parseBoolean, true)
+        .action(async (serviceName, opts) => {
+        await runServiceControlCommand({
+            serviceName,
+            action: "restart",
+            options: opts,
+        });
+    });
+    service
+        .command("command <serviceName> <command>")
+        .description("高级用法：按 agent 目标转发 service command")
+        .option("--payload <json>", "可选 payload（JSON 字符串或普通字符串）")
+        .option("--path <path>", "项目根目录（默认当前目录）", ".")
+        .option("--agent <name>", "agent 名称（从 managed agent registry 解析）")
+        .option("--host <host>", "Server host（覆盖自动解析）")
+        .option("--port <port>", "Server port（覆盖自动解析）", parsePort)
+        .option("--token <token>", "覆盖 Bearer Token（仅远程 HTTP 调用需要；默认本地走 IPC）")
+        .option("--json [enabled]", "以 JSON 输出", parseBoolean, true)
+        .action(async (serviceName, command, opts) => {
+        await runServiceCommandBridge({
+            serviceName,
+            command,
+            payloadRaw: opts.payload,
+            options: opts,
+        });
+    });
+    registerServiceScheduleCommands(service);
+}
+//# sourceMappingURL=Services.js.map

package/bin/cli/service/Services.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Services.js","sourceRoot":"","sources":["../../../src/cli/service/Services.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEvD,OAAO,EACL,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,+BAA+B,EAAE,MAAM,6BAA6B,CAAC;AAE9E,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAEpE,SAAS,mBAAmB,CAAC,OAAgB;IAO3C,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,KAAK,EAAE,OAAO;QACd,iBAAiB,EAAE,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,KAAK,IAAI,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC;QAC/E,eAAe,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC;QACrG,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;KAC7F,CAAC;AACJ,CAAC;AAED,SAAS,sBAAsB,CAAC,MAE/B;IACC,MAAM,QAAQ,GAAG,sBAAsB,EAAE;SACtC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;SAC9C,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9D,WAAW,CAAC;QACV,MAAM,EAAE,MAAM,EAAE,MAAM;QACtB,OAAO,EAAE,IAAI;QACb,KAAK,EAAE,iBAAiB;QACxB,OAAO,EAAE;YACP,KAAK,EAAE,QAAQ,CAAC,MAAM;YACtB,QAAQ;SACT;KACF,CAAC,CAAC;AACL,CAAC;AAED,SAAS,wBAAwB,CAAC,MAGjC;IACC,MAAM,OAAO,GAAG,sBAAsB,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,WAAW,CAAC,CAAC;IAC1F,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,WAAW,CAAC;YACV,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,uBAAuB;YAC9B,OAAO,EAAE;gBACP,KAAK,EAAE,oBAAoB,MAAM,CAAC,WAAW,EAAE;aAChD;SACF,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IAED,WAAW,CAAC;QACV,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,OAAO,EAAE,IAAI;QACb,KAAK,EAAE,gBAAgB;QACvB,OAAO,EAAE;YACP,OAAO,EAAE,mBAAmB,CAAC,OAAO,CAAC;SACtC;KACF,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAAgB;IACtD,MAAM,OAAO,GAAG,OAAO;SACpB,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,qCAAqC,CAAC;SAClD,UAAU,CAAC,QAAQ,EAAE,0BAA0B,CAAC,CAAC;IAEpD,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,uBAAuB,CAAC;SACpC,MAAM,CAAC,kBAAkB,EAAE,WAAW,EAAE,YAAY,EAAE,IAAI,CAAC;SAC3D,MAAM,CAAC,KAAK,EAAE,IAAwB,EAAE,EAAE;QACzC,sBAAsB,CAAC;YACrB,MAAM,EAAE,IAAI,CAAC,IAAI,KAAK,KAAK;SAC5B,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,sBAAsB,CAAC;SAC/B,WAAW,CAAC,oBAAoB,CAAC;SACjC,MAAM,CAAC,kBAAkB,EAAE,WAAW,EAAE,YAAY,EAAE,IAAI,CAAC;SAC3D,MAAM,CAAC,KAAK,EAAE,WAAmB,EAAE,IAAwB,EAAE,EAAE;QAC9D,wBAAwB,CAAC;YACvB,WAAW;YACX,MAAM,EAAE,IAAI,CAAC,IAAI,KAAK,KAAK;SAC5B,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,qBAAqB,CAAC;SAC9B,WAAW,CAAC,2BAA2B,CAAC;SACxC,MAAM,CAAC,eAAe,EAAE,eAAe,EAAE,GAAG,CAAC;SAC7C,MAAM,CAAC,gBAAgB,EAAE,uCAAuC,CAAC;SACjE,MAAM,CAAC,eAAe,EAAE,qBAAqB,CAAC;SAC9C,MAAM,CAAC,eAAe,EAAE,qBAAqB,EAAE,SAAS,CAAC;SACzD,MAAM,CAAC,iBAAiB,EAAE,0CAA0C,CAAC;SACrE,MAAM,CAAC,kBAAkB,EAAE,WAAW,EAAE,YAAY,EAAE,IAAI,CAAC;SAC3D,MAAM,CAAC,KAAK,EAAE,WAAmB,EAAE,IAA2B,EAAE,EAAE;QACjE,MAAM,wBAAwB,CAAC;YAC7B,WAAW;YACX,MAAM,EAAE,OAAO;YACf,OAAO,EAAE,IAAI;SACd,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,oBAAoB,CAAC;SAC7B,WAAW,CAAC,2BAA2B,CAAC;SACxC,MAAM,CAAC,eAAe,EAAE,eAAe,EAAE,GAAG,CAAC;SAC7C,MAAM,CAAC,gBAAgB,EAAE,uCAAuC,CAAC;SACjE,MAAM,CAAC,eAAe,EAAE,qBAAqB,CAAC;SAC9C,MAAM,CAAC,eAAe,EAAE,qBAAqB,EAAE,SAAS,CAAC;SACzD,MAAM,CAAC,iBAAiB,EAAE,0CAA0C,CAAC;SACrE,MAAM,CAAC,kBAAkB,EAAE,WAAW,EAAE,YAAY,EAAE,IAAI,CAAC;SAC3D,MAAM,CAAC,KAAK,EAAE,WAAmB,EAAE,IAA2B,EAAE,EAAE;QACjE,MAAM,wBAAwB,CAAC;YAC7B,WAAW;YACX,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,IAAI;SACd,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,uBAAuB,CAAC;SAChC,WAAW,CAAC,2BAA2B,CAAC;SACxC,MAAM,CAAC,eAAe,EAAE,eAAe,EAAE,GAAG,CAAC;SAC7C,MAAM,CAAC,gBAAgB,EAAE,uCAAuC,CAAC;SACjE,MAAM,CAAC,eAAe,EAAE,qBAAqB,CAAC;SAC9C,MAAM,CAAC,eAAe,EAAE,qBAAqB,EAAE,SAAS,CAAC;SACzD,MAAM,CAAC,iBAAiB,EAAE,0CAA0C,CAAC;SACrE,MAAM,CAAC,kBAAkB,EAAE,WAAW,EAAE,YAAY,EAAE,IAAI,CAAC;SAC3D,MAAM,CAAC,KAAK,EAAE,WAAmB,EAAE,IAA2B,EAAE,EAAE;QACjE,MAAM,wBAAwB,CAAC;YAC7B,WAAW;YACX,MAAM,EAAE,SAAS;YACjB,OAAO,EAAE,IAAI;SACd,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,iCAAiC,CAAC;SAC1C,WAAW,CAAC,mCAAmC,CAAC;SAChD,MAAM,CAAC,kBAAkB,EAAE,4BAA4B,CAAC;SACxD,MAAM,CAAC,eAAe,EAAE,eAAe,EAAE,GAAG,CAAC;SAC7C,MAAM,CAAC,gBAAgB,EAAE,uCAAuC,CAAC;SACjE,MAAM,CAAC,eAAe,EAAE,qBAAqB,CAAC;SAC9C,MAAM,CAAC,eAAe,EAAE,qBAAqB,EAAE,SAAS,CAAC;SACzD,MAAM,CAAC,iBAAiB,EAAE,0CAA0C,CAAC;SACrE,MAAM,CAAC,kBAAkB,EAAE,WAAW,EAAE,YAAY,EAAE,IAAI,CAAC;SAC3D,MAAM,CACP,KAAK,EACH,WAAmB,EACnB,OAAe,EACf,IAAkD,EAClD,EAAE;QACF,MAAM,uBAAuB,CAAC;YAC5B,WAAW;YACX,OAAO;YACP,UAAU,EAAE,IAAI,CAAC,OAAO;YACxB,OAAO,EAAE,IAAI;SACd,CAAC,CAAC;IACL,CAAC,CACF,CAAC;IAEF,+BAA+B,CAAC,OAAO,CAAC,CAAC;AAC3C,CAAC"}

package/bin/cli/shared/Alias.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Alias.d.ts","sourceRoot":"","sources":["../../../src/cli/shared/Alias.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH;;GAEG;AACH,UAAU,YAAY;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAoCD;;GAEG;AACH,wBAAsB,YAAY,CAAC,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CA8E5E"}

package/bin/cli/shared/Alias.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Alias.js","sourceRoot":"","sources":["../../../src/cli/shared/Alias.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAW7D;;;;;;;GAOG;AACH,SAAS,gBAAgB,CAAC,OAAe,EAAE,UAAoB;IAC7D,MAAM,KAAK,GAAG,0BAA0B,CAAC;IACzC,MAAM,GAAG,GAAG,0BAA0B,CAAC;IACvC,MAAM,KAAK,GAAG,GAAG,KAAK,KAAK,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IAE7D,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACxC,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAEpC,IAAI,QAAQ,KAAK,CAAC,CAAC,IAAI,MAAM,KAAK,CAAC,CAAC,IAAI,MAAM,GAAG,QAAQ,EAAE,CAAC;QAC1D,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC9D,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAC1E,MAAM,IAAI,GAAG,GAAG,MAAM,OAAO,KAAK,GAAG,KAAK,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAC1E,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,KAAK,OAAO,EAAE,CAAC;IAC7C,CAAC;IAED,MAAM,UAAU,GAAG,uBAAuB,CAAC;IAC3C,IAAI,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7B,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC3C,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1D,MAAM,IAAI,GAAG,GAAG,MAAM,GAAG,KAAK,EAAE,CAAC;IACjC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,UAAwB,EAAE;IAC3D,MAAM,UAAU,GAAG,CAAC,uBAAuB,CAAC,CAAC;IAE7C,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,YAAY,CAAC;YACX,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE,eAAe;YACtB,KAAK,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBAC/B,KAAK,EAAE,MAAM;gBACb,KAAK,EAAE,IAAI;aACZ,CAAC,CAAC;SACJ,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,IAAI,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;IAC5D,MAAM,OAAO,GACX,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAE5E,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;IAC1B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IAExF,MAAM,YAAY,GAAa,EAAE,CAAC;IAClC,MAAM,YAAY,GAAa,EAAE,CAAC;IAElC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAC3C,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACjE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,gBAAgB,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QAEhE,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC1B,SAAS;QACX,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YACpB,MAAM,EAAE,CAAC,UAAU,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QAC7C,CAAC;QACD,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,YAAY,CAAC;YACX,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE,sBAAsB;YAC7B,OAAO,EAAE,SAAS;SACnB,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,YAAY,CAAC;YACX,IAAI,EAAE,SAAS;YACf,KAAK,EAAE,eAAe;SACvB,CAAC,CAAC;IACL,CAAC;IACD,WAAW,CAAC;QACV,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,SAAS;QAChB,KAAK,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;KACrD,CAAC,CAAC;IACH,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,WAAW,CAAC;YACV,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE,SAAS;YAChB,KAAK,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;SACrD,CAAC,CAAC;IACL,CAAC;IACD,WAAW,CAAC;QACV,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,eAAe;QACtB,KAAK,EAAE;YACL,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;gBACzB,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACpD,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;gBAC1B,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,EAAE,CAAC;gBACrD,CAAC,CAAC,EAAE,CAAC;YACP,EAAE,KAAK,EAAE,WAAW,EAAE;SACvB;KACF,CAAC,CAAC;AACL,CAAC"}

package/bin/cli/shared/Chat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Chat.d.ts","sourceRoot":"","sources":["../../../src/cli/shared/Chat.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIzC;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAc1D"}

package/bin/cli/shared/Chat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Chat.js","sourceRoot":"","sources":["../../../src/cli/shared/Chat.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAE7D;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAgB;IAClD,MAAM,IAAI,GAAG,OAAO;SACjB,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,+BAA+B,CAAC;SAC5C,UAAU,CAAC,QAAQ,EAAE,0BAA0B,CAAC;SAChD,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,KAAK,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;YAClE,MAAM,yBAAyB,EAAE,CAAC;YAClC,OAAO;QACT,CAAC;QACD,IAAI,CAAC,UAAU,EAAE,CAAC;IACpB,CAAC,CAAC,CAAC;IAEL,wBAAwB,CAAC,IAAI,CAAC,CAAC;AACjC,CAAC"}

package/bin/cli/shared/ChatAuth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatAuth.d.ts","sourceRoot":"","sources":["../../../src/cli/shared/ChatAuth.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAezC,KAAK,kBAAkB,GAAG;IACxB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC;AA8DF;;GAEG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,kBAAkB,CAAC;CAC9B,GAAG,OAAO,CAAC,IAAI,CAAC,CAuDhB;AAED;;GAEG;AACH,wBAAsB,6BAA6B,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAY/F;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAkB5D"}

package/bin/cli/shared/ChatAuth.js

@@ -0,0 +1,151 @@
+/**
+ * `city chat auth` CLI 辅助模块。
+ *
+ * 关键点（中文）
+ * - chat authorization 现在按 agent projectRoot 隔离存储。
+ * - 授权主体使用 `<platform>:<platformUserId>`，例如 `telegram:12345678`。
+ * - 管理员执行 `city chat auth set telegram:12345678` 后交互式选择 role。
+ */
+import path from "node:path";
+import prompts from "prompts";
+import { listChatAuthorizationRoles, readChatAuthorizationConfigSync, resolveAuthorizedUserRole, setChatAuthorizationUserRole, } from "@downcity/agent";
+import { emitCliBlock } from "./CliReporter.js";
+import { parseBoolean } from "./IndexSupport.js";
+import { isChatAuthorizationChannel, } from "@downcity/agent";
+function resolveChatAuthProjectRoot(pathInput) {
+    return path.resolve(String(pathInput || "."));
+}
+function parsePrincipal(principalInput) {
+    const principal = String(principalInput || "").trim();
+    const separator = principal.indexOf(":");
+    if (separator <= 0 || separator === principal.length - 1) {
+        throw new Error("principal 格式应为 <platform>:<userId>，例如 telegram:12345678");
+    }
+    const channel = principal.slice(0, separator).trim().toLowerCase();
+    const userId = principal.slice(separator + 1).trim();
+    if (!isChatAuthorizationChannel(channel)) {
+        throw new Error("platform 仅支持 telegram、feishu、qq");
+    }
+    if (!userId) {
+        throw new Error("userId 不能为空");
+    }
+    return { channel, userId };
+}
+function findRole(roles, roleId) {
+    return roles.find((role) => role.roleId === roleId) || null;
+}
+async function chooseRole(params) {
+    const initial = Math.max(0, params.roles.findIndex((role) => role.roleId === params.currentRoleId));
+    const response = (await prompts({
+        type: "select",
+        name: "roleId",
+        message: "选择新的 auth role",
+        choices: params.roles.map((role) => ({
+            title: role.roleId,
+            description: `${role.name} · ${role.permissions.length} permissions`,
+            value: role.roleId,
+        })),
+        initial,
+    }));
+    const roleId = String(response.roleId || "").trim();
+    if (!roleId)
+        return null;
+    return findRole(params.roles, roleId);
+}
+/**
+ * 设置授权主体角色。
+ */
+export async function runChatAuthSet(params) {
+    const principal = parsePrincipal(params.principal);
+    const projectRoot = resolveChatAuthProjectRoot(params.options?.path);
+    const config = readChatAuthorizationConfigSync(projectRoot);
+    const roles = listChatAuthorizationRoles({ config });
+    const currentRole = resolveAuthorizedUserRole({
+        channel: principal.channel,
+        userId: principal.userId,
+        authorizationConfig: config,
+        rootPath: projectRoot,
+    });
+    let nextRole = null;
+    const explicitRoleId = String(params.options?.role || "").trim();
+    if (explicitRoleId) {
+        nextRole = findRole(roles, explicitRoleId);
+        if (!nextRole)
+            throw new Error(`Unknown role: ${explicitRoleId}`);
+    }
+    else {
+        emitCliBlock({
+            tone: "info",
+            title: "Chat auth principal",
+            facts: [
+                { label: "Principal", value: `${principal.channel}:${principal.userId}` },
+                { label: "Current role", value: currentRole?.roleId || "default" },
+                { label: "Scope", value: "agent project" },
+                { label: "Project", value: projectRoot },
+            ],
+        });
+        nextRole = await chooseRole({
+            roles,
+            currentRoleId: currentRole?.roleId,
+        });
+    }
+    if (!nextRole)
+        return;
+    await setChatAuthorizationUserRole({
+        context: {
+            rootPath: projectRoot,
+        },
+        channel: principal.channel,
+        userId: principal.userId,
+        roleId: nextRole.roleId,
+    });
+    emitCliBlock({
+        tone: "success",
+        title: "Chat auth role updated",
+        summary: `${principal.channel}:${principal.userId} -> ${nextRole.roleId}`,
+        facts: [
+            { label: "Role", value: nextRole.name },
+            { label: "Scope", value: "agent project" },
+            { label: "Project", value: projectRoot },
+        ],
+    });
+}
+/**
+ * 交互式输入授权主体并设置角色。
+ */
+export async function runInteractiveChatAuthSetFlow(options) {
+    const response = (await prompts({
+        type: "text",
+        name: "principal",
+        message: "输入授权主体（例如 telegram:12345678）",
+    }));
+    const principal = String(response.principal || "").trim();
+    if (!principal)
+        return;
+    await runChatAuthSet({
+        principal,
+        options,
+    });
+}
+/**
+ * 注册 `city chat auth` 命令。
+ */
+export function registerChatAuthCommands(chat) {
+    const auth = chat
+        .command("auth")
+        .description("管理当前 agent 项目的 chat authorization")
+        .helpOption("--help", "display help for command");
+    auth
+        .command("set <principal>")
+        .description("给授权主体设置角色，例如：city chat auth set telegram:12345678 --path .")
+        .option("--path <path>", "agent 项目根目录（默认当前目录）", ".")
+        .option("--role <roleId>", "直接指定 roleId；不传则交互式选择")
+        .option("--json [enabled]", "以 JSON 输出", parseBoolean, false)
+        .action(async (principal, options) => {
+        await runChatAuthSet({
+            principal,
+            options,
+        });
+    });
+}
+//# sourceMappingURL=ChatAuth.js.map

package/bin/cli/shared/ChatAuth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatAuth.js","sourceRoot":"","sources":["../../../src/cli/shared/ChatAuth.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,OAAO,MAAM,SAAS,CAAC;AAE9B,OAAO,EACL,0BAA0B,EAC1B,+BAA+B,EAC/B,yBAAyB,EACzB,4BAA4B,GAC7B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EACL,0BAA0B,GAG3B,MAAM,iBAAiB,CAAC;AA4BzB,SAAS,0BAA0B,CAAC,SAAkB;IACpD,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,IAAI,GAAG,CAAC,CAAC,CAAC;AAChD,CAAC;AAED,SAAS,cAAc,CAAC,cAAsB;IAC5C,MAAM,SAAS,GAAG,MAAM,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACtD,MAAM,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACzC,IAAI,SAAS,IAAI,CAAC,IAAI,SAAS,KAAK,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzD,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC7E,CAAC;IACD,MAAM,OAAO,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACnE,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACrD,IAAI,CAAC,0BAA0B,CAAC,OAAO,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACrD,CAAC;IACD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,aAAa,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;AAC7B,CAAC;AAED,SAAS,QAAQ,CAAC,KAA8B,EAAE,MAAc;IAC9D,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC;AAC9D,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,MAGzB;IACC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CACtB,CAAC,EACD,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,MAAM,CAAC,aAAa,CAAC,CACvE,CAAC;IACF,MAAM,QAAQ,GAAG,CAAC,MAAM,OAAO,CAAC;QAC9B,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,gBAAgB;QACzB,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACnC,KAAK,EAAE,IAAI,CAAC,MAAM;YAClB,WAAW,EAAE,GAAG,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,WAAW,CAAC,MAAM,cAAc;YACpE,KAAK,EAAE,IAAI,CAAC,MAAM;SACnB,CAAC,CAAC;QACH,OAAO;KACR,CAAC,CAAwB,CAAC;IAC3B,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACpD,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,OAAO,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,MAGpC;IACC,MAAM,SAAS,GAAG,cAAc,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACnD,MAAM,WAAW,GAAG,0BAA0B,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACrE,MAAM,MAAM,GAAG,+BAA+B,CAAC,WAAW,CAAC,CAAC;IAC5D,MAAM,KAAK,GAAG,0BAA0B,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IACrD,MAAM,WAAW,GAAG,yBAAyB,CAAC;QAC5C,OAAO,EAAE,SAAS,CAAC,OAAO;QAC1B,MAAM,EAAE,SAAS,CAAC,MAAM;QACxB,mBAAmB,EAAE,MAAM;QAC3B,QAAQ,EAAE,WAAW;KACtB,CAAC,CAAC;IAEH,IAAI,QAAQ,GAAiC,IAAI,CAAC;IAClD,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACjE,IAAI,cAAc,EAAE,CAAC;QACnB,QAAQ,GAAG,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;QAC3C,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,iBAAiB,cAAc,EAAE,CAAC,CAAC;IACpE,CAAC;SAAM,CAAC;QACN,YAAY,CAAC;YACX,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE,qBAAqB;YAC5B,KAAK,EAAE;gBACL,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,SAAS,CAAC,OAAO,IAAI,SAAS,CAAC,MAAM,EAAE,EAAE;gBACzE,EAAE,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,IAAI,SAAS,EAAE;gBAClE,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE;gBAC1C,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE;aACzC;SACF,CAAC,CAAC;QACH,QAAQ,GAAG,MAAM,UAAU,CAAC;YAC1B,KAAK;YACL,aAAa,EAAE,WAAW,EAAE,MAAM;SACnC,CAAC,CAAC;IACL,CAAC;IAED,IAAI,CAAC,QAAQ;QAAE,OAAO;IAEtB,MAAM,4BAA4B,CAAC;QACjC,OAAO,EAAE;YACP,QAAQ,EAAE,WAAW;SACtB;QACD,OAAO,EAAE,SAAS,CAAC,OAAO;QAC1B,MAAM,EAAE,SAAS,CAAC,MAAM;QACxB,MAAM,EAAE,QAAQ,CAAC,MAAM;KACxB,CAAC,CAAC;IAEH,YAAY,CAAC;QACX,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,wBAAwB;QAC/B,OAAO,EAAE,GAAG,SAAS,CAAC,OAAO,IAAI,SAAS,CAAC,MAAM,OAAO,QAAQ,CAAC,MAAM,EAAE;QACzE,KAAK,EAAE;YACL,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,IAAI,EAAE;YACvC,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE;YAC1C,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE;SACzC;KACF,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,6BAA6B,CAAC,OAA4B;IAC9E,MAAM,QAAQ,GAAG,CAAC,MAAM,OAAO,CAAC;QAC9B,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,8BAA8B;KACxC,CAAC,CAA2B,CAAC;IAC9B,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1D,IAAI,CAAC,SAAS;QAAE,OAAO;IACvB,MAAM,cAAc,CAAC;QACnB,SAAS;QACT,OAAO;KACR,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CAAC,IAAa;IACpD,MAAM,IAAI,GAAG,IAAI;SACd,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,mCAAmC,CAAC;SAChD,UAAU,CAAC,QAAQ,EAAE,0BAA0B,CAAC,CAAC;IAEpD,IAAI;SACD,OAAO,CAAC,iBAAiB,CAAC;SAC1B,WAAW,CAAC,4DAA4D,CAAC;SACzE,MAAM,CAAC,eAAe,EAAE,qBAAqB,EAAE,GAAG,CAAC;SACnD,MAAM,CAAC,iBAAiB,EAAE,sBAAsB,CAAC;SACjD,MAAM,CAAC,kBAAkB,EAAE,WAAW,EAAE,YAAY,EAAE,KAAK,CAAC;SAC5D,MAAM,CAAC,KAAK,EAAE,SAAiB,EAAE,OAA2B,EAAE,EAAE;QAC/D,MAAM,cAAc,CAAC;YACnB,SAAS;YACT,OAAO;SACR,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACP,CAAC"}

package/bin/cli/shared/ChatManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatManager.d.ts","sourceRoot":"","sources":["../../../src/cli/shared/ChatManager.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAmZH;;GAEG;AACH,wBAAsB,yBAAyB,IAAI,OAAO,CAAC,IAAI,CAAC,CA2B/D"}