notify

type Notification ¶

type Notification struct {
	SessionID    string
	SessionTitle string
	Type         Type
	ProviderID   string
	// RunID, when non-empty, is the caller-supplied correlator
	// (proto.AgentMessage.RunID) for the run that produced this
	// notification. It lets observers attribute a TypeAgentError to a
	// specific request rather than to any in-flight run on the
	// session. Empty when no caller set one.
	RunID string
	// Message carries the error text for TypeAgentError. Other
	// notification types ignore it.
	Message string
}

Notification represents a domain event published by the agent.

type RunComplete ¶

type RunComplete struct {
	SessionID string
	RunID     string
	MessageID string
	Text      string
	Error     string
	Cancelled bool
}

RunComplete is the authoritative end-of-run signal for a session. It is published exactly once per top-level agent run (per [sessionAgent.Run] invocation that actually executed) after all message updates for the turn have been flushed via message.Service.FlushAll. Carries the final assistant text and message ID so non-interactive clients can reconcile stdout even if SSE events arrive out of order or are dropped by the broker. Error is non-empty when the run terminated with an error; Cancelled is true when the run terminated due to context cancellation. The two are mutually exclusive in the success case but may overlap when a cancel triggers a downstream error.

RunID identifies the specific request that produced this event. It is the value the caller set on `proto.AgentMessage.RunID` (or equivalently propagated via agent.WithRunID on the context that reaches the coordinator); empty when no caller set one. Filtering by RunID lets a client correlate a SendMessage call with its terminal event even when the session is busy and other turns are finishing on the same session.

type Type ¶

type Type string

Type identifies the kind of agent notification.

const (
	// TypeAgentFinished indicates the agent has completed its turn.
	TypeAgentFinished Type = "agent_finished"
	// TypeReAuthenticate indicates the agent encountered an
	// authentication error and the user needs to re-authenticate.
	TypeReAuthenticate Type = "re_authenticate"
	// TypeAgentError indicates the agent's turn terminated with an
	// error. The error text is carried in Notification.Message.
	TypeAgentError Type = "error"
)