@downcity/city 1.1.4 → 1.1.6

package/src/types/sandbox/SandboxRuntime.ts

@@ -1,377 +0,0 @@
-/**
- * SandboxRuntime 类型定义。
- *
- * 关键点（中文）
- * - 这里放的是 agent 执行层内部使用的最小 sandbox 运行时类型。
- * - 当前只围绕 `SandboxRunner` 设计，不引入复杂 provider / policy / binding 对象。
- * - 目标是让 `ShellService` 可以直接把命令交给 `SandboxRunner` 执行。
- */
-
-import type { ChildProcessWithoutNullStreams } from "node:child_process";
-import type { SandboxConfig } from "@downcity/agent/shared/types/Sandbox.js";
-import type { SandboxNetworkMode } from "@downcity/agent/shared/types/Sandbox.js";
-
-/**
- * sandbox 会话状态。
- *
- * 说明（中文）
- * - `shell_exec` 这类 one-shot 命令通常会很快走到终态。
- * - `shell_start` 则会维持一个状态化 sandbox session。
- */
-export type SandboxSessionStatus =
-  | "starting"
-  | "running"
-  | "completed"
-  | "failed"
-  | "killed"
-  | "expired";
-
-/**
- * 单个 sandbox session 快照。
- */
-export interface SandboxSessionSnapshot {
-  /**
-   * sandbox 唯一标识。
-   */
-  sandboxId: string;
-
-  /**
-   * 原始命令文本。
-   */
-  cmd: string;
-
-  /**
-   * 当前 sandbox 实际工作目录。
-   */
-  cwd: string;
-
-  /**
-   * 当前 sandbox 状态。
-   */
-  status: SandboxSessionStatus;
-
-  /**
-   * 进程 pid。
-   *
-   * 说明（中文）
-   * - 某些 backend 可能拿不到宿主 pid，这时为空。
-   */
-  pid?: number;
-
-  /**
-   * 创建时间戳（毫秒）。
-   */
-  startedAt: number;
-
-  /**
-   * 最近更新时间戳（毫秒）。
-   */
-  updatedAt: number;
-
-  /**
-   * 结束时间戳（毫秒）。
-   */
-  endedAt?: number;
-
-  /**
-   * 退出码。
-   */
-  exitCode?: number;
-
-  /**
-   * 最近输出预览。
-   */
-  lastOutputPreview?: string;
-
-  /**
-   * 累计输出字符数。
-   */
-  outputChars: number;
-
-  /**
-   * 版本号。
-   *
-   * 说明（中文）
-   * - 任意状态或输出变化都递增，供 wait/read 增量判断使用。
-   */
-  version: number;
-}
-
-/**
- * sandbox 输出块。
- */
-export interface SandboxOutputChunk {
-  /**
-   * 当前输出块所属 sandbox 标识。
-   */
-  sandboxId: string;
-
-  /**
-   * 输出文本。
-   */
-  output: string;
-
-  /**
-   * 起始游标。
-   */
-  startCursor: number;
-
-  /**
-   * 结束游标。
-   */
-  endCursor: number;
-
-  /**
-   * 原始输出字符数。
-   */
-  originalChars: number;
-
-  /**
-   * 是否还有更多输出未读。
-   */
-  hasMoreOutput: boolean;
-}
-
-/**
- * one-shot 命令执行请求。
- */
-export interface SandboxExecRequest {
-  /**
-   * 最终使用的 sandbox 配置。
-   */
-  config: SandboxConfig;
-
-  /**
-   * 要执行的命令文本。
-   */
-  cmd: string;
-
-  /**
-   * 可选工作目录。
-   */
-  cwd?: string;
-
-  /**
-   * 可选 shell 可执行文件。
-   */
-  shell?: string;
-
-  /**
-   * 是否以 login shell 语义执行。
-   */
-  login?: boolean;
-}
-
-/**
- * 状态化 sandbox session 启动请求。
- */
-export interface SandboxStartRequest extends SandboxExecRequest {}
-
-/**
- * sandbox 会话读取请求。
- */
-export interface SandboxReadRequest {
-  /**
-   * 目标 sandbox 标识。
-   */
-  sandboxId: string;
-
-  /**
-   * 从哪个游标开始增量读取。
-   */
-  fromCursor?: number;
-}
-
-/**
- * sandbox 会话写入请求。
- */
-export interface SandboxWriteRequest {
-  /**
-   * 目标 sandbox 标识。
-   */
-  sandboxId: string;
-
-  /**
-   * 要写入 stdin 的原始文本。
-   */
-  chars: string;
-}
-
-/**
- * sandbox 会话等待请求。
- */
-export interface SandboxWaitRequest {
-  /**
-   * 目标 sandbox 标识。
-   */
-  sandboxId: string;
-
-  /**
-   * 仅当版本号大于该值时才立即返回。
-   */
-  afterVersion?: number;
-
-  /**
-   * 最长等待毫秒数。
-   */
-  timeoutMs?: number;
-}
-
-/**
- * sandbox 会话关闭请求。
- */
-export interface SandboxCloseRequest {
-  /**
-   * 目标 sandbox 标识。
-   */
-  sandboxId: string;
-
-  /**
-   * 是否强制关闭。
-   */
-  force?: boolean;
-}
-
-/**
- * `SandboxRunner` 最小接口。
- *
- * 说明（中文）
- * - `exec` 用于 one-shot 命令。
- * - `start/read/write/wait/close` 用于状态化 shell session。
- */
-export interface SandboxRunner {
-  /**
-   * 执行一次 one-shot 命令并等待完成。
-   */
-  exec(request: SandboxExecRequest): Promise<{
-    snapshot: SandboxSessionSnapshot;
-    chunk: SandboxOutputChunk;
-  }>;
-
-  /**
-   * 启动一个状态化 sandbox session。
-   */
-  start(request: SandboxStartRequest): Promise<{
-    snapshot: SandboxSessionSnapshot;
-    chunk: SandboxOutputChunk;
-  }>;
-
-  /**
-   * 读取 sandbox 输出。
-   */
-  read(request: SandboxReadRequest): Promise<{
-    snapshot: SandboxSessionSnapshot;
-    chunk: SandboxOutputChunk;
-  }>;
-
-  /**
-   * 向 sandbox stdin 写入内容。
-   */
-  write(request: SandboxWriteRequest): Promise<{
-    snapshot: SandboxSessionSnapshot;
-  }>;
-
-  /**
-   * 等待 sandbox 状态变化。
-   */
-  wait(request: SandboxWaitRequest): Promise<{
-    snapshot: SandboxSessionSnapshot;
-    chunk: SandboxOutputChunk;
-  }>;
-
-  /**
-   * 关闭 sandbox session。
-   */
-  close(request: SandboxCloseRequest): Promise<{
-    snapshot: SandboxSessionSnapshot;
-  }>;
-}
-
-/**
- * 运行时归一化后的 sandbox 配置。
- *
- * 说明（中文）
- * - 这里的路径都已经解析成绝对路径。
- * - 当前版本强制要求 shell 命令走 sandbox，不再允许回退到宿主机普通子进程执行。
- */
-export interface ResolvedSandboxConfig extends SandboxConfig {
-  /**
-   * 当前运行时选中的 backend。
-   */
-  backend: "macos-seatbelt";
-}
-
-/**
- * 单次 shell 启动时传给 sandbox backend 的归一化参数。
- */
-export interface SandboxSpawnParams {
-  /**
-   * 当前 shell 会话标识。
-   */
-  shellId: string;
-
-  /**
-   * shell 会话目录。
-   */
-  shellDir: string;
-
-  /**
-   * 要执行的原始命令文本。
-   */
-  cmd: string;
-
-  /**
-   * 最终工作目录。
-   */
-  cwd: string;
-
-  /**
-   * shell 可执行文件路径。
-   */
-  shellPath: string;
-
-  /**
-   * 是否使用 login shell 语义。
-   */
-  login: boolean;
-
-  /**
-   * sandbox 生效前的基础环境变量。
-   */
-  baseEnv: NodeJS.ProcessEnv;
-
-  /**
-   * 当前请求最终使用的 sandbox 配置。
-   */
-  config: ResolvedSandboxConfig;
-}
-
-/**
- * sandbox backend 返回的进程启动结果。
- */
-export interface SandboxSpawnResult {
-  /**
-   * 已启动的子进程句柄。
-   */
-  child: ChildProcessWithoutNullStreams;
-
-  /**
-   * 当前子进程实际使用的工作目录。
-   */
-  cwd: string;
-
-  /**
-   * 当前进程是否实际运行在 sandbox 中。
-   */
-  sandboxed: boolean;
-
-  /**
-   * 当前使用的 backend 名称。
-   */
-  backend: "macos-seatbelt";
-
-  /**
-   * 当前实际采用的网络模式。
-   */
-  networkMode: SandboxNetworkMode;
-}

package/src/types/store/Store.ts

@@ -1,27 +0,0 @@
-/**
- * city ConsoleStore 相关类型。
- *
- * 关键点（中文）
- * - 绝大多数存储结构直接复用 `@downcity/agent` 的共享类型定义。
- * - city 只在这里补充 console 专属的派生视图类型，避免继续维护整份副本。
- */
-
-export * from "@downcity/agent/shared/types/Store.js";
-
-/**
- * Provider 元信息（不含 API Key，用于同步快速查询）。
- */
-export interface StoredProviderMeta {
-  /**
-   * provider 主键 ID。
-   */
-  id: string;
-  /**
-   * provider 类型。
-   */
-  type: string;
-  /**
-   * provider baseUrl（可选）。
-   */
-  baseUrl?: string;
-}

package/src/types/task/TaskRunner.ts

@@ -1,199 +0,0 @@
-/**
- * TaskRunner 类型定义。
- *
- * 关键点（中文）
- * - 这里集中声明 task runner 在拆分后跨模块共享的内部类型。
- * - 这些类型服务于 task 运行链路，统一归档到 `src/types/task/`。
- */
-
-import type { SessionHistoryComposerPort } from "@downcity/agent/types/agent/AgentContext.js";
-import type { SessionExecutor } from "@downcity/agent/types/session/SessionExecutor.js";
-import type {
-  ShipTaskRunExecutionStatusV1,
-  ShipTaskRunProgressPhaseV1,
-  ShipTaskRunProgressStatusV1,
-  ShipTaskRunResultStatusV1,
-  ShipTaskRunStatusV1,
-} from "@downcity/agent/services/task/types/Task.js";
-
-/**
- * run-progress.json 的当前快照状态。
- */
-export type RunProgressSnapshot = {
-  /**
-   * 当前进度状态。
-   */
-  status: ShipTaskRunProgressStatusV1;
-  /**
-   * 当前进度阶段。
-   */
-  phase: ShipTaskRunProgressPhaseV1;
-  /**
-   * 当前阶段对人类可读的说明文本。
-   */
-  message: string;
-  /**
-   * 当前对话轮次。
-   */
-  round?: number;
-  /**
-   * 最大允许轮次。
-   */
-  maxRounds?: number;
-  /**
-   * 运行结束时间（毫秒时间戳）。
-   */
-  endedAt?: number;
-  /**
-   * 任务总体运行状态。
-   */
-  runStatus?: ShipTaskRunStatusV1;
-  /**
-   * 执行阶段状态。
-   */
-  executionStatus?: ShipTaskRunExecutionStatusV1;
-  /**
-   * 结果校验状态。
-   */
-  resultStatus?: ShipTaskRunResultStatusV1;
-};
-
-/**
- * 任务结果校验结果。
- */
-export type TaskResultValidation = {
-  /**
-   * 结果校验后的状态。
-   */
-  resultStatus: ShipTaskRunResultStatusV1;
-  /**
-   * 校验失败时的错误列表。
-   */
-  errors: string[];
-};
-
-/**
- * 模拟用户的判定结果。
- */
-export type UserSimulatorDecision = {
-  /**
-   * 模拟用户是否认为当前结果已满足要求。
-   */
-  satisfied: boolean;
-  /**
-   * 模拟用户给出的回复文本。
-   */
-  reply: string;
-  /**
-   * 判定理由。
-   */
-  reason: string;
-  /**
-   * 可选评分，范围通常为 0-10。
-   */
-  score?: number;
-  /**
-   * 原始输出文本快照。
-   */
-  raw: string;
-};
-
-/**
- * 单轮对话的落盘记录。
- */
-export type DialogueRoundRecord = {
-  /**
-   * 当前任务是否启用了 review 多轮模式。
-   */
-  reviewEnabled: boolean;
-  /**
-   * 当前轮次编号。
-   */
-  round: number;
-  /**
-   * 本轮执行器收到的 query。
-   */
-  executorQuery: string;
-  /**
-   * 本轮执行器输出文本。
-   */
-  executorOutput: string;
-  /**
-   * 本轮执行器是否通过 `chat_send` 等方式实际送达文本。
-   */
-  executorDelivered: boolean;
-  /**
-   * 执行器 assistantMessage 的调试快照。
-   */
-  executorAssistantMessageSnapshot?: string;
-  /**
-   * 本轮结果校验状态。
-   */
-  validationResultStatus: ShipTaskRunResultStatusV1;
-  /**
-   * 本轮规则校验失败项。
-   */
-  ruleErrors: string[];
-  /**
-   * 模拟用户收到的 query。
-   */
-  userSimulatorQuery?: string;
-  /**
-   * 模拟用户输出文本。
-   */
-  userSimulatorOutput?: string;
-  /**
-   * 模拟用户 assistantMessage 的调试快照。
-   */
-  userSimulatorAssistantMessageSnapshot?: string;
-  /**
-   * 模拟用户最终判定结果。
-   */
-  userSimulator: UserSimulatorDecision;
-  /**
-   * 传递给下一轮执行器的反馈文本。
-   */
-  feedbackForNextRound?: string;
-};
-
-/**
- * script 类型任务的执行结果。
- */
-export type ScriptExecutionResult = {
-  /**
-   * script 标准输出与标准错误合并后的文本。
-   */
-  outputText: string;
-};
-
-/**
- * task 运行专用的 session runtime 端口。
- *
- * 关键点（中文）
- * - task runner 不直接依赖具体 `LocalSessionExecutor` 实现。
- * - 这里暴露的是 task 场景最小可用端口：执行器 + history Composer。
- */
-export type TaskSessionRuntimePort = {
-  /**
-   * 获取指定 sessionId 对应的 Session 执行端口。
-   */
-  getExecutor(sessionId: string): SessionExecutor;
-  /**
-   * 获取指定 sessionId 对应的 SessionHistoryComposer 持久化端口。
-   */
-  getHistoryComposer(sessionId: string): SessionHistoryComposerPort;
-};
-
-/**
- * 从 assistant 输出中提取的文本结果。
- */
-export type ChatSendOutputPick = {
-  /**
-   * 最终提取到的文本内容。
-   */
-  text: string;
-  /**
-   * 该文本是否已经通过 chat_send 等方式送达。
-   */
-  delivered: boolean;
-};