[{"code":"invalid_credential","category":"permission","summary":"The supplied API key or browser solve grant is invalid.","details":"The supplied API key or browser solve grant is invalid.","suggestion":"Inspect the hosted API access and limits documentation. Retry only transient failures with the same Idempotency-Key.","related_help_operation_ids":["auto-solve"]},{"code":"api_access_required","category":"permission","summary":"This scenario uses Pro features and requires a regular Pro subscription.","details":"This scenario uses Pro features and requires a regular Pro subscription.","suggestion":"Inspect the hosted API access and limits documentation. Retry only transient failures with the same Idempotency-Key.","related_help_operation_ids":["auto-solve"]},{"code":"verified_account_required","category":"permission","summary":"A verified account is required for account API keys and browser recovery.","details":"A verified account is required for account API keys and browser recovery.","suggestion":"Inspect the hosted API access and limits documentation. Retry only transient failures with the same Idempotency-Key.","related_help_operation_ids":["auto-solve"]},{"code":"pro_allowance_exhausted","category":"permission","summary":"The daily Pro allowance is exhausted.","details":"The daily Pro allowance is exhausted.","suggestion":"Inspect the hosted API access and limits documentation. Retry only transient failures with the same Idempotency-Key.","related_help_operation_ids":["auto-solve"]},{"code":"pro_allowance_unavailable","category":"internal","summary":"The Pro allowance service is unavailable.","details":"The Pro allowance service is unavailable.","suggestion":"Inspect the hosted API access and limits documentation. Retry only transient failures with the same Idempotency-Key.","related_help_operation_ids":["auto-solve"]},{"code":"concurrency_limit","category":"conflict","summary":"The hosted solver is busy.","details":"The hosted solver is busy.","suggestion":"Inspect the hosted API access and limits documentation. Retry only transient failures with the same Idempotency-Key.","related_help_operation_ids":["auto-solve"]},{"code":"idempotency_conflict","category":"conflict","summary":"The idempotency key is already bound to different input.","details":"The idempotency key is already bound to different input.","suggestion":"Inspect the hosted API access and limits documentation. Retry only transient failures with the same Idempotency-Key.","related_help_operation_ids":["auto-solve"]},{"code":"request_in_progress","category":"conflict","summary":"This request is already running.","details":"This request is already running.","suggestion":"Inspect the hosted API access and limits documentation. Retry only transient failures with the same Idempotency-Key.","related_help_operation_ids":["auto-solve"]},{"code":"completion_unknown","category":"conflict","summary":"Prior execution could not be recovered and will not be restarted.","details":"Prior execution could not be recovered and will not be restarted.","suggestion":"Inspect the hosted API access and limits documentation. Retry only transient failures with the same Idempotency-Key.","related_help_operation_ids":["auto-solve"]},{"code":"authority_unavailable","category":"internal","summary":"Authorization or settlement is unavailable.","details":"Authorization or settlement is unavailable.","suggestion":"Inspect the hosted API access and limits documentation. Retry only transient failures with the same Idempotency-Key.","related_help_operation_ids":["auto-solve"]},{"code":"execution_timeout","category":"timeout","summary":"The hosted worker reached its execution limit and was stopped.","details":"The hosted worker reached its execution limit and was stopped.","suggestion":"Inspect the hosted API access and limits documentation. Retry only transient failures with the same Idempotency-Key.","related_help_operation_ids":["auto-solve"]},{"code":"worker_failed","category":"internal","summary":"The hosted worker failed.","details":"The hosted worker failed.","suggestion":"Inspect the hosted API access and limits documentation. Retry only transient failures with the same Idempotency-Key.","related_help_operation_ids":["auto-solve"]},{"code":"scenario_limit_exceeded","category":"invalid_input","summary":"The scenario exceeds hosted compute limits.","details":"The scenario exceeds hosted compute limits.","suggestion":"Inspect the hosted API access and limits documentation. Retry only transient failures with the same Idempotency-Key.","related_help_operation_ids":["auto-solve"]},{"code":"solver_timeout","category":"timeout","summary":"The solver ran out of time before establishing feasibility.","details":"No valid starting schedule was found within the available time. This does not prove the scenario is impossible.","suggestion":"Increase the solver time limit and try again. Keep the required constraints unchanged unless you intend to edit them.","related_help_operation_ids":["solve","validate-scenario"]},{"code":"invalid_request","category":"invalid_input","summary":"The provided request or payload shape is invalid.","details":"The caller supplied malformed JSON, a missing required field, or an unexpected value shape for the requested operation.","suggestion":"Inspect the relevant input schema and local help for the targeted operation, then resend a valid request.","related_help_operation_ids":["validate-scenario","get-schema"]},{"code":"operation_not_found","category":"unsupported","summary":"The requested operation is not part of the public solver contract.","details":"The caller referenced an operation ID or affordance name that is not registered in the shared contracts graph.","suggestion":"Start from bootstrap help, then choose one of the registered top-level operations.","related_help_operation_ids":["solve","validate-scenario","get-schema"]},{"code":"schema_not_found","category":"unsupported","summary":"The requested schema ID is not registered.","details":"The caller requested a schema identifier that does not exist in the contract registry.","suggestion":"Inspect the schema lookup/help affordance and request one of the registered schema IDs.","related_help_operation_ids":["get-schema"]},{"code":"error_code_not_found","category":"unsupported","summary":"The requested public error code is not registered.","details":"The caller requested an error code identifier that does not exist in the contract registry.","suggestion":"Inspect the error-catalog help affordance and request one of the registered public error codes.","related_help_operation_ids":["inspect-errors"]},{"code":"infeasible_scenario","category":"infeasible","summary":"The scenario definition is internally inconsistent or infeasible.","details":"The solver cannot satisfy the required constraints, capacities, or session assignments for the provided scenario input.","suggestion":"Validate the scenario, inspect constraint settings, and adjust the input so a valid schedule is possible.","related_help_operation_ids":["validate-scenario","solve"]},{"code":"unsupported_constraint_type","category":"unsupported","summary":"A constraint type or similar enum-like value is not supported.","details":"The caller referenced a named domain feature that is not part of the currently supported public contract.","suggestion":"Inspect the relevant schema and contract help, then replace the unsupported value with a supported one.","related_help_operation_ids":["validate-scenario","get-schema"]},{"code":"quota_exceeded","category":"permission","summary":"An account or service compute, request, or concurrency limit is exhausted.","details":"Hosted compute uses durable account and global reservations, daily compute and request budgets, and concurrency guards. API access and browser recovery have separate account budgets.","suggestion":"Retry after the advertised reset/retry interval, reduce solve cost, or use a local/private GroupMixer surface for larger workloads.","related_help_operation_ids":["auto-solve","inspect-errors"]},{"code":"payload_too_large","category":"invalid_input","summary":"The request body exceeds the hosted public API payload limit.","details":"The hosted public API caps payload bytes before parsing to bound memory and bandwidth before admitting hosted computation.","suggestion":"Send a smaller scenario payload or use a local/private GroupMixer surface for larger workloads.","related_help_operation_ids":["auto-solve","get-schema"]},{"code":"unsupported_field","category":"unsupported","summary":"The request includes a field that is intentionally unsupported by the hosted public API.","details":"The hosted public API exposes only automatic solving and does not accept solver configuration, solver-family selection, incumbent schedules, or stop-condition controls.","suggestion":"Remove the unsupported field and let the public auto policy choose the solver configuration, or use a local/private surface for advanced control.","related_help_operation_ids":["auto-solve","get-schema"]},{"code":"internal_error","category":"internal","summary":"An unexpected internal failure occurred.","details":"The operation failed for a reason outside the normal public validation and feasibility model.","suggestion":"Capture the error details, inspect local help for the attempted operation, and retry only if the failure is known to be transient.","related_help_operation_ids":["solve","validate-scenario","inspect-result","inspect-errors"]}]