agent

var AllTargets = []Target{TargetClaude, TargetCursor, TargetAgentsMD}

var CLIDoc string

var ErrUnclosedSection = errors.New("AGENTS.md has an audd begin marker but no " + EndMarker + " after it")

var ExitCodes = []ExitCode{
	{0, "ok", "success, including no match"},
	{1, "unexpected", "unexpected error, or no match with --fail-on-no-match"},
	{2, "usage", "invalid arguments or input, or a missing tool such as ffmpeg"},
	{3, "auth", "missing or rejected API token, or sign-in needed (audd login)"},
	{4, "quota", "quota, plan, or feature not available on the account"},
	{5, "network", "network or server error; retrying may help"},
	{6, "safety", "a bound is missing (--limit, --max-files), a confirmation is needed (--yes), --max-requests was reached, or an unfinished job for the same files needs --resume or --new"},
	{7, "partial", "a batch finished with some files failed"},
	{8, "threshold", "usage --check found fewer remaining requests than --min-remaining"},
	{130, "interrupted", "stopped with Ctrl-C; a batch keeps finished files (audd jobs resume continues it)"},
}

var Outputs = map[string]Output{
	"object": {Description: `one JSON document: {"schema_version":1, ...fields}`},
	"list":   {Description: `one JSON document with the rows under "items": {"schema_version":1,"items":[...]}`},
	"recognition": {
		Description: `One file or URL: {"schema_version":1,"input","cached","result"} where result is AudD's result object or null for no match; with --enterprise, "matches" (and "tracks" with --tracklist) instead of "result"; with --dry-run (one input or a batch), {"dry_run":true,"input":name|null,"job_id":id|null,"endpoint":"standard"|"enterprise","plan":{"files","cached_files","requests","approximate","cost_usd"}}: input is set for one file or URL, job_id when a batch would resume a job; requests and cost_usd are null with "unbounded":true when enterprise URLs with --limit none (or a dry run without --limit) leave the scan uncapped; with --format jsonl the plan is a "type":"event" line with "event":"dry_run". Folders, globs, lists, and jobs resume print JSON lines: "result" per file, "progress", and a final "summary" whose counts are for the whole job (as in audd jobs list), with "requests_spent_this_run" for this run.`,
		Schema: obj(map[string]any{
			"schema_version": typ("integer"),
			"input":          typ("string"),
			"cached":         typ("boolean"),
			"result":         map[string]any{"type": []string{"object", "null"}, "description": "AudD's result: artist, title, album, release_date, label, timecode, song_link, plus any --return blocks"},
			"matches":        map[string]any{"type": "array", "description": "enterprise matches, each with start and end positions"},
			"tracks":         map[string]any{"type": "array", "description": "with --tracklist: merged tracks with start_seconds and end_seconds"},
		}),
	},
	"api_response": {Description: `{"schema_version":1, ...the fields of the API's JSON response}: the response as AudD sent it, with "schema_version" added`},
	"plays": {
		Description: `{"schema_version":1,"since","plays":[play...],"gaps":[{"from","to"}...]}: plays newest first; gaps are periods some stream was not recorded, so totals may miss plays there`,
		Schema: obj(map[string]any{
			"plays": map[string]any{"type": "array", "items": playSchema},
			"gaps":  map[string]any{"type": "array", "items": gapSchema},
		}),
	},
	"play_stream": {
		Description: `JSON lines: {"schema_version":1,"type":"result", ...play} per play, and "event" lines for stream health`,
		Schema:      playSchema,
	},
	"now_playing": {
		Description: `With --once, one document with the latest song of each stream ({"stations":[{"radio_id","url","stream_running","health","now_playing":{...play,"state","playing","elapsed_seconds","played_seconds","ended_at","ago_seconds","length_seconds"}}]}); otherwise JSON lines, a "result" line with the same fields each time the song changes. state is just_played or last_recognized for results sent when a song ends (the default), playing for streams added with --start; elapsed_seconds only while playing, played_seconds and ended_at only for end-of-song results, length_seconds only with provider metadata`,
	},
	"report": {
		Description: `{"schema_version":1,"by","since","rows":[{"key","plays","airtime_seconds","stations"}...],"gaps","complete"}; complete is false when gaps mean totals miss plays`,
	},
	"docs":     {Description: `The page's markdown as is, piped or not; with --format json, {"schema_version":1,"topic","source","markdown"}. Without a topic, the list of topics`},
	"commands": {Description: "this reference"},
	"error": {
		Description: "printed to stderr when a command fails in a machine format",
		Schema: obj(map[string]any{
			"schema_version": typ("integer"),
			"error": obj(map[string]any{
				"code":      typ("string"),
				"api_code":  typ("integer"),
				"message":   typ("string"),
				"hint":      map[string]any{"type": "string", "description": "usually the command that fixes it"},
				"retryable": typ("boolean"),
			}),
		}),
	},
}

var Topics = []Topic{
	{Name: "api", Title: "Recognition API: endpoints, parameters, results, errors", Path: "/.md", Account: "api"},
	{Name: "enterprise", Title: "Enterprise endpoint: whole files, every match with timestamps", Path: "/enterprise.md", Account: "enterprise"},
	{Name: "streams", Title: "Stream monitoring: streams, callbacks, longpoll", Path: "/streams.md", Account: "streams"},
	{Name: "upload", Title: "Sending audio files and URLs", Path: "/upload_audio_endpoint.md", Account: "upload"},
	{Name: "mcp", Title: "The AudD MCP server", Path: "/mcp.md"},
	{Name: "sdks", Title: "Official SDKs", Path: "/sdks.md"},
	{Name: "cli", Title: "This CLI: commands, limits, output, exit codes"},
}