xiaoju
ca223a19c6
- Rename packages/workflow-agent-kit → packages/workflow-util-agent - Update all imports, tsconfig references, docs - Delete dead file packages/workflow-util-agent/src/build-agent-prompt.ts - Merge workflow-moderator (62 LOC) into cli-workflow/src/moderator/ - Move workflow-moderator to legacy-packages/ - Add mustache dependency to cli-workflow - Update publish-all.mjs Fixes #512
62 lines
1.7 KiB
Markdown
62 lines
1.7 KiB
Markdown
# @uncaged/workflow-moderator
|
|
|
|
Status-based graph evaluator — determines the next role or `$END` with zero LLM cost.
|
|
|
|
## Overview
|
|
|
|
The moderator (Layer 1) performs a status-based map lookup on the workflow graph. Given the last role and its output, it looks up `graph[lastRole][lastOutput.status]` to find the next `Target` (role + prompt template). The prompt is rendered via Mustache with `lastOutput` as the template context. For `$START`, the unit status `_` is used.
|
|
|
|
**Dependencies:** `@uncaged/workflow-protocol`, `mustache`
|
|
|
|
## Installation
|
|
|
|
```bash
|
|
bun add @uncaged/workflow-moderator
|
|
```
|
|
|
|
## API
|
|
|
|
### Functions
|
|
|
|
```typescript
|
|
function evaluate(
|
|
graph: Record<string, Record<string, Target>>,
|
|
lastRole: string,
|
|
lastOutput: Record<string, unknown> & { status: string },
|
|
): Result<EvaluateResult, Error>
|
|
```
|
|
|
|
Returns `{ ok: true, value: { role, prompt } }` where `role` is the next role name or `"$END"`, and `prompt` is the rendered edge instruction for the agent.
|
|
|
|
### Types
|
|
|
|
```typescript
|
|
type EvaluateResult = {
|
|
role: string;
|
|
prompt: string;
|
|
};
|
|
```
|
|
|
|
The `Result<T, E>` type is local to this package (`{ ok: true; value: T } | { ok: false; error: E }`), not re-exported from `index.ts`.
|
|
|
|
## Usage
|
|
|
|
```typescript
|
|
import { evaluate } from "@uncaged/workflow-moderator";
|
|
import type { Target } from "@uncaged/workflow-protocol";
|
|
|
|
const result = evaluate(graph, lastRole, lastOutput);
|
|
if (result.ok && result.value.role !== "$END") {
|
|
console.log(`Next role: ${result.value.role}, prompt: ${result.value.prompt}`);
|
|
}
|
|
```
|
|
|
|
## Internal Structure
|
|
|
|
```
|
|
src/
|
|
├── index.ts Public exports
|
|
├── evaluate.ts Status-based map lookup + Mustache prompt rendering
|
|
└── types.ts EvaluateResult, Result
|
|
```
|