Package akka.javasdk.agent.autonomous
Interface Notification
- All Known Subinterfaces:
Notification.BacklogNotification,Notification.ConversationNotification,Notification.DelegationNotification,Notification.HandoffNotification,Notification.LifecycleNotification,Notification.MessagingNotification,Notification.StruggleNotification,Notification.TaskNotification,Notification.TeamNotification
- All Known Implementing Classes:
Notification.Activated,Notification.BacklogAccessGranted,Notification.BacklogAssigned,Notification.BacklogClosed,Notification.BacklogTaskClaimed,Notification.ContactAdded,Notification.ConversationCreated,Notification.ConversationEnded,Notification.ConversationJoined,Notification.ConversationParticipantReady,Notification.ConversationParticipantSetupFailed,Notification.ConversationTurnReceived,Notification.Deactivated,Notification.DelegationResolved,Notification.DelegationStarted,Notification.DependencyResolved,Notification.HandoffReceived,Notification.HandoffStarted,Notification.IterationCompleted,Notification.IterationFailed,Notification.IterationStarted,Notification.MessageReceived,Notification.ParticipantTurnSubmitted,Notification.RepeatedIterationFailure,Notification.Resumed,Notification.Stopped,Notification.Suspended,Notification.TaskApproachingMaxIterations,Notification.TaskAssigned,Notification.TaskCancelled,Notification.TaskCompleted,Notification.TaskDependencyStuck,Notification.TaskDependencyWait,Notification.TaskFailed,Notification.TaskResultRejected,Notification.TaskStarted,Notification.TaskStruggleDetected,Notification.TeamCreated,Notification.TeamDisbanded,Notification.TeamJoined,Notification.TeamMemberReady,Notification.TeamMemberSetupFailed,Notification.TeamMemberStopped,Notification.WorkerTaskCompleted,Notification.WorkerTaskReceived
@DoNotInherit
public sealed interface Notification
permits Notification.LifecycleNotification, Notification.TaskNotification, Notification.HandoffNotification, Notification.DelegationNotification, Notification.TeamNotification, Notification.BacklogNotification, Notification.ConversationNotification, Notification.MessagingNotification, Notification.StruggleNotification
Notifications published by the runtime for an autonomous agent instance.
These events are emitted automatically by the runtime as the agent progresses through its execution loop. They are not published by user code.
Subscribe to notifications via AutonomousAgentClient.notificationStream().
Notifications are grouped by capability into marker sub-interfaces (for example Notification.LifecycleNotification, Notification.TaskNotification, Notification.TeamNotification). User code can match
on a marker to handle a whole family generically.
-
Nested Class Summary
Nested ClassesModifier and TypeInterfaceDescriptionstatic final recordAgent activated — transitioned from idle to processing.static final recordBacklog access: this agent has been granted access to a backlog.static final recordBacklog management: a backlog has been assigned to this agent.static final recordBacklog management: a backlog has been closed.static interfaceBacklog notifications: backlog assignment/access and task claims.static final recordBacklog access: this agent claimed a task from a backlog.static final recordA new contact was introduced to this agent.static final recordConversation moderator: a new conversation was created with the given participants.static final recordConversation moderator: a conversation has ended.static final recordConversation participant: this agent joined a conversation moderated by the given agent.static interfaceConversation notifications: conversation creation, turns, participation.static final recordConversation moderator: a participant's setup completed and they are ready to take turns.static final recordConversation moderator: a participant's setup failed.static final recordConversation moderator: a turn was received from a participant.static final recordAgent deactivated — no more work, back to idle.static interfaceDelegation notifications: orchestrator-side and worker-side of subtask delegation.static final recordOrchestrator side: aggregate resolution of a delegation batch.static final recordOrchestrator side: a batch of subtasks has been dispatched to workers.static final recordA specific dependency for a task has resolved (success or failure).static interfaceHandoff notifications: source-side and target-side of cross-agent handoffs.static final recordTarget side: this agent has received a handed-off task from another agent.static final recordSource side: this agent has handed off a task to another agent.static final recordAgent iteration completed successfully.static final recordAgent iteration failed.static final recordAgent iteration started — LLM call beginning.static interfaceLifecycle notifications: agent activation, iteration boundaries, pause/resume/stop.static final recordA message was received from another agent.static interfaceMessaging notifications: contact introductions and message delivery.static final recordConversation participant: this agent submitted its turn after the given number of iterations.static final recordDerived signal: N consecutive iteration failures in flows not tied to a specific task (pre-task setup, request-based delegation).static final recordAgent resumed.static final recordAgent stopped.static interfaceStruggle signals: derived notifications for repeated failures, stuck deps, approaching limits.static final recordAgent suspended.static final recordDerived signal: a task is at or beyond a configurable fraction (default 80%) of its max iterations.static final recordA task was assigned (queued) — fires before the model loop begins setup for it.static final recordTask was cancelled by the framework — dependency failure, max iterations, orphan cleanup, etc.static final recordAgent completed a task successfully.static final recordDerived signal: a task waiting on dependencies has been waiting longer than the configured threshold.static final recordA task is blocked waiting for one or more dependency tasks to resolve.static final recordAgent failed a task via explicit fail_task.static interfaceTask notifications: assignment, start, completion, failure, cancellation, dependencies.static final recordAgent's task result was rejected by a validation rule.static final recordAgent started working on a task.static final recordDerived signal: a task is struggling — N consecutive iteration failures, M consecutive result rejections, or some other impediment captured inNotification.TaskStruggleDetected.reason().static final recordTeam lead: a new team was formed with the given members.static final recordTeam lead: a team has been disbanded.static final recordTeam member: this agent joined a team led by the given agent.static final recordTeam lead: a team member's setup chain completed and the member is now active.static final recordTeam lead: a team member's setup chain failed.static final recordTeam lead: a team member has stopped.static interfaceTeam notifications: team formation, member lifecycle, disbanding.static final recordWorker side: this agent finished its delegated subtask.static final recordWorker side: this agent accepted a delegated subtask from the orchestrator.