config

type AgentOptions struct {
	Prompt                string   `short:"p" long:"prompt" description:"Natural language task or existing file path for the agent"`
	Inputs                []string `short:"i" long:"input" description:"Target input: IP, URL, IP:port, or CIDR. Can specify multiple"`
	Skills                []string `short:"s" long:"skill" description:"Skill to apply (name or file path). Can specify multiple"`
	Tools                 []string `` /* 126-byte string literal not displayed */
	TaskFile              string   `long:"task-file" description:"File containing task description"`
	Heartbeat             int      `` /* 132-byte string literal not displayed */
	Timeout               int      `long:"timeout" config:"timeout" description:"Overall timeout in seconds" default:"3600"`
	EvalCriteria          string   `` /* 146-byte string literal not displayed */
	EvalModel             string   `long:"eval-model" config:"eval_model" description:"Model for goal evaluation (defaults to main model)"`
	EvalMaxRetries        int      `long:"eval-retries" config:"eval_retries" description:"Max goal evaluation retry rounds" default:"3"`
	ServerURL             string   `long:"server-url" config:"server_url" description:"AIScan Web server URL for AOP, remote REPL and PTY access"`
	WebURL                string   `long:"web-url" config:"web_url" description:"Deprecated alias for --server-url" hidden:"true"`
	Transport             string   `long:"transport" config:"transport" description:"Agent transport: auto, local, web, or stdio" default:"auto"`
	Resume                string   `long:"resume" description:"Resume session from a saved session file path"`
	SaveSession           bool     `` /* 135-byte string literal not displayed */
	CaptureProviderFrames bool     `` /* 145-byte string literal not displayed */
}

type AgentTransport string

type IOAClientArgs struct {
	Space     string
	MessageID string
}

type IOAOptions struct {
	IOAURL      string `long:"ioa-url" config:"url" description:"Optional independent IOA URL (defaults to <server-url>/ioa for Web agents)"`
	IOAToken    string `long:"server-token" config:"token" description:"Server access key (auto-generated if empty)"`
	IOANodeID   string `long:"node-id" description:"Existing node id for agent tools"`
	IOANodeName string `long:"node-name" config:"node_name" description:"Node name when auto-registering"`
	Space       string `long:"space" config:"space" description:"Space name" default:"default"`
	IOAJSON     bool   `long:"json" description:"Output query results in JSON format"`
}

type LLMOptions struct {
	Provider      string             `long:"provider" config:"provider" description:"LLM protocol: openai (OpenAI-compatible, default) or anthropic"`
	BaseURL       string             `long:"base-url" config:"base_url" description:"LLM API base URL (leave empty to use provider default)"`
	APIKey        string             `long:"api-key" config:"api_key" description:"LLM API key (or env: OPENAI_API_KEY, ANTHROPIC_API_KEY, AISCAN_API_KEY)"`
	Model         string             `long:"model" config:"model" description:"LLM model name"`
	MaxTokens     int                `long:"max-tokens" config:"max_tokens" description:"Maximum output tokens per LLM response"`
	ContextWindow int                `long:"context-window" config:"context_window" description:"Explicit model context window in tokens"`
	LLMProxy      string             `long:"llm-proxy" config:"proxy" description:"Proxy for LLM API requests"`
	ActiveProfile string             `no-flag:"true" config:"active_profile" description:"Active named LLM profile"`
	Providers     []LLMProviderEntry `no-flag:"true" config:"providers" description:"Configured LLM provider profiles"`
	AI            bool               `long:"ai" description:"Analyze direct scanner output with an LLM"`
}

type LLMProviderEntry struct {
	ID            string `config:"id" yaml:"id,omitempty"`
	Name          string `config:"name" yaml:"name,omitempty"`
	Provider      string `config:"provider" yaml:"provider"`
	BaseURL       string `config:"base_url" yaml:"base_url"`
	APIKey        string `config:"api_key" yaml:"api_key"`
	Model         string `config:"model" yaml:"model"`
	Proxy         string `config:"proxy" yaml:"proxy"`
	Timeout       int    `config:"timeout" yaml:"timeout"`
	Images        *bool  `config:"images" yaml:"images,omitempty"`
	MaxTokens     int    `config:"max_tokens" yaml:"max_tokens,omitempty"`
	ContextWindow int    `config:"context_window" yaml:"context_window,omitempty"`
}

type MiscOptions struct {
	ConfigFile string `short:"c" long:"config" description:"Path to config file (default: ./aiscan.yaml, <binary_dir>/aiscan.yaml)"`
	DataDir    string `long:"data-dir" config:"data_dir" description:"Data directory for cache, arsenal, history (default: <binary_dir>/.aiscan)"`
	InitConfig bool   `long:"init" description:"Generate default aiscan.yaml and exit"`
	ViewFile   string `short:"F" long:"view" description:"View a scan record JSONL file"`
	ViewFormat string `short:"o" long:"output" description:"Output format for -F: terminal (default), markdown" default:"terminal"`
	ViewOutput string `short:"f" long:"file" description:"Write -F output to file instead of stdout"`
	Debug      bool   `long:"debug" config:"debug" description:"Enable debug logging"`
	Verbose    []bool `short:"v" long:"verbose" description:"Increase verbosity (-v thinking and tool previews, -vv full tool results)"`
	Quiet      bool   `short:"q" long:"quiet" config:"quiet" description:"Quiet mode — only show final result"`
	NoColor    bool   `long:"no-color" config:"no_color" description:"Disable ANSI colors in scanner output"`
	Version    bool   `long:"version" description:"Print version and exit"`
}

type Option struct {
	LLMOptions     `group:"LLM Options" config:"llm"`
	ScannerOptions `group:"Scanner Options" config:"cyberhub"`
	AgentOptions   `group:"Agent Options" config:"agent"`
	IOAOptions     `group:"Server Options" config:"ioa"`
	ReconOptions   `group:"Recon Options" config:"recon"`
	OutputOptions  `group:"Agent Output Options" config:"output"`
	MiscOptions    `group:"Miscellaneous Options" config:"misc"`
	ScanConfig     ScanConfigOptions   `no-flag:"true" config:"scan"`
	SearchConfig   SearchConfigOptions `no-flag:"true" config:"search"`

	// Runtime-only environment settings. Business packages receive these values
	// after ResolveRuntimeConfig instead of reading the process environment.
	RenderMode         string            `no-flag:"true"`
	REPLMode           string            `no-flag:"true"`
	PlaywrightSession  string            `no-flag:"true"`
	UncoverCredentials map[string]string `no-flag:"true"`
}

type OutputCalls string

type OutputDetail string

type OutputOptions struct {
	Preset        string `config:"preset" default:"default" description:"Output preset: default, verbose, or full"`
	Reasoning     string `config:"reasoning" default:"hidden" config_optional:"true" description:"Reasoning output: hidden or full"`
	ToolCalls     string `config:"tool_calls" default:"compact" config_optional:"true" description:"Tool call output: hidden or compact"`
	ToolArguments string `config:"tool_arguments" default:"hidden" config_optional:"true" description:"Tool argument output: hidden, preview, or full"`
	ToolResults   string `config:"tool_results" default:"hidden" config_optional:"true" description:"Tool result output: hidden, preview, or full"`
	LiveStatus    *bool  `config:"live_status" default:"true" config_optional:"true" description:"Show the transient thinking/tooling/talking status"`
	Usage         *bool  `config:"usage" default:"true" config_optional:"true" description:"Show token and context usage in the live status"`
}

type OutputPolicy struct {
	Preset        OutputPreset
	Reasoning     OutputDetail
	ToolCalls     OutputCalls
	ToolArguments OutputDetail
	ToolResults   OutputDetail
	LiveStatus    bool
	Usage         bool
	Custom        bool
}

type OutputPreset string

type ReconOptions struct {
	FofaEmail    string `long:"fofa-email" config:"fofa_email" hidden:"true"`
	FofaKey      string `long:"fofa-key" config:"fofa_key" hidden:"true"`
	HunterToken  string `long:"hunter-token" config:"hunter_token" hidden:"true"`
	HunterAPIKey string `long:"hunter-api-key" config:"hunter_api_key" hidden:"true"`
	TavilyKey    string `long:"tavily-key" config:"tavily_key" hidden:"true"`
	ReconProxy   string `long:"recon-proxy" config:"proxy" hidden:"true"`
	ReconLimit   *int   `long:"recon-limit" config:"limit" hidden:"true"`
}

type RunMode string

type ScanConfigOptions struct {
	Verify string `config:"verify"`
}

type ScannerCommands struct {
	Scan    struct{} `command:"scan" description:"Run the scan pipeline"`
	Gogo    struct{} `command:"gogo" description:"Run gogo scanner"`
	Spray   struct{} `command:"spray" description:"Run spray scanner"`
	Katana  struct{} `command:"katana" description:"Run katana web crawler"`
	Zombie  struct{} `command:"zombie" description:"Run zombie weakpass scanner"`
	Neutron struct{} `command:"neutron" description:"Run neutron POC scanner"`
	Proton  struct{} `command:"proton" description:"Run proton sensitive info scanner"`
	Passive struct{} `command:"passive" description:"Run passive cyberspace recon"`
}

type ScannerOptions struct {
	CyberhubURL  string `long:"cyberhub-url" config:"url" description:"Cyberhub server URL for loading fingers/templates"`
	CyberhubKey  string `long:"cyberhub-key" config:"key" description:"Cyberhub API key"`
	CyberhubMode string `long:"cyberhub-mode" config:"mode" description:"Cyberhub resource mode: merge or override"`
	Proxy        string `` /* 151-byte string literal not displayed */
}

type SearchConfigOptions struct {
	TavilyKeys string `config:"tavily_keys" description:"Tavily API keys (comma-separated; empty falls back to DuckDuckGo)"`
}