Files
goclaw/pkg/protocol/events.go
T
Viet Tran 9a9744077e refactor(teams): v2 system cleanup — remove legacy tools, fix followup, add events API (#210)
Major refactoring of the team system with multiple improvements:

## Removed legacy delegation tools
- Delete `delegate.go`, `delegate_async.go`, `delegate_sync.go`, `delegate_events.go`,
  `delegate_policy.go`, `delegate_prep.go`, `delegate_state.go`, `delegate_search_tool.go`
- Delete `evaluate_loop_tool.go`, `handoff_tool.go`
- Remove all references and registrations from tool manager and policy
- Clean up TEAM_PLAYBOOK_IDEAS.md and TEAM_SYSTEM.md (moved to docs)

## Rename await_reply → ask_user
- Rename action `await_reply` → `ask_user`, `clear_followup` → `clear_ask_user`
- Rename functions `executeAwaitReply` → `executeAskUser`, `executeClearFollowup` → `executeClearAskUser`
- Update system prompt with stronger wording to prevent model misuse
- Model was confusing "await_reply" with general waiting; "ask_user" is unambiguous

## Fix auto-followup false positives
- Add `HasActiveMemberTasks(ctx, teamID, excludeAgentID)` store method
- Guard `autoSetFollowup()` in consumer: skip when lead has active member tasks
- Prevents auto-followup when lead is orchestrating teammates (not waiting for user)

## Task identifier zero-padding
- Change format from `T-1-xxxx` → `T-001-xxxx` (3-digit minimum)

## Refactor workspace WS handlers to filesystem-only
- Rewrite `teams.workspace.list/read/delete` to use pure filesystem (os.ReadDir/ReadFile/Remove)
- Remove DB dependency from workspace WS handlers
- Consistent with storage handler and workspace tools
- Simplify TeamWorkspaceFile type and frontend hook

## Add team events listing API
- New WS method `teams.events.list` with team_id, limit, offset params
- New HTTP endpoint `GET /v1/teams/{id}/events` with bearer auth
- New `ListTeamEvents(ctx, teamID, limit, offset)` store method
- JOIN with team_tasks for team-wide event filtering

## Extract team access policy
- New `team_access_policy.go` — centralized team tool access control

## Migration 000019: team_id columns
- Add team_id foreign key columns to relevant tables

## Other improvements
- Add team_id propagation through agent loop, tracing, sessions
- Update i18n locale files (en/vi/zh) for new tool labels
- Update frontend builtin-tools page and require-setup component
- Bump RequiredSchemaVersion for migration 000019
2026-03-15 14:53:19 +07:00

115 lines
4.3 KiB
Go

package protocol
// WebSocket event names pushed from server to client.
const (
EventAgent = "agent"
EventChat = "chat"
EventHealth = "health"
EventCron = "cron"
EventExecApprovalReq = "exec.approval.requested"
EventExecApprovalRes = "exec.approval.resolved"
EventPresence = "presence"
EventTick = "tick"
EventShutdown = "shutdown"
EventNodePairRequested = "node.pair.requested"
EventNodePairResolved = "node.pair.resolved"
EventDevicePairReq = "device.pair.requested"
EventDevicePairRes = "device.pair.resolved"
EventVoicewakeChanged = "voicewake.changed"
EventConnectChallenge = "connect.challenge"
EventTalkMode = "talk.mode"
// Agent summoning events (predefined agent setup via LLM).
EventAgentSummoning = "agent.summoning"
// Agent handoff event (payload: from_agent, to_agent, reason).
EventHandoff = "handoff"
// Team activity events (real-time team workflow visibility).
EventTeamTaskCreated = "team.task.created"
EventTeamTaskCompleted = "team.task.completed"
EventTeamMessageSent = "team.message.sent"
EventDelegationStarted = "delegation.started"
EventDelegationCompleted = "delegation.completed"
// Delegation lifecycle events.
EventDelegationFailed = "delegation.failed"
EventDelegationCancelled = "delegation.cancelled"
EventDelegationProgress = "delegation.progress"
EventDelegationAccumulated = "delegation.accumulated"
EventDelegationAnnounce = "delegation.announce"
EventQualityGateRetry = "delegation.quality_gate.retry"
// Team task lifecycle events.
EventTeamTaskClaimed = "team.task.claimed"
EventTeamTaskCancelled = "team.task.cancelled"
EventTeamTaskFailed = "team.task.failed"
EventTeamTaskReviewed = "team.task.reviewed"
EventTeamTaskApproved = "team.task.approved"
EventTeamTaskRejected = "team.task.rejected"
EventTeamTaskProgress = "team.task.progress"
EventTeamTaskCommented = "team.task.commented"
EventTeamTaskAssigned = "team.task.assigned"
EventTeamTaskUpdated = "team.task.updated"
EventTeamTaskStale = "team.task.stale"
// Team CRUD events (admin operations).
EventTeamCreated = "team.created"
EventTeamUpdated = "team.updated"
EventTeamDeleted = "team.deleted"
EventTeamMemberAdded = "team.member.added"
EventTeamMemberRemoved = "team.member.removed"
// Workspace events (team file changes).
EventWorkspaceFileChanged = "workspace.file.changed"
// Agent link events (admin operations).
EventAgentLinkCreated = "agent_link.created"
EventAgentLinkUpdated = "agent_link.updated"
EventAgentLinkDeleted = "agent_link.deleted"
// Trace lifecycle events (realtime trace/span updates).
EventTraceUpdated = "trace.updated"
// Skill dependency check events (realtime progress during startup/rescan).
EventSkillDepsChecked = "skill.deps.checked"
EventSkillDepsComplete = "skill.deps.complete"
// Skill dependency install events (triggered by POST /v1/skills/install-deps).
EventSkillDepsInstalling = "skill.deps.installing"
EventSkillDepsInstalled = "skill.deps.installed"
// Per-item install events (triggered by POST /v1/skills/install-dep).
EventSkillDepItemInstalling = "skill.dep.item.installing" // payload: {dep: "pip:openpyxl"}
EventSkillDepItemInstalled = "skill.dep.item.installed" // payload: {dep, ok: bool, error?: string}
// Cache invalidation events (internal, not forwarded to WS clients).
EventCacheInvalidate = "cache.invalidate"
// Audit log event (internal, not forwarded to WS clients).
EventAuditLog = "audit.log"
// Zalo Personal QR login events (client-scoped, not broadcast).
EventZaloPersonalQRCode = "zalo.personal.qr.code"
EventZaloPersonalQRDone = "zalo.personal.qr.done"
)
// Agent event subtypes (in payload.type)
const (
AgentEventRunStarted = "run.started"
AgentEventRunCompleted = "run.completed"
AgentEventRunFailed = "run.failed"
AgentEventRunRetrying = "run.retrying"
AgentEventToolCall = "tool.call"
AgentEventToolResult = "tool.result"
AgentEventBlockReply = "block.reply"
AgentEventActivity = "activity" // agent phase transitions: thinking, tool_exec, compacting
)
// Chat event subtypes (in payload.type)
const (
ChatEventChunk = "chunk"
ChatEventMessage = "message"
ChatEventThinking = "thinking"
)