@downcity/agent 1.1.287 → 1.1.310

package/src/types/runtime/http/InlineInstant.ts

@@ -1,96 +0,0 @@
-/**
- * Inline 即时执行类型定义。
- *
- * 关键点（中文）
- * - 统一描述 Chrome Extension Inline Composer 的“即时模式”请求与返回。
- * - 即时模式始终走临时 session，执行完成后立即返回文本结果。
- * - executor 只是即时模式的内部执行实现，不再暴露独立产品路径。
- */
-
-/**
- * Inline 即时执行器类型。
- */
-export type InlineInstantExecutorType = "model" | "acp";
-
-/**
- * 平台 Inline 即时执行请求输入。
- */
-export interface PlatformInlineInstantRunInput {
-  /**
-   * 本次即时执行选用的 executor 类型。
-   */
-  executorType: InlineInstantExecutorType;
-
-  /**
-   * 用户当前输入的问题或指令。
-   */
-  prompt: string;
-
-  /**
-   * 可选附加 system prompt。
-   */
-  system?: string;
-
-  /**
-   * 可选页面上下文文本。
-   *
-   * 说明（中文）
-   * - 通常由扩展侧把选区或整页快照整理成 Markdown 后传入。
-   */
-  pageContext?: string;
-
-  /**
-   * `model` executor 对应的 City AIService modelId。
-   */
-  modelId?: string;
-
-  /**
-   * `acp` executor 对应的 agent 项目 id。
-   *
-   * 说明（中文）
-   * - 当前实现中等同于 agent 项目根目录绝对路径。
-   */
-  agentId?: string;
-}
-
-/**
- * 平台 Inline 即时执行结果。
- */
-export interface PlatformInlineInstantRunResult {
-  /**
-   * 本次即时执行内部使用的临时 sessionId。
-   */
-  sessionId: string;
-
-  /**
-   * 实际执行使用的 executor 类型。
-   */
-  executorType: InlineInstantExecutorType;
-
-  /**
-   * 最终返回给前端展示的文本结果。
-   */
-  text: string;
-
-  /**
-   * 若为 `model` executor，则回传本次命中的 modelId。
-   */
-  modelId?: string;
-
-  /**
-   * 若为 `acp` executor，则回传本次命中的 agentId。
-   */
-  agentId?: string;
-}
-
-/**
- * 平台 Inline 即时执行运行端口。
- */
-export interface PlatformInlineInstantRunner {
-  /**
-   * 运行一次即时执行请求。
-   */
-  run(
-    input: PlatformInlineInstantRunInput,
-  ): Promise<PlatformInlineInstantRunResult>;
-}

package/src/types/runtime/platform/Platform.ts

@@ -1,432 +0,0 @@
-/**
- * Platform：control plane / managed-agent 相关共享类型定义。
- *
- * 关键点（中文）
- * - control plane runtime 自身的进程状态类型仍保留在这里，因为它属于 city control plane 的公开契约。
- * - 多 agent 平台视图、managed agent registry 结构也集中在这里，避免 city/agent 双侧重复维护。
- * - 文件名使用 `Platform`，强调这些类型服务于平台控制面，而不是某个具体 UI 页面实现。
- */
-
-/**
- * 平台控制面中的单个 agent 选项。
- */
-export interface PlatformAgentOption {
-  /**
-   * UI 侧唯一标识（使用 projectRoot 绝对路径）。
-   */
-  id: string;
-
-  /**
-   * Agent 全局配置中的稳定标识。
-   */
-  agentId: string;
-
-  /**
-   * agent 项目根目录（绝对路径）。
-   */
-  projectRoot: string;
-
-  /**
-   * 当前 downcity 托管的 Agent 进程是否存活。
-   */
-  running: boolean;
-
-  /**
-   * 可访问的 runtime 主机地址（已归一化，不会是 0.0.0.0/::）。
-   */
-  host?: string;
-
-  /**
-   * runtime 端口。
-   */
-  port?: number;
-
-  /**
-   * runtime 基础地址（例如 http://127.0.0.1:5314）。
-   */
-  baseUrl?: string;
-
-  /**
-   * registry 首次登记时间（ISO8601）。
-   */
-  startedAt: string;
-
-  /**
-   * registry 最近刷新时间（ISO8601）。
-   */
-  updatedAt: string;
-
-  /**
-   * 最近停止时间（ISO8601，可选）。
-   */
-  stoppedAt?: string;
-
-  /**
-   * 当前读取到的 downcity 托管进程 pid（仅 running=true 时有值）。
-   */
-  daemonPid?: number;
-
-  /**
-   * downcity 托管进程日志路径（用于排障展示）。
-   */
-  logPath?: string;
-
-  /**
-   * 当前 agent 的 chat 渠道运行快照。
-   */
-  chatProfiles?: Array<{
-    /**
-     * 渠道名（telegram/feishu/qq）。
-     */
-    channel: string;
-    /**
-     * 链路状态（connected/disconnected/unknown）。
-     */
-    linkState?: string;
-    /**
-     * 状态文案（如 polling/ws_online/config_missing）。
-     */
-    statusText?: string;
-  }>;
-
-  /**
-   * 当前 Agent 全局配置绑定的模型 ID。
-   */
-  modelId?: string;
-}
-
-/**
- * `/api/ui/agents` 响应体。
- */
-export interface PlatformAgentsResponse {
-  /**
-   * 请求是否成功。
-   */
-  success: boolean;
-
-  /**
-   * 当前 DC CLI 版本号。
-   */
-  cityVersion: string;
-
-  /**
-   * 当前可选的 agent 列表。
-   */
-  agents: PlatformAgentOption[];
-
-  /**
-   * 当前选中的 agent id（无可用 agent 时为空字符串）。
-   */
-  selectedAgentId: string;
-}
-
-/**
- * 平台控制面使用的本地 GGUF 模型列表响应。
- */
-export interface PlatformLocalModelsResponse {
-  /**
-   * 请求是否成功。
-   */
-  success: boolean;
-
-  /**
-   * 实际扫描使用的模型目录。
-   */
-  modelsDir: string;
-
-  /**
-   * 当前发现的本地模型文件列表。
-   */
-  models: string[];
-}
-
-/**
- * 平台控制面使用的 agent 目录探测结果。
- */
-export interface PlatformAgentDirectoryInspection {
-  /**
-   * 探测的项目绝对路径。
-   */
-  projectRoot: string;
-
-  /**
-   * 该目录是否已满足最小 agent 初始化条件。
-   */
-  initialized: boolean;
-
-  /** 该目录是否已出现在 managed agent registry 中。 */
-  knownAgent: boolean;
-
-  /**
-   * 若已登记，当前 downcity 托管进程是否运行中。
-   */
-  running: boolean;
-
-  /**
-   * 当前目录解析出的 agent id（若存在）。
-   */
-  agentId?: string;
-
-  /**
-   * 当前读取到的主模型 ID（若存在）。
-   */
-  modelId?: string;
-
-}
-
-/**
- * 控制面运行时元数据。
- */
-export interface ControlPlaneRuntimeMeta {
-  /**
-   * UI 进程 pid。
-   */
-  pid: number;
-
-  /**
-   * UI 监听主机。
-   */
-  host: string;
-
-  /**
-   * UI 监听端口。
-   */
-  port: number;
-
-  /**
-   * 启动时间（ISO8601）。
-   */
-  startedAt: string;
-}
-
-/**
- * 控制面运行状态视图。
- */
-export interface ControlPlaneRuntimeStatus {
-  /**
-   * UI 是否运行中。
-   */
-  running: boolean;
-
-  /**
-   * UI pid（运行中时有值）。
-   */
-  pid?: number;
-
-  /**
-   * UI 展示主机（运行中时有值）。
-   *
-   * 说明（中文）
-   * - `0.0.0.0` / `::` 会展示为本机可访问地址，避免用户把通配地址复制到浏览器。
-   */
-  host?: string;
-
-  /**
-   * UI 实际绑定主机（运行中时有值）。
-   *
-   * 说明（中文）
-   * - 用于判断当前控制面是否真的以公网模式监听。
-   * - 可能是 `127.0.0.1`、`0.0.0.0`、自定义 IP 或域名。
-   */
-  bindHost?: string;
-
-  /**
-   * UI 监听端口（运行中时有值）。
-   */
-  port?: number;
-
-  /**
-   * 可访问 URL（运行中时有值）。
-   */
-  url?: string;
-
-  /**
-   * UI 日志路径。
-   */
-  logPath: string;
-
-  /**
-   * 状态文件路径。
-   */
-  pidPath: string;
-}
-
-/**
- * 平台控制面使用的配置文件状态项。
- */
-export interface PlatformConfigFileStatusItem {
-  /**
-   * 配置状态逻辑名称（例如 `agent_config`、`control_plane_pid`）。
-   */
-  key: string;
-
-  /**
-   * 配置文件分组（`platform` 或 `agent`）。
-   */
-  scope: "platform" | "agent";
-
-  /**
-   * 配置文件展示标签。
-   */
-  label: string;
-
-  /**
-   * 配置文件绝对路径。
-   */
-  path: string;
-
-  /**
-   * 是否存在。
-   */
-  exists: boolean;
-
-  /**
-   * 是否为普通文件。
-   */
-  isFile: boolean;
-
-  /**
-   * 是否可读。
-   */
-  readable: boolean;
-
-  /**
-   * 文件大小（字节）。
-   */
-  sizeBytes: number;
-
-  /**
-   * 最后修改时间（ISO8601）。
-   */
-  mtime: string;
-
-  /**
-   * 归一化状态（ok/missing/error）。
-   */
-  status: "ok" | "missing" | "error";
-
-  /**
-   * 状态原因（例如 `file_not_found`、`not_a_file`）。
-   */
-  reason: string;
-}
-
-/**
- * `/api/ui/config-status` 响应体。
- */
-export interface PlatformConfigStatusResponse {
-  /**
-   * 请求是否成功。
-   */
-  success: boolean;
-
-  /**
-   * 当前选中的 agent id（可能为空）。
-   */
-  selectedAgentId: string;
-
-  /**
-   * 当前选中的 Agent 配置 id（可能为空）。
-   */
-  selectedAgentProjectId: string;
-
-  /**
-   * 配置文件状态列表。
-   */
-  items: PlatformConfigFileStatusItem[];
-}
-
-/**
- * control plane 管理的单条 agent registry 记录。
- */
-export interface ManagedAgentRegistryEntry {
-  /**
-   * agent 项目根目录绝对路径。
-   */
-  projectRoot: string;
-
-  /**
-   * registry 最近一次记录的 downcity 托管进程 pid。
-   */
-  pid: number;
-
-  /**
-   * 首次登记时间（ISO8601）。
-   */
-  startedAt: string;
-
-  /**
-   * 最近刷新时间（ISO8601）。
-   */
-  updatedAt: string;
-
-  /**
-   * registry 记录状态。
-   */
-  status: "running" | "stopped";
-
-  /**
-   * 最近停止时间（仅 stopped 时有值）。
-   */
-  stoppedAt?: string;
-}
-
-/**
- * control plane 管理的 agent registry 文件结构。
- */
-export interface ManagedAgentRegistryV1 {
-  /**
-   * registry schema 版本。
-   */
-  v: 1;
-
-  /**
-   * registry 最近更新时间（ISO8601）。
-   */
-  updatedAt: string;
-
-  /**
-   * 当前登记的 agent 列表。
-   */
-  agents: ManagedAgentRegistryEntry[];
-}
-
-/**
- * `downcity agent list --running` 输出可复用的受管 agent 运行态视图。
- */
-export interface ManagedAgentProcessView {
-  /**
-   * agent 项目根目录绝对路径。
-   */
-  projectRoot: string;
-
-  /**
-   * registry 中登记的 pid。
-   */
-  registeredPid: number;
-
-  /**
-   * 当前实际存活的 downcity 托管进程 pid。
-   */
-  daemonPid: number;
-
-  /**
-   * 当前是否运行中。
-   */
-  running: boolean;
-
-  /**
-   * 首次启动时间（ISO8601）。
-   */
-  startedAt: string;
-
-  /**
-   * 最近更新时间（ISO8601）。
-   */
-  updatedAt: string;
-
-  /**
-   * downcity 托管进程日志文件路径。
-   */
-  logPath: string;
-}

package/src/types/runtime/platform/PlatformGateway.ts

@@ -1,46 +0,0 @@
-/**
- * 平台控制面读取 Agent runtime 状态时使用的宽松类型。
- *
- * 关键点（中文）
- * - 仅承载平台 gateway / control plane 内部使用的结构化类型。
- * - 所有字段保持宽松输入，便于兼容运行时 API 的非强约束数据。
- */
-/**
- * chat plugin status 返回中的单渠道状态。
- */
-export interface PlatformAgentChatChannelStatus {
-  /**
-   * 渠道名。
-   */
-  channel?: unknown;
-
-  /**
-   * 是否启用。
-   */
-  enabled?: unknown;
-
-  /**
-   * 是否已完成配置。
-   */
-  configured?: unknown;
-
-  /**
-   * Agent runtime 中该渠道是否处于运行态。
-   */
-  running?: unknown;
-
-  /**
-   * 链接状态文本。
-   */
-  linkState?: unknown;
-
-  /**
-   * 用户可见状态文案。
-   */
-  statusText?: unknown;
-
-  /**
-   * 额外明细。
-   */
-  detail?: Record<string, unknown>;
-}

package/src/types/session/SessionApproval.ts

@@ -1,69 +0,0 @@
-/**
- * Session 级工具审批类型。
- *
- * 审批由具体工具运行时执行，但归属、查询和决策能力统一通过 Session 暴露。
- */
-
-/** Session 工具审批的最终人工决策。 */
-export type SessionApprovalDecision = "approved" | "denied";
-
-/** Session 工具审批模式。 */
-export type SessionApprovalMode = "ask" | "always-allow";
-
-/** 当前 Session 的待审批工具请求。 */
-export interface SessionApproval {
-  /** 当前审批请求的稳定唯一标识。 */
-  approval_id: string;
-  /** 当前审批所属 Session 标识。 */
-  session_id: string;
-  /** 当前审批所属 Turn 标识。 */
-  turn_id: string;
-  /** 当前审批对应的工具调用标识。 */
-  tool_call_id: string;
-  /** 当前审批对应的工具注册名称。 */
-  tool_name: string;
-  /** 请求执行的命令或输入文本。 */
-  command: string;
-  /** 当前工具执行工作目录。 */
-  cwd: string;
-  /** 工具申请 unrestricted 权限的原因。 */
-  reason: string;
-  /** 当前审批对应的工具操作类型。 */
-  operation: "exec" | "start" | "write";
-  /** 当前审批创建时间戳（ms）。 */
-  created_at: number;
-  /** 当前审批自动过期时间戳（ms）。 */
-  expires_at: number;
-}
-
-/** 提交 Session 工具审批决策的参数。 */
-export interface ResolveSessionApprovalInput {
-  /** 需要处理的审批请求标识。 */
-  approval_id: string;
-  /** 对当前审批请求作出的最终决定。 */
-  decision: SessionApprovalDecision;
-}
-
-/** Session 工具审批决策结果。 */
-export interface SessionApprovalResult {
-  /** 是否成功命中并处理 pending 审批。 */
-  success: boolean;
-  /** 已尝试处理的审批请求标识。 */
-  approval_id: string;
-  /** 已提交的最终审批决定。 */
-  decision: SessionApprovalDecision;
-}
-
-/** 当前 Session 的审批模式快照。 */
-export interface SessionApprovalModeSnapshot {
-  /** 当前审批模式所属 Session 标识。 */
-  session_id: string;
-  /** 当前 Session 生效的审批模式。 */
-  mode: SessionApprovalMode;
-}
-
-/** 更新当前 Session 审批模式的参数。 */
-export interface SetSessionApprovalModeInput {
-  /** 需要设置的新审批模式。 */
-  mode: SessionApprovalMode;
-}

package/src/types/session/SessionApprovalBroker.ts

@@ -1,18 +0,0 @@
-/**
- * Session Approval Broker 内部类型。
- *
- * Broker 是单个 Session 内 pending approval 与审批模式的唯一所有者。
- */
-
-import type { SessionApproval } from "@/types/session/SessionApproval.js";
-import type { ShellApprovalStatus } from "@downcity/shell";
-
-/** Broker 内部保存的单个 pending approval。 */
-export interface SessionPendingApproval {
-  /** 对外发布的完整审批快照。 */
-  approval: SessionApproval;
-  /** 兑现 Shell 等待 Promise 的回调。 */
-  resolve: (decision: ShellApprovalStatus) => void;
-  /** 审批自动过期定时器。 */
-  timer: ReturnType<typeof setTimeout>;
-}

package/src/types/session/SessionInstruction.ts

@@ -1,24 +0,0 @@
-/**
- * Session system 显式快照存储类型。
- *
- * 关键点（中文）
- * - 这里只描述 instruction.md 的定位与写入输入。
- * - 文件存在性本身用于表达 Session 是否启用显式 system 快照。
- */
-
-/** Session instruction.md 的稳定定位信息。 */
-export interface SessionInstructionStorageLocation {
-  /** 当前项目根目录。 */
-  project_root: string;
-  /** 当前 Agent 稳定标识。 */
-  agent_id: string;
-  /** 当前 Session 稳定标识。 */
-  session_id: string;
-}
-
-/** 原子写入 Session instruction.md 使用的完整输入。 */
-export interface WriteSessionInstructionInput
-  extends SessionInstructionStorageLocation {
-  /** 当前 Session 首次生成后固定的完整 system Markdown。 */
-  instruction: string;
-}