Agent Workflows

Early implementation of a repository-local control system for repeatable agent-led application walkthroughs.

The public package is @neonwatty/agent-workflows, and its CLI command is workflow. This is an early 0.1.x release: the foundational schemas, validation, state machine, and run storage are usable while the higher-level training and evaluation experience is still being built.

Install

npm install --save-dev @neonwatty/agent-workflows

Implemented in this slice

• Draft 2020-12 schemas for project config, workflows, agent responses, and run events.
• YAML and JSONL loading and validation.
• Semantic workflow validation for IDs, references, overrides, dependency cycles, and media intervals.
• Desktop/mobile platform override resolution with canonical and effective hashes.
• Pure event reducer enforcing the initial runner state machine.
• Append-only filesystem run store with atomic manifests, flushed JSONL appends, path containment, and a single-writer lock.
• Minimal doctor, validate, and platform-resolved show CLI commands.

Browser adapters, host-agent skills, training orchestration, the local studio, Playwright generation, and iOS simulator support are not implemented yet.

Development

npm install
npm run check

Validate the concrete Bleep examples:

node ./bin/workflow.js validate \
  examples/workflows.config.yaml \
  examples/bleep-browser-demo.workflow.yaml \
  examples/bleep-browser-demo.events.jsonl

Inspect the resolved mobile workflow:

node ./bin/workflow.js show \
  examples/bleep-browser-demo.workflow.yaml \
  --platform mobile-web \
  --json

Design documents

• docs/workflow-protocol.md
• docs/state-machine.md
• docs/cli-contract.md
• docs/repository-layout.md