cmd

type AttachmentCmd struct {
	Download AttachmentDownloadCmd `cmd:"" help:"Download an attachment by ID."`
}

type AttachmentDownloadCmd struct {
	Ref    string `arg:"" name:"url" help:"Disbug report URL with ?pin=<number>."`
	ID     int64  `arg:"" name:"attachment-id" help:"Attachment ID shown in session or pin output."`
	Output string `short:"o" help:"Destination file or directory; defaults to the attachment filename."`
	Stdout bool   `help:"Write the raw attachment bytes to stdout instead of a file."`
	Force  bool   `help:"Overwrite an existing destination file."`
}

type CLI struct {
	RootFlags

	Version kong.VersionFlag `name:"version" help:"Show version."`

	Sessions   SessionsCmd   `cmd:"" name:"sessions" help:"List cloud sessions, optionally filtered by status or time."`
	Session    SessionCmd    `cmd:"" name:"session" help:"Show a cloud session summary from its report URL."`
	Pin        PinCmd        `cmd:"" name:"pin" help:"Fetch selected evidence for one pin from a report URL."`
	Pins       PinsCmd       `cmd:"" name:"pins" help:"Fetch evidence for pins from multiple report URLs."`
	Attachment AttachmentCmd `cmd:"" name:"attachment" help:"Download a file attached to a cloud pin."`
	Search     SearchCmd     `cmd:"" name:"search" help:"Search cloud sessions or pins."`
	Watch      WatchCmd      `cmd:"" name:"watch" help:"Stream newly saved cloud sessions as events."`
	Inspect    InspectCmd    `cmd:"" name:"inspect" help:"Inspect a downloaded local report JSON file."`

	Login     LoginCmd     `cmd:"" name:"login" help:"Authenticate and save a Disbug token profile."`
	Logout    LogoutCmd    `cmd:"" name:"logout" help:"Remove a saved Disbug token profile."`
	Whoami    WhoamiCmd    `cmd:"" name:"whoami" help:"Show the authenticated agent and team."`
	Configure ConfigureCmd `cmd:"" name:"configure" help:"Connect Disbug MCP and its workflow skill to AI coding agents."`
	Doctor    DoctorCmd    `cmd:"" name:"doctor" help:"Check login, backend compatibility, and agent integrations."`

	MCP        MCPCmd        `cmd:"" name:"mcp" help:"Run the Disbug MCP server over stdio."`
	Completion CompletionCmd `cmd:"" name:"completion" help:"Generate shell completion scripts."`
	VersionCmd VersionCmd    `cmd:"" name:"version" help:"Print the disbug version."`
}

type CompletionCmd struct {
	Shell string `arg:"" enum:"bash,zsh,fish,powershell" help:"Shell to generate completions for."`
}

type ConfigureCmd struct {
	Agents    []string `name:"agent" help:"Agent to configure; repeat for more than one (codex, claude-code, cursor)."`
	Yes       bool     `short:"y" help:"Apply the displayed plan without prompting."`
	DryRun    bool     `name:"dry-run" help:"Show changes without applying them."`
	SkipMCP   bool     `name:"skip-mcp" help:"Do not configure the Disbug MCP server."`
	SkipSkill bool     `name:"skip-skill" help:"Do not install the using-disbug skill."`
	Force     bool     `help:"Replace an existing using-disbug skill not managed by Disbug."`
}

type DoctorCmd struct{}

type InspectCmd struct {
	Path     string `arg:"" name:"path" help:"Path to a downloaded Disbug local report JSON file."`
	Pin      int    `help:"Inspect one pin by number instead of returning the session summary."`
	Fields   string `help:"Comma-separated fields for --pin: screenshot,console,network,events,replay,voice_note,video,all."`
	CacheDir string `name:"cache-dir" help:"Directory for decoded local artifacts. Defaults to the user cache directory."`
}

type LoginCmd struct {
	Name           string  `help:"Agent name to pre-fill. Defaults to hostname."`
	APIURL         string  `name:"api-url" env:"DISBUG_API_URL" default:"https://disbug.io" help:"Disbug API URL."`
	ListenAddr     string  `name:"listen-addr" help:"Local listener host:port override."`
	Manual         bool    `help:"Print auth URL and paste redirect URL back instead of listening."`
	NoBrowser      bool    `name:"no-browser" help:"Print auth URL instead of opening the browser."`
	Force          bool    `help:"Overwrite an existing token profile."`
	Token          *string `help:"Set token directly."`
	TokenFromStdin bool    `name:"token-from-stdin" help:"Read token from the first stdin line."`
	TokenFromEnv   bool    `name:"token-from-env" help:"Read token from DISBUG_LOGIN_TOKEN."`
}

type LogoutCmd struct {
	LocalOnly bool `name:"local-only" help:"Skip server revoke; just delete local profile."`
}

type MCPCmd struct{}

type PinCmd struct {
	Get    PinGetCmd    `cmd:"" default:"withargs" help:"Fetch selected evidence for one pin."`
	Status PinStatusCmd `cmd:"" help:"Update a cloud pin status."`
}

type PinGetCmd struct {
	Ref    string `arg:"" name:"url" help:"Disbug report URL with ?pin=<number>."`
	Pin    int64  `help:"Pin number when the report URL does not include ?pin=."`
	Fields string `help:"Comma-separated fields: screenshot,console,network,events,replay,voice_note,video,all" default:"all"`
}

type PinStatusCmd struct {
	Ref    string `arg:"" name:"ref" help:"Disbug report URL with ?pin=<number>."`
	Status string `arg:"" name:"status" enum:"open,resolved,dismissed" help:"New pin status."`
	Note   string `help:"Optional activity-log note."`
}

type PinsCmd struct {
	Refs   []string `arg:"" name:"urls" help:"One or more Disbug report URLs with ?pin=<number>."`
	Fields string   `help:"Default fields when a URL omits the fields query parameter." default:"all"`
}

type RootFlags struct {
	Pretty  bool   `help:"Indent JSON output with 2 spaces."`
	Profile string `default:"default" env:"DISBUG_PROFILE" help:"Configuration profile to use."`
	Verbose bool   `short:"v" help:"Enable verbose logging."`
}

type SearchCmd struct {
	Query string `arg:"" name:"query" help:"Search query"`
	Scope string `help:"Search scope" enum:"sessions,pins" default:"sessions"`
	Limit int    `help:"Max results (1-50)" default:"20"`
}

type SessionCmd struct {
	Get    SessionGetCmd    `cmd:"" default:"withargs" help:"Show a cloud session summary."`
	Status SessionStatusCmd `cmd:"" help:"Update a cloud session status."`
}

type SessionGetCmd struct {
	Ref string `arg:"" name:"url" help:"Disbug report URL (e.g. https://app.disbug.io/team/projects/1/sessions/2/)"`
}

type SessionStatusCmd struct {
	Ref    string `arg:"" name:"ref" help:"Disbug session report URL."`
	Status string `arg:"" name:"status" enum:"open,resolved,dismissed" help:"New session status."`
	Note   string `help:"Optional activity-log note."`
}

type SessionsCmd struct {
	Status  string `help:"Filter by status" enum:"open,resolved,dismissed," default:""`
	Project string `help:"Filter by project slug"`
	Limit   int    `help:"Max results (1-100)" default:"50"`
	Cursor  string `help:"Pagination cursor"`
	Since   string `help:"Only include sessions newer than this duration, e.g. 30s, 15m, or 2h."`
}

type VersionCmd struct{}

type WatchCmd struct {
	CloudOnly    bool   `name:"cloud-only" help:"Watch cloud sessions only."`
	Since        string `help:"Backfill sessions newer than this duration before watching, e.g. 30s, 15m, or 2h."`
	Status       string `help:"Filter by status." enum:"open,resolved,dismissed," default:""`
	Project      string `help:"Filter by project slug."`
	Exec         string `help:"Run this shell command once per non-backfill event."`
	Format       string `help:"Output format." enum:"jsonl,text" default:"jsonl"`
	PollInterval string `help:"Polling interval." default:"30s"`
}

type WhoamiCmd struct{}