@downcity/city 1.1.1 → 1.1.5

package/bin/cli/shared/Update.js

@@ -0,0 +1,150 @@
+/**
+ * `city update`：更新全局 downcity CLI。
+ *
+ * 关键点（中文）
+ * - 优先根据当前 CLI 所在的全局模块目录，自动判断是 npm 还是 pnpm 安装。
+ * - 允许用户通过 `--manager` 显式覆盖包管理器选择。
+ * - 实际更新只负责全局包升级，不自动重启已有 runtime/Console 进程。
+ */
+import fs from "fs";
+import path from "path";
+import { execFileSync, spawn } from "node:child_process";
+import { fileURLToPath } from "url";
+import { emitCliBlock } from "./CliReporter.js";
+import { CliError } from "./CliError.js";
+import { runWithSpinner } from "../../utils/cli/Spinner.js";
+const GLOBAL_PACKAGE_NAME = "downcity";
+/**
+ * 构造全局更新命令。
+ */
+export function buildGlobalUpdateInvocation(manager) {
+    if (manager === "pnpm") {
+        return {
+            command: "pnpm",
+            args: ["add", "-g", `${GLOBAL_PACKAGE_NAME}@latest`],
+        };
+    }
+    return {
+        command: "npm",
+        args: ["install", "-g", `${GLOBAL_PACKAGE_NAME}@latest`],
+    };
+}
+/**
+ * 根据全局模块根目录判断当前 CLI 来源。
+ */
+export function resolveUpdateManagerFromGlobalRoots(params) {
+    const packageRoot = normalizeRealPath(params.packageRoot) || path.resolve(params.packageRoot);
+    const pnpmRoot = normalizeRealPath(params.pnpmRoot);
+    const npmRoot = normalizeRealPath(params.npmRoot);
+    if (pnpmRoot && isSubPath(packageRoot, pnpmRoot))
+        return "pnpm";
+    if (npmRoot && isSubPath(packageRoot, npmRoot))
+        return "npm";
+    return null;
+}
+function normalizeRealPath(target) {
+    const raw = String(target || "").trim();
+    if (!raw)
+        return null;
+    try {
+        return fs.realpathSync(raw);
+    }
+    catch {
+        return path.resolve(raw);
+    }
+}
+function isSubPath(targetPath, rootPath) {
+    const relative = path.relative(rootPath, targetPath);
+    return relative === "" || (!relative.startsWith("..") && !path.isAbsolute(relative));
+}
+function readGlobalRoot(manager) {
+    try {
+        const output = execFileSync(manager, ["root", "-g"], {
+            encoding: "utf8",
+            stdio: ["ignore", "pipe", "ignore"],
+        });
+        const trimmed = String(output || "").trim();
+        return trimmed || null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 自动判断当前全局安装使用的包管理器。
+ */
+export function detectInstalledUpdateManager() {
+    const __filename = fileURLToPath(import.meta.url);
+    const __dirname = path.dirname(__filename);
+    const packageRoot = path.resolve(__dirname, "../..");
+    const detected = resolveUpdateManagerFromGlobalRoots({
+        packageRoot,
+        npmRoot: readGlobalRoot("npm") || undefined,
+        pnpmRoot: readGlobalRoot("pnpm") || undefined,
+    });
+    return detected || "npm";
+}
+async function runCommand(command, args) {
+    await new Promise((resolve, reject) => {
+        const child = spawn(command, args, {
+            stdio: "inherit",
+            env: process.env,
+        });
+        child.on("error", reject);
+        child.on("exit", (code) => {
+            if (code === 0) {
+                resolve();
+                return;
+            }
+            reject(new Error(`${command} exited with code ${String(code)}`));
+        });
+    });
+}
+/**
+ * update 命令入口。
+ */
+export async function updateCommand(options = {}) {
+    const manager = options.manager && options.manager !== "auto"
+        ? options.manager
+        : detectInstalledUpdateManager();
+    const invocation = buildGlobalUpdateInvocation(manager);
+    emitCliBlock({
+        tone: "accent",
+        title: "Updating downcity",
+        facts: [
+            {
+                label: "Manager",
+                value: manager,
+            },
+            {
+                label: "Command",
+                value: `${invocation.command} ${invocation.args.join(" ")}`,
+            },
+        ],
+    });
+    try {
+        await runWithSpinner(() => runCommand(invocation.command, invocation.args), { text: `Installing ${GLOBAL_PACKAGE_NAME}@latest via ${manager}...` });
+    }
+    catch (error) {
+        throw new CliError({
+            title: "Failed to update downcity",
+            note: error instanceof Error ? error.message : String(error),
+        });
+    }
+    emitCliBlock({
+        tone: "success",
+        title: "Downcity updated",
+        facts: [
+            {
+                label: "Package",
+                value: `${GLOBAL_PACKAGE_NAME}@latest`,
+            },
+            {
+                label: "Manager",
+                value: manager,
+            },
+        ],
+        note: "如果当前已有 city runtime / Console 在运行，建议执行 `city restart` 载入最新版本。",
+    });
+}
+//# sourceMappingURL=Update.js.map

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

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

package/bin/config/DowncitySchema.d.ts

@@ -0,0 +1,3 @@
+import type { JsonObject } from "@downcity/agent";
+export declare const DOWNCITY_JSON_SCHEMA: JsonObject;
+//# sourceMappingURL=DowncitySchema.d.ts.map

package/bin/config/DowncitySchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DowncitySchema.d.ts","sourceRoot":"","sources":["../../src/config/DowncitySchema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,eAAO,MAAM,oBAAoB,EAAE,UAsXlC,CAAC"}

package/bin/config/DowncitySchema.js

@@ -0,0 +1,367 @@
+export const DOWNCITY_JSON_SCHEMA = {
+    $schema: "https://json-schema.org/draft/2020-12/schema",
+    $id: "https://downcity.ai/schemas/downcity.schema.json",
+    title: "Downcity downcity.json",
+    type: "object",
+    additionalProperties: true,
+    properties: {
+        $schema: {
+            type: "string",
+            description: "JSON Schema reference for editor/IDE validation (e.g. ./.downcity/schema/downcity.schema.json).",
+        },
+        name: { type: "string" },
+        version: { type: "string" },
+        description: { type: "string" },
+        start: {
+            type: "object",
+            additionalProperties: true,
+            properties: {
+                port: { type: "integer", minimum: 1, maximum: 65535 },
+                host: { type: "string" },
+            },
+        },
+        execution: {
+            type: "object",
+            additionalProperties: true,
+            properties: {
+                type: {
+                    type: "string",
+                    enum: ["api", "acp", "local"],
+                },
+                modelId: {
+                    type: "string",
+                    description: "API 执行模式下绑定的平台全局模型 ID。",
+                },
+                agent: {
+                    type: "object",
+                    additionalProperties: true,
+                    properties: {
+                        type: {
+                            type: "string",
+                            enum: ["codex", "claude", "kimi"],
+                        },
+                        command: { type: "string" },
+                        args: {
+                            type: "array",
+                            items: { type: "string" },
+                        },
+                        env: {
+                            type: "object",
+                            additionalProperties: { type: "string" },
+                        },
+                    },
+                    required: ["type"],
+                },
+                local: {
+                    type: "null",
+                    description: "本地执行模式不再从 execution.local 读取配置；请改为使用 plugins.lmp。",
+                },
+            },
+            required: ["type"],
+            allOf: [
+                {
+                    if: {
+                        properties: {
+                            type: { const: "api" },
+                        },
+                    },
+                    then: {
+                        required: ["modelId"],
+                    },
+                },
+                {
+                    if: {
+                        properties: {
+                            type: { const: "acp" },
+                        },
+                    },
+                    then: {
+                        required: ["agent"],
+                    },
+                },
+                {
+                    if: {
+                        properties: {
+                            type: { const: "local" },
+                        },
+                    },
+                    then: true,
+                },
+            ],
+        },
+        sandbox: {
+            type: "object",
+            additionalProperties: true,
+            description: "Shell / CLI sandbox boundary configuration for local command execution. Sandbox is always required for shell execution.",
+            properties: {
+                envAllowlist: {
+                    type: "array",
+                    description: "Environment variable names that may be exported into the sandbox.",
+                    items: { type: "string" },
+                },
+                writablePaths: {
+                    type: "array",
+                    description: "Writable paths, absolute or relative to the project root.",
+                    items: { type: "string" },
+                },
+                networkMode: {
+                    type: "string",
+                    enum: ["off", "restricted", "full"],
+                    description: "Network boundary for sandboxed shell execution.",
+                },
+            },
+        },
+        services: {
+            type: "object",
+            additionalProperties: true,
+            properties: {
+                skills: {
+                    type: "object",
+                    additionalProperties: true,
+                    properties: {
+                        paths: { type: "array", items: { type: "string" } },
+                        allowExternalPaths: { type: "boolean" },
+                    },
+                },
+                chat: {
+                    type: "object",
+                    additionalProperties: true,
+                    properties: {
+                        queue: {
+                            type: "object",
+                            additionalProperties: true,
+                            properties: {
+                                maxConcurrency: { type: "integer", minimum: 1, maximum: 32 },
+                                mergeDebounceMs: { type: "integer", minimum: 0, maximum: 60000 },
+                                mergeMaxWaitMs: { type: "integer", minimum: 0, maximum: 120000 },
+                            },
+                        },
+                        egress: {
+                            type: "object",
+                            additionalProperties: true,
+                            properties: {
+                                chatSendMaxCallsPerRun: { type: "integer", minimum: 1, maximum: 500 },
+                                chatSendIdempotency: { type: "boolean" },
+                            },
+                        },
+                        channels: {
+                            type: "object",
+                            additionalProperties: true,
+                            description: "Chat platform channels (Telegram / Feishu / QQ...).",
+                            properties: {
+                                telegram: {
+                                    type: "object",
+                                    additionalProperties: true,
+                                    properties: {
+                                        enabled: { type: "boolean" },
+                                        channelAccountId: { type: "string" },
+                                    },
+                                },
+                                feishu: {
+                                    type: "object",
+                                    additionalProperties: true,
+                                    properties: {
+                                        enabled: { type: "boolean" },
+                                        channelAccountId: { type: "string" },
+                                    },
+                                },
+                                qq: {
+                                    type: "object",
+                                    additionalProperties: true,
+                                    properties: {
+                                        enabled: { type: "boolean" },
+                                        channelAccountId: { type: "string" },
+                                    },
+                                },
+                            },
+                        },
+                    },
+                },
+            },
+        },
+        plugins: {
+            type: "object",
+            additionalProperties: true,
+            properties: {
+                asr: {
+                    type: "object",
+                    additionalProperties: true,
+                    properties: {
+                        injectPrompt: { type: "boolean" },
+                        augmentMessage: { type: "boolean" },
+                        provider: { type: "string", enum: ["local", "command"] },
+                        modelId: {
+                            type: "string",
+                            enum: [
+                                "SenseVoiceSmall",
+                                "paraformer-zh-streaming",
+                                "whisper-large-v3-turbo",
+                            ],
+                        },
+                        modelsDir: { type: "string" },
+                        pythonBin: { type: "string" },
+                        command: { type: "string" },
+                        language: { type: "string" },
+                        timeoutMs: { type: "integer", minimum: 1000, maximum: 600000 },
+                        strategy: {
+                            type: "string",
+                            enum: ["auto", "funasr", "transformers-whisper", "command"],
+                        },
+                        installedModels: {
+                            type: "array",
+                            items: {
+                                type: "string",
+                                enum: [
+                                    "SenseVoiceSmall",
+                                    "paraformer-zh-streaming",
+                                    "whisper-large-v3-turbo",
+                                ],
+                            },
+                        },
+                    },
+                },
+                tts: {
+                    type: "object",
+                    additionalProperties: true,
+                    properties: {
+                        provider: {
+                            type: "string",
+                            enum: ["local"],
+                        },
+                        modelId: {
+                            type: "string",
+                            enum: ["qwen3-tts-0.6b", "kokoro-82m", "qwen3-tts-1.7b"],
+                        },
+                        modelsDir: { type: "string" },
+                        pythonBin: { type: "string" },
+                        language: { type: "string" },
+                        voice: { type: "string" },
+                        format: {
+                            type: "string",
+                            enum: ["wav", "flac"],
+                        },
+                        speed: { type: "number", minimum: 0.5, maximum: 2 },
+                        outputDir: { type: "string" },
+                        timeoutMs: { type: "integer", minimum: 5000, maximum: 900000 },
+                        installedModels: {
+                            type: "array",
+                            items: {
+                                type: "string",
+                                enum: ["qwen3-tts-0.6b", "kokoro-82m", "qwen3-tts-1.7b"],
+                            },
+                        },
+                    },
+                },
+                lmp: {
+                    type: "object",
+                    additionalProperties: true,
+                    properties: {
+                        provider: {
+                            type: "string",
+                            enum: ["llama"],
+                        },
+                        model: {
+                            type: "string",
+                            description: "当前激活的本地模型文件名或绝对路径；相对路径默认相对 plugins.lmp.modelsDir。",
+                        },
+                        modelsDir: {
+                            type: "string",
+                            description: "本地模型目录，默认 ~/.models。",
+                        },
+                        command: {
+                            type: "string",
+                            description: "llama-server 可执行命令，默认 llama-server。",
+                        },
+                        args: {
+                            type: "array",
+                            items: { type: "string" },
+                        },
+                        host: { type: "string" },
+                        port: { type: "integer", minimum: 1, maximum: 65535 },
+                        contextSize: { type: "integer", minimum: 512, maximum: 1048576 },
+                        gpuLayers: { type: "integer", minimum: -1, maximum: 65535 },
+                        autoStart: { type: "boolean" },
+                        installedModels: {
+                            type: "array",
+                            items: {
+                                type: "string",
+                            },
+                        },
+                    },
+                },
+            },
+        },
+        llm: {
+            type: "object",
+            additionalProperties: true,
+            properties: {
+                providers: {
+                    type: "object",
+                    additionalProperties: {
+                        type: "object",
+                        additionalProperties: true,
+                        properties: {
+                            type: {
+                                type: "string",
+                                enum: [
+                                    "anthropic",
+                                    "openai",
+                                    "deepseek",
+                                    "gemini",
+                                    "open-compatible",
+                                    "open-responses",
+                                    "moonshot-cn",
+                                    "moonshot-ai",
+                                    "kimi-code",
+                                    "xai",
+                                    "huggingface",
+                                    "openrouter",
+                                ],
+                            },
+                            baseUrl: { type: "string" },
+                            apiKey: { type: "string" },
+                        },
+                        required: ["type"],
+                    },
+                },
+                models: {
+                    type: "object",
+                    additionalProperties: {
+                        type: "object",
+                        additionalProperties: true,
+                        properties: {
+                            provider: { type: "string" },
+                            name: { type: "string" },
+                            temperature: { type: "number" },
+                            maxTokens: { type: "number" },
+                            topP: { type: "number" },
+                            frequencyPenalty: { type: "number" },
+                            presencePenalty: { type: "number" },
+                            anthropicVersion: { type: "string" },
+                        },
+                        required: ["provider", "name"],
+                    },
+                },
+                logMessages: { type: "boolean" },
+            },
+            required: ["providers", "models"],
+        },
+        context: {
+            type: "object",
+            additionalProperties: true,
+            properties: {
+                messages: {
+                    type: "object",
+                    additionalProperties: true,
+                    properties: {
+                        keepLastMessages: { type: "integer", minimum: 6, maximum: 5000 },
+                        maxInputTokensApprox: { type: "integer", minimum: 2000, maximum: 200000 },
+                        archiveOnCompact: { type: "boolean" },
+                        compactRatio: { type: "number", minimum: 0.1, maximum: 0.9 },
+                    },
+                },
+            },
+        },
+    },
+};
+//# sourceMappingURL=DowncitySchema.js.map

package/bin/config/DowncitySchema.js.map

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

package/bin/control/AgentStatusApiRoutes.d.ts

@@ -0,0 +1,28 @@
+/**
+ * 平台 Agent 状态探活路由。
+ *
+ * 关键点（中文）
+ * - 启动窗口期的 agent 状态探测放到 UI 网关内部执行，避免浏览器直接看到 500/503 噪音。
+ * - 该接口始终返回 200 + 结构化状态，前端按状态轮询即可。
+ * - ready 判定收敛在这里，保持前端逻辑尽量薄。
+ */
+import type { Hono } from "hono";
+import type { PlatformAgentOption } from "@downcity/agent";
+/**
+ * 注册 Agent 状态探活 API 路由。
+ */
+export declare function registerPlatformAgentStatusRoutes(params: {
+    /**
+     * Hono 应用实例。
+     */
+    app: Hono;
+    /**
+     * 从请求中读取目标 agent id。
+     */
+    readRequestedAgentId: (request: Request) => string;
+    /**
+     * 解析当前应使用的 agent。
+     */
+    resolveSelectedAgent: (requestedAgentId: string) => Promise<PlatformAgentOption | null>;
+}): void;
+//# sourceMappingURL=AgentStatusApiRoutes.d.ts.map

package/bin/control/AgentStatusApiRoutes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentStatusApiRoutes.d.ts","sourceRoot":"","sources":["../../src/control/AgentStatusApiRoutes.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACjC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAgL3D;;GAEG;AACH,wBAAgB,iCAAiC,CAAC,MAAM,EAAE;IACxD;;OAEG;IACH,GAAG,EAAE,IAAI,CAAC;IACV;;OAEG;IACH,oBAAoB,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,CAAC;IACnD;;OAEG;IACH,oBAAoB,EAAE,CAAC,gBAAgB,EAAE,MAAM,KAAK,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAAC;CACzF,GAAG,IAAI,CAsBP"}