pi-factory-gate

AI Factory orchestration gateway for pi agents — dispatch jobs, manage environments, list agents/workers/workflows, and stream results from a wrok.in orchestrator.

Install

pi install npm:@bytesbrains/pi-factory-gate

Configuration

Add a .factoryrc.yml to your repo root:

orchestratorUrl: http://localhost:3002
defaultEnvironment: default
defaultLimit: 20
requestTimeout: 15000
maxLogLines: 500

Key	Default	Description
orchestratorUrl	http://localhost:3002	Base URL of the wrok.in orchestrator
defaultEnvironment	(none)	Default environment for job dispatch
defaultLimit	20	Default page size for list operations
requestTimeout	15000	API call timeout in ms
maxLogLines	500	Max lines for streamed job output

Tools

Agents

Tool	Description
factory_list_agents	List all agents, optionally filtered by environment
factory_get_agent	Get agent detail including inheritance and resolved config

Jobs

Tool	Description
factory_create_job	Dispatch a job (single, chain, or parallel mode)
factory_get_job	Get job status and results
factory_list_jobs	List all jobs in the factory
factory_stream_job	Poll for completion, returns final state

Environments

Tool	Description
factory_list_environments	List all registered environments
factory_get_environment	Get environment detail
factory_create_environment	Register a new environment (clone a repo)

Workers

Tool	Description
factory_list_workers	List all workers with health/status

Workflows

Tool	Description
factory_list_workflows	List workflow templates (DB + disk discovery)
factory_run_workflow	Execute a workflow template

Events & Status

Tool	Description
factory_get_events	Get recent system events
factory_status	Health check — is the orchestrator reachable?

About wrok.in

This gate works with the wrok.in AI Factory — a personal AI workflow orchestrator that manages pi workers across Docker containers with multi-repo environments, agent inheritance, DB-backed agents, and workflow scheduling.

License

MIT

---

Built and maintained by BytesBrains — AI automation & agents, engineered to production standards. The model proposes, code guarantees.