@downcity/agent 1.1.287 → 1.1.310

package/src/types/plugin/PluginSetup.ts

@@ -1,138 +0,0 @@
-/**
- * Plugin setup / usage UI 协议类型。
- *
- * 关键点（中文）
- * - setup 面向安装与配置。
- * - usage 面向 agent 使用 plugin 时的行为参数。
- */
-
-/**
- * Plugin setup 字段选项。
- */
-export interface PluginSetupFieldOption {
-  /** 选项展示标签。 */
-  label: string;
-  /** 选项实际值。 */
-  value: string;
-  /** 选项补充说明（可选）。 */
-  hint?: string;
-}
-
-/**
- * Plugin setup 字段定义。
- */
-export interface PluginSetupField {
-  /** 字段稳定键。 */
-  key: string;
-  /** 字段展示标签。 */
-  label: string;
-  /**
-   * 字段类型。
-   *
-   * 说明（中文）
-   * - 当前阶段只允许 `select` 与 `checkbox`，避免退回到大量自由输入。
-   */
-  type: "select" | "checkbox";
-  /** 是否必填。 */
-  required?: boolean;
-  /** 静态选项列表（可选）。 */
-  options?: PluginSetupFieldOption[];
-  /**
-   * 动态选项来源 action（可选）。
-   *
-   * 说明（中文）
-   * - 若存在，则 Console 打开 setup 弹窗时会先调用该 action 拉取下拉选项。
-   */
-  sourceAction?: string;
-}
-
-/**
- * Plugin setup 定义。
- */
-export interface PluginSetupDefinition {
-  /**
-   * setup 模式。
-   *
-   * 说明（中文）
-   * - `install`：只执行依赖安装。
-   * - `configure`：只写入配置。
-   * - `install-configure`：安装与配置一体化。
-   */
-  mode: "install" | "configure" | "install-configure";
-  /** setup 面板标题。 */
-  title: string;
-  /** setup 面板说明（可选）。 */
-  description?: string;
-  /** setup 字段列表。 */
-  fields: PluginSetupField[];
-  /** 主动作 action 名称。 */
-  primaryAction: string;
-  /** 状态同步 action 名称（可选）。 */
-  statusAction?: string;
-}
-
-/**
- * Plugin usage 字段选项。
- */
-export interface PluginUsageFieldOption {
-  /** 选项展示标签。 */
-  label: string;
-  /** 选项实际值。 */
-  value: string;
-  /** 选项补充说明（可选）。 */
-  description?: string;
-}
-
-/**
- * Plugin usage 字段定义。
- */
-export interface PluginUsageField {
-  /** 字段稳定键。 */
-  key: string;
-  /** 字段展示标签。 */
-  label: string;
-  /**
-   * 字段类型。
-   *
-   * 说明（中文）
-   * - `usage` 面向 agent 如何使用 plugin，因此允许更丰富的配置类型。
-   */
-  type: "string" | "secret" | "boolean" | "select" | "number";
-  /** 字段占位文案（可选）。 */
-  placeholder?: string;
-  /** 字段说明（可选）。 */
-  description?: string;
-  /** 是否必填。 */
-  required?: boolean;
-  /** 字段是否禁用。 */
-  disabled?: boolean;
-  /** 布尔字段为 true 时的标签（可选）。 */
-  trueLabel?: string;
-  /** 布尔字段为 false 时的标签（可选）。 */
-  falseLabel?: string;
-  /** 静态选项列表（可选）。 */
-  options?: PluginUsageFieldOption[];
-  /**
-   * 动态选项来源 action（可选）。
-   *
-   * 说明（中文）
-   * - Console 打开 usage 面板时会先调用该 action 同步下拉选项。
-   */
-  sourceAction?: string;
-}
-
-/**
- * Plugin usage 定义。
- */
-export interface PluginUsageDefinition {
-  /** usage 面板标题。 */
-  title: string;
-  /** usage 面板说明（可选）。 */
-  description?: string;
-  /** agent 使用该 plugin 时可配置的字段列表。 */
-  fields: PluginUsageField[];
-  /** 保存 usage 配置时调用的 action。 */
-  saveAction: string;
-  /** 读取当前 usage 快照时调用的 action（可选）。 */
-  statusAction?: string;
-}

package/src/types/plugin/PluginToolRuntime.ts

@@ -1,98 +0,0 @@
-/**
- * Plugin tool runtime 绑定类型。
- *
- * 关键点（中文）
- * - plugin_call / plugin_read 必须绑定当前 Agent 自己的 plugin registry。
- * - 这些类型描述 tool 工厂与 bridge 调用时需要的显式 runtime 依赖。
- */
-
-import type { Tool } from "ai";
-import type { AgentPlugins } from "@/types/plugin/PluginRuntime.js";
-import type {
-  PluginCallInput,
-  PluginReadInput,
-} from "@/executor/tools/plugin/types/PluginTool.js";
-import type { SessionRunContext } from "@/types/executor/SessionRunContext.js";
-
-/**
- * 创建 plugin tools 的参数。
- */
-export interface CreatePluginToolsOptions {
-  /**
-   * 当前 Agent 自己的 plugin 调用面。
-   *
-   * 关键点（中文）
-   * - 该引用必须来自当前 Agent 装配出的 plugin registry。
-   * - tool 执行时只能通过它访问 plugin，避免跨 Agent 读到其他 registry。
-   */
-  plugins: AgentPlugins;
-}
-
-/**
- * 当前 Agent 专属 plugin tools。
- */
-export interface AgentPluginTools {
-  /**
-   * 读取 plugin metadata 的模型工具。
-   *
-   * 关键点（中文）
-   * - 该 tool 通过闭包绑定当前 Agent 的 `plugins`。
-   * - 不读取任何模块级全局 runtime。
-   */
-  plugin_read: Tool;
-
-  /**
-   * 执行 plugin action 的模型工具。
-   *
-   * 关键点（中文）
-   * - 该 tool 通过闭包绑定当前 Agent 的 `plugins`。
-   * - 多 Agent 并发时，每个 Agent 都有自己的 tool 实例。
-   */
-  plugin_call: Tool;
-}
-
-/**
- * 调用 plugin_call bridge 的参数。
- */
-export interface InvokePluginCallToolOptions {
-  /**
-   * 当前 Agent 自己的 plugin 调用面。
-   *
-   * 关键点（中文）
-   * - 由 Agent 级 tool 工厂注入。
-   * - 不能在 bridge 内通过全局变量读取。
-   */
-  plugins: AgentPlugins;
-
-  /**
-   * 当前 tool 调用所属的 Session run 上下文。
-   *
-   * 关键点（中文）
-   * - 由 Executor 在每个 step 显式绑定。
-   * - 用于选择当前 plugin lease、资源目录与 assistant file 队列。
-   */
-  run_context: SessionRunContext;
-
-  /**
-   * 模型提交给 plugin_call 的结构化输入。
-   */
-  input: PluginCallInput;
-}
-
-/**
- * 调用 plugin_read bridge 的参数。
- */
-export interface InvokePluginReadToolOptions {
-  /**
-   * 当前 Agent 自己的 plugin 调用面。
-   */
-  plugins: AgentPlugins;
-
-  /** 当前 tool 调用所属的 Session run 上下文。 */
-  run_context: SessionRunContext;
-
-  /**
-   * 模型提交给 plugin_read 的结构化输入。
-   */
-  input: PluginReadInput;
-}

package/src/types/runtime/auth/AuthPermission.ts

@@ -1,120 +0,0 @@
-/**
- * 统一账户权限目录定义。
- *
- * 关键点（中文）
- * - V1 使用稳定的字符串权限 key，避免把权限判断散落在业务代码里。
- * - 默认角色与权限关系也在这里收口，方便 bootstrap 时统一 seed。
- */
-
-/**
- * V1 支持的权限 key 列表。
- */
-export const AUTH_PERMISSION_KEYS = [
-  "agent.read",
-  "agent.write",
-  "agent.execute",
-  "task.read",
-  "task.run",
-  "model.read",
-  "model.write",
-  "env.read",
-  "env.write",
-  "channel.read",
-  "channel.write",
-  "auth.read",
-  "auth.write",
-  "shell.execute",
-  "session.read",
-  "session.write",
-  "plugin.read",
-  "plugin.write",
-] as const;
-
-/**
- * 权限 key 联合类型。
- */
-export type AuthPermissionKey = (typeof AUTH_PERMISSION_KEYS)[number];
-
-/**
- * 权限说明映射。
- */
-export const AUTH_PERMISSION_DESCRIPTIONS: Record<AuthPermissionKey, string> = {
-  "agent.read": "读取 agent 基础信息与运行状态。",
-  "agent.write": "修改 agent 配置与元信息。",
-  "agent.execute": "触发 agent 执行与会话运行。",
-  "task.read": "查看 task 定义与运行结果。",
-  "task.run": "创建或手动执行 task。",
-  "model.read": "查看 City AIService 模型与模型绑定。",
-  "model.write": "修改模型绑定。",
-  "env.read": "查看环境变量配置。",
-  "env.write": "修改环境变量配置。",
-  "channel.read": "查看渠道账号与渠道状态。",
-  "channel.write": "修改渠道账号与渠道配置。",
-  "auth.read": "查看统一账户、角色、权限与 token 状态。",
-  "auth.write": "修改统一账户、角色、权限与 token 状态。",
-  "shell.execute": "执行 shell 指令。",
-  "session.read": "查看 session 与消息。",
-  "session.write": "修改 session 或写入消息。",
-  "plugin.read": "查看 plugin 状态与配置。",
-  "plugin.write": "修改 plugin 配置并执行管理动作。",
-};
-
-/**
- * 默认角色名称。
- */
-export const AUTH_DEFAULT_ROLE_NAMES = ["admin", "operator", "viewer"] as const;
-
-/**
- * 默认角色名称类型。
- */
-export type AuthDefaultRoleName = (typeof AUTH_DEFAULT_ROLE_NAMES)[number];
-
-/**
- * 默认角色定义。
- */
-export interface AuthDefaultRoleDefinition {
-  /**
-   * 角色名。
-   */
-  name: AuthDefaultRoleName;
-  /**
-   * 角色说明。
-   */
-  description: string;
-  /**
-   * 角色拥有的权限集合。
-   */
-  permissions: AuthPermissionKey[];
-}
-
-/**
- * V1 默认角色目录。
- */
-export const AUTH_DEFAULT_ROLES: AuthDefaultRoleDefinition[] = [
-  {
-    name: "admin",
-    description: "System administrator who can manage unified accounts and all control-plane capabilities.",
-    permissions: [...AUTH_PERMISSION_KEYS],
-  },
-  {
-    name: "operator",
-    description: "Operations role that can view and operate the runtime but cannot manage unified accounts.",
-    permissions: AUTH_PERMISSION_KEYS.filter((permission) =>
-      permission !== "auth.write" && permission !== "auth.read"
-    ),
-  },
-  {
-    name: "viewer",
-    description: "Read-only role that can view status but cannot perform high-risk changes.",
-    permissions: [
-      "agent.read",
-      "task.read",
-      "model.read",
-      "env.read",
-      "channel.read",
-      "auth.read",
-      "session.read",
-      "plugin.read",
-    ],
-  },
-];

package/src/types/runtime/auth/AuthRoute.ts

@@ -1,31 +0,0 @@
-/**
- * 统一账户路由策略类型。
- *
- * 关键点（中文）
- * - 当前文件先定义协议，后续路由全面切入 Bearer 鉴权时直接复用。
- */
-
-import type { AuthPermissionKey } from "./AuthPermission.js";
-
-/**
- * 单条路由的鉴权策略。
- */
-export interface AuthRoutePolicy {
-  /**
-   * 路由路径模式。
-   */
-  path: string;
-  /**
-   * HTTP 方法。
-   */
-  method: string;
-  /**
-   * 是否必须登录。
-   */
-  requireAuth: boolean;
-  /**
-   * 通过该路由所需的任一权限集合。
-   */
-  anyPermissions?: AuthPermissionKey[];
-}
-

package/src/types/runtime/auth/AuthToken.ts

@@ -1,47 +0,0 @@
-/**
- * 统一账户 Token 响应类型。
- *
- * 关键点（中文）
- * - 明文 token 只在签发时返回一次。
- * - 列表与详情接口一律只返回摘要，不返回明文。
- */
-
-/**
- * 对外返回的 token 摘要。
- */
-export interface AuthTokenSummary {
-  /**
-   * token 记录 ID。
-   */
-  id: string;
-  /**
-   * token 名称。
-   */
-  name: string;
-  /**
-   * 过期时间（可选）。
-   */
-  expiresAt?: string;
-  /**
-   * 最近使用时间（可选）。
-   */
-  lastUsedAt?: string;
-  /**
-   * 创建时间（ISO 字符串）。
-   */
-  createdAt: string;
-  /**
-   * 更新时间（ISO 字符串）。
-   */
-  updatedAt: string;
-}
-
-/**
- * 新签发 token 的一次性返回结构。
- */
-export interface AuthIssuedToken extends AuthTokenSummary {
-  /**
-   * 明文 Bearer Token。
-   */
-  token: string;
-}

package/src/types/runtime/auth/AuthTypes.ts

@@ -1,235 +0,0 @@
-/**
- * 统一账户领域基础类型。
- *
- * 关键点（中文）
- * - 这些类型描述的是 auth 表记录与运行时 principal，不承载路由细节。
- * - 所有字段都保持可序列化，便于 API 响应与审计日志复用。
- */
-
-import type { AuthPermissionKey } from "./AuthPermission.js";
-
-/**
- * 用户状态。
- */
-export type AuthUserStatus = "active" | "disabled";
-
-/**
- * 用户记录。
- */
-export interface AuthUser {
-  /**
-   * 用户主键 ID。
-   */
-  id: string;
-  /**
-   * 登录用户名。
-   */
-  username: string;
-  /**
-   * 密码哈希值。
-   */
-  passwordHash: string;
-  /**
-   * 展示名称。
-   */
-  displayName?: string;
-  /**
-   * 用户状态。
-   */
-  status: AuthUserStatus;
-  /**
-   * 创建时间（ISO 字符串）。
-   */
-  createdAt: string;
-  /**
-   * 更新时间（ISO 字符串）。
-   */
-  updatedAt: string;
-}
-
-/**
- * 角色记录。
- */
-export interface AuthRole {
-  /**
-   * 角色主键 ID。
-   */
-  id: string;
-  /**
-   * 角色名。
-   */
-  name: string;
-  /**
-   * 角色说明。
-   */
-  description?: string;
-  /**
-   * 创建时间（ISO 字符串）。
-   */
-  createdAt: string;
-  /**
-   * 更新时间（ISO 字符串）。
-   */
-  updatedAt: string;
-}
-
-/**
- * 权限记录。
- */
-export interface AuthPermission {
-  /**
-   * 权限主键 ID。
-   */
-  id: string;
-  /**
-   * 权限 key。
-   */
-  key: AuthPermissionKey;
-  /**
-   * 权限说明。
-   */
-  description?: string;
-  /**
-   * 创建时间（ISO 字符串）。
-   */
-  createdAt: string;
-  /**
-   * 更新时间（ISO 字符串）。
-   */
-  updatedAt: string;
-}
-
-/**
- * Token 记录。
- */
-export interface AuthTokenRecord {
-  /**
-   * token 记录主键 ID。
-   */
-  id: string;
-  /**
-   * 所属用户 ID。
-   */
-  userId: string;
-  /**
-   * token 名称。
-   */
-  name: string;
-  /**
-   * token 哈希值。
-   */
-  tokenHash: string;
-  /**
-   * 过期时间（可选）。
-   */
-  expiresAt?: string;
-  /**
-   * 吊销时间（可选）。
-   */
-  revokedAt?: string;
-  /**
-   * 最近使用时间（可选）。
-   */
-  lastUsedAt?: string;
-  /**
-   * 创建时间（ISO 字符串）。
-   */
-  createdAt: string;
-  /**
-   * 更新时间（ISO 字符串）。
-   */
-  updatedAt: string;
-}
-
-/**
- * 审计日志记录。
- */
-export interface AuthAuditLog {
-  /**
-   * 审计日志主键 ID。
-   */
-  id: string;
-  /**
-   * 操作人用户 ID。
-   */
-  actorUserId?: string;
-  /**
-   * 操作人 token ID。
-   */
-  actorTokenId?: string;
-  /**
-   * 资源类型。
-   */
-  resourceType: string;
-  /**
-   * 资源 ID。
-   */
-  resourceId?: string;
-  /**
-   * 动作名。
-   */
-  action: string;
-  /**
-   * 动作结果。
-   */
-  result: string;
-  /**
-   * 请求 ID。
-   */
-  requestId?: string;
-  /**
-   * 请求 IP。
-   */
-  ip?: string;
-  /**
-   * User-Agent。
-   */
-  userAgent?: string;
-  /**
-   * 附加元数据 JSON 字符串。
-   */
-  metaJson?: string;
-  /**
-   * 创建时间（ISO 字符串）。
-   */
-  createdAt: string;
-}
-
-/**
- * 当前请求的认证主体。
- */
-export interface AuthPrincipal {
-  /**
-   * 当前用户 ID。
-   */
-  userId: string;
-  /**
-   * 当前用户名。
-   */
-  username: string;
-  /**
-   * 当前展示名。
-   */
-  displayName?: string;
-  /**
-   * 当前用户状态。
-   */
-  status: AuthUserStatus;
-  /**
-   * 当前 token 记录 ID。
-   */
-  tokenId: string;
-  /**
-   * 当前 token 名称。
-   */
-  tokenName: string;
-  /**
-   * 当前用户角色列表。
-   */
-  roles: string[];
-  /**
-   * 当前用户权限列表。
-   */
-  permissions: AuthPermissionKey[];
-}
-