{"owner":"coze-dev","repo":"coze-loop","hasSkills":true,"totalSkillsCount":41,"totalTokensCount":21721,"categories":["root-instruction","plugin-manifest"],"hasMcp":false,"mcpConfig":null,"found":["AGENTS.md","docs/AGENTS.md","frontend/infra/plugins/pkg-root-webpack-plugin/README.md","frontend/infra/plugins/postcss-plugin/README.md","frontend/packages/loop-base/account/README.md","frontend/packages/loop-base/api-schema/README.md","frontend/packages/loop-base/base-hooks/README.md","frontend/packages/loop-base/bot-env-adapter/README.md","frontend/packages/loop-base/bot-env/README.md","frontend/packages/loop-base/bot-flags/README.md","frontend/packages/loop-base/bot-md-box-adapter/README.md","frontend/packages/loop-base/bot-typings/README.md","frontend/packages/loop-base/components/README.md","frontend/packages/loop-base/env/README.md","frontend/packages/loop-base/fetch-stream/README.md","frontend/packages/loop-base/guard/README.md","frontend/packages/loop-base/intl/README.md","frontend/packages/loop-base/logger/README.md","frontend/packages/loop-base/loop-lng/README.md","frontend/packages/loop-base/route/README.md","frontend/packages/loop-base/stores/README.md","frontend/packages/loop-base/tea/README.md","frontend/packages/loop-base/toolkit/README.md","frontend/packages/loop-components/adapter-interfaces/README.md","frontend/packages/loop-components/biz-components/README.md","frontend/packages/loop-components/biz-config/README.md","frontend/packages/loop-components/biz-hooks/README.md","frontend/packages/loop-components/components-with-adapter/README.md","frontend/packages/loop-components/evaluate-components/README.md","frontend/packages/loop-components/prompt-components-v2/README.md","frontend/packages/loop-components/prompt-components/README.md","frontend/packages/loop-components/tag-components/README.md","frontend/packages/loop-config/rsbuild-config/README.md","frontend/packages/loop-config/tailwind-config/README.md","frontend/packages/loop-config/tailwind-plugin/README.md","frontend/packages/loop-modules/evaluate/README.md","frontend/packages/loop-pages/auth-pages/README.md","frontend/packages/loop-pages/evaluate-pages/README.md","frontend/packages/loop-pages/observation-pages/README.md","frontend/packages/loop-pages/prompt-pages/README.md","frontend/packages/loop-pages/tag-pages/README.md"],"skills":{"AGENTS.md":"# AGENTS.md\n\nThis file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.\n\n> 开始任务前先通读本文件；涉及架构决策时读 `ARCHITECTURE.md`；进入具体模块时读模块代码。\n\n## 项目概要\n\nCoze Loop 是一个开源的 LLM 评测与可观测性平台，提供 Prompt 开发调试、评测（评测集 + 评估器 + 实验）、可观测性（Trace/Span）、模型集成（OpenAI / Volcengine Ark）等能力。采用 Go 后端（DDD 6 模块，Hertz + Kitex）+ TypeScript/React 前端（Rush.js 59 包）的多语言单体仓库架构，Thrift IDL 共享契约。\n\n## 文档体系\n\n| 层级 | 文件 | 职责 |\n|------|------|------|\n| L0 入口 | `AGENTS.md`（本文件） | 项目全貌、核心约束、导航 |\n| L1 架构 | `ARCHITECTURE.md` | 系统架构、代码地图、依赖关系、不变量 |\n| L1 专题 | `docs/AGENTS.md` | 中层索引，串联 reference/ 和 guidance/ |\n| L3 参考 | `docs/reference/backend-modules-api.md` | 后端 6 模块职责、分层、API 路由 |\n| L3 参考 | `docs/reference/frontend-packages.md` | 前端 59 包分层结构 |\n| L3 指南 | `docs/guidance/deployment-guide.md` | Docker Compose / Helm 部署 |\n| L3 指南 | `docs/guidance/idl-codegen-guide.md` | IDL 变更后代码生成流程 |\n\n## 导航表\n\n| 我想… | 去哪里 |\n|-------|--------|\n| 了解仓库整体架构和模块关系 | `ARCHITECTURE.md` |\n| 查找 docs 下的专题文档 | `docs/AGENTS.md` |\n| 了解后端 6 个 DDD 模块的职责和 API | `docs/reference/backend-modules-api.md` |\n| 了解前端 59 包的分层结构 | `docs/reference/frontend-packages.md` |\n| 部署 Coze Loop（Docker / Helm） | `docs/guidance/deployment-guide.md` |\n| 修改 IDL 后生成代码 | `docs/guidance/idl-codegen-guide.md` |\n| 修改数据库表结构 | 本文件「开发流程」→ Step 3-4 |\n| 添加新的 API 接口 | 本文件「开发流程」→ Step 1-2 → Step 6 |\n| 运行本地开发环境 | `make compose-up-dev` |\n| 了解错误码定义规范 | 本文件「开发流程」→ Step 7 |\n| 执行 lint 检查 | `cd backend && golangci-lint run --config ../.github/.golangci.yaml --fix` |\n\n## 仓库结构\n\n```\ncoze-loop/\n├── idl/thrift/coze/loop/ # Thrift IDL（前后端共享契约，同步源）\n│ ├── /domain/ # 开源领域实体\n│ ├── /domain_openapi/# OpenAPI 领域实体\n│ └── /coze.loop.*.thrift # 服务接口\n├── backend/\n│ ├── cmd/ # 服务入口（main.go HTTP, consumer.go MQ）\n│ ├── api/ # Hertz 网关层（生成 + handler）\n│ ├── modules/ # 6 个 DDD 业务模块\n│ │ ├── evaluation/ # 评测（实验 / 评估器 / 评测集）\n│ │ ├── observability/ # 可观测性（Trace / Span）\n│ │ ├── prompt/ # Prompt 管理\n│ │ ├── data/ # 数据管理（Dataset）\n│ │ ├── llm/ # LLM 模型集成\n│ │ └── foundation/ # 基础（用户 / 空间 / API Key）\n│ ├── infra/ # 共享基础设施（DB, Redis, ClickHouse, MQ, middleware）\n│ ├── pkg/ # 共享工具库\n│ ├── kitex_gen/ # Kitex 生成代码 ⚠️ 禁止手动修改\n│ ├── loop_gen/ # Loop 生成代码 ⚠️ 禁止手动修改\n│ └── script/ # 代码生成脚本\n│ ├── cloudwego/code_gen.sh # IDL → Go\n│ ├── gorm_gen/generate.go # SQL → GORM Model\n│ └── errorx/code_gen.py # 错误码生成\n├── frontend/ # Rush.js 前端 monorepo（59 包）\n│ ├── apps/cozeloop/ # 主 SPA（React 18, Rsbuild, react-router, zustand）\n│ ├── packages/ # loop-pages, loop-modules, loop-components, loop-base\n│ ├── config/ # eslint-config, ts-config, vitest-config 等\n│ └── infra/ # IDL 转 TypeScript 工具等\n├── release/deployment/\n│ ├── docker-compose/ # Docker 部署（conf/ + bootstrap/）\n│ └── helm-chart/ # Kubernetes 部署\n└── common/ # git-hooks（Rush 管理）\n```\n\n## 核心约束\n\n### 1. DDD 分层纪律\n\n每个 `backend/modules//` 遵循三层架构，依赖方向单向：\n\n```\napi/ → application/ → domain/ ← infra/\n```\n\n- **domain/** 定义接口，**infra/** 实现接口，domain **绝不**引用 infra\n- Application 层负责 DTO↔DO 转换、用例编排\n- Repository 的事务只在 infra 层启动\n\n### 2. IDL 优先\n\n`idl/thrift/` 是接口契约的同步源。商业化 IDL 仓库的 `open/` 目录从此处同步。修改 IDL 后必须运行代码生成。\n\n### 3. 生成代码不可手动修改\n\n- `backend/kitex_gen/` — Kitex 生成\n- `backend/loop_gen/` — Loop 本地调用生成\n- `backend/api/router_gen.go` — Hertz 路由生成\n- `**/wire_gen.go` — Wire DI 生成\n- `**/gorm_gen/**` — GORM 模型生成\n\n### 4. 向前兼容\n\n已有企业用户二开部署。IDL API / Domain 核心接口 / 配置文件 / 存储 Schema 均要求向前兼容。新增字段必须 optional，数据库只允许加列。\n\n### 5. SQL 双路径同步\n\n修改数据库表时，以下两个目录必须保持一致：\n- `release/deployment/docker-compose/bootstrap/mysql-init/`（Docker）\n- `release/deployment/helm-chart/charts/app/bootstrap/init/mysql/init-sql/`（Helm）\n\n修改表还需要在 `patch-sql/` 写 ALTER 语句。CI 会通过 `mysql-schema-check` 工作流校验两侧一致性。\n\n### 6. 前端依赖分层\n\n前端 6 层依赖结构（Level-1 到 Level-6），高层级只能依赖低层级，禁止反向依赖。商业版与开源版差异通过 Adapter 模式解耦（`adapter-interfaces/` → `*-adapter/` → `components-with-adapter/`）。\n\n## 后端开发流程\n\n```\nStep 1: IDL 定义 → Step 2: 代码生成 → Step 3: MySQL Schema → Step 4: GORM Gen\n→ Step 5: 配置文件 → Step 6: 业务代码 → Step 7: 错误码 → Step 8: 国际化\n→ Step 9: UT → Step 10: golint\n```\n\n详细步骤见 `docs/guidance/idl-codegen-guide.md`（Step 1-2）和 `docs/guidance/deployment-guide.md`（部署配置）。\n\n**Wire 依赖注入**：修改 `wire.go` 后运行 `wire generate` 重新生成 `wire_gen.go`。禁止手动编辑 `wire_gen.go`。\n\n**代码复用约束**：新增功能前必须先搜索 codebase 是否已有相同/类似实现，有则复用或扩展，不得新建重复文件。\n\n## 常用命令\n\n### 后端（Go）\n\n| 操作 | 命令 |\n|------|------|\n| Go 编译 | `cd backend && go build ./...` |\n| 全量测试 | `cd backend && go test -gcflags=\"all=-N -l\" ./...` |\n| 单测（指定包） | `cd backend && go test -gcflags=\"all=-N -l\" ./modules//...` |\n| 单测（指定函数） | `cd backend && go test -gcflags=\"all=-N -l\" -run TestFuncName ./modules//...` |\n| CI 级测试（含 race） | `cd backend && go test -gcflags=\"all=-N -l\" -race -v -coverprofile=coverage.out -coverpkg=./... ./...` |\n| golint 修复 | `cd backend && golangci-lint run --config ../.github/.golangci.yaml --fix` |\n| IDL 代码生成 | `bash backend/script/cloudwego/code_gen.sh` |\n| GORM 代码生成 | `cd backend && go run script/gorm_gen/generate.go` |\n| 错误码生成 | `backend/script/errorx/code_gen.py ` |\n\n### 前端（Rush.js + pnpm）\n\n| 操作 | 命令 |\n|------|------|\n| 安装依赖 | `node common/scripts/install-run-rush.js install` |\n| 全量构建 | `node common/scripts/install-run-rush.js rebuild --verbose` |\n| 开发服务器 | `cd frontend/apps/cozeloop && npm run dev` |\n| Lint | `cd frontend/apps/cozeloop && npm run lint` |\n| 测试 | `cd frontend/apps/cozeloop && npm run test` |\n| TypeScript 检查 | `cd frontend/apps/cozeloop && npm run build:ts` |\n\n### 部署\n\n| 操作 | 命令 |\n|------|------|\n| 本地 dev 部署 | `make compose-up-dev` |\n| 本地 debug 部署（含 Delve） | `make compose-up-debug` |\n| 停止 dev | `make compose-down-dev` |\n| 停止并清理 volumes | `make compose-down-v-dev` |\n| Helm 部署 | `make helm-up` |\n| 查看 Pod 状态 | `make helm-pod` |\n\n### PR 标题格式\n\nPR 标题必须符合 `[][] ` 格式，CI 会校验。\n\n- type: `feat`, `fix`, `docs`, `style`, `refactor`, `perf`, `test`, `chore`, `build`, `ci`\n- scope: `all`, `idl`, `frontend`, `backend`, `infra`, `workflow`, `prompt`, `evaluation`, `trace`, `model`, `tag`, `dataset`, `foundation`\n\n示例：`[feat][evaluation] add offline metric support`\n","docs/AGENTS.md":"# AGENTS.md\n\nThis file provides guidance to Claude Code (claude.ai/code) when working with docs in this repository.\n\n> 中层索引，串联 reference/（事实说明）和 guidance/（操作手册）。\n\n## 文件树\n\n```\ndocs/\n├── AGENTS.md ← 本文件\n├── reference/\n│ ├── backend-modules-api.md # 后端 6 模块职责、分层、API 路由\n│ └── frontend-packages.md # 前端 59 包分层结构\n└── guidance/\n ├── deployment-guide.md # Docker Compose / Helm 部署指南\n └── idl-codegen-guide.md # IDL 变更后代码生成完整流程\n```\n\n## 导航\n\n| 我想… | 文件 |\n|-------|------|\n| 了解后端某个模块的职责和 API 路由 | `reference/backend-modules-api.md` |\n| 了解前端包的分层和依赖关系 | `reference/frontend-packages.md` |\n| 部署 Coze Loop 到 Docker 或 K8s | `guidance/deployment-guide.md` |\n| 修改 IDL 后走完代码生成流程 | `guidance/idl-codegen-guide.md` |\n\n## 文档分类原则\n\n- **reference/**：事实说明——描述\"是什么\"，不随任务变化\n- **guidance/**：操作手册——描述\"怎么做\"，面向具体操作步骤\n","frontend/infra/plugins/pkg-root-webpack-plugin/README.md":"# @coze-arch/pkg-root-webpack-plugin\n\n> 用于支持 `@` 根目录引用的插件\n\n## Overview\n\nThis package is part of the Coze Studio monorepo and provides architecture functionality. It includes hook, plugin.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@coze-arch/pkg-root-webpack-plugin\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@coze-arch/pkg-root-webpack-plugin';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Hook\n- Plugin\n\n## API Reference\n\n### Exports\n\n- `default PkgRootWebpackPlugin;`\n- `PkgRootWebpackPlugin ;`\n\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Studio monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","frontend/infra/plugins/postcss-plugin/README.md":"# @coze-arch/postcss-plugin\n\nA postcss plugin to add namespace prefix for all css selector\n\n## Overview\n\nThis package is part of the Coze Studio monorepo and provides architecture functionality. It serves as a core component in the Coze Studio ecosystem.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@coze-arch/postcss-plugin\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@coze-arch/postcss-plugin';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Core functionality for Coze Studio\n- TypeScript support\n- Modern ES modules\n\n## API Reference\n\nPlease refer to the TypeScript definitions for detailed API documentation.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Studio monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","frontend/packages/loop-base/account/README.md":"# @cozeloop/account\n\nCozeLoop account\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides authentication functionality. It includes hook, store, service.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/account\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@cozeloop/account';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Hook\n- Store\n- Service\n\n## API Reference\n\n### Exports\n\n- `useUserStore, setUserInfo`\n- `useSpaceStore,\n setSpace,\n PERSONAL_ENTERPRISE_ID,`\n- `useLogin`\n- `useRegister`\n- `useLoginStatus`\n- `useLogout`\n- `useCheckLogin`\n- `userService`\n- `authnService`\n- `spaceService`\n\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","frontend/packages/loop-base/api-schema/README.md":"# @cozeloop/api-schema\n\nCoze Loop 的 API Schema 定义包。\n\n## 安装\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/api-schema\": \"workspace:*\"\n }\n}\n```\n\n```bash\nrush update\n```\n\n## 更新 API Schema\n\n当后端 API 发生变更时，运行以下命令更新：\n\n```bash\nrushx update\n```\n\n### 指定分支\n\n默认从 `main` 分支拉取 IDL 定义。如需从其他分支更新，可以修改 [package.json](./package.json) 中 `prethrift` 脚本的 `--branch` 参数：\n\n```json\n{\n \"scripts\": {\n \"prethrift\": \"bash ./scripts/download-thrift.sh --branch=your-branch\"\n }\n}\n```\n\n然后执行 `rushx update` 即可从指定分支拉取最新的 API Schema。\n\n## License\n\nApache-2.0\n","frontend/packages/loop-base/base-hooks/README.md":"# @cozeloop/hooks\n\nHooks for CozeLoop\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides community features functionality. It includes modal.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/hooks\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@cozeloop/hooks';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Modal\n\n## API Reference\n\n### Exports\n\n- `useRefresh`\n- `useModalData`\n- `useMouseDownOffset`\n- `useBreadcrumb`\n- `useNavbarCollapsed`\n\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","frontend/packages/loop-base/bot-env-adapter/README.md":"# @coze-studio/bot-env-adapter\n\n> Environment configuration adapter for bot applications with multi-region support\n\n## Project Overview\n\nThe `@coze-studio/bot-env-adapter` package provides a centralized environment configuration management system for bot applications. It consolidates environment variables, feature flags, and business configurations into a type-safe, region-aware adapter that supports different deployment environments (CN, SG, VA) and build types (local, online, offline, test).\n\nThis package was originally extracted from `apps/bot/env` to provide reusable environment configuration management across the bot ecosystem.\n\n## Features\n\n- **Multi-Region Support**: Configures environments for China (CN), Singapore (SG), and Virginia (VA) regions\n- **Environment-Aware Configuration**: Automatically selects appropriate configurations based on build type and region\n- **Type Safety**: Auto-generated TypeScript definitions ensure type safety across the application\n- **Feature Flags**: Centralized feature flag management for different environments and regions\n- **Business Configuration**: Environment-specific business settings and API configurations\n- **Build-Time Validation**: Validates required environment variables at build time\n\n## Get Started\n\n### Installation\n\nInstall the package in your workspace:\n\n```bash\n# Add to your package.json dependencies\n\"@coze-studio/bot-env-adapter\": \"workspace:*\"\n\n# Run rush update to install\nrush update\n```\n\n### Basic Usage\n\n```typescript\nimport { GLOBAL_ENVS } from '@coze-studio/bot-env-adapter';\n\n// Access environment variables\nconsole.log(GLOBAL_ENVS.REGION); // 'cn' | 'sg' | 'va'\nconsole.log(GLOBAL_ENVS.BUILD_TYPE); // 'local' | 'online' | 'offline' | 'test'\nconsole.log(GLOBAL_ENVS.BOT_BRAND_NAME); // Region-specific brand name\n\n// Access feature flags\nif (GLOBAL_ENVS.FEATURE_ENABLE_SSO) {\n // Enable SSO functionality\n}\n\n// Access business configurations\nconst appId = GLOBAL_ENVS.APP_ID;\nconst cdnUrl = GLOBAL_ENVS.CDN;\n```\n\n### Runtime Environment\n\n```typescript\nimport { runtimeEnv } from '@coze-studio/bot-env-adapter/runtime';\n\n// Access runtime environment information\nconsole.log(runtimeEnv.isPPE); // Production environment check\n```\n\n### Type Definitions\n\n```typescript\nimport type { TConfigEnv } from '@coze-studio/bot-env-adapter/typings';\n\n// Use predefined types for configuration\nconst myConfig: TConfigEnv = {\n cn: {\n boe: 'boe-value',\n inhouse: 'inhouse-value',\n release: 'release-value',\n },\n sg: {\n inhouse: 'sg-inhouse-value',\n release: 'sg-release-value',\n },\n va: {\n release: 'va-release-value',\n },\n};\n```\n\n## API Reference\n\n### Core Exports\n\n#### `GLOBAL_ENVS`\nThe main export containing all environment variables, feature flags, and configurations.\n\n```typescript\nimport { GLOBAL_ENVS } from '@coze-studio/bot-env-adapter';\n\n// Base environment variables\nGLOBAL_ENVS.BUILD_TYPE // Build environment type\nGLOBAL_ENVS.REGION // Deployment region\nGLOBAL_ENVS.NODE_ENV // Node environment\nGLOBAL_ENVS.CDN // CDN URL for current environment\n\n// Feature flags\nGLOBAL_ENVS.FEATURE_ENABLE_SSO // SSO feature toggle\nGLOBAL_ENVS.FEATURE_ENABLE_APP_GUIDE // App guide feature\nGLOBAL_ENVS.FEATURE_GOOGLE_LOGIN // Google login support\n\n// Business configurations\nGLOBAL_ENVS.APP_ID // Application ID\nGLOBAL_ENVS.BOT_BRAND_NAME // Brand name for current region\nGLOBAL_ENVS.GOOGLE_CLIENT_ID // Google OAuth client ID\n```\n\n#### `extractEnvValue(config: TConfigEnv): T`\nUtility function to extract environment-specific values based on current region and build type.\n\n```typescript\nimport { extractEnvValue } from '@coze-studio/bot-env-adapter';\n\nconst apiUrl = extractEnvValue({\n cn: {\n boe: 'https://api-boe.example.cn',\n inhouse: 'https://api-inhouse.example.cn',\n release: 'https://api.example.cn',\n },\n sg: {\n inhouse: 'https://api-inhouse.example.com',\n release: 'https://api.example.com',\n },\n va: {\n release: 'https://api-va.example.com',\n },\n});\n```\n\n### Configuration Structure\n\n#### Base Configuration (`base.ts`)\nContains fundamental environment variables and regional judgments:\n- Build type and version information\n- Regional flags (IS_OVERSEA, IS_CN_REGION, etc.)\n- CDN configurations\n- Development mode flags\n\n#### Feature Flags (`features.ts`)\nBoolean flags controlling feature availability:\n- Authentication features (SSO, Google login, etc.)\n- Regional feature differences\n- Version-specific feature toggles\n\n#### Business Configurations (`configs.ts`)\nEnvironment-specific business settings:\n- API keys and application IDs\n- External service configurations\n- Legal document URLs\n- Platform-specific settings\n\n### Type Definitions\n\nThe package automatically generates TypeScript definitions in `src/typings.d.ts` based on the environment configuration. These types are available for import:\n\n```typescript\n// Auto-generated types based on actual configuration\ndeclare const BUILD_TYPE: 'local' | 'online' | 'offline' | 'test';\ndeclare const REGION: 'cn' | 'sg' | 'va';\ndeclare const FEATURE_ENABLE_SSO: boolean;\n// ... and many more\n```\n\n## Development\n\n### Project Structure\n\n```\nsrc/\n├── index.ts # Main entry point, exports GLOBAL_ENVS\n├── base.ts # Base environment variables and regional flags\n├── features.ts # Feature flag configurations\n├── configs.ts # Business-specific configurations\n├── typings.d.ts # Auto-generated type definitions\n├── runtime/\n│ └── index.ts # Runtime environment utilities\n├── utils/\n│ ├── config-helper.ts # Configuration extraction utilities\n│ └── current-branch.ts # Git branch detection\n└── configs/\n └── volcano.ts # Volcano platform configurations\n```\n\n### Configuration Guidelines\n\nWhen adding new environment configurations, follow these conventions:\n\n1. **Use `extractEnvValue` for environment-specific values**:\n```typescript\nconst MY_CONFIG = extractEnvValue({\n cn: {\n boe: 'boe-value',\n inhouse: 'inhouse-value',\n release: 'release-value',\n },\n sg: {\n inhouse: 'sg-inhouse-value',\n release: 'sg-release-value',\n },\n va: {\n release: 'va-release-value',\n },\n});\n```\n\n2. **Ensure all environments are covered** to prevent configuration gaps\n3. **Update the `envs` object** in `src/index.ts` to include new configurations\n4. **Run the build script** to regenerate type definitions\n\n### Build Process\n\nThe package includes an automated TypeScript definition generator:\n\n```bash\nnpm run build\n```\n\nThis command:\n1. Analyzes the `envs` object in `src/index.ts`\n2. Generates type definitions in `src/typings.d.ts`\n3. Compiles TypeScript files\n\n### Environment Variables\n\nSet these environment variables to control the adapter behavior:\n\n- `BUILD_TYPE`: Build environment ('local' | 'online' | 'offline' | 'test')\n- `REGION`: Deployment region ('cn' | 'sg' | 'va')\n- `CUSTOM_VERSION`: Version type ('inhouse' | 'release')\n- `NODE_ENV`: Node environment ('development' | 'production' | 'test')\n- `VERBOSE`: Set to 'true' to log all environment values\n\n### Testing\n\n```bash\nnpm run test # Run tests\nnpm run test:cov # Run tests with coverage\nnpm run lint # Run linting\n```\n\n## Dependencies\n\n### Runtime Dependencies\nThis package has no runtime dependencies, making it lightweight and suitable for both client and server environments.\n\n### Development Dependencies\n- **@coze-arch/eslint-config**: Workspace ESLint configuration\n- **@coze-arch/ts-config**: Workspace TypeScript configuration\n- **@coze-arch/vitest-config**: Workspace Vitest configuration\n- **ts-morph**: TypeScript AST manipulation for type generation\n- **sucrase**: Fast TypeScript compiler for build scripts\n\n## License\n\nApache-2.0\n","frontend/packages/loop-base/bot-env/README.md":"# @coze-arch/bot-env\n\n> A TypeScript-based environment variable management system for the bot-studio monorepo, providing compile-time type safety and runtime environment configuration.\n\n## Features\n\n- 🔧 **Compile-time Environment Variables**: Access to environment variables with full TypeScript support\n- 🏗️ **Multi-environment Support**: Handles different deployment environments (BOE, production, development)\n- 🌍 **Multi-region Configuration**: Supports CN, SG, and VA regions with region-specific configurations\n- 🎯 **Feature Flags**: Built-in feature toggle system for conditional functionality\n- 📝 **Auto-generated Types**: Automatically generates TypeScript declarations from environment configuration\n- 🔒 **Type Safety**: Full TypeScript support with strict typing for all environment variables\n- ⚡ **Runtime Environment Access**: Provides runtime environment detection and configuration\n\n## Get Started\n\n### Installation\n\n```bash\n# Install the package\nrush add -p @coze-arch/bot-env\n\n# Update dependencies\nrush update\n```\n\n### Basic Usage\n\n```typescript\n// Import compile-time environment variables\nimport { GLOBAL_ENVS } from '@coze-arch/bot-env';\n\n// Access environment variables with full type safety\nconsole.log(GLOBAL_ENVS.REGION); // 'cn' | 'sg' | 'va'\nconsole.log(GLOBAL_ENVS.IS_PROD); // boolean\nconsole.log(GLOBAL_ENVS.BUILD_TYPE); // 'local' | 'online' | 'offline' | 'test'\n\n// Import runtime environment utilities\nimport { runtimeEnv } from '@coze-arch/bot-env/runtime';\n\n// Access runtime environment information\nconsole.log(runtimeEnv.isPPE); // boolean\n```\n\n### TypeScript Declarations\n\n```typescript\n// Import TypeScript declarations\n/// \n\n// All environment variables are available as global constants\ndeclare const REGION: 'cn' | 'sg' | 'va';\ndeclare const IS_PROD: boolean;\ndeclare const FEATURE_ENABLE_SSO: boolean;\n// ... and many more\n```\n\n## API Reference\n\n### GLOBAL_ENVS\n\nThe main export containing all environment variables organized by category:\n\n#### Base Environment Variables\n- `BUILD_TYPE`: Build environment type (`'local' | 'online' | 'offline' | 'test'`)\n- `CUSTOM_VERSION`: Version type (`'inhouse' | 'release'`)\n- `REGION`: Deployment region (`'cn' | 'sg' | 'va'`)\n- `NODE_ENV`: Node environment (`'production' | 'development' | 'test'`)\n- `IS_PROD`: Production environment flag\n- `IS_BOE`: BOE environment flag\n- `IS_OVERSEA`: Overseas deployment flag\n- `IS_RELEASE_VERSION`: Release version flag\n\n#### Feature Flags\n- `FEATURE_ENABLE_SSO`: Single Sign-On feature\n- `FEATURE_ENABLE_APP_GUIDE`: Application guide feature\n- `FEATURE_ENABLE_MSG_DEBUG`: Message debugging feature\n- `FEATURE_AWEME_LOGIN`: Aweme login integration\n- `FEATURE_GOOGLE_LOGIN`: Google login integration\n- And many more feature toggles...\n\n#### Configuration Variables\n- `CDN`: Content delivery network URL\n- `UPLOAD_CDN`: Upload CDN configuration\n- `COZE_DOMAIN`: Coze service domain\n- `APP_ID`: Application identifier\n- `APP_KEY`: Application key\n- Various service-specific configurations\n\n### Runtime Environment\n\n```typescript\nimport { runtimeEnv } from '@coze-arch/bot-env/runtime';\n\n// Runtime environment detection\nruntimeEnv.isPPE // boolean - Production-like environment detection\n```\n\n### Build Scripts\n\n```typescript\nimport { build } from '@coze-arch/bot-env/build';\n\n// Generate TypeScript declarations from environment configuration\nbuild();\n```\n\n## Development\n\n### Project Structure\n\n```\nsrc/\n├── index.ts # Main exports\n├── runtime/ # Runtime environment utilities\n├── typings.d.ts # Auto-generated TypeScript declarations\n└── global.d.ts # Global type definitions\n\nscripts/\n├── build.ts # Build script exports\n└── index.ts # Build script runner\n```\n\n### Environment Configuration\n\nThis package acts as a wrapper around `@coze-studio/bot-env-adapter`, which provides the actual environment configuration logic. The adapter package includes:\n\n- **Base configuration**: Core environment variables like region, build type, and deployment flags\n- **Feature flags**: Toggle switches for various application features\n- **Business configs**: Service-specific configuration values\n- **Configuration helpers**: Utilities for environment-specific value extraction\n\n### Auto-generated Types\n\nThe package automatically generates TypeScript declarations based on the environment configuration. The build process:\n\n1. Analyzes the `envs` object in the source code\n2. Extracts type information for each environment variable\n3. Generates corresponding TypeScript declarations\n4. Updates the `typings.d.ts` file with the latest types\n\n### Environment-specific Configuration\n\nUse the `extractEnvValue` utility for environment-specific configurations:\n\n```typescript\nconst API_ENDPOINT = extractEnvValue({\n cn: {\n boe: 'https://boe.api.example.com',\n inhouse: 'https://inhouse.api.example.com',\n release: 'https://api.example.com'\n },\n sg: {\n inhouse: 'https://sg-inhouse.api.example.com',\n release: 'https://sg.api.example.com'\n },\n va: {\n release: 'https://va.api.example.com'\n }\n});\n```\n\n### Running Tests\n\n```bash\n# Run tests\nrush test -t @coze-arch/bot-env\n\n# Run tests with coverage\nrush test:cov -t @coze-arch/bot-env\n```\n\n### Building\n\n```bash\n# Build the package\nrush build -t @coze-arch/bot-env\n\n# Generate type definitions\nrush build:types -t @coze-arch/bot-env\n```\n\n## Dependencies\n\n### Runtime Dependencies\n- `@coze-studio/bot-env-adapter`: Core environment configuration adapter\n\n### Development Dependencies\n- `@coze-arch/eslint-config`: ESLint configuration\n- `@coze-arch/ts-config`: TypeScript configuration\n- `@coze-arch/vitest-config`: Vitest testing configuration\n- `ts-morph`: TypeScript AST manipulation for type generation\n- `sucrase`: Fast TypeScript/JSX compiler\n- `vitest`: Testing framework\n\n## License\n\nApache-2.0 License - see package.json for details.\n\n---\n\nFor more information about environment configuration patterns and best practices, refer to the [bot-studio monorepo documentation](../../docs/).\n","frontend/packages/loop-base/bot-flags/README.md":"# @coze-arch/bot-flags\n\nfeature gating for bot studio\n\n## Overview\n\nThis package is part of the Coze Studio monorepo and provides architecture functionality. It serves as a core component in the Coze ecosystem.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@coze-arch/bot-flags\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@coze-arch/bot-flags';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Core functionality for Coze Studio\n- TypeScript support\n- Modern ES modules\n\n## API Reference\n\n### Exports\n\n- `type FEATURE_FLAGS, type FetchFeatureGatingFunction`\n- `getFlags`\n- `useFlags`\n- `pullFeatureFlags`\n\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Studio monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","frontend/packages/loop-base/bot-md-box-adapter/README.md":"# @coze-arch/bot-md-box-adapter\n\n> Project template for react component with storybook.\n\n## Features\n\n- [x] eslint & ts\n- [x] esm bundle\n- [x] umd bundle\n- [x] storybook\n\n## Commands\n\n- init: `rush update`\n- dev: `npm run dev`\n- build: `npm run build`\n","frontend/packages/loop-base/bot-typings/README.md":"# @coze-arch/bot-typings\n\nA comprehensive TypeScript type definitions package extracted from the bot application, providing essential type declarations for the Coze bot platform. This package centralizes common type definitions, interfaces, and module declarations to ensure type safety across the bot ecosystem.\n\n## Features\n\n- **Global Type Declarations**: Provides type definitions for various file formats (images, stylesheets, SVG)\n- **Common Utility Types**: Includes utility types like `Expand`, `PartialRequired`, and `Obj` for enhanced type manipulation\n- **Platform-Specific Types**: Defines interfaces for browser APIs, window objects, and navigator extensions\n- **User & Authentication Types**: Comprehensive type definitions for user data, authentication flows, and OAuth\n- **Teamspace & Routing Types**: Type definitions for dynamic routing parameters and teamspace functionality\n- **Zero Runtime Impact**: Pure TypeScript declarations with no runtime dependencies\n\n## Get Started\n\n### Installation\n\nInstall the package in your Rush.js monorepo:\n\n```bash\n# Add to your package.json\n\"@coze-arch/bot-typings\": \"workspace:*\"\n\n# Run Rush update to install\nrush update\n```\n\n### Basic Usage\n\nImport the main type definitions:\n\n```typescript\n// Import the main type definitions\nimport \"@coze-arch/bot-typings\";\n\n// Import specific modules\nimport { BotPageFromEnum, Obj, Expand, PartialRequired } from \"@coze-arch/bot-typings/common\";\nimport { DynamicParams } from \"@coze-arch/bot-typings/teamspace\";\n```\n\n## API Reference\n\n### Common Types\n\n#### `BotPageFromEnum`\nDefines the source of bot detail pages:\n\n```typescript\nenum BotPageFromEnum {\n Bot = 'bot', // Bot list\n Explore = 'explore', // Explore list\n Store = 'store',\n Template = 'template',\n}\n```\n\n#### Utility Types\n\n**`Obj`** - Generic object type:\n```typescript\ntype Obj = Record;\n```\n\n**`Expand`** - Expands intersection types for better readability:\n```typescript\ntype Intersection = { a: string } & { b: number };\ntype Result = Expand;\n// Result: { a: string; b: number }\n```\n\n**`PartialRequired`** - Makes specific fields required:\n```typescript\ninterface Agent {\n id?: string;\n name?: string;\n desc?: string;\n}\ntype Result = PartialRequired;\n// Result: { id: string; name: string; desc?: string }\n```\n\n### Teamspace Types\n\n#### `DynamicParams`\nDefines route parameters for teamspace navigation:\n\n```typescript\ninterface DynamicParams extends Record {\n space_id?: string;\n bot_id?: string;\n plugin_id?: string;\n workflow_id?: string;\n dataset_id?: string;\n doc_id?: string;\n tool_id?: string;\n invite_key?: string;\n product_id?: string;\n mock_set_id?: string;\n conversation_id: string; // Required\n commit_version?: string;\n scene_id?: string;\n post_id?: string;\n project_id?: string;\n}\n```\n\n### User & Authentication Types\n\nThe package provides comprehensive types under the `DataItem` namespace:\n\n#### `UserInfo`\nComplete user information interface:\n```typescript\ninterface UserInfo {\n user_id_str: string;\n name: string;\n screen_name: string;\n avatar_url: string;\n email?: string;\n // ... many more fields\n}\n```\n\n#### Authentication Types\n- `AuthLoginParams` - OAuth login parameters\n- `AuthorizeResponse` - Authorization response structure\n- `SendCodeData` - Verification code response\n- `UserCheckResponse` - User validation response\n\n### Global Module Declarations\n\nThe package automatically provides type declarations for:\n\n**Image Files:**\n```typescript\n// .jpeg, .jpg, .webp, .gif, .png files\nimport myImage from './image.png'; // string\n```\n\n**Stylesheets:**\n```typescript\n// .less, .css files\nimport styles from './styles.less'; // { [key: string]: string }\n```\n\n**SVG Files:**\n```typescript\n// .svg files\nimport { ReactComponent } from './icon.svg'; // React.FunctionComponent\nimport icon from './icon.svg'; // any (depends on svgDefaultExport config)\n```\n\n### Browser API Extensions\n\n**Window Interface Extensions:**\n```typescript\n// IDE plugin support\nwindow.editorDispose?.();\n\n// Mini-program integration\nwindow.tt?.miniProgram.postMessage({ data: {...} });\n\n// Coze app integration\nwindow.__cozeapp__?.setLoading?.(true);\n```\n\n**Navigator Extensions:**\n```typescript\n// Standalone app detection\nif (navigator.standalone) {\n // Running as standalone web app\n}\n```\n\n## Development\n\n### Project Structure\n\n```\nsrc/\n├── index.d.ts # Main type definitions and module declarations\n├── common.ts # Common utility types and enums\n├── teamspace.ts # Teamspace-related type definitions\n├── data_item.d.ts # User and authentication type definitions\n├── navigator.d.ts # Navigator API extensions\n└── window.d.ts # Window object extensions\n```\n\n### Building\n\nThis package contains only TypeScript declarations and requires no build step:\n\n```bash\nnpm run build # No-op (exits with code 0)\n```\n\n### Linting\n\n```bash\nnpm run lint\n```\n\n### Adding New Types\n\n1. **Module Declarations**: Add to `index.d.ts`\n2. **Common Utilities**: Add to `common.ts`\n3. **Domain-Specific Types**: Create new files and export from appropriate entry points\n4. **Global Extensions**: Add to `window.d.ts` or `navigator.d.ts`\n\nRemember to update the `exports` field in `package.json` for new modules.\n\n## Dependencies\n\n### Runtime Dependencies\nNone - this package contains only TypeScript type definitions.\n\n### Development Dependencies\n- **@coze-arch/bot-env**: Workspace package providing environment-specific typings\n- **@coze-arch/eslint-config**: Shared ESLint configuration\n- **@coze-arch/ts-config**: Shared TypeScript configuration\n- **TypeScript 5.8.2**: Core TypeScript compiler\n- **React Types**: For component and SVG type definitions\n\n## License\n\nApache-2.0\n\n---\n\n**Author**: fanwenjie.fe@bytedance.com\n\nThis package is part of the Coze bot platform architecture and provides essential type safety for bot development workflows.\n","frontend/packages/loop-base/components/README.md":"# @cozeloop/components\n\ncommon components for cozeloop\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides ui component functionality. It serves as a core component in the Coze Loop ecosystem.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/components\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@cozeloop/components';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Core functionality for Coze Loop\n- TypeScript support\n- Modern ES modules\n\n## API Reference\n\n### Exports\n\n- `ColumnSelector, type ColumnItem`\n- `TooltipWhenDisabled`\n- `LoopTable`\n- `TableWithPagination,\n DEFAULT_PAGE_SIZE,\n PAGE_SIZE_OPTIONS,`\n- `PageError,\n PageLoading,\n PageNoAuth,\n PageNoContent,\n PageNotFound,`\n- `TableColActions`\n- `LoopTabs`\n- `LargeTxtRender`\n- `InputSlider`\n- `handleCopy, sleep`\n\n*And more...*\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- React\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","frontend/packages/loop-base/env/README.md":"# @cozeloop/env-adapter\n\nA community features package for the Coze Loop ecosystem\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides community features functionality. It serves as a core component in the Coze Loop ecosystem.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/env-adapter\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@cozeloop/env-adapter';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Core functionality for Coze Loop\n- TypeScript support\n- Modern ES modules\n\n## API Reference\n\n### Exports\n\n- `const envs = new Env();`\n\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","frontend/packages/loop-base/fetch-stream/README.md":"# @coze-arch/fetch-stream\n\nfetch stream vanilla js\n\n## Overview\n\nThis package is part of the Coze Studio monorepo and provides api & networking functionality. It serves as a core component in the Coze ecosystem.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@coze-arch/fetch-stream\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@coze-arch/fetch-stream';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Core functionality for Coze Studio\n- TypeScript support\n- Modern ES modules\n\n## API Reference\n\n### Exports\n\n- `isFetchStreamErrorInfo,\n fetchStream,\n FetchStreamErrorCode,\n type FetchSteamConfig,\n type FetchStreamErrorInfo,`\n\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Studio monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","frontend/packages/loop-base/guard/README.md":"# @cozeloop/guard\n\nCozeloop 权限守卫组件，用于管理和控制用户界面中的权限点。\n\n## 安装\n\n```bash\npnpm add @cozeloop/guard\n```\n\n## 特性\n\n- 支持多种权限控制方式（隐藏、只读、拦截等）\n- 提供上下文管理权限状态\n- 支持路由级别的权限控制\n- 可扩展的权限点定义\n\n## 使用方法\n\n### 基础使用\n\n```tsx\nimport { Guard, GuardPoint } from '@cozeloop/guard';\n\nfunction MyComponent() {\n return (\n \n \n \n );\n}\n```\n\n### 路由权限控制\n\n```tsx\nimport { GuardRoute, GuardPoint } from '@cozeloop/guard';\n\nfunction ProtectedRoute() {\n return (\n \n
受保护的内容
\n \n );\n}\n```\n\n### 权限上下文\n\n```tsx\nimport { GuardProvider } from '@cozeloop/guard';\n\nfunction App() {\n // 自定义权限策略\n const customStrategy = {\n // 实现 GuardStrategy 接口\n };\n\n return (\n \n \n \n );\n}\n```\n\n## Features\n\n- [x] eslint & ts\n- [x] esm bundle\n- [x] umd bundle\n- [x] storybook\n\n## Commands\n\n- init: `rush update`\n- dev: `npm run dev`\n- build: `npm run build`\n","frontend/packages/loop-base/intl/README.md":"# @cozeloop/intl\n\nInternationalization(intl) runtime for CozeLoop\n","frontend/packages/loop-base/logger/README.md":"# @coze-arch/logger\n\nA comprehensive logging and error reporting library for the Coze architecture ecosystem, providing unified console logging, React error boundaries, and performance tracing capabilities.\n\n## Features\n\n- **Unified Logging Interface**: Centralized logging with support for multiple log levels (info, success, warning, error, fatal)\n- **Console Logging**: Console output for debugging and development\n- **React Error Boundaries**: Ready-to-use error boundary components with automatic error reporting\n- **Performance Tracing**: Duration tracking for multi-step operations and workflows\n- **Context-Aware Logging**: Namespace and scope-based log organization\n- **TypeScript Support**: Full TypeScript definitions and type safety\n- **Pending Queue System**: Queues logs when reporter is not initialized, executes when ready\n- **Console Control**: Configurable console output for different environments\n\n## Get Started\n\n### Installation\n\n```bash\n# Add to your Rush.js workspace\nrush add -p @coze-arch/logger --dev\n\n# Update dependencies\nrush update\n```\n\n### Basic Usage\n\n#### Console Logging\n\n```typescript\nimport { logger } from '@coze-arch/logger';\n\n// Simple string messages\nlogger.info('Operation completed successfully');\nlogger.warning('This is a warning message');\nlogger.error({ message: 'Something went wrong', error: new Error('Details') });\n\n// With context and metadata\nlogger.info({\n message: 'User action completed',\n namespace: 'user-management',\n scope: 'profile-update',\n meta: {\n userId: '12345',\n action: 'profile_update',\n duration: 150\n }\n});\n```\n\n#### Event Reporting\n\n```typescript\nimport { reporter } from '@coze-arch/logger';\n\n// Initialize reporter\nreporter.init();\n\n// Log custom events\nreporter.event({\n eventName: 'user_action',\n namespace: 'analytics',\n meta: {\n action: 'button_click',\n component: 'header'\n }\n});\n\n// Report errors\nreporter.error({\n message: 'API request failed',\n error: new Error('Network timeout'),\n namespace: 'api',\n scope: 'user-service'\n});\n```\n\n## API Reference\n\n### Logger\n\nThe main logger instance for console output and basic logging.\n\n```typescript\nimport { logger, Logger } from '@coze-arch/logger';\n\n// Create custom logger with preset context\nconst apiLogger = logger.createLoggerWith({\n ctx: {\n namespace: 'api',\n scope: 'user-service'\n }\n});\n\n// Available log levels\nlogger.info(message | options);\nlogger.success(message | options);\nlogger.warning(message | options);\nlogger.error(options); // requires error object\n\n// Setup configuration\nlogger.setup({ 'no-console': true }); // Disable console output\n```\n\n### Reporter\n\nHandles event reporting and structured logging.\n\n```typescript\nimport { reporter, Reporter } from '@coze-arch/logger';\n\n// Initialize reporter\nreporter.init();\n\n// Create reporter with preset context\nconst moduleReporter = reporter.createReporterWithPreset({\n namespace: 'auth',\n scope: 'login',\n meta: { version: '1.0.0' }\n});\n\n// Custom logs\nreporter.info({ message: 'Info log', meta: { key: 'value' } });\nreporter.warning({ message: 'Warning log' });\nreporter.error({ message: 'Error log', error: new Error() });\n\n// Custom events\nreporter.event({ eventName: 'user_login' });\nreporter.successEvent({ eventName: 'operation_complete' });\nreporter.errorEvent({ eventName: 'login_failed', error: new Error() });\n```\n\n### Performance Tracing\n\nTrack duration across multiple steps in a workflow.\n\n```typescript\nimport { reporter } from '@coze-arch/logger';\n\n// Create tracer for a specific event\nconst { trace } = reporter.tracer({ eventName: 'api_request' });\n\n// Track steps with automatic duration calculation\ntrace('start');\n// ... some operation\ntrace('validation_complete');\n// ... more operations\ntrace('request_sent');\n// ... final operations\ntrace('success', {\n meta: { responseSize: 1024 }\n});\n\n// Handle errors in tracing\ntrace('error', {\n error: new Error('Request failed'),\n meta: { statusCode: 500 }\n});\n```\n\n### Error Boundary\n\nReact component for catching and reporting JavaScript errors.\n\n```typescript\nimport { ErrorBoundary } from '@coze-arch/logger';\n\nfunction App() {\n return (\n {\n console.log('Error caught:', error);\n }}\n onReset={() => {\n // Reset app state\n }}\n >\n \n \n );\n}\n\nfunction ErrorFallback({ error, resetErrorBoundary }) {\n return (\n
\n

Something went wrong:

\n 
{error.message}
\n \n
\n );\n}\n```\n\n### Error Boundary Hooks\n\n```typescript\nimport { useErrorBoundary, useErrorHandler } from '@coze-arch/logger';\n\nfunction ComponentWithErrorHandling() {\n const { showBoundary } = useErrorBoundary();\n const handleError = useErrorHandler();\n\n const handleAsyncOperation = async () => {\n try {\n await riskyOperation();\n } catch (error) {\n // Report to error boundary\n showBoundary(error);\n // Or handle manually\n handleError(error);\n }\n };\n}\n```\n\n### Logger Context\n\nProvide logger instances through React context.\n\n```typescript\nimport { LoggerContext, useLogger } from '@coze-arch/logger';\n\n// Provider\nfunction App() {\n const logger = new Logger({\n ctx: { namespace: 'app' }\n });\n\n return (\n \n \n \n );\n}\n\n// Consumer\nfunction Component() {\n const logger = useLogger();\n\n logger.info('Component mounted');\n}\n```\n\n### Types and Interfaces\n\n```typescript\nimport type {\n LogLevel,\n CommonLogOptions,\n CustomLog,\n CustomErrorLog,\n CustomEvent,\n ErrorEvent,\n LoggerCommonProperties\n} from '@coze-arch/logger';\n\n// Log levels\nenum LogLevel {\n INFO = 'info',\n SUCCESS = 'success',\n WARNING = 'warning',\n ERROR = 'error',\n FATAL = 'fatal'\n}\n\n// Common log options interface\ninterface CommonLogOptions {\n namespace?: string;\n scope?: string;\n level?: LogLevel;\n action?: LogAction[];\n message?: string;\n eventName?: string;\n meta?: Record;\n error?: Error;\n}\n```\n\n## Development\n\n### Running Tests\n\n```bash\n# Run all tests\nrush test\n\n# Run tests with coverage\nrush test:cov\n\n# Run tests for this package only\ncd packages/arch/logger\nrushx test\n```\n\n### Linting\n\n```bash\n# Lint the package\nrushx lint\n\n# Auto-fix linting issues\nrushx lint --fix\n```\n\n### Building\n\n```bash\n# Build the package\nrushx build\n\n# Type checking\nrushx ts-check\n```\n\n## Dependencies\n\n### Production Dependencies\n\n- **@coze-arch/bot-env**: Environment configuration utilities\n- **@coze-arch/bot-typings**: Shared type definitions\n- **lodash-es**: Utility functions library\n- **react**: React library for error boundary components\n- **react-error-boundary**: React error boundary utilities\n\n### Development Dependencies\n\n- **@coze-arch/eslint-config**: Shared ESLint configuration\n- **@coze-arch/ts-config**: Shared TypeScript configuration\n- **@coze-arch/vitest-config**: Shared Vitest configuration\n- **@types/lodash-es**: TypeScript definitions for lodash-es\n- **@types/react**: TypeScript definitions for React\n- **vitest**: Testing framework\n\n## License\n\nThis package is part of the Coze architecture ecosystem and follows the project's licensing terms.\n","frontend/packages/loop-base/loop-lng/README.md":"# @cozeloop/loop-lng\n\nLanguage data of Cozeloop.\n\n## Overview\n\nThis package is part of the Coze Studio monorepo and provides architecture functionality. It serves as a core component in the Coze Studio ecosystem.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/loop-lng\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport {} from /* exported functions/components */ '@cozeloop/loop-lng';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Core functionality for Coze Studio\n- TypeScript support\n- Modern ES modules\n\n## API Reference\n\n### Exports\n\n- `localeEn, localeZhCN`\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Studio monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","frontend/packages/loop-base/route/README.md":"# @cozeloop/biz-hooks-adapter\n\nBiz hooks for CozeLoop\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides community features functionality. It serves as a core component in the Coze Loop ecosystem.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/biz-hooks-adapter\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@cozeloop/biz-hooks-adapter';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Core functionality for Coze Loop\n- TypeScript support\n- Modern ES modules\n\n## API Reference\n\n### Exports\n\n- `useSpace`\n- `useUserInfo`\n- `useNavigateModule`\n- `useOpenWindow`\n- `useRouteInfo`\n- `useCozeLocation`\n- `useBenefit, type BenefitConfig`\n- `useFetchUserBenefit`\n- `useDemoSpace`\n\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","frontend/packages/loop-base/stores/README.md":"# @cozeloop/stores\n\nStores For Devops\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides state management functionality. It includes store.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/stores\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@cozeloop/stores';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Store\n\n## API Reference\n\n### Exports\n\n- `useUIStore, UIEvent`\n- `type BreadcrumbItemConfig`\n\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","frontend/packages/loop-base/tea/README.md":"# @cozeloop/tea-adapter\n\nA community features package for the Coze Loop ecosystem\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides community features functionality. It serves as a core component in the Coze Loop ecosystem.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/tea-adapter\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@cozeloop/tea-adapter';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Core functionality for Coze Loop\n- TypeScript support\n- Modern ES modules\n\n## API Reference\n\n### Exports\n\n- `start, init, config, stop, sendEvent, isStarted`\n- `type ParamsTypeDefine = Record>;`\n\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","frontend/packages/loop-base/toolkit/README.md":"# @cozeloop/toolkit\n\nToolkit For Devops\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides utilities functionality. It serves as a core component in the Coze Loop ecosystem.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/toolkit\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@cozeloop/toolkit';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Core functionality for Coze Loop\n- TypeScript support\n- Modern ES modules\n\n## API Reference\n\n### Exports\n\n- `notEmpty`\n- `getSafeFileName`\n- `formatTimestampToString,\n safeParseJson,\n formateMsToSeconds,`\n- `CozeLoopStorage`\n- `type LocalStorageKeys`\n- `formatNumberWithCommas,\n formatNumberInThousands,\n formatNumberInMillions,`\n- `safeJsonParse`\n- `fileDownload`\n\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","frontend/packages/loop-components/adapter-interfaces/README.md":"# @cozeloop/adapter-interfaces\n\nCozeLoop adapter interfaces\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides adapter interfaces definition.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/adapter-interfaces\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported type */ } from '@cozeloop/adapter-interfaces';\n\n// or\n\nimport { /* exported type */ } from '@cozeloop/adapter-interfaces/evaluate';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","frontend/packages/loop-components/biz-components/README.md":"# @cozeloop/upload-toolkit-adapter\n\nA utilities package for the Coze Loop ecosystem\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides utilities functionality. It includes api, evaluation.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/upload-toolkit-adapter\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@cozeloop/upload-toolkit-adapter';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Api\n- Evaluation\n\n## API Reference\n\nPlease refer to the TypeScript definitions for detailed API documentation.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","frontend/packages/loop-components/biz-config/README.md":"# @cozeloop/biz-config-adapter\n\nBiz config for CozeLoop\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides community features functionality. It serves as a core component in the Coze Loop ecosystem.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/biz-config-adapter\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported config */ } from '@cozeloop/biz-config-adapter';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Core functionality for Coze Loop\n- TypeScript support\n- Modern ES modules\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","frontend/packages/loop-components/biz-hooks/README.md":"# @cozeloop/biz-hooks-adapter\n\nBiz hooks for CozeLoop\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides community features functionality. It serves as a core component in the Coze Loop ecosystem.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/biz-hooks-adapter\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@cozeloop/biz-hooks-adapter';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Core functionality for Coze Loop\n- TypeScript support\n- Modern ES modules\n\n## API Reference\n\n### Exports\n\n- `useSpace`\n- `useUserInfo`\n- `useNavigateModule`\n- `useOpenWindow`\n- `useRouteInfo`\n- `useCozeLocation`\n- `useBenefit, type BenefitConfig`\n- `useFetchUserBenefit`\n- `useDemoSpace`\n\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","frontend/packages/loop-components/components-with-adapter/README.md":"# @cozeloop/components\n\ncommon components for cozeloop\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides ui component functionality. It serves as a core component in the Coze Loop ecosystem.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/components\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@cozeloop/components';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Core functionality for Coze Loop\n- TypeScript support\n- Modern ES modules\n\n## API Reference\n\n### Exports\n\n- `ColumnSelector, type ColumnItem`\n- `TooltipWhenDisabled`\n- `LoopTable`\n- `TableWithPagination,\n DEFAULT_PAGE_SIZE,\n PAGE_SIZE_OPTIONS,`\n- `PageError,\n PageLoading,\n PageNoAuth,\n PageNoContent,\n PageNotFound,`\n- `TableColActions`\n- `LoopTabs`\n- `LargeTxtRender`\n- `InputSlider`\n- `handleCopy, sleep`\n\n*And more...*\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- React\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","frontend/packages/loop-components/evaluate-components/README.md":"# @cozeloop/evaluate-components\n\n> Project template for react component with storybook.\n\n## Features\n\n- [x] eslint & ts\n- [x] esm bundle\n- [x] umd bundle\n- [x] storybook\n\n## Commands\n\n- init: `rush update`\n- dev: `npm run dev`\n- build: `npm run build`\n","frontend/packages/loop-components/prompt-components-v2/README.md":"# @cozeloop/prompt-components\n\nPrompt common components for cozeloop\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides ui component functionality. It includes editor, prompt.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/prompt-components\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@cozeloop/prompt-components';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Editor\n- Prompt\n\n## API Reference\n\n### Exports\n\n- `PromptBasicEditor,\n PromptBasicEditorProps,\n PromptBasicEditorRef,`\n- `PromptDiffEditor`\n- `PromptEditor,\n PromptEditorProps,\n PromptMessage,`\n- `PopoverModelConfigEditor`\n- `PopoverModelConfigEditorQuery`\n- `BasicModelConfigEditor`\n- `ModelSelectWithObject`\n- `DevLayout`\n- `PromptCreate`\n- `getPlaceholderErrorContent`\n\n*And more...*\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- React\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","frontend/packages/loop-components/prompt-components/README.md":"# @cozeloop/prompt-components\n\nPrompt common components for cozeloop\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides ui component functionality. It includes editor, prompt.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/prompt-components\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@cozeloop/prompt-components';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Editor\n- Prompt\n\n## API Reference\n\n### Exports\n\n- `PromptBasicEditor,\n PromptBasicEditorProps,\n PromptBasicEditorRef,`\n- `PromptDiffEditor`\n- `PromptEditor,\n PromptEditorProps,\n PromptMessage,`\n- `PopoverModelConfigEditor`\n- `PopoverModelConfigEditorQuery`\n- `BasicModelConfigEditor`\n- `ModelSelectWithObject`\n- `DevLayout`\n- `PromptCreate`\n- `getPlaceholderErrorContent`\n\n*And more...*\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- React\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","frontend/packages/loop-components/tag-components/README.md":"# @cozeloop/tag-components\n\n> Project template for react component with storybook.\n\n## Features\n\n- [x] eslint & ts\n- [x] esm bundle\n- [x] umd bundle\n- [x] storybook\n\n## Commands\n\n- init: `rush update`\n- dev: `npm run dev`\n- build: `npm run build`\n","frontend/packages/loop-config/rsbuild-config/README.md":"# @cozeloop/rsbuild-config\n\nRsbuild config for cozeloop\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides ui component functionality. It serves as a core component in the Coze Loop ecosystem.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/rsbuild-config\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@cozeloop/rsbuild-config';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Core functionality for Coze Loop\n- TypeScript support\n- Modern ES modules\n\n## API Reference\n\n### Exports\n\n- `createRsbuildConfig`\n\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","frontend/packages/loop-config/tailwind-config/README.md":"# @cozeloop/tailwind-config\n\nTailwind config\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides development tools functionality. It serves as a core component in the Coze Loop ecosystem.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/tailwind-config\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@cozeloop/tailwind-config';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Core functionality for Coze Loop\n- TypeScript support\n- Modern ES modules\n\n## API Reference\n\n### Exports\n\n- `tailwindcssConfig, createTailwindcssConfig`\n\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","frontend/packages/loop-config/tailwind-plugin/README.md":"# @cozeloop/tailwind-plugin\n\nA plugin system package for the Coze Loop ecosystem\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides plugin system functionality. It serves as a core component in the Coze Loop ecosystem.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/tailwind-plugin\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@cozeloop/tailwind-plugin';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Core functionality for Coze Loop\n- TypeScript support\n- Modern ES modules\n\n## API Reference\n\nPlease refer to the TypeScript definitions for detailed API documentation.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","frontend/packages/loop-modules/evaluate/README.md":"# @cozeloop/evaluate-components\n\n> Project template for react component with storybook.\n\n## Features\n\n- [x] eslint & ts\n- [x] esm bundle\n- [x] umd bundle\n- [x] storybook\n\n## Commands\n\n- init: `rush update`\n- dev: `npm run dev`\n- build: `npm run build`\n","frontend/packages/loop-pages/auth-pages/README.md":"# @cozeloop/auth-pages\n\nAuthentication and account management pages for CozeLoop.\n\n## Overview\n\nThis package provides authentication-related pages and components for the CozeLoop platform, including login pages, account settings, and user management interfaces. It's part of the CozeLoop monorepo and integrates with the platform's authentication system.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/auth-pages\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n#### Using the Auth App (Default Export)\n\n```typescript\nimport AuthApp from '@cozeloop/auth-pages';\nimport { BrowserRouter } from 'react-router-dom';\n\nfunction App() {\n return (\n \n \n \n );\n}\n```\n\nThe default export provides a complete auth application with routing:\n\n- `/login` - Login page\n- Automatic redirect to login for unmatched routes\n\n#### Using Individual Components\n\n```typescript\nimport { AccountSetting, SwitchLang } from '@cozeloop/auth-pages';\n\nfunction SettingsPage() {\n return (\n
\n \n \n
\n );\n}\n```\n\n## Features\n\n- **Login Flow**: Complete login page with authentication handling\n- **Account Settings**: User profile and account management interface\n- **Personal Access Token (PAT) Management**: Create, view, and manage API tokens\n- **User Information Panel**: Edit user profile, username, and account details\n- **Language Switching**: Multi-language support with language switcher component\n- **Responsive Auth Frame**: Consistent layout for authentication pages\n\n## Components\n\n### Main Exports\n\n- **`App` (default)**: Complete auth application with routing\n- **`AccountSetting`**: Account settings and management interface\n- **`SwitchLang`**: Language switcher component\n\n### Internal Components\n\n- `AuthFrame`: Layout wrapper for auth pages\n- `LoginPanel`: Login form component\n- `Logo`: CozeLoop logo component\n- `UserInfoPanel`: User profile management\n- `PATPanel`: Personal Access Token management\n\n## API Reference\n\n### Default Export: `App`\n\nA React component that provides the complete authentication application with built-in routing.\n\n### Named Exports\n\n#### `AccountSetting`\n\nComponent for managing user account settings, including:\n\n- User information editing\n- Personal Access Token (PAT) management\n- Account preferences\n\n#### `SwitchLang`\n\nLanguage switcher component for changing the application language.\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Dependencies\n\nThis package depends on:\n\n- `@cozeloop/account`: Account management functionality\n- `@cozeloop/api-schema`: API type definitions\n- `@cozeloop/i18n-adapter`: Internationalization support\n- `@cozeloop/stores`: State management\n- `@coze-arch/coze-design`: UI component library\n- `react-router-dom`: Routing functionality\n\n## Development\n\nThis package is built with:\n\n- TypeScript for type safety\n- React 18+ for UI components\n- React Router for navigation\n- Vitest for testing\n- ESLint for code quality\n- Coze Design System for UI components\n\n### Scripts\n\n```bash\n# Build the package\nnpm run build\n\n# Run linting\nnpm run lint\n\n# Run tests\nnpm run test\n\n# Run tests with coverage\nnpm run test:cov\n```\n\n## Contributing\n\nThis package is part of the CozeLoop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","frontend/packages/loop-pages/evaluate-pages/README.md":"# @cozeloop/evaluate-pages\n\nEvaluation and testing pages for CozeLoop platform, providing comprehensive experiment management, dataset handling, and evaluator configuration.\n\n## Overview\n\nThis package provides the complete evaluation system pages for the CozeLoop platform. It integrates evaluation workflows including dataset management, evaluator creation and configuration, and experiment execution and analysis. The package serves as the main entry point for the evaluation feature set in CozeLoop.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/evaluate-pages\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport EvaluateApp from '@cozeloop/evaluate-pages';\nimport { BrowserRouter } from 'react-router-dom';\n\nfunction App() {\n return (\n \n \n \n );\n}\n```\n\nThe app provides comprehensive routing for the evaluation workflow with automatic initialization of community evaluation configurations.\n\n## Features\n\n### Dataset Management (评测集)\n\n- **Dataset List**: Browse and manage all evaluation datasets\n- **Dataset Creation**: Create new datasets for evaluation\n- **Dataset Details**: View and edit dataset configurations and data\n\n### Evaluator Management (评估器)\n\n- **Evaluator List**: View all available evaluators\n- **LLM Evaluator Creation**: Create and configure LLM-based evaluators\n- **Code Evaluator Creation**: Create custom code-based evaluators\n- **Evaluator Details**: View and modify evaluator configurations\n\n### Experiment Management (实验)\n\n- **Experiment List**: Browse all experiments\n- **Experiment Creation**: Set up new evaluation experiments\n- **Experiment Details**: View experiment results and analytics\n- **Experiment Contrast**: Compare multiple experiments side-by-side\n\n## Routes\n\nThe application provides the following routes:\n\n### Datasets (评测集)\n\n- `/datasets` - Dataset list page\n- `/datasets/create` - Create new dataset\n- `/datasets/:id` - Dataset detail page\n\n### Evaluators (评估器)\n\n- `/evaluators` - Evaluator list page\n- `/evaluators/create/llm` - Create LLM evaluator\n- `/evaluators/create/llm/:id?` - Edit LLM evaluator\n- `/evaluators/create/code` - Create code evaluator\n- `/evaluators/create/code/:id?` - Edit code evaluator\n- `/evaluators/:id` - LLM evaluator detail page\n- `/evaluators/code/:id?` - Code evaluator detail page\n\n### Experiments (实验)\n\n- `/experiments` - Redirects to experiments list\n- `/experiments/list` - Experiment list page\n- `/experiments/create` - Create new experiment\n- `/experiments/:experimentID` - Experiment detail page\n- `/experiments/contrast` - Compare experiments\n\n## API Reference\n\n### Default Export\n\nThe package exports a single React component that provides the complete evaluation application with built-in routing and community configuration initialization.\n\n```typescript\nimport EvaluateApp from '@cozeloop/evaluate-pages';\n```\n\n### Configuration\n\nThe app automatically initializes community evaluation configurations using the `useEvaluateConfigCommunityInit` hook from `@cozeloop/evaluate`.\n\n## Dependencies\n\nThis package integrates with:\n\n- `@cozeloop/evaluate`: Core evaluation functionality and page components\n- `@cozeloop/evaluate-components`: UI components for evaluation features\n- `@cozeloop/i18n-adapter`: Internationalization support\n- `@cozeloop/toolkit`: Utility functions\n- `@cozeloop/biz-hooks-adapter`: Business logic hooks\n- `@coze-arch/coze-design`: UI component library\n- `react-router-dom`: Routing functionality\n\n## Development\n\nThis package is built with:\n\n- TypeScript for type safety\n- React 18+ for UI components\n- React Router for navigation\n- Vitest for testing\n- ESLint for code quality\n- Coze Design System for UI components\n\n### Scripts\n\n```bash\n# Build the package\nnpm run build\n\n# Run linting\nnpm run lint\n\n# Run tests\nnpm run test\n\n# Run tests with coverage\nnpm run test:cov\n```\n\n## Contributing\n\nThis package is part of the CozeLoop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","frontend/packages/loop-pages/observation-pages/README.md":"# @cozeloop/observation-pages\n\nObservability and tracing pages for CozeLoop platform, providing comprehensive trace monitoring, analysis, and debugging capabilities.\n\n## Overview\n\nThis package provides the observability system pages for the CozeLoop platform. It offers trace monitoring and analysis capabilities, allowing users to track, search, and debug application execution flows. The package integrates with the CozeLoop observation infrastructure to provide detailed insights into span execution, performance metrics, and trace data.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/observation-pages\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport ObservationApp from '@cozeloop/observation-pages';\nimport { BrowserRouter } from 'react-router-dom';\n\nfunction App() {\n return (\n \n \n \n );\n}\n```\n\nThe app provides comprehensive trace monitoring and analysis with automatic routing configuration.\n\n## Features\n\n### Trace Monitoring\n\n- **Trace List View**: Browse and search all traces with advanced filtering\n- **Trace Detail Panel**: Deep dive into individual trace execution flows\n- **Span Analysis**: Examine individual spans with detailed metrics\n- **Real-time Search**: Search traces by various criteria including trace ID, status, and custom fields\n- **Performance Metrics**: Track latency, tokens, and other performance indicators\n- **Multi-language Support**: Internationalization with Chinese and English locales\n\n### Key Capabilities\n\n- **Advanced Filtering**: Filter traces by platform type, date range, status, and custom fields\n- **Column Customization**: Configure visible columns including:\n - Status and trace/span identifiers\n - Input/output data\n - Token usage (input, output, total)\n - Latency metrics (total and first response)\n - Timestamps and metadata\n - Prompt keys and span information\n\n- **Trace Details**: View comprehensive trace information including:\n - Span hierarchy and relationships\n - Advanced trace information\n - Input/output data for each span\n - Performance metrics and timing data\n\n- **Custom Views**: User-configurable views with customizable columns and filters\n\n## Routes\n\nThe application provides the following routes:\n\n- `/` - Redirects to traces page\n- `/traces` - Main trace monitoring and analysis page\n\n## API Reference\n\n### Default Export\n\nThe package exports a single React component that provides the complete observation application with built-in routing.\n\n```typescript\nimport ObservationApp from '@cozeloop/observation-pages';\n```\n\n### Features Integration\n\nThe observation pages integrate with:\n\n- **Trace List Component**: `CozeloopTraceListWithDetailPanel` from `@cozeloop/observation-components`\n- **Field Metadata**: Dynamic field metadata fetching based on platform and span types\n- **API Integration**: Direct integration with `observabilityTrace` API for data fetching\n- **User Context**: Integration with workspace and user information\n\n### Configurable Columns\n\nThe following columns are available for trace viewing:\n\n- `status` - Trace execution status\n- `trace_id` - Unique trace identifier\n- `span_id` - Span identifier\n- `span_type` - Type of span\n- `span_name` - Name of the span\n- `input` - Input data\n- `output` - Output data\n- `tokens` - Total token count\n- `input_tokens` - Input token count\n- `output_tokens` - Output token count\n- `latency` - Total latency\n- `latency_first_resp` - First response latency\n- `start_time` - Execution start time\n- `prompt_key` - Associated prompt key\n- `logic_delete_date` - Logical deletion date\n\n## Dependencies\n\nThis package integrates with:\n\n- `@cozeloop/observation-components`: Core observation UI components and utilities\n- `@cozeloop/api-schema`: API type definitions and observation schemas\n- `@cozeloop/i18n-adapter`: Internationalization support\n- `@cozeloop/components`: Shared UI components (PrimaryPage, etc.)\n- `@cozeloop/biz-hooks-adapter`: Business logic hooks (workspace, user info)\n- `@cozeloop/guard`: Access control and permissions\n- `@coze-arch/coze-design`: UI component library\n- `react-router-dom`: Routing functionality\n\n## Development\n\nThis package is built with:\n\n- TypeScript for type safety\n- React 18+ for UI components\n- React Router for navigation\n- Vitest for testing\n- ESLint for code quality\n- Coze Design System for UI components\n\n### Scripts\n\n```bash\n# Build the package\nnpm run build\n\n# Run linting\nnpm run lint\n\n# Run tests\nnpm run test\n\n# Run tests with coverage\nnpm run test:cov\n```\n\n## Contributing\n\nThis package is part of the CozeLoop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","frontend/packages/loop-pages/prompt-pages/README.md":"# @cozeloop/prompt-pages\n\nPrompt engineering and management pages for CozeLoop platform, providing comprehensive prompt development, testing, and lifecycle management.\n\n## Overview\n\nThis package provides the prompt engineering (PE) system pages for the CozeLoop platform. It offers a complete workflow for creating, editing, testing, and managing prompts with integrated observability features. The package includes a prompt list view, development environment, and playground for experimentation.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/prompt-pages\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport PromptApp from '@cozeloop/prompt-pages';\nimport { BrowserRouter } from 'react-router-dom';\n\nfunction App() {\n return (\n \n \n \n );\n}\n```\n\nThe app provides comprehensive prompt engineering capabilities with automatic routing and lazy-loaded pages for optimal performance.\n\n## Features\n\n### Prompt List Management\n\n- **Prompt Library**: Browse and manage all prompts in your workspace\n- **Advanced Search**: Filter prompts by creator, name, tags, and other attributes\n- **Batch Operations**: Create, edit, copy, and delete prompts\n- **Permission Control**: Owner-based deletion permissions\n- **Quick Access**: Click to edit, Shift/Cmd/Ctrl+Click to open in new window\n- **Call Records**: Direct access to prompt execution traces via observation system\n\n### Prompt Development\n\n- **Interactive Editor**: Full-featured prompt development environment\n- **Version Management**: Track and manage prompt versions\n- **Model Integration**: Support for multiple LLM models\n- **Multi-modal Support**: Image input support with validation\n- **Real-time Testing**: Execute and test prompts with immediate feedback\n- **Trace Integration**: View execution traces and debug information\n- **Execute History**: Track execution history and results\n- **File Upload**: Support for file attachments in prompts\n\n### Prompt Playground\n\n- **Experimentation Environment**: Test prompts without saving\n- **Template Support**: Start from templates or scratch\n- **Quick Iteration**: Rapid testing and refinement\n- **Model Selection**: Choose from available models\n- **Save to Library**: Convert playground prompts to saved prompts\n\n### Observability Integration\n\n- **Execution Traces**: View detailed trace logs for each prompt execution\n- **Performance Metrics**: Track latency, tokens, and other metrics\n- **Debug Information**: Access detailed execution information\n- **Trace History Panel**: Browse historical executions\n- **Direct Links**: Navigate to full trace details in observation system\n\n## Routes\n\nThe application provides the following routes:\n\n- `/` - Redirects to prompts list\n- `/prompts` - Prompt list page (PE 列表)\n- `/prompts/:promptID` - Prompt development page\n- `/playground` - Prompt playground page\n\n## Components\n\n### Main Pages\n\n- **PromptListPage**: Browse and manage all prompts with CRUD operations\n- **PromptDevelopPage**: Full-featured prompt development environment\n- **PromptPlaygroundPage**: Experimental prompt testing environment\n\n### Custom Components\n\n- **ExecuteHistoryPanel**: Display execution history with filtering\n- **TraceTab**: Integrated trace viewing for prompt executions\n\n### Integrated Components\n\nFrom `@cozeloop/prompt-components-v2`:\n\n- `PromptList`: Configurable prompt list with search and filters\n- `PromptDevelop`: Complete prompt development UI\n- `PromptCreateModal`: Modal for creating/editing prompts\n- `PromptDeleteModal`: Confirmation modal for deletion\n\n## API Reference\n\n### Default Export\n\nThe package exports a single React component that provides the complete prompt engineering application with built-in routing.\n\n```typescript\nimport PromptApp from '@cozeloop/prompt-pages';\n```\n\n### Key Features\n\n- **Lazy Loading**: Pages are lazy-loaded for optimal performance\n- **Workspace Integration**: Automatic workspace context integration\n- **Model Management**: Dynamic model list loading per workspace\n- **Event Tracking**: Built-in analytics event reporting\n- **User Permissions**: Creator-based access control\n\n## Dependencies\n\nThis package integrates with:\n\n- `@cozeloop/prompt-components-v2`: Core prompt UI components and functionality\n- `@cozeloop/observation-components`: Trace viewing and observability features\n- `@cozeloop/observation-adapter`: Observability integration layer\n- `@cozeloop/biz-components-adapter`: Business components (UserSelect, file upload)\n- `@cozeloop/biz-hooks-adapter`: Business hooks (workspace, user, navigation, models)\n- `@cozeloop/components`: Shared UI components\n- `@cozeloop/hooks`: Utility hooks (modal, breadcrumb, refresh)\n- `@cozeloop/i18n-adapter`: Internationalization support\n- `@cozeloop/api-schema`: API type definitions\n- `@cozeloop/toolkit`: Utility functions\n- `@coze-arch/coze-design`: UI component library\n- `react-router-dom`: Routing functionality\n\n## Development\n\nThis package is built with:\n\n- TypeScript for type safety\n- React 18+ for UI components\n- React Router for navigation with lazy loading\n- Vitest for testing\n- ESLint for code quality\n- Coze Design System for UI components\n\n### Scripts\n\n```bash\n# Build the package (currently a no-op)\nnpm run build\n\n# Run linting\nnpm run lint\n\n# Run tests (currently a no-op)\nnpm run test\n\n# Run tests with coverage (currently a no-op)\nnpm run test:cov\n```\n\n## Contributing\n\nThis package is part of the CozeLoop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","frontend/packages/loop-pages/tag-pages/README.md":"# @cozeloop/tag-pages\n\nTag management pages for CozeLoop platform, providing tag organization, categorization, and CRUD operations.\n\n## Overview\n\nThis package provides the tag management system pages for the CozeLoop platform. It offers a complete workflow for creating, viewing, editing, and organizing tags to help categorize and manage resources within the workspace. The package includes a tag list view, detail pages, and creation interfaces.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/tag-pages\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport TagApp from '@cozeloop/tag-pages';\nimport { BrowserRouter } from 'react-router-dom';\n\nfunction App() {\n return (\n \n \n \n );\n}\n```\n\nThe app provides comprehensive tag management capabilities with automatic routing configuration.\n\n## Features\n\n### Tag Management\n\n- **Tag List View**: Browse and manage all tags in your workspace\n- **Tag Creation**: Create new tags with customizable properties\n- **Tag Details**: View and edit individual tag information\n- **Tag Organization**: Organize and categorize resources using tags\n- **Consistent Navigation**: Integrated breadcrumb and navigation system\n\n## Routes\n\nThe application provides the following routes:\n\n- `/` - Redirects to tag list\n- `/tag` - Tag list page (标签管理)\n- `/tag/create` - Create new tag page\n- `/tag/:tagId` - Tag detail and edit page\n\n**Note**: The actual complete route path is `tag/tag/*` due to the module base path prefix.\n\n## Components\n\n### Integrated Pages\n\nFrom `@cozeloop/tag-components`:\n\n- **TagsListPage**: Browse and manage all tags\n- **TagsCreatePage**: Create new tags\n- **TagsDetailPage**: View and edit tag details\n\n**Note**: Per the codebase TODO, page-level components are currently exported from `@cozeloop/tag-components` but should be moved to this package in future refactoring.\n\n## API Reference\n\n### Default Export\n\nThe package exports a single React component that provides the complete tag management application with built-in routing.\n\n```typescript\nimport TagApp from '@cozeloop/tag-pages';\n```\n\n### Route Configuration\n\nThe tag module uses a consistent route configuration:\n\n- **Module Base Path**: `tag`\n- **Tag List Path**: `tag/tag` (used for navigation and breadcrumbs)\n- All pages receive `tagListPagePath` prop for consistent navigation\n\n## Dependencies\n\nThis package integrates with:\n\n- `@cozeloop/tag-components`: Core tag UI components and page implementations\n- `react-router-dom`: Routing functionality\n\n### Development Dependencies\n\n- `@cozeloop/i18n-adapter`: Internationalization support\n- `@coze-arch/eslint-config`: ESLint configuration\n- `@coze-arch/ts-config`: TypeScript configuration\n- `@coze-arch/vitest-config`: Testing configuration\n\n## Development\n\nThis package is built with:\n\n- TypeScript for type safety\n- React 18+ for UI components\n- React Router for navigation\n- Vitest for testing\n- ESLint for code quality\n- Storybook for component development\n\n### Scripts\n\n```bash\n# Build the package\nnpm run build\n\n# Run Storybook development server\nnpm run dev\n\n# Run linting\nnpm run lint\n\n# Run tests\nnpm run test\n\n# Run tests with coverage\nnpm run test:cov\n```\n\n## Architecture Notes\n\nThis package currently serves as a routing wrapper around `@cozeloop/tag-components`. According to the codebase TODO, future refactoring should:\n\n- Move page-level components from `@cozeloop/tag-components` to this package\n- Keep only UI components in `@cozeloop/tag-components`\n- Improve separation of concerns between components and pages\n\n## Contributing\n\nThis package is part of the CozeLoop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n"},"files":{"AGENTS.md":"# AGENTS.md\n\nThis file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.\n\n> 开始任务前先通读本文件；涉及架构决策时读 `ARCHITECTURE.md`；进入具体模块时读模块代码。\n\n## 项目概要\n\nCoze Loop 是一个开源的 LLM 评测与可观测性平台，提供 Prompt 开发调试、评测（评测集 + 评估器 + 实验）、可观测性（Trace/Span）、模型集成（OpenAI / Volcengine Ark）等能力。采用 Go 后端（DDD 6 模块，Hertz + Kitex）+ TypeScript/React 前端（Rush.js 59 包）的多语言单体仓库架构，Thrift IDL 共享契约。\n\n## 文档体系\n\n| 层级 | 文件 | 职责 |\n|------|------|------|\n| L0 入口 | `AGENTS.md`（本文件） | 项目全貌、核心约束、导航 |\n| L1 架构 | `ARCHITECTURE.md` | 系统架构、代码地图、依赖关系、不变量 |\n| L1 专题 | `docs/AGENTS.md` | 中层索引，串联 reference/ 和 guidance/ |\n| L3 参考 | `docs/reference/backend-modules-api.md` | 后端 6 模块职责、分层、API 路由 |\n| L3 参考 | `docs/reference/frontend-packages.md` | 前端 59 包分层结构 |\n| L3 指南 | `docs/guidance/deployment-guide.md` | Docker Compose / Helm 部署 |\n| L3 指南 | `docs/guidance/idl-codegen-guide.md` | IDL 变更后代码生成流程 |\n\n## 导航表\n\n| 我想… | 去哪里 |\n|-------|--------|\n| 了解仓库整体架构和模块关系 | `ARCHITECTURE.md` |\n| 查找 docs 下的专题文档 | `docs/AGENTS.md` |\n| 了解后端 6 个 DDD 模块的职责和 API | `docs/reference/backend-modules-api.md` |\n| 了解前端 59 包的分层结构 | `docs/reference/frontend-packages.md` |\n| 部署 Coze Loop（Docker / Helm） | `docs/guidance/deployment-guide.md` |\n| 修改 IDL 后生成代码 | `docs/guidance/idl-codegen-guide.md` |\n| 修改数据库表结构 | 本文件「开发流程」→ Step 3-4 |\n| 添加新的 API 接口 | 本文件「开发流程」→ Step 1-2 → Step 6 |\n| 运行本地开发环境 | `make compose-up-dev` |\n| 了解错误码定义规范 | 本文件「开发流程」→ Step 7 |\n| 执行 lint 检查 | `cd backend && golangci-lint run --config ../.github/.golangci.yaml --fix` |\n\n## 仓库结构\n\n```\ncoze-loop/\n├── idl/thrift/coze/loop/ # Thrift IDL（前后端共享契约，同步源）\n│ ├── /domain/ # 开源领域实体\n│ ├── /domain_openapi/# OpenAPI 领域实体\n│ └── /coze.loop.*.thrift # 服务接口\n├── backend/\n│ ├── cmd/ # 服务入口（main.go HTTP, consumer.go MQ）\n│ ├── api/ # Hertz 网关层（生成 + handler）\n│ ├── modules/ # 6 个 DDD 业务模块\n│ │ ├── evaluation/ # 评测（实验 / 评估器 / 评测集）\n│ │ ├── observability/ # 可观测性（Trace / Span）\n│ │ ├── prompt/ # Prompt 管理\n│ │ ├── data/ # 数据管理（Dataset）\n│ │ ├── llm/ # LLM 模型集成\n│ │ └── foundation/ # 基础（用户 / 空间 / API Key）\n│ ├── infra/ # 共享基础设施（DB, Redis, ClickHouse, MQ, middleware）\n│ ├── pkg/ # 共享工具库\n│ ├── kitex_gen/ # Kitex 生成代码 ⚠️ 禁止手动修改\n│ ├── loop_gen/ # Loop 生成代码 ⚠️ 禁止手动修改\n│ └── script/ # 代码生成脚本\n│ ├── cloudwego/code_gen.sh # IDL → Go\n│ ├── gorm_gen/generate.go # SQL → GORM Model\n│ └── errorx/code_gen.py # 错误码生成\n├── frontend/ # Rush.js 前端 monorepo（59 包）\n│ ├── apps/cozeloop/ # 主 SPA（React 18, Rsbuild, react-router, zustand）\n│ ├── packages/ # loop-pages, loop-modules, loop-components, loop-base\n│ ├── config/ # eslint-config, ts-config, vitest-config 等\n│ └── infra/ # IDL 转 TypeScript 工具等\n├── release/deployment/\n│ ├── docker-compose/ # Docker 部署（conf/ + bootstrap/）\n│ └── helm-chart/ # Kubernetes 部署\n└── common/ # git-hooks（Rush 管理）\n```\n\n## 核心约束\n\n### 1. DDD 分层纪律\n\n每个 `backend/modules//` 遵循三层架构，依赖方向单向：\n\n```\napi/ → application/ → domain/ ← infra/\n```\n\n- **domain/** 定义接口，**infra/** 实现接口，domain **绝不**引用 infra\n- Application 层负责 DTO↔DO 转换、用例编排\n- Repository 的事务只在 infra 层启动\n\n### 2. IDL 优先\n\n`idl/thrift/` 是接口契约的同步源。商业化 IDL 仓库的 `open/` 目录从此处同步。修改 IDL 后必须运行代码生成。\n\n### 3. 生成代码不可手动修改\n\n- `backend/kitex_gen/` — Kitex 生成\n- `backend/loop_gen/` — Loop 本地调用生成\n- `backend/api/router_gen.go` — Hertz 路由生成\n- `**/wire_gen.go` — Wire DI 生成\n- `**/gorm_gen/**` — GORM 模型生成\n\n### 4. 向前兼容\n\n已有企业用户二开部署。IDL API / Domain 核心接口 / 配置文件 / 存储 Schema 均要求向前兼容。新增字段必须 optional，数据库只允许加列。\n\n### 5. SQL 双路径同步\n\n修改数据库表时，以下两个目录必须保持一致：\n- `release/deployment/docker-compose/bootstrap/mysql-init/`（Docker）\n- `release/deployment/helm-chart/charts/app/bootstrap/init/mysql/init-sql/`（Helm）\n\n修改表还需要在 `patch-sql/` 写 ALTER 语句。CI 会通过 `mysql-schema-check` 工作流校验两侧一致性。\n\n### 6. 前端依赖分层\n\n前端 6 层依赖结构（Level-1 到 Level-6），高层级只能依赖低层级，禁止反向依赖。商业版与开源版差异通过 Adapter 模式解耦（`adapter-interfaces/` → `*-adapter/` → `components-with-adapter/`）。\n\n## 后端开发流程\n\n```\nStep 1: IDL 定义 → Step 2: 代码生成 → Step 3: MySQL Schema → Step 4: GORM Gen\n→ Step 5: 配置文件 → Step 6: 业务代码 → Step 7: 错误码 → Step 8: 国际化\n→ Step 9: UT → Step 10: golint\n```\n\n详细步骤见 `docs/guidance/idl-codegen-guide.md`（Step 1-2）和 `docs/guidance/deployment-guide.md`（部署配置）。\n\n**Wire 依赖注入**：修改 `wire.go` 后运行 `wire generate` 重新生成 `wire_gen.go`。禁止手动编辑 `wire_gen.go`。\n\n**代码复用约束**：新增功能前必须先搜索 codebase 是否已有相同/类似实现，有则复用或扩展，不得新建重复文件。\n\n## 常用命令\n\n### 后端（Go）\n\n| 操作 | 命令 |\n|------|------|\n| Go 编译 | `cd backend && go build ./...` |\n| 全量测试 | `cd backend && go test -gcflags=\"all=-N -l\" ./...` |\n| 单测（指定包） | `cd backend && go test -gcflags=\"all=-N -l\" ./modules//...` |\n| 单测（指定函数） | `cd backend && go test -gcflags=\"all=-N -l\" -run TestFuncName ./modules//...` |\n| CI 级测试（含 race） | `cd backend && go test -gcflags=\"all=-N -l\" -race -v -coverprofile=coverage.out -coverpkg=./... ./...` |\n| golint 修复 | `cd backend && golangci-lint run --config ../.github/.golangci.yaml --fix` |\n| IDL 代码生成 | `bash backend/script/cloudwego/code_gen.sh` |\n| GORM 代码生成 | `cd backend && go run script/gorm_gen/generate.go` |\n| 错误码生成 | `backend/script/errorx/code_gen.py ` |\n\n### 前端（Rush.js + pnpm）\n\n| 操作 | 命令 |\n|------|------|\n| 安装依赖 | `node common/scripts/install-run-rush.js install` |\n| 全量构建 | `node common/scripts/install-run-rush.js rebuild --verbose` |\n| 开发服务器 | `cd frontend/apps/cozeloop && npm run dev` |\n| Lint | `cd frontend/apps/cozeloop && npm run lint` |\n| 测试 | `cd frontend/apps/cozeloop && npm run test` |\n| TypeScript 检查 | `cd frontend/apps/cozeloop && npm run build:ts` |\n\n### 部署\n\n| 操作 | 命令 |\n|------|------|\n| 本地 dev 部署 | `make compose-up-dev` |\n| 本地 debug 部署（含 Delve） | `make compose-up-debug` |\n| 停止 dev | `make compose-down-dev` |\n| 停止并清理 volumes | `make compose-down-v-dev` |\n| Helm 部署 | `make helm-up` |\n| 查看 Pod 状态 | `make helm-pod` |\n\n### PR 标题格式\n\nPR 标题必须符合 `[][] ` 格式，CI 会校验。\n\n- type: `feat`, `fix`, `docs`, `style`, `refactor`, `perf`, `test`, `chore`, `build`, `ci`\n- scope: `all`, `idl`, `frontend`, `backend`, `infra`, `workflow`, `prompt`, `evaluation`, `trace`, `model`, `tag`, `dataset`, `foundation`\n\n示例：`[feat][evaluation] add offline metric support`\n","docs/AGENTS.md":"# AGENTS.md\n\nThis file provides guidance to Claude Code (claude.ai/code) when working with docs in this repository.\n\n> 中层索引，串联 reference/（事实说明）和 guidance/（操作手册）。\n\n## 文件树\n\n```\ndocs/\n├── AGENTS.md ← 本文件\n├── reference/\n│ ├── backend-modules-api.md # 后端 6 模块职责、分层、API 路由\n│ └── frontend-packages.md # 前端 59 包分层结构\n└── guidance/\n ├── deployment-guide.md # Docker Compose / Helm 部署指南\n └── idl-codegen-guide.md # IDL 变更后代码生成完整流程\n```\n\n## 导航\n\n| 我想… | 文件 |\n|-------|------|\n| 了解后端某个模块的职责和 API 路由 | `reference/backend-modules-api.md` |\n| 了解前端包的分层和依赖关系 | `reference/frontend-packages.md` |\n| 部署 Coze Loop 到 Docker 或 K8s | `guidance/deployment-guide.md` |\n| 修改 IDL 后走完代码生成流程 | `guidance/idl-codegen-guide.md` |\n\n## 文档分类原则\n\n- **reference/**：事实说明——描述\"是什么\"，不随任务变化\n- **guidance/**：操作手册——描述\"怎么做\"，面向具体操作步骤\n","frontend/infra/plugins/pkg-root-webpack-plugin/README.md":"# @coze-arch/pkg-root-webpack-plugin\n\n> 用于支持 `@` 根目录引用的插件\n\n## Overview\n\nThis package is part of the Coze Studio monorepo and provides architecture functionality. It includes hook, plugin.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@coze-arch/pkg-root-webpack-plugin\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@coze-arch/pkg-root-webpack-plugin';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Hook\n- Plugin\n\n## API Reference\n\n### Exports\n\n- `default PkgRootWebpackPlugin;`\n- `PkgRootWebpackPlugin ;`\n\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Studio monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","frontend/infra/plugins/postcss-plugin/README.md":"# @coze-arch/postcss-plugin\n\nA postcss plugin to add namespace prefix for all css selector\n\n## Overview\n\nThis package is part of the Coze Studio monorepo and provides architecture functionality. It serves as a core component in the Coze Studio ecosystem.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@coze-arch/postcss-plugin\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@coze-arch/postcss-plugin';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Core functionality for Coze Studio\n- TypeScript support\n- Modern ES modules\n\n## API Reference\n\nPlease refer to the TypeScript definitions for detailed API documentation.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Studio monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","frontend/packages/loop-base/account/README.md":"# @cozeloop/account\n\nCozeLoop account\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides authentication functionality. It includes hook, store, service.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/account\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@cozeloop/account';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Hook\n- Store\n- Service\n\n## API Reference\n\n### Exports\n\n- `useUserStore, setUserInfo`\n- `useSpaceStore,\n setSpace,\n PERSONAL_ENTERPRISE_ID,`\n- `useLogin`\n- `useRegister`\n- `useLoginStatus`\n- `useLogout`\n- `useCheckLogin`\n- `userService`\n- `authnService`\n- `spaceService`\n\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","frontend/packages/loop-base/api-schema/README.md":"# @cozeloop/api-schema\n\nCoze Loop 的 API Schema 定义包。\n\n## 安装\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/api-schema\": \"workspace:*\"\n }\n}\n```\n\n```bash\nrush update\n```\n\n## 更新 API Schema\n\n当后端 API 发生变更时，运行以下命令更新：\n\n```bash\nrushx update\n```\n\n### 指定分支\n\n默认从 `main` 分支拉取 IDL 定义。如需从其他分支更新，可以修改 [package.json](./package.json) 中 `prethrift` 脚本的 `--branch` 参数：\n\n```json\n{\n \"scripts\": {\n \"prethrift\": \"bash ./scripts/download-thrift.sh --branch=your-branch\"\n }\n}\n```\n\n然后执行 `rushx update` 即可从指定分支拉取最新的 API Schema。\n\n## License\n\nApache-2.0\n","frontend/packages/loop-base/base-hooks/README.md":"# @cozeloop/hooks\n\nHooks for CozeLoop\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides community features functionality. It includes modal.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/hooks\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@cozeloop/hooks';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Modal\n\n## API Reference\n\n### Exports\n\n- `useRefresh`\n- `useModalData`\n- `useMouseDownOffset`\n- `useBreadcrumb`\n- `useNavbarCollapsed`\n\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","frontend/packages/loop-base/bot-env-adapter/README.md":"# @coze-studio/bot-env-adapter\n\n> Environment configuration adapter for bot applications with multi-region support\n\n## Project Overview\n\nThe `@coze-studio/bot-env-adapter` package provides a centralized environment configuration management system for bot applications. It consolidates environment variables, feature flags, and business configurations into a type-safe, region-aware adapter that supports different deployment environments (CN, SG, VA) and build types (local, online, offline, test).\n\nThis package was originally extracted from `apps/bot/env` to provide reusable environment configuration management across the bot ecosystem.\n\n## Features\n\n- **Multi-Region Support**: Configures environments for China (CN), Singapore (SG), and Virginia (VA) regions\n- **Environment-Aware Configuration**: Automatically selects appropriate configurations based on build type and region\n- **Type Safety**: Auto-generated TypeScript definitions ensure type safety across the application\n- **Feature Flags**: Centralized feature flag management for different environments and regions\n- **Business Configuration**: Environment-specific business settings and API configurations\n- **Build-Time Validation**: Validates required environment variables at build time\n\n## Get Started\n\n### Installation\n\nInstall the package in your workspace:\n\n```bash\n# Add to your package.json dependencies\n\"@coze-studio/bot-env-adapter\": \"workspace:*\"\n\n# Run rush update to install\nrush update\n```\n\n### Basic Usage\n\n```typescript\nimport { GLOBAL_ENVS } from '@coze-studio/bot-env-adapter';\n\n// Access environment variables\nconsole.log(GLOBAL_ENVS.REGION); // 'cn' | 'sg' | 'va'\nconsole.log(GLOBAL_ENVS.BUILD_TYPE); // 'local' | 'online' | 'offline' | 'test'\nconsole.log(GLOBAL_ENVS.BOT_BRAND_NAME); // Region-specific brand name\n\n// Access feature flags\nif (GLOBAL_ENVS.FEATURE_ENABLE_SSO) {\n // Enable SSO functionality\n}\n\n// Access business configurations\nconst appId = GLOBAL_ENVS.APP_ID;\nconst cdnUrl = GLOBAL_ENVS.CDN;\n```\n\n### Runtime Environment\n\n```typescript\nimport { runtimeEnv } from '@coze-studio/bot-env-adapter/runtime';\n\n// Access runtime environment information\nconsole.log(runtimeEnv.isPPE); // Production environment check\n```\n\n### Type Definitions\n\n```typescript\nimport type { TConfigEnv } from '@coze-studio/bot-env-adapter/typings';\n\n// Use predefined types for configuration\nconst myConfig: TConfigEnv = {\n cn: {\n boe: 'boe-value',\n inhouse: 'inhouse-value',\n release: 'release-value',\n },\n sg: {\n inhouse: 'sg-inhouse-value',\n release: 'sg-release-value',\n },\n va: {\n release: 'va-release-value',\n },\n};\n```\n\n## API Reference\n\n### Core Exports\n\n#### `GLOBAL_ENVS`\nThe main export containing all environment variables, feature flags, and configurations.\n\n```typescript\nimport { GLOBAL_ENVS } from '@coze-studio/bot-env-adapter';\n\n// Base environment variables\nGLOBAL_ENVS.BUILD_TYPE // Build environment type\nGLOBAL_ENVS.REGION // Deployment region\nGLOBAL_ENVS.NODE_ENV // Node environment\nGLOBAL_ENVS.CDN // CDN URL for current environment\n\n// Feature flags\nGLOBAL_ENVS.FEATURE_ENABLE_SSO // SSO feature toggle\nGLOBAL_ENVS.FEATURE_ENABLE_APP_GUIDE // App guide feature\nGLOBAL_ENVS.FEATURE_GOOGLE_LOGIN // Google login support\n\n// Business configurations\nGLOBAL_ENVS.APP_ID // Application ID\nGLOBAL_ENVS.BOT_BRAND_NAME // Brand name for current region\nGLOBAL_ENVS.GOOGLE_CLIENT_ID // Google OAuth client ID\n```\n\n#### `extractEnvValue(config: TConfigEnv): T`\nUtility function to extract environment-specific values based on current region and build type.\n\n```typescript\nimport { extractEnvValue } from '@coze-studio/bot-env-adapter';\n\nconst apiUrl = extractEnvValue({\n cn: {\n boe: 'https://api-boe.example.cn',\n inhouse: 'https://api-inhouse.example.cn',\n release: 'https://api.example.cn',\n },\n sg: {\n inhouse: 'https://api-inhouse.example.com',\n release: 'https://api.example.com',\n },\n va: {\n release: 'https://api-va.example.com',\n },\n});\n```\n\n### Configuration Structure\n\n#### Base Configuration (`base.ts`)\nContains fundamental environment variables and regional judgments:\n- Build type and version information\n- Regional flags (IS_OVERSEA, IS_CN_REGION, etc.)\n- CDN configurations\n- Development mode flags\n\n#### Feature Flags (`features.ts`)\nBoolean flags controlling feature availability:\n- Authentication features (SSO, Google login, etc.)\n- Regional feature differences\n- Version-specific feature toggles\n\n#### Business Configurations (`configs.ts`)\nEnvironment-specific business settings:\n- API keys and application IDs\n- External service configurations\n- Legal document URLs\n- Platform-specific settings\n\n### Type Definitions\n\nThe package automatically generates TypeScript definitions in `src/typings.d.ts` based on the environment configuration. These types are available for import:\n\n```typescript\n// Auto-generated types based on actual configuration\ndeclare const BUILD_TYPE: 'local' | 'online' | 'offline' | 'test';\ndeclare const REGION: 'cn' | 'sg' | 'va';\ndeclare const FEATURE_ENABLE_SSO: boolean;\n// ... and many more\n```\n\n## Development\n\n### Project Structure\n\n```\nsrc/\n├── index.ts # Main entry point, exports GLOBAL_ENVS\n├── base.ts # Base environment variables and regional flags\n├── features.ts # Feature flag configurations\n├── configs.ts # Business-specific configurations\n├── typings.d.ts # Auto-generated type definitions\n├── runtime/\n│ └── index.ts # Runtime environment utilities\n├── utils/\n│ ├── config-helper.ts # Configuration extraction utilities\n│ └── current-branch.ts # Git branch detection\n└── configs/\n └── volcano.ts # Volcano platform configurations\n```\n\n### Configuration Guidelines\n\nWhen adding new environment configurations, follow these conventions:\n\n1. **Use `extractEnvValue` for environment-specific values**:\n```typescript\nconst MY_CONFIG = extractEnvValue({\n cn: {\n boe: 'boe-value',\n inhouse: 'inhouse-value',\n release: 'release-value',\n },\n sg: {\n inhouse: 'sg-inhouse-value',\n release: 'sg-release-value',\n },\n va: {\n release: 'va-release-value',\n },\n});\n```\n\n2. **Ensure all environments are covered** to prevent configuration gaps\n3. **Update the `envs` object** in `src/index.ts` to include new configurations\n4. **Run the build script** to regenerate type definitions\n\n### Build Process\n\nThe package includes an automated TypeScript definition generator:\n\n```bash\nnpm run build\n```\n\nThis command:\n1. Analyzes the `envs` object in `src/index.ts`\n2. Generates type definitions in `src/typings.d.ts`\n3. Compiles TypeScript files\n\n### Environment Variables\n\nSet these environment variables to control the adapter behavior:\n\n- `BUILD_TYPE`: Build environment ('local' | 'online' | 'offline' | 'test')\n- `REGION`: Deployment region ('cn' | 'sg' | 'va')\n- `CUSTOM_VERSION`: Version type ('inhouse' | 'release')\n- `NODE_ENV`: Node environment ('development' | 'production' | 'test')\n- `VERBOSE`: Set to 'true' to log all environment values\n\n### Testing\n\n```bash\nnpm run test # Run tests\nnpm run test:cov # Run tests with coverage\nnpm run lint # Run linting\n```\n\n## Dependencies\n\n### Runtime Dependencies\nThis package has no runtime dependencies, making it lightweight and suitable for both client and server environments.\n\n### Development Dependencies\n- **@coze-arch/eslint-config**: Workspace ESLint configuration\n- **@coze-arch/ts-config**: Workspace TypeScript configuration\n- **@coze-arch/vitest-config**: Workspace Vitest configuration\n- **ts-morph**: TypeScript AST manipulation for type generation\n- **sucrase**: Fast TypeScript compiler for build scripts\n\n## License\n\nApache-2.0\n","frontend/packages/loop-base/bot-env/README.md":"# @coze-arch/bot-env\n\n> A TypeScript-based environment variable management system for the bot-studio monorepo, providing compile-time type safety and runtime environment configuration.\n\n## Features\n\n- 🔧 **Compile-time Environment Variables**: Access to environment variables with full TypeScript support\n- 🏗️ **Multi-environment Support**: Handles different deployment environments (BOE, production, development)\n- 🌍 **Multi-region Configuration**: Supports CN, SG, and VA regions with region-specific configurations\n- 🎯 **Feature Flags**: Built-in feature toggle system for conditional functionality\n- 📝 **Auto-generated Types**: Automatically generates TypeScript declarations from environment configuration\n- 🔒 **Type Safety**: Full TypeScript support with strict typing for all environment variables\n- ⚡ **Runtime Environment Access**: Provides runtime environment detection and configuration\n\n## Get Started\n\n### Installation\n\n```bash\n# Install the package\nrush add -p @coze-arch/bot-env\n\n# Update dependencies\nrush update\n```\n\n### Basic Usage\n\n```typescript\n// Import compile-time environment variables\nimport { GLOBAL_ENVS } from '@coze-arch/bot-env';\n\n// Access environment variables with full type safety\nconsole.log(GLOBAL_ENVS.REGION); // 'cn' | 'sg' | 'va'\nconsole.log(GLOBAL_ENVS.IS_PROD); // boolean\nconsole.log(GLOBAL_ENVS.BUILD_TYPE); // 'local' | 'online' | 'offline' | 'test'\n\n// Import runtime environment utilities\nimport { runtimeEnv } from '@coze-arch/bot-env/runtime';\n\n// Access runtime environment information\nconsole.log(runtimeEnv.isPPE); // boolean\n```\n\n### TypeScript Declarations\n\n```typescript\n// Import TypeScript declarations\n/// \n\n// All environment variables are available as global constants\ndeclare const REGION: 'cn' | 'sg' | 'va';\ndeclare const IS_PROD: boolean;\ndeclare const FEATURE_ENABLE_SSO: boolean;\n// ... and many more\n```\n\n## API Reference\n\n### GLOBAL_ENVS\n\nThe main export containing all environment variables organized by category:\n\n#### Base Environment Variables\n- `BUILD_TYPE`: Build environment type (`'local' | 'online' | 'offline' | 'test'`)\n- `CUSTOM_VERSION`: Version type (`'inhouse' | 'release'`)\n- `REGION`: Deployment region (`'cn' | 'sg' | 'va'`)\n- `NODE_ENV`: Node environment (`'production' | 'development' | 'test'`)\n- `IS_PROD`: Production environment flag\n- `IS_BOE`: BOE environment flag\n- `IS_OVERSEA`: Overseas deployment flag\n- `IS_RELEASE_VERSION`: Release version flag\n\n#### Feature Flags\n- `FEATURE_ENABLE_SSO`: Single Sign-On feature\n- `FEATURE_ENABLE_APP_GUIDE`: Application guide feature\n- `FEATURE_ENABLE_MSG_DEBUG`: Message debugging feature\n- `FEATURE_AWEME_LOGIN`: Aweme login integration\n- `FEATURE_GOOGLE_LOGIN`: Google login integration\n- And many more feature toggles...\n\n#### Configuration Variables\n- `CDN`: Content delivery network URL\n- `UPLOAD_CDN`: Upload CDN configuration\n- `COZE_DOMAIN`: Coze service domain\n- `APP_ID`: Application identifier\n- `APP_KEY`: Application key\n- Various service-specific configurations\n\n### Runtime Environment\n\n```typescript\nimport { runtimeEnv } from '@coze-arch/bot-env/runtime';\n\n// Runtime environment detection\nruntimeEnv.isPPE // boolean - Production-like environment detection\n```\n\n### Build Scripts\n\n```typescript\nimport { build } from '@coze-arch/bot-env/build';\n\n// Generate TypeScript declarations from environment configuration\nbuild();\n```\n\n## Development\n\n### Project Structure\n\n```\nsrc/\n├── index.ts # Main exports\n├── runtime/ # Runtime environment utilities\n├── typings.d.ts # Auto-generated TypeScript declarations\n└── global.d.ts # Global type definitions\n\nscripts/\n├── build.ts # Build script exports\n└── index.ts # Build script runner\n```\n\n### Environment Configuration\n\nThis package acts as a wrapper around `@coze-studio/bot-env-adapter`, which provides the actual environment configuration logic. The adapter package includes:\n\n- **Base configuration**: Core environment variables like region, build type, and deployment flags\n- **Feature flags**: Toggle switches for various application features\n- **Business configs**: Service-specific configuration values\n- **Configuration helpers**: Utilities for environment-specific value extraction\n\n### Auto-generated Types\n\nThe package automatically generates TypeScript declarations based on the environment configuration. The build process:\n\n1. Analyzes the `envs` object in the source code\n2. Extracts type information for each environment variable\n3. Generates corresponding TypeScript declarations\n4. Updates the `typings.d.ts` file with the latest types\n\n### Environment-specific Configuration\n\nUse the `extractEnvValue` utility for environment-specific configurations:\n\n```typescript\nconst API_ENDPOINT = extractEnvValue({\n cn: {\n boe: 'https://boe.api.example.com',\n inhouse: 'https://inhouse.api.example.com',\n release: 'https://api.example.com'\n },\n sg: {\n inhouse: 'https://sg-inhouse.api.example.com',\n release: 'https://sg.api.example.com'\n },\n va: {\n release: 'https://va.api.example.com'\n }\n});\n```\n\n### Running Tests\n\n```bash\n# Run tests\nrush test -t @coze-arch/bot-env\n\n# Run tests with coverage\nrush test:cov -t @coze-arch/bot-env\n```\n\n### Building\n\n```bash\n# Build the package\nrush build -t @coze-arch/bot-env\n\n# Generate type definitions\nrush build:types -t @coze-arch/bot-env\n```\n\n## Dependencies\n\n### Runtime Dependencies\n- `@coze-studio/bot-env-adapter`: Core environment configuration adapter\n\n### Development Dependencies\n- `@coze-arch/eslint-config`: ESLint configuration\n- `@coze-arch/ts-config`: TypeScript configuration\n- `@coze-arch/vitest-config`: Vitest testing configuration\n- `ts-morph`: TypeScript AST manipulation for type generation\n- `sucrase`: Fast TypeScript/JSX compiler\n- `vitest`: Testing framework\n\n## License\n\nApache-2.0 License - see package.json for details.\n\n---\n\nFor more information about environment configuration patterns and best practices, refer to the [bot-studio monorepo documentation](../../docs/).\n","frontend/packages/loop-base/bot-flags/README.md":"# @coze-arch/bot-flags\n\nfeature gating for bot studio\n\n## Overview\n\nThis package is part of the Coze Studio monorepo and provides architecture functionality. It serves as a core component in the Coze ecosystem.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@coze-arch/bot-flags\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@coze-arch/bot-flags';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Core functionality for Coze Studio\n- TypeScript support\n- Modern ES modules\n\n## API Reference\n\n### Exports\n\n- `type FEATURE_FLAGS, type FetchFeatureGatingFunction`\n- `getFlags`\n- `useFlags`\n- `pullFeatureFlags`\n\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Studio monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","frontend/packages/loop-base/bot-md-box-adapter/README.md":"# @coze-arch/bot-md-box-adapter\n\n> Project template for react component with storybook.\n\n## Features\n\n- [x] eslint & ts\n- [x] esm bundle\n- [x] umd bundle\n- [x] storybook\n\n## Commands\n\n- init: `rush update`\n- dev: `npm run dev`\n- build: `npm run build`\n","frontend/packages/loop-base/bot-typings/README.md":"# @coze-arch/bot-typings\n\nA comprehensive TypeScript type definitions package extracted from the bot application, providing essential type declarations for the Coze bot platform. This package centralizes common type definitions, interfaces, and module declarations to ensure type safety across the bot ecosystem.\n\n## Features\n\n- **Global Type Declarations**: Provides type definitions for various file formats (images, stylesheets, SVG)\n- **Common Utility Types**: Includes utility types like `Expand`, `PartialRequired`, and `Obj` for enhanced type manipulation\n- **Platform-Specific Types**: Defines interfaces for browser APIs, window objects, and navigator extensions\n- **User & Authentication Types**: Comprehensive type definitions for user data, authentication flows, and OAuth\n- **Teamspace & Routing Types**: Type definitions for dynamic routing parameters and teamspace functionality\n- **Zero Runtime Impact**: Pure TypeScript declarations with no runtime dependencies\n\n## Get Started\n\n### Installation\n\nInstall the package in your Rush.js monorepo:\n\n```bash\n# Add to your package.json\n\"@coze-arch/bot-typings\": \"workspace:*\"\n\n# Run Rush update to install\nrush update\n```\n\n### Basic Usage\n\nImport the main type definitions:\n\n```typescript\n// Import the main type definitions\nimport \"@coze-arch/bot-typings\";\n\n// Import specific modules\nimport { BotPageFromEnum, Obj, Expand, PartialRequired } from \"@coze-arch/bot-typings/common\";\nimport { DynamicParams } from \"@coze-arch/bot-typings/teamspace\";\n```\n\n## API Reference\n\n### Common Types\n\n#### `BotPageFromEnum`\nDefines the source of bot detail pages:\n\n```typescript\nenum BotPageFromEnum {\n Bot = 'bot', // Bot list\n Explore = 'explore', // Explore list\n Store = 'store',\n Template = 'template',\n}\n```\n\n#### Utility Types\n\n**`Obj`** - Generic object type:\n```typescript\ntype Obj = Record;\n```\n\n**`Expand`** - Expands intersection types for better readability:\n```typescript\ntype Intersection = { a: string } & { b: number };\ntype Result = Expand;\n// Result: { a: string; b: number }\n```\n\n**`PartialRequired`** - Makes specific fields required:\n```typescript\ninterface Agent {\n id?: string;\n name?: string;\n desc?: string;\n}\ntype Result = PartialRequired;\n// Result: { id: string; name: string; desc?: string }\n```\n\n### Teamspace Types\n\n#### `DynamicParams`\nDefines route parameters for teamspace navigation:\n\n```typescript\ninterface DynamicParams extends Record {\n space_id?: string;\n bot_id?: string;\n plugin_id?: string;\n workflow_id?: string;\n dataset_id?: string;\n doc_id?: string;\n tool_id?: string;\n invite_key?: string;\n product_id?: string;\n mock_set_id?: string;\n conversation_id: string; // Required\n commit_version?: string;\n scene_id?: string;\n post_id?: string;\n project_id?: string;\n}\n```\n\n### User & Authentication Types\n\nThe package provides comprehensive types under the `DataItem` namespace:\n\n#### `UserInfo`\nComplete user information interface:\n```typescript\ninterface UserInfo {\n user_id_str: string;\n name: string;\n screen_name: string;\n avatar_url: string;\n email?: string;\n // ... many more fields\n}\n```\n\n#### Authentication Types\n- `AuthLoginParams` - OAuth login parameters\n- `AuthorizeResponse` - Authorization response structure\n- `SendCodeData` - Verification code response\n- `UserCheckResponse` - User validation response\n\n### Global Module Declarations\n\nThe package automatically provides type declarations for:\n\n**Image Files:**\n```typescript\n// .jpeg, .jpg, .webp, .gif, .png files\nimport myImage from './image.png'; // string\n```\n\n**Stylesheets:**\n```typescript\n// .less, .css files\nimport styles from './styles.less'; // { [key: string]: string }\n```\n\n**SVG Files:**\n```typescript\n// .svg files\nimport { ReactComponent } from './icon.svg'; // React.FunctionComponent\nimport icon from './icon.svg'; // any (depends on svgDefaultExport config)\n```\n\n### Browser API Extensions\n\n**Window Interface Extensions:**\n```typescript\n// IDE plugin support\nwindow.editorDispose?.();\n\n// Mini-program integration\nwindow.tt?.miniProgram.postMessage({ data: {...} });\n\n// Coze app integration\nwindow.__cozeapp__?.setLoading?.(true);\n```\n\n**Navigator Extensions:**\n```typescript\n// Standalone app detection\nif (navigator.standalone) {\n // Running as standalone web app\n}\n```\n\n## Development\n\n### Project Structure\n\n```\nsrc/\n├── index.d.ts # Main type definitions and module declarations\n├── common.ts # Common utility types and enums\n├── teamspace.ts # Teamspace-related type definitions\n├── data_item.d.ts # User and authentication type definitions\n├── navigator.d.ts # Navigator API extensions\n└── window.d.ts # Window object extensions\n```\n\n### Building\n\nThis package contains only TypeScript declarations and requires no build step:\n\n```bash\nnpm run build # No-op (exits with code 0)\n```\n\n### Linting\n\n```bash\nnpm run lint\n```\n\n### Adding New Types\n\n1. **Module Declarations**: Add to `index.d.ts`\n2. **Common Utilities**: Add to `common.ts`\n3. **Domain-Specific Types**: Create new files and export from appropriate entry points\n4. **Global Extensions**: Add to `window.d.ts` or `navigator.d.ts`\n\nRemember to update the `exports` field in `package.json` for new modules.\n\n## Dependencies\n\n### Runtime Dependencies\nNone - this package contains only TypeScript type definitions.\n\n### Development Dependencies\n- **@coze-arch/bot-env**: Workspace package providing environment-specific typings\n- **@coze-arch/eslint-config**: Shared ESLint configuration\n- **@coze-arch/ts-config**: Shared TypeScript configuration\n- **TypeScript 5.8.2**: Core TypeScript compiler\n- **React Types**: For component and SVG type definitions\n\n## License\n\nApache-2.0\n\n---\n\n**Author**: fanwenjie.fe@bytedance.com\n\nThis package is part of the Coze bot platform architecture and provides essential type safety for bot development workflows.\n","frontend/packages/loop-base/components/README.md":"# @cozeloop/components\n\ncommon components for cozeloop\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides ui component functionality. It serves as a core component in the Coze Loop ecosystem.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/components\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@cozeloop/components';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Core functionality for Coze Loop\n- TypeScript support\n- Modern ES modules\n\n## API Reference\n\n### Exports\n\n- `ColumnSelector, type ColumnItem`\n- `TooltipWhenDisabled`\n- `LoopTable`\n- `TableWithPagination,\n DEFAULT_PAGE_SIZE,\n PAGE_SIZE_OPTIONS,`\n- `PageError,\n PageLoading,\n PageNoAuth,\n PageNoContent,\n PageNotFound,`\n- `TableColActions`\n- `LoopTabs`\n- `LargeTxtRender`\n- `InputSlider`\n- `handleCopy, sleep`\n\n*And more...*\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- React\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","frontend/packages/loop-base/env/README.md":"# @cozeloop/env-adapter\n\nA community features package for the Coze Loop ecosystem\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides community features functionality. It serves as a core component in the Coze Loop ecosystem.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/env-adapter\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@cozeloop/env-adapter';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Core functionality for Coze Loop\n- TypeScript support\n- Modern ES modules\n\n## API Reference\n\n### Exports\n\n- `const envs = new Env();`\n\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","frontend/packages/loop-base/fetch-stream/README.md":"# @coze-arch/fetch-stream\n\nfetch stream vanilla js\n\n## Overview\n\nThis package is part of the Coze Studio monorepo and provides api & networking functionality. It serves as a core component in the Coze ecosystem.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@coze-arch/fetch-stream\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@coze-arch/fetch-stream';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Core functionality for Coze Studio\n- TypeScript support\n- Modern ES modules\n\n## API Reference\n\n### Exports\n\n- `isFetchStreamErrorInfo,\n fetchStream,\n FetchStreamErrorCode,\n type FetchSteamConfig,\n type FetchStreamErrorInfo,`\n\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Studio monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","frontend/packages/loop-base/guard/README.md":"# @cozeloop/guard\n\nCozeloop 权限守卫组件，用于管理和控制用户界面中的权限点。\n\n## 安装\n\n```bash\npnpm add @cozeloop/guard\n```\n\n## 特性\n\n- 支持多种权限控制方式（隐藏、只读、拦截等）\n- 提供上下文管理权限状态\n- 支持路由级别的权限控制\n- 可扩展的权限点定义\n\n## 使用方法\n\n### 基础使用\n\n```tsx\nimport { Guard, GuardPoint } from '@cozeloop/guard';\n\nfunction MyComponent() {\n return (\n \n \n \n );\n}\n```\n\n### 路由权限控制\n\n```tsx\nimport { GuardRoute, GuardPoint } from '@cozeloop/guard';\n\nfunction ProtectedRoute() {\n return (\n \n
受保护的内容
\n \n );\n}\n```\n\n### 权限上下文\n\n```tsx\nimport { GuardProvider } from '@cozeloop/guard';\n\nfunction App() {\n // 自定义权限策略\n const customStrategy = {\n // 实现 GuardStrategy 接口\n };\n\n return (\n \n \n \n );\n}\n```\n\n## Features\n\n- [x] eslint & ts\n- [x] esm bundle\n- [x] umd bundle\n- [x] storybook\n\n## Commands\n\n- init: `rush update`\n- dev: `npm run dev`\n- build: `npm run build`\n","frontend/packages/loop-base/intl/README.md":"# @cozeloop/intl\n\nInternationalization(intl) runtime for CozeLoop\n","frontend/packages/loop-base/logger/README.md":"# @coze-arch/logger\n\nA comprehensive logging and error reporting library for the Coze architecture ecosystem, providing unified console logging, React error boundaries, and performance tracing capabilities.\n\n## Features\n\n- **Unified Logging Interface**: Centralized logging with support for multiple log levels (info, success, warning, error, fatal)\n- **Console Logging**: Console output for debugging and development\n- **React Error Boundaries**: Ready-to-use error boundary components with automatic error reporting\n- **Performance Tracing**: Duration tracking for multi-step operations and workflows\n- **Context-Aware Logging**: Namespace and scope-based log organization\n- **TypeScript Support**: Full TypeScript definitions and type safety\n- **Pending Queue System**: Queues logs when reporter is not initialized, executes when ready\n- **Console Control**: Configurable console output for different environments\n\n## Get Started\n\n### Installation\n\n```bash\n# Add to your Rush.js workspace\nrush add -p @coze-arch/logger --dev\n\n# Update dependencies\nrush update\n```\n\n### Basic Usage\n\n#### Console Logging\n\n```typescript\nimport { logger } from '@coze-arch/logger';\n\n// Simple string messages\nlogger.info('Operation completed successfully');\nlogger.warning('This is a warning message');\nlogger.error({ message: 'Something went wrong', error: new Error('Details') });\n\n// With context and metadata\nlogger.info({\n message: 'User action completed',\n namespace: 'user-management',\n scope: 'profile-update',\n meta: {\n userId: '12345',\n action: 'profile_update',\n duration: 150\n }\n});\n```\n\n#### Event Reporting\n\n```typescript\nimport { reporter } from '@coze-arch/logger';\n\n// Initialize reporter\nreporter.init();\n\n// Log custom events\nreporter.event({\n eventName: 'user_action',\n namespace: 'analytics',\n meta: {\n action: 'button_click',\n component: 'header'\n }\n});\n\n// Report errors\nreporter.error({\n message: 'API request failed',\n error: new Error('Network timeout'),\n namespace: 'api',\n scope: 'user-service'\n});\n```\n\n## API Reference\n\n### Logger\n\nThe main logger instance for console output and basic logging.\n\n```typescript\nimport { logger, Logger } from '@coze-arch/logger';\n\n// Create custom logger with preset context\nconst apiLogger = logger.createLoggerWith({\n ctx: {\n namespace: 'api',\n scope: 'user-service'\n }\n});\n\n// Available log levels\nlogger.info(message | options);\nlogger.success(message | options);\nlogger.warning(message | options);\nlogger.error(options); // requires error object\n\n// Setup configuration\nlogger.setup({ 'no-console': true }); // Disable console output\n```\n\n### Reporter\n\nHandles event reporting and structured logging.\n\n```typescript\nimport { reporter, Reporter } from '@coze-arch/logger';\n\n// Initialize reporter\nreporter.init();\n\n// Create reporter with preset context\nconst moduleReporter = reporter.createReporterWithPreset({\n namespace: 'auth',\n scope: 'login',\n meta: { version: '1.0.0' }\n});\n\n// Custom logs\nreporter.info({ message: 'Info log', meta: { key: 'value' } });\nreporter.warning({ message: 'Warning log' });\nreporter.error({ message: 'Error log', error: new Error() });\n\n// Custom events\nreporter.event({ eventName: 'user_login' });\nreporter.successEvent({ eventName: 'operation_complete' });\nreporter.errorEvent({ eventName: 'login_failed', error: new Error() });\n```\n\n### Performance Tracing\n\nTrack duration across multiple steps in a workflow.\n\n```typescript\nimport { reporter } from '@coze-arch/logger';\n\n// Create tracer for a specific event\nconst { trace } = reporter.tracer({ eventName: 'api_request' });\n\n// Track steps with automatic duration calculation\ntrace('start');\n// ... some operation\ntrace('validation_complete');\n// ... more operations\ntrace('request_sent');\n// ... final operations\ntrace('success', {\n meta: { responseSize: 1024 }\n});\n\n// Handle errors in tracing\ntrace('error', {\n error: new Error('Request failed'),\n meta: { statusCode: 500 }\n});\n```\n\n### Error Boundary\n\nReact component for catching and reporting JavaScript errors.\n\n```typescript\nimport { ErrorBoundary } from '@coze-arch/logger';\n\nfunction App() {\n return (\n {\n console.log('Error caught:', error);\n }}\n onReset={() => {\n // Reset app state\n }}\n >\n \n \n );\n}\n\nfunction ErrorFallback({ error, resetErrorBoundary }) {\n return (\n
\n

Something went wrong:

\n 
{error.message}
\n \n
\n );\n}\n```\n\n### Error Boundary Hooks\n\n```typescript\nimport { useErrorBoundary, useErrorHandler } from '@coze-arch/logger';\n\nfunction ComponentWithErrorHandling() {\n const { showBoundary } = useErrorBoundary();\n const handleError = useErrorHandler();\n\n const handleAsyncOperation = async () => {\n try {\n await riskyOperation();\n } catch (error) {\n // Report to error boundary\n showBoundary(error);\n // Or handle manually\n handleError(error);\n }\n };\n}\n```\n\n### Logger Context\n\nProvide logger instances through React context.\n\n```typescript\nimport { LoggerContext, useLogger } from '@coze-arch/logger';\n\n// Provider\nfunction App() {\n const logger = new Logger({\n ctx: { namespace: 'app' }\n });\n\n return (\n \n \n \n );\n}\n\n// Consumer\nfunction Component() {\n const logger = useLogger();\n\n logger.info('Component mounted');\n}\n```\n\n### Types and Interfaces\n\n```typescript\nimport type {\n LogLevel,\n CommonLogOptions,\n CustomLog,\n CustomErrorLog,\n CustomEvent,\n ErrorEvent,\n LoggerCommonProperties\n} from '@coze-arch/logger';\n\n// Log levels\nenum LogLevel {\n INFO = 'info',\n SUCCESS = 'success',\n WARNING = 'warning',\n ERROR = 'error',\n FATAL = 'fatal'\n}\n\n// Common log options interface\ninterface CommonLogOptions {\n namespace?: string;\n scope?: string;\n level?: LogLevel;\n action?: LogAction[];\n message?: string;\n eventName?: string;\n meta?: Record;\n error?: Error;\n}\n```\n\n## Development\n\n### Running Tests\n\n```bash\n# Run all tests\nrush test\n\n# Run tests with coverage\nrush test:cov\n\n# Run tests for this package only\ncd packages/arch/logger\nrushx test\n```\n\n### Linting\n\n```bash\n# Lint the package\nrushx lint\n\n# Auto-fix linting issues\nrushx lint --fix\n```\n\n### Building\n\n```bash\n# Build the package\nrushx build\n\n# Type checking\nrushx ts-check\n```\n\n## Dependencies\n\n### Production Dependencies\n\n- **@coze-arch/bot-env**: Environment configuration utilities\n- **@coze-arch/bot-typings**: Shared type definitions\n- **lodash-es**: Utility functions library\n- **react**: React library for error boundary components\n- **react-error-boundary**: React error boundary utilities\n\n### Development Dependencies\n\n- **@coze-arch/eslint-config**: Shared ESLint configuration\n- **@coze-arch/ts-config**: Shared TypeScript configuration\n- **@coze-arch/vitest-config**: Shared Vitest configuration\n- **@types/lodash-es**: TypeScript definitions for lodash-es\n- **@types/react**: TypeScript definitions for React\n- **vitest**: Testing framework\n\n## License\n\nThis package is part of the Coze architecture ecosystem and follows the project's licensing terms.\n","frontend/packages/loop-base/loop-lng/README.md":"# @cozeloop/loop-lng\n\nLanguage data of Cozeloop.\n\n## Overview\n\nThis package is part of the Coze Studio monorepo and provides architecture functionality. It serves as a core component in the Coze Studio ecosystem.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/loop-lng\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport {} from /* exported functions/components */ '@cozeloop/loop-lng';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Core functionality for Coze Studio\n- TypeScript support\n- Modern ES modules\n\n## API Reference\n\n### Exports\n\n- `localeEn, localeZhCN`\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Studio monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","frontend/packages/loop-base/route/README.md":"# @cozeloop/biz-hooks-adapter\n\nBiz hooks for CozeLoop\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides community features functionality. It serves as a core component in the Coze Loop ecosystem.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/biz-hooks-adapter\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@cozeloop/biz-hooks-adapter';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Core functionality for Coze Loop\n- TypeScript support\n- Modern ES modules\n\n## API Reference\n\n### Exports\n\n- `useSpace`\n- `useUserInfo`\n- `useNavigateModule`\n- `useOpenWindow`\n- `useRouteInfo`\n- `useCozeLocation`\n- `useBenefit, type BenefitConfig`\n- `useFetchUserBenefit`\n- `useDemoSpace`\n\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","frontend/packages/loop-base/stores/README.md":"# @cozeloop/stores\n\nStores For Devops\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides state management functionality. It includes store.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/stores\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@cozeloop/stores';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Store\n\n## API Reference\n\n### Exports\n\n- `useUIStore, UIEvent`\n- `type BreadcrumbItemConfig`\n\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","frontend/packages/loop-base/tea/README.md":"# @cozeloop/tea-adapter\n\nA community features package for the Coze Loop ecosystem\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides community features functionality. It serves as a core component in the Coze Loop ecosystem.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/tea-adapter\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@cozeloop/tea-adapter';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Core functionality for Coze Loop\n- TypeScript support\n- Modern ES modules\n\n## API Reference\n\n### Exports\n\n- `start, init, config, stop, sendEvent, isStarted`\n- `type ParamsTypeDefine = Record>;`\n\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","frontend/packages/loop-base/toolkit/README.md":"# @cozeloop/toolkit\n\nToolkit For Devops\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides utilities functionality. It serves as a core component in the Coze Loop ecosystem.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/toolkit\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@cozeloop/toolkit';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Core functionality for Coze Loop\n- TypeScript support\n- Modern ES modules\n\n## API Reference\n\n### Exports\n\n- `notEmpty`\n- `getSafeFileName`\n- `formatTimestampToString,\n safeParseJson,\n formateMsToSeconds,`\n- `CozeLoopStorage`\n- `type LocalStorageKeys`\n- `formatNumberWithCommas,\n formatNumberInThousands,\n formatNumberInMillions,`\n- `safeJsonParse`\n- `fileDownload`\n\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","frontend/packages/loop-components/adapter-interfaces/README.md":"# @cozeloop/adapter-interfaces\n\nCozeLoop adapter interfaces\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides adapter interfaces definition.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/adapter-interfaces\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported type */ } from '@cozeloop/adapter-interfaces';\n\n// or\n\nimport { /* exported type */ } from '@cozeloop/adapter-interfaces/evaluate';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","frontend/packages/loop-components/biz-components/README.md":"# @cozeloop/upload-toolkit-adapter\n\nA utilities package for the Coze Loop ecosystem\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides utilities functionality. It includes api, evaluation.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/upload-toolkit-adapter\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@cozeloop/upload-toolkit-adapter';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Api\n- Evaluation\n\n## API Reference\n\nPlease refer to the TypeScript definitions for detailed API documentation.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","frontend/packages/loop-components/biz-config/README.md":"# @cozeloop/biz-config-adapter\n\nBiz config for CozeLoop\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides community features functionality. It serves as a core component in the Coze Loop ecosystem.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/biz-config-adapter\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported config */ } from '@cozeloop/biz-config-adapter';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Core functionality for Coze Loop\n- TypeScript support\n- Modern ES modules\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","frontend/packages/loop-components/biz-hooks/README.md":"# @cozeloop/biz-hooks-adapter\n\nBiz hooks for CozeLoop\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides community features functionality. It serves as a core component in the Coze Loop ecosystem.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/biz-hooks-adapter\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@cozeloop/biz-hooks-adapter';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Core functionality for Coze Loop\n- TypeScript support\n- Modern ES modules\n\n## API Reference\n\n### Exports\n\n- `useSpace`\n- `useUserInfo`\n- `useNavigateModule`\n- `useOpenWindow`\n- `useRouteInfo`\n- `useCozeLocation`\n- `useBenefit, type BenefitConfig`\n- `useFetchUserBenefit`\n- `useDemoSpace`\n\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","frontend/packages/loop-components/components-with-adapter/README.md":"# @cozeloop/components\n\ncommon components for cozeloop\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides ui component functionality. It serves as a core component in the Coze Loop ecosystem.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/components\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@cozeloop/components';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Core functionality for Coze Loop\n- TypeScript support\n- Modern ES modules\n\n## API Reference\n\n### Exports\n\n- `ColumnSelector, type ColumnItem`\n- `TooltipWhenDisabled`\n- `LoopTable`\n- `TableWithPagination,\n DEFAULT_PAGE_SIZE,\n PAGE_SIZE_OPTIONS,`\n- `PageError,\n PageLoading,\n PageNoAuth,\n PageNoContent,\n PageNotFound,`\n- `TableColActions`\n- `LoopTabs`\n- `LargeTxtRender`\n- `InputSlider`\n- `handleCopy, sleep`\n\n*And more...*\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- React\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","frontend/packages/loop-components/evaluate-components/README.md":"# @cozeloop/evaluate-components\n\n> Project template for react component with storybook.\n\n## Features\n\n- [x] eslint & ts\n- [x] esm bundle\n- [x] umd bundle\n- [x] storybook\n\n## Commands\n\n- init: `rush update`\n- dev: `npm run dev`\n- build: `npm run build`\n","frontend/packages/loop-components/prompt-components-v2/README.md":"# @cozeloop/prompt-components\n\nPrompt common components for cozeloop\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides ui component functionality. It includes editor, prompt.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/prompt-components\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@cozeloop/prompt-components';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Editor\n- Prompt\n\n## API Reference\n\n### Exports\n\n- `PromptBasicEditor,\n PromptBasicEditorProps,\n PromptBasicEditorRef,`\n- `PromptDiffEditor`\n- `PromptEditor,\n PromptEditorProps,\n PromptMessage,`\n- `PopoverModelConfigEditor`\n- `PopoverModelConfigEditorQuery`\n- `BasicModelConfigEditor`\n- `ModelSelectWithObject`\n- `DevLayout`\n- `PromptCreate`\n- `getPlaceholderErrorContent`\n\n*And more...*\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- React\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","frontend/packages/loop-components/prompt-components/README.md":"# @cozeloop/prompt-components\n\nPrompt common components for cozeloop\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides ui component functionality. It includes editor, prompt.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/prompt-components\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@cozeloop/prompt-components';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Editor\n- Prompt\n\n## API Reference\n\n### Exports\n\n- `PromptBasicEditor,\n PromptBasicEditorProps,\n PromptBasicEditorRef,`\n- `PromptDiffEditor`\n- `PromptEditor,\n PromptEditorProps,\n PromptMessage,`\n- `PopoverModelConfigEditor`\n- `PopoverModelConfigEditorQuery`\n- `BasicModelConfigEditor`\n- `ModelSelectWithObject`\n- `DevLayout`\n- `PromptCreate`\n- `getPlaceholderErrorContent`\n\n*And more...*\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- React\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","frontend/packages/loop-components/tag-components/README.md":"# @cozeloop/tag-components\n\n> Project template for react component with storybook.\n\n## Features\n\n- [x] eslint & ts\n- [x] esm bundle\n- [x] umd bundle\n- [x] storybook\n\n## Commands\n\n- init: `rush update`\n- dev: `npm run dev`\n- build: `npm run build`\n","frontend/packages/loop-config/rsbuild-config/README.md":"# @cozeloop/rsbuild-config\n\nRsbuild config for cozeloop\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides ui component functionality. It serves as a core component in the Coze Loop ecosystem.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/rsbuild-config\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@cozeloop/rsbuild-config';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Core functionality for Coze Loop\n- TypeScript support\n- Modern ES modules\n\n## API Reference\n\n### Exports\n\n- `createRsbuildConfig`\n\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","frontend/packages/loop-config/tailwind-config/README.md":"# @cozeloop/tailwind-config\n\nTailwind config\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides development tools functionality. It serves as a core component in the Coze Loop ecosystem.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/tailwind-config\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@cozeloop/tailwind-config';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Core functionality for Coze Loop\n- TypeScript support\n- Modern ES modules\n\n## API Reference\n\n### Exports\n\n- `tailwindcssConfig, createTailwindcssConfig`\n\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","frontend/packages/loop-config/tailwind-plugin/README.md":"# @cozeloop/tailwind-plugin\n\nA plugin system package for the Coze Loop ecosystem\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides plugin system functionality. It serves as a core component in the Coze Loop ecosystem.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/tailwind-plugin\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@cozeloop/tailwind-plugin';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Core functionality for Coze Loop\n- TypeScript support\n- Modern ES modules\n\n## API Reference\n\nPlease refer to the TypeScript definitions for detailed API documentation.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","frontend/packages/loop-modules/evaluate/README.md":"# @cozeloop/evaluate-components\n\n> Project template for react component with storybook.\n\n## Features\n\n- [x] eslint & ts\n- [x] esm bundle\n- [x] umd bundle\n- [x] storybook\n\n## Commands\n\n- init: `rush update`\n- dev: `npm run dev`\n- build: `npm run build`\n","frontend/packages/loop-pages/auth-pages/README.md":"# @cozeloop/auth-pages\n\nAuthentication and account management pages for CozeLoop.\n\n## Overview\n\nThis package provides authentication-related pages and components for the CozeLoop platform, including login pages, account settings, and user management interfaces. It's part of the CozeLoop monorepo and integrates with the platform's authentication system.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/auth-pages\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n#### Using the Auth App (Default Export)\n\n```typescript\nimport AuthApp from '@cozeloop/auth-pages';\nimport { BrowserRouter } from 'react-router-dom';\n\nfunction App() {\n return (\n \n \n \n );\n}\n```\n\nThe default export provides a complete auth application with routing:\n\n- `/login` - Login page\n- Automatic redirect to login for unmatched routes\n\n#### Using Individual Components\n\n```typescript\nimport { AccountSetting, SwitchLang } from '@cozeloop/auth-pages';\n\nfunction SettingsPage() {\n return (\n
\n \n \n
\n );\n}\n```\n\n## Features\n\n- **Login Flow**: Complete login page with authentication handling\n- **Account Settings**: User profile and account management interface\n- **Personal Access Token (PAT) Management**: Create, view, and manage API tokens\n- **User Information Panel**: Edit user profile, username, and account details\n- **Language Switching**: Multi-language support with language switcher component\n- **Responsive Auth Frame**: Consistent layout for authentication pages\n\n## Components\n\n### Main Exports\n\n- **`App` (default)**: Complete auth application with routing\n- **`AccountSetting`**: Account settings and management interface\n- **`SwitchLang`**: Language switcher component\n\n### Internal Components\n\n- `AuthFrame`: Layout wrapper for auth pages\n- `LoginPanel`: Login form component\n- `Logo`: CozeLoop logo component\n- `UserInfoPanel`: User profile management\n- `PATPanel`: Personal Access Token management\n\n## API Reference\n\n### Default Export: `App`\n\nA React component that provides the complete authentication application with built-in routing.\n\n### Named Exports\n\n#### `AccountSetting`\n\nComponent for managing user account settings, including:\n\n- User information editing\n- Personal Access Token (PAT) management\n- Account preferences\n\n#### `SwitchLang`\n\nLanguage switcher component for changing the application language.\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Dependencies\n\nThis package depends on:\n\n- `@cozeloop/account`: Account management functionality\n- `@cozeloop/api-schema`: API type definitions\n- `@cozeloop/i18n-adapter`: Internationalization support\n- `@cozeloop/stores`: State management\n- `@coze-arch/coze-design`: UI component library\n- `react-router-dom`: Routing functionality\n\n## Development\n\nThis package is built with:\n\n- TypeScript for type safety\n- React 18+ for UI components\n- React Router for navigation\n- Vitest for testing\n- ESLint for code quality\n- Coze Design System for UI components\n\n### Scripts\n\n```bash\n# Build the package\nnpm run build\n\n# Run linting\nnpm run lint\n\n# Run tests\nnpm run test\n\n# Run tests with coverage\nnpm run test:cov\n```\n\n## Contributing\n\nThis package is part of the CozeLoop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","frontend/packages/loop-pages/evaluate-pages/README.md":"# @cozeloop/evaluate-pages\n\nEvaluation and testing pages for CozeLoop platform, providing comprehensive experiment management, dataset handling, and evaluator configuration.\n\n## Overview\n\nThis package provides the complete evaluation system pages for the CozeLoop platform. It integrates evaluation workflows including dataset management, evaluator creation and configuration, and experiment execution and analysis. The package serves as the main entry point for the evaluation feature set in CozeLoop.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/evaluate-pages\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport EvaluateApp from '@cozeloop/evaluate-pages';\nimport { BrowserRouter } from 'react-router-dom';\n\nfunction App() {\n return (\n \n \n \n );\n}\n```\n\nThe app provides comprehensive routing for the evaluation workflow with automatic initialization of community evaluation configurations.\n\n## Features\n\n### Dataset Management (评测集)\n\n- **Dataset List**: Browse and manage all evaluation datasets\n- **Dataset Creation**: Create new datasets for evaluation\n- **Dataset Details**: View and edit dataset configurations and data\n\n### Evaluator Management (评估器)\n\n- **Evaluator List**: View all available evaluators\n- **LLM Evaluator Creation**: Create and configure LLM-based evaluators\n- **Code Evaluator Creation**: Create custom code-based evaluators\n- **Evaluator Details**: View and modify evaluator configurations\n\n### Experiment Management (实验)\n\n- **Experiment List**: Browse all experiments\n- **Experiment Creation**: Set up new evaluation experiments\n- **Experiment Details**: View experiment results and analytics\n- **Experiment Contrast**: Compare multiple experiments side-by-side\n\n## Routes\n\nThe application provides the following routes:\n\n### Datasets (评测集)\n\n- `/datasets` - Dataset list page\n- `/datasets/create` - Create new dataset\n- `/datasets/:id` - Dataset detail page\n\n### Evaluators (评估器)\n\n- `/evaluators` - Evaluator list page\n- `/evaluators/create/llm` - Create LLM evaluator\n- `/evaluators/create/llm/:id?` - Edit LLM evaluator\n- `/evaluators/create/code` - Create code evaluator\n- `/evaluators/create/code/:id?` - Edit code evaluator\n- `/evaluators/:id` - LLM evaluator detail page\n- `/evaluators/code/:id?` - Code evaluator detail page\n\n### Experiments (实验)\n\n- `/experiments` - Redirects to experiments list\n- `/experiments/list` - Experiment list page\n- `/experiments/create` - Create new experiment\n- `/experiments/:experimentID` - Experiment detail page\n- `/experiments/contrast` - Compare experiments\n\n## API Reference\n\n### Default Export\n\nThe package exports a single React component that provides the complete evaluation application with built-in routing and community configuration initialization.\n\n```typescript\nimport EvaluateApp from '@cozeloop/evaluate-pages';\n```\n\n### Configuration\n\nThe app automatically initializes community evaluation configurations using the `useEvaluateConfigCommunityInit` hook from `@cozeloop/evaluate`.\n\n## Dependencies\n\nThis package integrates with:\n\n- `@cozeloop/evaluate`: Core evaluation functionality and page components\n- `@cozeloop/evaluate-components`: UI components for evaluation features\n- `@cozeloop/i18n-adapter`: Internationalization support\n- `@cozeloop/toolkit`: Utility functions\n- `@cozeloop/biz-hooks-adapter`: Business logic hooks\n- `@coze-arch/coze-design`: UI component library\n- `react-router-dom`: Routing functionality\n\n## Development\n\nThis package is built with:\n\n- TypeScript for type safety\n- React 18+ for UI components\n- React Router for navigation\n- Vitest for testing\n- ESLint for code quality\n- Coze Design System for UI components\n\n### Scripts\n\n```bash\n# Build the package\nnpm run build\n\n# Run linting\nnpm run lint\n\n# Run tests\nnpm run test\n\n# Run tests with coverage\nnpm run test:cov\n```\n\n## Contributing\n\nThis package is part of the CozeLoop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","frontend/packages/loop-pages/observation-pages/README.md":"# @cozeloop/observation-pages\n\nObservability and tracing pages for CozeLoop platform, providing comprehensive trace monitoring, analysis, and debugging capabilities.\n\n## Overview\n\nThis package provides the observability system pages for the CozeLoop platform. It offers trace monitoring and analysis capabilities, allowing users to track, search, and debug application execution flows. The package integrates with the CozeLoop observation infrastructure to provide detailed insights into span execution, performance metrics, and trace data.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/observation-pages\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport ObservationApp from '@cozeloop/observation-pages';\nimport { BrowserRouter } from 'react-router-dom';\n\nfunction App() {\n return (\n \n \n \n );\n}\n```\n\nThe app provides comprehensive trace monitoring and analysis with automatic routing configuration.\n\n## Features\n\n### Trace Monitoring\n\n- **Trace List View**: Browse and search all traces with advanced filtering\n- **Trace Detail Panel**: Deep dive into individual trace execution flows\n- **Span Analysis**: Examine individual spans with detailed metrics\n- **Real-time Search**: Search traces by various criteria including trace ID, status, and custom fields\n- **Performance Metrics**: Track latency, tokens, and other performance indicators\n- **Multi-language Support**: Internationalization with Chinese and English locales\n\n### Key Capabilities\n\n- **Advanced Filtering**: Filter traces by platform type, date range, status, and custom fields\n- **Column Customization**: Configure visible columns including:\n - Status and trace/span identifiers\n - Input/output data\n - Token usage (input, output, total)\n - Latency metrics (total and first response)\n - Timestamps and metadata\n - Prompt keys and span information\n\n- **Trace Details**: View comprehensive trace information including:\n - Span hierarchy and relationships\n - Advanced trace information\n - Input/output data for each span\n - Performance metrics and timing data\n\n- **Custom Views**: User-configurable views with customizable columns and filters\n\n## Routes\n\nThe application provides the following routes:\n\n- `/` - Redirects to traces page\n- `/traces` - Main trace monitoring and analysis page\n\n## API Reference\n\n### Default Export\n\nThe package exports a single React component that provides the complete observation application with built-in routing.\n\n```typescript\nimport ObservationApp from '@cozeloop/observation-pages';\n```\n\n### Features Integration\n\nThe observation pages integrate with:\n\n- **Trace List Component**: `CozeloopTraceListWithDetailPanel` from `@cozeloop/observation-components`\n- **Field Metadata**: Dynamic field metadata fetching based on platform and span types\n- **API Integration**: Direct integration with `observabilityTrace` API for data fetching\n- **User Context**: Integration with workspace and user information\n\n### Configurable Columns\n\nThe following columns are available for trace viewing:\n\n- `status` - Trace execution status\n- `trace_id` - Unique trace identifier\n- `span_id` - Span identifier\n- `span_type` - Type of span\n- `span_name` - Name of the span\n- `input` - Input data\n- `output` - Output data\n- `tokens` - Total token count\n- `input_tokens` - Input token count\n- `output_tokens` - Output token count\n- `latency` - Total latency\n- `latency_first_resp` - First response latency\n- `start_time` - Execution start time\n- `prompt_key` - Associated prompt key\n- `logic_delete_date` - Logical deletion date\n\n## Dependencies\n\nThis package integrates with:\n\n- `@cozeloop/observation-components`: Core observation UI components and utilities\n- `@cozeloop/api-schema`: API type definitions and observation schemas\n- `@cozeloop/i18n-adapter`: Internationalization support\n- `@cozeloop/components`: Shared UI components (PrimaryPage, etc.)\n- `@cozeloop/biz-hooks-adapter`: Business logic hooks (workspace, user info)\n- `@cozeloop/guard`: Access control and permissions\n- `@coze-arch/coze-design`: UI component library\n- `react-router-dom`: Routing functionality\n\n## Development\n\nThis package is built with:\n\n- TypeScript for type safety\n- React 18+ for UI components\n- React Router for navigation\n- Vitest for testing\n- ESLint for code quality\n- Coze Design System for UI components\n\n### Scripts\n\n```bash\n# Build the package\nnpm run build\n\n# Run linting\nnpm run lint\n\n# Run tests\nnpm run test\n\n# Run tests with coverage\nnpm run test:cov\n```\n\n## Contributing\n\nThis package is part of the CozeLoop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","frontend/packages/loop-pages/prompt-pages/README.md":"# @cozeloop/prompt-pages\n\nPrompt engineering and management pages for CozeLoop platform, providing comprehensive prompt development, testing, and lifecycle management.\n\n## Overview\n\nThis package provides the prompt engineering (PE) system pages for the CozeLoop platform. It offers a complete workflow for creating, editing, testing, and managing prompts with integrated observability features. The package includes a prompt list view, development environment, and playground for experimentation.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/prompt-pages\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport PromptApp from '@cozeloop/prompt-pages';\nimport { BrowserRouter } from 'react-router-dom';\n\nfunction App() {\n return (\n \n \n \n );\n}\n```\n\nThe app provides comprehensive prompt engineering capabilities with automatic routing and lazy-loaded pages for optimal performance.\n\n## Features\n\n### Prompt List Management\n\n- **Prompt Library**: Browse and manage all prompts in your workspace\n- **Advanced Search**: Filter prompts by creator, name, tags, and other attributes\n- **Batch Operations**: Create, edit, copy, and delete prompts\n- **Permission Control**: Owner-based deletion permissions\n- **Quick Access**: Click to edit, Shift/Cmd/Ctrl+Click to open in new window\n- **Call Records**: Direct access to prompt execution traces via observation system\n\n### Prompt Development\n\n- **Interactive Editor**: Full-featured prompt development environment\n- **Version Management**: Track and manage prompt versions\n- **Model Integration**: Support for multiple LLM models\n- **Multi-modal Support**: Image input support with validation\n- **Real-time Testing**: Execute and test prompts with immediate feedback\n- **Trace Integration**: View execution traces and debug information\n- **Execute History**: Track execution history and results\n- **File Upload**: Support for file attachments in prompts\n\n### Prompt Playground\n\n- **Experimentation Environment**: Test prompts without saving\n- **Template Support**: Start from templates or scratch\n- **Quick Iteration**: Rapid testing and refinement\n- **Model Selection**: Choose from available models\n- **Save to Library**: Convert playground prompts to saved prompts\n\n### Observability Integration\n\n- **Execution Traces**: View detailed trace logs for each prompt execution\n- **Performance Metrics**: Track latency, tokens, and other metrics\n- **Debug Information**: Access detailed execution information\n- **Trace History Panel**: Browse historical executions\n- **Direct Links**: Navigate to full trace details in observation system\n\n## Routes\n\nThe application provides the following routes:\n\n- `/` - Redirects to prompts list\n- `/prompts` - Prompt list page (PE 列表)\n- `/prompts/:promptID` - Prompt development page\n- `/playground` - Prompt playground page\n\n## Components\n\n### Main Pages\n\n- **PromptListPage**: Browse and manage all prompts with CRUD operations\n- **PromptDevelopPage**: Full-featured prompt development environment\n- **PromptPlaygroundPage**: Experimental prompt testing environment\n\n### Custom Components\n\n- **ExecuteHistoryPanel**: Display execution history with filtering\n- **TraceTab**: Integrated trace viewing for prompt executions\n\n### Integrated Components\n\nFrom `@cozeloop/prompt-components-v2`:\n\n- `PromptList`: Configurable prompt list with search and filters\n- `PromptDevelop`: Complete prompt development UI\n- `PromptCreateModal`: Modal for creating/editing prompts\n- `PromptDeleteModal`: Confirmation modal for deletion\n\n## API Reference\n\n### Default Export\n\nThe package exports a single React component that provides the complete prompt engineering application with built-in routing.\n\n```typescript\nimport PromptApp from '@cozeloop/prompt-pages';\n```\n\n### Key Features\n\n- **Lazy Loading**: Pages are lazy-loaded for optimal performance\n- **Workspace Integration**: Automatic workspace context integration\n- **Model Management**: Dynamic model list loading per workspace\n- **Event Tracking**: Built-in analytics event reporting\n- **User Permissions**: Creator-based access control\n\n## Dependencies\n\nThis package integrates with:\n\n- `@cozeloop/prompt-components-v2`: Core prompt UI components and functionality\n- `@cozeloop/observation-components`: Trace viewing and observability features\n- `@cozeloop/observation-adapter`: Observability integration layer\n- `@cozeloop/biz-components-adapter`: Business components (UserSelect, file upload)\n- `@cozeloop/biz-hooks-adapter`: Business hooks (workspace, user, navigation, models)\n- `@cozeloop/components`: Shared UI components\n- `@cozeloop/hooks`: Utility hooks (modal, breadcrumb, refresh)\n- `@cozeloop/i18n-adapter`: Internationalization support\n- `@cozeloop/api-schema`: API type definitions\n- `@cozeloop/toolkit`: Utility functions\n- `@coze-arch/coze-design`: UI component library\n- `react-router-dom`: Routing functionality\n\n## Development\n\nThis package is built with:\n\n- TypeScript for type safety\n- React 18+ for UI components\n- React Router for navigation with lazy loading\n- Vitest for testing\n- ESLint for code quality\n- Coze Design System for UI components\n\n### Scripts\n\n```bash\n# Build the package (currently a no-op)\nnpm run build\n\n# Run linting\nnpm run lint\n\n# Run tests (currently a no-op)\nnpm run test\n\n# Run tests with coverage (currently a no-op)\nnpm run test:cov\n```\n\n## Contributing\n\nThis package is part of the CozeLoop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","frontend/packages/loop-pages/tag-pages/README.md":"# @cozeloop/tag-pages\n\nTag management pages for CozeLoop platform, providing tag organization, categorization, and CRUD operations.\n\n## Overview\n\nThis package provides the tag management system pages for the CozeLoop platform. It offers a complete workflow for creating, viewing, editing, and organizing tags to help categorize and manage resources within the workspace. The package includes a tag list view, detail pages, and creation interfaces.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/tag-pages\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport TagApp from '@cozeloop/tag-pages';\nimport { BrowserRouter } from 'react-router-dom';\n\nfunction App() {\n return (\n \n \n \n );\n}\n```\n\nThe app provides comprehensive tag management capabilities with automatic routing configuration.\n\n## Features\n\n### Tag Management\n\n- **Tag List View**: Browse and manage all tags in your workspace\n- **Tag Creation**: Create new tags with customizable properties\n- **Tag Details**: View and edit individual tag information\n- **Tag Organization**: Organize and categorize resources using tags\n- **Consistent Navigation**: Integrated breadcrumb and navigation system\n\n## Routes\n\nThe application provides the following routes:\n\n- `/` - Redirects to tag list\n- `/tag` - Tag list page (标签管理)\n- `/tag/create` - Create new tag page\n- `/tag/:tagId` - Tag detail and edit page\n\n**Note**: The actual complete route path is `tag/tag/*` due to the module base path prefix.\n\n## Components\n\n### Integrated Pages\n\nFrom `@cozeloop/tag-components`:\n\n- **TagsListPage**: Browse and manage all tags\n- **TagsCreatePage**: Create new tags\n- **TagsDetailPage**: View and edit tag details\n\n**Note**: Per the codebase TODO, page-level components are currently exported from `@cozeloop/tag-components` but should be moved to this package in future refactoring.\n\n## API Reference\n\n### Default Export\n\nThe package exports a single React component that provides the complete tag management application with built-in routing.\n\n```typescript\nimport TagApp from '@cozeloop/tag-pages';\n```\n\n### Route Configuration\n\nThe tag module uses a consistent route configuration:\n\n- **Module Base Path**: `tag`\n- **Tag List Path**: `tag/tag` (used for navigation and breadcrumbs)\n- All pages receive `tagListPagePath` prop for consistent navigation\n\n## Dependencies\n\nThis package integrates with:\n\n- `@cozeloop/tag-components`: Core tag UI components and page implementations\n- `react-router-dom`: Routing functionality\n\n### Development Dependencies\n\n- `@cozeloop/i18n-adapter`: Internationalization support\n- `@coze-arch/eslint-config`: ESLint configuration\n- `@coze-arch/ts-config`: TypeScript configuration\n- `@coze-arch/vitest-config`: Testing configuration\n\n## Development\n\nThis package is built with:\n\n- TypeScript for type safety\n- React 18+ for UI components\n- React Router for navigation\n- Vitest for testing\n- ESLint for code quality\n- Storybook for component development\n\n### Scripts\n\n```bash\n# Build the package\nnpm run build\n\n# Run Storybook development server\nnpm run dev\n\n# Run linting\nnpm run lint\n\n# Run tests\nnpm run test\n\n# Run tests with coverage\nnpm run test:cov\n```\n\n## Architecture Notes\n\nThis package currently serves as a routing wrapper around `@cozeloop/tag-components`. According to the codebase TODO, future refactoring should:\n\n- Move page-level components from `@cozeloop/tag-components` to this package\n- Keep only UI components in `@cozeloop/tag-components`\n- Improve separation of concerns between components and pages\n\n## Contributing\n\nThis package is part of the CozeLoop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n"},"items":[{"name":"AGENTS.md","path":"AGENTS.md","rawUrl":"https://raw.githubusercontent.com/coze-dev/coze-loop/HEAD/AGENTS.md","title":"AI Agent Protocol & Instructions","category":"root-instruction","format":"markdown","content":"# AGENTS.md\n\nThis file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.\n\n> 开始任务前先通读本文件；涉及架构决策时读 `ARCHITECTURE.md`；进入具体模块时读模块代码。\n\n## 项目概要\n\nCoze Loop 是一个开源的 LLM 评测与可观测性平台，提供 Prompt 开发调试、评测（评测集 + 评估器 + 实验）、可观测性（Trace/Span）、模型集成（OpenAI / Volcengine Ark）等能力。采用 Go 后端（DDD 6 模块，Hertz + Kitex）+ TypeScript/React 前端（Rush.js 59 包）的多语言单体仓库架构，Thrift IDL 共享契约。\n\n## 文档体系\n\n| 层级 | 文件 | 职责 |\n|------|------|------|\n| L0 入口 | `AGENTS.md`（本文件） | 项目全貌、核心约束、导航 |\n| L1 架构 | `ARCHITECTURE.md` | 系统架构、代码地图、依赖关系、不变量 |\n| L1 专题 | `docs/AGENTS.md` | 中层索引，串联 reference/ 和 guidance/ |\n| L3 参考 | `docs/reference/backend-modules-api.md` | 后端 6 模块职责、分层、API 路由 |\n| L3 参考 | `docs/reference/frontend-packages.md` | 前端 59 包分层结构 |\n| L3 指南 | `docs/guidance/deployment-guide.md` | Docker Compose / Helm 部署 |\n| L3 指南 | `docs/guidance/idl-codegen-guide.md` | IDL 变更后代码生成流程 |\n\n## 导航表\n\n| 我想… | 去哪里 |\n|-------|--------|\n| 了解仓库整体架构和模块关系 | `ARCHITECTURE.md` |\n| 查找 docs 下的专题文档 | `docs/AGENTS.md` |\n| 了解后端 6 个 DDD 模块的职责和 API | `docs/reference/backend-modules-api.md` |\n| 了解前端 59 包的分层结构 | `docs/reference/frontend-packages.md` |\n| 部署 Coze Loop（Docker / Helm） | `docs/guidance/deployment-guide.md` |\n| 修改 IDL 后生成代码 | `docs/guidance/idl-codegen-guide.md` |\n| 修改数据库表结构 | 本文件「开发流程」→ Step 3-4 |\n| 添加新的 API 接口 | 本文件「开发流程」→ Step 1-2 → Step 6 |\n| 运行本地开发环境 | `make compose-up-dev` |\n| 了解错误码定义规范 | 本文件「开发流程」→ Step 7 |\n| 执行 lint 检查 | `cd backend && golangci-lint run --config ../.github/.golangci.yaml --fix` |\n\n## 仓库结构\n\n```\ncoze-loop/\n├── idl/thrift/coze/loop/ # Thrift IDL（前后端共享契约，同步源）\n│ ├── /domain/ # 开源领域实体\n│ ├── /domain_openapi/# OpenAPI 领域实体\n│ └── /coze.loop.*.thrift # 服务接口\n├── backend/\n│ ├── cmd/ # 服务入口（main.go HTTP, consumer.go MQ）\n│ ├── api/ # Hertz 网关层（生成 + handler）\n│ ├── modules/ # 6 个 DDD 业务模块\n│ │ ├── evaluation/ # 评测（实验 / 评估器 / 评测集）\n│ │ ├── observability/ # 可观测性（Trace / Span）\n│ │ ├── prompt/ # Prompt 管理\n│ │ ├── data/ # 数据管理（Dataset）\n│ │ ├── llm/ # LLM 模型集成\n│ │ └── foundation/ # 基础（用户 / 空间 / API Key）\n│ ├── infra/ # 共享基础设施（DB, Redis, ClickHouse, MQ, middleware）\n│ ├── pkg/ # 共享工具库\n│ ├── kitex_gen/ # Kitex 生成代码 ⚠️ 禁止手动修改\n│ ├── loop_gen/ # Loop 生成代码 ⚠️ 禁止手动修改\n│ └── script/ # 代码生成脚本\n│ ├── cloudwego/code_gen.sh # IDL → Go\n│ ├── gorm_gen/generate.go # SQL → GORM Model\n│ └── errorx/code_gen.py # 错误码生成\n├── frontend/ # Rush.js 前端 monorepo（59 包）\n│ ├── apps/cozeloop/ # 主 SPA（React 18, Rsbuild, react-router, zustand）\n│ ├── packages/ # loop-pages, loop-modules, loop-components, loop-base\n│ ├── config/ # eslint-config, ts-config, vitest-config 等\n│ └── infra/ # IDL 转 TypeScript 工具等\n├── release/deployment/\n│ ├── docker-compose/ # Docker 部署（conf/ + bootstrap/）\n│ └── helm-chart/ # Kubernetes 部署\n└── common/ # git-hooks（Rush 管理）\n```\n\n## 核心约束\n\n### 1. DDD 分层纪律\n\n每个 `backend/modules//` 遵循三层架构，依赖方向单向：\n\n```\napi/ → application/ → domain/ ← infra/\n```\n\n- **domain/** 定义接口，**infra/** 实现接口，domain **绝不**引用 infra\n- Application 层负责 DTO↔DO 转换、用例编排\n- Repository 的事务只在 infra 层启动\n\n### 2. IDL 优先\n\n`idl/thrift/` 是接口契约的同步源。商业化 IDL 仓库的 `open/` 目录从此处同步。修改 IDL 后必须运行代码生成。\n\n### 3. 生成代码不可手动修改\n\n- `backend/kitex_gen/` — Kitex 生成\n- `backend/loop_gen/` — Loop 本地调用生成\n- `backend/api/router_gen.go` — Hertz 路由生成\n- `**/wire_gen.go` — Wire DI 生成\n- `**/gorm_gen/**` — GORM 模型生成\n\n### 4. 向前兼容\n\n已有企业用户二开部署。IDL API / Domain 核心接口 / 配置文件 / 存储 Schema 均要求向前兼容。新增字段必须 optional，数据库只允许加列。\n\n### 5. SQL 双路径同步\n\n修改数据库表时，以下两个目录必须保持一致：\n- `release/deployment/docker-compose/bootstrap/mysql-init/`（Docker）\n- `release/deployment/helm-chart/charts/app/bootstrap/init/mysql/init-sql/`（Helm）\n\n修改表还需要在 `patch-sql/` 写 ALTER 语句。CI 会通过 `mysql-schema-check` 工作流校验两侧一致性。\n\n### 6. 前端依赖分层\n\n前端 6 层依赖结构（Level-1 到 Level-6），高层级只能依赖低层级，禁止反向依赖。商业版与开源版差异通过 Adapter 模式解耦（`adapter-interfaces/` → `*-adapter/` → `components-with-adapter/`）。\n\n## 后端开发流程\n\n```\nStep 1: IDL 定义 → Step 2: 代码生成 → Step 3: MySQL Schema → Step 4: GORM Gen\n→ Step 5: 配置文件 → Step 6: 业务代码 → Step 7: 错误码 → Step 8: 国际化\n→ Step 9: UT → Step 10: golint\n```\n\n详细步骤见 `docs/guidance/idl-codegen-guide.md`（Step 1-2）和 `docs/guidance/deployment-guide.md`（部署配置）。\n\n**Wire 依赖注入**：修改 `wire.go` 后运行 `wire generate` 重新生成 `wire_gen.go`。禁止手动编辑 `wire_gen.go`。\n\n**代码复用约束**：新增功能前必须先搜索 codebase 是否已有相同/类似实现，有则复用或扩展，不得新建重复文件。\n\n## 常用命令\n\n### 后端（Go）\n\n| 操作 | 命令 |\n|------|------|\n| Go 编译 | `cd backend && go build ./...` |\n| 全量测试 | `cd backend && go test -gcflags=\"all=-N -l\" ./...` |\n| 单测（指定包） | `cd backend && go test -gcflags=\"all=-N -l\" ./modules//...` |\n| 单测（指定函数） | `cd backend && go test -gcflags=\"all=-N -l\" -run TestFuncName ./modules//...` |\n| CI 级测试（含 race） | `cd backend && go test -gcflags=\"all=-N -l\" -race -v -coverprofile=coverage.out -coverpkg=./... ./...` |\n| golint 修复 | `cd backend && golangci-lint run --config ../.github/.golangci.yaml --fix` |\n| IDL 代码生成 | `bash backend/script/cloudwego/code_gen.sh` |\n| GORM 代码生成 | `cd backend && go run script/gorm_gen/generate.go` |\n| 错误码生成 | `backend/script/errorx/code_gen.py ` |\n\n### 前端（Rush.js + pnpm）\n\n| 操作 | 命令 |\n|------|------|\n| 安装依赖 | `node common/scripts/install-run-rush.js install` |\n| 全量构建 | `node common/scripts/install-run-rush.js rebuild --verbose` |\n| 开发服务器 | `cd frontend/apps/cozeloop && npm run dev` |\n| Lint | `cd frontend/apps/cozeloop && npm run lint` |\n| 测试 | `cd frontend/apps/cozeloop && npm run test` |\n| TypeScript 检查 | `cd frontend/apps/cozeloop && npm run build:ts` |\n\n### 部署\n\n| 操作 | 命令 |\n|------|------|\n| 本地 dev 部署 | `make compose-up-dev` |\n| 本地 debug 部署（含 Delve） | `make compose-up-debug` |\n| 停止 dev | `make compose-down-dev` |\n| 停止并清理 volumes | `make compose-down-v-dev` |\n| Helm 部署 | `make helm-up` |\n| 查看 Pod 状态 | `make helm-pod` |\n\n### PR 标题格式\n\nPR 标题必须符合 `[][] ` 格式，CI 会校验。\n\n- type: `feat`, `fix`, `docs`, `style`, `refactor`, `perf`, `test`, `chore`, `build`, `ci`\n- scope: `all`, `idl`, `frontend`, `backend`, `infra`, `workflow`, `prompt`, `evaluation`, `trace`, `model`, `tag`, `dataset`, `foundation`\n\n示例：`[feat][evaluation] add offline metric support`\n","isInternal":false,"tokens":2900,"sizeBytes":8743},{"name":"AGENTS.md","path":"docs/AGENTS.md","rawUrl":"https://raw.githubusercontent.com/coze-dev/coze-loop/HEAD/docs/AGENTS.md","title":"docs - AI Agent Protocol & Instructions","category":"root-instruction","format":"markdown","content":"# AGENTS.md\n\nThis file provides guidance to Claude Code (claude.ai/code) when working with docs in this repository.\n\n> 中层索引，串联 reference/（事实说明）和 guidance/（操作手册）。\n\n## 文件树\n\n```\ndocs/\n├── AGENTS.md ← 本文件\n├── reference/\n│ ├── backend-modules-api.md # 后端 6 模块职责、分层、API 路由\n│ └── frontend-packages.md # 前端 59 包分层结构\n└── guidance/\n ├── deployment-guide.md # Docker Compose / Helm 部署指南\n └── idl-codegen-guide.md # IDL 变更后代码生成完整流程\n```\n\n## 导航\n\n| 我想… | 文件 |\n|-------|------|\n| 了解后端某个模块的职责和 API 路由 | `reference/backend-modules-api.md` |\n| 了解前端包的分层和依赖关系 | `reference/frontend-packages.md` |\n| 部署 Coze Loop 到 Docker 或 K8s | `guidance/deployment-guide.md` |\n| 修改 IDL 后走完代码生成流程 | `guidance/idl-codegen-guide.md` |\n\n## 文档分类原则\n\n- **reference/**：事实说明——描述\"是什么\"，不随任务变化\n- **guidance/**：操作手册——描述\"怎么做\"，面向具体操作步骤\n","isInternal":false,"tokens":374,"sizeBytes":1224},{"name":"README.md","path":"frontend/infra/plugins/pkg-root-webpack-plugin/README.md","rawUrl":"https://raw.githubusercontent.com/coze-dev/coze-loop/HEAD/frontend/infra/plugins/pkg-root-webpack-plugin/README.md","title":"pkg-root-webpack-plugin Documentation","category":"plugin-manifest","format":"markdown","content":"# @coze-arch/pkg-root-webpack-plugin\n\n> 用于支持 `@` 根目录引用的插件\n\n## Overview\n\nThis package is part of the Coze Studio monorepo and provides architecture functionality. It includes hook, plugin.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@coze-arch/pkg-root-webpack-plugin\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@coze-arch/pkg-root-webpack-plugin';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Hook\n- Plugin\n\n## API Reference\n\n### Exports\n\n- `default PkgRootWebpackPlugin;`\n- `PkgRootWebpackPlugin ;`\n\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Studio monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","isInternal":false,"tokens":264,"sizeBytes":1071},{"name":"README.md","path":"frontend/infra/plugins/postcss-plugin/README.md","rawUrl":"https://raw.githubusercontent.com/coze-dev/coze-loop/HEAD/frontend/infra/plugins/postcss-plugin/README.md","title":"postcss-plugin Documentation","category":"plugin-manifest","format":"markdown","content":"# @coze-arch/postcss-plugin\n\nA postcss plugin to add namespace prefix for all css selector\n\n## Overview\n\nThis package is part of the Coze Studio monorepo and provides architecture functionality. It serves as a core component in the Coze Studio ecosystem.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@coze-arch/postcss-plugin\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@coze-arch/postcss-plugin';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Core functionality for Coze Studio\n- TypeScript support\n- Modern ES modules\n\n## API Reference\n\nPlease refer to the TypeScript definitions for detailed API documentation.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Studio monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","isInternal":false,"tokens":249,"sizeBytes":1081},{"name":"README.md","path":"frontend/packages/loop-base/account/README.md","rawUrl":"https://raw.githubusercontent.com/coze-dev/coze-loop/HEAD/frontend/packages/loop-base/account/README.md","title":"account Documentation","category":"plugin-manifest","format":"markdown","content":"# @cozeloop/account\n\nCozeLoop account\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides authentication functionality. It includes hook, store, service.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/account\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@cozeloop/account';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Hook\n- Store\n- Service\n\n## API Reference\n\n### Exports\n\n- `useUserStore, setUserInfo`\n- `useSpaceStore,\n setSpace,\n PERSONAL_ENTERPRISE_ID,`\n- `useLogin`\n- `useRegister`\n- `useLoginStatus`\n- `useLogout`\n- `useCheckLogin`\n- `userService`\n- `authnService`\n- `spaceService`\n\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","isInternal":false,"tokens":298,"sizeBytes":1164},{"name":"README.md","path":"frontend/packages/loop-base/api-schema/README.md","rawUrl":"https://raw.githubusercontent.com/coze-dev/coze-loop/HEAD/frontend/packages/loop-base/api-schema/README.md","title":"api-schema Documentation","category":"plugin-manifest","format":"markdown","content":"# @cozeloop/api-schema\n\nCoze Loop 的 API Schema 定义包。\n\n## 安装\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/api-schema\": \"workspace:*\"\n }\n}\n```\n\n```bash\nrush update\n```\n\n## 更新 API Schema\n\n当后端 API 发生变更时，运行以下命令更新：\n\n```bash\nrushx update\n```\n\n### 指定分支\n\n默认从 `main` 分支拉取 IDL 定义。如需从其他分支更新，可以修改 [package.json](./package.json) 中 `prethrift` 脚本的 `--branch` 参数：\n\n```json\n{\n \"scripts\": {\n \"prethrift\": \"bash ./scripts/download-thrift.sh --branch=your-branch\"\n }\n}\n```\n\n然后执行 `rushx update` 即可从指定分支拉取最新的 API Schema。\n\n## License\n\nApache-2.0\n","isInternal":false,"tokens":218,"sizeBytes":687},{"name":"README.md","path":"frontend/packages/loop-base/base-hooks/README.md","rawUrl":"https://raw.githubusercontent.com/coze-dev/coze-loop/HEAD/frontend/packages/loop-base/base-hooks/README.md","title":"base-hooks Documentation","category":"plugin-manifest","format":"markdown","content":"# @cozeloop/hooks\n\nHooks for CozeLoop\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides community features functionality. It includes modal.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/hooks\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@cozeloop/hooks';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Modal\n\n## API Reference\n\n### Exports\n\n- `useRefresh`\n- `useModalData`\n- `useMouseDownOffset`\n- `useBreadcrumb`\n- `useNavbarCollapsed`\n\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","isInternal":false,"tokens":248,"sizeBytes":1011},{"name":"README.md","path":"frontend/packages/loop-base/bot-env-adapter/README.md","rawUrl":"https://raw.githubusercontent.com/coze-dev/coze-loop/HEAD/frontend/packages/loop-base/bot-env-adapter/README.md","title":"bot-env-adapter Documentation","category":"plugin-manifest","format":"markdown","content":"# @coze-studio/bot-env-adapter\n\n> Environment configuration adapter for bot applications with multi-region support\n\n## Project Overview\n\nThe `@coze-studio/bot-env-adapter` package provides a centralized environment configuration management system for bot applications. It consolidates environment variables, feature flags, and business configurations into a type-safe, region-aware adapter that supports different deployment environments (CN, SG, VA) and build types (local, online, offline, test).\n\nThis package was originally extracted from `apps/bot/env` to provide reusable environment configuration management across the bot ecosystem.\n\n## Features\n\n- **Multi-Region Support**: Configures environments for China (CN), Singapore (SG), and Virginia (VA) regions\n- **Environment-Aware Configuration**: Automatically selects appropriate configurations based on build type and region\n- **Type Safety**: Auto-generated TypeScript definitions ensure type safety across the application\n- **Feature Flags**: Centralized feature flag management for different environments and regions\n- **Business Configuration**: Environment-specific business settings and API configurations\n- **Build-Time Validation**: Validates required environment variables at build time\n\n## Get Started\n\n### Installation\n\nInstall the package in your workspace:\n\n```bash\n# Add to your package.json dependencies\n\"@coze-studio/bot-env-adapter\": \"workspace:*\"\n\n# Run rush update to install\nrush update\n```\n\n### Basic Usage\n\n```typescript\nimport { GLOBAL_ENVS } from '@coze-studio/bot-env-adapter';\n\n// Access environment variables\nconsole.log(GLOBAL_ENVS.REGION); // 'cn' | 'sg' | 'va'\nconsole.log(GLOBAL_ENVS.BUILD_TYPE); // 'local' | 'online' | 'offline' | 'test'\nconsole.log(GLOBAL_ENVS.BOT_BRAND_NAME); // Region-specific brand name\n\n// Access feature flags\nif (GLOBAL_ENVS.FEATURE_ENABLE_SSO) {\n // Enable SSO functionality\n}\n\n// Access business configurations\nconst appId = GLOBAL_ENVS.APP_ID;\nconst cdnUrl = GLOBAL_ENVS.CDN;\n```\n\n### Runtime Environment\n\n```typescript\nimport { runtimeEnv } from '@coze-studio/bot-env-adapter/runtime';\n\n// Access runtime environment information\nconsole.log(runtimeEnv.isPPE); // Production environment check\n```\n\n### Type Definitions\n\n```typescript\nimport type { TConfigEnv } from '@coze-studio/bot-env-adapter/typings';\n\n// Use predefined types for configuration\nconst myConfig: TConfigEnv = {\n cn: {\n boe: 'boe-value',\n inhouse: 'inhouse-value',\n release: 'release-value',\n },\n sg: {\n inhouse: 'sg-inhouse-value',\n release: 'sg-release-value',\n },\n va: {\n release: 'va-release-value',\n },\n};\n```\n\n## API Reference\n\n### Core Exports\n\n#### `GLOBAL_ENVS`\nThe main export containing all environment variables, feature flags, and configurations.\n\n```typescript\nimport { GLOBAL_ENVS } from '@coze-studio/bot-env-adapter';\n\n// Base environment variables\nGLOBAL_ENVS.BUILD_TYPE // Build environment type\nGLOBAL_ENVS.REGION // Deployment region\nGLOBAL_ENVS.NODE_ENV // Node environment\nGLOBAL_ENVS.CDN // CDN URL for current environment\n\n// Feature flags\nGLOBAL_ENVS.FEATURE_ENABLE_SSO // SSO feature toggle\nGLOBAL_ENVS.FEATURE_ENABLE_APP_GUIDE // App guide feature\nGLOBAL_ENVS.FEATURE_GOOGLE_LOGIN // Google login support\n\n// Business configurations\nGLOBAL_ENVS.APP_ID // Application ID\nGLOBAL_ENVS.BOT_BRAND_NAME // Brand name for current region\nGLOBAL_ENVS.GOOGLE_CLIENT_ID // Google OAuth client ID\n```\n\n#### `extractEnvValue(config: TConfigEnv): T`\nUtility function to extract environment-specific values based on current region and build type.\n\n```typescript\nimport { extractEnvValue } from '@coze-studio/bot-env-adapter';\n\nconst apiUrl = extractEnvValue({\n cn: {\n boe: 'https://api-boe.example.cn',\n inhouse: 'https://api-inhouse.example.cn',\n release: 'https://api.example.cn',\n },\n sg: {\n inhouse: 'https://api-inhouse.example.com',\n release: 'https://api.example.com',\n },\n va: {\n release: 'https://api-va.example.com',\n },\n});\n```\n\n### Configuration Structure\n\n#### Base Configuration (`base.ts`)\nContains fundamental environment variables and regional judgments:\n- Build type and version information\n- Regional flags (IS_OVERSEA, IS_CN_REGION, etc.)\n- CDN configurations\n- Development mode flags\n\n#### Feature Flags (`features.ts`)\nBoolean flags controlling feature availability:\n- Authentication features (SSO, Google login, etc.)\n- Regional feature differences\n- Version-specific feature toggles\n\n#### Business Configurations (`configs.ts`)\nEnvironment-specific business settings:\n- API keys and application IDs\n- External service configurations\n- Legal document URLs\n- Platform-specific settings\n\n### Type Definitions\n\nThe package automatically generates TypeScript definitions in `src/typings.d.ts` based on the environment configuration. These types are available for import:\n\n```typescript\n// Auto-generated types based on actual configuration\ndeclare const BUILD_TYPE: 'local' | 'online' | 'offline' | 'test';\ndeclare const REGION: 'cn' | 'sg' | 'va';\ndeclare const FEATURE_ENABLE_SSO: boolean;\n// ... and many more\n```\n\n## Development\n\n### Project Structure\n\n```\nsrc/\n├── index.ts # Main entry point, exports GLOBAL_ENVS\n├── base.ts # Base environment variables and regional flags\n├── features.ts # Feature flag configurations\n├── configs.ts # Business-specific configurations\n├── typings.d.ts # Auto-generated type definitions\n├── runtime/\n│ └── index.ts # Runtime environment utilities\n├── utils/\n│ ├── config-helper.ts # Configuration extraction utilities\n│ └── current-branch.ts # Git branch detection\n└── configs/\n └── volcano.ts # Volcano platform configurations\n```\n\n### Configuration Guidelines\n\nWhen adding new environment configurations, follow these conventions:\n\n1. **Use `extractEnvValue` for environment-specific values**:\n```typescript\nconst MY_CONFIG = extractEnvValue({\n cn: {\n boe: 'boe-value',\n inhouse: 'inhouse-value',\n release: 'release-value',\n },\n sg: {\n inhouse: 'sg-inhouse-value',\n release: 'sg-release-value',\n },\n va: {\n release: 'va-release-value',\n },\n});\n```\n\n2. **Ensure all environments are covered** to prevent configuration gaps\n3. **Update the `envs` object** in `src/index.ts` to include new configurations\n4. **Run the build script** to regenerate type definitions\n\n### Build Process\n\nThe package includes an automated TypeScript definition generator:\n\n```bash\nnpm run build\n```\n\nThis command:\n1. Analyzes the `envs` object in `src/index.ts`\n2. Generates type definitions in `src/typings.d.ts`\n3. Compiles TypeScript files\n\n### Environment Variables\n\nSet these environment variables to control the adapter behavior:\n\n- `BUILD_TYPE`: Build environment ('local' | 'online' | 'offline' | 'test')\n- `REGION`: Deployment region ('cn' | 'sg' | 'va')\n- `CUSTOM_VERSION`: Version type ('inhouse' | 'release')\n- `NODE_ENV`: Node environment ('development' | 'production' | 'test')\n- `VERBOSE`: Set to 'true' to log all environment values\n\n### Testing\n\n```bash\nnpm run test # Run tests\nnpm run test:cov # Run tests with coverage\nnpm run lint # Run linting\n```\n\n## Dependencies\n\n### Runtime Dependencies\nThis package has no runtime dependencies, making it lightweight and suitable for both client and server environments.\n\n### Development Dependencies\n- **@coze-arch/eslint-config**: Workspace ESLint configuration\n- **@coze-arch/ts-config**: Workspace TypeScript configuration\n- **@coze-arch/vitest-config**: Workspace Vitest configuration\n- **ts-morph**: TypeScript AST manipulation for type generation\n- **sucrase**: Fast TypeScript compiler for build scripts\n\n## License\n\nApache-2.0\n","isInternal":false,"tokens":1769,"sizeBytes":7890},{"name":"README.md","path":"frontend/packages/loop-base/bot-env/README.md","rawUrl":"https://raw.githubusercontent.com/coze-dev/coze-loop/HEAD/frontend/packages/loop-base/bot-env/README.md","title":"bot-env Documentation","category":"plugin-manifest","format":"markdown","content":"# @coze-arch/bot-env\n\n> A TypeScript-based environment variable management system for the bot-studio monorepo, providing compile-time type safety and runtime environment configuration.\n\n## Features\n\n- 🔧 **Compile-time Environment Variables**: Access to environment variables with full TypeScript support\n- 🏗️ **Multi-environment Support**: Handles different deployment environments (BOE, production, development)\n- 🌍 **Multi-region Configuration**: Supports CN, SG, and VA regions with region-specific configurations\n- 🎯 **Feature Flags**: Built-in feature toggle system for conditional functionality\n- 📝 **Auto-generated Types**: Automatically generates TypeScript declarations from environment configuration\n- 🔒 **Type Safety**: Full TypeScript support with strict typing for all environment variables\n- ⚡ **Runtime Environment Access**: Provides runtime environment detection and configuration\n\n## Get Started\n\n### Installation\n\n```bash\n# Install the package\nrush add -p @coze-arch/bot-env\n\n# Update dependencies\nrush update\n```\n\n### Basic Usage\n\n```typescript\n// Import compile-time environment variables\nimport { GLOBAL_ENVS } from '@coze-arch/bot-env';\n\n// Access environment variables with full type safety\nconsole.log(GLOBAL_ENVS.REGION); // 'cn' | 'sg' | 'va'\nconsole.log(GLOBAL_ENVS.IS_PROD); // boolean\nconsole.log(GLOBAL_ENVS.BUILD_TYPE); // 'local' | 'online' | 'offline' | 'test'\n\n// Import runtime environment utilities\nimport { runtimeEnv } from '@coze-arch/bot-env/runtime';\n\n// Access runtime environment information\nconsole.log(runtimeEnv.isPPE); // boolean\n```\n\n### TypeScript Declarations\n\n```typescript\n// Import TypeScript declarations\n/// \n\n// All environment variables are available as global constants\ndeclare const REGION: 'cn' | 'sg' | 'va';\ndeclare const IS_PROD: boolean;\ndeclare const FEATURE_ENABLE_SSO: boolean;\n// ... and many more\n```\n\n## API Reference\n\n### GLOBAL_ENVS\n\nThe main export containing all environment variables organized by category:\n\n#### Base Environment Variables\n- `BUILD_TYPE`: Build environment type (`'local' | 'online' | 'offline' | 'test'`)\n- `CUSTOM_VERSION`: Version type (`'inhouse' | 'release'`)\n- `REGION`: Deployment region (`'cn' | 'sg' | 'va'`)\n- `NODE_ENV`: Node environment (`'production' | 'development' | 'test'`)\n- `IS_PROD`: Production environment flag\n- `IS_BOE`: BOE environment flag\n- `IS_OVERSEA`: Overseas deployment flag\n- `IS_RELEASE_VERSION`: Release version flag\n\n#### Feature Flags\n- `FEATURE_ENABLE_SSO`: Single Sign-On feature\n- `FEATURE_ENABLE_APP_GUIDE`: Application guide feature\n- `FEATURE_ENABLE_MSG_DEBUG`: Message debugging feature\n- `FEATURE_AWEME_LOGIN`: Aweme login integration\n- `FEATURE_GOOGLE_LOGIN`: Google login integration\n- And many more feature toggles...\n\n#### Configuration Variables\n- `CDN`: Content delivery network URL\n- `UPLOAD_CDN`: Upload CDN configuration\n- `COZE_DOMAIN`: Coze service domain\n- `APP_ID`: Application identifier\n- `APP_KEY`: Application key\n- Various service-specific configurations\n\n### Runtime Environment\n\n```typescript\nimport { runtimeEnv } from '@coze-arch/bot-env/runtime';\n\n// Runtime environment detection\nruntimeEnv.isPPE // boolean - Production-like environment detection\n```\n\n### Build Scripts\n\n```typescript\nimport { build } from '@coze-arch/bot-env/build';\n\n// Generate TypeScript declarations from environment configuration\nbuild();\n```\n\n## Development\n\n### Project Structure\n\n```\nsrc/\n├── index.ts # Main exports\n├── runtime/ # Runtime environment utilities\n├── typings.d.ts # Auto-generated TypeScript declarations\n└── global.d.ts # Global type definitions\n\nscripts/\n├── build.ts # Build script exports\n└── index.ts # Build script runner\n```\n\n### Environment Configuration\n\nThis package acts as a wrapper around `@coze-studio/bot-env-adapter`, which provides the actual environment configuration logic. The adapter package includes:\n\n- **Base configuration**: Core environment variables like region, build type, and deployment flags\n- **Feature flags**: Toggle switches for various application features\n- **Business configs**: Service-specific configuration values\n- **Configuration helpers**: Utilities for environment-specific value extraction\n\n### Auto-generated Types\n\nThe package automatically generates TypeScript declarations based on the environment configuration. The build process:\n\n1. Analyzes the `envs` object in the source code\n2. Extracts type information for each environment variable\n3. Generates corresponding TypeScript declarations\n4. Updates the `typings.d.ts` file with the latest types\n\n### Environment-specific Configuration\n\nUse the `extractEnvValue` utility for environment-specific configurations:\n\n```typescript\nconst API_ENDPOINT = extractEnvValue({\n cn: {\n boe: 'https://boe.api.example.com',\n inhouse: 'https://inhouse.api.example.com',\n release: 'https://api.example.com'\n },\n sg: {\n inhouse: 'https://sg-inhouse.api.example.com',\n release: 'https://sg.api.example.com'\n },\n va: {\n release: 'https://va.api.example.com'\n }\n});\n```\n\n### Running Tests\n\n```bash\n# Run tests\nrush test -t @coze-arch/bot-env\n\n# Run tests with coverage\nrush test:cov -t @coze-arch/bot-env\n```\n\n### Building\n\n```bash\n# Build the package\nrush build -t @coze-arch/bot-env\n\n# Generate type definitions\nrush build:types -t @coze-arch/bot-env\n```\n\n## Dependencies\n\n### Runtime Dependencies\n- `@coze-studio/bot-env-adapter`: Core environment configuration adapter\n\n### Development Dependencies\n- `@coze-arch/eslint-config`: ESLint configuration\n- `@coze-arch/ts-config`: TypeScript configuration\n- `@coze-arch/vitest-config`: Vitest testing configuration\n- `ts-morph`: TypeScript AST manipulation for type generation\n- `sucrase`: Fast TypeScript/JSX compiler\n- `vitest`: Testing framework\n\n## License\n\nApache-2.0 License - see package.json for details.\n\n---\n\nFor more information about environment configuration patterns and best practices, refer to the [bot-studio monorepo documentation](../../docs/).\n","isInternal":false,"tokens":1384,"sizeBytes":6133},{"name":"README.md","path":"frontend/packages/loop-base/bot-flags/README.md","rawUrl":"https://raw.githubusercontent.com/coze-dev/coze-loop/HEAD/frontend/packages/loop-base/bot-flags/README.md","title":"bot-flags Documentation","category":"plugin-manifest","format":"markdown","content":"# @coze-arch/bot-flags\n\nfeature gating for bot studio\n\n## Overview\n\nThis package is part of the Coze Studio monorepo and provides architecture functionality. It serves as a core component in the Coze ecosystem.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@coze-arch/bot-flags\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@coze-arch/bot-flags';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Core functionality for Coze Studio\n- TypeScript support\n- Modern ES modules\n\n## API Reference\n\n### Exports\n\n- `type FEATURE_FLAGS, type FetchFeatureGatingFunction`\n- `getFlags`\n- `useFlags`\n- `pullFeatureFlags`\n\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Studio monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","isInternal":false,"tokens":279,"sizeBytes":1146},{"name":"README.md","path":"frontend/packages/loop-base/bot-md-box-adapter/README.md","rawUrl":"https://raw.githubusercontent.com/coze-dev/coze-loop/HEAD/frontend/packages/loop-base/bot-md-box-adapter/README.md","title":"bot-md-box-adapter Documentation","category":"plugin-manifest","format":"markdown","content":"# @coze-arch/bot-md-box-adapter\n\n> Project template for react component with storybook.\n\n## Features\n\n- [x] eslint & ts\n- [x] esm bundle\n- [x] umd bundle\n- [x] storybook\n\n## Commands\n\n- init: `rush update`\n- dev: `npm run dev`\n- build: `npm run build`\n","isInternal":false,"tokens":83,"sizeBytes":252},{"name":"README.md","path":"frontend/packages/loop-base/bot-typings/README.md","rawUrl":"https://raw.githubusercontent.com/coze-dev/coze-loop/HEAD/frontend/packages/loop-base/bot-typings/README.md","title":"bot-typings Documentation","category":"plugin-manifest","format":"markdown","content":"# @coze-arch/bot-typings\n\nA comprehensive TypeScript type definitions package extracted from the bot application, providing essential type declarations for the Coze bot platform. This package centralizes common type definitions, interfaces, and module declarations to ensure type safety across the bot ecosystem.\n\n## Features\n\n- **Global Type Declarations**: Provides type definitions for various file formats (images, stylesheets, SVG)\n- **Common Utility Types**: Includes utility types like `Expand`, `PartialRequired`, and `Obj` for enhanced type manipulation\n- **Platform-Specific Types**: Defines interfaces for browser APIs, window objects, and navigator extensions\n- **User & Authentication Types**: Comprehensive type definitions for user data, authentication flows, and OAuth\n- **Teamspace & Routing Types**: Type definitions for dynamic routing parameters and teamspace functionality\n- **Zero Runtime Impact**: Pure TypeScript declarations with no runtime dependencies\n\n## Get Started\n\n### Installation\n\nInstall the package in your Rush.js monorepo:\n\n```bash\n# Add to your package.json\n\"@coze-arch/bot-typings\": \"workspace:*\"\n\n# Run Rush update to install\nrush update\n```\n\n### Basic Usage\n\nImport the main type definitions:\n\n```typescript\n// Import the main type definitions\nimport \"@coze-arch/bot-typings\";\n\n// Import specific modules\nimport { BotPageFromEnum, Obj, Expand, PartialRequired } from \"@coze-arch/bot-typings/common\";\nimport { DynamicParams } from \"@coze-arch/bot-typings/teamspace\";\n```\n\n## API Reference\n\n### Common Types\n\n#### `BotPageFromEnum`\nDefines the source of bot detail pages:\n\n```typescript\nenum BotPageFromEnum {\n Bot = 'bot', // Bot list\n Explore = 'explore', // Explore list\n Store = 'store',\n Template = 'template',\n}\n```\n\n#### Utility Types\n\n**`Obj`** - Generic object type:\n```typescript\ntype Obj = Record;\n```\n\n**`Expand`** - Expands intersection types for better readability:\n```typescript\ntype Intersection = { a: string } & { b: number };\ntype Result = Expand;\n// Result: { a: string; b: number }\n```\n\n**`PartialRequired`** - Makes specific fields required:\n```typescript\ninterface Agent {\n id?: string;\n name?: string;\n desc?: string;\n}\ntype Result = PartialRequired;\n// Result: { id: string; name: string; desc?: string }\n```\n\n### Teamspace Types\n\n#### `DynamicParams`\nDefines route parameters for teamspace navigation:\n\n```typescript\ninterface DynamicParams extends Record {\n space_id?: string;\n bot_id?: string;\n plugin_id?: string;\n workflow_id?: string;\n dataset_id?: string;\n doc_id?: string;\n tool_id?: string;\n invite_key?: string;\n product_id?: string;\n mock_set_id?: string;\n conversation_id: string; // Required\n commit_version?: string;\n scene_id?: string;\n post_id?: string;\n project_id?: string;\n}\n```\n\n### User & Authentication Types\n\nThe package provides comprehensive types under the `DataItem` namespace:\n\n#### `UserInfo`\nComplete user information interface:\n```typescript\ninterface UserInfo {\n user_id_str: string;\n name: string;\n screen_name: string;\n avatar_url: string;\n email?: string;\n // ... many more fields\n}\n```\n\n#### Authentication Types\n- `AuthLoginParams` - OAuth login parameters\n- `AuthorizeResponse` - Authorization response structure\n- `SendCodeData` - Verification code response\n- `UserCheckResponse` - User validation response\n\n### Global Module Declarations\n\nThe package automatically provides type declarations for:\n\n**Image Files:**\n```typescript\n// .jpeg, .jpg, .webp, .gif, .png files\nimport myImage from './image.png'; // string\n```\n\n**Stylesheets:**\n```typescript\n// .less, .css files\nimport styles from './styles.less'; // { [key: string]: string }\n```\n\n**SVG Files:**\n```typescript\n// .svg files\nimport { ReactComponent } from './icon.svg'; // React.FunctionComponent\nimport icon from './icon.svg'; // any (depends on svgDefaultExport config)\n```\n\n### Browser API Extensions\n\n**Window Interface Extensions:**\n```typescript\n// IDE plugin support\nwindow.editorDispose?.();\n\n// Mini-program integration\nwindow.tt?.miniProgram.postMessage({ data: {...} });\n\n// Coze app integration\nwindow.__cozeapp__?.setLoading?.(true);\n```\n\n**Navigator Extensions:**\n```typescript\n// Standalone app detection\nif (navigator.standalone) {\n // Running as standalone web app\n}\n```\n\n## Development\n\n### Project Structure\n\n```\nsrc/\n├── index.d.ts # Main type definitions and module declarations\n├── common.ts # Common utility types and enums\n├── teamspace.ts # Teamspace-related type definitions\n├── data_item.d.ts # User and authentication type definitions\n├── navigator.d.ts # Navigator API extensions\n└── window.d.ts # Window object extensions\n```\n\n### Building\n\nThis package contains only TypeScript declarations and requires no build step:\n\n```bash\nnpm run build # No-op (exits with code 0)\n```\n\n### Linting\n\n```bash\nnpm run lint\n```\n\n### Adding New Types\n\n1. **Module Declarations**: Add to `index.d.ts`\n2. **Common Utilities**: Add to `common.ts`\n3. **Domain-Specific Types**: Create new files and export from appropriate entry points\n4. **Global Extensions**: Add to `window.d.ts` or `navigator.d.ts`\n\nRemember to update the `exports` field in `package.json` for new modules.\n\n## Dependencies\n\n### Runtime Dependencies\nNone - this package contains only TypeScript type definitions.\n\n### Development Dependencies\n- **@coze-arch/bot-env**: Workspace package providing environment-specific typings\n- **@coze-arch/eslint-config**: Shared ESLint configuration\n- **@coze-arch/ts-config**: Shared TypeScript configuration\n- **TypeScript 5.8.2**: Core TypeScript compiler\n- **React Types**: For component and SVG type definitions\n\n## License\n\nApache-2.0\n\n---\n\n**Author**: fanwenjie.fe@bytedance.com\n\nThis package is part of the Coze bot platform architecture and provides essential type safety for bot development workflows.\n","isInternal":false,"tokens":1385,"sizeBytes":5972},{"name":"README.md","path":"frontend/packages/loop-base/components/README.md","rawUrl":"https://raw.githubusercontent.com/coze-dev/coze-loop/HEAD/frontend/packages/loop-base/components/README.md","title":"components Documentation","category":"plugin-manifest","format":"markdown","content":"# @cozeloop/components\n\ncommon components for cozeloop\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides ui component functionality. It serves as a core component in the Coze Loop ecosystem.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/components\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@cozeloop/components';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Core functionality for Coze Loop\n- TypeScript support\n- Modern ES modules\n\n## API Reference\n\n### Exports\n\n- `ColumnSelector, type ColumnItem`\n- `TooltipWhenDisabled`\n- `LoopTable`\n- `TableWithPagination,\n DEFAULT_PAGE_SIZE,\n PAGE_SIZE_OPTIONS,`\n- `PageError,\n PageLoading,\n PageNoAuth,\n PageNoContent,\n PageNotFound,`\n- `TableColActions`\n- `LoopTabs`\n- `LargeTxtRender`\n- `InputSlider`\n- `handleCopy, sleep`\n\n*And more...*\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- React\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","isInternal":false,"tokens":337,"sizeBytes":1353},{"name":"README.md","path":"frontend/packages/loop-base/env/README.md","rawUrl":"https://raw.githubusercontent.com/coze-dev/coze-loop/HEAD/frontend/packages/loop-base/env/README.md","title":"env Documentation","category":"plugin-manifest","format":"markdown","content":"# @cozeloop/env-adapter\n\nA community features package for the Coze Loop ecosystem\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides community features functionality. It serves as a core component in the Coze Loop ecosystem.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/env-adapter\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@cozeloop/env-adapter';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Core functionality for Coze Loop\n- TypeScript support\n- Modern ES modules\n\n## API Reference\n\n### Exports\n\n- `const envs = new Env();`\n\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","isInternal":false,"tokens":264,"sizeBytes":1106},{"name":"README.md","path":"frontend/packages/loop-base/fetch-stream/README.md","rawUrl":"https://raw.githubusercontent.com/coze-dev/coze-loop/HEAD/frontend/packages/loop-base/fetch-stream/README.md","title":"fetch-stream Documentation","category":"plugin-manifest","format":"markdown","content":"# @coze-arch/fetch-stream\n\nfetch stream vanilla js\n\n## Overview\n\nThis package is part of the Coze Studio monorepo and provides api & networking functionality. It serves as a core component in the Coze ecosystem.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@coze-arch/fetch-stream\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@coze-arch/fetch-stream';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Core functionality for Coze Studio\n- TypeScript support\n- Modern ES modules\n\n## API Reference\n\n### Exports\n\n- `isFetchStreamErrorInfo,\n fetchStream,\n FetchStreamErrorCode,\n type FetchSteamConfig,\n type FetchStreamErrorInfo,`\n\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Studio monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","isInternal":false,"tokens":279,"sizeBytes":1171},{"name":"README.md","path":"frontend/packages/loop-base/guard/README.md","rawUrl":"https://raw.githubusercontent.com/coze-dev/coze-loop/HEAD/frontend/packages/loop-base/guard/README.md","title":"guard Documentation","category":"plugin-manifest","format":"markdown","content":"# @cozeloop/guard\n\nCozeloop 权限守卫组件，用于管理和控制用户界面中的权限点。\n\n## 安装\n\n```bash\npnpm add @cozeloop/guard\n```\n\n## 特性\n\n- 支持多种权限控制方式（隐藏、只读、拦截等）\n- 提供上下文管理权限状态\n- 支持路由级别的权限控制\n- 可扩展的权限点定义\n\n## 使用方法\n\n### 基础使用\n\n```tsx\nimport { Guard, GuardPoint } from '@cozeloop/guard';\n\nfunction MyComponent() {\n return (\n \n \n \n );\n}\n```\n\n### 路由权限控制\n\n```tsx\nimport { GuardRoute, GuardPoint } from '@cozeloop/guard';\n\nfunction ProtectedRoute() {\n return (\n \n
受保护的内容
\n \n );\n}\n```\n\n### 权限上下文\n\n```tsx\nimport { GuardProvider } from '@cozeloop/guard';\n\nfunction App() {\n // 自定义权限策略\n const customStrategy = {\n // 实现 GuardStrategy 接口\n };\n\n return (\n \n \n \n );\n}\n```\n\n## Features\n\n- [x] eslint & ts\n- [x] esm bundle\n- [x] umd bundle\n- [x] storybook\n\n## Commands\n\n- init: `rush update`\n- dev: `npm run dev`\n- build: `npm run build`\n","isInternal":false,"tokens":429,"sizeBytes":1355},{"name":"README.md","path":"frontend/packages/loop-base/intl/README.md","rawUrl":"https://raw.githubusercontent.com/coze-dev/coze-loop/HEAD/frontend/packages/loop-base/intl/README.md","title":"intl Documentation","category":"plugin-manifest","format":"markdown","content":"# @cozeloop/intl\n\nInternationalization(intl) runtime for CozeLoop\n","isInternal":false,"tokens":20,"sizeBytes":66},{"name":"README.md","path":"frontend/packages/loop-base/logger/README.md","rawUrl":"https://raw.githubusercontent.com/coze-dev/coze-loop/HEAD/frontend/packages/loop-base/logger/README.md","title":"logger Documentation","category":"plugin-manifest","format":"markdown","content":"# @coze-arch/logger\n\nA comprehensive logging and error reporting library for the Coze architecture ecosystem, providing unified console logging, React error boundaries, and performance tracing capabilities.\n\n## Features\n\n- **Unified Logging Interface**: Centralized logging with support for multiple log levels (info, success, warning, error, fatal)\n- **Console Logging**: Console output for debugging and development\n- **React Error Boundaries**: Ready-to-use error boundary components with automatic error reporting\n- **Performance Tracing**: Duration tracking for multi-step operations and workflows\n- **Context-Aware Logging**: Namespace and scope-based log organization\n- **TypeScript Support**: Full TypeScript definitions and type safety\n- **Pending Queue System**: Queues logs when reporter is not initialized, executes when ready\n- **Console Control**: Configurable console output for different environments\n\n## Get Started\n\n### Installation\n\n```bash\n# Add to your Rush.js workspace\nrush add -p @coze-arch/logger --dev\n\n# Update dependencies\nrush update\n```\n\n### Basic Usage\n\n#### Console Logging\n\n```typescript\nimport { logger } from '@coze-arch/logger';\n\n// Simple string messages\nlogger.info('Operation completed successfully');\nlogger.warning('This is a warning message');\nlogger.error({ message: 'Something went wrong', error: new Error('Details') });\n\n// With context and metadata\nlogger.info({\n message: 'User action completed',\n namespace: 'user-management',\n scope: 'profile-update',\n meta: {\n userId: '12345',\n action: 'profile_update',\n duration: 150\n }\n});\n```\n\n#### Event Reporting\n\n```typescript\nimport { reporter } from '@coze-arch/logger';\n\n// Initialize reporter\nreporter.init();\n\n// Log custom events\nreporter.event({\n eventName: 'user_action',\n namespace: 'analytics',\n meta: {\n action: 'button_click',\n component: 'header'\n }\n});\n\n// Report errors\nreporter.error({\n message: 'API request failed',\n error: new Error('Network timeout'),\n namespace: 'api',\n scope: 'user-service'\n});\n```\n\n## API Reference\n\n### Logger\n\nThe main logger instance for console output and basic logging.\n\n```typescript\nimport { logger, Logger } from '@coze-arch/logger';\n\n// Create custom logger with preset context\nconst apiLogger = logger.createLoggerWith({\n ctx: {\n namespace: 'api',\n scope: 'user-service'\n }\n});\n\n// Available log levels\nlogger.info(message | options);\nlogger.success(message | options);\nlogger.warning(message | options);\nlogger.error(options); // requires error object\n\n// Setup configuration\nlogger.setup({ 'no-console': true }); // Disable console output\n```\n\n### Reporter\n\nHandles event reporting and structured logging.\n\n```typescript\nimport { reporter, Reporter } from '@coze-arch/logger';\n\n// Initialize reporter\nreporter.init();\n\n// Create reporter with preset context\nconst moduleReporter = reporter.createReporterWithPreset({\n namespace: 'auth',\n scope: 'login',\n meta: { version: '1.0.0' }\n});\n\n// Custom logs\nreporter.info({ message: 'Info log', meta: { key: 'value' } });\nreporter.warning({ message: 'Warning log' });\nreporter.error({ message: 'Error log', error: new Error() });\n\n// Custom events\nreporter.event({ eventName: 'user_login' });\nreporter.successEvent({ eventName: 'operation_complete' });\nreporter.errorEvent({ eventName: 'login_failed', error: new Error() });\n```\n\n### Performance Tracing\n\nTrack duration across multiple steps in a workflow.\n\n```typescript\nimport { reporter } from '@coze-arch/logger';\n\n// Create tracer for a specific event\nconst { trace } = reporter.tracer({ eventName: 'api_request' });\n\n// Track steps with automatic duration calculation\ntrace('start');\n// ... some operation\ntrace('validation_complete');\n// ... more operations\ntrace('request_sent');\n// ... final operations\ntrace('success', {\n meta: { responseSize: 1024 }\n});\n\n// Handle errors in tracing\ntrace('error', {\n error: new Error('Request failed'),\n meta: { statusCode: 500 }\n});\n```\n\n### Error Boundary\n\nReact component for catching and reporting JavaScript errors.\n\n```typescript\nimport { ErrorBoundary } from '@coze-arch/logger';\n\nfunction App() {\n return (\n {\n console.log('Error caught:', error);\n }}\n onReset={() => {\n // Reset app state\n }}\n >\n \n \n );\n}\n\nfunction ErrorFallback({ error, resetErrorBoundary }) {\n return (\n
\n

Something went wrong:

\n 
{error.message}
\n \n
\n );\n}\n```\n\n### Error Boundary Hooks\n\n```typescript\nimport { useErrorBoundary, useErrorHandler } from '@coze-arch/logger';\n\nfunction ComponentWithErrorHandling() {\n const { showBoundary } = useErrorBoundary();\n const handleError = useErrorHandler();\n\n const handleAsyncOperation = async () => {\n try {\n await riskyOperation();\n } catch (error) {\n // Report to error boundary\n showBoundary(error);\n // Or handle manually\n handleError(error);\n }\n };\n}\n```\n\n### Logger Context\n\nProvide logger instances through React context.\n\n```typescript\nimport { LoggerContext, useLogger } from '@coze-arch/logger';\n\n// Provider\nfunction App() {\n const logger = new Logger({\n ctx: { namespace: 'app' }\n });\n\n return (\n \n \n \n );\n}\n\n// Consumer\nfunction Component() {\n const logger = useLogger();\n\n logger.info('Component mounted');\n}\n```\n\n### Types and Interfaces\n\n```typescript\nimport type {\n LogLevel,\n CommonLogOptions,\n CustomLog,\n CustomErrorLog,\n CustomEvent,\n ErrorEvent,\n LoggerCommonProperties\n} from '@coze-arch/logger';\n\n// Log levels\nenum LogLevel {\n INFO = 'info',\n SUCCESS = 'success',\n WARNING = 'warning',\n ERROR = 'error',\n FATAL = 'fatal'\n}\n\n// Common log options interface\ninterface CommonLogOptions {\n namespace?: string;\n scope?: string;\n level?: LogLevel;\n action?: LogAction[];\n message?: string;\n eventName?: string;\n meta?: Record;\n error?: Error;\n}\n```\n\n## Development\n\n### Running Tests\n\n```bash\n# Run all tests\nrush test\n\n# Run tests with coverage\nrush test:cov\n\n# Run tests for this package only\ncd packages/arch/logger\nrushx test\n```\n\n### Linting\n\n```bash\n# Lint the package\nrushx lint\n\n# Auto-fix linting issues\nrushx lint --fix\n```\n\n### Building\n\n```bash\n# Build the package\nrushx build\n\n# Type checking\nrushx ts-check\n```\n\n## Dependencies\n\n### Production Dependencies\n\n- **@coze-arch/bot-env**: Environment configuration utilities\n- **@coze-arch/bot-typings**: Shared type definitions\n- **lodash-es**: Utility functions library\n- **react**: React library for error boundary components\n- **react-error-boundary**: React error boundary utilities\n\n### Development Dependencies\n\n- **@coze-arch/eslint-config**: Shared ESLint configuration\n- **@coze-arch/ts-config**: Shared TypeScript configuration\n- **@coze-arch/vitest-config**: Shared Vitest configuration\n- **@types/lodash-es**: TypeScript definitions for lodash-es\n- **@types/react**: TypeScript definitions for React\n- **vitest**: Testing framework\n\n## License\n\nThis package is part of the Coze architecture ecosystem and follows the project's licensing terms.\n","isInternal":false,"tokens":1689,"sizeBytes":7377},{"name":"README.md","path":"frontend/packages/loop-base/loop-lng/README.md","rawUrl":"https://raw.githubusercontent.com/coze-dev/coze-loop/HEAD/frontend/packages/loop-base/loop-lng/README.md","title":"loop-lng Documentation","category":"plugin-manifest","format":"markdown","content":"# @cozeloop/loop-lng\n\nLanguage data of Cozeloop.\n\n## Overview\n\nThis package is part of the Coze Studio monorepo and provides architecture functionality. It serves as a core component in the Coze Studio ecosystem.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/loop-lng\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport {} from /* exported functions/components */ '@cozeloop/loop-lng';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Core functionality for Coze Studio\n- TypeScript support\n- Modern ES modules\n\n## API Reference\n\n### Exports\n\n- `localeEn, localeZhCN`\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Studio monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","isInternal":false,"tokens":260,"sizeBytes":1064},{"name":"README.md","path":"frontend/packages/loop-base/route/README.md","rawUrl":"https://raw.githubusercontent.com/coze-dev/coze-loop/HEAD/frontend/packages/loop-base/route/README.md","title":"route Documentation","category":"plugin-manifest","format":"markdown","content":"# @cozeloop/biz-hooks-adapter\n\nBiz hooks for CozeLoop\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides community features functionality. It serves as a core component in the Coze Loop ecosystem.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/biz-hooks-adapter\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@cozeloop/biz-hooks-adapter';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Core functionality for Coze Loop\n- TypeScript support\n- Modern ES modules\n\n## API Reference\n\n### Exports\n\n- `useSpace`\n- `useUserInfo`\n- `useNavigateModule`\n- `useOpenWindow`\n- `useRouteInfo`\n- `useCozeLocation`\n- `useBenefit, type BenefitConfig`\n- `useFetchUserBenefit`\n- `useDemoSpace`\n\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","isInternal":false,"tokens":315,"sizeBytes":1244},{"name":"README.md","path":"frontend/packages/loop-base/stores/README.md","rawUrl":"https://raw.githubusercontent.com/coze-dev/coze-loop/HEAD/frontend/packages/loop-base/stores/README.md","title":"stores Documentation","category":"plugin-manifest","format":"markdown","content":"# @cozeloop/stores\n\nStores For Devops\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides state management functionality. It includes store.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/stores\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@cozeloop/stores';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Store\n\n## API Reference\n\n### Exports\n\n- `useUIStore, UIEvent`\n- `type BreadcrumbItemConfig`\n\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","isInternal":false,"tokens":240,"sizeBytes":970},{"name":"README.md","path":"frontend/packages/loop-base/tea/README.md","rawUrl":"https://raw.githubusercontent.com/coze-dev/coze-loop/HEAD/frontend/packages/loop-base/tea/README.md","title":"tea Documentation","category":"plugin-manifest","format":"markdown","content":"# @cozeloop/tea-adapter\n\nA community features package for the Coze Loop ecosystem\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides community features functionality. It serves as a core component in the Coze Loop ecosystem.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/tea-adapter\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@cozeloop/tea-adapter';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Core functionality for Coze Loop\n- TypeScript support\n- Modern ES modules\n\n## API Reference\n\n### Exports\n\n- `start, init, config, stop, sendEvent, isStarted`\n- `type ParamsTypeDefine = Record>;`\n\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","isInternal":false,"tokens":290,"sizeBytes":1198},{"name":"README.md","path":"frontend/packages/loop-base/toolkit/README.md","rawUrl":"https://raw.githubusercontent.com/coze-dev/coze-loop/HEAD/frontend/packages/loop-base/toolkit/README.md","title":"toolkit Documentation","category":"plugin-manifest","format":"markdown","content":"# @cozeloop/toolkit\n\nToolkit For Devops\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides utilities functionality. It serves as a core component in the Coze Loop ecosystem.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/toolkit\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@cozeloop/toolkit';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Core functionality for Coze Loop\n- TypeScript support\n- Modern ES modules\n\n## API Reference\n\n### Exports\n\n- `notEmpty`\n- `getSafeFileName`\n- `formatTimestampToString,\n safeParseJson,\n formateMsToSeconds,`\n- `CozeLoopStorage`\n- `type LocalStorageKeys`\n- `formatNumberWithCommas,\n formatNumberInThousands,\n formatNumberInMillions,`\n- `safeJsonParse`\n- `fileDownload`\n\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","isInternal":false,"tokens":320,"sizeBytes":1282},{"name":"README.md","path":"frontend/packages/loop-components/adapter-interfaces/README.md","rawUrl":"https://raw.githubusercontent.com/coze-dev/coze-loop/HEAD/frontend/packages/loop-components/adapter-interfaces/README.md","title":"adapter-interfaces Documentation","category":"plugin-manifest","format":"markdown","content":"# @cozeloop/adapter-interfaces\n\nCozeLoop adapter interfaces\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides adapter interfaces definition.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/adapter-interfaces\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported type */ } from '@cozeloop/adapter-interfaces';\n\n// or\n\nimport { /* exported type */ } from '@cozeloop/adapter-interfaces/evaluate';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","isInternal":false,"tokens":220,"sizeBytes":878},{"name":"README.md","path":"frontend/packages/loop-components/biz-components/README.md","rawUrl":"https://raw.githubusercontent.com/coze-dev/coze-loop/HEAD/frontend/packages/loop-components/biz-components/README.md","title":"biz-components Documentation","category":"plugin-manifest","format":"markdown","content":"# @cozeloop/upload-toolkit-adapter\n\nA utilities package for the Coze Loop ecosystem\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides utilities functionality. It includes api, evaluation.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/upload-toolkit-adapter\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@cozeloop/upload-toolkit-adapter';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Api\n- Evaluation\n\n## API Reference\n\nPlease refer to the TypeScript definitions for detailed API documentation.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","isInternal":false,"tokens":234,"sizeBytes":991},{"name":"README.md","path":"frontend/packages/loop-components/biz-config/README.md","rawUrl":"https://raw.githubusercontent.com/coze-dev/coze-loop/HEAD/frontend/packages/loop-components/biz-config/README.md","title":"biz-config Documentation","category":"plugin-manifest","format":"markdown","content":"# @cozeloop/biz-config-adapter\n\nBiz config for CozeLoop\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides community features functionality. It serves as a core component in the Coze Loop ecosystem.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/biz-config-adapter\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported config */ } from '@cozeloop/biz-config-adapter';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Core functionality for Coze Loop\n- TypeScript support\n- Modern ES modules\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","isInternal":false,"tokens":234,"sizeBytes":942},{"name":"README.md","path":"frontend/packages/loop-components/biz-hooks/README.md","rawUrl":"https://raw.githubusercontent.com/coze-dev/coze-loop/HEAD/frontend/packages/loop-components/biz-hooks/README.md","title":"biz-hooks Documentation","category":"plugin-manifest","format":"markdown","content":"# @cozeloop/biz-hooks-adapter\n\nBiz hooks for CozeLoop\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides community features functionality. It serves as a core component in the Coze Loop ecosystem.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/biz-hooks-adapter\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@cozeloop/biz-hooks-adapter';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Core functionality for Coze Loop\n- TypeScript support\n- Modern ES modules\n\n## API Reference\n\n### Exports\n\n- `useSpace`\n- `useUserInfo`\n- `useNavigateModule`\n- `useOpenWindow`\n- `useRouteInfo`\n- `useCozeLocation`\n- `useBenefit, type BenefitConfig`\n- `useFetchUserBenefit`\n- `useDemoSpace`\n\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","isInternal":false,"tokens":315,"sizeBytes":1244},{"name":"README.md","path":"frontend/packages/loop-components/components-with-adapter/README.md","rawUrl":"https://raw.githubusercontent.com/coze-dev/coze-loop/HEAD/frontend/packages/loop-components/components-with-adapter/README.md","title":"components-with-adapter Documentation","category":"plugin-manifest","format":"markdown","content":"# @cozeloop/components\n\ncommon components for cozeloop\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides ui component functionality. It serves as a core component in the Coze Loop ecosystem.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/components\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@cozeloop/components';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Core functionality for Coze Loop\n- TypeScript support\n- Modern ES modules\n\n## API Reference\n\n### Exports\n\n- `ColumnSelector, type ColumnItem`\n- `TooltipWhenDisabled`\n- `LoopTable`\n- `TableWithPagination,\n DEFAULT_PAGE_SIZE,\n PAGE_SIZE_OPTIONS,`\n- `PageError,\n PageLoading,\n PageNoAuth,\n PageNoContent,\n PageNotFound,`\n- `TableColActions`\n- `LoopTabs`\n- `LargeTxtRender`\n- `InputSlider`\n- `handleCopy, sleep`\n\n*And more...*\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- React\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","isInternal":false,"tokens":337,"sizeBytes":1353},{"name":"README.md","path":"frontend/packages/loop-components/evaluate-components/README.md","rawUrl":"https://raw.githubusercontent.com/coze-dev/coze-loop/HEAD/frontend/packages/loop-components/evaluate-components/README.md","title":"evaluate-components Documentation","category":"plugin-manifest","format":"markdown","content":"# @cozeloop/evaluate-components\n\n> Project template for react component with storybook.\n\n## Features\n\n- [x] eslint & ts\n- [x] esm bundle\n- [x] umd bundle\n- [x] storybook\n\n## Commands\n\n- init: `rush update`\n- dev: `npm run dev`\n- build: `npm run build`\n","isInternal":false,"tokens":80,"sizeBytes":252},{"name":"README.md","path":"frontend/packages/loop-components/prompt-components-v2/README.md","rawUrl":"https://raw.githubusercontent.com/coze-dev/coze-loop/HEAD/frontend/packages/loop-components/prompt-components-v2/README.md","title":"prompt-components-v2 Documentation","category":"plugin-manifest","format":"markdown","content":"# @cozeloop/prompt-components\n\nPrompt common components for cozeloop\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides ui component functionality. It includes editor, prompt.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/prompt-components\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@cozeloop/prompt-components';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Editor\n- Prompt\n\n## API Reference\n\n### Exports\n\n- `PromptBasicEditor,\n PromptBasicEditorProps,\n PromptBasicEditorRef,`\n- `PromptDiffEditor`\n- `PromptEditor,\n PromptEditorProps,\n PromptMessage,`\n- `PopoverModelConfigEditor`\n- `PopoverModelConfigEditorQuery`\n- `BasicModelConfigEditor`\n- `ModelSelectWithObject`\n- `DevLayout`\n- `PromptCreate`\n- `getPlaceholderErrorContent`\n\n*And more...*\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- React\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","isInternal":false,"tokens":322,"sizeBytes":1313},{"name":"README.md","path":"frontend/packages/loop-components/prompt-components/README.md","rawUrl":"https://raw.githubusercontent.com/coze-dev/coze-loop/HEAD/frontend/packages/loop-components/prompt-components/README.md","title":"prompt-components Documentation","category":"plugin-manifest","format":"markdown","content":"# @cozeloop/prompt-components\n\nPrompt common components for cozeloop\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides ui component functionality. It includes editor, prompt.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/prompt-components\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@cozeloop/prompt-components';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Editor\n- Prompt\n\n## API Reference\n\n### Exports\n\n- `PromptBasicEditor,\n PromptBasicEditorProps,\n PromptBasicEditorRef,`\n- `PromptDiffEditor`\n- `PromptEditor,\n PromptEditorProps,\n PromptMessage,`\n- `PopoverModelConfigEditor`\n- `PopoverModelConfigEditorQuery`\n- `BasicModelConfigEditor`\n- `ModelSelectWithObject`\n- `DevLayout`\n- `PromptCreate`\n- `getPlaceholderErrorContent`\n\n*And more...*\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- React\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","isInternal":false,"tokens":322,"sizeBytes":1313},{"name":"README.md","path":"frontend/packages/loop-components/tag-components/README.md","rawUrl":"https://raw.githubusercontent.com/coze-dev/coze-loop/HEAD/frontend/packages/loop-components/tag-components/README.md","title":"tag-components Documentation","category":"plugin-manifest","format":"markdown","content":"# @cozeloop/tag-components\n\n> Project template for react component with storybook.\n\n## Features\n\n- [x] eslint & ts\n- [x] esm bundle\n- [x] umd bundle\n- [x] storybook\n\n## Commands\n\n- init: `rush update`\n- dev: `npm run dev`\n- build: `npm run build`\n","isInternal":false,"tokens":79,"sizeBytes":247},{"name":"README.md","path":"frontend/packages/loop-config/rsbuild-config/README.md","rawUrl":"https://raw.githubusercontent.com/coze-dev/coze-loop/HEAD/frontend/packages/loop-config/rsbuild-config/README.md","title":"rsbuild-config Documentation","category":"plugin-manifest","format":"markdown","content":"# @cozeloop/rsbuild-config\n\nRsbuild config for cozeloop\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides ui component functionality. It serves as a core component in the Coze Loop ecosystem.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/rsbuild-config\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@cozeloop/rsbuild-config';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Core functionality for Coze Loop\n- TypeScript support\n- Modern ES modules\n\n## API Reference\n\n### Exports\n\n- `createRsbuildConfig`\n\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","isInternal":false,"tokens":258,"sizeBytes":1076},{"name":"README.md","path":"frontend/packages/loop-config/tailwind-config/README.md","rawUrl":"https://raw.githubusercontent.com/coze-dev/coze-loop/HEAD/frontend/packages/loop-config/tailwind-config/README.md","title":"tailwind-config Documentation","category":"plugin-manifest","format":"markdown","content":"# @cozeloop/tailwind-config\n\nTailwind config\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides development tools functionality. It serves as a core component in the Coze Loop ecosystem.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/tailwind-config\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@cozeloop/tailwind-config';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Core functionality for Coze Loop\n- TypeScript support\n- Modern ES modules\n\n## API Reference\n\n### Exports\n\n- `tailwindcssConfig, createTailwindcssConfig`\n\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","isInternal":false,"tokens":263,"sizeBytes":1095},{"name":"README.md","path":"frontend/packages/loop-config/tailwind-plugin/README.md","rawUrl":"https://raw.githubusercontent.com/coze-dev/coze-loop/HEAD/frontend/packages/loop-config/tailwind-plugin/README.md","title":"tailwind-plugin Documentation","category":"plugin-manifest","format":"markdown","content":"# @cozeloop/tailwind-plugin\n\nA plugin system package for the Coze Loop ecosystem\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides plugin system functionality. It serves as a core component in the Coze Loop ecosystem.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/tailwind-plugin\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@cozeloop/tailwind-plugin';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Core functionality for Coze Loop\n- TypeScript support\n- Modern ES modules\n\n## API Reference\n\nPlease refer to the TypeScript definitions for detailed API documentation.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","isInternal":false,"tokens":251,"sizeBytes":1064},{"name":"README.md","path":"frontend/packages/loop-modules/evaluate/README.md","rawUrl":"https://raw.githubusercontent.com/coze-dev/coze-loop/HEAD/frontend/packages/loop-modules/evaluate/README.md","title":"evaluate Documentation","category":"plugin-manifest","format":"markdown","content":"# @cozeloop/evaluate-components\n\n> Project template for react component with storybook.\n\n## Features\n\n- [x] eslint & ts\n- [x] esm bundle\n- [x] umd bundle\n- [x] storybook\n\n## Commands\n\n- init: `rush update`\n- dev: `npm run dev`\n- build: `npm run build`\n","isInternal":false,"tokens":80,"sizeBytes":252},{"name":"README.md","path":"frontend/packages/loop-pages/auth-pages/README.md","rawUrl":"https://raw.githubusercontent.com/coze-dev/coze-loop/HEAD/frontend/packages/loop-pages/auth-pages/README.md","title":"auth-pages Documentation","category":"plugin-manifest","format":"markdown","content":"# @cozeloop/auth-pages\n\nAuthentication and account management pages for CozeLoop.\n\n## Overview\n\nThis package provides authentication-related pages and components for the CozeLoop platform, including login pages, account settings, and user management interfaces. It's part of the CozeLoop monorepo and integrates with the platform's authentication system.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/auth-pages\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n#### Using the Auth App (Default Export)\n\n```typescript\nimport AuthApp from '@cozeloop/auth-pages';\nimport { BrowserRouter } from 'react-router-dom';\n\nfunction App() {\n return (\n \n \n \n );\n}\n```\n\nThe default export provides a complete auth application with routing:\n\n- `/login` - Login page\n- Automatic redirect to login for unmatched routes\n\n#### Using Individual Components\n\n```typescript\nimport { AccountSetting, SwitchLang } from '@cozeloop/auth-pages';\n\nfunction SettingsPage() {\n return (\n
\n \n \n
\n );\n}\n```\n\n## Features\n\n- **Login Flow**: Complete login page with authentication handling\n- **Account Settings**: User profile and account management interface\n- **Personal Access Token (PAT) Management**: Create, view, and manage API tokens\n- **User Information Panel**: Edit user profile, username, and account details\n- **Language Switching**: Multi-language support with language switcher component\n- **Responsive Auth Frame**: Consistent layout for authentication pages\n\n## Components\n\n### Main Exports\n\n- **`App` (default)**: Complete auth application with routing\n- **`AccountSetting`**: Account settings and management interface\n- **`SwitchLang`**: Language switcher component\n\n### Internal Components\n\n- `AuthFrame`: Layout wrapper for auth pages\n- `LoginPanel`: Login form component\n- `Logo`: CozeLoop logo component\n- `UserInfoPanel`: User profile management\n- `PATPanel`: Personal Access Token management\n\n## API Reference\n\n### Default Export: `App`\n\nA React component that provides the complete authentication application with built-in routing.\n\n### Named Exports\n\n#### `AccountSetting`\n\nComponent for managing user account settings, including:\n\n- User information editing\n- Personal Access Token (PAT) management\n- Account preferences\n\n#### `SwitchLang`\n\nLanguage switcher component for changing the application language.\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Dependencies\n\nThis package depends on:\n\n- `@cozeloop/account`: Account management functionality\n- `@cozeloop/api-schema`: API type definitions\n- `@cozeloop/i18n-adapter`: Internationalization support\n- `@cozeloop/stores`: State management\n- `@coze-arch/coze-design`: UI component library\n- `react-router-dom`: Routing functionality\n\n## Development\n\nThis package is built with:\n\n- TypeScript for type safety\n- React 18+ for UI components\n- React Router for navigation\n- Vitest for testing\n- ESLint for code quality\n- Coze Design System for UI components\n\n### Scripts\n\n```bash\n# Build the package\nnpm run build\n\n# Run linting\nnpm run lint\n\n# Run tests\nnpm run test\n\n# Run tests with coverage\nnpm run test:cov\n```\n\n## Contributing\n\nThis package is part of the CozeLoop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","isInternal":false,"tokens":772,"sizeBytes":3454},{"name":"README.md","path":"frontend/packages/loop-pages/evaluate-pages/README.md","rawUrl":"https://raw.githubusercontent.com/coze-dev/coze-loop/HEAD/frontend/packages/loop-pages/evaluate-pages/README.md","title":"evaluate-pages Documentation","category":"plugin-manifest","format":"markdown","content":"# @cozeloop/evaluate-pages\n\nEvaluation and testing pages for CozeLoop platform, providing comprehensive experiment management, dataset handling, and evaluator configuration.\n\n## Overview\n\nThis package provides the complete evaluation system pages for the CozeLoop platform. It integrates evaluation workflows including dataset management, evaluator creation and configuration, and experiment execution and analysis. The package serves as the main entry point for the evaluation feature set in CozeLoop.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/evaluate-pages\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport EvaluateApp from '@cozeloop/evaluate-pages';\nimport { BrowserRouter } from 'react-router-dom';\n\nfunction App() {\n return (\n \n \n \n );\n}\n```\n\nThe app provides comprehensive routing for the evaluation workflow with automatic initialization of community evaluation configurations.\n\n## Features\n\n### Dataset Management (评测集)\n\n- **Dataset List**: Browse and manage all evaluation datasets\n- **Dataset Creation**: Create new datasets for evaluation\n- **Dataset Details**: View and edit dataset configurations and data\n\n### Evaluator Management (评估器)\n\n- **Evaluator List**: View all available evaluators\n- **LLM Evaluator Creation**: Create and configure LLM-based evaluators\n- **Code Evaluator Creation**: Create custom code-based evaluators\n- **Evaluator Details**: View and modify evaluator configurations\n\n### Experiment Management (实验)\n\n- **Experiment List**: Browse all experiments\n- **Experiment Creation**: Set up new evaluation experiments\n- **Experiment Details**: View experiment results and analytics\n- **Experiment Contrast**: Compare multiple experiments side-by-side\n\n## Routes\n\nThe application provides the following routes:\n\n### Datasets (评测集)\n\n- `/datasets` - Dataset list page\n- `/datasets/create` - Create new dataset\n- `/datasets/:id` - Dataset detail page\n\n### Evaluators (评估器)\n\n- `/evaluators` - Evaluator list page\n- `/evaluators/create/llm` - Create LLM evaluator\n- `/evaluators/create/llm/:id?` - Edit LLM evaluator\n- `/evaluators/create/code` - Create code evaluator\n- `/evaluators/create/code/:id?` - Edit code evaluator\n- `/evaluators/:id` - LLM evaluator detail page\n- `/evaluators/code/:id?` - Code evaluator detail page\n\n### Experiments (实验)\n\n- `/experiments` - Redirects to experiments list\n- `/experiments/list` - Experiment list page\n- `/experiments/create` - Create new experiment\n- `/experiments/:experimentID` - Experiment detail page\n- `/experiments/contrast` - Compare experiments\n\n## API Reference\n\n### Default Export\n\nThe package exports a single React component that provides the complete evaluation application with built-in routing and community configuration initialization.\n\n```typescript\nimport EvaluateApp from '@cozeloop/evaluate-pages';\n```\n\n### Configuration\n\nThe app automatically initializes community evaluation configurations using the `useEvaluateConfigCommunityInit` hook from `@cozeloop/evaluate`.\n\n## Dependencies\n\nThis package integrates with:\n\n- `@cozeloop/evaluate`: Core evaluation functionality and page components\n- `@cozeloop/evaluate-components`: UI components for evaluation features\n- `@cozeloop/i18n-adapter`: Internationalization support\n- `@cozeloop/toolkit`: Utility functions\n- `@cozeloop/biz-hooks-adapter`: Business logic hooks\n- `@coze-arch/coze-design`: UI component library\n- `react-router-dom`: Routing functionality\n\n## Development\n\nThis package is built with:\n\n- TypeScript for type safety\n- React 18+ for UI components\n- React Router for navigation\n- Vitest for testing\n- ESLint for code quality\n- Coze Design System for UI components\n\n### Scripts\n\n```bash\n# Build the package\nnpm run build\n\n# Run linting\nnpm run lint\n\n# Run tests\nnpm run test\n\n# Run tests with coverage\nnpm run test:cov\n```\n\n## Contributing\n\nThis package is part of the CozeLoop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","isInternal":false,"tokens":929,"sizeBytes":4140},{"name":"README.md","path":"frontend/packages/loop-pages/observation-pages/README.md","rawUrl":"https://raw.githubusercontent.com/coze-dev/coze-loop/HEAD/frontend/packages/loop-pages/observation-pages/README.md","title":"observation-pages Documentation","category":"plugin-manifest","format":"markdown","content":"# @cozeloop/observation-pages\n\nObservability and tracing pages for CozeLoop platform, providing comprehensive trace monitoring, analysis, and debugging capabilities.\n\n## Overview\n\nThis package provides the observability system pages for the CozeLoop platform. It offers trace monitoring and analysis capabilities, allowing users to track, search, and debug application execution flows. The package integrates with the CozeLoop observation infrastructure to provide detailed insights into span execution, performance metrics, and trace data.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/observation-pages\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport ObservationApp from '@cozeloop/observation-pages';\nimport { BrowserRouter } from 'react-router-dom';\n\nfunction App() {\n return (\n \n \n \n );\n}\n```\n\nThe app provides comprehensive trace monitoring and analysis with automatic routing configuration.\n\n## Features\n\n### Trace Monitoring\n\n- **Trace List View**: Browse and search all traces with advanced filtering\n- **Trace Detail Panel**: Deep dive into individual trace execution flows\n- **Span Analysis**: Examine individual spans with detailed metrics\n- **Real-time Search**: Search traces by various criteria including trace ID, status, and custom fields\n- **Performance Metrics**: Track latency, tokens, and other performance indicators\n- **Multi-language Support**: Internationalization with Chinese and English locales\n\n### Key Capabilities\n\n- **Advanced Filtering**: Filter traces by platform type, date range, status, and custom fields\n- **Column Customization**: Configure visible columns including:\n - Status and trace/span identifiers\n - Input/output data\n - Token usage (input, output, total)\n - Latency metrics (total and first response)\n - Timestamps and metadata\n - Prompt keys and span information\n\n- **Trace Details**: View comprehensive trace information including:\n - Span hierarchy and relationships\n - Advanced trace information\n - Input/output data for each span\n - Performance metrics and timing data\n\n- **Custom Views**: User-configurable views with customizable columns and filters\n\n## Routes\n\nThe application provides the following routes:\n\n- `/` - Redirects to traces page\n- `/traces` - Main trace monitoring and analysis page\n\n## API Reference\n\n### Default Export\n\nThe package exports a single React component that provides the complete observation application with built-in routing.\n\n```typescript\nimport ObservationApp from '@cozeloop/observation-pages';\n```\n\n### Features Integration\n\nThe observation pages integrate with:\n\n- **Trace List Component**: `CozeloopTraceListWithDetailPanel` from `@cozeloop/observation-components`\n- **Field Metadata**: Dynamic field metadata fetching based on platform and span types\n- **API Integration**: Direct integration with `observabilityTrace` API for data fetching\n- **User Context**: Integration with workspace and user information\n\n### Configurable Columns\n\nThe following columns are available for trace viewing:\n\n- `status` - Trace execution status\n- `trace_id` - Unique trace identifier\n- `span_id` - Span identifier\n- `span_type` - Type of span\n- `span_name` - Name of the span\n- `input` - Input data\n- `output` - Output data\n- `tokens` - Total token count\n- `input_tokens` - Input token count\n- `output_tokens` - Output token count\n- `latency` - Total latency\n- `latency_first_resp` - First response latency\n- `start_time` - Execution start time\n- `prompt_key` - Associated prompt key\n- `logic_delete_date` - Logical deletion date\n\n## Dependencies\n\nThis package integrates with:\n\n- `@cozeloop/observation-components`: Core observation UI components and utilities\n- `@cozeloop/api-schema`: API type definitions and observation schemas\n- `@cozeloop/i18n-adapter`: Internationalization support\n- `@cozeloop/components`: Shared UI components (PrimaryPage, etc.)\n- `@cozeloop/biz-hooks-adapter`: Business logic hooks (workspace, user info)\n- `@cozeloop/guard`: Access control and permissions\n- `@coze-arch/coze-design`: UI component library\n- `react-router-dom`: Routing functionality\n\n## Development\n\nThis package is built with:\n\n- TypeScript for type safety\n- React 18+ for UI components\n- React Router for navigation\n- Vitest for testing\n- ESLint for code quality\n- Coze Design System for UI components\n\n### Scripts\n\n```bash\n# Build the package\nnpm run build\n\n# Run linting\nnpm run lint\n\n# Run tests\nnpm run test\n\n# Run tests with coverage\nnpm run test:cov\n```\n\n## Contributing\n\nThis package is part of the CozeLoop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","isInternal":false,"tokens":1055,"sizeBytes":4773},{"name":"README.md","path":"frontend/packages/loop-pages/prompt-pages/README.md","rawUrl":"https://raw.githubusercontent.com/coze-dev/coze-loop/HEAD/frontend/packages/loop-pages/prompt-pages/README.md","title":"prompt-pages Documentation","category":"plugin-manifest","format":"markdown","content":"# @cozeloop/prompt-pages\n\nPrompt engineering and management pages for CozeLoop platform, providing comprehensive prompt development, testing, and lifecycle management.\n\n## Overview\n\nThis package provides the prompt engineering (PE) system pages for the CozeLoop platform. It offers a complete workflow for creating, editing, testing, and managing prompts with integrated observability features. The package includes a prompt list view, development environment, and playground for experimentation.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/prompt-pages\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport PromptApp from '@cozeloop/prompt-pages';\nimport { BrowserRouter } from 'react-router-dom';\n\nfunction App() {\n return (\n \n \n \n );\n}\n```\n\nThe app provides comprehensive prompt engineering capabilities with automatic routing and lazy-loaded pages for optimal performance.\n\n## Features\n\n### Prompt List Management\n\n- **Prompt Library**: Browse and manage all prompts in your workspace\n- **Advanced Search**: Filter prompts by creator, name, tags, and other attributes\n- **Batch Operations**: Create, edit, copy, and delete prompts\n- **Permission Control**: Owner-based deletion permissions\n- **Quick Access**: Click to edit, Shift/Cmd/Ctrl+Click to open in new window\n- **Call Records**: Direct access to prompt execution traces via observation system\n\n### Prompt Development\n\n- **Interactive Editor**: Full-featured prompt development environment\n- **Version Management**: Track and manage prompt versions\n- **Model Integration**: Support for multiple LLM models\n- **Multi-modal Support**: Image input support with validation\n- **Real-time Testing**: Execute and test prompts with immediate feedback\n- **Trace Integration**: View execution traces and debug information\n- **Execute History**: Track execution history and results\n- **File Upload**: Support for file attachments in prompts\n\n### Prompt Playground\n\n- **Experimentation Environment**: Test prompts without saving\n- **Template Support**: Start from templates or scratch\n- **Quick Iteration**: Rapid testing and refinement\n- **Model Selection**: Choose from available models\n- **Save to Library**: Convert playground prompts to saved prompts\n\n### Observability Integration\n\n- **Execution Traces**: View detailed trace logs for each prompt execution\n- **Performance Metrics**: Track latency, tokens, and other metrics\n- **Debug Information**: Access detailed execution information\n- **Trace History Panel**: Browse historical executions\n- **Direct Links**: Navigate to full trace details in observation system\n\n## Routes\n\nThe application provides the following routes:\n\n- `/` - Redirects to prompts list\n- `/prompts` - Prompt list page (PE 列表)\n- `/prompts/:promptID` - Prompt development page\n- `/playground` - Prompt playground page\n\n## Components\n\n### Main Pages\n\n- **PromptListPage**: Browse and manage all prompts with CRUD operations\n- **PromptDevelopPage**: Full-featured prompt development environment\n- **PromptPlaygroundPage**: Experimental prompt testing environment\n\n### Custom Components\n\n- **ExecuteHistoryPanel**: Display execution history with filtering\n- **TraceTab**: Integrated trace viewing for prompt executions\n\n### Integrated Components\n\nFrom `@cozeloop/prompt-components-v2`:\n\n- `PromptList`: Configurable prompt list with search and filters\n- `PromptDevelop`: Complete prompt development UI\n- `PromptCreateModal`: Modal for creating/editing prompts\n- `PromptDeleteModal`: Confirmation modal for deletion\n\n## API Reference\n\n### Default Export\n\nThe package exports a single React component that provides the complete prompt engineering application with built-in routing.\n\n```typescript\nimport PromptApp from '@cozeloop/prompt-pages';\n```\n\n### Key Features\n\n- **Lazy Loading**: Pages are lazy-loaded for optimal performance\n- **Workspace Integration**: Automatic workspace context integration\n- **Model Management**: Dynamic model list loading per workspace\n- **Event Tracking**: Built-in analytics event reporting\n- **User Permissions**: Creator-based access control\n\n## Dependencies\n\nThis package integrates with:\n\n- `@cozeloop/prompt-components-v2`: Core prompt UI components and functionality\n- `@cozeloop/observation-components`: Trace viewing and observability features\n- `@cozeloop/observation-adapter`: Observability integration layer\n- `@cozeloop/biz-components-adapter`: Business components (UserSelect, file upload)\n- `@cozeloop/biz-hooks-adapter`: Business hooks (workspace, user, navigation, models)\n- `@cozeloop/components`: Shared UI components\n- `@cozeloop/hooks`: Utility hooks (modal, breadcrumb, refresh)\n- `@cozeloop/i18n-adapter`: Internationalization support\n- `@cozeloop/api-schema`: API type definitions\n- `@cozeloop/toolkit`: Utility functions\n- `@coze-arch/coze-design`: UI component library\n- `react-router-dom`: Routing functionality\n\n## Development\n\nThis package is built with:\n\n- TypeScript for type safety\n- React 18+ for UI components\n- React Router for navigation with lazy loading\n- Vitest for testing\n- ESLint for code quality\n- Coze Design System for UI components\n\n### Scripts\n\n```bash\n# Build the package (currently a no-op)\nnpm run build\n\n# Run linting\nnpm run lint\n\n# Run tests (currently a no-op)\nnpm run test\n\n# Run tests with coverage (currently a no-op)\nnpm run test:cov\n```\n\n## Contributing\n\nThis package is part of the CozeLoop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","isInternal":false,"tokens":1211,"sizeBytes":5628},{"name":"README.md","path":"frontend/packages/loop-pages/tag-pages/README.md","rawUrl":"https://raw.githubusercontent.com/coze-dev/coze-loop/HEAD/frontend/packages/loop-pages/tag-pages/README.md","title":"tag-pages Documentation","category":"plugin-manifest","format":"markdown","content":"# @cozeloop/tag-pages\n\nTag management pages for CozeLoop platform, providing tag organization, categorization, and CRUD operations.\n\n## Overview\n\nThis package provides the tag management system pages for the CozeLoop platform. It offers a complete workflow for creating, viewing, editing, and organizing tags to help categorize and manage resources within the workspace. The package includes a tag list view, detail pages, and creation interfaces.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/tag-pages\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport TagApp from '@cozeloop/tag-pages';\nimport { BrowserRouter } from 'react-router-dom';\n\nfunction App() {\n return (\n \n \n \n );\n}\n```\n\nThe app provides comprehensive tag management capabilities with automatic routing configuration.\n\n## Features\n\n### Tag Management\n\n- **Tag List View**: Browse and manage all tags in your workspace\n- **Tag Creation**: Create new tags with customizable properties\n- **Tag Details**: View and edit individual tag information\n- **Tag Organization**: Organize and categorize resources using tags\n- **Consistent Navigation**: Integrated breadcrumb and navigation system\n\n## Routes\n\nThe application provides the following routes:\n\n- `/` - Redirects to tag list\n- `/tag` - Tag list page (标签管理)\n- `/tag/create` - Create new tag page\n- `/tag/:tagId` - Tag detail and edit page\n\n**Note**: The actual complete route path is `tag/tag/*` due to the module base path prefix.\n\n## Components\n\n### Integrated Pages\n\nFrom `@cozeloop/tag-components`:\n\n- **TagsListPage**: Browse and manage all tags\n- **TagsCreatePage**: Create new tags\n- **TagsDetailPage**: View and edit tag details\n\n**Note**: Per the codebase TODO, page-level components are currently exported from `@cozeloop/tag-components` but should be moved to this package in future refactoring.\n\n## API Reference\n\n### Default Export\n\nThe package exports a single React component that provides the complete tag management application with built-in routing.\n\n```typescript\nimport TagApp from '@cozeloop/tag-pages';\n```\n\n### Route Configuration\n\nThe tag module uses a consistent route configuration:\n\n- **Module Base Path**: `tag`\n- **Tag List Path**: `tag/tag` (used for navigation and breadcrumbs)\n- All pages receive `tagListPagePath` prop for consistent navigation\n\n## Dependencies\n\nThis package integrates with:\n\n- `@cozeloop/tag-components`: Core tag UI components and page implementations\n- `react-router-dom`: Routing functionality\n\n### Development Dependencies\n\n- `@cozeloop/i18n-adapter`: Internationalization support\n- `@coze-arch/eslint-config`: ESLint configuration\n- `@coze-arch/ts-config`: TypeScript configuration\n- `@coze-arch/vitest-config`: Testing configuration\n\n## Development\n\nThis package is built with:\n\n- TypeScript for type safety\n- React 18+ for UI components\n- React Router for navigation\n- Vitest for testing\n- ESLint for code quality\n- Storybook for component development\n\n### Scripts\n\n```bash\n# Build the package\nnpm run build\n\n# Run Storybook development server\nnpm run dev\n\n# Run linting\nnpm run lint\n\n# Run tests\nnpm run test\n\n# Run tests with coverage\nnpm run test:cov\n```\n\n## Architecture Notes\n\nThis package currently serves as a routing wrapper around `@cozeloop/tag-components`. According to the codebase TODO, future refactoring should:\n\n- Move page-level components from `@cozeloop/tag-components` to this package\n- Keep only UI components in `@cozeloop/tag-components`\n- Improve separation of concerns between components and pages\n\n## Contributing\n\nThis package is part of the CozeLoop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n","isInternal":false,"tokens":865,"sizeBytes":3822}],"systemPromptSnippet":"\n\n# AGENTS.md\n\nThis file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.\n\n> 开始任务前先通读本文件；涉及架构决策时读 `ARCHITECTURE.md`；进入具体模块时读模块代码。\n\n## 项目概要\n\nCoze Loop 是一个开源的 LLM 评测与可观测性平台，提供 Prompt 开发调试、评测（评测集 + 评估器 + 实验）、可观测性（Trace/Span）、模型集成（OpenAI / Volcengine Ark）等能力。采用 Go 后端（DDD 6 模块，Hertz + Kitex）+ TypeScript/React 前端（Rush.js 59 包）的多语言单体仓库架构，Thrift IDL 共享契约。\n\n## 文档体系\n\n| 层级 | 文件 | 职责 |\n|------|------|------|\n| L0 入口 | `AGENTS.md`（本文件） | 项目全貌、核心约束、导航 |\n| L1 架构 | `ARCHITECTURE.md` | 系统架构、代码地图、依赖关系、不变量 |\n| L1 专题 | `docs/AGENTS.md` | 中层索引，串联 reference/ 和 guidance/ |\n| L3 参考 | `docs/reference/backend-modules-api.md` | 后端 6 模块职责、分层、API 路由 |\n| L3 参考 | `docs/reference/frontend-packages.md` | 前端 59 包分层结构 |\n| L3 指南 | `docs/guidance/deployment-guide.md` | Docker Compose / Helm 部署 |\n| L3 指南 | `docs/guidance/idl-codegen-guide.md` | IDL 变更后代码生成流程 |\n\n## 导航表\n\n| 我想… | 去哪里 |\n|-------|--------|\n| 了解仓库整体架构和模块关系 | `ARCHITECTURE.md` |\n| 查找 docs 下的专题文档 | `docs/AGENTS.md` |\n| 了解后端 6 个 DDD 模块的职责和 API | `docs/reference/backend-modules-api.md` |\n| 了解前端 59 包的分层结构 | `docs/reference/frontend-packages.md` |\n| 部署 Coze Loop（Docker / Helm） | `docs/guidance/deployment-guide.md` |\n| 修改 IDL 后生成代码 | `docs/guidance/idl-codegen-guide.md` |\n| 修改数据库表结构 | 本文件「开发流程」→ Step 3-4 |\n| 添加新的 API 接口 | 本文件「开发流程」→ Step 1-2 → Step 6 |\n| 运行本地开发环境 | `make compose-up-dev` |\n| 了解错误码定义规范 | 本文件「开发流程」→ Step 7 |\n| 执行 lint 检查 | `cd backend && golangci-lint run --config ../.github/.golangci.yaml --fix` |\n\n## 仓库结构\n\n```\ncoze-loop/\n├── idl/thrift/coze/loop/ # Thrift IDL（前后端共享契约，同步源）\n│ ├── /domain/ # 开源领域实体\n│ ├── /domain_openapi/# OpenAPI 领域实体\n│ └── /coze.loop.*.thrift # 服务接口\n├── backend/\n│ ├── cmd/ # 服务入口（main.go HTTP, consumer.go MQ）\n│ ├── api/ # Hertz 网关层（生成 + handler）\n│ ├── modules/ # 6 个 DDD 业务模块\n│ │ ├── evaluation/ # 评测（实验 / 评估器 / 评测集）\n│ │ ├── observability/ # 可观测性（Trace / Span）\n│ │ ├── prompt/ # Prompt 管理\n│ │ ├── data/ # 数据管理（Dataset）\n│ │ ├── llm/ # LLM 模型集成\n│ │ └── foundation/ # 基础（用户 / 空间 / API Key）\n│ ├── infra/ # 共享基础设施（DB, Redis, ClickHouse, MQ, middleware）\n│ ├── pkg/ # 共享工具库\n│ ├── kitex_gen/ # Kitex 生成代码 ⚠️ 禁止手动修改\n│ ├── loop_gen/ # Loop 生成代码 ⚠️ 禁止手动修改\n│ └── script/ # 代码生成脚本\n│ ├── cloudwego/code_gen.sh # IDL → Go\n│ ├── gorm_gen/generate.go # SQL → GORM Model\n│ └── errorx/code_gen.py # 错误码生成\n├── frontend/ # Rush.js 前端 monorepo（59 包）\n│ ├── apps/cozeloop/ # 主 SPA（React 18, Rsbuild, react-router, zustand）\n│ ├── packages/ # loop-pages, loop-modules, loop-components, loop-base\n│ ├── config/ # eslint-config, ts-config, vitest-config 等\n│ └── infra/ # IDL 转 TypeScript 工具等\n├── release/deployment/\n│ ├── docker-compose/ # Docker 部署（conf/ + bootstrap/）\n│ └── helm-chart/ # Kubernetes 部署\n└── common/ # git-hooks（Rush 管理）\n```\n\n## 核心约束\n\n### 1. DDD 分层纪律\n\n每个 `backend/modules//` 遵循三层架构，依赖方向单向：\n\n```\napi/ → application/ → domain/ ← infra/\n```\n\n- **domain/** 定义接口，**infra/** 实现接口，domain **绝不**引用 infra\n- Application 层负责 DTO↔DO 转换、用例编排\n- Repository 的事务只在 infra 层启动\n\n### 2. IDL 优先\n\n`idl/thrift/` 是接口契约的同步源。商业化 IDL 仓库的 `open/` 目录从此处同步。修改 IDL 后必须运行代码生成。\n\n### 3. 生成代码不可手动修改\n\n- `backend/kitex_gen/` — Kitex 生成\n- `backend/loop_gen/` — Loop 本地调用生成\n- `backend/api/router_gen.go` — Hertz 路由生成\n- `**/wire_gen.go` — Wire DI 生成\n- `**/gorm_gen/**` — GORM 模型生成\n\n### 4. 向前兼容\n\n已有企业用户二开部署。IDL API / Domain 核心接口 / 配置文件 / 存储 Schema 均要求向前兼容。新增字段必须 optional，数据库只允许加列。\n\n### 5. SQL 双路径同步\n\n修改数据库表时，以下两个目录必须保持一致：\n- `release/deployment/docker-compose/bootstrap/mysql-init/`（Docker）\n- `release/deployment/helm-chart/charts/app/bootstrap/init/mysql/init-sql/`（Helm）\n\n修改表还需要在 `patch-sql/` 写 ALTER 语句。CI 会通过 `mysql-schema-check` 工作流校验两侧一致性。\n\n### 6. 前端依赖分层\n\n前端 6 层依赖结构（Level-1 到 Level-6），高层级只能依赖低层级，禁止反向依赖。商业版与开源版差异通过 Adapter 模式解耦（`adapter-interfaces/` → `*-adapter/` → `components-with-adapter/`）。\n\n## 后端开发流程\n\n```\nStep 1: IDL 定义 → Step 2: 代码生成 → Step 3: MySQL Schema → Step 4: GORM Gen\n→ Step 5: 配置文件 → Step 6: 业务代码 → Step 7: 错误码 → Step 8: 国际化\n→ Step 9: UT → Step 10: golint\n```\n\n详细步骤见 `docs/guidance/idl-codegen-guide.md`（Step 1-2）和 `docs/guidance/deployment-guide.md`（部署配置）。\n\n**Wire 依赖注入**：修改 `wire.go` 后运行 `wire generate` 重新生成 `wire_gen.go`。禁止手动编辑 `wire_gen.go`。\n\n**代码复用约束**：新增功能前必须先搜索 codebase 是否已有相同/类似实现，有则复用或扩展，不得新建重复文件。\n\n## 常用命令\n\n### 后端（Go）\n\n| 操作 | 命令 |\n|------|------|\n| Go 编译 | `cd backend && go build ./...` |\n| 全量测试 | `cd backend && go test -gcflags=\"all=-N -l\" ./...` |\n| 单测（指定包） | `cd backend && go test -gcflags=\"all=-N -l\" ./modules//...` |\n| 单测（指定函数） | `cd backend && go test -gcflags=\"all=-N -l\" -run TestFuncName ./modules//...` |\n| CI 级测试（含 race） | `cd backend && go test -gcflags=\"all=-N -l\" -race -v -coverprofile=coverage.out -coverpkg=./... ./...` |\n| golint 修复 | `cd backend && golangci-lint run --config ../.github/.golangci.yaml --fix` |\n| IDL 代码生成 | `bash backend/script/cloudwego/code_gen.sh` |\n| GORM 代码生成 | `cd backend && go run script/gorm_gen/generate.go` |\n| 错误码生成 | `backend/script/errorx/code_gen.py ` |\n\n### 前端（Rush.js + pnpm）\n\n| 操作 | 命令 |\n|------|------|\n| 安装依赖 | `node common/scripts/install-run-rush.js install` |\n| 全量构建 | `node common/scripts/install-run-rush.js rebuild --verbose` |\n| 开发服务器 | `cd frontend/apps/cozeloop && npm run dev` |\n| Lint | `cd frontend/apps/cozeloop && npm run lint` |\n| 测试 | `cd frontend/apps/cozeloop && npm run test` |\n| TypeScript 检查 | `cd frontend/apps/cozeloop && npm run build:ts` |\n\n### 部署\n\n| 操作 | 命令 |\n|------|------|\n| 本地 dev 部署 | `make compose-up-dev` |\n| 本地 debug 部署（含 Delve） | `make compose-up-debug` |\n| 停止 dev | `make compose-down-dev` |\n| 停止并清理 volumes | `make compose-down-v-dev` |\n| Helm 部署 | `make helm-up` |\n| 查看 Pod 状态 | `make helm-pod` |\n\n### PR 标题格式\n\nPR 标题必须符合 `[][] ` 格式，CI 会校验。\n\n- type: `feat`, `fix`, `docs`, `style`, `refactor`, `perf`, `test`, `chore`, `build`, `ci`\n- scope: `all`, `idl`, `frontend`, `backend`, `infra`, `workflow`, `prompt`, `evaluation`, `trace`, `model`, `tag`, `dataset`, `foundation`\n\n示例：`[feat][evaluation] add offline metric support`\n\n\n# AGENTS.md\n\nThis file provides guidance to Claude Code (claude.ai/code) when working with docs in this repository.\n\n> 中层索引，串联 reference/（事实说明）和 guidance/（操作手册）。\n\n## 文件树\n\n```\ndocs/\n├── AGENTS.md ← 本文件\n├── reference/\n│ ├── backend-modules-api.md # 后端 6 模块职责、分层、API 路由\n│ └── frontend-packages.md # 前端 59 包分层结构\n└── guidance/\n ├── deployment-guide.md # Docker Compose / Helm 部署指南\n └── idl-codegen-guide.md # IDL 变更后代码生成完整流程\n```\n\n## 导航\n\n| 我想… | 文件 |\n|-------|------|\n| 了解后端某个模块的职责和 API 路由 | `reference/backend-modules-api.md` |\n| 了解前端包的分层和依赖关系 | `reference/frontend-packages.md` |\n| 部署 Coze Loop 到 Docker 或 K8s | `guidance/deployment-guide.md` |\n| 修改 IDL 后走完代码生成流程 | `guidance/idl-codegen-guide.md` |\n\n## 文档分类原则\n\n- **reference/**：事实说明——描述\"是什么\"，不随任务变化\n- **guidance/**：操作手册——描述\"怎么做\"，面向具体操作步骤\n\n\n# @coze-arch/pkg-root-webpack-plugin\n\n> 用于支持 `@` 根目录引用的插件\n\n## Overview\n\nThis package is part of the Coze Studio monorepo and provides architecture functionality. It includes hook, plugin.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@coze-arch/pkg-root-webpack-plugin\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@coze-arch/pkg-root-webpack-plugin';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Hook\n- Plugin\n\n## API Reference\n\n### Exports\n\n- `default PkgRootWebpackPlugin;`\n- `PkgRootWebpackPlugin ;`\n\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Studio monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n\n\n# @coze-arch/postcss-plugin\n\nA postcss plugin to add namespace prefix for all css selector\n\n## Overview\n\nThis package is part of the Coze Studio monorepo and provides architecture functionality. It serves as a core component in the Coze Studio ecosystem.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@coze-arch/postcss-plugin\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@coze-arch/postcss-plugin';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Core functionality for Coze Studio\n- TypeScript support\n- Modern ES modules\n\n## API Reference\n\nPlease refer to the TypeScript definitions for detailed API documentation.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Studio monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n\n\n# @cozeloop/account\n\nCozeLoop account\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides authentication functionality. It includes hook, store, service.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/account\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@cozeloop/account';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Hook\n- Store\n- Service\n\n## API Reference\n\n### Exports\n\n- `useUserStore, setUserInfo`\n- `useSpaceStore,\n setSpace,\n PERSONAL_ENTERPRISE_ID,`\n- `useLogin`\n- `useRegister`\n- `useLoginStatus`\n- `useLogout`\n- `useCheckLogin`\n- `userService`\n- `authnService`\n- `spaceService`\n\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n\n\n# @cozeloop/api-schema\n\nCoze Loop 的 API Schema 定义包。\n\n## 安装\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/api-schema\": \"workspace:*\"\n }\n}\n```\n\n```bash\nrush update\n```\n\n## 更新 API Schema\n\n当后端 API 发生变更时，运行以下命令更新：\n\n```bash\nrushx update\n```\n\n### 指定分支\n\n默认从 `main` 分支拉取 IDL 定义。如需从其他分支更新，可以修改 [package.json](./package.json) 中 `prethrift` 脚本的 `--branch` 参数：\n\n```json\n{\n \"scripts\": {\n \"prethrift\": \"bash ./scripts/download-thrift.sh --branch=your-branch\"\n }\n}\n```\n\n然后执行 `rushx update` 即可从指定分支拉取最新的 API Schema。\n\n## License\n\nApache-2.0\n\n\n# @cozeloop/hooks\n\nHooks for CozeLoop\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides community features functionality. It includes modal.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/hooks\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@cozeloop/hooks';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Modal\n\n## API Reference\n\n### Exports\n\n- `useRefresh`\n- `useModalData`\n- `useMouseDownOffset`\n- `useBreadcrumb`\n- `useNavbarCollapsed`\n\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n\n\n# @coze-studio/bot-env-adapter\n\n> Environment configuration adapter for bot applications with multi-region support\n\n## Project Overview\n\nThe `@coze-studio/bot-env-adapter` package provides a centralized environment configuration management system for bot applications. It consolidates environment variables, feature flags, and business configurations into a type-safe, region-aware adapter that supports different deployment environments (CN, SG, VA) and build types (local, online, offline, test).\n\nThis package was originally extracted from `apps/bot/env` to provide reusable environment configuration management across the bot ecosystem.\n\n## Features\n\n- **Multi-Region Support**: Configures environments for China (CN), Singapore (SG), and Virginia (VA) regions\n- **Environment-Aware Configuration**: Automatically selects appropriate configurations based on build type and region\n- **Type Safety**: Auto-generated TypeScript definitions ensure type safety across the application\n- **Feature Flags**: Centralized feature flag management for different environments and regions\n- **Business Configuration**: Environment-specific business settings and API configurations\n- **Build-Time Validation**: Validates required environment variables at build time\n\n## Get Started\n\n### Installation\n\nInstall the package in your workspace:\n\n```bash\n# Add to your package.json dependencies\n\"@coze-studio/bot-env-adapter\": \"workspace:*\"\n\n# Run rush update to install\nrush update\n```\n\n### Basic Usage\n\n```typescript\nimport { GLOBAL_ENVS } from '@coze-studio/bot-env-adapter';\n\n// Access environment variables\nconsole.log(GLOBAL_ENVS.REGION); // 'cn' | 'sg' | 'va'\nconsole.log(GLOBAL_ENVS.BUILD_TYPE); // 'local' | 'online' | 'offline' | 'test'\nconsole.log(GLOBAL_ENVS.BOT_BRAND_NAME); // Region-specific brand name\n\n// Access feature flags\nif (GLOBAL_ENVS.FEATURE_ENABLE_SSO) {\n // Enable SSO functionality\n}\n\n// Access business configurations\nconst appId = GLOBAL_ENVS.APP_ID;\nconst cdnUrl = GLOBAL_ENVS.CDN;\n```\n\n### Runtime Environment\n\n```typescript\nimport { runtimeEnv } from '@coze-studio/bot-env-adapter/runtime';\n\n// Access runtime environment information\nconsole.log(runtimeEnv.isPPE); // Production environment check\n```\n\n### Type Definitions\n\n```typescript\nimport type { TConfigEnv } from '@coze-studio/bot-env-adapter/typings';\n\n// Use predefined types for configuration\nconst myConfig: TConfigEnv = {\n cn: {\n boe: 'boe-value',\n inhouse: 'inhouse-value',\n release: 'release-value',\n },\n sg: {\n inhouse: 'sg-inhouse-value',\n release: 'sg-release-value',\n },\n va: {\n release: 'va-release-value',\n },\n};\n```\n\n## API Reference\n\n### Core Exports\n\n#### `GLOBAL_ENVS`\nThe main export containing all environment variables, feature flags, and configurations.\n\n```typescript\nimport { GLOBAL_ENVS } from '@coze-studio/bot-env-adapter';\n\n// Base environment variables\nGLOBAL_ENVS.BUILD_TYPE // Build environment type\nGLOBAL_ENVS.REGION // Deployment region\nGLOBAL_ENVS.NODE_ENV // Node environment\nGLOBAL_ENVS.CDN // CDN URL for current environment\n\n// Feature flags\nGLOBAL_ENVS.FEATURE_ENABLE_SSO // SSO feature toggle\nGLOBAL_ENVS.FEATURE_ENABLE_APP_GUIDE // App guide feature\nGLOBAL_ENVS.FEATURE_GOOGLE_LOGIN // Google login support\n\n// Business configurations\nGLOBAL_ENVS.APP_ID // Application ID\nGLOBAL_ENVS.BOT_BRAND_NAME // Brand name for current region\nGLOBAL_ENVS.GOOGLE_CLIENT_ID // Google OAuth client ID\n```\n\n#### `extractEnvValue(config: TConfigEnv): T`\nUtility function to extract environment-specific values based on current region and build type.\n\n```typescript\nimport { extractEnvValue } from '@coze-studio/bot-env-adapter';\n\nconst apiUrl = extractEnvValue({\n cn: {\n boe: 'https://api-boe.example.cn',\n inhouse: 'https://api-inhouse.example.cn',\n release: 'https://api.example.cn',\n },\n sg: {\n inhouse: 'https://api-inhouse.example.com',\n release: 'https://api.example.com',\n },\n va: {\n release: 'https://api-va.example.com',\n },\n});\n```\n\n### Configuration Structure\n\n#### Base Configuration (`base.ts`)\nContains fundamental environment variables and regional judgments:\n- Build type and version information\n- Regional flags (IS_OVERSEA, IS_CN_REGION, etc.)\n- CDN configurations\n- Development mode flags\n\n#### Feature Flags (`features.ts`)\nBoolean flags controlling feature availability:\n- Authentication features (SSO, Google login, etc.)\n- Regional feature differences\n- Version-specific feature toggles\n\n#### Business Configurations (`configs.ts`)\nEnvironment-specific business settings:\n- API keys and application IDs\n- External service configurations\n- Legal document URLs\n- Platform-specific settings\n\n### Type Definitions\n\nThe package automatically generates TypeScript definitions in `src/typings.d.ts` based on the environment configuration. These types are available for import:\n\n```typescript\n// Auto-generated types based on actual configuration\ndeclare const BUILD_TYPE: 'local' | 'online' | 'offline' | 'test';\ndeclare const REGION: 'cn' | 'sg' | 'va';\ndeclare const FEATURE_ENABLE_SSO: boolean;\n// ... and many more\n```\n\n## Development\n\n### Project Structure\n\n```\nsrc/\n├── index.ts # Main entry point, exports GLOBAL_ENVS\n├── base.ts # Base environment variables and regional flags\n├── features.ts # Feature flag configurations\n├── configs.ts # Business-specific configurations\n├── typings.d.ts # Auto-generated type definitions\n├── runtime/\n│ └── index.ts # Runtime environment utilities\n├── utils/\n│ ├── config-helper.ts # Configuration extraction utilities\n│ └── current-branch.ts # Git branch detection\n└── configs/\n └── volcano.ts # Volcano platform configurations\n```\n\n### Configuration Guidelines\n\nWhen adding new environment configurations, follow these conventions:\n\n1. **Use `extractEnvValue` for environment-specific values**:\n```typescript\nconst MY_CONFIG = extractEnvValue({\n cn: {\n boe: 'boe-value',\n inhouse: 'inhouse-value',\n release: 'release-value',\n },\n sg: {\n inhouse: 'sg-inhouse-value',\n release: 'sg-release-value',\n },\n va: {\n release: 'va-release-value',\n },\n});\n```\n\n2. **Ensure all environments are covered** to prevent configuration gaps\n3. **Update the `envs` object** in `src/index.ts` to include new configurations\n4. **Run the build script** to regenerate type definitions\n\n### Build Process\n\nThe package includes an automated TypeScript definition generator:\n\n```bash\nnpm run build\n```\n\nThis command:\n1. Analyzes the `envs` object in `src/index.ts`\n2. Generates type definitions in `src/typings.d.ts`\n3. Compiles TypeScript files\n\n### Environment Variables\n\nSet these environment variables to control the adapter behavior:\n\n- `BUILD_TYPE`: Build environment ('local' | 'online' | 'offline' | 'test')\n- `REGION`: Deployment region ('cn' | 'sg' | 'va')\n- `CUSTOM_VERSION`: Version type ('inhouse' | 'release')\n- `NODE_ENV`: Node environment ('development' | 'production' | 'test')\n- `VERBOSE`: Set to 'true' to log all environment values\n\n### Testing\n\n```bash\nnpm run test # Run tests\nnpm run test:cov # Run tests with coverage\nnpm run lint # Run linting\n```\n\n## Dependencies\n\n### Runtime Dependencies\nThis package has no runtime dependencies, making it lightweight and suitable for both client and server environments.\n\n### Development Dependencies\n- **@coze-arch/eslint-config**: Workspace ESLint configuration\n- **@coze-arch/ts-config**: Workspace TypeScript configuration\n- **@coze-arch/vitest-config**: Workspace Vitest configuration\n- **ts-morph**: TypeScript AST manipulation for type generation\n- **sucrase**: Fast TypeScript compiler for build scripts\n\n## License\n\nApache-2.0\n\n\n# @coze-arch/bot-env\n\n> A TypeScript-based environment variable management system for the bot-studio monorepo, providing compile-time type safety and runtime environment configuration.\n\n## Features\n\n- 🔧 **Compile-time Environment Variables**: Access to environment variables with full TypeScript support\n- 🏗️ **Multi-environment Support**: Handles different deployment environments (BOE, production, development)\n- 🌍 **Multi-region Configuration**: Supports CN, SG, and VA regions with region-specific configurations\n- 🎯 **Feature Flags**: Built-in feature toggle system for conditional functionality\n- 📝 **Auto-generated Types**: Automatically generates TypeScript declarations from environment configuration\n- 🔒 **Type Safety**: Full TypeScript support with strict typing for all environment variables\n- ⚡ **Runtime Environment Access**: Provides runtime environment detection and configuration\n\n## Get Started\n\n### Installation\n\n```bash\n# Install the package\nrush add -p @coze-arch/bot-env\n\n# Update dependencies\nrush update\n```\n\n### Basic Usage\n\n```typescript\n// Import compile-time environment variables\nimport { GLOBAL_ENVS } from '@coze-arch/bot-env';\n\n// Access environment variables with full type safety\nconsole.log(GLOBAL_ENVS.REGION); // 'cn' | 'sg' | 'va'\nconsole.log(GLOBAL_ENVS.IS_PROD); // boolean\nconsole.log(GLOBAL_ENVS.BUILD_TYPE); // 'local' | 'online' | 'offline' | 'test'\n\n// Import runtime environment utilities\nimport { runtimeEnv } from '@coze-arch/bot-env/runtime';\n\n// Access runtime environment information\nconsole.log(runtimeEnv.isPPE); // boolean\n```\n\n### TypeScript Declarations\n\n```typescript\n// Import TypeScript declarations\n/// \n\n// All environment variables are available as global constants\ndeclare const REGION: 'cn' | 'sg' | 'va';\ndeclare const IS_PROD: boolean;\ndeclare const FEATURE_ENABLE_SSO: boolean;\n// ... and many more\n```\n\n## API Reference\n\n### GLOBAL_ENVS\n\nThe main export containing all environment variables organized by category:\n\n#### Base Environment Variables\n- `BUILD_TYPE`: Build environment type (`'local' | 'online' | 'offline' | 'test'`)\n- `CUSTOM_VERSION`: Version type (`'inhouse' | 'release'`)\n- `REGION`: Deployment region (`'cn' | 'sg' | 'va'`)\n- `NODE_ENV`: Node environment (`'production' | 'development' | 'test'`)\n- `IS_PROD`: Production environment flag\n- `IS_BOE`: BOE environment flag\n- `IS_OVERSEA`: Overseas deployment flag\n- `IS_RELEASE_VERSION`: Release version flag\n\n#### Feature Flags\n- `FEATURE_ENABLE_SSO`: Single Sign-On feature\n- `FEATURE_ENABLE_APP_GUIDE`: Application guide feature\n- `FEATURE_ENABLE_MSG_DEBUG`: Message debugging feature\n- `FEATURE_AWEME_LOGIN`: Aweme login integration\n- `FEATURE_GOOGLE_LOGIN`: Google login integration\n- And many more feature toggles...\n\n#### Configuration Variables\n- `CDN`: Content delivery network URL\n- `UPLOAD_CDN`: Upload CDN configuration\n- `COZE_DOMAIN`: Coze service domain\n- `APP_ID`: Application identifier\n- `APP_KEY`: Application key\n- Various service-specific configurations\n\n### Runtime Environment\n\n```typescript\nimport { runtimeEnv } from '@coze-arch/bot-env/runtime';\n\n// Runtime environment detection\nruntimeEnv.isPPE // boolean - Production-like environment detection\n```\n\n### Build Scripts\n\n```typescript\nimport { build } from '@coze-arch/bot-env/build';\n\n// Generate TypeScript declarations from environment configuration\nbuild();\n```\n\n## Development\n\n### Project Structure\n\n```\nsrc/\n├── index.ts # Main exports\n├── runtime/ # Runtime environment utilities\n├── typings.d.ts # Auto-generated TypeScript declarations\n└── global.d.ts # Global type definitions\n\nscripts/\n├── build.ts # Build script exports\n└── index.ts # Build script runner\n```\n\n### Environment Configuration\n\nThis package acts as a wrapper around `@coze-studio/bot-env-adapter`, which provides the actual environment configuration logic. The adapter package includes:\n\n- **Base configuration**: Core environment variables like region, build type, and deployment flags\n- **Feature flags**: Toggle switches for various application features\n- **Business configs**: Service-specific configuration values\n- **Configuration helpers**: Utilities for environment-specific value extraction\n\n### Auto-generated Types\n\nThe package automatically generates TypeScript declarations based on the environment configuration. The build process:\n\n1. Analyzes the `envs` object in the source code\n2. Extracts type information for each environment variable\n3. Generates corresponding TypeScript declarations\n4. Updates the `typings.d.ts` file with the latest types\n\n### Environment-specific Configuration\n\nUse the `extractEnvValue` utility for environment-specific configurations:\n\n```typescript\nconst API_ENDPOINT = extractEnvValue({\n cn: {\n boe: 'https://boe.api.example.com',\n inhouse: 'https://inhouse.api.example.com',\n release: 'https://api.example.com'\n },\n sg: {\n inhouse: 'https://sg-inhouse.api.example.com',\n release: 'https://sg.api.example.com'\n },\n va: {\n release: 'https://va.api.example.com'\n }\n});\n```\n\n### Running Tests\n\n```bash\n# Run tests\nrush test -t @coze-arch/bot-env\n\n# Run tests with coverage\nrush test:cov -t @coze-arch/bot-env\n```\n\n### Building\n\n```bash\n# Build the package\nrush build -t @coze-arch/bot-env\n\n# Generate type definitions\nrush build:types -t @coze-arch/bot-env\n```\n\n## Dependencies\n\n### Runtime Dependencies\n- `@coze-studio/bot-env-adapter`: Core environment configuration adapter\n\n### Development Dependencies\n- `@coze-arch/eslint-config`: ESLint configuration\n- `@coze-arch/ts-config`: TypeScript configuration\n- `@coze-arch/vitest-config`: Vitest testing configuration\n- `ts-morph`: TypeScript AST manipulation for type generation\n- `sucrase`: Fast TypeScript/JSX compiler\n- `vitest`: Testing framework\n\n## License\n\nApache-2.0 License - see package.json for details.\n\n---\n\nFor more information about environment configuration patterns and best practices, refer to the [bot-studio monorepo documentation](../../docs/).\n\n\n# @coze-arch/bot-flags\n\nfeature gating for bot studio\n\n## Overview\n\nThis package is part of the Coze Studio monorepo and provides architecture functionality. It serves as a core component in the Coze ecosystem.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@coze-arch/bot-flags\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@coze-arch/bot-flags';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Core functionality for Coze Studio\n- TypeScript support\n- Modern ES modules\n\n## API Reference\n\n### Exports\n\n- `type FEATURE_FLAGS, type FetchFeatureGatingFunction`\n- `getFlags`\n- `useFlags`\n- `pullFeatureFlags`\n\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Studio monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n\n\n# @coze-arch/bot-md-box-adapter\n\n> Project template for react component with storybook.\n\n## Features\n\n- [x] eslint & ts\n- [x] esm bundle\n- [x] umd bundle\n- [x] storybook\n\n## Commands\n\n- init: `rush update`\n- dev: `npm run dev`\n- build: `npm run build`\n\n\n# @coze-arch/bot-typings\n\nA comprehensive TypeScript type definitions package extracted from the bot application, providing essential type declarations for the Coze bot platform. This package centralizes common type definitions, interfaces, and module declarations to ensure type safety across the bot ecosystem.\n\n## Features\n\n- **Global Type Declarations**: Provides type definitions for various file formats (images, stylesheets, SVG)\n- **Common Utility Types**: Includes utility types like `Expand`, `PartialRequired`, and `Obj` for enhanced type manipulation\n- **Platform-Specific Types**: Defines interfaces for browser APIs, window objects, and navigator extensions\n- **User & Authentication Types**: Comprehensive type definitions for user data, authentication flows, and OAuth\n- **Teamspace & Routing Types**: Type definitions for dynamic routing parameters and teamspace functionality\n- **Zero Runtime Impact**: Pure TypeScript declarations with no runtime dependencies\n\n## Get Started\n\n### Installation\n\nInstall the package in your Rush.js monorepo:\n\n```bash\n# Add to your package.json\n\"@coze-arch/bot-typings\": \"workspace:*\"\n\n# Run Rush update to install\nrush update\n```\n\n### Basic Usage\n\nImport the main type definitions:\n\n```typescript\n// Import the main type definitions\nimport \"@coze-arch/bot-typings\";\n\n// Import specific modules\nimport { BotPageFromEnum, Obj, Expand, PartialRequired } from \"@coze-arch/bot-typings/common\";\nimport { DynamicParams } from \"@coze-arch/bot-typings/teamspace\";\n```\n\n## API Reference\n\n### Common Types\n\n#### `BotPageFromEnum`\nDefines the source of bot detail pages:\n\n```typescript\nenum BotPageFromEnum {\n Bot = 'bot', // Bot list\n Explore = 'explore', // Explore list\n Store = 'store',\n Template = 'template',\n}\n```\n\n#### Utility Types\n\n**`Obj`** - Generic object type:\n```typescript\ntype Obj = Record;\n```\n\n**`Expand`** - Expands intersection types for better readability:\n```typescript\ntype Intersection = { a: string } & { b: number };\ntype Result = Expand;\n// Result: { a: string; b: number }\n```\n\n**`PartialRequired`** - Makes specific fields required:\n```typescript\ninterface Agent {\n id?: string;\n name?: string;\n desc?: string;\n}\ntype Result = PartialRequired;\n// Result: { id: string; name: string; desc?: string }\n```\n\n### Teamspace Types\n\n#### `DynamicParams`\nDefines route parameters for teamspace navigation:\n\n```typescript\ninterface DynamicParams extends Record {\n space_id?: string;\n bot_id?: string;\n plugin_id?: string;\n workflow_id?: string;\n dataset_id?: string;\n doc_id?: string;\n tool_id?: string;\n invite_key?: string;\n product_id?: string;\n mock_set_id?: string;\n conversation_id: string; // Required\n commit_version?: string;\n scene_id?: string;\n post_id?: string;\n project_id?: string;\n}\n```\n\n### User & Authentication Types\n\nThe package provides comprehensive types under the `DataItem` namespace:\n\n#### `UserInfo`\nComplete user information interface:\n```typescript\ninterface UserInfo {\n user_id_str: string;\n name: string;\n screen_name: string;\n avatar_url: string;\n email?: string;\n // ... many more fields\n}\n```\n\n#### Authentication Types\n- `AuthLoginParams` - OAuth login parameters\n- `AuthorizeResponse` - Authorization response structure\n- `SendCodeData` - Verification code response\n- `UserCheckResponse` - User validation response\n\n### Global Module Declarations\n\nThe package automatically provides type declarations for:\n\n**Image Files:**\n```typescript\n// .jpeg, .jpg, .webp, .gif, .png files\nimport myImage from './image.png'; // string\n```\n\n**Stylesheets:**\n```typescript\n// .less, .css files\nimport styles from './styles.less'; // { [key: string]: string }\n```\n\n**SVG Files:**\n```typescript\n// .svg files\nimport { ReactComponent } from './icon.svg'; // React.FunctionComponent\nimport icon from './icon.svg'; // any (depends on svgDefaultExport config)\n```\n\n### Browser API Extensions\n\n**Window Interface Extensions:**\n```typescript\n// IDE plugin support\nwindow.editorDispose?.();\n\n// Mini-program integration\nwindow.tt?.miniProgram.postMessage({ data: {...} });\n\n// Coze app integration\nwindow.__cozeapp__?.setLoading?.(true);\n```\n\n**Navigator Extensions:**\n```typescript\n// Standalone app detection\nif (navigator.standalone) {\n // Running as standalone web app\n}\n```\n\n## Development\n\n### Project Structure\n\n```\nsrc/\n├── index.d.ts # Main type definitions and module declarations\n├── common.ts # Common utility types and enums\n├── teamspace.ts # Teamspace-related type definitions\n├── data_item.d.ts # User and authentication type definitions\n├── navigator.d.ts # Navigator API extensions\n└── window.d.ts # Window object extensions\n```\n\n### Building\n\nThis package contains only TypeScript declarations and requires no build step:\n\n```bash\nnpm run build # No-op (exits with code 0)\n```\n\n### Linting\n\n```bash\nnpm run lint\n```\n\n### Adding New Types\n\n1. **Module Declarations**: Add to `index.d.ts`\n2. **Common Utilities**: Add to `common.ts`\n3. **Domain-Specific Types**: Create new files and export from appropriate entry points\n4. **Global Extensions**: Add to `window.d.ts` or `navigator.d.ts`\n\nRemember to update the `exports` field in `package.json` for new modules.\n\n## Dependencies\n\n### Runtime Dependencies\nNone - this package contains only TypeScript type definitions.\n\n### Development Dependencies\n- **@coze-arch/bot-env**: Workspace package providing environment-specific typings\n- **@coze-arch/eslint-config**: Shared ESLint configuration\n- **@coze-arch/ts-config**: Shared TypeScript configuration\n- **TypeScript 5.8.2**: Core TypeScript compiler\n- **React Types**: For component and SVG type definitions\n\n## License\n\nApache-2.0\n\n---\n\n**Author**: fanwenjie.fe@bytedance.com\n\nThis package is part of the Coze bot platform architecture and provides essential type safety for bot development workflows.\n\n\n# @cozeloop/components\n\ncommon components for cozeloop\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides ui component functionality. It serves as a core component in the Coze Loop ecosystem.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/components\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@cozeloop/components';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Core functionality for Coze Loop\n- TypeScript support\n- Modern ES modules\n\n## API Reference\n\n### Exports\n\n- `ColumnSelector, type ColumnItem`\n- `TooltipWhenDisabled`\n- `LoopTable`\n- `TableWithPagination,\n DEFAULT_PAGE_SIZE,\n PAGE_SIZE_OPTIONS,`\n- `PageError,\n PageLoading,\n PageNoAuth,\n PageNoContent,\n PageNotFound,`\n- `TableColActions`\n- `LoopTabs`\n- `LargeTxtRender`\n- `InputSlider`\n- `handleCopy, sleep`\n\n*And more...*\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- React\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n\n\n# @cozeloop/env-adapter\n\nA community features package for the Coze Loop ecosystem\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides community features functionality. It serves as a core component in the Coze Loop ecosystem.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/env-adapter\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@cozeloop/env-adapter';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Core functionality for Coze Loop\n- TypeScript support\n- Modern ES modules\n\n## API Reference\n\n### Exports\n\n- `const envs = new Env();`\n\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n\n\n# @coze-arch/fetch-stream\n\nfetch stream vanilla js\n\n## Overview\n\nThis package is part of the Coze Studio monorepo and provides api & networking functionality. It serves as a core component in the Coze ecosystem.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@coze-arch/fetch-stream\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@coze-arch/fetch-stream';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Core functionality for Coze Studio\n- TypeScript support\n- Modern ES modules\n\n## API Reference\n\n### Exports\n\n- `isFetchStreamErrorInfo,\n fetchStream,\n FetchStreamErrorCode,\n type FetchSteamConfig,\n type FetchStreamErrorInfo,`\n\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Studio monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n\n\n# @cozeloop/guard\n\nCozeloop 权限守卫组件，用于管理和控制用户界面中的权限点。\n\n## 安装\n\n```bash\npnpm add @cozeloop/guard\n```\n\n## 特性\n\n- 支持多种权限控制方式（隐藏、只读、拦截等）\n- 提供上下文管理权限状态\n- 支持路由级别的权限控制\n- 可扩展的权限点定义\n\n## 使用方法\n\n### 基础使用\n\n```tsx\nimport { Guard, GuardPoint } from '@cozeloop/guard';\n\nfunction MyComponent() {\n return (\n \n \n \n );\n}\n```\n\n### 路由权限控制\n\n```tsx\nimport { GuardRoute, GuardPoint } from '@cozeloop/guard';\n\nfunction ProtectedRoute() {\n return (\n \n
受保护的内容
\n \n );\n}\n```\n\n### 权限上下文\n\n```tsx\nimport { GuardProvider } from '@cozeloop/guard';\n\nfunction App() {\n // 自定义权限策略\n const customStrategy = {\n // 实现 GuardStrategy 接口\n };\n\n return (\n \n \n \n );\n}\n```\n\n## Features\n\n- [x] eslint & ts\n- [x] esm bundle\n- [x] umd bundle\n- [x] storybook\n\n## Commands\n\n- init: `rush update`\n- dev: `npm run dev`\n- build: `npm run build`\n\n\n# @cozeloop/intl\n\nInternationalization(intl) runtime for CozeLoop\n\n\n# @coze-arch/logger\n\nA comprehensive logging and error reporting library for the Coze architecture ecosystem, providing unified console logging, React error boundaries, and performance tracing capabilities.\n\n## Features\n\n- **Unified Logging Interface**: Centralized logging with support for multiple log levels (info, success, warning, error, fatal)\n- **Console Logging**: Console output for debugging and development\n- **React Error Boundaries**: Ready-to-use error boundary components with automatic error reporting\n- **Performance Tracing**: Duration tracking for multi-step operations and workflows\n- **Context-Aware Logging**: Namespace and scope-based log organization\n- **TypeScript Support**: Full TypeScript definitions and type safety\n- **Pending Queue System**: Queues logs when reporter is not initialized, executes when ready\n- **Console Control**: Configurable console output for different environments\n\n## Get Started\n\n### Installation\n\n```bash\n# Add to your Rush.js workspace\nrush add -p @coze-arch/logger --dev\n\n# Update dependencies\nrush update\n```\n\n### Basic Usage\n\n#### Console Logging\n\n```typescript\nimport { logger } from '@coze-arch/logger';\n\n// Simple string messages\nlogger.info('Operation completed successfully');\nlogger.warning('This is a warning message');\nlogger.error({ message: 'Something went wrong', error: new Error('Details') });\n\n// With context and metadata\nlogger.info({\n message: 'User action completed',\n namespace: 'user-management',\n scope: 'profile-update',\n meta: {\n userId: '12345',\n action: 'profile_update',\n duration: 150\n }\n});\n```\n\n#### Event Reporting\n\n```typescript\nimport { reporter } from '@coze-arch/logger';\n\n// Initialize reporter\nreporter.init();\n\n// Log custom events\nreporter.event({\n eventName: 'user_action',\n namespace: 'analytics',\n meta: {\n action: 'button_click',\n component: 'header'\n }\n});\n\n// Report errors\nreporter.error({\n message: 'API request failed',\n error: new Error('Network timeout'),\n namespace: 'api',\n scope: 'user-service'\n});\n```\n\n## API Reference\n\n### Logger\n\nThe main logger instance for console output and basic logging.\n\n```typescript\nimport { logger, Logger } from '@coze-arch/logger';\n\n// Create custom logger with preset context\nconst apiLogger = logger.createLoggerWith({\n ctx: {\n namespace: 'api',\n scope: 'user-service'\n }\n});\n\n// Available log levels\nlogger.info(message | options);\nlogger.success(message | options);\nlogger.warning(message | options);\nlogger.error(options); // requires error object\n\n// Setup configuration\nlogger.setup({ 'no-console': true }); // Disable console output\n```\n\n### Reporter\n\nHandles event reporting and structured logging.\n\n```typescript\nimport { reporter, Reporter } from '@coze-arch/logger';\n\n// Initialize reporter\nreporter.init();\n\n// Create reporter with preset context\nconst moduleReporter = reporter.createReporterWithPreset({\n namespace: 'auth',\n scope: 'login',\n meta: { version: '1.0.0' }\n});\n\n// Custom logs\nreporter.info({ message: 'Info log', meta: { key: 'value' } });\nreporter.warning({ message: 'Warning log' });\nreporter.error({ message: 'Error log', error: new Error() });\n\n// Custom events\nreporter.event({ eventName: 'user_login' });\nreporter.successEvent({ eventName: 'operation_complete' });\nreporter.errorEvent({ eventName: 'login_failed', error: new Error() });\n```\n\n### Performance Tracing\n\nTrack duration across multiple steps in a workflow.\n\n```typescript\nimport { reporter } from '@coze-arch/logger';\n\n// Create tracer for a specific event\nconst { trace } = reporter.tracer({ eventName: 'api_request' });\n\n// Track steps with automatic duration calculation\ntrace('start');\n// ... some operation\ntrace('validation_complete');\n// ... more operations\ntrace('request_sent');\n// ... final operations\ntrace('success', {\n meta: { responseSize: 1024 }\n});\n\n// Handle errors in tracing\ntrace('error', {\n error: new Error('Request failed'),\n meta: { statusCode: 500 }\n});\n```\n\n### Error Boundary\n\nReact component for catching and reporting JavaScript errors.\n\n```typescript\nimport { ErrorBoundary } from '@coze-arch/logger';\n\nfunction App() {\n return (\n {\n console.log('Error caught:', error);\n }}\n onReset={() => {\n // Reset app state\n }}\n >\n \n \n );\n}\n\nfunction ErrorFallback({ error, resetErrorBoundary }) {\n return (\n
\n

Something went wrong:

\n 
{error.message}
\n \n
\n );\n}\n```\n\n### Error Boundary Hooks\n\n```typescript\nimport { useErrorBoundary, useErrorHandler } from '@coze-arch/logger';\n\nfunction ComponentWithErrorHandling() {\n const { showBoundary } = useErrorBoundary();\n const handleError = useErrorHandler();\n\n const handleAsyncOperation = async () => {\n try {\n await riskyOperation();\n } catch (error) {\n // Report to error boundary\n showBoundary(error);\n // Or handle manually\n handleError(error);\n }\n };\n}\n```\n\n### Logger Context\n\nProvide logger instances through React context.\n\n```typescript\nimport { LoggerContext, useLogger } from '@coze-arch/logger';\n\n// Provider\nfunction App() {\n const logger = new Logger({\n ctx: { namespace: 'app' }\n });\n\n return (\n \n \n \n );\n}\n\n// Consumer\nfunction Component() {\n const logger = useLogger();\n\n logger.info('Component mounted');\n}\n```\n\n### Types and Interfaces\n\n```typescript\nimport type {\n LogLevel,\n CommonLogOptions,\n CustomLog,\n CustomErrorLog,\n CustomEvent,\n ErrorEvent,\n LoggerCommonProperties\n} from '@coze-arch/logger';\n\n// Log levels\nenum LogLevel {\n INFO = 'info',\n SUCCESS = 'success',\n WARNING = 'warning',\n ERROR = 'error',\n FATAL = 'fatal'\n}\n\n// Common log options interface\ninterface CommonLogOptions {\n namespace?: string;\n scope?: string;\n level?: LogLevel;\n action?: LogAction[];\n message?: string;\n eventName?: string;\n meta?: Record;\n error?: Error;\n}\n```\n\n## Development\n\n### Running Tests\n\n```bash\n# Run all tests\nrush test\n\n# Run tests with coverage\nrush test:cov\n\n# Run tests for this package only\ncd packages/arch/logger\nrushx test\n```\n\n### Linting\n\n```bash\n# Lint the package\nrushx lint\n\n# Auto-fix linting issues\nrushx lint --fix\n```\n\n### Building\n\n```bash\n# Build the package\nrushx build\n\n# Type checking\nrushx ts-check\n```\n\n## Dependencies\n\n### Production Dependencies\n\n- **@coze-arch/bot-env**: Environment configuration utilities\n- **@coze-arch/bot-typings**: Shared type definitions\n- **lodash-es**: Utility functions library\n- **react**: React library for error boundary components\n- **react-error-boundary**: React error boundary utilities\n\n### Development Dependencies\n\n- **@coze-arch/eslint-config**: Shared ESLint configuration\n- **@coze-arch/ts-config**: Shared TypeScript configuration\n- **@coze-arch/vitest-config**: Shared Vitest configuration\n- **@types/lodash-es**: TypeScript definitions for lodash-es\n- **@types/react**: TypeScript definitions for React\n- **vitest**: Testing framework\n\n## License\n\nThis package is part of the Coze architecture ecosystem and follows the project's licensing terms.\n\n\n# @cozeloop/loop-lng\n\nLanguage data of Cozeloop.\n\n## Overview\n\nThis package is part of the Coze Studio monorepo and provides architecture functionality. It serves as a core component in the Coze Studio ecosystem.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/loop-lng\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport {} from /* exported functions/components */ '@cozeloop/loop-lng';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Core functionality for Coze Studio\n- TypeScript support\n- Modern ES modules\n\n## API Reference\n\n### Exports\n\n- `localeEn, localeZhCN`\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Studio monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n\n\n# @cozeloop/biz-hooks-adapter\n\nBiz hooks for CozeLoop\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides community features functionality. It serves as a core component in the Coze Loop ecosystem.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/biz-hooks-adapter\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@cozeloop/biz-hooks-adapter';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Core functionality for Coze Loop\n- TypeScript support\n- Modern ES modules\n\n## API Reference\n\n### Exports\n\n- `useSpace`\n- `useUserInfo`\n- `useNavigateModule`\n- `useOpenWindow`\n- `useRouteInfo`\n- `useCozeLocation`\n- `useBenefit, type BenefitConfig`\n- `useFetchUserBenefit`\n- `useDemoSpace`\n\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n\n\n# @cozeloop/stores\n\nStores For Devops\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides state management functionality. It includes store.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/stores\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@cozeloop/stores';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Store\n\n## API Reference\n\n### Exports\n\n- `useUIStore, UIEvent`\n- `type BreadcrumbItemConfig`\n\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n\n\n# @cozeloop/tea-adapter\n\nA community features package for the Coze Loop ecosystem\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides community features functionality. It serves as a core component in the Coze Loop ecosystem.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/tea-adapter\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@cozeloop/tea-adapter';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Core functionality for Coze Loop\n- TypeScript support\n- Modern ES modules\n\n## API Reference\n\n### Exports\n\n- `start, init, config, stop, sendEvent, isStarted`\n- `type ParamsTypeDefine = Record>;`\n\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n\n\n# @cozeloop/toolkit\n\nToolkit For Devops\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides utilities functionality. It serves as a core component in the Coze Loop ecosystem.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/toolkit\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@cozeloop/toolkit';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Core functionality for Coze Loop\n- TypeScript support\n- Modern ES modules\n\n## API Reference\n\n### Exports\n\n- `notEmpty`\n- `getSafeFileName`\n- `formatTimestampToString,\n safeParseJson,\n formateMsToSeconds,`\n- `CozeLoopStorage`\n- `type LocalStorageKeys`\n- `formatNumberWithCommas,\n formatNumberInThousands,\n formatNumberInMillions,`\n- `safeJsonParse`\n- `fileDownload`\n\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n\n\n# @cozeloop/adapter-interfaces\n\nCozeLoop adapter interfaces\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides adapter interfaces definition.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/adapter-interfaces\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported type */ } from '@cozeloop/adapter-interfaces';\n\n// or\n\nimport { /* exported type */ } from '@cozeloop/adapter-interfaces/evaluate';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n\n\n# @cozeloop/upload-toolkit-adapter\n\nA utilities package for the Coze Loop ecosystem\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides utilities functionality. It includes api, evaluation.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/upload-toolkit-adapter\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@cozeloop/upload-toolkit-adapter';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Api\n- Evaluation\n\n## API Reference\n\nPlease refer to the TypeScript definitions for detailed API documentation.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n\n\n# @cozeloop/biz-config-adapter\n\nBiz config for CozeLoop\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides community features functionality. It serves as a core component in the Coze Loop ecosystem.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/biz-config-adapter\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported config */ } from '@cozeloop/biz-config-adapter';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Core functionality for Coze Loop\n- TypeScript support\n- Modern ES modules\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n\n\n# @cozeloop/biz-hooks-adapter\n\nBiz hooks for CozeLoop\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides community features functionality. It serves as a core component in the Coze Loop ecosystem.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/biz-hooks-adapter\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@cozeloop/biz-hooks-adapter';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Core functionality for Coze Loop\n- TypeScript support\n- Modern ES modules\n\n## API Reference\n\n### Exports\n\n- `useSpace`\n- `useUserInfo`\n- `useNavigateModule`\n- `useOpenWindow`\n- `useRouteInfo`\n- `useCozeLocation`\n- `useBenefit, type BenefitConfig`\n- `useFetchUserBenefit`\n- `useDemoSpace`\n\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- Modern JavaScript\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n\n\n# @cozeloop/components\n\ncommon components for cozeloop\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides ui component functionality. It serves as a core component in the Coze Loop ecosystem.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/components\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@cozeloop/components';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Core functionality for Coze Loop\n- TypeScript support\n- Modern ES modules\n\n## API Reference\n\n### Exports\n\n- `ColumnSelector, type ColumnItem`\n- `TooltipWhenDisabled`\n- `LoopTable`\n- `TableWithPagination,\n DEFAULT_PAGE_SIZE,\n PAGE_SIZE_OPTIONS,`\n- `PageError,\n PageLoading,\n PageNoAuth,\n PageNoContent,\n PageNotFound,`\n- `TableColActions`\n- `LoopTabs`\n- `LargeTxtRender`\n- `InputSlider`\n- `handleCopy, sleep`\n\n*And more...*\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- React\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n\n\n# @cozeloop/evaluate-components\n\n> Project template for react component with storybook.\n\n## Features\n\n- [x] eslint & ts\n- [x] esm bundle\n- [x] umd bundle\n- [x] storybook\n\n## Commands\n\n- init: `rush update`\n- dev: `npm run dev`\n- build: `npm run build`\n\n\n# @cozeloop/prompt-components\n\nPrompt common components for cozeloop\n\n## Overview\n\nThis package is part of the Coze Loop monorepo and provides ui component functionality. It includes editor, prompt.\n\n## Getting Started\n\n### Installation\n\nAdd this package to your `package.json`:\n\n```json\n{\n \"dependencies\": {\n \"@cozeloop/prompt-components\": \"workspace:*\"\n }\n}\n```\n\nThen run:\n\n```bash\nrush update\n```\n\n### Usage\n\n```typescript\nimport { /* exported functions/components */ } from '@cozeloop/prompt-components';\n\n// Example usage\n// TODO: Add specific usage examples\n```\n\n## Features\n\n- Editor\n- Prompt\n\n## API Reference\n\n### Exports\n\n- `PromptBasicEditor,\n PromptBasicEditorProps,\n PromptBasicEditorRef,`\n- `PromptDiffEditor`\n- `PromptEditor,\n PromptEditorProps,\n PromptMessage,`\n- `PopoverModelConfigEditor`\n- `PopoverModelConfigEditorQuery`\n- `BasicModelConfigEditor`\n- `ModelSelectWithObject`\n- `DevLayout`\n- `PromptCreate`\n- `getPlaceholderErrorContent`\n\n*And more...*\n\nFor detailed API documentation, please refer to the TypeScript definitions.\n\n## Development\n\nThis package is built with:\n\n- TypeScript\n- React\n- Vitest for testing\n- ESLint for code quality\n\n## Contributing\n\nThis package is part of the Coze Loop monorepo. Please follow the monorepo contribution guidelines.\n\n## License\n\nApache-2.0\n\n\n"}