{ "id": "decision-scenarios-analyze", "name": "Exact finite-scenario decision tradeoffs", "description": "Compare caller-defined alternatives using a complete loss matrix: all expected-loss, worst-loss and minimax-regret optima, scenario Pareto dominance and perfect-information value. Optional explicit positive relative probabilities; no inferred likelihoods or universal recommendation.", "category": "workflow-assurance", "priceUsd": "0.006", "pricingStatus": "proposed-unverified", "pricing": { "unit": "one successful operation call", "proposedNominalUsd": "0.006", "sixDecimalTokenBaseUnits": "6000", "subscription": false, "includesPayerWalletOrNetworkFees": false, "liveQuoteVerified": false, "condition": "Actual SDK challenge is authoritative only within the caller's explicit authorization; configured six-decimal token peg is an operator assertion, not a conversion guarantee." }, "intents": [ "Compare decision alternatives under supplied uncertain scenarios", "Compute exact minimax regret, worst-case loss and Pareto-dominated options", "Calculate expected-loss choices and perfect-information value from explicit scenario weights" ], "whenToUse": [ "Caller supplies complete nonnegative losses in one unit for every alternative and scenario", "Use null probabilityWeights when no probability model is justified" ], "whenNotToUse": [ "Forecasting, eliciting utilities or probabilities, validating scenario completeness, continuous or randomized policies", "Weighted rubric aggregation with missing observations or incompatible units", "Investment advice, high-impact decisions about people, or validating the truth of caller assumptions" ], "capabilities": [ "All tied minimizers retained with exact decimal and rational arithmetic", "Strict Pareto dominance requires no worse loss everywhere and strictly lower loss somewhere; identical alternatives remain nondominated", "Expected values are absent unless strictly positive relative probability weights are supplied for every scenario", "Perfect-information value assumes cost-free advance revelation of the supplied scenario and is not the value of a real experiment", "Exact bounded supplied-data arithmetic; no network, clock, randomness or external action" ], "related": [ "rubric-score-aggregate", "inventory-scenarios-optimize" ], "limits": { "inputBytes": 48000, "outputBytes": 192000, "jsonNodes": 8000, "depth": 12, "alternatives": 24, "scenarios": 24, "matrixCells": 576, "maximumDominanceCellComparisons": 27648, "decimalIntegerDigits": 12, "decimalFractionDigits": 6, "probabilityWeightDigits": 9 }, "errorCodes": [ "INPUT_LIMIT", "OUTPUT_LIMIT", "COMPLEXITY_LIMIT", "INVALID_JSON", "INVALID_NUMBER", "INVALID_UNICODE", "UNSAFE_KEY", "INVALID_INPUT", "DUPLICATE_ID", "MATRIX_SHAPE", "WEIGHT_SHAPE" ], "requirementsProfile": { "format": "declared-requirements-v1", "facts": { "execution.suppliedCode": false, "execution.remoteMutation": false, "execution.llmInference": false, "execution.paidMcp": false, "verification.semanticTruth": false, "verification.sourceAuthenticity": false, "verification.liveVulnerabilities": false, "numbers.arbitraryPrecisionJson": false, "numbers.model": "bounded-exact-decimal-strings-and-integer-quantities", "privacy.requestBodyPersisted": false, "execution.deterministic": true, "execution.networkAccess": false, "privacy.resultBodyPersisted": false, "payment.x402": true, "payment.mpp": true, "operation.id": "decision-scenarios-analyze", "operation.category": "workflow-assurance", "limit.httpRequestBytes": 131072, "limit.requestBytes": 48000, "limit.responseBytes": 524288, "limit.resultBytes": 192000, "limit.jsonDepth": 12, "limit.jsonNodes": 8000, "decision.exactSuppliedDataArithmetic": true, "decision.assumptionsVerified": false, "decision.externalAction": false, "decision.forecastsGenerated": false, "decision.realWorldOptimalityGuaranteed": false, "decision.maxDecimalIntegerDigits": 12, "decision.maxDecimalFractionDigits": 6, "decision.profile": "finite-scenario-loss-analysis-v1", "decision.maxAlternatives": 24, "decision.maxScenarios": 24, "decision.allExactTies": true, "decision.inferredProbabilities": false, "decision.universalRecommendation": false, "decision.completeSuppliedParetoRelations": true, "decision.perfectInformationConditional": true, "input.alternativeIds.maxItems": 24, "input.alternativeIds.minItems": 1, "input.scenarioIds.maxItems": 24, "input.scenarioIds.minItems": 1, "input.losses.maxItems": 24, "input.losses.minItems": 1, "input.lossUnit.maxLength": 64, "input.lossUnit.minLength": 1 }, "unknownPolicy": "Undeclared requirements are unknown, never compatible. Matching declared facts does not establish semantic fit or input validity.", "preflight": "/preflight" }, "documentation": "/reference/tools/decision-scenarios-analyze.md", "serviceContract": "/reference/services/decision-scenarios-analyze.json", "errors": [ { "status": 400, "meaning": "Malformed JSON, missing/invalid idempotency key, or payment identifier mismatch", "retry": "Correct the request before payment" }, { "status": 402, "meaning": "Payment challenge or rejected payment", "retry": "Use official protocol SDK; inspect payment outcome before another payment" }, { "status": 409, "meaning": "Idempotency conflict, duplicate proof, or PAYMENT_UNCERTAIN", "retry": "Keep original key, body, and proof; reconcile uncertainty with operator; never blindly repay" }, { "status": 413, "meaning": "Input or generated output too large", "retry": "Reduce input; no payment attempted for validation failure" }, { "status": 415, "meaning": "Unsupported media type or compression", "retry": "Send uncompressed application/json" }, { "status": 422, "meaning": "Schema or service-specific semantic validation failure", "retry": "Correct input using returned error code; no payment attempted" }, { "status": 429, "meaning": "Request/payment-attempt rate exceeded", "retry": "Wait for rate limit window; preserve existing payment identity" }, { "status": 503, "meaning": "Payment configuration/provider/state unavailable, or live DNS preparation failed before settlement", "retry": "Check readiness; DNS preparation failures may retry the identical key/body/credential only; uncertainty requires reconciliation" } ], "numericPrecision": "JavaScript IEEE-754 numbers; use strings for large integer IDs/exact decimals where the schema accepts strings. No lossless numeric parsing.", "paymentWorkflow": { "discoveryOnly": false, "supportedProtocols": [ "x402", "mpp" ], "x402": { "credentialHeader": "PAYMENT-SIGNATURE", "challengeHeader": "PAYMENT-REQUIRED", "receiptHeader": "PAYMENT-RESPONSE", "version": 2, "scheme": "exact", "paymentIdentifier": "payment-identifier extension MUST equal the HTTP Idempotency-Key", "sdk": "@x402/core with @x402/evm" }, "mpp": { "supported": true, "credentialHeader": "Authorization", "challengeHeader": "WWW-Authenticate", "receiptHeader": "Payment-Receipt", "method": "tempo", "intent": "charge", "sdk": "mppx", "tokenDecimals": 6 }, "steps": [ "Check configured readiness and the exact service schema", "Generate a fresh random Idempotency-Key for this operation; never use a discovery probe fixture for purchases", "Send valid input without a credential to obtain the official protocol challenge", "Use the official SDK and authorized wallet to fulfill the challenge", "Retry only with identical key, body, protocol and credential", "On PAYMENT_UNCERTAIN stop and request operator reconciliation; never blindly pay again" ], "versionedRetries": "Request fingerprint includes service release version. Retries across a version upgrade can conflict; coordinate upgrades outside the 24-hour replay window and reconcile pending attempts.", "docs": "/llms.txt" }, "method": "POST", "paths": { "x402": "/v1/x402/decision-scenarios-analyze", "mpp": "/v1/mpp/decision-scenarios-analyze" }, "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "alternativeIds": { "minItems": 1, "maxItems": 24, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 64 } }, "scenarioIds": { "minItems": 1, "maxItems": 24, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 64 } }, "losses": { "minItems": 1, "maxItems": 24, "type": "array", "items": { "minItems": 1, "maxItems": 24, "type": "array", "items": { "type": "string", "pattern": "^(?:0|[1-9][0-9]{0,11})(?:\\.[0-9]{1,6})?$" } } }, "probabilityWeights": { "anyOf": [ { "minItems": 1, "maxItems": 24, "type": "array", "items": { "type": "string", "pattern": "^[1-9][0-9]{0,8}$" } }, { "type": "null" } ] }, "lossUnit": { "type": "string", "minLength": 1, "maxLength": 64 } }, "required": [ "alternativeIds", "scenarioIds", "losses", "probabilityWeights", "lossUnit" ], "additionalProperties": false }, "outputSchema": { "type": "object", "required": [ "operation", "version", "result", "provenance" ], "properties": { "operation": { "const": "decision-scenarios-analyze", "type": "string" }, "version": { "const": "0.29.0", "type": "string" }, "result": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "profile": { "type": "string", "const": "finite-scenario-loss-analysis-v1" }, "externalRequests": { "type": "number", "const": 0 }, "execution": { "type": "boolean", "const": false }, "assumptionsVerified": { "type": "boolean", "const": false }, "lossUnit": { "type": "string", "minLength": 1, "maxLength": 64 }, "scenarioIds": { "minItems": 1, "maxItems": 24, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 64 } }, "probabilityModel": { "type": "string", "enum": [ "none-supplied", "normalized-positive-relative-weights" ] }, "scenarios": { "minItems": 1, "maxItems": 24, "type": "array", "items": { "type": "object", "properties": { "scenarioId": { "type": "string", "minLength": 1, "maxLength": 64 }, "probability": { "anyOf": [ { "type": "object", "properties": { "numerator": { "type": "string", "pattern": "^(?:0|[1-9][0-9]*)$" }, "denominator": { "type": "string", "pattern": "^[1-9][0-9]*$" } }, "required": [ "numerator", "denominator" ], "additionalProperties": false }, { "type": "null" } ] }, "bestLoss": { "type": "object", "properties": { "numerator": { "type": "string", "pattern": "^(?:0|[1-9][0-9]*)$" }, "denominator": { "type": "string", "pattern": "^[1-9][0-9]*$" } }, "required": [ "numerator", "denominator" ], "additionalProperties": false }, "bestAlternativeIds": { "minItems": 1, "maxItems": 24, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 64 } } }, "required": [ "scenarioId", "probability", "bestLoss", "bestAlternativeIds" ], "additionalProperties": false } }, "alternatives": { "minItems": 1, "maxItems": 24, "type": "array", "items": { "type": "object", "properties": { "alternativeId": { "type": "string", "minLength": 1, "maxLength": 64 }, "expectedLoss": { "anyOf": [ { "type": "object", "properties": { "numerator": { "type": "string", "pattern": "^(?:0|[1-9][0-9]*)$" }, "denominator": { "type": "string", "pattern": "^[1-9][0-9]*$" } }, "required": [ "numerator", "denominator" ], "additionalProperties": false }, { "type": "null" } ] }, "worstLoss": { "type": "object", "properties": { "numerator": { "type": "string", "pattern": "^(?:0|[1-9][0-9]*)$" }, "denominator": { "type": "string", "pattern": "^[1-9][0-9]*$" } }, "required": [ "numerator", "denominator" ], "additionalProperties": false }, "maximumRegret": { "type": "object", "properties": { "numerator": { "type": "string", "pattern": "^(?:0|[1-9][0-9]*)$" }, "denominator": { "type": "string", "pattern": "^[1-9][0-9]*$" } }, "required": [ "numerator", "denominator" ], "additionalProperties": false }, "regrets": { "minItems": 1, "maxItems": 24, "type": "array", "items": { "type": "object", "properties": { "numerator": { "type": "string", "pattern": "^(?:0|[1-9][0-9]*)$" }, "denominator": { "type": "string", "pattern": "^[1-9][0-9]*$" } }, "required": [ "numerator", "denominator" ], "additionalProperties": false } }, "dominatedBy": { "maxItems": 23, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 64 } } }, "required": [ "alternativeId", "expectedLoss", "worstLoss", "maximumRegret", "regrets", "dominatedBy" ], "additionalProperties": false } }, "criteria": { "type": "object", "properties": { "expectedLoss": { "anyOf": [ { "type": "object", "properties": { "minimum": { "type": "object", "properties": { "numerator": { "type": "string", "pattern": "^(?:0|[1-9][0-9]*)$" }, "denominator": { "type": "string", "pattern": "^[1-9][0-9]*$" } }, "required": [ "numerator", "denominator" ], "additionalProperties": false }, "alternativeIds": { "minItems": 1, "maxItems": 24, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 64 } } }, "required": [ "minimum", "alternativeIds" ], "additionalProperties": false }, { "type": "null" } ] }, "worstLoss": { "type": "object", "properties": { "minimum": { "type": "object", "properties": { "numerator": { "type": "string", "pattern": "^(?:0|[1-9][0-9]*)$" }, "denominator": { "type": "string", "pattern": "^[1-9][0-9]*$" } }, "required": [ "numerator", "denominator" ], "additionalProperties": false }, "alternativeIds": { "minItems": 1, "maxItems": 24, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 64 } } }, "required": [ "minimum", "alternativeIds" ], "additionalProperties": false }, "maximumRegret": { "type": "object", "properties": { "minimum": { "type": "object", "properties": { "numerator": { "type": "string", "pattern": "^(?:0|[1-9][0-9]*)$" }, "denominator": { "type": "string", "pattern": "^[1-9][0-9]*$" } }, "required": [ "numerator", "denominator" ], "additionalProperties": false }, "alternativeIds": { "minItems": 1, "maxItems": 24, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 64 } } }, "required": [ "minimum", "alternativeIds" ], "additionalProperties": false } }, "required": [ "expectedLoss", "worstLoss", "maximumRegret" ], "additionalProperties": false }, "paretoAlternativeIds": { "minItems": 1, "maxItems": 24, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 64 } }, "perfectInformation": { "anyOf": [ { "type": "object", "properties": { "expectedBestScenarioLoss": { "type": "object", "properties": { "numerator": { "type": "string", "pattern": "^(?:0|[1-9][0-9]*)$" }, "denominator": { "type": "string", "pattern": "^[1-9][0-9]*$" } }, "required": [ "numerator", "denominator" ], "additionalProperties": false }, "expectedValue": { "type": "object", "properties": { "numerator": { "type": "string", "pattern": "^(?:0|[1-9][0-9]*)$" }, "denominator": { "type": "string", "pattern": "^[1-9][0-9]*$" } }, "required": [ "numerator", "denominator" ], "additionalProperties": false } }, "required": [ "expectedBestScenarioLoss", "expectedValue" ], "additionalProperties": false }, { "type": "null" } ] }, "tiePolicy": { "type": "string", "const": "return-all-exact-ties-in-UTF-16-ID-order" } }, "required": [ "profile", "externalRequests", "execution", "assumptionsVerified", "lossUnit", "scenarioIds", "probabilityModel", "scenarios", "alternatives", "criteria", "paretoAlternativeIds", "perfectInformation", "tiePolicy" ], "additionalProperties": false }, "provenance": { "type": "object", "required": [ "inputSha256", "outputSha256", "deterministic", "externalRequests" ], "properties": { "inputSha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "outputSha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "deterministic": { "const": true }, "externalRequests": { "const": 0 } } } }, "additionalProperties": false }, "exampleInput": { "alternativeIds": [ "small-cache", "balanced-cache", "large-cache" ], "scenarioIds": [ "light-load", "heavy-load" ], "losses": [ [ "2", "12" ], [ "5", "6" ], [ "9", "3" ] ], "probabilityWeights": [ "3", "1" ], "lossUnit": "caller-defined operating loss units" }, "exampleResponse": { "operation": "decision-scenarios-analyze", "version": "0.29.0", "result": { "profile": "finite-scenario-loss-analysis-v1", "externalRequests": 0, "execution": false, "assumptionsVerified": false, "lossUnit": "caller-defined operating loss units", "scenarioIds": [ "heavy-load", "light-load" ], "probabilityModel": "normalized-positive-relative-weights", "scenarios": [ { "scenarioId": "heavy-load", "probability": { "numerator": "1", "denominator": "4" }, "bestLoss": { "numerator": "3", "denominator": "1" }, "bestAlternativeIds": [ "large-cache" ] }, { "scenarioId": "light-load", "probability": { "numerator": "3", "denominator": "4" }, "bestLoss": { "numerator": "2", "denominator": "1" }, "bestAlternativeIds": [ "small-cache" ] } ], "alternatives": [ { "alternativeId": "balanced-cache", "expectedLoss": { "numerator": "21", "denominator": "4" }, "worstLoss": { "numerator": "6", "denominator": "1" }, "maximumRegret": { "numerator": "3", "denominator": "1" }, "regrets": [ { "numerator": "3", "denominator": "1" }, { "numerator": "3", "denominator": "1" } ], "dominatedBy": [] }, { "alternativeId": "large-cache", "expectedLoss": { "numerator": "15", "denominator": "2" }, "worstLoss": { "numerator": "9", "denominator": "1" }, "maximumRegret": { "numerator": "7", "denominator": "1" }, "regrets": [ { "numerator": "0", "denominator": "1" }, { "numerator": "7", "denominator": "1" } ], "dominatedBy": [] }, { "alternativeId": "small-cache", "expectedLoss": { "numerator": "9", "denominator": "2" }, "worstLoss": { "numerator": "12", "denominator": "1" }, "maximumRegret": { "numerator": "9", "denominator": "1" }, "regrets": [ { "numerator": "9", "denominator": "1" }, { "numerator": "0", "denominator": "1" } ], "dominatedBy": [] } ], "criteria": { "expectedLoss": { "minimum": { "numerator": "9", "denominator": "2" }, "alternativeIds": [ "small-cache" ] }, "worstLoss": { "minimum": { "numerator": "6", "denominator": "1" }, "alternativeIds": [ "balanced-cache" ] }, "maximumRegret": { "minimum": { "numerator": "3", "denominator": "1" }, "alternativeIds": [ "balanced-cache" ] } }, "paretoAlternativeIds": [ "balanced-cache", "large-cache", "small-cache" ], "perfectInformation": { "expectedBestScenarioLoss": { "numerator": "9", "denominator": "4" }, "expectedValue": { "numerator": "9", "denominator": "4" } }, "tiePolicy": "return-all-exact-ties-in-UTF-16-ID-order" }, "provenance": { "inputSha256": "6503438bf50595b06913f93b1bcf8848af7f8a5603bdaba4569da2df1f5e00e1", "outputSha256": "7da7e3fd918490552b1a161ace8b7bc4f28243452db8962ae66114ab202853cb", "deterministic": true, "externalRequests": 0 } }, "requiredHeaders": { "Content-Type": "application/json", "Idempotency-Key": "random 16–128 character operation identifier" }, "fixedExample": "/reference/examples/decision-scenarios-analyze.json", "execution": { "deterministic": true, "externalRequests": 0, "maxExternalRequests": 0, "resultSnapshotPersisted": false, "fixedExampleIsIllustrativeSnapshot": false, "requiresPayment": true, "supportsMcpExecution": false }, "releaseSnapshot": { "format": "static-release-reference-v1", "sourceVersion": "0.29.0", "sourceRegistrySha256": "a2b5ec09bf6c38b9d2879d746a4fded374f5928b445377b0270ef6aa8e6cac65", "generatedAt": "2026-10-06T15:38:00Z", "releaseAcceptance": "not-verified-by-generator", "runtimeReadiness": "not-evaluated", "livePaymentsVerified": false, "indexingVerified": false, "apiOrigin": null, "notice": "Build-time release reference. Runtime readiness, deployment, payment settlement and external indexing are not evaluated here. Prices are proposed; this file cannot authorize execution or payment." } }