@downcity/city 1.1.1 → 1.1.4

package/src/http/static/static.ts

@@ -1,104 +0,0 @@
-/**
- * 静态资源路由模块。
- *
- * 职责说明：
- * 1. 提供根目录前端静态文件访问。
- * 2. 提供 `.downcity/public` 的受限文件暴露。
- * 3. 只处理静态资源协议，不承载业务逻辑。
- */
-
-import { Hono } from "hono";
-import fs from "fs-extra";
-import path from "path";
-import { getDowncityPublicDirPath } from "@/config/Paths.js";
-import { getAgentRuntime } from "@/agent/AgentRuntime.js";
-
-/**
- * 静态资源路由。
- */
-export const staticRouter = new Hono();
-
-staticRouter.get("/", async (c) => {
-  const indexPath = path.join(getAgentRuntime().rootPath, "public", "index.html");
-  if (await fs.pathExists(indexPath)) {
-    const content = await fs.readFile(indexPath, "utf-8");
-    return c.body(content, 200, {
-      "Content-Type": "text/html; charset=utf-8",
-      "Cache-Control": "no-cache",
-    });
-  }
-  return c.text("Downcity Agent Server", 200);
-});
-
-staticRouter.get("/styles.css", async (c) => {
-  const cssPath = path.join(getAgentRuntime().rootPath, "public", "styles.css");
-  if (await fs.pathExists(cssPath)) {
-    const content = await fs.readFile(cssPath, "utf-8");
-    return c.body(content, 200, {
-      "Content-Type": "text/css; charset=utf-8",
-      "Cache-Control": "no-cache",
-    });
-  }
-  return c.text("Not Found", 404);
-});
-
-staticRouter.get("/app.js", async (c) => {
-  const jsPath = path.join(getAgentRuntime().rootPath, "public", "app.js");
-  if (await fs.pathExists(jsPath)) {
-    const content = await fs.readFile(jsPath, "utf-8");
-    return c.body(content, 200, {
-      "Content-Type": "application/javascript; charset=utf-8",
-      "Cache-Control": "no-cache",
-    });
-  }
-  return c.text("Not Found", 404);
-});
-
-staticRouter.get("/downcity/public/*", async (c) => {
-  const root = getDowncityPublicDirPath(getAgentRuntime().rootPath);
-  const prefix = "/downcity/public/";
-  const requestPath = c.req.path;
-  const rel = requestPath.startsWith(prefix)
-    ? requestPath.slice(prefix.length)
-    : "";
-  if (!rel) return c.text("Not Found", 404);
-
-  const full = path.resolve(root, rel);
-  const rootResolved = path.resolve(root);
-  if (full !== rootResolved && !full.startsWith(rootResolved + path.sep)) {
-    return c.text("Forbidden", 403);
-  }
-
-  try {
-    const stat = await fs.stat(full);
-    if (!stat.isFile()) return c.text("Not Found", 404);
-  } catch {
-    return c.text("Not Found", 404);
-  }
-
-  const ext = path.extname(full).toLowerCase();
-  const contentType =
-    ext === ".html"
-      ? "text/html; charset=utf-8"
-      : ext === ".css"
-        ? "text/css; charset=utf-8"
-        : ext === ".js"
-          ? "application/javascript; charset=utf-8"
-          : ext === ".json"
-            ? "application/json; charset=utf-8"
-            : ext === ".txt" || ext === ".md"
-              ? "text/plain; charset=utf-8"
-              : ext === ".pdf"
-                ? "application/pdf"
-                : ext === ".png"
-                  ? "image/png"
-                  : ext === ".jpg" || ext === ".jpeg"
-                    ? "image/jpeg"
-                    : "application/octet-stream";
-
-  const buf = await fs.readFile(full);
-  return c.body(buf, 200, {
-    "Content-Type": contentType,
-    "Cache-Control": "no-cache",
-  });
-});

package/src/model/CreateModel.ts

@@ -1,343 +0,0 @@
-/**
- * LLM provider/model factory.
- *
- * 设计目标（中文，关键点）
- * - 这是“核心能力”，不应该依赖 server/RuntimeContext（避免隐式初始化时序）。
- * - `execution.type=api` 时，从 console 全局 `llm.models` / `llm.providers` 解析最终模型。
- * - 当前只有 `api` 执行模式。
- */
-
-import { createAnthropic } from "@ai-sdk/anthropic";
-import { createGoogleGenerativeAI } from "@ai-sdk/google";
-import { createHuggingFace } from "@ai-sdk/huggingface";
-import { createMoonshotAI } from "@ai-sdk/moonshotai";
-import { createOpenResponses } from "@ai-sdk/open-responses";
-import { createOpenAI } from "@ai-sdk/openai";
-import { createOpenAICompatible } from "@ai-sdk/openai-compatible";
-import { createXai } from "@ai-sdk/xai";
-import { createOpenRouter } from "@openrouter/ai-sdk-provider";
-import { type LanguageModel } from "ai";
-import { createLlmLoggingFetch } from "@shared/utils/logger/Fetch.js";
-import { getLogger } from "@shared/utils/logger/Logger.js";
-import type { DowncityConfig } from "@/shared/types/DowncityConfig.js";
-import type { LlmProviderType } from "@/shared/types/LlmConfig.js";
-import { ConsoleStore } from "@shared/utils/store/index.js";
-import { readProjectExecutionBinding } from "@/agent/project/ProjectExecutionBinding.js";
-
-type ModelLogContext = {
-  sessionId?: string;
-};
-
-function buildResponsesUrl(baseUrl?: string): string {
-  const trimmed = String(baseUrl || "")
-    .trim()
-    .replace(/\/+$/, "");
-  if (!trimmed) return "https://api.openai.com/v1/responses";
-  if (trimmed.endsWith("/responses")) return trimmed;
-  return `${trimmed}/responses`;
-}
-
-function normalizeOptionalBaseUrl(value: string | undefined): string | undefined {
-  const trimmed = String(value || "")
-    .trim()
-    .replace(/\/+$/, "");
-  return trimmed || undefined;
-}
-
-/**
- * provider 默认 baseUrl。
- *
- * 关键点（中文）
- * - 当 `downcity.json.llm.providers.<id>.baseUrl` 省略时，按 provider type 自动补全。
- * - 保持“只配置 provider type + apiKey + modelName”也能跑通常见 provider。
- */
-function resolveProviderDefaultBaseUrl(
-  providerType: LlmProviderType,
-): string | undefined {
-  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";
-  return undefined;
-}
-
-function resolveEnvPlaceholder(value: string | undefined): string | undefined {
-  if (!value) return value;
-  if (value.startsWith("${") && value.endsWith("}")) {
-    const envVar = value.slice(2, -1);
-    return process.env[envVar];
-  }
-  return value;
-}
-
-function resolveApiKeyFallback(providerType: LlmProviderType): string | undefined {
-  if (providerType === "gemini") {
-    return (
-      process.env.GEMINI_API_KEY ||
-      process.env.GOOGLE_API_KEY ||
-      process.env.GOOGLE_GENERATIVE_AI_API_KEY ||
-      process.env.API_KEY
-    );
-  }
-  if (providerType === "anthropic") {
-    return process.env.ANTHROPIC_API_KEY || process.env.API_KEY;
-  }
-  if (providerType === "deepseek") {
-    return (
-      process.env.DEEPSEEK_API_KEY ||
-      process.env.OPENAI_API_KEY ||
-      process.env.API_KEY
-    );
-  }
-  if (providerType === "xai") {
-    return process.env.XAI_API_KEY || process.env.API_KEY;
-  }
-  if (providerType === "huggingface") {
-    return (
-      process.env.HUGGINGFACE_API_KEY ||
-      process.env.HF_TOKEN ||
-      process.env.API_KEY
-    );
-  }
-  if (providerType === "openrouter") {
-    return process.env.OPENROUTER_API_KEY || process.env.API_KEY;
-  }
-  if (providerType === "moonshot-cn" || providerType === "moonshot-ai") {
-    return (
-      process.env.MOONSHOT_API_KEY ||
-      process.env.KIMI_API_KEY ||
-      process.env.API_KEY
-    );
-  }
-  if (providerType === "kimi-code") {
-    return (
-      process.env.KIMI_CODE_API_KEY ||
-      process.env.KIMI_API_KEY ||
-      process.env.MOONSHOT_API_KEY ||
-      process.env.API_KEY
-    );
-  }
-  return process.env.OPENAI_API_KEY || process.env.API_KEY;
-}
-
-function normalizeProviderType(value: unknown): LlmProviderType | null {
-  if (value === "anthropic") return value;
-  if (value === "openai") return value;
-  if (value === "deepseek") return value;
-  if (value === "gemini") return value;
-  if (value === "open-compatible") return value;
-  if (value === "open-responses") return value;
-  if (value === "moonshot-cn") return value;
-  if (value === "moonshot-ai") return value;
-  if (value === "kimi-code") return value;
-  if (value === "xai") return value;
-  if (value === "huggingface") return value;
-  if (value === "openrouter") return value;
-  return null;
-}
-
-/**
- * 创建 LanguageModel 实例。
- *
- * 解析策略（中文）
- * 1) 读取 `execution`，确认是 `api` 模式。
- * `api`：定位 console 全局 `llm.models[modelId]` 与 `llm.providers[providerKey]`。
- * 创建带日志拦截的 fetch，并按 provider type 分发到 SDK 工厂。
- */
-export async function createModel(input: {
-  config: DowncityConfig;
-  getSessionRunScope?: () => ModelLogContext | undefined;
-  store?: ConsoleStore;
-  projectRoot?: string;
-}): Promise<LanguageModel> {
-  const logger = getLogger();
-  const execution = readProjectExecutionBinding(input.config);
-  if (!execution) {
-    await logger.log("warn", "No agent execution configured");
-    throw Error("No agent execution configured");
-  }
-
-  // 日志策略（中文）：默认开启 LLM 请求日志；可通过 llm.logMessages 关闭。
-  const configLog = input.config.llm?.logMessages;
-  const logLlmMessages = typeof configLog === "boolean" ? configLog : true;
-  const loggingFetch = createLlmLoggingFetch({
-    logger,
-    enabled: logLlmMessages,
-    getSessionRunScope: input.getSessionRunScope,
-  });
-  if (!execution || execution.type !== "api") {
-    await logger.log("warn", `Unsupported agent execution for createModel: ${execution.type}`);
-    throw Error(`Unsupported agent execution for createModel: ${execution.type}`);
-  }
-
-  const primaryModelId = execution.modelId;
-
-  const store = input.store || new ConsoleStore();
-  const resolved = await store.getResolvedModel(primaryModelId);
-  if (!input.store) {
-    store.close();
-  }
-  if (!resolved) {
-    await logger.log("warn", `LLM model config not found in sqlite store: ${primaryModelId}`);
-    throw Error(`LLM model config not found in sqlite store: ${primaryModelId}`);
-  }
-  const selectedModelConfig = resolved.model;
-  const selectedProviderConfig = resolved.provider;
-  if (selectedModelConfig.isPaused === true) {
-    await logger.log(
-      "warn",
-      `LLM model is paused in sqlite store: ${primaryModelId}`,
-    );
-    throw Error(`LLM model is paused: ${primaryModelId}`);
-  }
-  const providerKey = selectedProviderConfig.id;
-
-  const providerType = normalizeProviderType(selectedProviderConfig.type);
-  if (!providerType) {
-    await logger.log("warn", `Unsupported LLM provider type: ${selectedProviderConfig.type}`);
-    throw Error(`Unsupported LLM provider type: ${selectedProviderConfig.type}`);
-  }
-
-  const resolvedModel = resolveEnvPlaceholder(selectedModelConfig.name);
-  if (!resolvedModel || resolvedModel === "${}") {
-    await logger.log("warn", "No LLM model name configured");
-    throw Error("No LLM model name configured");
-  }
-
-  const resolvedBaseUrl = normalizeOptionalBaseUrl(
-    resolveEnvPlaceholder(selectedProviderConfig.baseUrl) ||
-      resolveProviderDefaultBaseUrl(providerType),
-  );
-
-  let resolvedApiKey = resolveEnvPlaceholder(selectedProviderConfig.apiKey);
-  if (!resolvedApiKey) {
-    resolvedApiKey = resolveApiKeyFallback(providerType);
-  }
-  if (!resolvedApiKey) {
-    await logger.log("warn", "No API Key configured, will use simulation mode");
-    throw Error("No API Key configured, will use simulation mode");
-  }
-
-  // 关键点（中文）：启动阶段只打印一次当前生效模型状态，便于快速确认路由是否正确。
-  await logger.log(
-    "info",
-    `[main] model primary=${primaryModelId} provider=${providerType}/${providerKey} name=${resolvedModel}${resolvedBaseUrl ? ` baseUrl=${resolvedBaseUrl}` : ""}`,
-    {
-      kind: "llm_model_ready",
-      primaryModel: primaryModelId,
-      providerType,
-      providerKey,
-      model: resolvedModel,
-      ...(resolvedBaseUrl ? { baseUrl: resolvedBaseUrl } : {}),
-      logMessages: logLlmMessages,
-    },
-  );
-
-  if (providerType === "anthropic") {
-    const anthropicProvider = createAnthropic({
-      apiKey: resolvedApiKey,
-      baseURL: resolvedBaseUrl,
-      fetch: loggingFetch as typeof fetch,
-    });
-    return anthropicProvider(resolvedModel);
-  }
-
-  if (providerType === "gemini") {
-    const googleProvider = createGoogleGenerativeAI({
-      apiKey: resolvedApiKey,
-      baseURL: resolvedBaseUrl,
-      fetch: loggingFetch as typeof fetch,
-    });
-    return googleProvider(resolvedModel);
-  }
-
-  if (providerType === "open-responses") {
-    const responsesProvider = createOpenResponses({
-      url: buildResponsesUrl(resolvedBaseUrl),
-      name: providerKey,
-      apiKey: resolvedApiKey,
-      fetch: loggingFetch as typeof fetch,
-    });
-    return responsesProvider(resolvedModel);
-  }
-
-  if (providerType === "open-compatible") {
-    const compatibleBaseUrl = resolvedBaseUrl || "https://api.openai.com/v1";
-    const compatibleProvider = createOpenAICompatible({
-      name: providerKey,
-      baseURL: compatibleBaseUrl,
-      apiKey: resolvedApiKey,
-      fetch: loggingFetch as typeof fetch,
-    });
-    return compatibleProvider(resolvedModel);
-  }
-
-  if (providerType === "kimi-code") {
-    const compatibleBaseUrl = resolvedBaseUrl || "https://api.kimi.com/coding/v1";
-    const compatibleProvider = createOpenAICompatible({
-      name: providerKey,
-      baseURL: compatibleBaseUrl,
-      apiKey: resolvedApiKey,
-      fetch: loggingFetch as typeof fetch,
-    });
-    return compatibleProvider(resolvedModel);
-  }
-
-  if (providerType === "moonshot-cn" || providerType === "moonshot-ai") {
-    const moonshotProvider = createMoonshotAI({
-      baseURL: resolvedBaseUrl,
-      apiKey: resolvedApiKey,
-      fetch: loggingFetch as typeof fetch,
-    });
-    return moonshotProvider(resolvedModel);
-  }
-
-  if (providerType === "xai") {
-    const xaiProvider = createXai({
-      baseURL: resolvedBaseUrl,
-      apiKey: resolvedApiKey,
-      fetch: loggingFetch as typeof fetch,
-    });
-    return xaiProvider(resolvedModel);
-  }
-
-  if (providerType === "huggingface") {
-    const huggingFaceProvider = createHuggingFace({
-      baseURL: resolvedBaseUrl,
-      apiKey: resolvedApiKey,
-      fetch: loggingFetch as typeof fetch,
-    });
-    return huggingFaceProvider(resolvedModel);
-  }
-
-  if (providerType === "openrouter") {
-    const openRouterProvider = createOpenRouter({
-      baseURL: resolvedBaseUrl,
-      apiKey: resolvedApiKey,
-      fetch: loggingFetch as typeof fetch,
-    });
-    return openRouterProvider(resolvedModel);
-  }
-
-  // DeepSeek 只支持 Chat Completions，不能用 Responses API。
-  if (providerType === "deepseek") {
-    const deepseekProvider = createOpenAICompatible({
-      name: providerKey,
-      baseURL: resolvedBaseUrl || "https://api.deepseek.com/v1",
-      apiKey: resolvedApiKey,
-      fetch: loggingFetch as typeof fetch,
-    });
-    return deepseekProvider(resolvedModel);
-  }
-
-  // OpenAI-compatible providers（中文）：
-  // - openai 统一走 OpenAI SDK（Responses/Completions 由 SDK 自适配）。
-  const openaiCompatibleProvider = createOpenAI({
-    apiKey: resolvedApiKey,
-    baseURL: resolvedBaseUrl,
-    fetch: loggingFetch as typeof fetch,
-  });
-  return openaiCompatibleProvider(resolvedModel);
-}

package/src/plugin/Activation.ts

@@ -1,22 +0,0 @@
-/**
- * Plugin 激活判定工具。
- *
- * 关键点（中文）
- * - 统一收敛“某个 plugin 在当前 city 配置下是否启用”的规则。
- * - plugin 启用态属于 city 级生命周期配置，不再来自 agent `downcity.json`。
- */
-
-import type { Plugin } from "@/shared/types/Plugin.js";
-import { isCityPluginEnabled } from "@/plugin/Lifecycle.js";
-
-/**
- * 读取当前 city 配置下的 plugin 启用态。
- */
-export function isPluginEnabled(params: {
-  plugin: Plugin;
-}): boolean {
-  const pluginName = String(params.plugin.name || "").trim();
-  if (!pluginName) return false;
-  if (pluginName === "auth") return true;
-  return isCityPluginEnabled(pluginName);
-}

package/src/plugin/Catalog.ts

@@ -1,118 +0,0 @@
-/**
- * Plugin Catalog。
- *
- * 关键点（中文）
- * - 这里承载 console 侧的静态 plugin 元数据视图。
- * - 目标是把“控制面可见的 plugin 定义”从 agent 执行态里拆出来复用。
- * - 当前先服务 Console 与 `city plugin` CLI 的静态回退场景。
- */
-
-import { PLUGINS } from "@/plugin/Plugins.js";
-import { isPluginEnabled } from "@/plugin/Activation.js";
-import type {
-  Plugin,
-  PluginAvailability,
-  PluginView,
-} from "@/shared/types/Plugin.js";
-
-/**
- * 将 Plugin 定义转换成静态概览视图。
- */
-export function toStaticPluginView(plugin: Plugin): PluginView {
-  return {
-    name: plugin.name,
-    title: String(plugin.title || plugin.name || "").trim(),
-    description: String(plugin.description || "").trim(),
-    actions: Object.keys(plugin.actions || {}).sort((a, b) => a.localeCompare(b)),
-    pipelines: Object.keys(plugin.hooks?.pipeline || {}).sort((a, b) =>
-      a.localeCompare(b),
-    ),
-    guards: Object.keys(plugin.hooks?.guard || {}).sort((a, b) =>
-      a.localeCompare(b),
-    ),
-    effects: Object.keys(plugin.hooks?.effect || {}).sort((a, b) =>
-      a.localeCompare(b),
-    ),
-    resolves: Object.keys(plugin.resolves || {}).sort((a, b) =>
-      a.localeCompare(b),
-    ),
-    hasSystem: typeof plugin.system === "function",
-    hasAvailability: typeof plugin.availability === "function",
-  };
-}
-
-/**
- * 列出全部内建 plugin 定义。
- */
-export function listBuiltinPlugins(): Plugin[] {
-  return [...PLUGINS];
-}
-
-/**
- * 列出全部内建 plugin 的静态概览视图。
- */
-export function listStaticPluginViews(): PluginView[] {
-  return listBuiltinPlugins()
-    .map((plugin) => toStaticPluginView(plugin))
-    .sort((a, b) => a.name.localeCompare(b.name));
-}
-
-/**
- * 按名称查找内建 plugin 定义。
- */
-export function findBuiltinPlugin(pluginName: string): Plugin | null {
-  const key = String(pluginName || "").trim();
-  if (!key) return null;
-  return listBuiltinPlugins().find((plugin) => plugin.name === key) || null;
-}
-
-/**
- * 按名称查找内建 plugin 的静态概览视图。
- */
-export function findStaticPluginView(
-  pluginName: string,
-): PluginView | null {
-  const plugin = findBuiltinPlugin(pluginName);
-  return plugin ? toStaticPluginView(plugin) : null;
-}
-
-/**
- * 构建静态 plugin 可用性视图。
- *
- * 关键点（中文）
- * - 这里表达的是“控制面视角下可见的 city 配置事实”，不是执行链路中的最终可用性。
- * - `enabled` 只对齐 city 级 plugin lifecycle，不再读取 agent 项目配置。
- * - `available` 仅在无需执行上下文即可明确判断为 false 时返回 false；否则静态层视为可用。
- */
-export function buildStaticPluginAvailability(params: {
-  pluginName: string;
-  agentError?: string;
-}): PluginAvailability {
-  const plugin = findBuiltinPlugin(params.pluginName);
-  if (!plugin) {
-    return {
-      enabled: false,
-      available: false,
-      reasons: [`Unknown plugin: ${params.pluginName}`],
-    };
-  }
-
-  const enabled = isPluginEnabled({ plugin });
-
-  if (!enabled) {
-    return {
-      enabled: false,
-      available: false,
-      reasons: [`Plugin "${plugin.name}" is disabled in city config.`],
-    };
-  }
-
-  const agentReason = String(params.agentError || "").trim();
-  return {
-    enabled: true,
-    available: false,
-    reasons: agentReason
-      ? [`Agent server unavailable: ${agentReason}`]
-      : ["Static catalog view only. Agent-side availability is not loaded."],
-  };
-}