Software factory / Custom agents
Fix an error in the factory file
A factory file has an error, so no custom agent runs. The built-in agents still run. Find the error, fix the file, and save it again.
2 min read
You need:
- Admin access to the repository.
1. Find the error
Admins see the errors in these places:
- Agents, Software factory, Custom agents: a red alert lists each error, with its file name.
src factory agents: it prints the errors on stderr, after the list of files, and exits 0.- REST and MCP:
GET /repos/<owner>/<repo>/factory/agents/status, and the toolget_custom_agent_status.
Read the error. It starts with the file, for example factory/house.ts:.
2. Fix the file
Fix the file, and run it with Node.js, as in Check the file on your machine.
3. Save the file again
Save the file again, with the same name. For .source/factory.ts, push the fix to the default branch.
Done
The alert goes away, and the card lists the agents that loaded.
Who sees the errors on an item
The Factory panel of an issue or a pull request also says that the custom agents cannot run. Only people who can read the file see its errors there, because an error can quote the file:
- The errors of
.source/factory.tsshow to people with write access. - The errors of files in the vault show to the admins of the repository. Other people with write access read that an admin can see the errors in the factory settings.
- Everyone else reads that some custom agents cannot run now.