be78c27561
AX principles + go/agent + core/agent + php/agent specs. Temporary — needed in-repo until core-agent mount bug is fixed. Co-Authored-By: Virgil <virgil@lethean.io>
111 lines
5.3 KiB
Markdown
111 lines
5.3 KiB
Markdown
# core/php/agent — Actions
|
|
|
|
## Brain
|
|
| Action | Class | Input | Output |
|
|
|--------|-------|-------|--------|
|
|
| Remember | `Actions\Brain\RememberKnowledge` | content, tags[], project? | BrainMemory |
|
|
| Recall | `Actions\Brain\RecallKnowledge` | query, limit?, tags[]? | BrainMemory[] |
|
|
| Forget | `Actions\Brain\ForgetKnowledge` | id | bool |
|
|
| List | `Actions\Brain\ListKnowledge` | filters? | BrainMemory[] |
|
|
|
|
## Forge
|
|
| Action | Class | Input | Output |
|
|
|--------|-------|-------|--------|
|
|
| Assign Agent | `Actions\Forge\AssignAgent` | issue_id, agent_type | bool |
|
|
| Create Plan from Issue | `Actions\Forge\CreatePlanFromIssue` | issue_id | AgentPlan |
|
|
| Manage PR | `Actions\Forge\ManagePullRequest` | pr_id, action | bool |
|
|
| Report to Issue | `Actions\Forge\ReportToIssue` | issue_id, report | bool |
|
|
| Scan for Work | `Actions\Forge\ScanForWork` | — | Issue[] |
|
|
|
|
## Plan
|
|
| Action | Class | Input | Output |
|
|
|--------|-------|-------|--------|
|
|
| Create | `Actions\Plan\CreatePlan` | title, description, phases[] | AgentPlan |
|
|
| Get | `Actions\Plan\GetPlan` | id or slug | AgentPlan |
|
|
| List | `Actions\Plan\ListPlans` | status?, workspace_id? | AgentPlan[] |
|
|
| Update Status | `Actions\Plan\UpdatePlanStatus` | id, status | AgentPlan |
|
|
| Archive | `Actions\Plan\ArchivePlan` | id | bool |
|
|
|
|
## Session
|
|
| Action | Class | Input | Output |
|
|
|--------|-------|-------|--------|
|
|
| Start | `Actions\Session\StartSession` | agent_type, plan_id?, context | AgentSession |
|
|
| Continue | `Actions\Session\ContinueSession` | session_id, work_log | AgentSession |
|
|
| End | `Actions\Session\EndSession` | session_id, summary, handoff? | AgentSession |
|
|
| Get | `Actions\Session\GetSession` | session_id | AgentSession |
|
|
| List | `Actions\Session\ListSessions` | status?, agent_type? | AgentSession[] |
|
|
|
|
## Issue
|
|
| Action | Class | Input | Output |
|
|
|--------|-------|-------|--------|
|
|
| Create | `Actions\Issue\CreateIssue` | title, type, priority, labels[] | Issue |
|
|
| Get | `Actions\Issue\GetIssue` | id | Issue |
|
|
| List | `Actions\Issue\ListIssues` | status?, type?, sprint_id? | Issue[] |
|
|
| Update | `Actions\Issue\UpdateIssue` | id, fields | Issue |
|
|
| Comment | `Actions\Issue\AddIssueComment` | issue_id, body | IssueComment |
|
|
| Archive | `Actions\Issue\ArchiveIssue` | id | bool |
|
|
|
|
## Sprint
|
|
| Action | Class | Input | Output |
|
|
|--------|-------|-------|--------|
|
|
| Create | `Actions\Sprint\CreateSprint` | title, goal, started_at, ended_at | Sprint |
|
|
| Get | `Actions\Sprint\GetSprint` | id | Sprint |
|
|
| List | `Actions\Sprint\ListSprints` | status? | Sprint[] |
|
|
| Update | `Actions\Sprint\UpdateSprint` | id, fields | Sprint |
|
|
| Archive | `Actions\Sprint\ArchiveSprint` | id | bool |
|
|
|
|
## Phase
|
|
| Action | Class | Input | Output |
|
|
|--------|-------|-------|--------|
|
|
| Get | `Actions\Phase\GetPhase` | id | AgentPhase |
|
|
| Update Status | `Actions\Phase\UpdatePhaseStatus` | id, status | AgentPhase |
|
|
| Add Checkpoint | `Actions\Phase\AddCheckpoint` | id, checkpoint_data | AgentPhase |
|
|
|
|
## Task
|
|
| Action | Class | Input | Output |
|
|
|--------|-------|-------|--------|
|
|
| Toggle | `Actions\Task\ToggleTask` | id | Task |
|
|
| Update | `Actions\Task\UpdateTask` | id, fields | Task |
|
|
|
|
## Auth
|
|
| Action | Class | Input | Output |
|
|
|--------|-------|-------|--------|
|
|
| ProvisionKey | `Actions\Auth\ProvisionAgentKey` | oauth_user_id, name?, permissions[]? | AgentApiKey |
|
|
| RevokeKey | `Actions\Auth\RevokeAgentKey` | key_id | bool |
|
|
|
|
## Fleet
|
|
| Action | Class | Input | Output |
|
|
|--------|-------|-------|--------|
|
|
| Register | `Actions\Fleet\RegisterNode` | agent_id, capabilities, platform, models[] | FleetNode |
|
|
| Heartbeat | `Actions\Fleet\NodeHeartbeat` | agent_id, status, compute_budget | FleetNode |
|
|
| Deregister | `Actions\Fleet\DeregisterNode` | agent_id | bool |
|
|
| ListNodes | `Actions\Fleet\ListNodes` | status?, platform? | FleetNode[] |
|
|
| AssignTask | `Actions\Fleet\AssignTask` | agent_id, task, repo, template | FleetTask |
|
|
| CompleteTask | `Actions\Fleet\CompleteTask` | agent_id, task_id, result, findings[] | FleetTask (triggers AwardCredits as side-effect) |
|
|
| GetNextTask | `Actions\Fleet\GetNextTask` | agent_id, capabilities | FleetTask? (scheduler: P0-P3 priority, capability match, repo affinity, round-robin, budget check) |
|
|
|
|
## Fleet Stats
|
|
| Action | Class | Input | Output |
|
|
|--------|-------|-------|--------|
|
|
| GetFleetStats | `Actions\Fleet\GetFleetStats` | (none) | FleetStats |
|
|
|
|
## Sync
|
|
| Action | Class | Input | Output |
|
|
|--------|-------|-------|--------|
|
|
| PushState | `Actions\Sync\PushDispatchHistory` | agent_id, dispatches[] | SyncResult |
|
|
| PullContext | `Actions\Sync\PullFleetContext` | agent_id, since? | FleetContext |
|
|
| GetStatus | `Actions\Sync\GetAgentSyncStatus` | agent_id | SyncStatus |
|
|
|
|
## Credits
|
|
| Action | Class | Input | Output |
|
|
|--------|-------|-------|--------|
|
|
| AwardCredits | `Actions\Credits\AwardCredits` | agent_id, task_type, amount | CreditEntry |
|
|
| GetBalance | `Actions\Credits\GetBalance` | agent_id | CreditBalance |
|
|
| GetHistory | `Actions\Credits\GetCreditHistory` | agent_id, limit? | CreditEntry[] |
|
|
|
|
## Subscription
|
|
| Action | Class | Input | Output |
|
|
|--------|-------|-------|--------|
|
|
| DetectCapabilities | `Actions\Subscription\DetectCapabilities` | api_keys{} | Capabilities |
|
|
| GetNodeBudget | `Actions\Subscription\GetNodeBudget` | agent_id | Budget |
|
|
| UpdateBudget | `Actions\Subscription\UpdateBudget` | agent_id, limits | Budget |
|