Spaces:
Running
Running
File size: 2,483 Bytes
a9e27c0 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 | from __future__ import annotations
"""Decide what follows one failed model candidate.
Pure: the caller supplies what the client has received and what the failed
candidate left behind, and acts on the step returned.
"""
from dataclasses import dataclass
from free_claude_code.core.stream_recovery import (
ContinuationSeed,
DeliveredPrefix,
RecoveryAction,
StreamFailureContext,
assess_recovery,
)
@dataclass(frozen=True, slots=True)
class CandidateFailure:
"""What one failed candidate left behind."""
context: StreamFailureContext | None
retryable: bool
produced_output: bool
@dataclass(frozen=True, slots=True)
class Fail:
"""Raise the candidate's failure to the client."""
@dataclass(frozen=True, slots=True)
class Handoff:
"""End the response so the client can act on its released tool calls."""
@dataclass(frozen=True, slots=True)
class Fallback:
"""Open the next candidate, continuing from ``seed`` when there is one."""
seed: ContinuationSeed | None
action: RecoveryAction
reason: str | None
type FallbackStep = Fail | Handoff | Fallback
def next_step(
failure: CandidateFailure,
*,
content_released: bool,
prefix: DeliveredPrefix | None,
seed: ContinuationSeed | None,
has_next: bool,
) -> FallbackStep:
"""Return the step after ``failure``, given the delivery so far.
``prefix`` is what the client has received; it is consulted only when the
failure carries stream evidence.
"""
action = RecoveryAction.CONTINUE if seed is not None else RecoveryAction.RESTART
reason: str | None = "no_candidate_output"
if failure.context is None:
# Without stream evidence, only a candidate that produced nothing
# leaves the delivered prefix, and so the current seed, intact.
if content_released and (failure.produced_output or seed is None):
return Fail()
else:
assessment = assess_recovery(
content_released=content_released,
prefix=prefix,
source=failure.context.source,
retryable=failure.retryable,
)
if assessment.action is RecoveryAction.STOP:
return Fail()
if assessment.action is RecoveryAction.HANDOFF:
return Handoff()
seed = assessment.seed
action = assessment.action
reason = assessment.reason
if not has_next:
return Fail()
return Fallback(seed, action, reason)
|