Skip to content

summary

summary

Job execution summary and completion types.

Contains types used across CLI, daemon, and execution layers to represent job completion state. These types are the public contract between the execution engine (baton/runner) and the rest of the system.

Canonical definitions: - JobCompletionSummary: marianne.core.models - FatalError, RateLimitExhaustedError, GracefulShutdownError: marianne.core.errors.exceptions - GroundingDecisionContext, SheetExecutionMode: defined here

Classes

GroundingDecisionContext dataclass 

GroundingDecisionContext(passed, message, confidence=1.0, should_escalate=False, recovery_guidance=None, hooks_executed=0)

Context from grounding hooks for completion mode decisions.

Encapsulates grounding results to inform decision-making about whether to retry, complete, or escalate.

Functions
from_results classmethod 
from_results(results)

Build context from grounding results list.

Source code in src/marianne/core/summary.py 
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
@classmethod
def from_results(cls, results: list[GroundingResult]) -> GroundingDecisionContext:
    """Build context from grounding results list."""
    if not results:
        return cls(passed=True, message="No grounding hooks executed", hooks_executed=0)

    passed = all(r.passed for r in results)
    confidences = [r.confidence for r in results]
    avg_confidence = sum(confidences) / len(confidences) if confidences else 1.0
    should_escalate = any(r.should_escalate for r in results)

    failed = [r for r in results if not r.passed]
    recovery_guidance = None
    if failed:
        guidance_parts = [r.recovery_guidance for r in failed if r.recovery_guidance]
        if guidance_parts:
            recovery_guidance = "; ".join(guidance_parts)

    if passed:
        message = f"All {len(results)} grounding check(s) passed"
    else:
        failures = ", ".join(f"{r.hook_name}: {r.message}" for r in failed)
        message = f"{len(failed)}/{len(results)} grounding check(s) failed: {failures}"

    return cls(
        passed=passed,
        message=message,
        confidence=avg_confidence,
        should_escalate=should_escalate,
        recovery_guidance=recovery_guidance,
        hooks_executed=len(results),
    )
disabled classmethod 
disabled()

Create context when grounding is disabled.

Source code in src/marianne/core/summary.py 
87
88
89
90
@classmethod
def disabled(cls) -> GroundingDecisionContext:
    """Create context when grounding is disabled."""
    return cls(passed=True, message="Grounding not enabled", hooks_executed=0)

SheetExecutionMode

Bases: str, Enum

Mode of sheet execution.