Files
kandev/apps/backend/pkg/websocket/actions.go
T
João Salavisa dfaab11959 feat: full GitLab integration — parity with GitHub (#1120)
* feat(backend): full GitLab parity — store, service, poller, WS, presets

Add the watcher/poll/write-action surface on top of the existing GitLab
client + service skeleton:

* 5 new SQLite tables (mr_watches, review_watches, review_mr_tasks,
  issue_watches, issue_watch_tasks, action_presets) + CRUD
* Client + Service: MergeMR, GetProjectMergeMethods, GetProtectedBranch,
  ListUserProjects, SearchProjects, SetMRLabels, SetMRAssignees
* Service: review/issue/MR watch CRUD + Check/Trigger, GetStats,
  CleanupAllReview/IssueTasks (cleanup-policy aware), TriggerMRSync,
  action-presets CRUD with defaults
* Background poller (MR / review / issue loops) wired from main.go
* ~35 GitLab WS action constants + handlers.go registrations
* Mock controller for E2E seeding (MRs, issues, pipelines, discussions,
  approvals, branches)
* eventBus + taskDeleter + taskSessionChecker plumbed through Service
* Event types: GitLabMRFeedback / NewReviewMR / NewIssue / TaskMRUpdated

* feat(web): GitLab frontend parity — types, API, store slice, domain hooks

Extend the frontend GitLab integration on top of the new backend surface:

* HTTP API client expansion (gitlab-api.ts): full CRUD for review/issue/MR
  watches, MR write actions (merge/approve/labels/assignees), MR
  files/commits/feedback, action presets, projects autocomplete, stats
* Store slice expansion: review/issue/MR watches lists, action presets
  by workspace, stats + status with loading flags. Properties prefixed
  with gitlab to avoid collision with GitHub slice
* Domain hooks: use-gitlab-status, use-gitlab-stats,
  use-gitlab-review-watches, use-gitlab-issue-watches,
  use-gitlab-action-presets — mirror github hook shapes
* Type model: ReviewWatch, IssueWatch, MRWatch, ActionPresets, Stats,
  ProjectMergeMethods, MRApproval, Pipeline, MRFeedback, etc.
* Backend controller HTTP routes for watches/presets/write-actions/
  projects/stats so the frontend HTTP API client has endpoints to hit

All passes: backend (build + vet + lint + tests), web (typecheck + lint +
2400 tests).

* fix(gitlab): wire orchestrator event handlers, fix label-filter drop, add tests

Address Claude review blockers on the parity PR:

1. Wire orchestrator subscriptions for GitLab review/issue watch events.
   Add event_handlers_gitlab.go with handleGitLabNewReviewMR /
   handleGitLabNewIssue, dedup reservation handshake, and task-creator
   interfaces (mirrors event_handlers_github.go). main.go now calls
   orchestratorSvc.SetGitLabService so the dedup APIs are usable
2. Fix silent label-filter drop: when a custom_query is set on an issue
   watch, labels were being appended to the unused filter arg. Fold
   labels into customQuery (or default filter) so they actually reach
   GitLab; extracted appendLabelsToQuery helper with explicit handling
   of pre-existing labels= clauses
3. Switch event payloads to pointer types (mirrors GitHub) so
   handlers can type-assert pointer events
4. Backend tests: store_watches_test.go (CRUD + reserve/assign for all
   4 new tables + presets), service_watches_test.go (label-filter
   helper, cleanup policy, project normalisation), action_presets_test.go
5. Frontend slice tests: review/issue watch CRUD round-trips, action
   presets + stats reducer coverage

All green: backend (build+vet+lint+tests), web (typecheck+lint+2403 tests).

* fix(gitlab): address remaining blockers — cleanup wiring, safe defaults, nil guards

Address the second round of Claude review blockers:

1. main.go: wire SetTaskDeleter + SetTaskSessionChecker on services.GitLab
   (mirrors GitHub). Without these, manual cleanup sweeps would always
   error with "task deleter not configured"
2. service_cleanup.go: default cleanup policy on transient DB error is now
   CleanupPolicyNever (preserve tasks) instead of CleanupPolicyAuto
   (silently delete). Genuine "watch was deleted" path also falls under
   the safe-side default; user can manually delete the orphan tasks
3. service_watches.go: add nil guards on requireStore() so the 6 MR-watch
   list/get/delete methods return an errStoreUnavailable error instead
   of panicking when the SQLite store failed to construct at boot
4. use-gitlab-status.ts + use-gitlab-stats.ts: add per-mount attemptedRef
   so an unreachable GitLab doesn't trigger an infinite re-fetch loop —
   the previous useEffect re-ran every render because the failure path
   left status null, satisfying the !status guard

* fix(gitlab): propagate session-check errors, clamp poll interval on update

Address remaining Claude blockers:

* service_cleanup.go: HasUserAuthoredMessage transient errors are now
  preserved (return false → skip delete) instead of silently ignored;
  the alternative was occasionally deleting tasks a user had touched
* service_watches.go: extract clampPollInterval helper applying the same
  bounds (0 → default, <60 → 60) as the create path; both
  applyReviewWatchPatch and applyIssueWatchPatch use it so user-supplied
  zero or tiny values via UpdateXxxWatchRequest no longer hammer GitLab

* fix(gitlab): clear dupl lint, fix preset retry loop + per-workspace watch cache

* service_watches.go: applyReviewWatchPatch / applyIssueWatchPatch get
  nolint:dupl markers — they share shape but per-domain field validation
  lives in the create paths, so deduplicating via generics would obscure
  the contract. Restores backend lint to 0 issues
* use-gitlab-action-presets.ts: per-workspace attemptedRef set so a
  failing preset fetch doesn't retry on every render
* use-gitlab-review-watches.ts + use-gitlab-issue-watches.ts: track
  lastFetchedRef per consumer so a workspace switch triggers a refetch.
  The slice-level loaded flag is shared across instances and can't
  double as a per-workspace cache key

* fix(gitlab): add nil-store guards across review/issue watch + cleanup paths

Round-3 Claude finding: ReviewWatch / IssueWatch / preset / reservation
methods still called s.requireStore().X() directly. If NewStore fails at
boot (table migration error), the service struct's store is nil and every
list/get/update/create/reserve method panics on first request.

Apply the same store-nil → errStoreUnavailable pattern from f95a929 to
every remaining method:
* CreateReviewWatch / CreateIssueWatch
* GetReviewWatch / ListReviewWatches / ListAllReviewWatches /
  UpdateReviewWatch / TriggerReviewWatchAll
* GetIssueWatch / ListIssueWatches / ListAllIssueWatches /
  UpdateIssueWatch / TriggerIssueWatchAll
* ReserveReviewMRTask / AssignReviewMRTaskID / ReleaseReviewMRTask
* ReserveIssueWatchTask / AssignIssueWatchTaskID / ReleaseIssueWatchTask
* lookupReviewPolicy / lookupIssuePolicy (return CleanupPolicyNever)

* fix(gitlab): nil-store guards on CheckXxxWatch + DeleteXxxWatch + cleanup paths

Round-4 Claude finding: 4 remaining panic sites the previous nil-guard
pass missed — these run from the background poller (every 5 min) and the
manual delete/cleanup flows, so a boot-time NewStore failure would
crash the orchestrator process on first tick.

* service_watches.go: add store-nil guards to DeleteReviewWatch /
  DeleteIssueWatch / CheckReviewWatch / CheckIssueWatch
* service_cleanup.go: guard CleanupAllReviewTasks / CleanupAllIssueTasks
  entry points; wrap the trailing DeleteReviewMRTask / DeleteIssueWatchTask
  calls in `if store := s.requireStore(); store != nil` blocks so the
  cleanup succeeds even when the dedup-row delete is unreachable

* refactor(gitlab): split service_watches.go to stay under 800-line revive limit

CI's --new-from-rev lint caught service_watches.go at 808 lines (limit
800). Split into three focused files:

* service_events.go (94 LOC) — publish helpers for MR feedback /
  new review MR / new issue / watch lifecycle events
* service_issue_watches.go (302 LOC) — Issue watch CRUD + Check +
  Trigger + fetch + helpers
* service_reservations.go (59 LOC) — Reserve/Assign/Release dedup
  handles used by the orchestrator event handlers

service_watches.go is now 505 lines and contains MR watch + Review
watch only. No behavioral change.

* fix(gitlab): address inline code-review feedback

Address actionable inline comments from Claude/CodeRabbit/cubic/Greptile:

* appendLabelsToQuery: use url.ParseQuery for exact key match instead
  of strings.Contains; previously false-matched keys like mylabels=
  and silently dropped the watch's labels (test added)
* fetchReviewMRs: drop dead `filter = watch.CustomQuery` assignment —
  SearchMRs's buildMRSearchQuery returns customQuery verbatim and
  ignores filter when customQuery is non-empty
* store.go: add workspace_id indexes on gitlab_review_watches and
  gitlab_issue_watches (the 5-min poller and HTTP list endpoints did
  full table scans)
* mock_client.SearchProjects: switch from == to case-insensitive
  Contains so partial-query autocomplete returns the seeded project,
  matching the doc comment
* Poller: add sync.Mutex to guard `started` field; Start/Stop are
  now safe to call concurrently (go test -race would have flagged
  the previous read/write race)
* Add ErrWatchNotFound sentinel; controller_watches.go maps it to
  HTTP 404 via httpRespondError helper. Update/Trigger handlers
  previously returned 500 for missing watches, hiding the distinction
  from real server faults
* service_events.go: log Publish errors on watch lifecycle events
  instead of swallowing them silently
* handlers.go: reject malformed JSON payloads in list-style WS
  handlers rather than silently falling through to broader
  list/search behavior
* event_handlers_gitlab.go: remove dead gitlabRepoSlug helper +
  blank-identifier suppression

* ci: re-trigger to clear flaky E2E shard 3

* fix(gitlab): address final review round — nil guards, store merge, logs, body validation

- CheckMRWatch, UpdateReviewWatch, UpdateIssueWatch: nil guards for store/req
- handlers: wsNewDiscussionNote rejects empty body
- action_presets: Update reads raw stored row (no default freezing);
  Reset validates workspace_id
- service_search.GetStats: log Warn per sub-call failure before zero
- event_handlers_gitlab: log Release* dedup-row errors with context
- web/store.ts: post-slice merge restores every GitLab sub-state field;
  extract buildStateOverrides helper
- web/default-state.ts: add GitLab fields to defaultState +
  mergeInitialState via mergeGitLabFields helper
- web/gitlab-api.ts: UpdateXxxWatchRequest now Omit workspace_id

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

---------

Co-authored-by: Kandev Agent <agent@kandev.dev>
Co-authored-by: Claude Opus 4.7 <noreply@anthropic.com>
2026-06-02 22:10:07 +01:00

560 lines
26 KiB
Go

package websocket
// Action constants for WebSocket messages
const (
// Health
ActionHealthCheck = "health.check"
// Workflow actions
ActionWorkflowList = "workflow.list"
ActionWorkflowCreate = "workflow.create"
ActionWorkflowGet = "workflow.get"
ActionWorkflowUpdate = "workflow.update"
ActionWorkflowDelete = "workflow.delete"
ActionWorkflowReorder = "workflow.reorder"
// Workspace actions
ActionWorkspaceList = "workspace.list"
ActionWorkspaceCreate = "workspace.create"
ActionWorkspaceGet = "workspace.get"
ActionWorkspaceUpdate = "workspace.update"
ActionWorkspaceDelete = "workspace.delete"
// Repository actions
ActionRepositoryList = "repository.list"
ActionRepositoryCreate = "repository.create"
ActionRepositoryGet = "repository.get"
ActionRepositoryUpdate = "repository.update"
ActionRepositoryDelete = "repository.delete"
// Repository Script actions
ActionRepositoryScriptList = "repository.script.list"
ActionRepositoryScriptCreate = "repository.script.create"
ActionRepositoryScriptGet = "repository.script.get"
ActionRepositoryScriptUpdate = "repository.script.update"
ActionRepositoryScriptDelete = "repository.script.delete"
// Executor actions
ActionExecutorList = "executor.list"
ActionExecutorCreate = "executor.create"
ActionExecutorGet = "executor.get"
ActionExecutorUpdate = "executor.update"
ActionExecutorDelete = "executor.delete"
// Executor profile actions
ActionExecutorProfileList = "executor.profile.list"
ActionExecutorProfileListAll = "executor.profile.list_all"
ActionExecutorProfileCreate = "executor.profile.create"
ActionExecutorProfileGet = "executor.profile.get"
ActionExecutorProfileUpdate = "executor.profile.update"
ActionExecutorProfileDelete = "executor.profile.delete"
// Environment actions
ActionEnvironmentList = "environment.list"
ActionEnvironmentCreate = "environment.create"
ActionEnvironmentGet = "environment.get"
ActionEnvironmentUpdate = "environment.update"
ActionEnvironmentDelete = "environment.delete"
// Task actions
ActionTaskList = "task.list"
ActionTaskCreate = "task.create"
ActionTaskGet = "task.get"
ActionTaskUpdate = "task.update"
ActionTaskDelete = "task.delete"
ActionTaskMove = "task.move"
ActionTaskState = "task.state"
ActionTaskArchive = "task.archive"
ActionTaskPlanCreate = "task.plan.create"
ActionTaskPlanGet = "task.plan.get"
ActionTaskPlanUpdate = "task.plan.update"
ActionTaskPlanDelete = "task.plan.delete"
ActionTaskPlanRevisionsList = "task.plan.revisions.list"
ActionTaskPlanRevisionGet = "task.plan.revision.get"
ActionTaskPlanRevert = "task.plan.revert"
ActionTaskSessionList = "task.session.list"
ActionTaskSessionStatus = "task.session.status"
// Unified session launch
ActionSessionLaunch = "session.launch"
ActionSessionEnsure = "session.ensure"
ActionSessionRecover = "session.recover"
ActionSessionResetContext = "session.reset_context"
ActionSessionStop = "session.stop"
ActionSessionDelete = "session.delete"
ActionSessionSetPrimary = "session.set_primary"
ActionSessionSetPlanMode = "session.set_plan_mode"
// Agent actions
ActionAgentList = "agent.list"
ActionAgentLaunch = "agent.launch"
ActionAgentStatus = "agent.status"
ActionAgentLogs = "agent.logs"
ActionAgentStop = "agent.stop"
ActionAgentPrompt = "agent.prompt"
ActionAgentCancel = "agent.cancel"
ActionTaskSession = "task.session"
ActionAgentTypes = "agent.types"
// Agent passthrough actions
ActionAgentStdin = "agent.stdin" // Send input to agent process stdin (passthrough mode)
ActionAgentStdout = "agent.stdout" // Agent stdout notification (passthrough mode)
ActionAgentResize = "agent.resize" // Resize agent PTY (passthrough mode)
// Orchestrator actions
ActionOrchestratorStatus = "orchestrator.status"
ActionOrchestratorQueue = "orchestrator.queue"
ActionOrchestratorStop = "orchestrator.stop"
// Message Queue actions
ActionMessageQueueAdd = "message.queue.add"
ActionMessageQueueCancel = "message.queue.cancel" // Clears the entire queue for a session
ActionMessageQueueGet = "message.queue.get"
ActionMessageQueueUpdate = "message.queue.update"
ActionMessageQueueAppend = "message.queue.append"
ActionMessageQueueDrain = "message.queue.drain" // Dispatch one queued entry now when the session is promptable
ActionMessageQueueRemove = "message.queue.remove" // Delete a single entry by id
ActionMessageQueueStatusChanged = "message.queue.status_changed" // Notification: queue status changed
// Workflow template/step actions
ActionWorkflowTemplateList = "workflow.template.list"
ActionWorkflowTemplateGet = "workflow.template.get"
ActionWorkflowStepList = "workflow.step.list"
ActionWorkflowStepGet = "workflow.step.get"
ActionWorkflowStepCreate = "workflow.step.create"
ActionWorkflowHistoryList = "workflow.history.list"
// Subscription actions
ActionTaskSubscribe = "task.subscribe"
ActionTaskUnsubscribe = "task.unsubscribe"
ActionSessionSubscribe = "session.subscribe"
ActionSessionUnsubscribe = "session.unsubscribe"
// Focus signals are layered on top of subscriptions to indicate which
// session the user is actively viewing (task details page or task panel),
// vs merely subscribed (sidebar diff badges). Drives backend polling tier.
ActionSessionFocus = "session.focus"
ActionSessionUnfocus = "session.unfocus"
ActionUserSubscribe = "user.subscribe"
ActionUserUnsubscribe = "user.unsubscribe"
ActionRunSubscribe = "run.subscribe"
ActionRunUnsubscribe = "run.unsubscribe"
// Message actions
ActionMessageAdd = "message.add"
ActionMessageGet = "message.get"
ActionMessageList = "message.list"
ActionMessageSearch = "message.search"
// Notification actions (server -> client)
ActionACPProgress = "acp.progress"
ActionACPLog = "acp.log"
ActionACPResult = "acp.result"
ActionACPError = "acp.error"
ActionACPStatus = "acp.status"
ActionACPHeartbeat = "acp.heartbeat"
ActionTaskCreated = "task.created"
ActionTaskUpdated = "task.updated"
ActionTaskDeleted = "task.deleted"
ActionTaskStateChanged = "task.state_changed"
ActionTaskPlanCreated = "task.plan.created"
ActionTaskPlanUpdated = "task.plan.updated"
ActionTaskPlanDeleted = "task.plan.deleted"
ActionTaskPlanRevisionCreated = "task.plan.revision.created"
ActionTaskPlanReverted = "task.plan.reverted"
ActionAgentUpdated = "agent.updated"
ActionAgentAvailableUpdated = "agent.available.updated"
ActionAgentInstallStarted = "agent.install.started"
ActionAgentInstallOutput = "agent.install.output"
ActionAgentInstallFinished = "agent.install.finished"
ActionWorkspaceCreated = "workspace.created"
ActionWorkspaceUpdated = "workspace.updated"
ActionWorkspaceDeleted = "workspace.deleted"
ActionWorkflowCreated = "workflow.created"
ActionWorkflowUpdated = "workflow.updated"
ActionWorkflowDeleted = "workflow.deleted"
ActionWorkflowStepCreated = "workflow.step.created"
ActionWorkflowStepUpdated = "workflow.step.updated"
ActionWorkflowStepDeleted = "workflow.step.deleted"
ActionSessionMessageAdded = "session.message.added"
ActionSessionMessageUpdated = "session.message.updated"
ActionSessionStateChanged = "session.state_changed"
ActionSessionWaitingForInput = "session.waiting_for_input"
ActionSessionAgentctlStarting = "session.agentctl_starting"
ActionSessionAgentctlReady = "session.agentctl_ready"
ActionSessionAgentctlError = "session.agentctl_error"
ActionSessionTurnStarted = "session.turn.started"
ActionSessionTurnCompleted = "session.turn.completed"
ActionSessionAvailableCommands = "session.available_commands"
ActionSessionModeChanged = "session.mode_changed"
ActionSessionAgentCapabilities = "session.agent_capabilities"
ActionSessionModelsUpdated = "session.models_updated"
ActionSessionSetMode = "session.set_mode"
ActionSessionTodosUpdated = "session.todos_updated"
ActionSessionPromptUsage = "session.prompt_usage"
ActionSessionPollModeChanged = "session.poll_mode_changed"
ActionInputRequested = "input.requested"
ActionRepositoryCreated = "repository.created"
ActionRepositoryUpdated = "repository.updated"
ActionRepositoryDeleted = "repository.deleted"
ActionRepositoryScriptCreated = "repository.script.created"
ActionRepositoryScriptUpdated = "repository.script.updated"
ActionRepositoryScriptDeleted = "repository.script.deleted"
ActionExecutorCreated = "executor.created"
ActionExecutorUpdated = "executor.updated"
ActionExecutorDeleted = "executor.deleted"
ActionEnvironmentCreated = "environment.created"
ActionEnvironmentUpdated = "environment.updated"
ActionEnvironmentDeleted = "environment.deleted"
ActionExecutorProfileCreated = "executor.profile.created"
ActionExecutorProfileUpdated = "executor.profile.updated"
ActionExecutorProfileDeleted = "executor.profile.deleted"
ActionExecutorPrepareProgress = "executor.prepare.progress"
ActionExecutorPrepareCompleted = "executor.prepare.completed"
ActionAgentProfileDeleted = "agent.profile.deleted"
ActionAgentProfileCreated = "agent.profile.created"
ActionAgentProfileUpdated = "agent.profile.updated"
// Permission request actions (agent -> user -> agent)
ActionPermissionRequested = "permission.requested" // Agent requesting permission
ActionPermissionRespond = "permission.respond" // User responding to permission request
// Workspace file operations
ActionWorkspaceFileTreeGet = "workspace.tree.get"
ActionWorkspaceFileContentGet = "workspace.file.get"
ActionWorkspaceFileContentGetRef = "workspace.file.get_at_ref"
ActionWorkspaceFileContentUpdate = "workspace.file.update"
ActionWorkspaceFileCreate = "workspace.file.create"
ActionWorkspaceFileDelete = "workspace.file.delete"
ActionWorkspaceFileRename = "workspace.file.rename"
ActionWorkspaceFilesSearch = "workspace.files.search"
ActionWorkspaceFileChanges = "session.workspace.file.changes" // Notification
// Shell actions
ActionShellStatus = "session.shell.status" // Get shell status
ActionShellSubscribe = "shell.subscribe" // Subscribe to shell output
ActionShellInput = "shell.input" // Send input to shell
ActionSessionShellOutput = "session.shell.output" // Shell output notification (also used for exit with type: "exit")
// User shell actions (independent terminal tabs)
ActionUserShellList = "user_shell.list" // List user shells for a task (DB rows + agentctl probes)
ActionUserShellCreate = "user_shell.create" // Create a new user shell terminal (assigns ID + seq)
ActionUserShellStop = "user_shell.stop" // Legacy alias of destroy; kept for one release
ActionUserShellRename = "user_shell.rename" // Rename an ordinary user shell (set/clear custom_name)
ActionUserShellPark = "user_shell.park" // Hide tab; PTY continues running
ActionUserShellResume = "user_shell.resume" // Unhide a parked tab
ActionUserShellDestroy = "user_shell.destroy" // Stop the PTY and delete the row
// Session file review actions
ActionSessionFileReviewGet = "session.file_review.get" // Get all file reviews for a session
ActionSessionFileReviewUpdate = "session.file_review.update" // Upsert a single file review
ActionSessionFileReviewReset = "session.file_review.reset" // Delete all reviews for a session
// Session git actions (requests)
ActionSessionGitSnapshots = "session.git.snapshots" // Get git snapshots for a session
ActionSessionGitCommits = "session.git.commits" // Get commits for a session
ActionSessionCumulativeDiff = "session.cumulative_diff" // Get cumulative diff from base branch
ActionSessionCommitDiff = "session.commit_diff" // Get diff for a specific commit
// Session git event (unified notification)
ActionSessionGitEvent = "session.git.event" // Notification: unified git event
// Process runner actions
ActionSessionProcessOutput = "session.process.output"
ActionSessionProcessStatus = "session.process.status"
// Git worktree actions
ActionWorktreePull = "worktree.pull" // Pull from remote
ActionWorktreePush = "worktree.push" // Push to remote
ActionWorktreeRebase = "worktree.rebase" // Rebase onto base branch
ActionWorktreeMerge = "worktree.merge" // Merge base branch into worktree
ActionWorktreeAbort = "worktree.abort" // Abort in-progress merge or rebase
ActionWorktreeCommit = "worktree.commit" // Commit changes
ActionWorktreeStage = "worktree.stage" // Stage files for commit
ActionWorktreeUnstage = "worktree.unstage" // Unstage files from index
ActionWorktreeDiscard = "worktree.discard" // Discard changes to files
ActionWorktreeCreatePR = "worktree.create_pr" // Create a pull request
ActionWorktreeRevertCommit = "worktree.revert_commit" // Revert a commit (staged, no new commit)
ActionWorktreeRenameBranch = "worktree.rename_branch" // Rename the current branch
ActionWorktreeReset = "worktree.reset" // Reset HEAD to a commit (soft/hard)
// User actions
ActionUserGet = "user.get"
ActionUserSettingsUpdate = "user.settings.update"
ActionUserSettingsUpdated = "user.settings.updated"
// System maintenance jobs (VACUUM, factory reset, snapshot create/restore,
// disk walk). Broadcast to all connected clients so the System pages can
// render progress.
ActionSystemJobUpdate = "system.job.update"
// VS Code server actions
ActionVscodeStart = "vscode.start" // Start code-server for a session
ActionVscodeStop = "vscode.stop" // Stop code-server for a session
ActionVscodeStatus = "vscode.status" // Get code-server status for a session
ActionVscodeOpenFile = "vscode.openFile" // Open a file in code-server for a session
// Port actions
ActionPortList = "port.list" // List listening ports on a remote executor
ActionPortTunnelStart = "port.tunnel.start" // Start a port tunnel
ActionPortTunnelStop = "port.tunnel.stop" // Stop a port tunnel
ActionPortTunnelList = "port.tunnel.list" // List active port tunnels
// Secret actions
ActionSecretList = "secrets.list"
ActionSecretCreate = "secrets.create"
ActionSecretUpdate = "secrets.update"
ActionSecretDelete = "secrets.delete"
ActionSecretReveal = "secrets.reveal"
// Sprites actions
ActionSpritesStatus = "sprites.status"
ActionSpritesInstancesList = "sprites.instances.list"
ActionSpritesInstancesDestroy = "sprites.instances.destroy"
ActionSpritesTest = "sprites.test"
ActionSpritesNetworkPolicyGet = "sprites.network_policy.get"
ActionSpritesNetworkPolicyUpdate = "sprites.network_policy.update"
// MCP tool actions (agentctl -> backend via WS tunnel)
ActionMCPListWorkspaces = "mcp.list_workspaces"
ActionMCPListWorkflows = "mcp.list_workflows"
ActionMCPListWorkflowSteps = "mcp.list_workflow_steps"
ActionMCPListRepositories = "mcp.list_repositories"
ActionMCPListTasks = "mcp.list_tasks"
ActionMCPCreateTask = "mcp.create_task"
ActionMCPUpdateTask = "mcp.update_task"
ActionMCPAddBranchToTask = "mcp.add_branch_to_task"
ActionMCPAskUserQuestion = "mcp.ask_user_question"
ActionMCPCreateTaskPlan = "mcp.create_task_plan"
ActionMCPGetTaskPlan = "mcp.get_task_plan"
ActionMCPUpdateTaskPlan = "mcp.update_task_plan"
ActionMCPDeleteTaskPlan = "mcp.delete_task_plan"
ActionMCPClarificationTimeout = "mcp.clarification_timeout"
// Office task handoffs (cross-task context).
ActionMCPListRelatedTasks = "mcp.list_related_tasks"
ActionMCPListTaskDocuments = "mcp.list_task_documents"
ActionMCPGetTaskDocument = "mcp.get_task_document"
ActionMCPWriteTaskDocument = "mcp.write_task_document"
// Config-mode MCP actions (agent-native configuration)
ActionMCPCreateWorkflow = "mcp.create_workflow"
ActionMCPUpdateWorkflow = "mcp.update_workflow"
ActionMCPDeleteWorkflow = "mcp.delete_workflow"
ActionMCPImportWorkflow = "mcp.import_workflow"
ActionMCPCreateWorkflowStep = "mcp.create_workflow_step"
ActionMCPUpdateWorkflowStep = "mcp.update_workflow_step"
ActionMCPDeleteWorkflowStep = "mcp.delete_workflow_step"
ActionMCPReorderWorkflowStep = "mcp.reorder_workflow_steps"
ActionMCPListAgents = "mcp.list_agents"
ActionMCPUpdateAgent = "mcp.update_agent"
ActionMCPListAgentProfiles = "mcp.list_agent_profiles"
ActionMCPCreateAgentProfile = "mcp.create_agent_profile"
ActionMCPUpdateAgentProfile = "mcp.update_agent_profile"
ActionMCPDeleteAgentProfile = "mcp.delete_agent_profile"
ActionMCPGetMcpConfig = "mcp.get_mcp_config"
ActionMCPUpdateMcpConfig = "mcp.update_mcp_config"
ActionMCPListExecutors = "mcp.list_executors"
ActionMCPListExecutorProfiles = "mcp.list_executor_profiles"
ActionMCPCreateExecutorProfile = "mcp.create_executor_profile"
ActionMCPUpdateExecutorProfile = "mcp.update_executor_profile"
ActionMCPDeleteExecutorProfile = "mcp.delete_executor_profile"
ActionMCPMoveTask = "mcp.move_task"
ActionMCPDeleteTask = "mcp.delete_task"
ActionMCPArchiveTask = "mcp.archive_task"
ActionMCPUpdateTaskState = "mcp.update_task_state"
ActionMCPMessageTask = "mcp.message_task"
ActionMCPGetTaskConversation = "mcp.get_task_conversation"
)
// GitHub integration actions
const (
ActionGitHubStatus = "github.status"
ActionGitHubTaskPRsList = "github.task_prs.list"
ActionGitHubTaskPRGet = "github.task_pr.get"
ActionGitHubPRFeedbackGet = "github.pr_feedback.get"
ActionGitHubReviewWatchesList = "github.review_watches.list"
ActionGitHubReviewWatchCreate = "github.review_watches.create"
ActionGitHubReviewWatchUpdate = "github.review_watches.update"
ActionGitHubReviewWatchDelete = "github.review_watches.delete"
ActionGitHubReviewTrigger = "github.review_watches.trigger"
ActionGitHubReviewTriggerAll = "github.review_watches.trigger_all"
ActionGitHubPRWatchesList = "github.pr_watches.list"
ActionGitHubPRWatchDelete = "github.pr_watches.delete"
ActionGitHubPRFilesGet = "github.pr_files.get"
ActionGitHubPRCommitsGet = "github.pr_commits.get"
ActionGitHubTaskPRUpdated = "github.task_pr.updated" // Notification
ActionGitHubRateLimitUpdated = "github.rate_limit.updated" // Notification
ActionGitHubPRFeedbackNotify = "github.pr_feedback.notify" // Notification
ActionGitHubNewReviewPRNotify = "github.new_review_pr.notify" // Notification
ActionGitHubTaskPRSync = "github.task_pr.sync"
ActionGitHubStats = "github.stats"
ActionGitHubCheckSessionPR = "github.check_session_pr"
// Issue watch actions
ActionGitHubIssueWatchesList = "github.issue_watches.list"
ActionGitHubIssueWatchCreate = "github.issue_watches.create"
ActionGitHubIssueWatchUpdate = "github.issue_watches.update"
ActionGitHubIssueWatchDelete = "github.issue_watches.delete"
ActionGitHubIssueTrigger = "github.issue_watches.trigger"
ActionGitHubIssueTriggerAll = "github.issue_watches.trigger_all"
ActionGitHubNewIssueNotify = "github.new_issue.notify" // Notification
// Action preset actions for the /github page quick-launch prompts.
ActionGitHubActionPresetsList = "github.action_presets.list"
ActionGitHubActionPresetsUpdate = "github.action_presets.update"
ActionGitHubActionPresetsReset = "github.action_presets.reset"
// Manual cleanup sweeps over all dedup rows (review/issue). Used by the
// settings-page button so users can drain piled-up tasks on demand.
ActionGitHubCleanupReviewTasks = "github.cleanup.review_tasks"
ActionGitHubCleanupIssueTasks = "github.cleanup.issue_tasks"
)
// GitLab integration actions
const (
ActionGitLabStatus = "gitlab.status"
ActionGitLabTaskMRsList = "gitlab.task_mrs.list"
ActionGitLabTaskMRGet = "gitlab.task_mr.get"
ActionGitLabMRFeedbackGet = "gitlab.mr_feedback.get"
ActionGitLabReviewWatchesList = "gitlab.review_watches.list"
ActionGitLabReviewWatchCreate = "gitlab.review_watches.create"
ActionGitLabReviewWatchUpdate = "gitlab.review_watches.update"
ActionGitLabReviewWatchDelete = "gitlab.review_watches.delete"
ActionGitLabReviewTrigger = "gitlab.review_watches.trigger"
ActionGitLabReviewTriggerAll = "gitlab.review_watches.trigger_all"
ActionGitLabMRWatchesList = "gitlab.mr_watches.list"
ActionGitLabMRWatchDelete = "gitlab.mr_watches.delete"
ActionGitLabMRFilesGet = "gitlab.mr_files.get"
ActionGitLabMRCommitsGet = "gitlab.mr_commits.get"
ActionGitLabTaskMRUpdated = "gitlab.task_mr.updated" // Notification
ActionGitLabMRFeedbackNotify = "gitlab.mr_feedback.notify" // Notification
ActionGitLabNewReviewMRNotify = "gitlab.new_review_mr.notify" // Notification
ActionGitLabTaskMRSync = "gitlab.task_mr.sync"
ActionGitLabStats = "gitlab.stats"
ActionGitLabMRMerge = "gitlab.mr.merge"
ActionGitLabMRApprove = "gitlab.mr.approve"
ActionGitLabMRUnapprove = "gitlab.mr.unapprove"
ActionGitLabMRSetLabels = "gitlab.mr.set_labels"
ActionGitLabMRSetAssignees = "gitlab.mr.set_assignees"
ActionGitLabMRDiscussionNew = "gitlab.mr.discussion.new"
ActionGitLabMRDiscussionResolve = "gitlab.mr.discussion.resolve"
ActionGitLabProjectMergeMethodsGet = "gitlab.project.merge_methods.get"
// Issue watch actions
ActionGitLabIssueWatchesList = "gitlab.issue_watches.list"
ActionGitLabIssueWatchCreate = "gitlab.issue_watches.create"
ActionGitLabIssueWatchUpdate = "gitlab.issue_watches.update"
ActionGitLabIssueWatchDelete = "gitlab.issue_watches.delete"
ActionGitLabIssueTrigger = "gitlab.issue_watches.trigger"
ActionGitLabIssueTriggerAll = "gitlab.issue_watches.trigger_all"
ActionGitLabNewIssueNotify = "gitlab.new_issue.notify" // Notification
// Action preset actions for the /gitlab page quick-launch prompts.
ActionGitLabActionPresetsList = "gitlab.action_presets.list"
ActionGitLabActionPresetsUpdate = "gitlab.action_presets.update"
ActionGitLabActionPresetsReset = "gitlab.action_presets.reset"
// Project discovery / autocomplete.
ActionGitLabListUserProjects = "gitlab.projects.list"
ActionGitLabSearchProjects = "gitlab.projects.search"
ActionGitLabProjectBranches = "gitlab.project.branches"
// Manual cleanup sweeps.
ActionGitLabCleanupReviewTasks = "gitlab.cleanup.review_tasks"
ActionGitLabCleanupIssueTasks = "gitlab.cleanup.issue_tasks"
)
// Jira integration actions
const (
ActionJiraConfigGet = "jira.config.get"
ActionJiraConfigSet = "jira.config.set"
ActionJiraConfigDelete = "jira.config.delete"
ActionJiraConfigTest = "jira.config.test"
ActionJiraTicketGet = "jira.ticket.get"
ActionJiraTicketTransition = "jira.ticket.transition"
ActionJiraProjectsList = "jira.projects.list"
)
// Linear integration actions
const (
ActionLinearConfigGet = "linear.config.get"
ActionLinearConfigSet = "linear.config.set"
ActionLinearConfigDelete = "linear.config.delete"
ActionLinearConfigTest = "linear.config.test"
ActionLinearIssueGet = "linear.issue.get"
ActionLinearIssueTransition = "linear.issue.transition"
ActionLinearTeamsList = "linear.teams.list"
)
// Slack integration actions
const (
ActionSlackConfigGet = "slack.config.get"
ActionSlackConfigSet = "slack.config.set"
ActionSlackConfigDelete = "slack.config.delete"
ActionSlackConfigTest = "slack.config.test"
)
// Office notification actions (server -> client)
const (
ActionOfficeTaskUpdated = "office.task.updated"
ActionOfficeTaskCreated = "office.task.created"
ActionOfficeTaskMoved = "office.task.moved"
ActionOfficeTaskStatus = "office.task.status_changed"
ActionOfficeTaskDecision = "office.task.decision_recorded"
ActionOfficeTaskReview = "office.task.review_requested"
ActionOfficeCommentCreated = "office.comment.created"
ActionOfficeAgentCompleted = "office.agent.completed"
ActionOfficeAgentFailed = "office.agent.failed"
ActionOfficeAgentUpdated = "office.agent.updated"
ActionOfficeApprovalCreated = "office.approval.created"
ActionOfficeApprovalResolved = "office.approval.resolved"
ActionOfficeCostRecorded = "office.cost.recorded"
ActionOfficeRunQueued = "office.run.queued"
ActionOfficeRunProcessed = "office.run.processed"
ActionOfficeRoutineTriggered = "office.routine.triggered"
ActionOfficeActivityCreated = "office.activity.created"
ActionRunEventAppended = "run.event.appended"
// Office provider-routing events.
ActionOfficeProviderHealthChanged = "office.provider.health_changed"
ActionOfficeRouteAttemptAppended = "office.route_attempt.appended"
ActionOfficeRoutingSettingsUpdated = "office.routing.settings_updated"
)
// Automation actions
const (
ActionAutomationList = "automation.list"
ActionAutomationGet = "automation.get"
ActionAutomationCreate = "automation.create"
ActionAutomationUpdate = "automation.update"
ActionAutomationDelete = "automation.delete"
ActionAutomationEnable = "automation.enable"
ActionAutomationDisable = "automation.disable"
ActionAutomationTrigger = "automation.trigger"
ActionAutomationRunsList = "automation.runs.list"
ActionAutomationTriggerAdd = "automation.trigger.add"
ActionAutomationTriggerUpdate = "automation.trigger.update"
ActionAutomationTriggerDelete = "automation.trigger.delete"
ActionAutomationTriggerTypes = "automation.trigger_types"
ActionAutomationWebhookRevealSecret = "automation.webhook.reveal_secret"
)
// Error codes
const (
ErrorCodeBadRequest = "BAD_REQUEST"
ErrorCodeNotFound = "NOT_FOUND"
ErrorCodeInternalError = "INTERNAL_ERROR"
ErrorCodeUnauthorized = "UNAUTHORIZED"
ErrorCodeForbidden = "FORBIDDEN"
ErrorCodeValidation = "VALIDATION_ERROR"
ErrorCodeConflict = "CONFLICT"
ErrorCodeUnknownAction = "UNKNOWN_ACTION"
)