@kedge-agentic/common

Claude Code as a Service 的共享类型 + Zod schema。

类型: 框架无关库 · 状态: public · v0.2.0

用途

@kedge-agentic/common 是 ccaas monorepo 中所有包都依赖的最底层。 它导出:

• 跨包类型: Session, Skill, Message, TokenUsage 等 (./types)
• Zod schema: 运行时校验,用于跨进程边界 (./schemas)
• 常量: admin app 约定、UI 配置默认值等

零框架耦合,仅依赖 zod + uuid。 Agent 子进程、CLI 工具、浏览器、NestJS 服务都能用。

主要导出

import { Session, Skill, TokenUsage } from '@kedge-agentic/common'
import { SessionSchema } from '@kedge-agentic/common/schemas'

用法

// 类型用法
function getCurrentTokens(session: Session): TokenUsage {
  return session.tokenUsage
}

// 运行时校验
import { SessionSchema } from '@kedge-agentic/common/schemas'
const result = SessionSchema.safeParse(payload)
if (result.success) {
  // result.data 是类型安全的 Session
}

依赖

• 运行时: uuid, zod, @types/uuid
• 无 peerDeps

关联包

整个 monorepo 几乎所有包都依赖 common。 跨包类型应该加在这里,而不是局部重复定义。 流程:

1. 在 packages/common/src/types/index.ts 加 interface
2. 从 packages/common/src/index.ts re-export
3. npm run build:common
4. 在消费者包中 import from '@kedge-agentic/common'

构建 / 测试

npm run build:common
npm test -w @kedge-agentic/common