@downcity/city 1.1.1 → 1.1.4

package/src/shared/types/ServiceState.ts

@@ -1,112 +0,0 @@
-/**
- * ServiceState：service 状态相关共享类型。
- *
- * 关键点（中文）
- * - 这里只放状态快照与控制结果，不放 service 契约本身。
- * - 目的是让 main/service 内部拆分后，仍能共享统一的状态结构。
- */
-
-import type { ServiceState } from "@/shared/types/Service.js";
-
-/**
- * 单个 service 实例内部持有的状态记录。
- *
- * 关键点（中文）
- * - 这是 service 实例级的内部状态，不直接暴露给外部 API。
- * - `ServiceStateController` 负责更新它，service 实例负责持有它。
- */
-export type ServiceStateRecord = {
-  /**
-   * 当前运行状态。
-   */
-  state: ServiceState;
-  /**
-   * 最近一次状态更新时间（毫秒时间戳）。
-   */
-  updatedAt: number;
-  /**
-   * 最近一次错误信息。
-   */
-  lastError?: string;
-  /**
-   * 最近一次执行的命令名。
-   */
-  lastCommand?: string;
-  /**
-   * 最近一次执行命令的时间（毫秒时间戳）。
-   */
-  lastCommandAt?: number;
-  /**
-   * 当前串行控制链。
-   *
-   * 关键点（中文）
-   * - 用于把同一 service 的 start/stop/restart 串行化。
-   * - 避免并发控制命令把状态机打乱。
-   */
-  chain: Promise<void>;
-};
-
-/**
- * 单个 service 状态的对外快照。
- */
-export type ServiceStateSnapshot = {
-  /**
-   * service 名称。
-   */
-  name: string;
-  /**
-   * 当前运行状态。
-   */
-  state: ServiceState;
-  /**
-   * 最近一次状态更新时间（毫秒时间戳）。
-   */
-  updatedAt: number;
-  /**
-   * 最近一次错误信息。
-   */
-  lastError?: string;
-  /**
-   * 最近一次执行的命令名。
-   */
-  lastCommand?: string;
-  /**
-   * 最近一次执行命令的时间（毫秒时间戳）。
-   */
-  lastCommandAt?: number;
-  /**
-   * 是否支持 start/stop 生命周期控制。
-   */
-  supportsLifecycle: boolean;
-  /**
-   * 是否支持 command/action 命令调用。
-   */
-  supportsCommand: boolean;
-};
-
-/**
- * service 状态控制动作。
- */
-export type ServiceStateControlAction =
-  | "start"
-  | "stop"
-  | "restart"
-  | "status";
-
-/**
- * service 状态控制结果。
- */
-export type ServiceStateControlResult = {
-  /**
-   * 控制动作是否成功。
-   */
-  success: boolean;
-  /**
-   * 成功或失败后返回的最新 service 快照。
-   */
-  service?: ServiceStateSnapshot;
-  /**
-   * 失败时的错误信息。
-   */
-  error?: string;
-};

package/src/shared/types/Services.ts

@@ -1,100 +0,0 @@
-/**
- * service 管理命令类型。
- *
- * 关键点（中文）
- * - 统一描述 CLI -> daemon 的 service 管理协议
- * - 支持 lifecycle 控制与通用 command 转发
- */
-
-import type { JsonValue } from "@/shared/types/Json.js";
-
-export type ServiceControlAction = "start" | "stop" | "restart" | "status";
-
-/**
- * 单个 service 的对外状态视图。
- */
-export type ServiceStateView = {
-  /** service 稳定名称。 */
-  name: string;
-  /** 当前运行状态。 */
-  state: "running" | "stopped" | "starting" | "stopping" | "error";
-  /** 最近一次状态更新时间（毫秒时间戳）。 */
-  updatedAt: number;
-  /** 最近一次错误信息。 */
-  lastError?: string;
-  /** 最近一次执行的命令名称。 */
-  lastCommand?: string;
-  /** 最近一次执行命令的时间（毫秒时间戳）。 */
-  lastCommandAt?: number;
-  /** 当前 service 是否支持显式 start/stop 生命周期控制。 */
-  supportsLifecycle: boolean;
-  /** 当前 service 是否支持 command/action 调用。 */
-  supportsCommand: boolean;
-};
-
-/**
- * service 列表响应。
- */
-export type ServiceListResponse = {
-  /** 本次读取是否成功。 */
-  success: boolean;
-  /** 成功时返回的 service 状态列表。 */
-  services?: ServiceStateView[];
-  /** 失败时返回的错误信息。 */
-  error?: string;
-};
-
-/**
- * service 生命周期控制响应。
- */
-export type ServiceControlResponse = {
-  /** 本次控制动作是否成功。 */
-  success: boolean;
-  /** 成功时返回最新的 service 状态视图。 */
-  service?: ServiceStateView;
-  /** 失败时的错误信息。 */
-  error?: string;
-};
-
-/**
- * service command/action 执行响应。
- */
-export type ServiceCommandResponse = {
-  /** 本次 command/action 是否执行成功。 */
-  success: boolean;
-  /** 当前 service 的最新状态视图。 */
-  service?: ServiceStateView;
-  /** 面向人类可读的补充文本。 */
-  message?: string;
-  /** command/action 的数据输出。 */
-  data?: JsonValue;
-  /** 失败时的错误信息。 */
-  error?: string;
-};
-
-export type ServiceCliBaseOptions = {
-  /**
-   * agent 项目路径（默认当前目录）。
-   */
-  path?: string;
-  /**
-   * agent 名称（从 console registry 解析到项目路径）。
-   */
-  agent?: string;
-  /**
-   * 覆盖服务主机地址。
-   */
-  host?: string;
-  /**
-   * 覆盖服务端口。
-   */
-  port?: number;
-  /**
-   * 显式覆盖 Bearer Token。
-   */
-  token?: string;
-  /**
-   * 是否输出 JSON。
-   */
-  json?: boolean;
-};

package/src/shared/types/Shell.ts

@@ -1,103 +0,0 @@
-/**
- * Shell 工具类型定义。
- *
- * 关键点（中文）
- * - 统一沉淀 `shell_start/shell_status/shell_read/shell_write/shell_wait/shell_close` 类型。
- * - `shell_id` 与 chat `sessionId` 严格分离，避免语义混淆。
- */
-
-/**
- * 启动一个交互式 shell session 的输入。
- */
-export type ShellStartInput = {
-  /** 要启动的命令文本。 */
-  cmd: string;
-  /** shell 进程的工作目录。 */
-  workdir?: string;
-  /** 显式指定 shell 可执行文件。 */
-  shell?: string;
-  /** 是否使用 login shell 语义启动。 */
-  login?: boolean;
-  /** 启动后内联等待输出的毫秒数。 */
-  inline_wait_ms?: number;
-  /** 最多返回多少输出 token。 */
-  max_output_tokens?: number;
-  /** 进程退出时是否自动通知调用方。 */
-  auto_notify_on_exit?: boolean;
-};
-
-/**
- * 执行一次非持久 shell 命令的输入。
- */
-export type ShellExecInput = {
-  /** 要执行的命令文本。 */
-  cmd: string;
-  /** 命令执行工作目录。 */
-  workdir?: string;
-  /** 显式指定 shell 可执行文件。 */
-  shell?: string;
-  /** 是否使用 login shell 语义启动。 */
-  login?: boolean;
-  /** 本次命令执行超时时间。 */
-  timeout_ms?: number;
-  /** 最多返回多少输出 token。 */
-  max_output_tokens?: number;
-};
-
-/**
- * 查询 shell 运行状态的输入。
- */
-export type ShellStatusInput = {
-  /** 要查询的 shell session ID。 */
-  shell_id?: string;
-  /** 可选的原始命令文本，用于宽松筛选。 */
-  cmd?: string;
-};
-
-/**
- * 读取 shell 输出流的输入。
- */
-export type ShellReadInput = {
-  /** 要读取的 shell session ID。 */
-  shell_id: string;
-  /** 从哪个游标开始增量读取。 */
-  from_cursor?: number;
-  /** 最多返回多少输出 token。 */
-  max_output_tokens?: number;
-};
-
-/**
- * 向 shell session 写入输入字符。
- */
-export type ShellWriteInput = {
-  /** 要写入的 shell session ID。 */
-  shell_id: string;
-  /** 要发送到 stdin 的字符内容。 */
-  chars: string;
-};
-
-/**
- * 等待 shell 新输出的输入。
- */
-export type ShellWaitInput = {
-  /** 要等待的 shell session ID。 */
-  shell_id: string;
-  /** 从哪个版本号之后开始等待变更。 */
-  after_version?: number;
-  /** 从哪个输出游标开始读取。 */
-  from_cursor?: number;
-  /** 最长等待时间。 */
-  timeout_ms?: number;
-  /** 最多返回多少输出 token。 */
-  max_output_tokens?: number;
-};
-
-/**
- * 关闭 shell session 的输入。
- */
-export type ShellCloseInput = {
-  /** 要关闭的 shell session ID。 */
-  shell_id: string;
-  /** 是否强制结束子进程。 */
-  force?: boolean;
-};

package/src/shared/types/SkillCommand.ts

@@ -1,90 +0,0 @@
-/**
- * Skill 命令协议类型。
- *
- * 关键点（中文）
- * - 统一描述 skill list / lookup 相关的 CLI、API 与 plugin action 数据结构。
- * - 这些类型不绑定具体实现模块，避免再次退回到历史 service 目录。
- */
-
-/**
- * skill 摘要信息。
- */
-export type SkillSummary = {
-  /**
-   * skill 稳定标识。
-   */
-  id: string;
-  /**
-   * skill 展示名称。
-   */
-  name: string;
-  /**
-   * skill 简要描述。
-   */
-  description: string;
-  /**
-   * skill 根目录来源类型。
-   *
-   * 说明（中文）
-   * - 例如 user/project/builtin 等来源标识。
-   * - 这里只保留稳定字符串，不在类型层强绑定目录实现细节。
-   */
-  source: string;
-  /**
-   * `SKILL.md` 的绝对路径。
-   */
-  skillMdPath: string;
-  /**
-   * 归一化后的允许工具列表。
-   */
-  allowedTools: string[];
-};
-
-/**
- * skill 列表响应。
- */
-export type SkillListResponse = {
-  /**
-   * 本次列表读取是否成功。
-   */
-  success: true;
-  /**
-   * 当前可发现的 skill 摘要集合。
-   */
-  skills: SkillSummary[];
-};
-
-/**
- * skill lookup 请求。
- */
-export type SkillLookupRequest = {
-  /**
-   * 待读取的 skill 名称或标识。
-   */
-  name: string;
-};
-
-/**
- * skill lookup 响应。
- */
-export type SkillLookupResponse = {
-  /**
-   * lookup 是否成功。
-   */
-  success: boolean;
-  /**
-   * 命中的 skill 摘要。
-   */
-  skill?: SkillSummary;
-  /**
-   * `SKILL.md` 正文内容。
-   *
-   * 说明（中文）
-   * - 仅在命中 skill 且成功读取文件时返回。
-   */
-  content?: string;
-  /**
-   * 失败时的错误信息。
-   */
-  error?: string;
-};

package/src/shared/types/SkillPlugin.ts

@@ -1,107 +0,0 @@
-/**
- * Skill Plugin 协议类型。
- *
- * 关键点（中文）
- * - skill 已迁到 plugin 体系，因此把对外 action 名称与 payload 类型统一放到 `types/`。
- * - 该文件只描述插件动作协议，不承载发现、安装或 system 组装逻辑。
- */
-
-/**
- * skill plugin action 名称常量。
- */
-export const SKILL_PLUGIN_ACTIONS = {
-  /**
-   * 查找 skill。
-   */
-  find: "find",
-  /**
-   * 安装 skill。
-   */
-  install: "install",
-  /**
-   * 列出当前可发现的 skill。
-   */
-  list: "list",
-  /**
-   * 读取 skill 正文。
-   */
-  lookup: "lookup",
-} as const;
-
-/**
- * skill 查找输入。
- */
-export type SkillPluginFindPayload = {
-  /**
-   * 用户输入的 skill 查询词。
-   */
-  query: string;
-};
-
-/**
- * skill 安装输入。
- */
-export type SkillPluginInstallPayload = {
-  /**
-   * skill 安装 spec。
-   */
-  spec: string;
-  /**
-   * 是否全局安装。
-   */
-  global?: boolean;
-  /**
-   * 是否跳过确认。
-   */
-  yes?: boolean;
-  /**
-   * 安装目标 agent 名称。
-   */
-  agent?: string;
-};
-
-/**
- * skill 读取输入。
- */
-export type SkillPluginLookupPayload = {
-  /**
-   * 待读取的 skill 名称或 id。
-   */
-  name: string;
-};
-
-/**
- * skill plugin 配置。
- */
-export interface SkillPluginConfig {
-  /**
-   * 额外的 skill 扫描根目录。
-   *
-   * 说明（中文）
-   * - 相对路径基于项目根目录解析。
-   * - 典型值：`.agents/skills`、`.my/skills`。
-   */
-  paths?: string[];
-  /**
-   * 是否允许扫描项目根目录之外的外部路径。
-   *
-   * 说明（中文）
-   * - 仅影响 `paths` 中落在项目外部的目录。
-   * - 用户目录 `~/.agents/skills` 不受此字段限制。
-   */
-  allowExternalPaths?: boolean;
-}
-
-/**
- * 归一化后的 skill plugin 配置。
- */
-export interface ResolvedSkillPluginConfig {
-  /**
-   * 最终生效的额外 skill 扫描根目录。
-   */
-  paths: string[];
-  /**
-   * 最终生效的外部路径扫描开关。
-   */
-  allowExternalPaths: boolean;
-}

package/src/shared/types/SkillRoot.ts

@@ -1,49 +0,0 @@
-/**
- * Skill root 类型定义。
- *
- * 关键点（中文）
- * - 描述 skill 扫描根路径及其来源优先级。
- * - 该类型只表达结构，不耦合任何扫描实现。
- */
-
-/**
- * skill 根目录来源类型。
- */
-export type SkillRootSource = "project" | "home" | "config";
-
-/**
- * skill 扫描根目录。
- */
-export interface SkillRoot {
-  /**
-   * 根目录来源类型。
-   */
-  source: SkillRootSource;
-  /**
-   * 原始配置值。
-   *
-   * 说明（中文）
-   * - 可能是相对路径、绝对路径或带 `~` 的用户目录表达式。
-   */
-  raw: string;
-  /**
-   * 归一化后的绝对路径。
-   */
-  resolved: string;
-  /**
-   * 面向用户展示的路径文本。
-   */
-  display: string;
-  /**
-   * 扫描优先级。
-   *
-   * 说明（中文）
-   * - 数值越小优先级越高。
-   * - 同名 skill 解析时按该字段决定覆盖顺序。
-   */
-  priority: number;
-  /**
-   * 在禁用外部路径扫描时，是否仍然可信可读。
-   */
-  trustedWhenExternalDisabled: boolean;
-}

package/src/shared/types/Start.ts

@@ -1,16 +0,0 @@
-/**
- * run/start/restart 命令参数类型。
- *
- * 字段说明（中文）
- * - `port`/`host`：主 API 服务监听地址。
- *   - `agent start/restart` 中的 `port` 由 console 自动分配（CLI 不再暴露 `--port`）。
- * - `daemon`：兼容旧参数（显式声明后台/前台）。
- * - `foreground`：显式前台启动。
- */
-
-export interface StartOptions {
-  port?: number | string;
-  host?: string;
-  daemon?: boolean | string;
-  foreground?: boolean | string;
-}