@cloudbase/cli 2.11.0-beta.0 → 2.11.0

package/runtime/nodejs/runtime.js

@@ -1,183 +0,0 @@
-/* eslint-disable */
-const fs = require('fs')
-const crypto = require('crypto')
-
-var GLOBAL_FUNCTION_HANDLER = process.argv[2] || process.env.SCF_FUNCTION_HANDLER || 'index.main'
-var GLOBAL_FUNCTION_NAME = process.env.SCF_FUNCTION_NAME || 'main'
-var GLOBAL_EVENT_BODY =
-    process.argv[3] ||
-    process.env.SCF_EVENT_BODY ||
-    (process.env.DOCKER_USE_STDIN && fs.readFileSync('/dev/stdin', 'utf8')) ||
-    '{}'
-
-var GLOBAL_USER_FILE_PATH = process.env.GLOBAL_USER_FILE_PATH || ''
-var GLOBAL_VERSION = process.env.SCF_FUNCTION_VERSION || '$LATEST'
-var GLOBAL_MEM_SIZE = process.env.SCF_FUNCTION_MEMORY_SIZE || '256'
-var GLOBAL_TIMEOUT = process.env.SCF_FUNCTION_TIMEOUT || '3'
-var GLOBAL_ENVIRON = process.env.SCF_FUNCTION_ENVIRON || ''
-var GLOBAL_IS_QUIET = process.env.SCF_DISPLAY_IS_QUIET === 'True' || false
-
-var GLOBAL_REQUEST_ID = uuid()
-var GLOBAL_START_TIME = process.hrtime()
-var GLOBAL_SOCK = -1
-var GLOBAL_STAGE = 0
-
-module.exports = {
-    init: function() {
-        if (!GLOBAL_IS_QUIET) {
-            consoleLog('开始本地执行云函数，受环境影响，执行结果可能与云端存在一定差异！')
-            consoleLog('START RequestId: ' + GLOBAL_REQUEST_ID)
-        }
-        return 0
-    },
-    wait_for_invoke: function() {
-        var invokeInfo = []
-
-        GLOBAL_STAGE += 1
-        switch (GLOBAL_STAGE) {
-            case 1:
-                invokeInfo.cmd = 'RELOAD'
-                invokeInfo.context = GLOBAL_USER_FILE_PATH + GLOBAL_FUNCTION_HANDLER
-                invokeInfo.globalHandler = GLOBAL_FUNCTION_HANDLER
-                invokeInfo.filePath = GLOBAL_USER_FILE_PATH
-                break
-            case 2:
-                invokeInfo.cmd = 'EVENT'
-                invokeInfo.sockfd = GLOBAL_SOCK
-                invokeInfo.event = GLOBAL_EVENT_BODY
-                invokeInfo.context = initContext()
-                break
-            default:
-                process.exit()
-        }
-
-        return invokeInfo
-    },
-    log: function(str) {
-        // consoleLog(formatSystem(str))
-    },
-    console_log: function(str, err = false) {
-        if (!GLOBAL_IS_QUIET) {
-            if (err === false) {
-                consoleLog(formatConsole(str))
-            } else {
-                consoleLogErr(formatConsole(str))
-            }
-        }
-    },
-    report_fail: function(stackTrace, errNum, errType = 0) {
-        const result = {}
-
-        result['errorCode'] = 1
-        result['errorMessage'] = 'user code exception caught'
-        if (stackTrace) {
-            result['stackTrace'] = stackTrace
-        }
-
-        reportDone('', (errType = 1))
-        // console.dir(result);
-        consoleLogErr(JSON.stringify(result))
-    },
-    report_running: function() {
-        GLOBAL_START_TIME = process.hrtime()
-    },
-    report_done: function(resultStr, errType = 0) {
-        reportDone(resultStr, errType)
-    }
-}
-
-function initContext() {
-    var context = {}
-    context['function_version'] = GLOBAL_VERSION
-    context['function_name'] = GLOBAL_FUNCTION_NAME
-
-    context['time_limit_in_ms'] = GLOBAL_TIMEOUT
-    context['memory_limit_in_mb'] = GLOBAL_MEM_SIZE
-
-    context['request_id'] = GLOBAL_REQUEST_ID
-    context['environ'] = GLOBAL_ENVIRON
-
-    return JSON.stringify(context)
-}
-
-function reportDone(resultStr, errType = 0) {
-    if (GLOBAL_IS_QUIET) {
-        if (typeof resultStr === 'string') {
-            if (errType === 0) consoleLog(resultStr)
-            else consoleLogErr(resultStr)
-        }
-        return
-    }
-
-    var diffMs = hrTimeMs(process.hrtime(GLOBAL_START_TIME))
-    var billedMs = Math.min(100 * (Math.floor(diffMs / 100) + 1), GLOBAL_TIMEOUT * 1000)
-    if (errType === 0) {
-        consoleLog('END RequestId: ' + GLOBAL_REQUEST_ID)
-        consoleLog(
-            [
-                '运行信息：',
-                'REPORT RequestId: ' + GLOBAL_REQUEST_ID,
-                'Duration: ' + diffMs.toFixed(2) + ' ms',
-                'Billed Duration: ' + billedMs + ' ms',
-                'Memory Size: ' + GLOBAL_MEM_SIZE + ' MB',
-                'Max Memory Used: ' + Math.round(process.memoryUsage().rss / (1024 * 1024)) + ' MB'
-            ].join('\n')
-        )
-    } else {
-        consoleLogErr(
-            [
-                '运行信息：',
-                'REPORT RequestId: ' + GLOBAL_REQUEST_ID,
-                'Duration: ' + diffMs.toFixed(2) + ' ms',
-                'Billed Duration: ' + billedMs + ' ms',
-                'Memory Size: ' + GLOBAL_MEM_SIZE + ' MB',
-                'Max Memory Used: ' + Math.round(process.memoryUsage().rss / (1024 * 1024)) + ' MB'
-            ].join('\n')
-        )
-    }
-
-    if (typeof resultStr === 'string') {
-        if (errType === 0) {
-            consoleLog('返回结果：\n' + resultStr)
-        } else {
-            consoleLogErr('返回结果：\n' + resultStr)
-        }
-    }
-}
-
-function consoleLog(str) {
-    process.stdout.write(str + '\n')
-}
-
-function consoleLogErr(str) {
-    process.stderr.write(str + '\n')
-}
-
-function formatConsole(str) {
-    return str.replace(/^[0-9TZ:.-]+\t[0-9a-f-]+\t/, '\u001b[34m$&\u001b[0m')
-}
-
-function formatSystem(str) {
-    return '\u001b[32m' + str + '\u001b[0m'
-}
-
-function hrTimeMs(hrtime) {
-    return (hrtime[0] * 1e9 + hrtime[1]) / 1e6
-}
-
-function uuid() {
-    return (
-        crypto.randomBytes(4).toString('hex') +
-        '-' +
-        crypto.randomBytes(2).toString('hex') +
-        '-' +
-        crypto
-            .randomBytes(2)
-            .toString('hex')
-            .replace(/^./, '1') +
-        '-' +
-        crypto.randomBytes(2).toString('hex') +
-        '-' +
-        crypto.randomBytes(6).toString('hex')
-    )
-}

package/specs/ag-command/design.md

@@ -1,421 +0,0 @@
-# AG 命令设计方案
-
-## 1. 整体架构
-
-基于 doc.md 的设计要求，ag 命令将作为 CloudBase CLI 的一个子模块，用于管理新版 Agent（基于 Web 云函数的 Serverless 服务类型 Agent）。
-
-### 1.1 命令结构
-
-```
-tcb ag <subcommand> [agentId] [options]
-```
-
-### 1.2 子命令列表
-
-| 子命令 | 功能 | 参数 |
-|--------|------|------|
-| `create` | 初始化 Agent 项目 | `agentId` |
-| `deploy` | 部署 Agent | `agentId` |
-| `run` | 本地运行 Agent | `agentId` |
-| `web` | 本地运行 Agent Web 应用 | `agentId` |
-| `invoke` | 请求云端 Agent | `agentId` |
-| `list` | 查询 Agent 列表 | - |
-| `detail` | 查看 Agent 详情 | `agentId` |
-| `delete` | 删除 Agent | `[agentId]` |
-| `download` | 下载 Agent 代码 | `agentId` |
-| `resource` | 资源管理 | - |
-
-## 2. 配置文件设计
-
-### 2.1 cloudbaserc.json 扩展
-
-```json
-{
-  "envId": "dev-xxxx",
-  "agents": [
-    {
-      "id": "ag-xxx",
-      "name": "app",
-      "timeout": 5,
-      "environment": {
-        "key": "value"
-      },
-      "runtime": "Nodejs18.15",
-      "memorySize": 10,
-      "description": "",
-      "sessionConfig": {
-        "enable": true
-      },
-      "resources": [
-        {
-          "ResourceId": "",
-          "ResourceType": "",
-          "ResourceConfig": {
-            "Type": "",
-            "ApiKey": ""
-          }
-        }
-      ]
-    }
-  ]
-}
-```
-
-### 2.2 TypeScript 类型定义
-
-```typescript
-interface AgentConfig {
-  id: string;
-  name: string;
-  timeout?: number;
-  environment?: Record<string, string>;
-  runtime?: string;
-  memorySize?: number;
-  description?: string;
-  sessionConfig?: {
-    enable: boolean;
-  };
-  resources?: Array<{
-    ResourceId: string;
-    ResourceType: string;
-    ResourceConfig: {
-      Type: string;
-      ApiKey: string;
-    };
-  }>;
-}
-
-interface CloudbaseConfig {
-  envId: string;
-  agents?: AgentConfig[];
-}
-```
-
-## 3. 命令实现设计
-
-### 3.1 基础服务类
-
-参考 cloudrun 模块的 `getCloudrunService` 实现，创建 `getAgentService`：
-
-```typescript
-export async function getAgentService(envId: string) {
-    const region = await getRegion()
-    const { secretId, secretKey, token } = await checkAndGetCredential(true)
-
-    const app = new CloudBase({
-        region,
-        token,
-        envId,
-        secretId,
-        secretKey,
-        proxy: getProxy()
-    })
-    return app.agent
-}
-```
-
-### 3.2 命令类设计
-
-每个子命令对应一个 Command 类，使用装饰器模式：
-
-```typescript
-@ICommand()
-export class AgentCreateCommand extends Command {
-    get options() {
-        return {
-            cmd: 'ag',
-            childCmd: 'create <agentId>',
-            options: [
-                {
-                    flags: '-e, --envId <envId>',
-                    desc: t('环境 ID')
-                },
-                {
-                    flags: '--template <template>',
-                    desc: t('模板名称')
-                },
-                {
-                    flags: '--targetPath <targetPath>',
-                    desc: t('项目初始化目标路径')
-                }
-            ],
-            requiredEnvId: false,
-            autoRunLogin: true,
-            desc: t('初始化 Agent 项目')
-        }
-    }
-
-    @InjectParams()
-    async execute(
-        @CmdContext() ctx: any,
-        @EnvId() envId: string,
-        @Log() log: Logger,
-        @ArgsParams() params: string[],
-        @ArgsOptions() options: {
-            template?: string;
-            targetPath?: string;
-        }
-    ) {
-        // 实现逻辑
-    }
-}
-```
-
-## 4. 详细功能设计
-
-### 4.1 ag create - 初始化 Agent 项目
-
-**功能**：创建新的 Agent 项目结构
-
-**参数**：
-- `agentId`：Agent 标识符（必需）
-- `--template`：模板名称（可选）
-- `--targetPath`：目标路径（可选，默认当前目录）
-
-**实现逻辑**：
-1. 验证 agentId 格式
-2. 选择或指定模板
-3. 下载模板到指定目录
-4. 更新 cloudbaserc.json 配置
-5. 初始化项目依赖
-
-### 4.2 ag deploy - 部署 Agent
-
-**功能**：部署 Agent 到云端
-
-**参数**：
-- `agentId`：Agent 标识符（必需）
-- `--mode`：部署模式（webFn | cloudrun，默认 webFn）
-- `--force`：强制部署（可选）
-
-**实现逻辑**：
-1. 读取配置文件
-2. 检查 Agent 是否存在（首次部署 vs 更新部署）
-3. 打包代码
-4. 调用相应的部署接口
-5. 更新配置信息
-
-### 4.3 ag run - 本地运行 Agent
-
-**功能**：本地调试运行 Agent
-
-**参数**：
-- `agentId`：Agent 标识符（必需）
-- `--extendedContext`：扩展上下文（可选）
-- `--port`：端口号（可选，默认 3000）
-
-**实现逻辑**：
-1. 读取 Agent 配置
-2. 设置本地环境变量
-3. 启动本地服务
-4. 打开调试界面
-
-### 4.4 ag web - 本地运行 Agent Web 应用
-
-**功能**：启动 Agent Web 服务
-
-**参数**：
-- `agentId`：Agent 标识符（必需）
-- `--port`：端口号（可选，默认 8080）
-
-**实现逻辑**：
-1. 读取 Agent 配置
-2. 启动 Web 服务器
-3. 提供访问地址
-
-### 4.5 ag invoke - 请求云端 Agent
-
-**功能**：调用云端 Agent 服务
-
-**参数**：
-- `agentId`：Agent 标识符（必需）
-- `-d, --data`：请求数据 JSON
-- `-h, --headers`：请求头 JSON
-
-**实现逻辑**：
-1. 构建请求参数
-2. 发送 HTTP 请求到 Agent 服务
-3. 输出响应结果
-
-### 4.6 ag list - 查询 Agent 列表
-
-**功能**：列出环境中的所有 Agent
-
-**参数**：
-- `-l, --limit`：数据长度（可选）
-- `-o, --offset`：偏移量（可选）
-
-**实现逻辑**：
-1. 调用列表接口
-2. 格式化输出表格
-3. 显示 Agent 基本信息
-
-### 4.7 ag detail - 查看 Agent 详情
-
-**功能**：查看指定 Agent 的详细信息
-
-**参数**：
-- `agentId`：Agent 标识符（必需）
-
-**实现逻辑**：
-1. 调用详情接口
-2. 查询绑定的资源信息
-3. 格式化输出详细信息
-
-### 4.8 ag delete - 删除 Agent
-
-**功能**：删除指定的 Agent 或所有 Agent
-
-**参数**：
-- `[agentId]`：Agent 标识符（可选，不指定则删除所有）
-- `--force`：强制删除（可选）
-
-**实现逻辑**：
-1. 确认删除操作
-2. 调用删除接口
-3. 更新本地配置文件
-
-### 4.9 ag download - 下载 Agent 代码
-
-**功能**：下载云端 Agent 代码到本地
-
-**参数**：
-- `agentId`：Agent 标识符（必需）
-- `--destPath`：目标目录（可选）
-- `--force`：强制覆盖（可选）
-
-**实现逻辑**：
-1. 选择目标目录
-2. 检查覆盖确认
-3. 下载代码文件
-4. 更新本地配置
-
-### 4.10 ag resource - 资源管理
-
-**子命令**：
-- `ag resource bind`：绑定资源
-- `ag resource unbind`：解绑资源
-- `ag resource detail`：查询绑定资源
-
-**实现逻辑**：
-1. 根据子命令调用相应接口
-2. 处理资源绑定关系
-3. 更新配置信息
-
-## 5. 错误处理设计
-
-### 5.1 通用错误处理
-
-```typescript
-export class AgentError extends CloudBaseError {
-    constructor(message: string, code?: string) {
-        super(message, code)
-        this.name = 'AgentError'
-    }
-}
-```
-
-### 5.2 错误类型
-
-- 配置文件错误
-- Agent 不存在错误
-- 部署失败错误
-- 网络请求错误
-- 权限不足错误
-
-## 6. 工具函数设计
-
-### 6.1 配置文件操作
-
-```typescript
-// 读取 Agent 配置
-export async function getAgentConfig(agentId: string): Promise<AgentConfig>
-
-// 更新 Agent 配置
-export async function updateAgentConfig(agentId: string, config: Partial<AgentConfig>): Promise<void>
-
-// 验证 Agent ID 格式
-export function validateAgentId(agentId: string): boolean
-```
-
-### 6.2 交互式输入
-
-```typescript
-// 选择 Agent
-export async function selectAgent(agents: AgentConfig[]): Promise<string>
-
-// 输入 Agent 名称
-export async function inputAgentName(defaultName?: string): Promise<string>
-
-// 确认操作
-export async function confirmOperation(message: string): Promise<boolean>
-```
-
-## 7. 测试策略
-
-### 7.1 单元测试
-
-- 配置文件操作测试
-- 工具函数测试
-- 错误处理测试
-
-### 7.2 集成测试
-
-- 命令执行流程测试
-- API 接口调用测试
-- 文件操作测试
-
-### 7.3 端到端测试
-
-- 完整的 Agent 生命周期测试
-- 多环境部署测试
-- 错误场景测试
-
-## 8. 国际化支持
-
-所有用户可见的文本都需要支持国际化，使用 `t()` 函数包装：
-
-```typescript
-desc: t('初始化 Agent 项目')
-message: t('请输入 Agent 名称')
-```
-
-## 9. 日志和监控
-
-### 9.1 操作日志
-
-- 记录关键操作步骤
-- 记录错误信息和堆栈
-- 记录性能指标
-
-### 9.2 用户反馈
-
-- 操作进度提示
-- 成功/失败状态反馈
-- 帮助信息和建议
-
-## 10. 兼容性考虑
-
-### 10.1 向后兼容
-
-- 支持旧版配置文件格式
-- 提供迁移工具和指导
-
-### 10.2 平台兼容
-
-- 支持 Windows、macOS、Linux
-- 支持不同 Node.js 版本
-
-## 11. 安全性设计
-
-### 11.1 凭证管理
-
-- 安全存储访问凭证
-- 支持临时凭证
-- 避免凭证泄露
-
-### 11.2 代码保护
-
-- 支持代码加密
-- 安全的代码传输
-- 访问权限控制