agent

const (
	// -- Environmental Interaction (Basic) --
	ActionNavigate     ActionType = "NAVIGATE"       // Navigates to a URL.
	ActionClick        ActionType = "CLICK"          // Clicks on a UI element.
	ActionInputText    ActionType = "INPUT_TEXT"     // Types text into an input field.
	ActionSubmitForm   ActionType = "SUBMIT_FORM"    // Submits a form.
	ActionScroll       ActionType = "SCROLL"         // Scrolls the page.
	ActionWaitForAsync ActionType = "WAIT_FOR_ASYNC" // Pauses for asynchronous activity to settle.

	// -- High-Level Humanoid Actions --
	ActionHumanoidDragAndDrop ActionType = "HUMANOID_DRAG_AND_DROP" // Performs a human-like drag-and-drop.

	// -- Security Analysis Actions (Active & IAST) --
	// These actions involve injecting payloads, manipulating the environment, or analyzing the live state.
	ActionAnalyzeTaint      ActionType = "ANALYZE_TAINT"       // (IAST/Taint) Taint analysis (XSS, Injection) on the current page state.
	ActionTestRaceCondition ActionType = "TEST_RACE_CONDITION" // (Active/TimeSlip) Tests an endpoint for race conditions (TOCTOU).

	// -- Authentication & Authorization Testing --
	ActionTestATO  ActionType = "TEST_ATO"  // (Active/ATO) Account Takeover: Tests login endpoints for credential stuffing/enumeration.
	ActionTestIDOR ActionType = "TEST_IDOR" // (Active/IDOR) Insecure Direct Object Reference: Compares resource access between sessions.

	// -- Security Analysis Actions (Passive & Static) --
	// These actions analyze artifacts (HAR, DOM, Headers) already collected.
	ActionAnalyzeHeaders ActionType = "ANALYZE_HEADERS" // (Passive/Headers) Analyzes HTTP security headers from collected traffic.
	ActionAnalyzeJWT     ActionType = "ANALYZE_JWT"     // (Passive/JWT) Analyzes captured JWTs for vulnerabilities.

	// -- Codebase Interaction --
	ActionGatherCodebaseContext ActionType = "GATHER_CODEBASE_CONTEXT" // Gathers static analysis context from the agent's own codebase.

	// -- Proactive Self-Improvement --
	ActionEvolveCodebase ActionType = "EVOLVE_CODEBASE" // Initiates the self-improvement (evolution) process.

	// -- High-Level, Complex Actions --
	// Complex tasks that might be decomposed into simpler actions by the executor or the Mind itself.
	ActionExecuteLoginSequence ActionType = "EXECUTE_LOGIN_SEQUENCE" // Executes a predefined or discovered login sequence.
	ActionSignUp               ActionType = "SIGN_UP"                // Executes a sign-up or registration sequence.
	ActionExploreApplication   ActionType = "EXPLORE_APPLICATION"    // Initiates a comprehensive crawl/exploration of the application scope.
	ActionFuzzEndpoint         ActionType = "FUZZ_ENDPOINT"          // Performs fuzzing against a specific API endpoint or form inputs.
	ActionDecideNextStep       ActionType = "DECIDE_NEXT_STEP"       // Ties the scan process into the agents ability to decide, plan, react, replan or reorganize.

	// -- Mission Control --
	ActionConclude ActionType = "CONCLUDE" // Concludes the current mission.
)

const (
	StateInitializing AgentState = "INITIALIZING" // The agent is setting up its components.
	StateObserving    AgentState = "OBSERVING"    // The agent is processing new information from its environment.
	StateOrienting    AgentState = "ORIENTING"    // The agent is integrating new information and updating its world model.
	StateDeciding     AgentState = "DECIDING"     // The agent is reasoning about the next action to take.
	StateActing       AgentState = "ACTING"       // The agent has dispatched an action and is waiting for the result.
	StatePaused       AgentState = "PAUSED"       // The agent's cognitive loop is temporarily paused.
	StateCompleted    AgentState = "COMPLETED"    // The agent has successfully completed its mission.
	StateFailed       AgentState = "FAILED"       // The agent has encountered a critical, unrecoverable error.
)

const (
	MessageTypeAction      CognitiveMessageType = "ACTION"       // A message containing a new action to be executed.
	MessageTypeObservation CognitiveMessageType = "OBSERVATION"  // A message containing a new observation for the mind to process.
	MessageTypeStateChange CognitiveMessageType = "STATE_CHANGE" // A message indicating a change in the agent's state.
	MessageTypeInterrupt   CognitiveMessageType = "INTERRUPT"    // A message to interrupt the agent's current process.
)

const (
	// -- General Execution Errors --
	ErrCodeExecutionFailure  ErrorCode = "EXECUTION_FAILURE"   // A generic failure during the execution of an action.
	ErrCodeNotImplemented    ErrorCode = "NOT_IMPLEMENTED"     // The requested action or feature is not implemented.
	ErrCodeInvalidParameters ErrorCode = "INVALID_PARAMETERS"  // The parameters provided for the action were invalid.
	ErrCodeJSONMarshalFailed ErrorCode = "JSON_MARSHAL_FAILED" // Failed to marshal data to JSON.
	ErrCodeUnknownAction     ErrorCode = "UNKNOWN_ACTION_TYPE" // The action type is not recognized by any executor.
	ErrCodeFeatureDisabled   ErrorCode = "FEATURE_DISABLED"    // The requested feature is disabled in the configuration.
	ErrCodeTimeoutError      ErrorCode = "TIMEOUT_ERROR"       // An operation timed out.

	// -- Browser/DOM Errors --
	ErrCodeElementNotFound ErrorCode = "ELEMENT_NOT_FOUND" // The target DOM element could not be found.
	ErrCodeNavigationError ErrorCode = "NAVIGATION_ERROR"  // An error occurred while navigating to a URL.

	// ErrCodeHumanoidTargetNotVisible indicates that a target element was found in the DOM
	// but is not currently visible in the viewport (e.g., obscured or off-screen).
	ErrCodeHumanoidTargetNotVisible ErrorCode = "HUMANOID_TARGET_NOT_VISIBLE"

	// ErrCodeHumanoidGeometryInvalid indicates that the geometry of the target element is
	// invalid for interaction (e.g., it has zero width or height).
	ErrCodeHumanoidGeometryInvalid ErrorCode = "HUMANOID_GEOMETRY_INVALID"

	// ErrCodeHumanoidInteractionFailed is a general failure during a complex humanoid
	// interaction like a click or drag.
	ErrCodeHumanoidInteractionFailed ErrorCode = "HUMANOID_INTERACTION_FAILED"

	// -- Analysis & Security Testing Errors --
	ErrCodeAnalysisFailure ErrorCode = "ANALYSIS_FAILURE" // Failure within an analysis module.

	// -- Auth-specific errors --
	ErrCodeAuthWorkflowFailed   ErrorCode = "AUTH_WORKFLOW_FAILED"
	ErrCodeAuthCaptchaDetected  ErrorCode = "AUTH_CAPTCHA_DETECTED"
	ErrCodeAuthValidationFailed ErrorCode = "AUTH_VALIDATION_FAILED"

	// -- Evolution-specific errors --
	ErrCodeEvolutionFailure ErrorCode = "EVOLUTION_FAILURE" // An error occurred during the self-improvement/evolution process.

	// -- Internal System Errors --
	ErrCodeExecutorPanic ErrorCode = "EXECUTOR_PANIC" // An executor experienced an unrecoverable panic.
)

const (
	ObservedNetworkActivity ObservationType = "NETWORK_ACTIVITY" // An observation of network traffic (e.g., from a HAR file).
	ObservedDOMChange       ObservationType = "DOM_CHANGE"       // An observation of a change in the Document Object Model.
	ObservedConsoleMessage  ObservationType = "CONSOLE_MESSAGE"  // An observation of a browser console message.
	ObservedTaintFlow       ObservationType = "TAINT_FLOW"       // An observation of a data flow from a source to a sink (IAST).
	ObservedCodebaseContext ObservationType = "CODEBASE_CONTEXT" // An observation containing source code and dependency information.
	ObservedEvolutionResult ObservationType = "EVOLUTION_RESULT" // The outcome of a self-improvement attempt.
	ObservedVulnerability   ObservationType = "VULNERABILITY"    // A specific security vulnerability has been identified.
	ObservedSystemState     ObservationType = "SYSTEM_STATE"     // An observation about the agent's own internal state or a system error.
	ObservedAnalysisResult  ObservationType = "ANALYSIS_RESULT"  // A generic wrapper for analysis output (e.g., Headers, JWT, Race Condition results).
	ObservedAuthResult      ObservationType = "AUTH_RESULT"      // The result of an authentication or authorization test (ATO, IDOR, Login).
)