sable-sphynx 0.7.0.dev0__py3-none-any.whl

sphynx/__init__.pyi

@@ -0,0 +1,376 @@
+# Generated by tools/check_public_types.py; keep runtime imports lazy.
+# Explicit aliases expose the same objects to static editors.
+
+from .workflows import Admission as Admission
+from .workflow_contracts import AdmissionBinding as AdmissionBinding
+from ._analytical_client import AnalyticalReadError as AnalyticalReadError
+from .evals import ArtifactBinding as ArtifactBinding
+from .evals import ArtifactReference as ArtifactReference
+from .assessment_contracts import Assessment as Assessment
+from .assessment_contracts import AssessmentContractError as AssessmentContractError
+from .assessment_selection import AssessmentSelector as AssessmentSelector
+from .benchmarks import AssetRef as AssetRef
+from .workflow_async import AsyncWorkflowBackend as AsyncWorkflowBackend
+from .lifecycle import AttemptOutput as AttemptOutput
+from ._analytical_values import AuditProjectionSummary as AuditProjectionSummary
+from ._audit_client import AuditRequestError as AuditRequestError
+from .workflow_contracts import BackendDescriptor as BackendDescriptor
+from .audit_contracts import BankRelease as BankRelease
+from .audit_requests import BankReleaseDeclaration as BankReleaseDeclaration
+from .audit_requests import BankReleaseTransition as BankReleaseTransition
+from .components import BatchAlternative as BatchAlternative
+from .components import BatchConfiguration as BatchConfiguration
+from .components import BatchPlan as BatchPlan
+from .benchmarks import BenchmarkCase as BenchmarkCase
+from .benchmarks import BenchmarkContractError as BenchmarkContractError
+from .benchmarks import BenchmarkEligibility as BenchmarkEligibility
+from .benchmarks import BenchmarkRegistry as BenchmarkRegistry
+from .benchmarks import BenchmarkRelease as BenchmarkRelease
+from .analytical_views import BoardCoverage as BoardCoverage
+from .analytical_views import BoardEntry as BoardEntry
+from .analytical_views import BoardRanking as BoardRanking
+from .authoring import CallableCandidate as CallableCandidate
+from .lifecycle import CancellationToken as CancellationToken
+from .packs import CandidateCheck as CandidateCheck
+from .integration_contracts import CandidateConfiguration as CandidateConfiguration
+from .contracts import CandidateRequest as CandidateRequest
+from .contracts import CandidateResponse as CandidateResponse
+from .contracts import CandidateScore as CandidateScore
+from .contracts import CandidateSpec as CandidateSpec
+from .records import CaptureIdentity as CaptureIdentity
+from .workflow_contracts import CaseProvider as CaseProvider
+from .contracts import CaseReferences as CaseReferences
+from .assessment_contracts import CaseView as CaseView
+from .clickhouse_reader import ClickHouseReader as ClickHouseReader
+from .client import Client as Client
+from .results import Comparison as Comparison
+from .integration_contracts import ComparisonIdentity as ComparisonIdentity
+from .comparison_views import ComparisonMetric as ComparisonMetric
+from .comparison_views import ComparisonPair as ComparisonPair
+from ._analytical_values import ComparisonProjectionSummary as ComparisonProjectionSummary
+from .client import ComparisonRef as ComparisonRef
+from .comparison_views import ComparisonView as ComparisonView
+from .contracts import ContractError as ContractError
+from .contracts import CorpusVersions as CorpusVersions
+from .workflow_contracts import Criterion as Criterion
+from .workflow_contracts import Dataset as Dataset
+from .workflow_contracts import DatasetDefinition as DatasetDefinition
+from .workflow_decisions import DecisionContext as DecisionContext
+from .workflow_decisions import DecisionOutcome as DecisionOutcome
+from .workflow_decisions import DecisionPolicyError as DecisionPolicyError
+from .diagnostics import Diagnostic as Diagnostic
+from .lifecycle import DriverContext as DriverContext
+from .lifecycle import DriverDescriptor as DriverDescriptor
+from .lifecycle import DriverFailure as DriverFailure
+from .records import EVALUATION_SCHEMA_VERSION as EVALUATION_SCHEMA_VERSION
+from .records import EVIDENCE_SCHEMA_VERSION as EVIDENCE_SCHEMA_VERSION
+from .analytical_views import EvaluationBoardPage as EvaluationBoardPage
+from .evals import EvaluationContractError as EvaluationContractError
+from .evals import EvaluationDefinition as EvaluationDefinition
+from .records import EvaluationIdentity as EvaluationIdentity
+from .evaluation_protocols import EvaluationProtocol as EvaluationProtocol
+from .results import EvaluationRef as EvaluationRef
+from .evals import EvaluationRegistry as EvaluationRegistry
+from .evaluator_bindings import EvaluatorBinding as EvaluatorBinding
+from .assessment_contracts import EvaluatorContext as EvaluatorContext
+from .workflow_contracts import EvaluatorDefinition as EvaluatorDefinition
+from .records import EvidenceCapability as EvidenceCapability
+from .contracts import EvidenceGroup as EvidenceGroup
+from .assessment_contracts import EvidenceView as EvidenceView
+from .execution_capabilities import ExecutionPath as ExecutionPath
+from .packs import ExecutionPolicy as ExecutionPolicy
+from .client import Experiment as Experiment
+from .workflow_extensions import ExtensionError as ExtensionError
+from .contracts import FrozenCandidate as FrozenCandidate
+from .rerank_family_contracts import FrozenFittedState as FrozenFittedState
+from .contracts import FrozenPoolCase as FrozenPoolCase
+from .lifecycle import GradingContext as GradingContext
+from .workflows import GradingPass as GradingPass
+from .results import EvaluationRef as GradingPassRef
+from .lifecycle import GradingPolicy as GradingPolicy
+from .workflows import GradingRequestError as GradingRequestError
+from .workflow_async import GradingSnapshot as GradingSnapshot
+from .client import HostedClientError as HostedClientError
+from .hosted_workflow import HostedComparison as HostedComparison
+from .client import HostedEvaluation as HostedEvaluation
+from .client import HostedGradingPass as HostedGradingPass
+from .client import HostedReport as HostedReport
+from .client import HostedResult as HostedResult
+from .client import HostedRun as HostedRun
+from .client import HostedSubmission as HostedSubmission
+from .hosted_workflow import HostedWorkflowBackend as HostedWorkflowBackend
+from .contracts import INTERFACE_VERSION as INTERFACE_VERSION
+from .evaluator_bindings import InputRequirement as InputRequirement
+from .integrated_workflow import IntegratedBackend as IntegratedBackend
+from .integrated_rag import IntegratedCandidate as IntegratedCandidate
+from .integrated_rag import IntegratedDriver as IntegratedDriver
+from .invocation import InvocationBank as InvocationBank
+from .invocation import InvocationComparison as InvocationComparison
+from .invocation import InvocationError as InvocationError
+from .invocation import InvocationEvaluationRef as InvocationEvaluationRef
+from .invocation import InvocationEvaluationRef as InvocationGradingPassRef
+from .invocation import InvocationPack as InvocationPack
+from .invocation import InvocationRunRef as InvocationRunRef
+from .invocation import InvocationScorecard as InvocationScorecard
+from .benchmarks import LabelCase as LabelCase
+from .benchmarks import LabelLineage as LabelLineage
+from .benchmarks import LabelSetRelease as LabelSetRelease
+from .lifecycle_workflow import LifecycleBackend as LifecycleBackend
+from .lifecycle import LifecycleDriver as LifecycleDriver
+from .lifecycle import LifecycleError as LifecycleError
+from .lifecycle import LifecycleGradingRef as LifecycleGradingRef
+from .lifecycle_workflow import LifecycleProjection as LifecycleProjection
+from .lifecycle import LifecycleRunRef as LifecycleRunRef
+from ._local_eval import LocalEvaluationRef as LocalEvaluationRef
+from ._local_eval import LocalEvaluationRef as LocalGradingPassRef
+from ._local_eval import LocalRunRef as LocalRunRef
+from ._local_eval import LocalScorecard as LocalScorecard
+from .records import METRIC_DEFINITION_SCHEMA_VERSION as METRIC_DEFINITION_SCHEMA_VERSION
+from .metric_views import MetricCard as MetricCard
+from .records import MetricDefinition as MetricDefinition
+from ._analytical_values import MetricProjectionSummary as MetricProjectionSummary
+from .workflow_contracts import MetricSpec as MetricSpec
+from .metric_views import MetricSummary as MetricSummary
+from .question_robustness import ObservedSearch as ObservedSearch
+from .question_robustness import PILOT_MANIFEST_SHA256 as PILOT_MANIFEST_SHA256
+from .public_rerank import PUBLIC_POOL_SHA256 as PUBLIC_POOL_SHA256
+from .public_rerank import PUBLIC_RERANK_PACK_ID as PUBLIC_RERANK_PACK_ID
+from .packs import PackDescriptor as PackDescriptor
+from .workflow_extensions import PackagedExtension as PackagedExtension
+from .workflow_contracts import PayloadSchema as PayloadSchema
+from .workflows import PendingWorkError as PendingWorkError
+from .pipeline_workflow import PipelineBackend as PipelineBackend
+from .pipeline_workflow import PipelineCandidate as PipelineCandidate
+from .pipeline_workflow import PipelineSource as PipelineSource
+from .workflows import Plan as Plan
+from .workflow_contracts import PlanBinding as PlanBinding
+from ._pr_client import PrEvaluation as PrEvaluation
+from ._pr_client import PrEvaluationError as PrEvaluationError
+from .pr_evaluations import PrEvaluationRequest as PrEvaluationRequest
+from .pr_evaluations import PrEvaluationResult as PrEvaluationResult
+from .sable_rerank import PrivateEvaluation as PrivateEvaluation
+from .sable_rerank import PrivatePack as PrivatePack
+from .progress import ProgressView as ProgressView
+from ._analytical_values import ProjectionCoverage as ProjectionCoverage
+from .analytical_views import ProjectionEventRef as ProjectionEventRef
+from .analytical_views import ProjectionPage as ProjectionPage
+from .analytical_views import ProjectionProof as ProjectionProof
+from .analytical_views import ProjectionResult as ProjectionResult
+from .analytical_views import ProjectionRow as ProjectionRow
+from .analytical_views import ProjectionSelection as ProjectionSelection
+from .public_bundle import PublicRerankBundle as PublicRerankBundle
+from .public_rerank import PublicRerankPack as PublicRerankPack
+from .hosted_workflow import PullRequestCandidate as PullRequestCandidate
+from .question_robustness import QUESTION_ROBUSTNESS_INTERFACE as QUESTION_ROBUSTNESS_INTERFACE
+from .question_robustness import QUESTION_ROBUSTNESS_PACK_ID as QUESTION_ROBUSTNESS_PACK_ID
+from .question_robustness import QuestionRobustnessPack as QuestionRobustnessPack
+from .recorded_scores import RECORDED_SCORE_SCHEMA as RECORDED_SCORE_SCHEMA
+from .contracts import REQUEST_SCHEMA_VERSION as REQUEST_SCHEMA_VERSION
+from .contracts import RESPONSE_SCHEMA_VERSION as RESPONSE_SCHEMA_VERSION
+from .retrieval import RETRIEVAL_INTERFACE_VERSION as RETRIEVAL_INTERFACE_VERSION
+from .retrieval import RETRIEVAL_PACK_ID as RETRIEVAL_PACK_ID
+from .clickhouse_reader import ReadOnlyClickHouseConfig as ReadOnlyClickHouseConfig
+from .clickhouse_reader import ReadOnlyClickHouseError as ReadOnlyClickHouseError
+from .retrieval_candidates import RecordedHybridSignals as RecordedHybridSignals
+from .workflow_contracts import ReferenceBinding as ReferenceBinding
+from .contracts import ReferenceCandidate as ReferenceCandidate
+from .score_reliability import ReliabilityReference as ReliabilityReference
+from .workflows import Report as Report
+from .evaluator_bindings import ReportAssessment as ReportAssessment
+from .workflow_contracts import ReportProjection as ReportProjection
+from ._analytical_values import ReportProjectionSummary as ReportProjectionSummary
+from .workflow_decisions import ReportSnapshot as ReportSnapshot
+from .workflow_contracts import ResolvedBinding as ResolvedBinding
+from .evals import ResolvedInvocation as ResolvedInvocation
+from .workflows import ResolvedPlan as ResolvedPlan
+from .retrieval import RetrievalEvaluation as RetrievalEvaluation
+from .retrieval import RetrievalPack as RetrievalPack
+from .retrieval import RetrievalRun as RetrievalRun
+from .audit_requests import ReviewAdjudication as ReviewAdjudication
+from .audit_contracts import ReviewContribution as ReviewContribution
+from .audit_contracts import ReviewEvent as ReviewEvent
+from .audit_access import ReviewHistoryPage as ReviewHistoryPage
+from .audit_access import ReviewOperationReceipt as ReviewOperationReceipt
+from .benchmarks import ReviewReceipt as ReviewReceipt
+from .audit_contracts import ReviewTarget as ReviewTarget
+from .audit_access import ReviewTargetPage as ReviewTargetPage
+from .reviewer_audit import ReviewerAudit as ReviewerAudit
+from .workflows import Run as Run
+from .lifecycle import RunLimits as RunLimits
+from .lifecycle import RunPolicy as RunPolicy
+from .evidence import RunRef as RunRef
+from .sable_rerank import SABLE_PACK_ID as SABLE_PACK_ID
+from .integration_contracts import ScoreField as ScoreField
+from .integration_contracts import ScoreSemantics as ScoreSemantics
+from .results import Scorecard as Scorecard
+from .benchmarks import SliceParameters as SliceParameters
+from .stage_contracts import StageContractError as StageContractError
+from .stage_contracts import StageDefinition as StageDefinition
+from .stage_contracts import StageEvidence as StageEvidence
+from .stage_contracts import StageEvidenceBackend as StageEvidenceBackend
+from .stage_contracts import StageReplacement as StageReplacement
+from .stage_contracts import StageSelector as StageSelector
+from .sync import StorageConfig as StorageConfig
+from .workflows import Submission as Submission
+from .workflow_async import SubmissionError as SubmissionError
+from .workflow_async import SubmissionIntent as SubmissionIntent
+from .workflow_async import SubmissionSnapshot as SubmissionSnapshot
+from .workflows import Suite as Suite
+from .workflow_contracts import SuiteDefinition as SuiteDefinition
+from .sync import SyncResult as SyncResult
+from .audit_access import TargetReviewPage as TargetReviewPage
+from .integration_contracts import TrackEvaluationRef as TrackGradingPassRef
+from .workflow_decisions import Verdict as Verdict
+from .evaluation_protocols import VersionedIdentity as VersionedIdentity
+from .workflow_contracts import WorkflowBackend as WorkflowBackend
+from .workflow_contracts import WorkflowContractError as WorkflowContractError
+from .workflows import WorkflowError as WorkflowError
+from .workflow_registry import WorkflowRegistry as WorkflowRegistry
+from .workflow_registry import WorkflowRegistryError as WorkflowRegistryError
+from .workflows import WorkflowTimeoutError as WorkflowTimeoutError
+from .lifecycle import assess_lifecycle as assess_lifecycle
+from .reviewer_audit import audit_invocation_reviewer as audit_invocation_reviewer
+from .legacy_full_rag import audit_legacy_cherry_full_rag as audit_legacy_cherry_full_rag
+from .rag_diagnostics import audit_rag_judge as audit_rag_judge
+from .contracts import build_candidate_request as build_candidate_request
+from .sable_rerank import build_cherry_development_dataset as build_cherry_development_dataset
+from .customer_rerank import build_customer_development_dataset as build_customer_development_dataset
+from .customer_retrieval import build_customer_retrieval_dataset as build_customer_retrieval_dataset
+from .sable_rerank import build_exact_sable_dataset as build_exact_sable_dataset
+from .hosted_workflow import build_hosted_registry as build_hosted_registry
+from .integrated_workflow import build_integrated_registry as build_integrated_registry
+from .pipeline_workflow import build_pipeline_registry as build_pipeline_registry
+from .public_rerank import build_public_rerank_request as build_public_rerank_request
+from .question_robustness import build_question_robustness_request as build_question_robustness_request
+from .question_robustness import build_question_robustness_response as build_question_robustness_response
+from .retrieval import build_retrieval_request as build_retrieval_request
+from .evals import canonical_contract_json as canonical_contract_json
+from .contracts import canonical_json as canonical_json
+from .retrieval import capture_retrieval as capture_retrieval
+from .packs import check_candidate as check_candidate
+from .results import compare as compare
+from .full_rag import compare_full_rag as compare_full_rag
+from .full_rag import compare_full_rag_contexts as compare_full_rag_contexts
+from .invocation import compare_invocation as compare_invocation
+from .pipeline import compare_pipeline as compare_pipeline
+from .sable_rerank import compare_private_rerank as compare_private_rerank
+from .public_rerank import compare_public_rerank as compare_public_rerank
+from .question_robustness import compare_question_robustness as compare_question_robustness
+from .retrieval import compare_retrieval as compare_retrieval
+from .score_reliability import compare_score_reliability as compare_score_reliability
+from .workflow_contracts import contract_digest as contract_digest
+from .full_rag import create_full_rag_review_template as create_full_rag_review_template
+from .learned_rerank import create_learned_scorer as create_learned_scorer
+from .model_adapters import create_model_scorer as create_model_scorer
+from .question_robustness import create_query_review_template as create_query_review_template
+from .rag_diagnostics import create_rag_diagnostics_review_template as create_rag_diagnostics_review_template
+from .recorded_scores import create_recorded_scorer as create_recorded_scorer
+from .statistical_rerank import create_statistical_scorer as create_statistical_scorer
+from .workflow_decisions import decide_report as decide_report
+from .benchmarks import default_registry as default_benchmark_registry
+from .evals import default_evaluation_registry as default_evaluation_registry
+from .workflow_defaults import default_workflow_registry as default_workflow_registry
+from .evals import describe_eval as describe_eval
+from .workflow_extensions import discover_extensions as discover_extensions
+from .workflow_extensions import enable_extension as enable_extension
+from .rag_diagnostics import estimate_rag_ppi_mean as estimate_rag_ppi_mean
+from .score_reliability import evaluate_fitted_calibrator as evaluate_fitted_calibrator
+from .authoring import evaluation_suite as evaluation_suite
+from .lifecycle import execute_lifecycle as execute_lifecycle
+from .diagnostics import explain_error as explain_error
+from .catalog import get_dataset as get_dataset
+from .model_adapters import get_model_spec as get_model_spec
+from .packs import get_pack as get_pack
+from .results import grade as grade
+from .full_rag import grade_full_rag as grade_full_rag
+from .invocation import grade_invocation as grade_invocation
+from .pipeline import grade_pipeline as grade_pipeline
+from .sable_rerank import grade_private_rerank as grade_private_rerank
+from .public_rerank import grade_public_rerank as grade_public_rerank
+from .question_robustness import grade_question_robustness as grade_question_robustness
+from .rag_diagnostics import grade_rag_diagnostics as grade_rag_diagnostics
+from .retrieval import grade_retrieval as grade_retrieval
+from .score_reliability import grade_score_reliability as grade_score_reliability
+from .retrieval_recordings import import_hybrid_recordings as import_hybrid_recordings
+from .rag_diagnostics import import_rag_diagnostics_beir as import_rag_diagnostics_beir
+from .recorded_scores import import_recorded_scores as import_recorded_scores
+from .catalog import list_candidates as list_candidates
+from .catalog import list_datasets as list_datasets
+from .evals import list_evals as list_evals
+from .invocation import list_invocation_banks as list_invocation_banks
+from .metric_views import list_metric_tracks as list_metric_tracks
+from .metric_views import list_metrics as list_metrics
+from .packs import list_packs as list_packs
+from .public_rerank import list_public_pool_releases as list_public_pool_releases
+from .rag_diagnostics import list_rag_diagnostics_metrics as list_rag_diagnostics_metrics
+from .components import load_batch_manifest as load_batch_manifest
+from .rerank_family_contracts import load_fitted_state as load_fitted_state
+from .invocation import load_invocation_pack as load_invocation_pack
+from .sable_rerank import load_private_pack as load_private_pack
+from .public_rerank import load_public_pool_release as load_public_pool_release
+from .public_bundle import load_public_rerank_bundle as load_public_rerank_bundle
+from .public_rerank import load_public_rerank_pack as load_public_rerank_pack
+from .question_robustness import load_question_robustness_pack as load_question_robustness_pack
+from .rag_diagnostics import load_rag_diagnostics_dataset as load_rag_diagnostics_dataset
+from .rag_diagnostics import load_rag_diagnostics_demo as load_rag_diagnostics_demo
+from .rag_diagnostics import load_rag_diagnostics_report as load_rag_diagnostics_report
+from .score_reliability import load_reliability_reference as load_reliability_reference
+from .research_candidate import load_research_candidate as load_research_candidate
+from .retrieval import load_retrieval_pack as load_retrieval_pack
+from .research_candidate import make_research_candidate as make_research_candidate
+from .retrieval_candidates import make_retrieval_candidate as make_retrieval_candidate
+from .results import open_evaluation as open_evaluation
+from .lifecycle import open_lifecycle_run as open_lifecycle_run
+from ._local_eval import open_local_evaluation as open_local_evaluation
+from ._local_eval import open_local_run as open_local_run
+from .evidence import open_run as open_run
+from .contracts import pool_digest as pool_digest
+from .model_adapters import preflight_model as preflight_model
+from .public_bundle import prepare_public_rerank_bundle as prepare_public_rerank_bundle
+from .rag_diagnostics import rag_candidate_view as rag_candidate_view
+from .rag_diagnostics import rag_diagnostics_capabilities as rag_diagnostics_capabilities
+from .contracts import ranked_candidate_ids as ranked_candidate_ids
+from .sync import read_committed_projection as read_committed_projection
+from .pipeline_workflow import register_pipeline_backend as register_pipeline_backend
+from .rag_diagnostics import render_rag_diagnostics_report as render_rag_diagnostics_report
+from .recorded_scores import replay_rerank_scores as replay_rerank_scores
+from .results import report as report
+from .score_reliability import report_fitted_calibrator as report_fitted_calibrator
+from .full_rag import report_full_rag as report_full_rag
+from .invocation import report_invocation as report_invocation
+from .pipeline import report_pipeline as report_pipeline
+from .public_rerank import report_public_rerank as report_public_rerank
+from .question_robustness import report_question_robustness as report_question_robustness
+from .evals import resolve_eval as resolve_eval
+from .retrieval_candidates import retrieval_configuration as retrieval_configuration
+from .runner import run as run
+from .workbench import run_batch as run_batch
+from .full_rag import run_full_rag as run_full_rag
+from .integrated_rag import run_integrated as run_integrated
+from .invocation import run_invocation as run_invocation
+from .pipeline import run_pipeline as run_pipeline
+from .sable_rerank import run_private_rerank as run_private_rerank
+from .public_rerank import run_public_rerank as run_public_rerank
+from .question_robustness import run_question_robustness as run_question_robustness
+from .retrieval import run_retrieval as run_retrieval
+from .rag_diagnostics import save_rag_diagnostics_report as save_rag_diagnostics_report
+from .learned_rerank import score_learned_signals as score_learned_signals
+from .statistical_rerank import score_signals as score_signals
+from .customer_rerank import summarize_customer_rerank as summarize_customer_rerank
+from .metric_views import summarize_metrics as summarize_metrics
+from .sync import sync as sync
+from .workbench import validate_batch as validate_batch
+from .components import validate_batch_manifest as validate_batch_manifest
+from .contracts import validate_candidate_response as validate_candidate_response
+from .execution_capabilities import validate_execution_requirement as validate_execution_requirement
+from .rag_diagnostics import validate_rag_diagnostics_dataset as validate_rag_diagnostics_dataset
+from .score_reliability import validate_reliability_reference as validate_reliability_reference
+from .results import verify_evaluation as verify_evaluation
+from .lifecycle import verify_lifecycle_grading as verify_lifecycle_grading
+from .lifecycle import verify_lifecycle_run as verify_lifecycle_run
+from .retrieval import verify_retrieval_run as verify_retrieval_run
+from .evidence import verify_run as verify_run
+from .workbench_tracks import workbench_track_runners as workbench_track_runners
+
+__version__: str
+__all__: list[str]

sphynx/_analytical_client.py

@@ -0,0 +1,77 @@
+"""Selected-bank analytical reads over the existing Client transport."""
+from __future__ import annotations
+from dataclasses import replace
+from typing import TYPE_CHECKING
+from urllib.parse import quote, urlencode
+
+from ._analytical_values import identifier, require
+from .analytical_views import EvaluationBoardPage, ProjectionPage, board_cursor
+from .client import HostedClientError
+from .workflow_contracts import WorkflowContractError
+
+if TYPE_CHECKING:
+    from .client import Client
+    from .diagnostics import Diagnostic
+
+
+class AnalyticalReadError(HostedClientError):
+    """Retain the original selected request without printing its cursor."""
+    def __init__(self, cause: HostedClientError, *, bank_id: str, board_id: str,
+                 limit: int | None = None, cursor: str | None = None, entry_id: str | None = None):
+        self.bank_id, self.board_id = bank_id, board_id
+        self.limit, self.cursor, self.entry_id = limit, cursor, entry_id
+        super().__init__(cause.code, 'analytical read did not return a verified page; retain its original selectors and cursor')
+
+    @property
+    def diagnostic(self) -> Diagnostic:
+        view = super().diagnostic
+        if self.code == 'evaluation_board_snapshot_changed':
+            return replace(view, summary='The board changed while this snapshot was read.',
+                next_actions=('Explicitly request the first page for a new snapshot; keep the old cursor with its original page.',),
+                retryability='fix_required')
+        return view
+
+
+def _path(bank: str, board: str) -> str:
+    return '/v1/banks/' + quote(identifier(bank), safe='') + '/boards/' + quote(identifier(board), safe='')
+
+
+def _invalid() -> HostedClientError:
+    return HostedClientError('invalid_server_response', 'the selected analytical response could not be verified')
+
+
+def board(client: Client, bank_id: str, board_id: str, *, limit: int = 20,
+          cursor: str | None = None) -> EvaluationBoardPage:
+    path = _path(bank_id, board_id)
+    require(type(limit) is int and 1 <= limit <= 100, 'board limit must be from 1 to 100')
+    query: dict[str, object] = {'limit': limit}
+    if cursor is not None:
+        query['cursor'] = board_cursor(cursor)
+    try:
+        raw = client._request('GET', path + '?' + urlencode(query))
+        try:
+            page = EvaluationBoardPage.from_dict(raw)
+            require((page.bank_id, page.board_id, page.limit) == (bank_id, board_id, limit))
+            if cursor is not None:
+                board_cursor(cursor, snapshot=page.snapshot_digest)
+            return page
+        except (WorkflowContractError, ValueError, TypeError, KeyError, AttributeError, RecursionError, UnicodeError):
+            raise _invalid() from None
+    except HostedClientError as error:
+        raise AnalyticalReadError(error, bank_id=bank_id, board_id=board_id, limit=limit, cursor=cursor) from None
+
+
+def projection(client: Client, bank_id: str, board_id: str, entry_id: str) -> ProjectionPage:
+    path = _path(bank_id, board_id) + '/projections?' + urlencode({'entry_id': identifier(entry_id)})
+    try:
+        raw = client._request('GET', path)
+        try:
+            page = ProjectionPage.from_dict(raw)
+            require(page.bank_id == bank_id and page.selection is not None and len(page.items) == 1)
+            assert page.selection is not None
+            require((page.selection.board_id, page.selection.entry_id) == (board_id, entry_id))
+            return page
+        except (WorkflowContractError, ValueError, TypeError, KeyError, AttributeError, RecursionError, UnicodeError):
+            raise _invalid() from None
+    except HostedClientError as error:
+        raise AnalyticalReadError(error, bank_id=bank_id, board_id=board_id, entry_id=entry_id) from None