{ "id": "artifact-lineage-check", "name": "Artifact derivation lineage check", "description": "Check a supplied artifact derivation graph for parent-digest and media-type agreement, missing or cyclic ancestry, and required/forbidden ancestor or depth constraints. Inspect only supplied manifests; no artifact bytes, derivations, identities or source authenticity are verified.", "category": "workflow-assurance", "priceUsd": "0.005", "pricingStatus": "proposed-unverified", "pricing": { "unit": "one successful operation call", "proposedNominalUsd": "0.005", "sixDecimalTokenBaseUnits": "5000", "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": [ "Validate artifact parent digests and transformation media contracts", "Check required or forbidden source ancestry before accepting an agent artifact" ], "whenToUse": [ "Validate artifact parent digests and transformation media contracts", "Check required or forbidden source ancestry before accepting an agent artifact" ], "whenNotToUse": [ "Live negotiation, message delivery, queue consumption, remote pagination, artifact fetching or migration execution", "Authentication, signed provenance, authorization, schema compatibility proofs, or exactly-once guarantees", "Inferring absent versions, server state, missing history, semantic equivalence, or market uniqueness" ], "capabilities": [ "Derived/source distinction and exact digest/type checks across edges", "Transitive ancestor constraints, roots and longest chain depth on valid graphs", "Supplied declarations only; advisoryOnly=true; authorizationGranted=false; execution=false; externalRequests=0" ], "limits": { "inputBytes": 100000, "outputBytes": 400000, "jsonNodes": 12000, "depth": 20, "findings": 200, "artifacts": 128, "parentsPerArtifact": 16, "targets": 32, "ancestorsPerConstraint": 32 }, "related": [ "artifact-manifest-check", "workflow-dag-analyze" ], "errorCodes": [ "INPUT_LIMIT", "OUTPUT_LIMIT", "COMPLEXITY_LIMIT", "INVALID_NUMBER", "INVALID_UNICODE", "UNSAFE_KEY", "VERSION_LIMIT", "ITEM_LIMIT" ], "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": "ieee754-binary64", "privacy.requestBodyPersisted": false, "execution.deterministic": true, "execution.networkAccess": false, "privacy.resultBodyPersisted": false, "payment.x402": true, "payment.mpp": true, "operation.id": "artifact-lineage-check", "operation.category": "workflow-assurance", "limit.httpRequestBytes": 131072, "limit.requestBytes": 100000, "limit.responseBytes": 524288, "limit.resultBytes": 400000, "limit.jsonDepth": 20, "limit.jsonNodes": 12000, "exchange.profile": "artifact-derivation-lineage-v1", "exchange.advisoryOnly": true, "exchange.authorizationGranted": false, "exchange.liveNegotiation": false, "exchange.persistentState": false, "exchange.executesMigration": false, "exchange.deliversMessages": false, "exchange.authenticatedEvidence": false, "lineage.maxArtifacts": 128, "lineage.maxParentsPerArtifact": 16, "lineage.maxTargets": 32, "lineage.maxAncestorsPerConstraint": 32, "lineage.artifactBytesVerified": false, "lineage.derivationExecuted": false, "lineage.sourceAuthenticityVerified": false, "input.artifacts.maxItems": 128, "input.targets.maxItems": 32, "input.targets.minItems": 1 }, "unknownPolicy": "Undeclared requirements are unknown, never compatible. Matching declared facts does not establish semantic fit or input validity.", "preflight": "/preflight" }, "documentation": "/reference/tools/artifact-lineage-check.md", "serviceContract": "/reference/services/artifact-lineage-check.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/artifact-lineage-check", "mpp": "/v1/mpp/artifact-lineage-check" }, "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "type": "object", "properties": { "artifacts": { "maxItems": 128, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 100 }, "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "kind": { "type": "string", "enum": [ "source", "derived" ] }, "mediaType": { "type": "string", "minLength": 1, "maxLength": 100 }, "parents": { "maxItems": 16, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 100 }, "expectedSha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "id", "expectedSha256" ], "additionalProperties": false } }, "derivation": { "type": "object", "properties": { "operation": { "type": "string", "minLength": 1, "maxLength": 100 }, "version": { "type": "string", "minLength": 1, "maxLength": 100 }, "inputMediaTypes": { "minItems": 1, "maxItems": 16, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100 } }, "outputMediaType": { "type": "string", "minLength": 1, "maxLength": 100 } }, "required": [ "operation", "version", "inputMediaTypes", "outputMediaType" ], "additionalProperties": false } }, "required": [ "id", "sha256", "kind", "mediaType", "parents" ], "additionalProperties": false } }, "targets": { "minItems": 1, "maxItems": 32, "type": "array", "items": { "type": "object", "properties": { "artifactId": { "type": "string", "minLength": 1, "maxLength": 100 }, "expectedSha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }, "requiredAncestors": { "maxItems": 32, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100 } }, "forbiddenAncestors": { "maxItems": 32, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100 } }, "maximumDepth": { "type": "integer", "minimum": 0, "maximum": 127 } }, "required": [ "artifactId", "requiredAncestors", "forbiddenAncestors", "maximumDepth" ], "additionalProperties": false } } }, "required": [ "artifacts", "targets" ], "additionalProperties": false }, "outputSchema": { "type": "object", "required": [ "operation", "version", "result", "provenance" ], "properties": { "operation": { "const": "artifact-lineage-check", "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": "artifact-derivation-lineage-v1" }, "consistent": { "type": "boolean" }, "targets": { "maxItems": 32, "type": "array", "items": { "type": "object", "properties": { "artifactId": { "type": "string", "minLength": 1, "maxLength": 100 }, "matchesRequirements": { "type": "boolean" }, "ancestors": { "maxItems": 127, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100 } }, "rootSources": { "maxItems": 128, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100 } }, "depth": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, { "type": "null" } ] }, "completeSuppliedLineage": { "type": "boolean" } }, "required": [ "artifactId", "matchesRequirements", "ancestors", "rootSources", "depth", "completeSuppliedLineage" ], "additionalProperties": false } }, "findings": { "maxItems": 200, "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string" }, "severity": { "type": "string", "enum": [ "error", "warning" ] }, "path": { "type": "string" }, "message": { "type": "string" }, "relatedIds": { "maxItems": 8, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100 } } }, "required": [ "code", "severity", "path", "message", "relatedIds" ], "additionalProperties": false } }, "findingCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "errorCount": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "truncated": { "type": "boolean" }, "advisoryOnly": { "type": "boolean", "const": true }, "execution": { "type": "boolean", "const": false }, "authorizationGranted": { "type": "boolean", "const": false } }, "required": [ "profile", "consistent", "targets", "findings", "findingCount", "errorCount", "truncated", "advisoryOnly", "execution", "authorizationGranted" ], "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": { "artifacts": [ { "id": "source", "sha256": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", "kind": "source", "mediaType": "text/plain", "parents": [] }, { "id": "summary", "sha256": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb", "kind": "derived", "mediaType": "application/json", "parents": [ { "id": "source", "expectedSha256": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" } ], "derivation": { "operation": "extract", "version": "1", "inputMediaTypes": [ "text/plain" ], "outputMediaType": "application/json" } } ], "targets": [ { "artifactId": "summary", "expectedSha256": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb", "requiredAncestors": [ "source" ], "forbiddenAncestors": [], "maximumDepth": 2 } ] }, "exampleResponse": { "operation": "artifact-lineage-check", "version": "0.29.0", "result": { "profile": "artifact-derivation-lineage-v1", "consistent": true, "targets": [ { "artifactId": "summary", "matchesRequirements": true, "ancestors": [ "source" ], "rootSources": [ "source" ], "depth": 1, "completeSuppliedLineage": true } ], "findings": [], "findingCount": 0, "errorCount": 0, "truncated": false, "advisoryOnly": true, "execution": false, "authorizationGranted": false }, "provenance": { "inputSha256": "507af5b7f2bc18266841de2aad66dd74e0e46d7281b89d47ccc6c5e05c8c4882", "outputSha256": "f67df918a8b3a3f449b877066a50d72013446c94a2e48a1c9d6f42ee9fefd167", "deterministic": true, "externalRequests": 0 } }, "requiredHeaders": { "Content-Type": "application/json", "Idempotency-Key": "random 16–128 character operation identifier" }, "fixedExample": "/reference/examples/artifact-lineage-check.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." } }