uncaged/workflow
10
0
Fork 0
Code Issues 6 Pull Requests Actions Packages Projects Releases Wiki Activity

Phase 6 Testing: Agent instance model + npm convention #302

New Issue
Closed
opened 2026-05-18 02:37:56 +00:00 by xiaoju · 0 comments
xiaoju commented 2026-05-18 02:37:56 +00:00
Owner
Copy Link
Copy Source

验证目标

定义 agent instance CAS 节点，重构 agent 包导出约定。

前置

Phase 4 完成（#299, PR #300）

工作内容

1. PackageDescriptor 类型

在 workflow-protocol 定义:

type PackageDescriptor = {
  name: string;
  capabilities: string[];
  configSchema: Record<string, unknown>;  // JSON Schema
};

2. Agent 包标准导出

每个 agent 包（cursor, hermes, llm, react）添加:

  • export const packageDescriptor: PackageDescriptor
  • export function createAgent(config: Config): AgentFn（如果还没有标准化）

3. Agent 实例 CAS 节点

使用 json-cas-workflow 的 agent schema（已定义）:

{ "package": "@uncaged/workflow-agent-cursor", "version": "^1.0.0", "config": { "model": "..." } }

4. thread-start agents 字段

thread-start 的 agents 字段引用 agent instance hash（已在 Phase 4 引擎中预留）。

测试步骤

  • Step 1: packageDescriptor 导出
    每个 agent 包导出 packageDescriptor，包含 name, capabilities, configSchema

  • Step 2: configSchema 合法
    packageDescriptor.configSchema 是合法 JSON Schema

  • Step 3: agent 实例 put + validate
    用 agent schema 存实例节点，validate 通过

  • Step 4: 幂等性
    同一 package + config → 相同 hash; 不同 config → 不同 hash

  • Step 5: thread-start agents 引用
    thread-start 的 agents 字段引用 agent 实例，refs() 正确提取

验证完成标准

✅ 所有 checkbox 打勾
✅ bun test 全过

Ref: #294

## 验证目标 定义 agent instance CAS 节点，重构 agent 包导出约定。 ## 前置 Phase 4 完成（#299, PR #300） ## 工作内容 ### 1. PackageDescriptor 类型 在 workflow-protocol 定义: ```typescript type PackageDescriptor = { name: string; capabilities: string[]; configSchema: Record<string, unknown>; // JSON Schema }; ``` ### 2. Agent 包标准导出 每个 agent 包（cursor, hermes, llm, react）添加: - `export const packageDescriptor: PackageDescriptor` - `export function createAgent(config: Config): AgentFn`（如果还没有标准化） ### 3. Agent 实例 CAS 节点 使用 json-cas-workflow 的 agent schema（已定义）: ```json { "package": "@uncaged/workflow-agent-cursor", "version": "^1.0.0", "config": { "model": "..." } } ``` ### 4. thread-start agents 字段 thread-start 的 agents 字段引用 agent instance hash（已在 Phase 4 引擎中预留）。 ## 测试步骤 - [ ] **Step 1: packageDescriptor 导出** 每个 agent 包导出 packageDescriptor，包含 name, capabilities, configSchema - [ ] **Step 2: configSchema 合法** packageDescriptor.configSchema 是合法 JSON Schema - [ ] **Step 3: agent 实例 put + validate** 用 agent schema 存实例节点，validate 通过 - [ ] **Step 4: 幂等性** 同一 package + config → 相同 hash; 不同 config → 不同 hash - [ ] **Step 5: thread-start agents 引用** thread-start 的 agents 字段引用 agent 实例，refs() 正确提取 ## 验证完成标准 ✅ 所有 checkbox 打勾 ✅ `bun test` 全过 Ref: #294
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
No items
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
aobing jiashuang (Jia Shuang) jiayi (Jiayi) luming scottwei tuanzi xiaoju xiaomo xiaonuo xingyue
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: uncaged/workflow#302
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?