Files
united-workforce/packages/workflow-agent-cursor
xiaoju 4582274ba4 feat(protocol): AgentFn<Opt> type + createAgentAdapter bridge
Add AgentFn<Opt = void> as the formal agent boundary type:
- Input: ThreadContext (fixed), Output: string (fixed)
- Opt: agent-specific structured options (e.g. { workspace } for Cursor)

Add createAgentAdapter<Opt>(agent, extract) → AdapterFn bridge in
workflow-util-agent, plus createSimpleAgentAdapter for Opt = void.

Also fixes: workflow-cas composite flag + cursor tsconfig reference.

Refs #252
2026-05-14 08:41:22 +00:00
..

@uncaged/workflow-agent-cursor

AgentFn adapter that runs the cursor-agent CLI against a workspace path derived from the thread.

The agent builds a full prompt (system + task + step history via @uncaged/workflow-util-agent), extracts the absolute workspace path with your extract + Zod schema, then spawns cursor-agent with --workspace, model, and non-interactive flags.

Install

bun add @uncaged/workflow-agent-cursor @uncaged/workflow-runtime @uncaged/workflow-util-agent zod

In this monorepo: "@uncaged/workflow-agent-cursor": "workspace:*" plus workspace:* for @uncaged/workflow-runtime and @uncaged/workflow-util-agent, and zod ^4.

Usage

import { createCursorAgent } from "@uncaged/workflow-agent-cursor";

const agent = createCursorAgent({
  model: null, // null → "auto"
  timeout: 0, // ms; 0 = no limit (spawnCli timeout disabled)
  extract: myExtractFn,
});

API overview

Export Description
createCursorAgent(config) Returns AgentFn that runs cursor-agent with buildAgentPrompt(ctx) from @uncaged/workflow-util-agent
CursorAgentConfig model, timeout, extract (must supply workspace path)
validateCursorAgentConfig Config validation result

Requires cursor-agent on PATH at runtime.