observation

type CommandAction struct{ Type, Command, Path, Query string }

type Context struct {
	Tokens, Window uint64
	Known          bool
}

type Event struct {
	At, Started                                 time.Time
	Kind                                        Kind
	ThreadID, TurnID, ItemID, Delta, TurnStatus string
	Item                                        Item
	Thread                                      Thread
	ThreadStatus, ProcessID, Stdin              string
	Context                                     Context
}

type FileChange struct {
	Path, Diff string
	Kind       struct{ Type, MovePath string }
}

type Item struct {
	SavedPath                                          string
	CompactionReference                                string // Exact retained replacement bound to this native boundary.
	UserShell                                          bool   // Host-identified command entered by the user.
	ID, Type, Status, Text, Delivery, Phase, Cwd, Path string
	Command, ProcessID, ClientID                       string
	Tool                                               string
	Server                                             string         // MCP server identity.
	Arguments, Result, Error                           jsontext.Value // Opaque MCP input and outcome.
	DurationMS                                         *int64
	Summary                                            []string
	Content                                            jsontext.Value
	AggregatedOutput                                   *string
	ExitCode                                           *int
	Questions                                          []Question
	Changes                                            []FileChange
	CommandActions                                     []CommandAction
	Query                                              string
	Action                                             *WebSearchAction
	Results                                            *int
}

type ItemRef struct{ ThreadID, TurnID, ItemID string }

type Kind string

type Question struct {
	ID, Header, Question, Title string
	IsSecret                    bool
	Options                     jsontext.Value
}

type Source struct {
	Thread, Cwd string
	Events      []Event
	Unsupported map[string]int
	Bytes       int
}

type TextEvent struct {
	At    time.Time
	Kind  Kind
	Item  TextItem
	Delta string
}

type TextItem struct {
	Ref                  ItemRef
	Type, Text, Status   string
	Summary              []string
	AsyncQuestion, Final bool
}

type TextScope struct{ Thread, Turn *scope.Store }

type TextUpdate struct {
	Ref                       ItemRef
	Replaces                  string
	Kind, Phase, Text, Status string
	Observed, Completed       time.Time
	Thought                   time.Duration
	Live                      bool
	Sequence                  uint64
}

type Thread struct {
	ID, Nickname, Path, Role string
	NonAttachable            bool
}

type Transcript interface {
	// current is false only when the application knows another turn is active.
	TurnCompleted(thread, turn, status string, at time.Time, current bool, stores TextScope) []TextUpdate
	Observe(TextEvent, bool, TextScope) []TextUpdate
	ProviderStarted(thread string, at time.Time, store *scope.Store) []TextUpdate
	OtherItemStarted(thread string, store *scope.Store) []TextUpdate
}

type WebSearchAction struct {
	Type, Query, URL, Pattern string
	Queries                   []string
}