@downcity/agent 1.1.7 → 1.1.10

package/src/host/sdk/Session.ts

@@ -24,8 +24,8 @@ import type {
   AgentSessionSetInput,
   AgentSessionStreamEvent,
 } from "@/host/sdk/AgentSdkTypes.js";
-import type { SessionHistoryMetaV1 } from "@/types/session/SessionHistoryMeta.js";
-import type { SessionMessageV1 } from "@/types/session/SessionMessages.js";
+import type { SessionHistoryMetaV1 } from "@/session/types/SessionHistoryMeta.js";
+import type { SessionMessageV1 } from "@/session/types/SessionMessages.js";
 import { SdkSessionSystemComposer } from "@/host/sdk/SdkSessionSystemComposer.js";
 import {
   inferModelLabel,

package/src/host/sdk/SessionMetadata.ts

@@ -11,7 +11,7 @@ import type { LanguageModel } from "ai";
 import type {
   SessionHistoryMetaV1,
   SessionHistorySdkConfigV1,
-} from "@/types/session/SessionHistoryMeta.js";
+} from "@/session/types/SessionHistoryMeta.js";
 import { getSdkAgentSessionMetaPath } from "@/host/sdk/Paths.js";
 
 type ReadSessionMetadataInput = {

package/src/host/sdk/StreamEvents.ts

@@ -7,7 +7,7 @@
  */
 
 import type { UIMessageChunk } from "ai";
-import type { JsonValue } from "@/shared/types/Json.js";
+import type { JsonValue } from "@/utils/types/Json.js";
 import type { AgentSessionStreamEvent } from "@/host/sdk/AgentSdkTypes.js";
 
 function toJsonValue(value: unknown): JsonValue {

package/src/host/types/AgentHost.ts

@@ -0,0 +1,208 @@
+/**
+ * Agent 宿主能力类型定义。
+ *
+ * 关键点（中文）
+ * - 这里统一描述由 main 装配、再挂入 AgentRuntime 的宿主能力。
+ * - services / sessions / plugins 只能消费这些稳定能力，不应直接依赖 `main/*` 实现。
+ * - 当前先收敛路径、认证、plugin 配置持久化三类高频能力。
+ */
+
+import type { DowncityConfig } from "@/config/types/DowncityConfig.js";
+import type {
+  ChatAuthorizationChannel,
+  ChatAuthorizationConfig,
+} from "@/plugin/builtins/auth/types/AuthPlugin.js";
+import type {
+  ChatChannelAccountCreateInput,
+  ChatChannelAccountListItem,
+  ChatChannelAccountProbeResult,
+  ChatChannelAccountUpsertInput,
+} from "@/service/builtins/chat/types/ChannelAccount.js";
+import type {
+  StoredChannelAccount,
+  StoredModel,
+  StoredModelProvider,
+} from "@/host/types/Store.js";
+import type { ChatChannelName } from "@/service/builtins/chat/types/ChannelStatus.js";
+import type { AgentProjectInitializationInput } from "@/agent/project/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/host/types/Store.ts

@@ -0,0 +1,422 @@
+/**
+ * 模型存储（SQLite）类型定义。
+ *
+ * 关键点（中文）
+ * - 该类型用于平台控制面全局模型池（provider/model）的统一读写。
+ * - agent 项目只通过 `execution.modelId` 绑定模型 ID，不直接持有 provider 细节。
+ */
+import type { LlmProviderType } from "@/config/types/LlmConfig.js";
+
+/**
+ * Channel Account 支持的渠道类型。
+ */
+export type StoredChannelAccountChannel = "telegram" | "feishu" | "qq";
+
+/**
+ * 模型 provider 记录。
+ */
+export interface StoredModelProvider {
+  /**
+   * provider 主键 ID（例如：`openai_main`、`default`）。
+   */
+  id: string;
+  /**
+   * provider 类型（决定 SDK 分支与默认网关行为）。
+   */
+  type: LlmProviderType;
+  /**
+   * provider 基础地址（可选）。
+   */
+  baseUrl?: string;
+  /**
+   * provider API Key（解密后的明文；仅在运行时内存中使用）。
+   */
+  apiKey?: string;
+  /**
+   * 创建时间（ISO 字符串）。
+   */
+  createdAt: string;
+  /**
+   * 更新时间（ISO 字符串）。
+   */
+  updatedAt: string;
+}
+
+/**
+ * provider 元信息。
+ *
+ * 关键点（中文）
+ * - 仅保留同步读取所需的轻量字段。
+ * - 不包含解密后的 API Key，避免在只读展示链路中泄露敏感信息。
+ */
+export interface StoredProviderMeta {
+  /**
+   * provider 主键 ID。
+   */
+  id: string;
+  /**
+   * provider 类型。
+   */
+  type: LlmProviderType;
+  /**
+   * provider 基础地址（可选）。
+   */
+  baseUrl?: string;
+}
+
+/**
+ * 模型记录。
+ */
+export interface StoredModel {
+  /**
+   * 模型主键 ID（例如：`default`、`fast`、`quality`）。
+   */
+  id: string;
+  /**
+   * 关联 provider ID。
+   */
+  providerId: string;
+  /**
+   * 上游模型名称（例如 `gpt-4o-mini`）。
+   */
+  name: string;
+  /**
+   * 采样温度（可选）。
+   */
+  temperature?: number;
+  /**
+   * 最大输出 token（可选）。
+   */
+  maxTokens?: number;
+  /**
+   * topP（可选）。
+   */
+  topP?: number;
+  /**
+   * frequencyPenalty（可选）。
+   */
+  frequencyPenalty?: number;
+  /**
+   * presencePenalty（可选）。
+   */
+  presencePenalty?: number;
+  /**
+   * Anthropic 版本字段（可选）。
+   */
+  anthropicVersion?: string;
+  /**
+   * 是否暂停该模型。
+   *
+   * 关键点（中文）
+   * - 暂停后禁止作为 `execution.modelId` 被运行时加载。
+   * - 用于模型维护窗口、成本管控或临时故障隔离。
+   */
+  isPaused: boolean;
+  /**
+   * 创建时间（ISO 字符串）。
+   */
+  createdAt: string;
+  /**
+   * 更新时间（ISO 字符串）。
+   */
+  updatedAt: string;
+}
+
+/**
+ * provider 写入参数。
+ */
+export interface UpsertModelProviderInput {
+  /**
+   * provider ID。
+   */
+  id: string;
+  /**
+   * provider 类型。
+   */
+  type: LlmProviderType;
+  /**
+   * provider baseUrl（可选）。
+   */
+  baseUrl?: string;
+  /**
+   * provider apiKey（可选）。
+   */
+  apiKey?: string;
+}
+
+/**
+ * model 写入参数。
+ */
+export interface UpsertModelInput {
+  /**
+   * 模型 ID。
+   */
+  id: string;
+  /**
+   * provider ID。
+   */
+  providerId: string;
+  /**
+   * 上游模型名称。
+   */
+  name: string;
+  /**
+   * 采样温度（可选）。
+   */
+  temperature?: number;
+  /**
+   * 最大输出 token（可选）。
+   */
+  maxTokens?: number;
+  /**
+   * topP（可选）。
+   */
+  topP?: number;
+  /**
+   * frequencyPenalty（可选）。
+   */
+  frequencyPenalty?: number;
+  /**
+   * presencePenalty（可选）。
+   */
+  presencePenalty?: number;
+  /**
+   * Anthropic 版本字段（可选）。
+   */
+  anthropicVersion?: string;
+  /**
+   * 是否暂停该模型（可选）。
+   */
+  isPaused?: boolean;
+}
+
+/**
+ * Env 条目作用域。
+ */
+export type StoredEnvScope = "global" | "agent";
+
+/**
+ * 平台环境变量记录。
+ */
+export interface StoredEnvEntry {
+  /**
+   * Env 作用域。
+   *
+   * 关键点（中文）
+   * - `global` 表示平台控制面全局共享变量。
+   * - `agent` 表示仅某个 agent 可见的私有变量。
+   */
+  scope: StoredEnvScope;
+  /**
+   * Agent 唯一标识（使用 projectRoot 绝对路径）。
+   *
+   * 关键点（中文）
+   * - 仅当 `scope=agent` 时有值。
+   * - `scope=global` 时为空。
+   */
+  agentId?: string;
+  /**
+   * 环境变量 key（例如 `OPENAI_API_KEY`）。
+   */
+  key: string;
+  /**
+   * 环境变量描述。
+   *
+   * 关键点（中文）
+   * - 面向用户说明该变量的用途。
+   * - 可为空，用于兼容历史只存 key/value 的数据。
+   */
+  description?: string;
+  /**
+   * 环境变量 value（解密后的明文，仅运行时内存可见）。
+   */
+  value: string;
+  /**
+   * 创建时间（ISO 字符串）。
+   */
+  createdAt: string;
+  /**
+   * 更新时间（ISO 字符串）。
+   */
+  updatedAt: string;
+}
+
+/**
+ * Env 写入参数。
+ */
+export interface UpsertEnvEntryInput {
+  /**
+   * Env 作用域。
+   */
+  scope: StoredEnvScope;
+  /**
+   * Agent 唯一标识（projectRoot）。
+   *
+   * 关键点（中文）
+   * - 仅 `scope=agent` 时必填。
+   * - `scope=global` 时忽略。
+   */
+  agentId?: string;
+  /**
+   * 环境变量 key。
+   */
+  key: string;
+  /**
+   * 环境变量描述。
+   *
+   * 关键点（中文）
+   * - 允许为空，表示暂未填写用途说明。
+   */
+  description?: string;
+  /**
+   * 环境变量值；空字符串也允许（用于显式置空）。
+   */
+  value: string;
+}
+
+/**
+ * 全局环境变量记录。
+ *
+ * 关键点（中文）
+ * - 作为统一 `StoredEnvEntry` 的别名保留。
+ * - 调用方可继续按全局 env 语义使用。
+ */
+export type StoredGlobalEnvEntry = StoredEnvEntry;
+
+/**
+ * Agent 私有环境变量记录。
+ *
+ * 关键点（中文）
+ * - 作为统一 `StoredEnvEntry` 的别名保留。
+ * - 调用方可继续按 agent env 语义使用。
+ */
+export type StoredAgentEnvEntry = StoredEnvEntry;
+
+/**
+ * 全局环境变量写入参数。
+ *
+ * 关键点（中文）
+ * - 作为统一 `UpsertEnvEntryInput` 的别名保留。
+ */
+export type UpsertGlobalEnvEntryInput = Omit<UpsertEnvEntryInput, "scope" | "agentId">;
+
+/**
+ * Agent 私有环境变量写入参数。
+ *
+ * 关键点（中文）
+ * - 作为统一 `UpsertEnvEntryInput` 的别名保留。
+ */
+export type UpsertAgentEnvEntryInput = Omit<UpsertEnvEntryInput, "scope"> & {
+  /**
+   * Agent 唯一标识（projectRoot）。
+   */
+  agentId: string;
+};
+
+/**
+ * Channel Account 记录。
+ */
+export interface StoredChannelAccount {
+  /**
+   * 账户主键 ID（例如 `qq-main`）。
+   */
+  id: string;
+  /**
+   * 账户归属渠道（telegram/feishu/qq）。
+   */
+  channel: StoredChannelAccountChannel;
+  /**
+   * UI 展示名（例如“主 QQ 机器人”）。
+   */
+  name: string;
+  /**
+   * 身份展示文案（例如 `@my_bot`、`app:123`），可选。
+   */
+  identity?: string;
+  /**
+   * 机器人所有者信息（可选，平台可获取时自动同步）。
+   */
+  owner?: string;
+  /**
+   * 机器人创建者信息（可选，平台可获取时自动同步）。
+   */
+  creator?: string;
+  /**
+   * Telegram Token（解密后，可选）。
+   */
+  botToken?: string;
+  /**
+   * AppId（解密后，可选）。
+   */
+  appId?: string;
+  /**
+   * AppSecret（解密后，可选）。
+   */
+  appSecret?: string;
+  /**
+   * 渠道域名（主要用于 Feishu/Lark），可选。
+   */
+  domain?: string;
+  /**
+   * QQ 沙箱模式开关，可选。
+   */
+  sandbox?: boolean;
+  /**
+   * 创建时间（ISO 字符串）。
+   */
+  createdAt: string;
+  /**
+   * 更新时间（ISO 字符串）。
+   */
+  updatedAt: string;
+}
+
+/**
+ * Channel Account 写入参数。
+ */
+export interface UpsertChannelAccountInput {
+  /**
+   * 账户主键 ID。
+   */
+  id: string;
+  /**
+   * 账户归属渠道。
+   */
+  channel: StoredChannelAccountChannel;
+  /**
+   * 账户展示名。
+   */
+  name: string;
+  /**
+   * 身份展示文案，可选。
+   */
+  identity?: string;
+  /**
+   * 机器人所有者信息（可选）。
+   */
+  owner?: string;
+  /**
+   * 机器人创建者信息（可选）。
+   */
+  creator?: string;
+  /**
+   * Telegram Token，可选。
+   */
+  botToken?: string;
+  /**
+   * AppId，可选。
+   */
+  appId?: string;
+  /**
+   * AppSecret，可选。
+   */
+  appSecret?: string;
+  /**
+   * 渠道域名，可选。
+   */
+  domain?: string;
+  /**
+   * QQ 沙箱模式，可选。
+   */
+  sandbox?: boolean;
+}