Interface PanelAgentAdapter

packages/ui/src/panel/types.ts:30–81

 * - 'dispose': Agent is being disposed
 */
export interface PanelAgentAdapter extends EventTarget {
	/** Current agent status */
	readonly status: 'idle' | 'running' | 'completed' | 'error' | 'stopped'

	/** Result of the most recent run, or `null` before the first run completes */
	readonly lastResult: { success: boolean } | null

	/** History of agent events */
	readonly history: readonly {
		type: 'step' | 'observation' | 'user_takeover' | 'retry' | 'error'
		stepIndex?: number
		/** For 'step' type */
		reflection?: {
			evaluation_previous_goal?: string
			memory?: string
			next_goal?: string
		}
		/** For 'step' type */
		action?: {
			name: string
			input: unknown
			output: string
		}
		/** For 'observation' type */
		content?: string
		/** For 'retry' type */
		attempt?: number
		maxAttempts?: number
		/** For 'retry' and 'error' types */
		message?: string
	}[]

	/** Current task being executed */
	readonly task: string

	/**
	 * Called when the agent needs to ask the user questions.
	 * If unset, the `ask_user` tool will be disabled.
	 * Panel will set this to handle user questions via its UI.
	 * The optional `signal` aborts when the task is stopped or disposed.
	 */
	onAskUser?: (question: string, options?: { signal: AbortSignal }) => Promise<string>

	/** Execute a task */
	execute(task: string): Promise<unknown>

	/** Stop the current task (agent remains reusable) */
	stop(): Promise<void>

	/** Dispose the agent (terminal, cannot be reused) */
	dispose(): void
}