package analysis_service
Get desktop application:
View/edit binary Protocol Buffers messages
Admin-only analysis service
GetAdminStats returns overview statistics for the analysis system
message
analysis_service.proto:195(message has no fields)
message
analysis_service.proto:202int32 total_completed = 1
int32 pending_count = 2
int32 processing_count = 3
repeated leaderboard = 4
repeated contributors = 5
ListAnalyzedGames returns a paginated list of completed analysis jobs
message
analysis_service.proto:210int32 page = 1
int32 page_size = 2
message
analysis_service.proto:225repeated games = 1
int32 total = 2
RequeueAnalysis resets an analysis job back to pending for re-processing
message
analysis_service.proto:230string game_id = 1
message
analysis_service.proto:234string job_id = 1
int32 queue_position = 2
rpc ClaimJob (, )
analysis_service.proto:79ClaimJob atomically claims next available job
message
analysis_service.proto:7Request to claim next available job
string macondo_version = 1
Worker authenticates via X-Api-Key header (existing middleware)
Worker reports its version; rejected if too old
message
analysis_service.proto:13Response with job details or no_jobs flag
bool no_jobs = 1
string job_id = 2
Job details (populated if no_jobs = false)
string game_id = 3
optional config = 4
rpc FailJob (, )
analysis_service.proto:88FailJob reports a job as permanently failed due to unrecoverable data corruption
message
analysis_service.proto:67Request to report a job as permanently failed (e.g. corrupted game data)
string job_id = 1
string error_message = 2
string macondo_version = 3
message
analysis_service.proto:73bool accepted = 1
rpc Heartbeat (, )
analysis_service.proto:82Heartbeat keeps job from being reclaimed due to timeout
message
analysis_service.proto:37Heartbeat to keep job alive
string job_id = 1
int32 current_turn = 2
Optional progress info
int32 total_turns = 3
message
analysis_service.proto:45bool continue = 1
false if job was reclaimed
SubmitResult submits completed analysis
message
analysis_service.proto:50Submit completed analysis
string job_id = 1
bytes result_proto = 2
Deprecated: raw protojson bytes; use result field instead
string macondo_version = 3
optional result = 4
Typed result (v2+)
message
analysis_service.proto:60bool accepted = 1
string error = 2
Populated if accepted = false
string expected_version = 3
Populated if rejected due to version mismatch
User-facing analysis service
GetAnalysisResult gets the completed analysis result
message
analysis_service.proto:165Get analysis result
string game_id = 1
message
analysis_service.proto:169bool found = 1
bytes result_proto = 2
Deprecated: raw bytes for backward compat
optional result = 3
Typed result
optional run_info = 4
How this analysis was produced
GetAnalysisStatus gets status of an analysis job
message
analysis_service.proto:144Get status of an analysis
string game_id = 1
message
analysis_service.proto:148GetAnalysisStatusResponse.JobStatus status = 1
string job_id = 2
int32 queue_position = 3
Position in queue (0 if not pending)
string error_message = 4
If failed
int32 analysis_version = 5
0 = legacy (v1), 2 = enriched; only set when COMPLETED
GetGamesAnalysisStatus returns which of the given game IDs have completed analysis
message
analysis_service.proto:239repeated string game_ids = 1
message
analysis_service.proto:243repeated string analyzed_game_ids = 1
RequestAnalysis requests analysis for a completed game
message
analysis_service.proto:119Request analysis for a game
string game_id = 1
bool force = 2
Re-analyze even if completed (only allowed for legacy v0 results)
message
analysis_service.proto:124RequestAnalysisResponse.Status status = 1
string message = 2
Human-readable message
string job_id = 3
If successful or already requested:
Analysis job ID
int32 queue_position = 4
Position in queue (0 if processing/completed)
message
analysis_service.proto:23Analysis configuration
Used in:
int32 sim_plays_early_mid = 1
int32 sim_plies_early_mid = 2
int32 sim_stop_early_mid = 3
int32 sim_plays_early_preendgame = 4
int32 sim_plies_early_preendgame = 5
int32 sim_stop_early_preendgame = 6
bool peg_early_cutoff = 7
int32 threads = 8
message
analysis_service.proto:179AnalysisRunInfo describes the job that produced an analysis. The engine version is not repeated here: it already travels with the result itself, as GameAnalysisResult.analyzer_version.
Used in:
string analyzed_by_username = 1
Username of the volunteer whose worker ran the analysis. Empty for jobs predating worker tracking, or if the account no longer exists.
int64 completed_at_ms = 2
Unix milliseconds; 0 if unknown.
int64 duration_ms = 3
Wall-clock time the worker spent on the job (completed_at - claimed_at), in milliseconds. 0 if either timestamp is missing.
int64 queue_wait_ms = 4
Time the job sat in the queue before a worker picked it up (claimed_at - created_at), in milliseconds. 0 if either is missing.
message
analysis_service.proto:215Used in:
string job_id = 1
string game_id = 2
int64 created_at_ms = 3
Unix milliseconds
int64 completed_at_ms = 4
Unix milliseconds
string request_type = 5
string requested_by_username = 6
int64 claimed_at_ms = 7
Unix milliseconds
Used in:
NOT_FOUND = 0
No analysis job exists
PENDING = 1
Waiting in queue
PROCESSING = 2
Currently being analyzed
COMPLETED = 3
Analysis complete
FAILED = 4
Analysis failed
message
analysis_service.proto:197Used in:
string username = 1
int32 analysis_count = 2
Status of the request
Used in:
SUCCESS = 0
Analysis queued successfully
ALREADY_REQUESTED = 1
Analysis already requested/exists for this game
GAME_NOT_ENDED = 2
Game hasn't ended yet
NOT_A_PLAYER = 3
Requester is not a player in this game
RATE_LIMITED = 4
User has exceeded daily limit
INVALID_VARIANT = 5
Game variant not supported