Remove all Matrix/Dendrite infrastructure: - Delete lib/matrix_listener.sh (long-poll daemon), lib/matrix_listener.service (systemd unit), lib/hooks/on-stop-matrix.sh (response streaming hook) - Remove matrix_send() and matrix_send_ctx() from lib/env.sh - Remove MATRIX_HOMESERVER auto-detection, MATRIX_THREAD_MAP from lib/env.sh - Remove [matrix] section parsing from lib/load-project.sh - Remove Matrix hook installation from lib/agent-session.sh - Remove notify/notify_ctx helpers and Matrix thread tracking from dev/dev-agent.sh and action/action-agent.sh - Remove all matrix_send calls from dev-poll.sh, phase-handler.sh, action-poll.sh, vault-poll.sh, vault-fire.sh, vault-reject.sh, review-poll.sh, review-pr.sh, supervisor-poll.sh, formula-session.sh - Remove Matrix listener startup from docker/agents/entrypoint.sh - Remove append_dendrite_compose() and setup_matrix() from bin/disinto - Remove --matrix flag from disinto init - Clean Matrix references from .env.example, projects/*.toml.example, formulas/*.toml, AGENTS.md, BOOTSTRAP.md, README.md, RESOURCES.md, PHASE-PROTOCOL.md, and all agent AGENTS.md/PROMPT.md files Status visibility now via Codeberg PR/issue activity. Human interaction via vault items through forge. Proactive alerts via OpenClaw heartbeats. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2.7 KiB
Action Agent
Role: Execute operational tasks described by action formulas — run scripts, call APIs, send messages, collect human approval. Shares the same phase handler as the dev-agent: if an action produces code changes, the orchestrator creates a PR and drives the CI/review loop; otherwise Claude closes the issue directly.
Trigger: action-poll.sh runs every 10 min via cron. Sources lib/guard.sh
and calls check_active action first — skips if $FACTORY_ROOT/state/.action-active
is absent. Then scans for open issues labeled action that have no active tmux
session, and spawns action-agent.sh <issue-number>.
Key files:
action/action-poll.sh— Cron scheduler: finds open action issues with no active tmux session, spawns action-agent.shaction/action-agent.sh— Orchestrator: fetches issue body + prior comments, checks all dependencies vialib/parse-deps.shbefore spawning (skips silently if any dep is still open), creates tmux session (action-{project}-{issue_num}) with interactiveclaude, injects formula prompt with phase protocol, entersmonitor_phase_loop(shared viadev/phase-handler.sh) for CI/review lifecycle or direct completion
Session lifecycle:
action-poll.shfinds openactionissues with no active tmux session.- Spawns
action-agent.sh <issue_num>. - Agent creates tmux session
action-{project}-{issue_num}, injects prompt (formula + prior comments + phase protocol). - Agent enters
monitor_phase_loop(shared with dev-agent viadev/phase-handler.sh). - Path A (git output): Claude pushes branch →
PHASE:awaiting_ci→ handler creates PR, polls CI → injects failures → Claude fixes → push → re-poll → CI passes →PHASE:awaiting_review→ handler polls reviews → injects REQUEST_CHANGES → Claude fixes → approved → merge → cleanup. - Path B (no git output): Claude posts results as comment, closes issue →
PHASE:done→ handler cleans up (kill session, docker compose down, remove temp files). - For human input: Claude writes
PHASE:escalate; human responds via vault/forge.
Environment variables consumed:
FORGE_TOKEN,FORGE_REPO,FORGE_API,FORGE_URL,PROJECT_NAME,FORGE_WEBACTION_IDLE_TIMEOUT— Max seconds before killing idle session (default 14400 = 4h)ACTION_MAX_LIFETIME— Max total session wall-clock seconds (default 28800 = 8h); caps session independently of idle timeout
FORGE_REMOTE: action-agent.sh auto-detects the git remote for FORGE_URL (same logic as dev-agent). Exported as FORGE_REMOTE, used for worktree creation and push instructions injected into the Claude prompt.