API Reference

Temporal activities and helpers for AgentsFlow.

AgentsFlowActivities

Collection of Temporal activity entry points used by the process flow.

Source code in agentsflow/activities/__init__.py

class AgentsFlowActivities:
    """Collection of Temporal activity entry points used by the process flow."""

    def __init__(self, *, auto_approve: bool = True) -> None:
        self.git = GitActivities()
        self.issues = IssueActivities()
        self.agents = AgentActivities(auto_approve=auto_approve)

        # Attribute exposure for worker registration
        self.create_git_worktree = self.git.create_git_worktree
        self.finalize_git_changes = self.git.finalize_git_changes
        self.read_issue = self.issues.read_issue
        self.run_acp_implementation = self.agents.run_acp_implementation
        self.run_acp_tests = self.agents.run_acp_tests
        self.run_acp_review = self.agents.run_acp_review
        self.close_acp_session = self.agents.close_acp_session
        self.summarize_implementation = self.agents.summarize_implementation
        self.parse_coding_transcript = self.agents.parse_coding_transcript
        self.summarize_tests = self.agents.summarize_tests
        self.parse_review_transcript = self.agents.parse_review_transcript
        self.run_clarification_agent = self.agents.run_clarification_agent
        self.draft_release_plan = self.agents.draft_release_plan

    def activities(self) -> list[Any]:
        return self.git.activities() + self.issues.activities() + self.agents.activities()

GitWorktreeRequest dataclass

Parameters required to create a git worktree.

Source code in agentsflow/activities/git/models.py

@dataclass
class GitWorktreeRequest:
    """Parameters required to create a git worktree."""

    repository: str
    reference: str | None = None

GitWorktreeResult dataclass

Returned information about the created worktree.

Source code in agentsflow/activities/git/models.py

@dataclass
class GitWorktreeResult:
    """Returned information about the created worktree."""

    worktree_path: str
    repository_path: str
    reference: str
    cloned_from_remote: bool

IssueDetails dataclass

Normalized payload returned by issue providers.

Source code in agentsflow/activities/issues/models.py

@dataclass(slots=True)
class IssueDetails:
    """Normalized payload returned by issue providers."""

    issue_key: str
    issue_url: str
    summary: str
    description: str
    status: str | None
    comments: list[IssueComment]

IssueRequest dataclass

Parameters describing how to retrieve an issue from any provider.

Source code in agentsflow/activities/issues/reader.py

@dataclass(slots=True)
class IssueRequest:
    """Parameters describing how to retrieve an issue from any provider."""

    issue_url: str
    provider: str | None = None
    timeout_seconds: float = DEFAULT_TIMEOUT_SECONDS