Package com.tnsai.agents.interrupt

package com.tnsai.agents.interrupt

Agent interruption and checkpoint system.

This package provides interruption capabilities for agents, inspired by AgentScope's realtime steering feature. It allows:

• Graceful interruption of running agents
• State checkpointing and restoration
• Event-based interrupt handling
• Pause/resume functionality

Key Classes

• InterruptibleAgent - Interface for interruptible agents
• InterruptEvent - Sealed hierarchy of interrupt events
• AgentCheckpoint - Immutable snapshot of agent state

Interrupt Event Types

• InterruptEvent.UserInterrupt - User-initiated (cancel, Ctrl+C)
• InterruptEvent.TimeoutInterrupt - Execution timeout
• InterruptEvent.BudgetInterrupt - Token/cost limit exceeded
• InterruptEvent.ErrorInterrupt - Recoverable error
• InterruptEvent.ExternalInterrupt - External system signal

Related Packages

Package	Description
com.tnsai.agents	Agent classes and lifecycle management for the TnsAI framework.

Class	Description
AgentCheckpoint	Represents a checkpoint of agent state for interrupt/resume functionality.
AgentCheckpoint.Builder	Builder for AgentCheckpoint.
InterruptEvent	Sealed hierarchy of interrupt events for agent execution control.
InterruptEvent.BudgetInterrupt	Budget interrupt when token/cost limits are hit.
InterruptEvent.ErrorInterrupt	Error interrupt for recoverable errors.
InterruptEvent.ExternalInterrupt	External system interrupt (e.g., shutdown signal, orchestrator command).
InterruptEvent.TimeoutInterrupt	Timeout interrupt when execution exceeds time limit.
InterruptEvent.UserInterrupt	User-initiated interrupt (e.g., cancel button, Ctrl+C).
InterruptibleAgent	Interface for agents that support graceful interruption and state preservation.