atif

type Agent struct {
	Name      string `json:"name"`
	Version   string `json:"version"`
	ModelName string `json:"model_name"`
	// ToolDefinitions are OpenAI chat-completions tool objects,
	// {"type":"function","function":{name,description,parameters}},
	// kept as written.
	ToolDefinitions []json.RawMessage `json:"tool_definitions"`
	Ext             json.RawMessage   `json:"extra"`

	Members

	Raw json.RawMessage `json:"-"`
	Err error           `json:"-"`
}

type Content struct {
	Text  string
	Parts []*Part
	// IsText says the value was a string, the empty string included.
	IsText bool
	// Raw is a value that is neither, kept as written.
	Raw json.RawMessage
}

type File struct {
	// Path is the file the document was read from; empty when it was
	// read from a reader.
	Path string
	// Doc is the document, or, when Cut is set, what of it the reader
	// could read.
	Doc *Trajectory
	// Cut is set when the document does not parse to its end, as a file
	// a producer was rewriting in place when it was killed does not:
	// Doc then holds the root members and the steps that end before
	// CutAt, the byte after the last value that parsed. It is taken
	// where the parse last succeeded, not where it failed, since where
	// encoding/json stops on an error differs between Go releases.
	Cut   error
	CutAt int64
	// CutStep says a step was cut short. It is a unit the reader could
	// not read, and is not among Doc's steps.
	CutStep bool
	// CutMembers lists the root members that were cut short, or that
	// follow the cut, as far as the reader can tell: those whose name
	// it read.
	CutMembers []string
}

type Members = jsonline.Members

type Metrics struct {
	// PromptTokens counts all input, cached tokens included.
	PromptTokens json.RawMessage `json:"prompt_tokens"`
	// CompletionTokens counts all output, reasoning included.
	CompletionTokens json.RawMessage `json:"completion_tokens"`
	// CachedTokens is the part of PromptTokens read from a cache.
	CachedTokens       json.RawMessage `json:"cached_tokens"`
	CostUSD            json.RawMessage `json:"cost_usd"`
	PromptTokenIDs     json.RawMessage `json:"prompt_token_ids"`
	CompletionTokenIDs json.RawMessage `json:"completion_token_ids"`
	Logprobs           json.RawMessage `json:"logprobs"`
	Ext                json.RawMessage `json:"extra"`

	Members

	Raw json.RawMessage `json:"-"`
	Err error           `json:"-"`
}

type Object struct {
	Raw json.RawMessage
}

type Observation struct {
	Results []*Result `json:"results"`

	Members

	Raw json.RawMessage `json:"-"`
	Err error           `json:"-"`
}

type Part struct {
	Type   string  `json:"type"`
	Text   string  `json:"text"`
	Source *Source `json:"source"`

	Members

	Raw json.RawMessage `json:"-"`
	Err error           `json:"-"`
}

type Ref struct {
	TrajectoryID   string          `json:"trajectory_id"`
	SessionID      string          `json:"session_id"`
	TrajectoryPath string          `json:"trajectory_path"`
	Ext            json.RawMessage `json:"extra"`

	Members

	Raw json.RawMessage `json:"-"`
	Err error           `json:"-"`
}

type Refs struct {
	List []*Ref
	// Object says the member was one object rather than a list.
	Object bool
	// Raw is a value that is neither, kept as written.
	Raw json.RawMessage
}

type Result struct {
	// SourceCallID names a tool call of the same step; empty when the
	// result names none (absent or null).
	SourceCallID string          `json:"source_call_id"`
	Content      Content         `json:"content"`
	Refs         Refs            `json:"subagent_trajectory_ref"`
	Ext          json.RawMessage `json:"extra"`

	Members

	Raw json.RawMessage `json:"-"`
	Err error           `json:"-"`
}

type Source struct {
	MediaType string `json:"media_type"`
	// Path is relative to the document's directory, absolute, or a URL.
	Path string `json:"path"`
	// DurationSec is an audio clip's length, kept as written.
	DurationSec json.RawMessage `json:"duration_sec"`

	Members

	Raw json.RawMessage `json:"-"`
	Err error           `json:"-"`
}

type Step struct {
	// StepID is the 1-based ordinal, kept as written.
	StepID    json.RawMessage `json:"step_id"`
	Timestamp string          `json:"timestamp"`
	Source    string          `json:"source"`
	ModelName string          `json:"model_name"`
	// ReasoningEffort is a string or a number, kept as written.
	ReasoningEffort  json.RawMessage `json:"reasoning_effort"`
	Message          Content         `json:"message"`
	ReasoningContent string          `json:"reasoning_content"`
	ToolCalls        []*ToolCall     `json:"tool_calls"`
	Observation      *Observation    `json:"observation"`
	Metrics          *Metrics        `json:"metrics"`
	IsCopiedContext  *bool           `json:"is_copied_context"`
	// LLMCallCount is the number of model calls the step stands for,
	// kept as written: 0 marks a deterministic dispatch no model made.
	LLMCallCount json.RawMessage `json:"llm_call_count"`
	Ext          json.RawMessage `json:"extra"`

	Members

	// Raw is the step as read, and Err why it did not decode, for a
	// value that is not an object.
	Raw json.RawMessage `json:"-"`
	Err error           `json:"-"`
}

type ToolCall struct {
	ToolCallID   string `json:"tool_call_id"`
	FunctionName string `json:"function_name"`
	// Arguments is a JSON object in a valid document, kept as written.
	Arguments json.RawMessage `json:"arguments"`
	Ext       json.RawMessage `json:"extra"`

	Members

	Raw json.RawMessage `json:"-"`
	Err error           `json:"-"`
}

type Trajectory struct {
	SchemaVersion string `json:"schema_version"`
	// SessionID is scoped to the run, not the document: a parent, its
	// sub-agents and its continuations may share it.
	SessionID string `json:"session_id"`
	// TrajectoryID names this document; an embedded sub-agent must set
	// it, and a reference names the sub-agent by it.
	TrajectoryID string          `json:"trajectory_id"`
	Agent        *Agent          `json:"agent"`
	Steps        []*Step         `json:"steps"`
	Notes        string          `json:"notes"`
	FinalMetrics *Object         `json:"final_metrics"`
	ContinuedRef string          `json:"continued_trajectory_ref"`
	Ext          json.RawMessage `json:"extra"`
	// SubagentsRaw is subagent_trajectories as written, and Subagents
	// the trajectories it embeds, each of which may embed its own,
	// decoded one by one after this one: decoding them with it would
	// decode a nested trajectory again at every level whose members
	// need a second pass. SubagentsMistyped says the member is not an
	// array.
	SubagentsRaw      json.RawMessage `json:"subagent_trajectories"`
	Subagents         []*Trajectory   `json:"-"`
	SubagentsMistyped bool            `json:"-"`

	Members

	// Raw is the object as read, and Err why it did not decode, for a
	// value that is not an object; nothing else is then set.
	Raw json.RawMessage `json:"-"`
	Err error           `json:"-"`
}