shared

type APIKnowledgeGraph struct {
	Endpoints map[string]EndpointAnalysis `json:"endpoints"`
	Models    map[string]ModelDefinition  `json:"models"`
	Context   ProjectContext              `json:"context"`
	Version   string                      `json:"version"`
}

type AssertParams struct {
	StatusCode        *int                   `json:"status_code,omitempty"`
	StatusCodeNot     *int                   `json:"status_code_not,omitempty"`
	Headers           map[string]string      `json:"headers,omitempty"`
	HeadersNotPresent []string               `json:"headers_not_present,omitempty"`
	BodyContains      []string               `json:"body_contains,omitempty"`
	BodyNotContains   []string               `json:"body_not_contains,omitempty"`
	BodyEquals        interface{}            `json:"body_equals,omitempty"`
	BodyMatchesRegex  string                 `json:"body_matches_regex,omitempty"`
	JSONPath          map[string]interface{} `json:"json_path,omitempty"` // path -> expected value
	ResponseTimeMaxMs *int                   `json:"response_time_max_ms,omitempty"`
	ContentType       string                 `json:"content_type,omitempty"`
}

type AssertTool struct {
	// contains filtered or unexported fields
}

type AssertionResult struct {
	Passed       bool     `json:"passed"`
	TotalChecks  int      `json:"total_checks"`
	PassedChecks int      `json:"passed_checks"`
	FailedChecks int      `json:"failed_checks"`
	Failures     []string `json:"failures,omitempty"`
}

type AuthParams struct {
	// Action is required: "bearer", "basic", "oauth2", "parse_jwt", "decode_basic"
	Action string `json:"action"`

	// For "bearer": token, save_as
	Token  string `json:"token,omitempty"`
	SaveAs string `json:"save_as,omitempty"`

	// For "basic": username, password, save_as
	Username string `json:"username,omitempty"`
	Password string `json:"password,omitempty"`

	// For "oauth2": flow, token_url, client_id, client_secret, scopes, save_token_as
	Flow         string   `json:"flow,omitempty"`
	TokenURL     string   `json:"token_url,omitempty"`
	ClientID     string   `json:"client_id,omitempty"`
	ClientSecret string   `json:"client_secret,omitempty"`
	Scopes       []string `json:"scopes,omitempty"`
	SaveTokenAs  string   `json:"save_token_as,omitempty"`

	// For "parse_jwt" / "decode_basic": token
	FromBody string `json:"from_body,omitempty"`
}

type AuthTool struct {
	// contains filtered or unexported fields
}

type Baseline struct {
	Name      string            `json:"name"`
	CreatedAt time.Time         `json:"created_at"`
	Response  string            `json:"response"`
	Metadata  map[string]string `json:"metadata,omitempty"`
}

type BasicParams struct {
	// Username for authentication
	Username string `json:"username"`
	// Password for authentication
	Password string `json:"password"`
	// SaveAs is the optional variable name to save the Authorization header
	SaveAs string `json:"save_as,omitempty"`
}

type BasicTool struct {
	// contains filtered or unexported fields
}

type BearerParams struct {
	// Token is the actual token value (can use {{VAR}} for variable substitution)
	Token string `json:"token"`
	// SaveAs is the optional variable name to save the Authorization header
	SaveAs string `json:"save_as,omitempty"`
}

type BearerTool struct {
	// contains filtered or unexported fields
}

type CapturedRequest struct {
	Method    string            `json:"method"`
	Path      string            `json:"path"`
	Headers   map[string]string `json:"headers"`
	Body      string            `json:"body"`
	Timestamp time.Time         `json:"timestamp"`
}

type CompareParams struct {
	Baseline     string   `json:"baseline"`                // Baseline response ID or "last_response"
	Current      string   `json:"current,omitempty"`       // Current response or "last_response"
	IgnoreFields []string `json:"ignore_fields,omitempty"` // Fields to ignore (e.g., "timestamp")
	IgnoreOrder  bool     `json:"ignore_order,omitempty"`  // Ignore array order
	Tolerance    float64  `json:"tolerance,omitempty"`     // Numeric tolerance (0.01 = 1%)
	SaveBaseline bool     `json:"save_baseline,omitempty"` // Save current as new baseline
}

type CompareResponsesTool struct {
	// contains filtered or unexported fields
}

type ComparisonResult struct {
	Match       bool     `json:"match"`
	Differences []string `json:"differences,omitempty"`
	Summary     string   `json:"summary"`
}

type ConfirmationManager struct {
	// contains filtered or unexported fields
}

type EndpointAnalysis struct {
	Summary    string          `json:"summary"`
	Parameters []Parameter     `json:"parameters"`
	AuthType   string          `json:"auth_type"`
	Responses  []Response      `json:"responses"`
	Security   []SecurityRisks `json:"security_risks"`
}

type ExtractParams struct {
	JSONPath   string `json:"json_path,omitempty"`   // e.g., "$.data.user.id"
	Header     string `json:"header,omitempty"`      // e.g., "X-Request-Id"
	Cookie     string `json:"cookie,omitempty"`      // e.g., "session_token"
	Regex      string `json:"regex,omitempty"`       // e.g., "token=([a-z0-9]+)"
	RegexGroup int    `json:"regex_group,omitempty"` // Which capture group to use (default: 1)
	SaveAs     string `json:"save_as"`               // Variable name to save extracted value
}

type ExtractTool struct {
	// contains filtered or unexported fields
}

type FalconReadParams struct {
	// Path relative to .falcon/ — e.g. "flows/unit_get_users.yaml"
	Path string `json:"path"`
	// Format: "yaml", "json", or "raw" (default). Parsed output returned as formatted string.
	Format string `json:"format,omitempty"`
}

type FalconReadTool struct {
	// contains filtered or unexported fields
}

type FalconWriteParams struct {
	// Path relative to .falcon/ — e.g. "flows/unit_get_users.yaml"
	Path    string `json:"path"`
	Content string `json:"content"`
	// Format: "yaml", "json", or "markdown" (default). Parsed before writing.
	Format string `json:"format,omitempty"`
}

type FalconWriteTool struct {
	// contains filtered or unexported fields
}

type HTTPRequest struct {
	Method  string            `json:"method"`
	URL     string            `json:"url"`
	Headers map[string]string `json:"headers,omitempty"`
	Body    interface{}       `json:"body,omitempty"`
	Timeout int               `json:"timeout,omitempty"`
}

type HTTPResponse struct {
	StatusCode int               `json:"status_code"`
	Status     string            `json:"status"`
	Headers    map[string]string `json:"headers"`
	Body       string            `json:"body"`
	Duration   time.Duration     `json:"duration"`
}

type HTTPTool struct {
	// contains filtered or unexported fields
}

type HelperParams struct {
	// Action specifies the operation: "parse_jwt", "decode_basic"
	Action string `json:"action"`
	// Token is the token to parse or decode
	Token string `json:"token,omitempty"`
	// FromBody extracts the token from a response body field (optional)
	FromBody string `json:"from_body,omitempty"`
}

type HelperTool struct {
	// contains filtered or unexported fields
}

type Manifest struct {
	Version     int            `json:"version"`
	Description string         `json:"description"`
	Counts      map[string]int `json:"counts"`
	LastUpdated string         `json:"last_updated"`
}

type ModelDefinition struct {
	Name        string              `json:"name"`
	Fields      map[string]Variable `json:"fields"`
	Description string              `json:"description"`
}

type OAuth2Params struct {
	// Flow specifies the OAuth2 grant type: "client_credentials", "password"
	Flow string `json:"flow"`
	// TokenURL is the OAuth2 token endpoint URL
	TokenURL string `json:"token_url"`
	// ClientID is the OAuth2 client identifier
	ClientID string `json:"client_id"`
	// ClientSecret is the OAuth2 client secret
	ClientSecret string `json:"client_secret"`
	// Scopes are the requested OAuth2 scopes (optional)
	Scopes []string `json:"scopes,omitempty"`
	// Username is required for password flow
	Username string `json:"username,omitempty"`
	// Password is required for password flow
	Password string `json:"password,omitempty"`
	// AuthURL is for authorization_code flow (not supported in CLI mode)
	AuthURL string `json:"auth_url,omitempty"`
	// RedirectURL is for authorization_code flow (not supported in CLI mode)
	RedirectURL string `json:"redirect_url,omitempty"`
	// Code is for authorization_code flow (not supported in CLI mode)
	Code string `json:"code,omitempty"`
	// SaveTokenAs is the variable name to save the access token
	SaveTokenAs string `json:"save_token_as,omitempty"`
}

type OAuth2Tool struct {
	// contains filtered or unexported fields
}

type Parameter struct {
	Name        string `json:"name"`
	Type        string `json:"type"`
	Required    bool   `json:"required"`
	Description string `json:"description"`
}

type ProjectContext struct {
	Framework string `json:"framework"`
	SpecPath  string `json:"spec_path"`
	RootPath  string `json:"root_path"`
	Language  string `json:"language"`
}

type ReportWriter struct {
	FalconDir string
}

type Response struct {
	StatusCode  int    `json:"status_code"`
	Description string `json:"description"`
}

type ResponseManager struct {
	// contains filtered or unexported fields
}

type RetryParams struct {
	Tool          string `json:"tool"`
	Args          string `json:"args"`
	MaxAttempts   int    `json:"max_attempts"`
	RetryDelayMs  int    `json:"retry_delay_ms"`
	Backoff       string `json:"backoff,omitempty"` // "linear" or "exponential"
	RetryOnStatus []int  `json:"retry_on_status,omitempty"`
}

type RetryTool struct {
	// contains filtered or unexported fields
}

type SchemaParams struct {
	Schema       interface{} `json:"schema"`                  // Inline schema or file path
	SchemaURL    string      `json:"schema_url,omitempty"`    // Schema from URL
	ResponseBody string      `json:"response_body,omitempty"` // Or use last_response
}

type SchemaValidationTool struct {
	// contains filtered or unexported fields
}

type SecurityRisks struct {
	Risk        string `json:"risk"`
	Severity    string `json:"severity"`
	Description string `json:"description"`
}

type SessionLogParams struct {
	// Action: "start", "end", "list", "read"
	Action  string `json:"action"`
	Summary string `json:"summary,omitempty"` // for "end": what was accomplished
	Session string `json:"session,omitempty"` // for "read": session ID (timestamp prefix)
}

type SessionLogTool struct {
	// contains filtered or unexported fields
}

type StatusCodeRange struct {
	Min int `json:"min"`
	Max int `json:"max"`
}

type SuiteResult struct {
	Name       string            `json:"name"`
	StartTime  time.Time         `json:"start_time"`
	EndTime    time.Time         `json:"end_time"`
	Duration   time.Duration     `json:"duration"`
	TotalTests int               `json:"total_tests"`
	Passed     int               `json:"passed"`
	Failed     int               `json:"failed"`
	Tests      []SuiteTestResult `json:"tests"`
}

type SuiteTestResult struct {
	Name       string        `json:"name"`
	Passed     bool          `json:"passed"`
	Duration   time.Duration `json:"duration"`
	Error      string        `json:"error,omitempty"`
	StatusCode int           `json:"status_code,omitempty"`
}

type TestDefinition struct {
	Name       string            `json:"name"`
	Request    HTTPRequest       `json:"request"`
	Assertions *AssertParams     `json:"assertions,omitempty"`
	Extract    map[string]string `json:"extract,omitempty"` // var_name -> json_path
}

type TestExecutor struct {
	HTTPTool *HTTPTool
}

type TestExpectation struct {
	StatusCode      int                    `json:"status_code"`
	StatusCodeRange *StatusCodeRange       `json:"status_code_range,omitempty"`
	BodyContains    []string               `json:"body_contains,omitempty"`
	BodyNotContains []string               `json:"body_not_contains,omitempty"`
	HeaderContains  map[string]string      `json:"header_contains,omitempty"`
	MaxDurationMs   int                    `json:"max_duration_ms,omitempty"`
	JSONPath        map[string]interface{} `json:"json_path,omitempty"`
}

type TestResult struct {
	ScenarioID     string   `json:"scenario_id"`
	ScenarioName   string   `json:"scenario_name"`
	Category       string   `json:"category"`
	Passed         bool     `json:"passed"`
	ActualStatus   int      `json:"actual_status"`
	ExpectedStatus int      `json:"expected_status"`
	Error          string   `json:"error,omitempty"`
	DurationMs     int64    `json:"duration_ms"`
	ResponseBody   string   `json:"response_body,omitempty"`
	Logs           []string `json:"logs"`
	Severity       string   `json:"severity,omitempty"`
	OWASPRef       string   `json:"owasp_ref,omitempty"`
	Timestamp      string   `json:"timestamp"`
}

type TestScenario struct {
	ID          string            `json:"id"`
	Name        string            `json:"name"`
	Category    string            `json:"category"`
	Severity    string            `json:"severity"`
	Description string            `json:"description"`
	Method      string            `json:"method"`
	URL         string            `json:"url"`
	Headers     map[string]string `json:"headers,omitempty"`
	Body        interface{}       `json:"body,omitempty"`
	Expected    TestExpectation   `json:"expected"`
	OWASPRef    string            `json:"owasp_ref,omitempty"`
	CWERef      string            `json:"cwe_ref,omitempty"`
}

type TestSuiteParams struct {
	Name        string           `json:"name"`
	Tests       []TestDefinition `json:"tests"`
	OnFailure   string           `json:"on_failure,omitempty"`   // "stop" or "continue"
	SaveResults bool             `json:"save_results,omitempty"` // Save to .falcon/test-results/
}

type TestSuiteTool struct {
	// contains filtered or unexported fields
}

type TimeoutCallback func()

type ToolExecutor interface {
	ExecuteTool(toolName string, args string) (string, error)
}

type Variable struct {
	Type        string `json:"type"`
	Format      string `json:"format,omitempty"`
	Required    bool   `json:"required"`
	Description string `json:"description,omitempty"`
}

type VariableStore struct {
	// contains filtered or unexported fields
}

type WaitParams struct {
	DurationMs int    `json:"duration_ms"`
	Reason     string `json:"reason,omitempty"`
}

type WaitTool struct{}

type WebhookListenerParams struct {
	Action         string `json:"action"`
	Port           int    `json:"port,omitempty"`
	Path           string `json:"path,omitempty"`
	TimeoutSeconds int    `json:"timeout_seconds,omitempty"`
	ListenerID     string `json:"listener_id,omitempty"`
}

type WebhookListenerTool struct {
	// contains filtered or unexported fields
}