persona-core-opencode 1.0.0 → 1.0.2

package/README.md

@@ -0,0 +1,604 @@
+# persona-core-opencode
+
+使用 [opencode](https://github.com/opencode-ai/opencode) 作为执行引擎的 PersonaCore 实现。
+
+PersonaCore 是一个 AI 人格/角色框架，允许你定义具有特定能力和行为风格的 AI 角色，并通过程序化的方式与其交互。
+
+## 特性
+
+- **声明式人格定义**：通过 TypeScript 类型定义人格的系统提示和可用能力
+- **动态工具生成**：根据 ActionNodeType 自动生成 opencode 兼容的工具文件
+- **多种执行类型**：支持 API 调用、文件读写、HTTP 请求、LLM 调用等
+- **会话管理**：自动管理会话状态，支持多轮对话
+- **工具调用追踪**：记录所有工具调用历史
+
+## 安装
+
+```bash
+npm install persona-core-opencode
+```
+
+### 前置要求
+
+- Node.js >= 18
+- [opencode CLI](https://github.com/opencode-ai/opencode) 已安装并配置
+
+## 快速开始
+
+### 1. 创建客户端
+
+```typescript
+import { PersonaCoreClient, CreatePersonaInput, ActionNodeType } from 'persona-core-opencode';
+
+// 创建客户端实例
+const client = await PersonaCoreClient.create({
+  workspaceRoot: './workspace',  // 可选：工作空间根目录
+  opencodePath: 'opencode',      // 可选：opencode 命令路径
+  defaultTimeoutMs: 60000,       // 可选：默认超时时间
+});
+```
+
+### 2. 定义并创建 Persona
+
+```typescript
+// 定义动作类型
+const actionTypes: ActionNodeType[] = [
+  {
+    kind: 'action',
+    id: 'save_note',
+    name: '保存笔记',
+    description: '将笔记内容保存到文件',
+    executionType: 'file_write',
+    inputFields: [
+      { name: 'filePath', required: true, typeHint: 'string', description: '文件路径' },
+      { name: 'content', required: true, typeHint: 'string', description: '笔记内容' },
+    ],
+    outputFields: [
+      { name: 'success', required: true, typeHint: 'boolean' },
+      { name: 'filePath', required: true, typeHint: 'string' },
+    ],
+  },
+];
+
+// 创建 Persona
+const personaId = await client.createPersona({
+  name: '笔记助手',
+  description: '帮助用户记录和整理笔记',
+  systemPrompt: `你是一个专业的笔记助手。
+你可以使用 save_note 工具来保存用户的笔记。
+始终使用友好、专业的语气与用户交流。`,
+  actionTypes,
+});
+
+console.log(`Persona created: ${personaId}`);
+```
+
+### 3. 发送消息
+
+```typescript
+// 发送消息并获取响应
+const result = await client.sendMessage(
+  personaId,
+  '请帮我记录今天的会议纪要：项目进度良好，下周发布新版本。'
+);
+
+console.log('Response:', result.response);
+console.log('Tool calls:', result.toolCalls);
+
+// 继续对话（使用相同的 session）
+const followUp = await client.sendMessage(
+  personaId,
+  '再补充一点：需要准备发布文档。',
+  { sessionId: result.sessionId }
+);
+```
+
+### 4. 清理资源
+
+```typescript
+// 删除 Persona
+await client.deletePersona(personaId);
+
+// 或清理所有资源
+await client.cleanup();
+```
+
+## 核心概念
+
+### Persona（人格）
+
+Persona 是 PersonaCore 的核心概念，代表一个具有特定能力和行为风格的 AI 角色：
+
+```typescript
+interface Persona {
+  id: PersonaId;           // 唯一标识
+  name: string;            // 名称
+  description?: string;    // 描述
+  systemPrompt: string;    // 系统提示词，定义角色的行为风格
+  actionTypes: ActionNodeType[];  // 可用的动作类型
+  createdAt: Date;
+  updatedAt: Date;
+}
+```
+
+### ActionNodeType（动作节点类型）
+
+定义 Persona 可以执行的具体动作：
+
+```typescript
+interface ActionNodeType {
+  kind: 'action';
+  id: ActionTypeId;              // 动作唯一标识
+  name: string;                  // 语义名称
+  description?: string;          // 描述
+  executionType: ActionExecutionType;  // 执行类型
+  apiConfig?: ApiCallConfig;     // API 调用配置
+  asyncMode?: AsyncModeConfig;   // 异步模式配置
+  inputFields: FieldDefinition[];   // 输入字段
+  outputFields: FieldDefinition[];  // 输出字段
+}
+```
+
+### 执行类型（ActionExecutionType）
+
+系统内置的执行类型：
+
+| 类型 | 说明 | 用途 |
+|-----|------|------|
+| `api_call` | HTTP API 调用 | 调用外部 API 服务 |
+| `file_write` | 文件写入 | 保存内容到文件 |
+| `file_read` | 文件读取 | 读取文件内容 |
+| `http_request` | 通用 HTTP 请求 | 发送 HTTP 请求 |
+| `llm_call` | LLM 调用 | 调用语言模型处理 |
+| `database_query` | 数据库查询 | 执行数据库操作 |
+| `shell_command` | Shell 命令 | 执行系统命令 |
+
+## API 参考
+
+### PersonaCoreClient
+
+主要的客户端 API 类。
+
+#### 构造函数
+
+```typescript
+const client = new PersonaCoreClient(config?: PersonaCoreClientConfig);
+// 或使用静态工厂方法
+const client = await PersonaCoreClient.create(config?: PersonaCoreClientConfig);
+```
+
+**配置选项：**
+
+| 属性 | 类型 | 默认值 | 说明 |
+|-----|------|-------|------|
+| `workspaceRoot` | `string` | `process.cwd()` | 工作空间根目录 |
+| `opencodePath` | `string` | `'opencode'` | opencode 命令路径 |
+| `defaultTimeoutMs` | `number` | `30000` | 默认超时时间（毫秒） |
+
+#### 方法
+
+##### `createPersona(input: CreatePersonaInput): Promise<string>`
+
+创建新的 Persona。
+
+```typescript
+const personaId = await client.createPersona({
+  name: 'My Assistant',
+  systemPrompt: 'You are a helpful assistant.',
+  actionTypes: [...],
+});
+```
+
+##### `deletePersona(personaId: string): Promise<void>`
+
+删除 Persona 及其关联的所有 session。
+
+```typescript
+await client.deletePersona(personaId);
+```
+
+##### `getPersona(personaId: string): RegisteredPersona | undefined`
+
+获取已注册的 Persona。
+
+```typescript
+const persona = client.getPersona(personaId);
+```
+
+##### `hasPersona(personaId: string): boolean`
+
+检查 Persona 是否存在。
+
+```typescript
+if (client.hasPersona(personaId)) {
+  // Persona exists
+}
+```
+
+##### `sendMessage(personaId: string, message: string, options?: SendMessageOptions): Promise<SessionExecutionResult>`
+
+向 Persona 发送消息并获取响应。
+
+```typescript
+const result = await client.sendMessage(personaId, 'Hello!', {
+  sessionId: 'existing-session-id',  // 可选：继续已有会话
+  timeoutMs: 60000,                  // 可选：超时时间
+});
+```
+
+**返回值 `SessionExecutionResult`：**
+
+```typescript
+interface SessionExecutionResult {
+  sessionId: string;           // 会话 ID
+  success: boolean;            // 是否成功
+  response?: string;           // 响应文本
+  toolCalls: ToolCallRecord[]; // 工具调用记录
+  error?: string;              // 错误信息
+}
+
+interface ToolCallRecord {
+  tool: string;                    // 工具名称
+  args: Record<string, unknown>;   // 调用参数
+  result?: string;                 // 调用结果
+  error?: string;                  // 错误信息
+}
+```
+
+##### `cleanup(): Promise<void>`
+
+清理所有资源（关闭 session、删除工作空间）。
+
+```typescript
+await client.cleanup();
+```
+
+## API 调用配置
+
+对于 `api_call` 类型的动作，可以通过 `apiConfig` 配置详细的 HTTP 请求：
+
+```typescript
+const apiAction: ActionNodeType = {
+  kind: 'action',
+  id: 'search_web',
+  name: '网页搜索',
+  description: '搜索网页内容',
+  executionType: 'api_call',
+  apiConfig: {
+    url: 'https://api.example.com/search?q=${query}',
+    method: 'GET',
+    headers: {
+      type: 'static',
+      values: {
+        'Authorization': 'Bearer ${API_KEY}',
+        'Content-Type': 'application/json',
+      },
+    },
+    response: {
+      type: 'json',
+      extract: {
+        results: 'data.items',
+        total: 'meta.total',
+      },
+    },
+    timeoutMs: 30000,
+  },
+  inputFields: [
+    { name: 'query', required: true, typeHint: 'string', description: '搜索关键词' },
+  ],
+  outputFields: [
+    { name: 'results', required: true, typeHint: 'Array<{title: string, url: string}>' },
+    { name: 'total', required: true, typeHint: 'number' },
+  ],
+};
+```
+
+### URL 模板
+
+URL 支持变量替换：
+
+```typescript
+url: 'https://api.example.com/users/${userId}/posts/${postId}'
+```
+
+### 请求头配置
+
+**静态请求头：**
+
+```typescript
+headers: {
+  type: 'static',
+  values: {
+    'Authorization': 'Bearer token',
+    'X-Custom-Header': 'value',
+  },
+}
+```
+
+**模板请求头（使用 Nunjucks）：**
+
+```typescript
+headers: {
+  type: 'template',
+  template: '{"Authorization": "Bearer {{ apiKey }}", "X-User": "{{ userId }}"}',
+}
+```
+
+### 请求体配置
+
+**JSON 请求体：**
+
+```typescript
+body: {
+  contentType: 'json',
+  includeFields: ['title', 'content'],  // 只包含指定字段
+  // 或
+  excludeFields: ['internal'],          // 排除指定字段
+}
+```
+
+**模板请求体：**
+
+```typescript
+body: {
+  contentType: 'template',
+  template: '{"query": "{{ query }}", "limit": {{ limit | default(10) }}}',
+}
+```
+
+### 响应处理
+
+**提取字段（使用 JSONPath）：**
+
+```typescript
+response: {
+  type: 'json',
+  extract: {
+    imageUrl: 'data.images.0.url',
+    status: 'meta.status',
+  },
+}
+```
+
+**保存到文件：**
+
+```typescript
+response: {
+  type: 'json',
+  saveToFile: {
+    enabled: true,
+    pathField: 'outputPath',      // 从输入参数获取路径
+    dataPath: 'data.image',       // 从响应中提取数据
+    dataFormat: 'base64',         // 数据格式
+    outputField: 'savedFilePath', // 输出字段名
+  },
+}
+```
+
+## 异步任务支持
+
+对于需要轮询等待结果的异步 API，可以配置 `asyncMode`：
+
+```typescript
+const asyncAction: ActionNodeType = {
+  kind: 'action',
+  id: 'generate_video',
+  name: '生成视频',
+  executionType: 'api_call',
+  apiConfig: {
+    url: 'https://api.example.com/video/generate',
+    method: 'POST',
+    body: { contentType: 'json' },
+  },
+  asyncMode: {
+    isAsync: true,
+    defaultCheckIntervalMs: 5000,
+    defaultTimeoutMs: 300000,
+    taskIdPath: 'data.taskId',
+    statusCheck: {
+      url: 'https://api.example.com/video/status/${taskId}',
+      method: 'GET',
+      extract: {
+        statusPath: 'status',
+        completedValues: ['completed', 'success'],
+        failedValues: ['failed', 'error'],
+        progressPath: 'progress',
+      },
+    },
+    resultFetch: {
+      extractFromStatus: {
+        videoUrl: 'data.videoUrl',
+      },
+    },
+  },
+  inputFields: [...],
+  outputFields: [...],
+};
+```
+
+## 项目结构
+
+```
+persona-core-opencode/
+├── src/
+│   ├── index.ts                 # 主入口，导出公共 API
+│   ├── client/
+│   │   └── personaCoreClient.ts # 客户端 API
+│   ├── persona/
+│   │   └── personaRegistry.ts   # Persona 注册和管理
+│   ├── session/
+│   │   ├── sessionManager.ts    # 会话管理和执行
+│   │   └── sessionHandle.ts     # 会话句柄
+│   ├── generators/
+│   │   └── toolFileGenerator.ts # 工具文件生成
+│   └── types/
+│       ├── common.ts            # 通用类型
+│       ├── nodes.ts             # 节点类型定义
+│       └── persona.ts           # Persona 类型定义
+├── suites/                      # 示例 Persona 套件
+│   ├── comic/                   # 漫画生成 Persona
+│   └── humor/                   # 幽默安慰师 Persona
+├── tests/                       # 测试文件
+│   ├── unit/                    # 单元测试
+│   └── integration/             # 集成测试
+├── package.json
+├── tsconfig.json
+└── vitest.config.ts
+```
+
+## 工作原理
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│                     PersonaCoreClient                            │
+├─────────────────────────────────────────────────────────────────┤
+│  createPersona()  →  PersonaRegistry.registerPersona()          │
+│      │                    │                                      │
+│      │                    ├── 创建工作空间目录                    │
+│      │                    ├── 生成 .opencode/tools/*.ts          │
+│      │                    └── 生成 .opencode/rules/persona.md    │
+│      │                                                           │
+│  sendMessage()    →  SessionManager.executeThinking()           │
+│      │                    │                                      │
+│      │                    ├── 启动 opencode run CLI              │
+│      │                    ├── 通过 stdin 发送消息                 │
+│      │                    ├── 解析 stdout JSONL 输出             │
+│      │                    └── 返回响应和工具调用记录              │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+1. **Persona 注册**：当创建 Persona 时，系统会：
+   - 在工作空间中创建目录结构
+   - 根据 `actionTypes` 生成 opencode 工具文件（TypeScript）
+   - 将 `systemPrompt` 保存为 opencode 规则文件
+
+2. **消息执行**：当发送消息时，系统会：
+   - 创建或复用 session
+   - 启动 `opencode run` CLI 进程
+   - 通过 stdin 发送用户消息
+   - 解析 stdout 的 JSONL 输出
+   - 提取响应文本和工具调用记录
+
+## 环境变量
+
+参考 `.env.example` 配置所需的环境变量：
+
+```bash
+# LLM Provider（根据实际使用的 API 配置）
+DEEPSEEK_KEY=your-api-key
+DEEPSEEK_MODEL=deepseek-v3
+DEEPSEEK_URL=https://api.deepseek.com
+
+# 外部服务 API
+SERPER_KEY=your-serper-key    # 网页搜索
+JINA_KEY=your-jina-key        # 网页内容获取
+
+# 对象存储（如需要保存文件到 OSS）
+OSS_ENDPOINT=http://localhost:9000
+OSS_ACCESS_KEY_ID=minioadmin
+OSS_SECRET_ACCESS_KEY=minioadmin
+```
+
+## 开发
+
+### 安装依赖
+
+```bash
+npm install
+```
+
+### 构建
+
+```bash
+npm run build
+```
+
+### 运行测试
+
+```bash
+# 运行所有测试
+npm run test
+
+# 监听模式
+npm run test:watch
+
+# 类型检查
+npm run typecheck
+```
+
+### 运行示例套件
+
+```bash
+npm run suite
+```
+
+### 发布
+
+```bash
+# 补丁版本
+npm run release:patch
+
+# 次要版本
+npm run release:minor
+
+# 主要版本
+npm run release:major
+```
+
+## 示例：创建一个幽默安慰师
+
+```typescript
+import { PersonaCoreClient, ActionNodeType } from 'persona-core-opencode';
+
+const actionTypes: ActionNodeType[] = [
+  {
+    kind: 'action',
+    id: 'reply',
+    name: '回复',
+    description: '生成幽默的回复内容并保存到文件',
+    executionType: 'file_write',
+    inputFields: [
+      { name: 'filePath', required: true, typeHint: 'string', description: '保存路径' },
+      { name: 'content', required: true, typeHint: 'string', description: '回复内容' },
+    ],
+    outputFields: [
+      { name: 'success', required: true, typeHint: 'boolean' },
+      { name: 'filePath', required: true, typeHint: 'string' },
+    ],
+  },
+];
+
+async function main() {
+  const client = await PersonaCoreClient.create();
+  
+  const personaId = await client.createPersona({
+    name: '幽默安慰师',
+    description: '用幽默的方式安慰别人',
+    systemPrompt: `你是一个幽默的人，特别擅长用幽默的话安慰别人。
+
+你的特点：
+1. 总能用轻松幽默的方式化解对方的负面情绪
+2. 善于用比喻和类比来让人开心
+3. 会在安慰中加入恰到好处的调侃，但不会伤害对方
+
+当用户向你倾诉时，使用 reply 工具保存你的幽默回复。`,
+    actionTypes,
+  });
+
+  const result = await client.sendMessage(
+    personaId,
+    '今天代码写了一天都没跑通，太难受了...'
+  );
+
+  console.log('幽默安慰师的回复:', result.response);
+  console.log('保存的文件:', result.toolCalls);
+
+  await client.cleanup();
+}
+
+main().catch(console.error);
+```
+
+## 许可证
+
+MIT License

package/dist/persona/personaRegistry.d.ts

@@ -34,7 +34,7 @@ export declare class PersonaRegistry {
     constructor(config?: PersonaRegistryConfig);
     /**
      * 注册 Persona
-     * 1. 生成唯一 ID
+     * 1. 生成唯一 ID（如果 input.id 已提供，则直接使用）
      * 2. 创建工作目录
      * 3. 生成 tool 文件
      */
@@ -67,12 +67,10 @@ export declare class PersonaRegistry {
      * 获取工作空间根目录
      */
     getWorkspaceRoot(): string;
-    /**
-     * 生成唯一 ID
-     */
-    private generateId;
     /**
      * 生成 Persona 唯一 ID
+     * @param name Persona 名称
+     * @returns 生成的唯一 ID（格式：safeName-shortUuid）
      */
     private generatePersonaId;
 }

package/dist/persona/personaRegistry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"personaRegistry.d.ts","sourceRoot":"","sources":["../../src/persona/personaRegistry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAGlE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,YAAY;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,oBAAoB;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW;IACX,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,cAAc;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,kBAAkB,CAA6C;gBAE3D,MAAM,GAAE,qBAA0B;IAI9C;;;;;OAKG;IACG,eAAe,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC;IA6DjE;;OAEG;IACG,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAUhE;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAI5D;;OAEG;IACH,cAAc,IAAI,iBAAiB,EAAE;IAIrC;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAItC;;OAEG;IACG,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAiB5D;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAM9B;;OAEG;IACH,gBAAgB,IAAI,MAAM;IAI1B;;OAEG;IACH,OAAO,CAAC,UAAU;IAKlB;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAK1B"}
+{"version":3,"file":"personaRegistry.d.ts","sourceRoot":"","sources":["../../src/persona/personaRegistry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAGlE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,YAAY;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,oBAAoB;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW;IACX,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,cAAc;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,kBAAkB,CAA6C;gBAE3D,MAAM,GAAE,qBAA0B;IAI9C;;;;;OAKG;IACG,eAAe,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC;IAgEjE;;OAEG;IACG,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAUhE;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAI5D;;OAEG;IACH,cAAc,IAAI,iBAAiB,EAAE;IAIrC;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAItC;;OAEG;IACG,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAiB5D;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAM9B;;OAEG;IACH,gBAAgB,IAAI,MAAM;IAI1B;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;CAK1B"}

package/dist/persona/personaRegistry.js

@@ -17,15 +17,19 @@ export class PersonaRegistry {
     }
     /**
      * 注册 Persona
-     * 1. 生成唯一 ID
+     * 1. 生成唯一 ID（如果 input.id 已提供，则直接使用）
      * 2. 创建工作目录
      * 3. 生成 tool 文件
      */
     async registerPersona(input) {
+        // 如果提供了 id，直接使用；否则生成新的 id
+        const personaId = input.id
+            ? input.id
+            : this.generatePersonaId(input.name);
         // 创建 Persona 对象
         const now = new Date();
         const persona = {
-            id: input.id || this.generateId(input.name),
+            id: personaId,
             name: input.name,
             description: input.description,
             systemPrompt: input.systemPrompt,
@@ -33,7 +37,6 @@ export class PersonaRegistry {
             createdAt: now,
             updatedAt: now,
         };
-        const personaId = this.generatePersonaId(persona);
         const workspacePath = path.resolve(this.workspaceRoot, personaId);
         const toolsPath = path.join(workspacePath, '.opencode', 'tools');
         // 创建目录结构
@@ -132,19 +135,14 @@ ${persona.systemPrompt}
     getWorkspaceRoot() {
         return this.workspaceRoot;
     }
-    /**
-     * 生成唯一 ID
-     */
-    generateId(name) {
-        const safeName = name.replace(/[^a-zA-Z0-9-]/g, '-').toLowerCase();
-        return safeName;
-    }
     /**
      * 生成 Persona 唯一 ID
+     * @param name Persona 名称
+     * @returns 生成的唯一 ID（格式：safeName-shortUuid）
      */
-    generatePersonaId(persona) {
+    generatePersonaId(name) {
         const shortUuid = uuidv4().slice(0, 8);
-        const safeName = persona.id.replace(/[^a-zA-Z0-9-]/g, '-');
+        const safeName = name.replace(/[^a-zA-Z0-9-]/g, '-').toLowerCase();
         return `${safeName}-${shortUuid}`;
     }
 }

package/dist/persona/personaRegistry.js.map

@@ -1 +1 @@
-{"version":3,"file":"personaRegistry.js","sourceRoot":"","sources":["../../src/persona/personaRegistry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"personaRegistry.js","sourceRoot":"","sources":["../../src/persona/personaRegistry.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "persona-core-opencode",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "PersonaCore implementation using opencode as the execution engine",
   "type": "module",
   "main": "./dist/index.js",