xiaoju
1e9900bed3
- Protocol: AgentFnResult = string | { output, childThread }, RoleOutput.childThread,
ThreadContext.bundleHash for parent state lookup
- Runtime: create-workflow normalizes AgentFnResult, propagates childThread in RoleOutput
- Engine: ExecuteThreadOptions.parentStateHash, appendStateForStep writes childThread,
putStartNode uses parentStateHash
- workflowAsAgent: reads parent head state from threads.json, passes parentStateHash
to child, returns { output, childThread: rootHash }
- Integration test: 4 cases verifying bidirectional Merkle links (306 lines)
Phase 2 of #194 (Merkle Call Stack). Closes #196.
小橘 <xiaoju@shazhou.work>
@uncaged/workflow-util-agent
Shared helpers for CLI-backed workflow agents: assemble prompts from thread context and spawn subprocesses with timeouts.
Used by @uncaged/workflow-agent-cursor and @uncaged/workflow-agent-hermes. Depends on @uncaged/workflow for CAS reads (getContentMerklePayload) and Result typing.
Install
bun add @uncaged/workflow-util-agent @uncaged/workflow
In this monorepo: workspace:* for both packages.
Usage
import { buildAgentPrompt, spawnCli } from "@uncaged/workflow-util-agent";
const prompt = await buildAgentPrompt(agentContext);
const result = await spawnCli("my-cli", ["--json"], { cwd: "/tmp", timeoutMs: 60_000 });
if (!result.ok) { /* handle SpawnCliError */ }
const stdout = result.value;
API overview
| Export | Description |
|---|---|
buildAgentPrompt(ctx) |
System prompt + task + prior step summaries + latest body from CAS; appends uncaged-workflow thread <id> tool hint |
spawnCli(cmd, args, { cwd, timeoutMs }) |
Promise<Result<string, SpawnCliError>>; captures stdout, non-zero exit and spawn failures as err |
SpawnCliConfig |
cwd: string | null, timeoutMs: number | null |
SpawnCliError |
non_zero_exit | timeout | spawn_failed |
SpawnCliResult |
Alias for Result<string, SpawnCliError> |