@downcity/city 1.1.4 → 1.1.5

package/src/store/index.ts

@@ -1,497 +0,0 @@
-/**
- * ConsoleStore 门面。
- *
- * 关键点（中文）
- * - 对外仍然只暴露一个 `ConsoleStore` 类，保持调用入口稳定。
- * - 内部已经按职责拆成 schema、model/provider、secure settings、env、channel accounts 多个模块。
- * - 这样既能保持外部 API 简洁，也能把通用存储层控制在可维护的模块粒度内。
- */
-
-import fs from "fs-extra";
-import Database from "better-sqlite3";
-import { drizzle } from "drizzle-orm/better-sqlite3";
-import { getConsoleShipDbPath } from "@/registry/CityPaths.js";
-import { ensureConsoleStoreSchema } from "./StoreSchema.js";
-import type { ConsoleStoreContext } from "./StoreShared.js";
-import type {
-  StoredAgentEnvEntry,
-  StoredChannelAccount,
-  StoredEnvEntry,
-  StoredEnvScope,
-  StoredGlobalEnvEntry,
-  StoredModel,
-  StoredModelProvider,
-  StoredProviderMeta,
-  UpsertAgentEnvEntryInput,
-  UpsertChannelAccountInput,
-  UpsertEnvEntryInput,
-  UpsertGlobalEnvEntryInput,
-  UpsertModelInput,
-  UpsertModelProviderInput,
-} from "@/types/store/Store.js";
-import {
-  getConsoleRootDirPath,
-} from "@/registry/CityPaths.js";
-import {
-  clearStoredModelsAndProviders,
-  getResolvedStoredModel,
-  getStoredModel,
-  getStoredProvider,
-  listStoredModels,
-  listStoredProviderMetas,
-  listStoredProviders,
-  removeStoredModel,
-  removeStoredProvider,
-  setStoredModelPaused,
-  upsertStoredModel,
-  upsertStoredProvider,
-} from "./StoreModelRepository.js";
-import {
-  buildAgentSecureSettingKey,
-  getSecureSettingJson,
-  getSecureSettingJsonSync,
-  removeSecureSetting,
-  setSecureSettingJson,
-  setSecureSettingJsonSync,
-} from "./StoreSecureSettings.js";
-import {
-  clearAgentEnvEntries,
-  clearGlobalEnvEntries,
-  getAgentEnvMap,
-  getAgentEnvMapSync,
-  getGlobalEnvMap,
-  getGlobalEnvMapSync,
-  listAgentEnvEntries,
-  listAgentEnvEntriesSync,
-  listAllAgentEnvEntries,
-  listEnvEntries,
-  listEnvEntriesSync,
-  listGlobalEnvEntries,
-  listGlobalEnvEntriesSync,
-  removeAgentEnvEntry,
-  removeEnvEntry,
-  removeGlobalEnvEntry,
-  upsertAgentEnvEntry,
-  upsertEnvEntry,
-  upsertGlobalEnvEntry,
-} from "./StoreEnvRepository.js";
-import {
-  getChannelAccount,
-  getChannelAccountSync,
-  listChannelAccounts,
-  listChannelAccountsSync,
-  removeChannelAccount,
-  upsertChannelAccount,
-} from "./StoreChannelAccountRepository.js";
-
-/**
- * Console 模型存储。
- */
-export class ConsoleStore {
-  private readonly sqlite: Database.Database;
-  private readonly db: ReturnType<typeof drizzle>;
-
-  constructor(dbPath: string = getConsoleShipDbPath()) {
-    fs.ensureDirSync(getConsoleRootDirPath());
-    this.sqlite = new Database(dbPath);
-    this.sqlite.pragma("foreign_keys = ON");
-    this.sqlite.pragma("journal_mode = WAL");
-    this.db = drizzle(this.sqlite);
-    ensureConsoleStoreSchema(this.context);
-  }
-
-  /**
-   * 暴露给内部 helper 的只读上下文视图。
-   */
-  private get context(): ConsoleStoreContext {
-    return {
-      sqlite: this.sqlite,
-      db: this.db,
-    };
-  }
-
-  /**
-   * 关闭连接。
-   */
-  close(): void {
-    this.sqlite.close();
-  }
-
-  /**
-   * 列出 providers。
-   */
-  async listProviders(): Promise<StoredModelProvider[]> {
-    return await listStoredProviders(this.context);
-  }
-
-  /**
-   * 获取单个 provider。
-   */
-  async getProvider(providerId: string): Promise<StoredModelProvider | null> {
-    return await getStoredProvider(this.context, providerId);
-  }
-
-  /**
-   * 新增或更新 provider。
-   */
-  async upsertProvider(input: UpsertModelProviderInput): Promise<void> {
-    await upsertStoredProvider(this.context, input);
-  }
-
-  /**
-   * 删除 provider。
-   */
-  removeProvider(providerId: string): void {
-    removeStoredProvider(this.context, providerId);
-  }
-
-  /**
-   * 列出 models。
-   */
-  listModels(): StoredModel[] {
-    return listStoredModels(this.context);
-  }
-
-  /**
-   * 同步列出 provider 元信息（不含 API Key）。
-   */
-  listProvidersSync(): StoredProviderMeta[] {
-    return listStoredProviderMetas(this.context);
-  }
-
-  /**
-   * 获取单个 model。
-   */
-  getModel(modelId: string): StoredModel | null {
-    return getStoredModel(this.context, modelId);
-  }
-
-  /**
-   * 新增或更新 model。
-   */
-  upsertModel(input: UpsertModelInput): void {
-    upsertStoredModel(this.context, input);
-  }
-
-  /**
-   * 切换模型暂停状态。
-   */
-  setModelPaused(modelId: string, paused: boolean): void {
-    setStoredModelPaused(this.context, modelId, paused);
-  }
-
-  /**
-   * 删除 model。
-   */
-  removeModel(modelId: string): void {
-    removeStoredModel(this.context, modelId);
-  }
-
-  /**
-   * 获取 model + provider 聚合信息。
-   */
-  async getResolvedModel(modelId: string): Promise<{
-    model: StoredModel;
-    provider: StoredModelProvider;
-  } | null> {
-    return await getResolvedStoredModel(this.context, modelId);
-  }
-
-  /**
-   * 清空所有存储数据。
-   */
-  clearAll(): void {
-    clearStoredModelsAndProviders(this.context);
-    this.sqlite.exec("DELETE FROM console_secure_settings;");
-    this.sqlite.exec("DELETE FROM env_entries;");
-    this.sqlite.exec("DELETE FROM global_env;");
-    this.sqlite.exec("DELETE FROM agent_env;");
-    this.sqlite.exec("DELETE FROM channel_accounts;");
-  }
-
-  /**
-   * 同步读取 console 加密配置项（JSON）。
-   */
-  getSecureSettingJsonSync<T>(key: string): T | null {
-    return getSecureSettingJsonSync<T>(this.context, key);
-  }
-
-  /**
-   * 同步写入 console 加密配置项（JSON）。
-   */
-  setSecureSettingJsonSync(key: string, value: unknown): void {
-    setSecureSettingJsonSync(this.context, key, value);
-  }
-
-  /**
-   * 删除 console 加密配置项。
-   */
-  removeSecureSetting(key: string): void {
-    removeSecureSetting(this.context, key);
-  }
-
-  /**
-   * 异步读取 console 加密配置项（JSON）。
-   */
-  async getSecureSettingJson<T>(key: string): Promise<T | null> {
-    return await getSecureSettingJson<T>(this.context, key);
-  }
-
-  /**
-   * 异步写入 console 加密配置项（JSON）。
-   */
-  async setSecureSettingJson(key: string, value: unknown): Promise<void> {
-    await setSecureSettingJson(this.context, key, value);
-  }
-
-  /**
-   * 同步读取 agent 加密配置项（JSON）。
-   */
-  getAgentSecureSettingJsonSync<T>(agentIdInput: string, keyInput: string): T | null {
-    return this.getSecureSettingJsonSync<T>(
-      buildAgentSecureSettingKey(agentIdInput, keyInput),
-    );
-  }
-
-  /**
-   * 同步写入 agent 加密配置项（JSON）。
-   */
-  setAgentSecureSettingJsonSync(agentIdInput: string, keyInput: string, value: unknown): void {
-    this.setSecureSettingJsonSync(
-      buildAgentSecureSettingKey(agentIdInput, keyInput),
-      value,
-    );
-  }
-
-  /**
-   * 删除 agent 加密配置项。
-   */
-  removeAgentSecureSetting(agentIdInput: string, keyInput: string): void {
-    this.removeSecureSetting(buildAgentSecureSettingKey(agentIdInput, keyInput));
-  }
-
-  /**
-   * 异步读取 agent 加密配置项（JSON）。
-   */
-  async getAgentSecureSettingJson<T>(
-    agentIdInput: string,
-    keyInput: string,
-  ): Promise<T | null> {
-    return await this.getSecureSettingJson<T>(
-      buildAgentSecureSettingKey(agentIdInput, keyInput),
-    );
-  }
-
-  /**
-   * 异步写入 agent 加密配置项（JSON）。
-   */
-  async setAgentSecureSettingJson(
-    agentIdInput: string,
-    keyInput: string,
-    value: unknown,
-  ): Promise<void> {
-    await this.setSecureSettingJson(
-      buildAgentSecureSettingKey(agentIdInput, keyInput),
-      value,
-    );
-  }
-
-  /**
-   * 查询 env 条目（同步）。
-   */
-  listEnvEntriesSync(scopeInput?: StoredEnvScope, agentIdInput?: string): StoredEnvEntry[] {
-    return listEnvEntriesSync(this.context, scopeInput, agentIdInput);
-  }
-
-  /**
-   * 查询 env 条目（异步）。
-   */
-  async listEnvEntries(scopeInput?: StoredEnvScope, agentIdInput?: string): Promise<StoredEnvEntry[]> {
-    return await listEnvEntries(this.context, scopeInput, agentIdInput);
-  }
-
-  /**
-   * 新增或更新 env 条目。
-   */
-  async upsertEnvEntry(input: UpsertEnvEntryInput): Promise<void> {
-    await upsertEnvEntry(this.context, input);
-  }
-
-  /**
-   * 删除单个 env 条目。
-   */
-  removeEnvEntry(input: { scope: StoredEnvScope; agentId?: string; key: string }): void {
-    removeEnvEntry(this.context, input);
-  }
-
-  /**
-   * 列出全局环境变量（同步解密）。
-   */
-  listGlobalEnvEntriesSync(): StoredGlobalEnvEntry[] {
-    return listGlobalEnvEntriesSync(this.context);
-  }
-
-  /**
-   * 读取全局环境变量映射（同步解密）。
-   */
-  getGlobalEnvMapSync(): Record<string, string> {
-    return getGlobalEnvMapSync(this.context);
-  }
-
-  /**
-   * 列出全局环境变量（解密后）。
-   */
-  async listGlobalEnvEntries(): Promise<StoredGlobalEnvEntry[]> {
-    return await listGlobalEnvEntries(this.context);
-  }
-
-  /**
-   * 读取全局环境变量映射（解密后）。
-   */
-  async getGlobalEnvMap(): Promise<Record<string, string>> {
-    return await getGlobalEnvMap(this.context);
-  }
-
-  /**
-   * 新增或更新全局环境变量。
-   */
-  async upsertGlobalEnvEntry(input: UpsertGlobalEnvEntryInput): Promise<void> {
-    await upsertGlobalEnvEntry(this.context, input);
-  }
-
-  /**
-   * 删除单个全局环境变量。
-   */
-  removeGlobalEnvEntry(keyInput: string): void {
-    removeGlobalEnvEntry(this.context, keyInput);
-  }
-
-  /**
-   * 清空全局环境变量。
-   */
-  clearGlobalEnvEntries(): void {
-    clearGlobalEnvEntries(this.context);
-  }
-
-  /**
-   * 列出指定 agent 的私有环境变量（同步解密）。
-   */
-  listAgentEnvEntriesSync(agentIdInput: string): StoredAgentEnvEntry[] {
-    return listAgentEnvEntriesSync(this.context, agentIdInput);
-  }
-
-  /**
-   * 读取指定 agent 的私有环境变量映射（同步解密）。
-   */
-  getAgentEnvMapSync(agentIdInput: string): Record<string, string> {
-    return getAgentEnvMapSync(this.context, agentIdInput);
-  }
-
-  /**
-   * 列出指定 agent 的私有环境变量（解密后）。
-   */
-  async listAgentEnvEntries(agentIdInput: string): Promise<StoredAgentEnvEntry[]> {
-    return await listAgentEnvEntries(this.context, agentIdInput);
-  }
-
-  /**
-   * 列出全部 agent 私有环境变量（解密后）。
-   */
-  async listAllAgentEnvEntries(): Promise<StoredAgentEnvEntry[]> {
-    return await listAllAgentEnvEntries(this.context);
-  }
-
-  /**
-   * 读取指定 agent 的私有环境变量映射（解密后）。
-   */
-  async getAgentEnvMap(agentIdInput: string): Promise<Record<string, string>> {
-    return await getAgentEnvMap(this.context, agentIdInput);
-  }
-
-  /**
-   * 新增或更新 agent 私有环境变量。
-   */
-  async upsertAgentEnvEntry(input: UpsertAgentEnvEntryInput): Promise<void> {
-    await upsertAgentEnvEntry(this.context, input);
-  }
-
-  /**
-   * 删除指定 agent 的单个环境变量。
-   */
-  removeAgentEnvEntry(agentIdInput: string, keyInput: string): void {
-    removeAgentEnvEntry(this.context, agentIdInput, keyInput);
-  }
-
-  /**
-   * 清空指定 agent 的私有环境变量。
-   */
-  clearAgentEnvEntries(agentIdInput: string): void {
-    clearAgentEnvEntries(this.context, agentIdInput);
-  }
-
-  /**
-   * 列出 channel accounts（同步解密）。
-   */
-  listChannelAccountsSync(channelInput?: string): StoredChannelAccount[] {
-    return listChannelAccountsSync(this.context, channelInput);
-  }
-
-  /**
-   * 按 ID 获取 channel account（同步解密）。
-   */
-  getChannelAccountSync(accountIdInput: string): StoredChannelAccount | null {
-    return getChannelAccountSync(this.context, accountIdInput);
-  }
-
-  /**
-   * 列出 channel accounts（解密后）。
-   */
-  async listChannelAccounts(channelInput?: string): Promise<StoredChannelAccount[]> {
-    return await listChannelAccounts(this.context, channelInput);
-  }
-
-  /**
-   * 按 ID 获取 channel account（解密后）。
-   */
-  async getChannelAccount(accountIdInput: string): Promise<StoredChannelAccount | null> {
-    return await getChannelAccount(this.context, accountIdInput);
-  }
-
-  /**
-   * 新增或更新 channel account。
-   */
-  async upsertChannelAccount(input: UpsertChannelAccountInput): Promise<void> {
-    await upsertChannelAccount(this.context, input);
-  }
-
-  /**
-   * 删除 channel account。
-   */
-  removeChannelAccount(accountIdInput: string): void {
-    removeChannelAccount(this.context, accountIdInput);
-  }
-}
-
-/**
- * 在 ConsoleStore 上下文中执行操作。
- *
- * 关键点（中文）
- * - 用于一次性数据库操作，无需手动管理 ConsoleStore 实例生命周期。
- * - 自动处理数据库连接和关闭。
- */
-export function withConsoleStore<T>(callback: (context: ConsoleStoreContext) => T): T {
-  const dbPath = getConsoleShipDbPath();
-  fs.ensureDirSync(dbPath.replace(/\/[^/]+$/, ""));
-  const sqlite = new Database(dbPath);
-  sqlite.pragma("journal_mode = WAL");
-  const context: ConsoleStoreContext = {
-    sqlite,
-    db: drizzle(sqlite),
-  };
-  ensureConsoleStoreSchema(context);
-  try {
-    return callback(context);
-  } finally {
-    sqlite.close();
-  }
-}

package/src/store/schema.ts

@@ -1,103 +0,0 @@
-/**
- * 模型存储表结构（drizzle schema）。
- *
- * 关键点（中文）
- * - providers 与 models 分表，使用 providerId 做关联。
- * - API Key 以密文字段存储（`apiKeyEncrypted`）。
- */
-import {
-  index,
-  integer,
-  primaryKey,
-  real,
-  sqliteTable,
-  text,
-} from "drizzle-orm/sqlite-core";
-
-export const modelProvidersTable = sqliteTable("model_providers", {
-  id: text("id").primaryKey(),
-  type: text("type").notNull(),
-  baseUrl: text("base_url"),
-  apiKeyEncrypted: text("api_key_encrypted"),
-  createdAt: text("created_at").notNull(),
-  updatedAt: text("updated_at").notNull(),
-});
-
-export const modelsTable = sqliteTable(
-  "models",
-  {
-    id: text("id").primaryKey(),
-    providerId: text("provider_id").notNull(),
-    name: text("name").notNull(),
-    temperature: real("temperature"),
-    maxTokens: integer("max_tokens"),
-    topP: real("top_p"),
-    frequencyPenalty: real("frequency_penalty"),
-    presencePenalty: real("presence_penalty"),
-    anthropicVersion: text("anthropic_version"),
-    isPaused: integer("is_paused").notNull().default(0),
-    createdAt: text("created_at").notNull(),
-    updatedAt: text("updated_at").notNull(),
-  },
-  (table) => ({
-    providerIdIdx: index("models_provider_id_idx").on(table.providerId),
-  }),
-);
-
-/**
- * Console Env 统一存储表。
- *
- * 关键点（中文）
- * - 全局 env 与 agent env 共用一张表，通过 `scope` + `agentId` 区分。
- * - `agentId` 在 `scope=global` 时固定为空字符串，避免 SQLite 复合主键中的 NULL 语义问题。
- * - value 采用密文存储，解密仅在运行时内存中进行。
- */
-export const envEntriesTable = sqliteTable(
-  "env_entries",
-  {
-    scope: text("scope").notNull(),
-    agentId: text("agent_id").notNull().default(""),
-    key: text("key").notNull(),
-    description: text("description"),
-    valueEncrypted: text("value_encrypted").notNull(),
-    createdAt: text("created_at").notNull(),
-    updatedAt: text("updated_at").notNull(),
-  },
-  (table) => ({
-    pk: primaryKey({
-      columns: [table.scope, table.agentId, table.key],
-      name: "env_entries_scope_agent_key_pk",
-    }),
-    scopeIdx: index("env_entries_scope_idx").on(table.scope),
-    agentIdIdx: index("env_entries_agent_id_idx").on(table.agentId),
-  }),
-);
-
-/**
- * Channel Account 表。
- *
- * 关键点（中文）
- * - 各渠道敏感字段独立密文列存储。
- * - `downcity.json` 仅保存 channelAccountId 绑定，不直接保存密钥。
- */
-export const channelAccountsTable = sqliteTable(
-  "channel_accounts",
-  {
-    id: text("id").primaryKey(),
-    channel: text("channel").notNull(),
-    name: text("name").notNull(),
-    identity: text("identity"),
-    owner: text("owner"),
-    creator: text("creator"),
-    botTokenEncrypted: text("bot_token_encrypted"),
-    appIdEncrypted: text("app_id_encrypted"),
-    appSecretEncrypted: text("app_secret_encrypted"),
-    domain: text("domain"),
-    sandbox: integer("sandbox"),
-    createdAt: text("created_at").notNull(),
-    updatedAt: text("updated_at").notNull(),
-  },
-  (table) => ({
-    channelIdx: index("channel_accounts_channel_idx").on(table.channel),
-  }),
-);

package/src/types/chat/ChatSession.ts

@@ -1,32 +0,0 @@
-/**
- * ChatSession 相关类型定义。
- *
- * 关键点（中文）
- * - Chat 专用 session 会把“队列消息合并 / step 回发”收敛到 chat 层自身。
- * - 普通 Session 仍可复用基础 `run / append*` 能力，不强耦合 chat 语义。
- */
-
-import type { SessionUserMessageV1 } from "@downcity/agent/types/session/SessionMessages.js";
-import type { SessionAssistantStepCallback } from "@downcity/agent/types/session/SessionRun.js";
-
-/**
- * ChatSession 单次 turn 绑定的运行态。
- */
-export interface ChatSessionTurnState {
-  /**
-   * 提取本轮 step 边界新增的 user 消息。
-   *
-   * 关键点（中文）
-   * - 该回调用于把同一 chat lane 后续到达的消息并入当前推理。
-   * - 若未提供，则表示当前 turn 不启用 step 合并。
-   */
-  onStepCallback?: () => Promise<SessionUserMessageV1[]>;
-
-  /**
-   * assistant step 回发钩子。
-   *
-   * 关键点（中文）
-   * - ChatSession 内部会先完成 step 持久化，再调用该钩子做真实渠道发送。
-   */
-  onAssistantStepCallback?: SessionAssistantStepCallback;
-}

package/src/types/city/PublicHostEnv.ts

@@ -1,76 +0,0 @@
-/**
- * city 公网 host 环境变量类型。
- *
- * 关键点（中文）
- * - `city start` 会自动探测公网 IP，并写入 Console Env。
- * - contact link 通过 Console Env 读取该值，避免 link code 回退到 localhost。
- */
-
-/**
- * 公网 host 自动配置结果。
- */
-export type CityPublicHostEnvResult =
-  | {
-      /**
-       * 是否写入了新的环境变量。
-       */
-      changed: true;
-      /**
-       * 写入的环境变量名称。
-       */
-      key: "DOWNCITY_PUBLIC_HOST";
-      /**
-       * 写入的公网 host 值。
-       */
-      value: string;
-    }
-  | {
-      /**
-       * 是否写入了新的环境变量。
-       */
-      changed: false;
-      /**
-       * 未写入的原因。
-       */
-      reason: "configured" | "unavailable";
-    };
-
-/**
- * 写入 Console Env 的公网 host 条目。
- */
-export interface CityPublicHostEnvEntry {
-  /**
-   * 环境变量名称。
-   */
-  key: "DOWNCITY_PUBLIC_HOST";
-  /**
-   * 公网 host 值。
-   */
-  value: string;
-  /**
-   * 环境变量说明。
-   */
-  description: string;
-}
-
-/**
- * city 公网 host 自动配置依赖。
- */
-export interface EnsureCityPublicHostEnvInput {
-  /**
-   * 当前进程环境变量。
-   */
-  env?: NodeJS.ProcessEnv | Record<string, string | undefined>;
-  /**
-   * 读取 Console Env 全局变量。
-   */
-  readGlobalEnv?: () => Record<string, string>;
-  /**
-   * 公网 IPv4 解析器。
-   */
-  resolvePublicIpv4?: () => Promise<string | null> | string | null;
-  /**
-   * 写入 Console Env 全局变量。
-   */
-  upsertGlobalEnv?: (entry: CityPublicHostEnvEntry) => Promise<void>;
-}