{"uid":"cap_9bKnsfPOaWvVMrkvZOhTT","slug":"csv-drift-evidence-b7bdb66f","name":"CSV Drift Evidence","description":"Deterministically compares a candidate CSV with a known-good baseline and returns compact schema, missingness, type, order, and numeric-range drift evidence. Results are decision support, not a guarantee of downstream safety.","url":"https://foundry-csv-drift-evidence-mainnet.inference-chip-index.workers.dev/v1/csv/drift","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"baselineCsv":{"type":"string","maxLength":250000,"minLength":1,"description":"Known-good CSV including one header row."},"candidateCsv":{"type":"string","maxLength":250000,"minLength":1,"description":"Candidate CSV to compare with the baseline."},"allowedNewColumns":{"type":"array","items":{"type":"string","maxLength":256,"minLength":1},"maxItems":200,"description":"New candidate columns that should not reduce the score.","uniqueItems":true},"numericRangeColumns":{"type":"array","items":{"type":"string","maxLength":256,"minLength":1},"maxItems":200,"description":"Baseline numeric columns whose observed range should be checked.","uniqueItems":true},"missingRateReviewDelta":{"type":"number","default":0.1,"maximum":1,"minimum":0,"description":"Absolute missing-rate change that is reported for review."}}},"responseSchema":{"type":"json","example":{"score":88,"product":"csv-drift-evidence","version":"1.0.0","disposition":"REVIEW","typeChanges":[],"addedColumns":["source"],"baselineRows":2,"candidateRows":2,"removedColumns":[],"reorderedColumns":false,"missingRateChanges":[{"delta":0.5,"column":"region","baseline":0,"candidate":0.5}],"evidenceFingerprint":"15a1c350fa3d73358e9e0d846942c90e31a8923cbf6f41bcb2c10030505357a3","disallowedAddedColumns":[],"numericRangeExcursions":[{"above":1,"below":0,"column":"score","baselineMaximum":0.9,"baselineMinimum":0.7}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.015","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.015/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.015","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.015","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_zGO_lyG2OIyYxGaUFucg4","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.015","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Compares a candidate CSV against a baseline CSV and returns deterministic structural drift evidence including column, type, and missing-rate changes.","exampleAgentPrompt":"Compare this week's export CSV against last week's known-good baseline and flag any structural drift — especially check the 'price' and 'quantity' columns for numeric range changes and treat 'new_promo_id' as an allowed new column.","exampleUseCases":[{"title":"Data pipeline output validation","prompt":"I have my Friday pipeline output CSV and the reference baseline from last Monday — can you check whether any columns were dropped or added, whether missing rates jumped by more than 5%, and flag if 'revenue' or 'units_sold' went outside their historical ranges?"},{"title":"ETL schema drift monitoring","prompt":"Before we load this new vendor data CSV into the warehouse, compare it against our approved baseline and tell me about any column renames, new fields, or type changes — treat 'vendor_segment' as a new column we're expecting."},{"title":"Data quality audit before ML training","prompt":"I need to check whether our training dataset this month has drifted structurally from last month's verified CSV — look for missing rate changes, dropped features, and check that 'age', 'income', and 'score' stay within their known ranges."}],"resultDescription":"Returns deterministic structural drift evidence including: lists of added, removed, or renamed columns; type changes per column; missing-rate deltas that exceed the configured review threshold; and numeric range violations for specified columns compared to the baseline.","failureModes":["Malformed or empty CSV strings cause validation errors","CSV exceeding 250,000 characters is rejected","Column names in numericRangeColumns not present in baseline return warnings or are skipped","Mismatched encodings or line endings may cause parsing failures","Extremely wide CSVs with hundreds of columns may hit item limits on allowedNewColumns or numericRangeColumns"],"whenToPreferThis":"Choose this endpoint when you need deterministic, reproducible structural drift detection between two CSV snapshots — particularly for data pipeline validation, ETL monitoring, or pre-ingestion checks. It is ideal when you want explicit, auditable evidence of schema changes rather than statistical or ML-based drift scores. Prefer it over general data profiling tools when the focus is on column-level structure, missing rates, and numeric range adherence against a known-good baseline.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:35:39.698Z","isFirstParty":false}