@downcity/city 1.1.4 → 1.1.5

package/src/types/cli/AgentChat.ts

@@ -1,172 +0,0 @@
-/**
- * `city agent chat` CLI 类型。
- *
- * 关键点（中文）
- * - 统一覆盖交互式持续对话与一次性消息两种入口。
- * - 默认使用独立的 local-cli 会话，避免与 Console UI 上下文互相污染。
- */
-
-/**
- * `city agent chat` 默认使用的 local-cli 会话 ID。
- */
-export const AGENT_CHAT_DEFAULT_SESSION_ID = "local-cli-chat-main";
-
-/**
- * `city agent chat` 命令选项。
- */
-export interface AgentChatCliOptions {
-  /**
-   * 目标 agent 名称。
-   *
-   * 说明（中文）
-   * - 省略时在交互式终端中从当前运行中的 agent 列表里选择。
-   */
-  to?: string;
-
-  /**
-   * 一次性发送的消息文本。
-   *
-   * 说明（中文）
-   * - 传入后不进入 REPL，执行一轮后直接退出。
-   * - 未传时进入交互式持续对话模式。
-   */
-  message?: string;
-
-  /**
-   * 是否输出 JSON。
-   *
-   * 说明（中文）
-   * - 仅一次性模式使用；交互式对话不输出结构化 JSON。
-   */
-  json?: boolean;
-
-  /**
-   * 覆盖目标 runtime host。
-   */
-  host?: string;
-
-  /**
-   * 覆盖目标 runtime port。
-   */
-  port?: number;
-
-  /**
-   * 显式覆盖 Bearer Token。
-   */
-  token?: string;
-}
-
-/**
- * Dashboard execute 结果片段。
- */
-export interface AgentChatExecuteResult {
-  /**
-   * 本轮执行是否成功。
-   */
-  success?: boolean;
-
-  /**
-   * 是否已经进入队列。
-   */
-  queued?: boolean;
-
-  /**
-   * 队列项 ID。
-   */
-  queueItemId?: string;
-
-  /**
-   * 当前队列位置。
-   */
-  queuePosition?: number;
-
-  /**
-   * 面向用户可直接阅读的回复文本。
-   */
-  userVisible?: string;
-
-  /**
-   * 错误信息。
-   */
-  error?: string;
-}
-
-/**
- * Dashboard execute 响应体。
- */
-export interface AgentChatExecuteResponse {
-  /**
-   * HTTP 路由层是否成功处理请求。
-   */
-  success: boolean;
-
-  /**
-   * 实际执行使用的 sessionId。
-   */
-  sessionId?: string;
-
-  /**
-   * 执行结果。
-   */
-  result?: AgentChatExecuteResult;
-
-  /**
-   * 顶层错误信息。
-   */
-  error?: string;
-}
-
-/**
- * 复用 chat transport 时的基础选项。
- */
-export interface AgentChatTransportOptions {
-  /**
-   * 覆盖目标 runtime host。
-   */
-  host?: string;
-
-  /**
-   * 覆盖目标 runtime port。
-   */
-  port?: number;
-
-  /**
-   * 显式覆盖 Bearer Token。
-   */
-  token?: string;
-}
-
-/**
- * 单轮 chat 执行结果。
- */
-export interface AgentChatExecutionOutcome {
-  /**
-   * 目标 agent 名称。
-   */
-  agentName: string;
-
-  /**
-   * 目标 agent 项目根目录。
-   */
-  projectRoot?: string;
-
-  /**
-   * 实际执行使用的 sessionId。
-   */
-  sessionId: string;
-
-  /**
-   * 请求是否成功。
-   */
-  success: boolean;
-
-  /**
-   * 执行结果响应体。
-   */
-  payload?: AgentChatExecuteResponse;
-
-  /**
-   * 失败时的错误文本。
-   */
-  error?: string;
-}

package/src/types/cli/AgentHistory.ts

@@ -1,146 +0,0 @@
-/**
- * Agent 历史维护命令类型。
- *
- * 关键点（中文）
- * - 只描述 CLI 输入与清理结果。
- * - 具体文件删除逻辑放在 `src/cli/AgentHistory.ts`。
- */
-
-/**
- * `city agent history clean` 命令选项。
- */
-export interface AgentHistoryCleanOptions {
-  /**
-   * 目标 session ID。
-   *
-   * 说明（中文）
-   * - 与 channel/chatId 二选一。
-   * - 显式传入时优先级最高。
-   */
-  sessionId?: string;
-
-  /**
-   * 目标聊天渠道。
-   *
-   * 说明（中文）
-   * - 用于从 `.downcity/channel/meta.json` 反查 sessionId。
-   */
-  channel?: string;
-
-  /**
-   * 目标渠道内 chat ID。
-   *
-   * 说明（中文）
-   * - 与 channel 组合定位某个 Telegram/Feishu/QQ 对话。
-   */
-  chatId?: string;
-
-  /**
-   * 目标渠道会话类型。
-   *
-   * 说明（中文）
-   * - 可选字段，群聊/线程场景中用于缩小匹配范围。
-   */
-  targetType?: string;
-
-  /**
-   * 目标线程 ID。
-   *
-   * 说明（中文）
-   * - Telegram forum topic 等线程场景可使用。
-   */
-  threadId?: string;
-
-  /**
-   * 是否执行硬清理。
-   *
-   * 说明（中文）
-   * - 必须显式为 true，命令才会删除文件。
-   */
-  hard?: boolean;
-
-  /**
-   * 是否以 JSON 格式输出。
-   */
-  json?: boolean;
-}
-
-/**
- * Agent 历史硬清理结果。
- */
-export interface AgentHistoryCleanResult {
-  /**
-   * Agent 项目根目录。
-   */
-  projectRoot: string;
-
-  /**
-   * 被清理的 session ID。
-   */
-  sessionId: string;
-
-  /**
-   * 是否删除了 core session 目录。
-   */
-  removedSessionDir: boolean;
-
-  /**
-   * 是否删除了 chat 审计目录。
-   */
-  removedChatDir: boolean;
-
-  /**
-   * 是否删除了 channel 路由映射。
-   */
-  removedRoute: boolean;
-}
-
-/**
- * Channel 路由记录。
- */
-export interface AgentHistoryChannelRoute {
-  /**
-   * 路由绑定的 session ID。
-   */
-  sessionId?: unknown;
-
-  /**
-   * 渠道名称，例如 telegram。
-   */
-  channel?: unknown;
-
-  /**
-   * 渠道内 chat ID。
-   */
-  chatId?: unknown;
-
-  /**
-   * 渠道会话类型，例如 private。
-   */
-  targetType?: unknown;
-
-  /**
-   * 渠道线程 ID，例如 Telegram forum topic ID。
-   */
-  threadId?: unknown;
-}
-
-/**
- * `.downcity/channel/meta.json` 文件结构。
- */
-export interface AgentHistoryChannelMetaFile {
-  /**
-   * 路由文件最后更新时间。
-   */
-  updatedAt?: unknown;
-
-  /**
-   * 以 target key 索引的 session ID 映射。
-   */
-  sessionIdByTargetKey?: Record<string, unknown>;
-
-  /**
-   * 以 session ID 索引的渠道路由映射。
-   */
-  routesBySessionId?: Record<string, AgentHistoryChannelRoute>;
-}

package/src/types/cli/AgentManager.ts

@@ -1,119 +0,0 @@
-/**
- * `city agent` 交互式 manager 类型。
- *
- * 关键点（中文）
- * - 统一描述交互式 agent 管理器中的菜单动作与摘要视图。
- * - CLI 实现只引用这些显式类型，避免在命令模块中散落匿名对象结构。
- */
-
-/**
- * `city agent` 根菜单动作。
- */
-export type AgentManagerRootAction =
-  /**
-   * 查看 city registry 中登记的 agent。
-   */
-  | "list"
-  /**
-   * 创建或初始化一个 agent 项目。
-   */
-  | "create"
-  /**
-   * 启动一个 agent daemon。
-   */
-  | "start"
-  /**
-   * 选择一个已登记 agent 并进入管理视图。
-   */
-  | "manage"
-  /**
-   * 退出交互式管理器。
-   */
-  | "exit";
-
-/**
- * 单个 agent 详情视图可执行动作。
- */
-export type AgentManagerAgentAction =
-  /**
-   * 查看 agent daemon 状态。
-   */
-  | "status"
-  /**
-   * 启动当前 agent daemon。
-   */
-  | "start"
-  /**
-   * 停止当前 agent daemon。
-   */
-  | "stop"
-  /**
-   * 重启当前 agent daemon。
-   */
-  | "restart"
-  /**
-   * 在终端里与当前 agent 对话。
-   */
-  | "chat"
-  /**
-   * 配置当前 agent 的展示名称。
-   */
-  | "configureName"
-  /**
-   * 配置当前 agent 的执行模型绑定。
-   */
-  | "configureModel"
-  /**
-   * 将当前 agent 连接到 city 级 chat channel account。
-   */
-  | "connectChannels"
-  /**
-   * 返回上一级菜单。
-   */
-  | "back";
-
-/**
- * agent 列表中的摘要信息。
- */
-export interface AgentManagerAgentSummary {
-  /**
-   * agent 展示名称。
-   *
-   * 说明（中文）
-   * - 优先来自项目配置中的 agent 名称。
-   * - 当配置不可读时由项目目录名兜底。
-   */
-  name: string;
-
-  /**
-   * agent 项目的绝对路径。
-   */
-  projectRoot: string;
-
-  /**
-   * agent 当前运行状态。
-   *
-   * 说明（中文）
-   * - `running` 表示 daemon 仍然存活。
-   * - `stopped` 表示 registry 中有记录但当前未运行。
-   */
-  status: "running" | "stopped";
-
-  /**
-   * 当前 agent 配置中的执行模型 ID。
-   *
-   * 说明（中文）
-   * - 来自 `downcity.json.execution.modelId`。
-   * - 配置缺失或不可读时为空。
-   */
-  modelId?: string;
-
-  /**
-   * 当前 agent 关联的 chat channel 摘要。
-   *
-   * 说明（中文）
-   * - 来源于 `downcity.json.services.chat.channels`。
-   * - 只表达 agent 与 city channel account 的关联，不承载账号密钥配置。
-   */
-  channels: string[];
-}

package/src/types/cli/AgentSelection.ts

@@ -1,162 +0,0 @@
-/**
- * agent 选择与列表展示类型定义。
- *
- * 关键点（中文）
- * - 统一描述 `city agent list` 与 `city agent start` 交互选择共用的数据结构。
- * - 类型集中放在 `src/types/cli/`，避免命令层继续散落匿名对象协议。
- */
-
-/**
- * CLI 侧的已登记 agent 视图。
- */
-export type CliRegisteredAgentView = {
-  /**
-   * agent 展示名称。
-   *
-   * 说明（中文）
-   * - 优先读取 `downcity.json.name`。
-   * - 若未配置则回退为目录名。
-   */
-  name: string;
-
-  /**
-   * agent 项目根目录绝对路径。
-   *
-   * 说明（中文）
-   * - 作为 CLI 展示与后续启动目标的唯一定位键。
-   */
-  projectRoot: string;
-
-  /**
-   * registry 当前记录的运行状态。
-   *
-   * 说明（中文）
-   * - 这里只复用 registry 的粗粒度状态。
-   * - 更细的实时健康状态由其他命令单独判定。
-   */
-  status: "running" | "stopped";
-};
-
-/**
- * 交互式 agent 选择器中的单项 choice。
- */
-export type CliAgentPromptChoice = {
-  /**
-   * choice 主标题。
-   *
-   * 说明（中文）
-   * - 终端里通常展示为 agent 名称。
-   */
-  title: string;
-
-  /**
-   * choice 被选中后的返回值。
-   *
-   * 说明（中文）
-   * - 这里直接使用 projectRoot，便于后续命令链路复用。
-   */
-  value: string;
-
-  /**
-   * choice 辅助说明。
-   *
-   * 说明（中文）
-   * - 用于展示状态和绝对路径，帮助用户区分同名 agent。
-   */
-  description: string;
-};
-
-/**
- * `agent start` 目标解析的输入参数。
- */
-export type ResolveCliAgentStartTargetDecisionInput = {
-  /**
-   * 用户在命令行中显式传入的路径参数。
-   *
-   * 说明（中文）
-   * - 为空时表示用户没有指定路径，需要根据当前目录或交互选择补齐目标。
-   */
-  pathInput?: string;
-
-  /**
-   * 当前 CLI 进程的工作目录绝对路径。
-   *
-   * 说明（中文）
-   * - 当该目录本身就是已初始化 agent 项目时，应优先直接启动当前目录。
-   */
-  currentWorkingDirectory: string;
-
-  /**
-   * 当前工作目录是否已经满足最小 agent 初始化条件。
-   *
-   * 说明（中文）
-   * - 条件通常是 `PROFILE.md` 与 `downcity.json` 同时存在。
-   */
-  currentDirectoryInitialized: boolean;
-
-  /**
-   * 当前会话是否允许交互输入。
-   *
-   * 说明（中文）
-   * - 非 TTY 场景下不能弹选择器，因此必须返回显式错误决策。
-   */
-  interactive: boolean;
-
-  /**
-   * 当前 city registry 中已登记的 agent 列表。
-   *
-   * 说明（中文）
-   * - 当用户未传路径且当前目录不是 agent 项目时，这份列表就是交互选择的数据源。
-   */
-  registeredAgents: CliRegisteredAgentView[];
-};
-
-/**
- * `agent start` 目标解析后的决策结果。
- */
-export type ResolveCliAgentStartTargetDecision =
-  | {
-      /**
-       * 决策模式。
-       *
-       * 说明（中文）
-       * - `explicit`：用户传了显式路径。
-       * - `current`：直接使用当前工作目录。
-       */
-      mode: "explicit" | "current";
-
-      /**
-       * 最终确定的 agent 项目根目录。
-       *
-       * 说明（中文）
-       * - 仅在已明确目标目录时存在。
-       */
-      projectRoot: string;
-    }
-  | {
-      /**
-       * 决策模式。
-       *
-       * 说明（中文）
-       * - `prompt` 表示进入交互选择器。
-       */
-      mode: "prompt";
-    }
-  | {
-      /**
-       * 决策模式。
-       *
-       * 说明（中文）
-       * - `error` 表示当前上下文无法自动推导启动目标。
-       */
-      mode: "error";
-
-      /**
-       * 当前错误的标准化原因码。
-       *
-       * 说明（中文）
-       * - `no-registered-agents`：registry 中没有可选 agent。
-       * - `non-interactive`：当前终端无法弹出交互选择器。
-       */
-      reason: "no-registered-agents" | "non-interactive";
-    };

package/src/types/cli/ChatManager.ts

@@ -1,65 +0,0 @@
-/**
- * `city chat` 交互式 manager 类型。
- *
- * 关键点（中文）
- * - `city chat` 裸命令用于管理 chat service 与 city 级 channel accounts。
- * - 这里集中定义菜单动作，避免 CLI 实现里散落匿名字符串。
- */
-
-/**
- * `city chat` 根菜单动作。
- */
-export type ChatManagerRootAction =
-  /**
-   * 查看当前项目 chat service 状态。
-   */
-  | "status"
-  /**
-   * 启动当前项目 chat service。
-   */
-  | "start"
-  /**
-   * 停止当前项目 chat service。
-   */
-  | "stop"
-  /**
-   * 重启当前项目 chat service。
-   */
-  | "restart"
-  /**
-   * 管理 city 全局 chat channel account。
-   */
-  | "configureChannels"
-  /**
-   * 退出交互式管理器。
-   */
-  | "exit";
-
-/**
- * Chat channel account 管理菜单动作。
- */
-export type ChatChannelAccountAction =
-  /**
-   * 查看已配置账号。
-   */
-  | "list"
-  /**
-   * 新增账号。
-   */
-  | "add"
-  /**
-   * 编辑已有账号。
-   */
-  | "edit"
-  /**
-   * 删除已有账号。
-   */
-  | "remove"
-  /**
-   * 配置 city 全局 chat authorization。
-   */
-  | "configureAuthorization"
-  /**
-   * 返回上一级菜单。
-   */
-  | "back";