@longzai-intelligence-collaboration/core 0.0.1

package/README.md

@@ -0,0 +1,53 @@
+# @longzai-intelligence-collaboration/core
+
+collaboration 项目跨域共享的基础层，集中提供六大业务域共用的类型定义与 Zod 校验 Schema。
+
+## 定位
+
+作为 collaboration 工作区的基础设施包，core 不承载业务逻辑，只向 domains、apps、sdk、elysia 等子包输出统一的类型与 Schema，是其他子包依赖的最底层共享件。
+
+## 安装
+
+```bash
+bun add @longzai-intelligence-collaboration/core
+```
+
+## 核心能力
+
+提供跨域共享的类型定义（含会话、房间、消息、协作、Agent、Agent 任务等领域的公共类型）与对应的 Zod 校验 Schema，确保各业务包在类型与校验层面保持一致。
+
+### 领域枚举 Schema 与类型
+
+基于 Zod v4 `z.enum()` 定义枚举 Schema，类型经 `z.infer` 推导，运行时校验与编译期类型一一对应，按业务域分组：
+
+- Agent 域：`AgentType`、`AgentStatus`、`AgentPermission`、`AgentTaskStatus`、`AgentTaskPriority`、`AgentTaskType`
+- 房间域：`RoomType`、`RoomVisibility`、`RoomStatus`
+- 会话域：`SessionRole`、`SessionStatus`、`SessionParticipantType`
+- 消息域：`MessageType`、`MessageSenderType`
+- 协作域：`OperationType`、`ConflictResolutionStrategy`、`SyncStrategy`
+
+每个类型均有同名 `*Schema` 对应（如 `AgentStatus` ↔ `AgentStatusSchema`）。
+
+### 分页 Schema
+
+- `PaginationParams`：通用分页查询参数（`page` 从 1 起、`pageSize` 上限 100，均可选）
+- `PaginatedResult`：通用分页结果（`items`、`total`、`page`、`pageSize`、`totalPages`）
+
+## 快速上手
+
+```ts
+import {
+  AgentStatusSchema,
+  PaginationParamsSchema,
+  type AgentStatus,
+} from '@longzai-intelligence-collaboration/core';
+
+const status: AgentStatus = 'connected';
+AgentStatusSchema.parse(status); // 校验通过
+
+const params = PaginationParamsSchema.parse({ page: 1, pageSize: 20 });
+```
+
+## 实现情况
+
+已实现，作为纯类型与 Schema 包提供完整导出，按项目约定跳过单元测试，被 sdk、elysia、memory、apps 等多包依赖。

package/dist/index.d.ts

@@ -0,0 +1,276 @@
+import { z } from "zod";
+//#region src/types/enums.d.ts
+/**
+ * Agent 类型 Schema
+ * 定义 Agent 的分类类型
+ */
+declare const AgentTypeSchema: z.ZodEnum<{
+  analysis: "analysis";
+  assistant: "assistant";
+  automation: "automation";
+  custom: "custom";
+}>;
+/**
+ * Agent 类型
+ */
+type AgentType = z.infer<typeof AgentTypeSchema>;
+/**
+ * Agent 状态 Schema
+ * 定义 Agent 的连接与运行状态
+ */
+declare const AgentStatusSchema: z.ZodEnum<{
+  connected: "connected";
+  disconnected: "disconnected";
+  error: "error";
+  registered: "registered";
+  suspended: "suspended";
+}>;
+/**
+ * Agent 状态
+ */
+type AgentStatus = z.infer<typeof AgentStatusSchema>;
+/**
+ * Agent 权限级别 Schema
+ * 定义 Agent 的操作权限等级
+ */
+declare const AgentPermissionSchema: z.ZodEnum<{
+  full: "full";
+  read_only: "read_only";
+  read_write: "read_write";
+  restricted: "restricted";
+}>;
+/**
+ * Agent 权限级别
+ */
+type AgentPermission = z.infer<typeof AgentPermissionSchema>;
+/**
+ * Agent 任务状态 Schema
+ * 定义 Agent 任务的生命周期状态
+ */
+declare const AgentTaskStatusSchema: z.ZodEnum<{
+  assigned: "assigned";
+  cancelled: "cancelled";
+  completed: "completed";
+  executing: "executing";
+  failed: "failed";
+  pending: "pending";
+  timeout: "timeout";
+}>;
+/**
+ * Agent 任务状态
+ */
+type AgentTaskStatus = z.infer<typeof AgentTaskStatusSchema>;
+/**
+ * Agent 任务优先级 Schema
+ * 定义 Agent 任务的优先级等级
+ */
+declare const AgentTaskPrioritySchema: z.ZodEnum<{
+  high: "high";
+  low: "low";
+  medium: "medium";
+  urgent: "urgent";
+}>;
+/**
+ * Agent 任务优先级
+ */
+type AgentTaskPriority = z.infer<typeof AgentTaskPrioritySchema>;
+/**
+ * Agent 任务类型 Schema
+ * 定义 Agent 可执行的任务类型
+ */
+declare const AgentTaskTypeSchema: z.ZodEnum<{
+  analysis: "analysis";
+  automation: "automation";
+  custom: "custom";
+  document_edit: "document_edit";
+  message_send: "message_send";
+  whiteboard_draw: "whiteboard_draw";
+}>;
+/**
+ * Agent 任务类型
+ */
+type AgentTaskType = z.infer<typeof AgentTaskTypeSchema>;
+/**
+ * 房间类型 Schema
+ * 定义协作房间的类型分类
+ */
+declare const RoomTypeSchema: z.ZodEnum<{
+  custom: "custom";
+  document: "document";
+  webpage: "webpage";
+  whiteboard: "whiteboard";
+}>;
+/**
+ * 房间类型
+ */
+type RoomType = z.infer<typeof RoomTypeSchema>;
+/**
+ * 房间可见性 Schema
+ * 定义房间的访问可见性级别
+ */
+declare const RoomVisibilitySchema: z.ZodEnum<{
+  invite_only: "invite_only";
+  private: "private";
+  public: "public";
+}>;
+/**
+ * 房间可见性
+ */
+type RoomVisibility = z.infer<typeof RoomVisibilitySchema>;
+/**
+ * 房间状态 Schema
+ * 定义房间的生命周期状态
+ */
+declare const RoomStatusSchema: z.ZodEnum<{
+  active: "active";
+  archived: "archived";
+  closed: "closed";
+}>;
+/**
+ * 房间状态
+ */
+type RoomStatus = z.infer<typeof RoomStatusSchema>;
+/**
+ * 会话角色 Schema
+ * 定义会话参与者的角色等级
+ */
+declare const SessionRoleSchema: z.ZodEnum<{
+  admin: "admin";
+  editor: "editor";
+  owner: "owner";
+  viewer: "viewer";
+}>;
+/**
+ * 会话角色
+ */
+type SessionRole = z.infer<typeof SessionRoleSchema>;
+/**
+ * 会话状态 Schema
+ * 定义会话的连接状态
+ */
+declare const SessionStatusSchema: z.ZodEnum<{
+  connected: "connected";
+  disconnected: "disconnected";
+  reconnecting: "reconnecting";
+}>;
+/**
+ * 会话状态
+ */
+type SessionStatus = z.infer<typeof SessionStatusSchema>;
+/**
+ * 会话参与者类型 Schema
+ * 区分用户和 Agent 两种参与者
+ */
+declare const SessionParticipantTypeSchema: z.ZodEnum<{
+  agent: "agent";
+  user: "user";
+}>;
+/**
+ * 会话参与者类型
+ */
+type SessionParticipantType = z.infer<typeof SessionParticipantTypeSchema>;
+/**
+ * 消息类型 Schema
+ * 定义消息的分类类型
+ */
+declare const MessageTypeSchema: z.ZodEnum<{
+  agent_notification: "agent_notification";
+  agent_request: "agent_request";
+  agent_response: "agent_response";
+  chat: "chat";
+  notification: "notification";
+  operation: "operation";
+  sync: "sync";
+  system: "system";
+}>;
+/**
+ * 消息类型
+ */
+type MessageType = z.infer<typeof MessageTypeSchema>;
+/**
+ * 消息发送者类型 Schema
+ * 区分消息发送者的来源类型
+ */
+declare const MessageSenderTypeSchema: z.ZodEnum<{
+  agent: "agent";
+  system: "system";
+  user: "user";
+}>;
+/**
+ * 消息发送者类型
+ */
+type MessageSenderType = z.infer<typeof MessageSenderTypeSchema>;
+/**
+ * 操作类型 Schema
+ * 定义协作操作的基本类型
+ */
+declare const OperationTypeSchema: z.ZodEnum<{
+  delete: "delete";
+  insert: "insert";
+  move: "move";
+  transform: "transform";
+  update: "update";
+}>;
+/**
+ * 操作类型
+ */
+type OperationType = z.infer<typeof OperationTypeSchema>;
+/**
+ * 冲突解决策略 Schema
+ * 定义协作冲突的解决方式
+ */
+declare const ConflictResolutionStrategySchema: z.ZodEnum<{
+  lww: "lww";
+  merge: "merge";
+  ot: "ot";
+}>;
+/**
+ * 冲突解决策略
+ */
+type ConflictResolutionStrategy = z.infer<typeof ConflictResolutionStrategySchema>;
+/**
+ * 同步策略 Schema
+ * 定义协作数据的同步方式
+ */
+declare const SyncStrategySchema: z.ZodEnum<{
+  manual: "manual";
+  periodic: "periodic";
+  realtime: "realtime";
+}>;
+/**
+ * 同步策略
+ */
+type SyncStrategy = z.infer<typeof SyncStrategySchema>;
+//#endregion
+//#region src/schemas/pagination.schema.d.ts
+/**
+ * 分页参数 Schema
+ * 定义通用的分页查询参数
+ */
+declare const PaginationParamsSchema: z.ZodObject<{
+  page: z.ZodOptional<z.ZodNumber>;
+  pageSize: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * 分页参数类型
+ */
+type PaginationParams = z.infer<typeof PaginationParamsSchema>;
+/**
+ * 分页结果 Schema
+ * 包装分页查询的返回数据
+ *
+ * @template T - 数据项的 Zod Schema 类型
+ */
+declare const PaginatedResultSchema: z.ZodObject<{
+  items: z.ZodArray<z.ZodUnknown>;
+  total: z.ZodNumber;
+  page: z.ZodNumber;
+  pageSize: z.ZodNumber;
+  totalPages: z.ZodNumber;
+}, z.core.$strip>;
+/**
+ * 分页结果类型
+ */
+type PaginatedResult = z.infer<typeof PaginatedResultSchema>;
+//#endregion
+export { type AgentPermission, AgentPermissionSchema, type AgentStatus, AgentStatusSchema, type AgentTaskPriority, AgentTaskPrioritySchema, type AgentTaskStatus, AgentTaskStatusSchema, type AgentTaskType, AgentTaskTypeSchema, type AgentType, AgentTypeSchema, type ConflictResolutionStrategy, ConflictResolutionStrategySchema, type MessageSenderType, MessageSenderTypeSchema, type MessageType, MessageTypeSchema, type OperationType, OperationTypeSchema, type PaginatedResult, PaginatedResultSchema, type PaginationParams, PaginationParamsSchema, type RoomStatus, RoomStatusSchema, type RoomType, RoomTypeSchema, type RoomVisibility, RoomVisibilitySchema, type SessionParticipantType, SessionParticipantTypeSchema, type SessionRole, SessionRoleSchema, type SessionStatus, SessionStatusSchema, type SyncStrategy, SyncStrategySchema };

package/dist/index.js

@@ -0,0 +1 @@
+import{z as e}from"zod";const t=e.enum([`assistant`,`automation`,`analysis`,`custom`]),n=e.enum([`registered`,`connected`,`disconnected`,`suspended`,`error`]),r=e.enum([`full`,`read_write`,`read_only`,`restricted`]),i=e.enum([`pending`,`assigned`,`executing`,`completed`,`failed`,`cancelled`,`timeout`]),a=e.enum([`low`,`medium`,`high`,`urgent`]),o=e.enum([`document_edit`,`whiteboard_draw`,`message_send`,`analysis`,`automation`,`custom`]),s=e.enum([`whiteboard`,`document`,`webpage`,`custom`]),c=e.enum([`public`,`private`,`invite_only`]),l=e.enum([`active`,`archived`,`closed`]),u=e.enum([`owner`,`admin`,`editor`,`viewer`]),d=e.enum([`connected`,`disconnected`,`reconnecting`]),f=e.enum([`user`,`agent`]),p=e.enum([`operation`,`chat`,`notification`,`system`,`sync`,`agent_request`,`agent_response`,`agent_notification`]),m=e.enum([`user`,`agent`,`system`]),h=e.enum([`insert`,`delete`,`update`,`move`,`transform`]),g=e.enum([`lww`,`ot`,`merge`]),_=e.enum([`realtime`,`periodic`,`manual`]),v=e.object({page:e.number().int().min(1).optional(),pageSize:e.number().int().min(1).max(100).optional()}),y=e.object({items:e.array(e.unknown()),total:e.number().int().min(0),page:e.number().int().min(1),pageSize:e.number().int().min(1),totalPages:e.number().int().min(0)});export{r as AgentPermissionSchema,n as AgentStatusSchema,a as AgentTaskPrioritySchema,i as AgentTaskStatusSchema,o as AgentTaskTypeSchema,t as AgentTypeSchema,g as ConflictResolutionStrategySchema,m as MessageSenderTypeSchema,p as MessageTypeSchema,h as OperationTypeSchema,y as PaginatedResultSchema,v as PaginationParamsSchema,l as RoomStatusSchema,s as RoomTypeSchema,c as RoomVisibilitySchema,f as SessionParticipantTypeSchema,u as SessionRoleSchema,d as SessionStatusSchema,_ as SyncStrategySchema};

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@longzai-intelligence-collaboration/core",
+  "version": "0.0.1",
+  "private": false,
+  "license": "UNLICENSED",
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "bun": "./src/index.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "lzi-builder",
+    "build:prod": "NODE_ENV=production bun run build",
+    "prepublishOnly": "bun run build:prod",
+    "typecheck": "bun run typecheck:app && bun run typecheck:node && bun run typecheck:test",
+    "typecheck:app": "lzi-tsgo typecheck tsconfig/app.json",
+    "typecheck:node": "lzi-tsgo typecheck tsconfig/node.json",
+    "typecheck:test": "lzi-tsgo typecheck tsconfig/test.json",
+    "lint": "oxlint && oxfmt --check",
+    "lint:fix": "oxlint --fix && oxfmt",
+    "test": "lzi-bun-cli test",
+    "test:watch": "lzi-bun-cli test --watch",
+    "test:coverage": "lzi-bun-cli test --coverage",
+    "clean": "lzi-dev-cli clean"
+  },
+  "dependencies": {
+    "@longzai-intelligence-shared-kernel/core": "^0.1.4",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {}
+}