emit

type Artifact struct {
	Dir   string
	Files []File
}

type File struct {
	Name  string
	Bytes []byte
}

type Manifest struct {
	SchemaVersion string `json:"schema_version"`
	// Outcome comes second, immediately after the version and before the
	// content, because it is the field that decides whether the rest of this
	// manifest describes the page that was asked for.
	Outcome     graph.Outcome `json:"outcome"`
	URL         string        `json:"url"`
	FinalURL    string        `json:"final_url,omitempty"`
	Title       string        `json:"title"`
	Summary     string        `json:"summary"`
	Lang        string        `json:"lang,omitempty"`
	ContentHash string        `json:"content_hash"`
	DistilledAt time.Time     `json:"distilled_at"`

	Sections []ManifestSection `json:"sections"`

	Counts     ManifestCounts   `json:"counts"`
	Stats      *graph.Stats     `json:"stats,omitempty"`
	Audit      graph.Audit      `json:"audit"`
	Provenance graph.Provenance `json:"provenance"`
	// Gaps names content the page has that this artifact does not, so an agent
	// can decide to look elsewhere rather than concluding the page is silent
	// on a subject.
	Gaps []graph.Gap `json:"gaps,omitempty"`

	// Guidance is addressed to the model reading this manifest. Tool results are
	// read by a model, so the manifest says in plain words what to do next
	// rather than assuming the calling agent has read any documentation.
	Guidance string `json:"guidance"`
}

type ManifestCounts struct {
	Blocks  int `json:"blocks"`
	Actions int `json:"actions"`
	Forms   int `json:"forms"`
	Links   int `json:"links"`
	Media   int `json:"media"`
	// Latent counts hidden blocks. They are not part of the default payload
	// and are not counted in TotalTokens.
	Latent int `json:"latent"`
	// TotalTokens is what fetching the entire artifact would cost, which is
	// exactly the number an agent needs in order to decide not to.
	TotalTokens int `json:"est_total_tokens"`
}

type ManifestSection struct {
	ID         string `json:"id"`
	Title      string `json:"title"`
	Level      int    `json:"level,omitempty"`
	Blocks     int    `json:"blocks,omitempty"`
	Chars      int    `json:"chars,omitempty"`
	Tokens     int    `json:"est_tokens"`
	FirstBlock string `json:"first_block,omitempty"`
	LastBlock  string `json:"last_block,omitempty"`
}

type MarkdownOptions struct {
	// FrontMatter adds a YAML block with provenance.
	FrontMatter bool
	// Navigation appends the page's own navigation as a list. It is off by
	// default in the compact rendering because it costs tokens and answers only
	// structural questions.
	Navigation bool
	// Actions appends links, buttons and form schemas.
	Actions bool
	// Provenance annotates blocks that did not come from the DOM.
	Provenance bool
	// SafetyPreamble emits the notice that marks the body as untrusted data.
	SafetyPreamble bool
	// BlockIDs annotates each block with its id, so an agent reading the
	// Markdown can ask for a specific block by name afterwards.
	BlockIDs bool
	// Gaps lists the disclosure controls whose content was not opened.
	Gaps bool
	// Structured appends whitelisted facts from the page's structured data.
	Structured bool
	// Audit appends the artifact's account of its own reliability.
	Audit bool
	// Notes appends the prose the extraction recorded about itself: where the
	// content came from, and what it could not reach.
	//
	// Separate from Audit, which is retention ratios and confidence buckets --
	// statistics about the extraction. These are statements about the content,
	// and a reader needs them for a different reason: "the words on this page
	// were read out of a 3D scene rather than the document" changes how much a
	// figure should be trusted and what a follow-up should ask for, and it was
	// being computed and then withheld.
	Notes bool
	// Strict drops every metadata channel: alt text, aria labels, structured
	// data, captions. It is the minimal-trust surface for a caller who wants
	// only text a visitor could have read on screen.
	Strict bool
}