Skip to content

SignalExploitability

Source code in docs_src/capo_continuum/types/signal_exploitability.py
class SignalExploitability(TypedDict, closed=True):
    verdict: NotRequired[
        "capo_continuum.types.exploitability_verdict.ExploitabilityVerdict"
    ]
    """Validation's verdict. `UNCERTAIN` covers a run that was inconclusive — out of budget, an ambiguous failure, or no decisive layer reached — and is never a refutation."""
    reached_crown_jewels: NotRequired["bool"]
    """Whether validation reached the high-value sink the attack path posited. A Boolean rather than an enum: the sink was either reached or it was not, and how far the walk got when it was not is already carried, with more precision, by `highestLayerReached`. An unknown is the absent member."""
    highest_layer_reached: NotRequired["int"]
    """The highest impact layer validation reached, 1-5, as a measure of how far the attack path was walked."""
    confidence_tier: NotRequired[
        "capo_continuum.types.validation_confidence_tier.ValidationConfidenceTier"
    ]
    """How strong the evidence behind the verdict is."""
    scriptable: NotRequired["bool"]
    """Whether the proven exploit is automatable rather than one-off. A Boolean for the same reason as `SignalPrecondition.value`: validation records a bool, and an unknown is the absent member."""
    source_validation_artifact_id: NotRequired[
        "capo_continuum.types.issue_artifact_id.IssueArtifactId"
    ]
    """The VALIDATION_EVIDENCE artifact on this same issue holding the proof this verdict summarizes. Fetch it with GetCodeIssueArtifact for the full reasoning chain and exploit artifact."""

confidence_tier instance-attribute

confidence_tier: NotRequired[ValidationConfidenceTier]

How strong the evidence behind the verdict is.

highest_layer_reached instance-attribute

highest_layer_reached: NotRequired[int]

The highest impact layer validation reached, 1-5, as a measure of how far the attack path was walked.

reached_crown_jewels instance-attribute

reached_crown_jewels: NotRequired[bool]

Whether validation reached the high-value sink the attack path posited. A Boolean rather than an enum: the sink was either reached or it was not, and how far the walk got when it was not is already carried, with more precision, by highestLayerReached. An unknown is the absent member.

scriptable instance-attribute

scriptable: NotRequired[bool]

Whether the proven exploit is automatable rather than one-off. A Boolean for the same reason as SignalPrecondition.value: validation records a bool, and an unknown is the absent member.

source_validation_artifact_id instance-attribute

source_validation_artifact_id: NotRequired[IssueArtifactId]

The VALIDATION_EVIDENCE artifact on this same issue holding the proof this verdict summarizes. Fetch it with GetCodeIssueArtifact for the full reasoning chain and exploit artifact.

verdict instance-attribute

verdict: NotRequired[ExploitabilityVerdict]

Validation's verdict. UNCERTAIN covers a run that was inconclusive — out of budget, an ambiguous failure, or no decisive layer reached — and is never a refutation.