disinto/action/AGENTS.md
openhands 23949083c0 fix: Remove Matrix integration — notifications move to forge + OpenClaw (#732)
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>
2026-03-26 14:53:56 +00:00

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.sh
  • action/action-agent.sh — Orchestrator: fetches issue body + prior comments, checks all dependencies via lib/parse-deps.sh before spawning (skips silently if any dep is still open), creates tmux session (action-{project}-{issue_num}) with interactive claude, injects formula prompt with phase protocol, enters monitor_phase_loop (shared via dev/phase-handler.sh) for CI/review lifecycle or direct completion

Session lifecycle:

  1. action-poll.sh finds open action issues with no active tmux session.
  2. Spawns action-agent.sh <issue_num>.
  3. Agent creates tmux session action-{project}-{issue_num}, injects prompt (formula + prior comments + phase protocol).
  4. Agent enters monitor_phase_loop (shared with dev-agent via dev/phase-handler.sh).
  5. 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.
  6. 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).
  7. 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_WEB
  • ACTION_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.