@downcity/agent 1.1.8 → 1.1.10

package/src/shared/constants/DowncityDefault.ts

@@ -1,38 +0,0 @@
-import type { DowncityConfig } from "@/shared/types/DowncityConfig.js";
-
-export const DEFAULT_DOWNCITY_JSON: DowncityConfig = {
-  $schema: "./.downcity/schema/downcity.schema.json",
-  name: "downcity",
-  version: "1.0.0",
-  start: {
-    port: 5314,
-    host: "0.0.0.0",
-  },
-  execution: {
-    type: "api",
-    modelId: "default",
-  },
-  context: {
-    messages: {
-      keepLastMessages: 30,
-      maxInputTokensApprox: 128000,
-      archiveOnCompact: true,
-      compactRatio: 0.5,
-    },
-  },
-  services: {
-    chat: {
-      queue: {
-        maxConcurrency: 2,
-        mergeDebounceMs: 600,
-        mergeMaxWaitMs: 2000,
-      },
-      channels: {
-        telegram: {
-          enabled: false,
-          channelAccountId: undefined,
-        },
-      },
-    },
-  },
-};

package/src/shared/constants/DowncitySchema.ts

@@ -1,377 +0,0 @@
-import type { JsonObject } from "@/shared/types/Json.js";
-
-export const DOWNCITY_JSON_SCHEMA: JsonObject = {
-  $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 },
-          },
-        },
-      },
-    },
-  },
-};

package/src/shared/types/AgentHost.ts

@@ -1,208 +0,0 @@
-/**
- * Agent 宿主能力类型定义。
- *
- * 关键点（中文）
- * - 这里统一描述由 main 装配、再挂入 AgentRuntime 的宿主能力。
- * - services / sessions / plugins 只能消费这些稳定能力，不应直接依赖 `main/*` 实现。
- * - 当前先收敛路径、认证、plugin 配置持久化三类高频能力。
- */
-
-import type { DowncityConfig } from "@/shared/types/DowncityConfig.js";
-import type {
-  ChatAuthorizationChannel,
-  ChatAuthorizationConfig,
-} from "@/shared/types/AuthPlugin.js";
-import type {
-  ChatChannelAccountCreateInput,
-  ChatChannelAccountListItem,
-  ChatChannelAccountProbeResult,
-  ChatChannelAccountUpsertInput,
-} from "@/service/builtins/chat/types/ChannelAccount.js";
-import type {
-  StoredChannelAccount,
-  StoredModel,
-  StoredModelProvider,
-} from "@/shared/types/Store.js";
-import type { ChatChannelName } from "@/service/builtins/chat/types/ChannelStatus.js";
-import type { AgentProjectInitializationInput } from "@/shared/types/AgentProject.js";
-import type { PlatformModelChoice } from "@/agent/project/AgentInitializer.js";
-
-/**
- * Agent 路径能力集合。
- */
-export interface AgentPathRuntime {
-  /**
-   * 当前项目根目录。
-   */
-  projectRoot: string;
-  /**
-   * `.downcity` 根目录路径。
-   */
-  getDowncityDirPath(): string;
-  /**
-   * `.downcity/.cache` 目录路径。
-   */
-  getCacheDirPath(): string;
-  /**
-   * `.downcity/channel` 目录路径。
-   */
-  getDowncityChannelDirPath(): string;
-  /**
-   * `.downcity/channel/meta.json` 文件路径。
-   */
-  getDowncityChannelMetaPath(): string;
-  /**
-   * `.downcity/chat/<sessionId>/history.jsonl` 文件路径。
-   */
-  getDowncityChatHistoryPath(sessionId: string): string;
-  /**
-   * `.downcity/memory/MEMORY.md` 文件路径。
-   */
-  getDowncityMemoryLongTermPath(): string;
-  /**
-   * `.downcity/memory/daily` 目录路径。
-   */
-  getDowncityMemoryDailyDirPath(): string;
-  /**
-   * `.downcity/memory/daily/<date>.md` 文件路径。
-   */
-  getDowncityMemoryDailyPath(date: string): string;
-  /**
-   * `.downcity/session` 根目录路径。
-   */
-  getDowncitySessionRootDirPath(): string;
-  /**
-   * `.downcity/session/<sessionId>` 目录路径。
-   */
-  getDowncitySessionDirPath(sessionId: string): string;
-}
-
-/**
- * Plugin 配置持久化能力集合。
- */
-export interface AgentPluginConfigRuntime {
-  /**
-   * 将当前 `plugins` 配置块写回项目 `downcity.json`。
-   */
-  persistProjectPlugins(plugins: DowncityConfig["plugins"] | undefined): Promise<string>;
-}
-
-/**
- * Agent 可见的平台能力集合。
- *
- * 关键点（中文）
- * - agent 只消费这些平台能力，不直接管理平台级持久化实现。
- * - 具体数据存储与管理应由 city / control plane 提供。
- */
-export interface AgentPlatformRuntime {
-  /**
-   * 读取当前平台级全局环境变量快照。
-   */
-  getGlobalEnv(): Record<string, string>;
-  /**
-   * 读取指定 agent 项目的私有环境变量快照。
-   */
-  getAgentEnv(projectRoot: string): Record<string, string>;
-  /**
-   * 读取当前平台模型池中的全部模型。
-   */
-  listModels(): StoredModel[];
-  /**
-   * 读取当前平台模型池中的全部 provider。
-   */
-  listProviders(): Promise<StoredModelProvider[]>;
-  /**
-   * 按模型 ID 读取单个模型。
-   */
-  getModel(modelId: string): StoredModel | null;
-  /**
-   * 按账户 ID 读取单个渠道账户。
-   */
-  getChannelAccount(channelAccountId: string): StoredChannelAccount | null;
-  /**
-   * 列出当前平台保存的全部渠道账户安全视图。
-   */
-  listChannelAccounts?(): Promise<ChatChannelAccountListItem[]>;
-  /**
-   * 探测渠道凭据并返回建议账户信息。
-   */
-  probeChannelAccount?(input: {
-    channel: string;
-    botToken?: string;
-    appId?: string;
-    appSecret?: string;
-    domain?: string;
-    sandbox?: boolean;
-  }): Promise<ChatChannelAccountProbeResult>;
-  /**
-   * 创建新的渠道账户。
-   */
-  createChannelAccount?(input: ChatChannelAccountCreateInput): Promise<{
-    id: string;
-    probed: boolean;
-    message?: string;
-  }>;
-  /**
-   * 更新现有渠道账户。
-   */
-  updateChannelAccount?(input: ChatChannelAccountUpsertInput): Promise<void>;
-  /**
-   * 删除渠道账户。
-   */
-  removeChannelAccount?(channelAccountId: string): Promise<void>;
-  /**
-   * 解析某个渠道当前应使用的账户。
-   */
-  resolveChannelAccount?(params: {
-    projectRoot: string;
-    channel: ChatChannelName;
-    channelAccountId?: string;
-  }): StoredChannelAccount | null;
-  /**
-   * 读取当前 agent 的 chat 授权配置。
-   */
-  readChatAuthorizationConfig(projectRoot: string): ChatAuthorizationConfig;
-  /**
-   * 覆盖写入当前 agent 的 chat 授权配置。
-   */
-  writeChatAuthorizationConfig(
-    projectRoot: string,
-    nextConfig: ChatAuthorizationConfig,
-  ): Promise<ChatAuthorizationConfig>;
-  /**
-   * 设置当前 agent 某个渠道用户的授权角色。
-   */
-  setChatAuthorizationUserRole(params: {
-    projectRoot: string;
-    channel: ChatAuthorizationChannel;
-    userId: string;
-    roleId: string;
-  }): Promise<ChatAuthorizationConfig>;
-  /**
-   * 判断指定 plugin 当前是否启用。
-   */
-  isPluginEnabled(pluginName: string): boolean;
-  /**
-   * 设置指定 plugin 的全局启用态。
-   */
-  setPluginEnabled?(pluginName: string, enabled: boolean): void;
-  /**
-   * 列出平台模型选项。
-   */
-  listPlatformModelChoices?(): Promise<PlatformModelChoice[]>;
-  /**
-   * 初始化 agent 项目。
-   */
-  initializeAgentProject?(
-    input: AgentProjectInitializationInput,
-  ): Promise<{
-    projectRoot: string;
-    agentName: string;
-    createdFiles: string[];
-    skippedFiles: string[];
-  }>;
-  /**
-   * 校验项目执行绑定是否已就绪。
-   */
-  ensureRuntimeExecutionBindingReady?(projectRoot: string): void;
-}

package/src/shared/types/AgentProject.ts

@@ -1,92 +0,0 @@
-/**
- * Agent 项目初始化相关类型定义。
- *
- * 关键点（中文）
- * - 统一承载 CLI 与 control plane 共用的初始化输入/输出结构。
- * - 所有字段都面向"项目骨架创建"语义，不掺杂 runtime 状态。
- */
-
-import type { ExecutionBindingConfig } from "@/shared/types/ExecutionBinding.js";
-import type { DowncityConfig } from "@/shared/types/DowncityConfig.js";
-
-/**
- * 可选的 chat channel 标识。
- */
-export type AgentProjectChannel = "telegram" | "feishu" | "qq";
-
-/**
- * 初始化 agent 项目的输入参数。
- */
-export interface AgentProjectInitializationInput {
-  /**
-   * agent 项目根目录（绝对路径或可解析相对路径）。
-   */
-  projectRoot: string;
-
-  /**
-   * agent 展示名。
-   *
-   * 关键点（中文）
-   * - 为空时会自动回退到目录名推导出的默认名称。
-   */
-  agentName?: string;
-
-  /**
-   * 项目执行绑定配置。
-   *
-   * 说明（中文）
-   * - 绑定平台全局模型池中的模型 ID。
-   */
-  execution: ExecutionBindingConfig;
-
-  /**
-   * 需要一并写入项目的 plugin 配置补丁。
-   *
-   * 说明（中文）
-   * - 这里只承载初始化时的最小配置，不负责 city 级 plugin lifecycle。
-   */
-  plugins?: DowncityConfig["plugins"];
-
-  /**
-   * 需要启用的 chat channels。
-   *
-   * 关键点（中文）
-   * - 仅写入用户选择的渠道，未选择的渠道不会写入 `downcity.json`。
-   */
-  channels?: AgentProjectChannel[];
-
-  /**
-   * 是否允许覆盖已存在的 `downcity.json`。
-   */
-  forceOverwriteShipJson?: boolean;
-}
-
-/**
- * 初始化完成后的摘要结果。
- */
-export interface AgentProjectInitializationResult {
-  /**
-   * 已解析后的 agent 项目根目录（绝对路径）。
-   */
-  projectRoot: string;
-
-  /**
-   * 最终写入的 agent 名称。
-   */
-  agentName: string;
-
-  /**
-   * 最终启用的 chat channels。
-   */
-  channels: AgentProjectChannel[];
-
-  /**
-   * 本次实际创建/写入的文件列表。
-   */
-  createdFiles: string[];
-
-  /**
-   * 因已存在而跳过的文件列表。
-   */
-  skippedFiles: string[];
-}