@downcity/city 1.1.4 → 1.1.5

package/bin/cli/model/ModelManagerTypes.d.ts

@@ -0,0 +1,21 @@
+/**
+ * `city model` 交互式 manager 类型。
+ */
+export type ModelManagerRootAction = "providers" | "models" | "create" | "exit";
+export type ModelManagerProviderAction = "details" | "discover" | "back";
+export type ModelManagerModelAction = "details" | "togglePause" | "test" | "use" | "back";
+export interface ModelManagerProviderSummary {
+    id: string;
+    type: string;
+    baseUrl?: string;
+    modelCount: number;
+}
+export interface ModelManagerModelSummary {
+    id: string;
+    providerId: string;
+    name: string;
+    isPaused: boolean;
+    temperature?: number;
+    maxTokens?: number;
+}
+//# sourceMappingURL=ModelManagerTypes.d.ts.map

package/bin/cli/model/ModelManagerTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModelManagerTypes.d.ts","sourceRoot":"","sources":["../../../src/cli/model/ModelManagerTypes.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,sBAAsB,GAC9B,WAAW,GACX,QAAQ,GACR,QAAQ,GACR,MAAM,CAAC;AAEX,MAAM,MAAM,0BAA0B,GAClC,SAAS,GACT,UAAU,GACV,MAAM,CAAC;AAEX,MAAM,MAAM,uBAAuB,GAC/B,SAAS,GACT,aAAa,GACb,MAAM,GACN,KAAK,GACL,MAAM,CAAC;AAEX,MAAM,WAAW,2BAA2B;IAC1C,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,wBAAwB;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/bin/cli/model/ModelManagerTypes.js

@@ -0,0 +1,5 @@
+/**
+ * `city model` 交互式 manager 类型。
+ */
+export {};
+//# sourceMappingURL=ModelManagerTypes.js.map

package/bin/cli/model/ModelManagerTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModelManagerTypes.js","sourceRoot":"","sources":["../../../src/cli/model/ModelManagerTypes.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/bin/cli/model/ModelReadCommand.d.ts

@@ -0,0 +1,13 @@
+/**
+ * `city model` 查询与绑定命令。
+ *
+ * 关键点（中文）
+ * - 这里只处理不修改平台模型池状态的命令。
+ * - `use` 虽然会写项目配置，但不会改动 console store，因此也归在这里。
+ */
+import type { Command } from "commander";
+/**
+ * 注册 `list/get/discover/use` 命令。
+ */
+export declare function registerModelReadCommands(model: Command): void;
+//# sourceMappingURL=ModelReadCommand.d.ts.map

package/bin/cli/model/ModelReadCommand.d.ts.map

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

package/bin/cli/model/ModelReadCommand.js

@@ -0,0 +1,198 @@
+/**
+ * `city model` 查询与绑定命令。
+ *
+ * 关键点（中文）
+ * - 这里只处理不修改平台模型池状态的命令。
+ * - `use` 虽然会写项目配置，但不会改动 console store，因此也归在这里。
+ */
+import { PlatformStore } from "@downcity/agent";
+import { printResult } from "../../utils/cli/CliOutput.js";
+import { discoverProviderModels, resolveProjectRoot, setProjectPrimaryModel, } from "./ModelSupport.js";
+import { parseBooleanOption, runStoreCommand, toSafeProviderView, } from "./ModelCommandShared.js";
+/**
+ * 注册 `list/get/discover/use` 命令。
+ */
+export function registerModelReadCommands(model) {
+    registerListCommand(model);
+    registerGetCommands(model);
+    registerDiscoverCommand(model);
+    registerUseCommand(model);
+}
+function registerListCommand(model) {
+    model
+        .command("list")
+        .description("列出 provider 与 model")
+        .option("--json [enabled]", "以 JSON 输出", parseBooleanOption, true)
+        .helpOption("--help", "display help for command")
+        .action(async (options) => {
+        await runStoreCommand(options, async (store) => {
+            const providers = (await store.listProviders()).map((item) => toSafeProviderView(item));
+            const models = store.listModels();
+            return {
+                title: "platform models listed",
+                payload: {
+                    providers,
+                    models,
+                    providerIds: providers.map((item) => item.id),
+                    modelIds: models.map((item) => item.id),
+                },
+            };
+        });
+    });
+}
+function registerGetCommands(model) {
+    const get = model
+        .command("get")
+        .description("读取 provider/model 详情")
+        .helpOption("--help", "display help for command");
+    get
+        .command("provider <providerId>")
+        .description("读取 provider 详情")
+        .option("--json [enabled]", "以 JSON 输出", parseBooleanOption, true)
+        .helpOption("--help", "display help for command")
+        .action(async (providerId, options) => {
+        await runStoreCommand(options, async (store) => {
+            const id = String(providerId || "").trim();
+            if (!id)
+                throw new Error("providerId cannot be empty");
+            const provider = await store.getProvider(id);
+            if (!provider)
+                throw new Error(`Provider not found: ${id}`);
+            return {
+                title: "provider loaded",
+                payload: {
+                    providerId: id,
+                    provider: toSafeProviderView(provider),
+                },
+            };
+        });
+    });
+    get
+        .command("model <modelId>")
+        .description("读取 model 详情")
+        .option("--json [enabled]", "以 JSON 输出", parseBooleanOption, true)
+        .helpOption("--help", "display help for command")
+        .action(async (modelId, options) => {
+        await runStoreCommand(options, async (store) => {
+            const id = String(modelId || "").trim();
+            if (!id)
+                throw new Error("modelId cannot be empty");
+            const modelConfig = store.getModel(id);
+            if (!modelConfig)
+                throw new Error(`Model not found: ${id}`);
+            return {
+                title: "model loaded",
+                payload: {
+                    modelId: id,
+                    model: modelConfig,
+                },
+            };
+        });
+    });
+}
+function registerDiscoverCommand(model) {
+    model
+        .command("discover <providerId>")
+        .description("发现 provider 可用模型（非交互）")
+        .option("--auto-add [enabled]", "自动写入发现到的模型", parseBooleanOption, false)
+        .option("--prefix <prefix>", "自动添加时的 modelId 前缀（默认不加前缀）")
+        .option("--json [enabled]", "以 JSON 输出", parseBooleanOption, true)
+        .helpOption("--help", "display help for command")
+        .action(async (providerId, options) => {
+        await runStoreCommand(options, async (store) => {
+            const id = String(providerId || "").trim();
+            if (!id)
+                throw new Error("providerId cannot be empty");
+            const provider = await store.getProvider(id);
+            if (!provider)
+                throw new Error(`Provider not found: ${id}`);
+            const discovery = await discoverProviderModels({
+                providerId: id,
+                providerType: provider.type,
+                baseUrl: provider.baseUrl,
+                apiKey: provider.apiKey,
+            });
+            if (!discovery.ok) {
+                throw new Error(discovery.error || `provider discover failed (${discovery.status || "n/a"})`);
+            }
+            const autoAdded = [];
+            if (options.autoAdd === true) {
+                const prefix = String(options.prefix || "").trim();
+                for (const remoteModelName of discovery.models) {
+                    const modelName = String(remoteModelName || "").trim();
+                    if (!modelName)
+                        continue;
+                    const modelId = prefix ? `${prefix}${modelName}` : modelName;
+                    if (store.getModel(modelId))
+                        continue;
+                    store.upsertModel({
+                        id: modelId,
+                        providerId: id,
+                        name: modelName,
+                    });
+                    autoAdded.push({ modelId, modelName });
+                }
+            }
+            return {
+                title: "provider models discovered",
+                payload: {
+                    providerId: id,
+                    providerType: provider.type,
+                    discoveredModels: discovery.models,
+                    modelCount: discovery.models.length,
+                    autoAdded,
+                },
+            };
+        });
+    });
+}
+function registerUseCommand(model) {
+    model
+        .command("use <modelId>")
+        .description("把项目 execution.modelId 绑定到指定模型（非交互）")
+        .option("--path <path>", "目标项目根目录（默认当前目录）", ".")
+        .option("--json [enabled]", "以 JSON 输出", parseBooleanOption, true)
+        .helpOption("--help", "display help for command")
+        .action(async (modelId, options) => {
+        const asJson = options.json !== false;
+        try {
+            const store = new PlatformStore();
+            try {
+                const id = String(modelId || "").trim();
+                if (!id)
+                    throw new Error("modelId cannot be empty");
+                const exists = store.getModel(id);
+                if (!exists)
+                    throw new Error(`Model not found in platform pool: ${id}`);
+            }
+            finally {
+                store.close();
+            }
+            const projectRoot = resolveProjectRoot(options.path);
+            const changed = setProjectPrimaryModel(projectRoot, modelId);
+            printResult({
+                asJson,
+                success: true,
+                title: "project execution.modelId updated",
+                payload: {
+                    projectRoot,
+                    shipJsonPath: changed.shipJsonPath,
+                    previousPrimary: changed.previousPrimary,
+                    nextPrimary: changed.nextPrimary,
+                },
+            });
+        }
+        catch (error) {
+            printResult({
+                asJson,
+                success: false,
+                title: "platform model use failed",
+                payload: {
+                    error: error instanceof Error ? error.message : String(error),
+                },
+            });
+            process.exitCode = 1;
+        }
+    });
+}
+//# sourceMappingURL=ModelReadCommand.js.map

package/bin/cli/model/ModelReadCommand.js.map

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

package/bin/cli/model/ModelSupport.d.ts

@@ -0,0 +1,40 @@
+/**
+ * `city model` 支撑工具。
+ *
+ * 关键点（中文）
+ * - 收敛“路径处理、provider 模型发现、项目 model 绑定写入”等可复用逻辑。
+ * - 让命令编排文件保持在可维护规模内。
+ */
+import type { LlmProviderType } from "@downcity/agent";
+export type ProviderDiscoveryResult = {
+    providerId: string;
+    providerType: LlmProviderType;
+    ok: boolean;
+    status?: number;
+    models: string[];
+    error?: string;
+};
+export declare function resolveEnvPlaceholder(value: string | undefined): string | undefined;
+export declare function resolveProviderDefaultBaseUrl(providerType: LlmProviderType): string | undefined;
+export declare function normalizeBaseUrl(value: string | undefined): string | undefined;
+export declare function extractModelIdsFromPayload(payload: unknown): string[];
+export declare function discoverProviderModels(params: {
+    providerId: string;
+    providerType: LlmProviderType;
+    baseUrl?: string;
+    apiKey?: string;
+}): Promise<ProviderDiscoveryResult>;
+export { resolveProjectRoot } from "../service/ServiceCommandSupport.js";
+/**
+ * 设置项目 `downcity.json.execution.modelId`。
+ *
+ * 关键点（中文）
+ * - 仅更新绑定字段，不触碰其他运行配置。
+ * - 该操作用于把“模型池中的模型 ID”绑定到具体 agent 项目。
+ */
+export declare function setProjectPrimaryModel(projectRoot: string, modelId: string): {
+    shipJsonPath: string;
+    previousPrimary: string;
+    nextPrimary: string;
+};
+//# sourceMappingURL=ModelSupport.d.ts.map

package/bin/cli/model/ModelSupport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModelSupport.d.ts","sourceRoot":"","sources":["../../../src/cli/model/ModelSupport.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAiBvD,MAAM,MAAM,uBAAuB,GAAG;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,eAAe,CAAC;IAC9B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAMnF;AAED,wBAAgB,6BAA6B,CAC3C,YAAY,EAAE,eAAe,GAC5B,MAAM,GAAG,SAAS,CAUpB;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAG9E;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,EAAE,CAgBrE;AAED,wBAAsB,sBAAsB,CAAC,MAAM,EAAE;IACnD,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,eAAe,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CA+FnC;AAED,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAEzE;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG;IAC5E,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;CACrB,CA0BA"}

package/bin/cli/model/ModelSupport.js

@@ -0,0 +1,201 @@
+/**
+ * `city model` 支撑工具。
+ *
+ * 关键点（中文）
+ * - 收敛“路径处理、provider 模型发现、项目 model 绑定写入”等可复用逻辑。
+ * - 让命令编排文件保持在可维护规模内。
+ */
+import fs from "fs-extra";
+import { getDowncityJsonPath } from "../../config/Paths.js";
+const OPENAI_COMPAT_PROVIDER_TYPES = new Set([
+    "openai",
+    "deepseek",
+    "moonshot-cn",
+    "moonshot-ai",
+    "kimi-code",
+    "xai",
+    "huggingface",
+    "openrouter",
+    "open-compatible",
+    "open-responses",
+]);
+export function resolveEnvPlaceholder(value) {
+    const raw = String(value || "").trim();
+    if (!raw)
+        return undefined;
+    const matched = raw.match(/^\$\{([A-Z0-9_]+)\}$/);
+    if (!matched)
+        return raw;
+    return process.env[matched[1]];
+}
+export function resolveProviderDefaultBaseUrl(providerType) {
+    if (providerType === "deepseek")
+        return "https://api.deepseek.com/v1";
+    if (providerType === "moonshot-cn")
+        return "https://api.moonshot.cn/v1";
+    if (providerType === "moonshot-ai")
+        return "https://api.moonshot.ai/v1";
+    if (providerType === "kimi-code")
+        return "https://api.kimi.com/coding/v1";
+    if (providerType === "xai")
+        return "https://api.x.ai/v1";
+    if (providerType === "openrouter")
+        return "https://openrouter.ai/api/v1";
+    if (providerType === "open-compatible")
+        return "https://api.openai.com/v1";
+    if (providerType === "open-responses")
+        return "https://api.openai.com/v1";
+    return undefined;
+}
+export function normalizeBaseUrl(value) {
+    const raw = String(value || "").trim().replace(/\/+$/, "");
+    return raw || undefined;
+}
+export function extractModelIdsFromPayload(payload) {
+    if (!payload || typeof payload !== "object")
+        return [];
+    const data = payload.data;
+    if (!Array.isArray(data))
+        return [];
+    const ids = [];
+    for (const item of data) {
+        if (!item || typeof item !== "object")
+            continue;
+        const id = String(item.id || "").trim();
+        if (id) {
+            ids.push(id);
+            continue;
+        }
+        const name = String(item.name || "").trim();
+        if (name)
+            ids.push(name);
+    }
+    return [...new Set(ids)];
+}
+export async function discoverProviderModels(params) {
+    const providerId = String(params.providerId || "").trim();
+    const providerType = params.providerType;
+    const baseUrl = normalizeBaseUrl(params.baseUrl) || resolveProviderDefaultBaseUrl(providerType);
+    const apiKey = resolveEnvPlaceholder(params.apiKey);
+    if (!apiKey) {
+        return {
+            providerId,
+            providerType,
+            ok: false,
+            models: [],
+            error: "Missing apiKey (or unresolved ${ENV_VAR})",
+        };
+    }
+    try {
+        if (providerType === "gemini") {
+            const url = `https://generativelanguage.googleapis.com/v1beta/models?key=${encodeURIComponent(apiKey)}`;
+            const response = await fetch(url, { method: "GET" });
+            const payload = (await response.json().catch(() => ({})));
+            const models = Array.isArray(payload.models)
+                ? payload.models
+                    .map((x) => String(x?.name || "").trim())
+                    .filter(Boolean)
+                    .map((x) => x.replace(/^models\//, ""))
+                : [];
+            return {
+                providerId,
+                providerType,
+                ok: response.ok,
+                status: response.status,
+                models: [...new Set(models)],
+                ...(response.ok ? {} : { error: `HTTP ${response.status}` }),
+            };
+        }
+        if (providerType === "anthropic") {
+            const url = "https://api.anthropic.com/v1/models";
+            const response = await fetch(url, {
+                method: "GET",
+                headers: {
+                    "x-api-key": apiKey,
+                    "anthropic-version": "2023-06-01",
+                },
+            });
+            const payload = (await response.json().catch(() => ({})));
+            const models = extractModelIdsFromPayload(payload);
+            return {
+                providerId,
+                providerType,
+                ok: response.ok,
+                status: response.status,
+                models,
+                ...(response.ok ? {} : { error: `HTTP ${response.status}` }),
+            };
+        }
+        if (OPENAI_COMPAT_PROVIDER_TYPES.has(providerType)) {
+            const endpointBase = baseUrl || "https://api.openai.com/v1";
+            const response = await fetch(`${endpointBase}/models`, {
+                method: "GET",
+                headers: {
+                    Authorization: `Bearer ${apiKey}`,
+                },
+            });
+            const payload = (await response.json().catch(() => ({})));
+            const models = extractModelIdsFromPayload(payload);
+            return {
+                providerId,
+                providerType,
+                ok: response.ok,
+                status: response.status,
+                models,
+                ...(response.ok ? {} : { error: `HTTP ${response.status}` }),
+            };
+        }
+        return {
+            providerId,
+            providerType,
+            ok: false,
+            models: [],
+            error: `Model discovery is not implemented for provider type: ${providerType}`,
+        };
+    }
+    catch (error) {
+        return {
+            providerId,
+            providerType,
+            ok: false,
+            models: [],
+            error: String(error),
+        };
+    }
+}
+export { resolveProjectRoot } from "../service/ServiceCommandSupport.js";
+/**
+ * 设置项目 `downcity.json.execution.modelId`。
+ *
+ * 关键点（中文）
+ * - 仅更新绑定字段，不触碰其他运行配置。
+ * - 该操作用于把“模型池中的模型 ID”绑定到具体 agent 项目。
+ */
+export function setProjectPrimaryModel(projectRoot, modelId) {
+    const shipJsonPath = getDowncityJsonPath(projectRoot);
+    if (!fs.existsSync(shipJsonPath)) {
+        throw new Error(`downcity.json not found at ${shipJsonPath}`);
+    }
+    const raw = fs.readJsonSync(shipJsonPath);
+    if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
+        throw new Error(`Invalid downcity.json: expected object (${shipJsonPath})`);
+    }
+    const previousPrimary = String(raw.execution?.type === "api" ? raw.execution.modelId || "" : "").trim();
+    const nextPrimary = String(modelId || "").trim();
+    if (!nextPrimary)
+        throw new Error("modelId cannot be empty");
+    const nextConfig = {
+        ...raw,
+        execution: {
+            type: "api",
+            modelId: nextPrimary,
+        },
+    };
+    fs.writeJsonSync(shipJsonPath, nextConfig, { spaces: 2 });
+    return {
+        shipJsonPath,
+        previousPrimary,
+        nextPrimary,
+    };
+}
+//# sourceMappingURL=ModelSupport.js.map

package/bin/cli/model/ModelSupport.js.map

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

package/bin/cli/model/preset/ModelPresetManager.d.ts

@@ -0,0 +1,71 @@
+/**
+ * ModelPresetManager：LLM 模型预设管理器。
+ *
+ * 关键点（中文）
+ * - 统一管理 init 场景的“模型预设清单 + providerType 映射 + 自定义模型标记”。
+ * - 避免命令层直接依赖硬编码常量，提升可维护性与一致性。
+ */
+import type { LlmProviderType } from "@downcity/agent";
+/**
+ * 单个模型预设定义。
+ */
+export type ModelPreset = {
+    /**
+     * 预设 ID（同时作为模型名称写入 `llm.models.<active>.name`，除自定义模型外）。
+     */
+    id: string;
+    /**
+     * 预设标题（用于 CLI 交互显示）。
+     */
+    title: string;
+    /**
+     * 对应 provider 类型（用于生成 `llm.providers.<id>.type`）。
+     */
+    providerTypes: readonly LlmProviderType[];
+    /**
+     * 是否属于“模型名由环境变量注入”的自定义模型类型。
+     */
+    useCustomModelName: boolean;
+};
+/**
+ * init 模型选择解析结果。
+ */
+export type ResolvedInitModelPreset = {
+    /**
+     * 规范化后的模型预设 ID。
+     */
+    selectedModelId: string;
+    /**
+     * 选中的模型预设。
+     */
+    preset: ModelPreset;
+};
+/**
+ * 模型预设管理器。
+ */
+export declare class ModelPresetManager {
+    private readonly presets;
+    private readonly presetsById;
+    constructor();
+    /**
+     * 列出所有可选模型预设（按定义顺序）。
+     */
+    listPresets(): ModelPreset[];
+    /**
+     * 根据预设 ID 获取模型预设。
+     */
+    getPreset(id: string): ModelPreset | undefined;
+    /**
+     * 判断预设是否支持指定 provider 类型。
+     */
+    supportsProviderType(preset: ModelPreset, providerType: LlmProviderType): boolean;
+    /**
+     * 获取默认模型预设。
+     */
+    getDefaultPreset(): ModelPreset;
+    /**
+     * 解析 init 输入的模型选择，并返回稳定的预设结果。
+     */
+    resolveInitPreset(input?: string): ResolvedInitModelPreset;
+}
+//# sourceMappingURL=ModelPresetManager.d.ts.map

package/bin/cli/model/preset/ModelPresetManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModelPresetManager.d.ts","sourceRoot":"","sources":["../../../../src/cli/model/preset/ModelPresetManager.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,aAAa,EAAE,SAAS,eAAe,EAAE,CAAC;IAE1C;;OAEG;IACH,kBAAkB,EAAE,OAAO,CAAC;CAC7B,CAAC;AAgIF;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC;;OAEG;IACH,eAAe,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,MAAM,EAAE,WAAW,CAAC;CACrB,CAAC;AAEF;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA2B;;IASvD;;OAEG;IACH,WAAW,IAAI,WAAW,EAAE;IAI5B;;OAEG;IACH,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAM9C;;OAEG;IACH,oBAAoB,CAAC,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,eAAe,GAAG,OAAO;IAIjF;;OAEG;IACH,gBAAgB,IAAI,WAAW;IAQ/B;;OAEG;IACH,iBAAiB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,uBAAuB;CAc3D"}