Files

T

xiaoju ca223a19c6 refactor: rename workflow-agent-kit → workflow-util-agent, merge workflow-moderator into cli-workflow

- 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

2026-05-25 10:51:16 +00:00

1.7 KiB

Raw Blame History

@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

bun add @uncaged/workflow-moderator

API

Functions

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

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

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

1.7 KiB Raw Blame History