{"id":"csv-dialect","title":"Detect a CSV file's delimiter, quote, header row and broken header names","description":"Detects the delimiter (comma, semicolon, tab, pipe), quote character, line terminator, BOM, header row offset (preamble lines above the header) and whether a header exists in CSV text, parsed per RFC 4180 so quoted delimiters and CRLF inside quoted fields are handled. Returns every candidate dialect with its score, each ragged row with its physical line, and header repairs (empty, duplicate or BOM-polluted names, with the deterministic replacement). Reports `unknown` when two dialects fit equally well or the file has a single column, instead of guessing. For agents about to parse an unfamiliar export. It does not coerce types or fix data rows; use csv-roundtrip for type and spreadsheet hazards.","roi":"Wrong-delimiter parses silently produce one wide column or shifted fields. 200 KB per $0.005 call, no guesses when ambiguous.","audience":"developer","package":"data-contract-kit","channels":["x402","mcp"],"endpoint":{"method":"POST","url":"https://agents.writerslogic.com/api/v1/csv-dialect","path":"/api/v1/csv-dialect","contentType":"application/json"},"price":{"amount":"0.005","currency":"USDC","network":"base","perCall":true,"failedCallsCharged":false},"inputSchema":{"type":"object","additionalProperties":false,"required":["text"],"properties":{"text":{"type":"string","maxLength":200000,"description":"CSV text, up to 200000 characters. Detection samples the first 50000; structure checks cover all of it."}}},"resultSchema":{"type":"object","properties":{"status":{"type":"string","enum":["pass","fail","unknown","unsupported"],"description":"pass: every rule held. fail: a rule was violated (see witnesses). unknown: the input lacks the evidence to decide. unsupported: outside what this engine covers. Missing evidence is never a pass."},"dialect":{"anyOf":[{"type":"object","properties":{"delimiter":{"type":"string"},"quote":{"type":"string"},"escape":{"type":"string","description":"doubled-quote (RFC 4180)."},"lineTerminator":{"type":"string","enum":["CRLF","LF","CR","mixed","none"]},"bom":{"type":"boolean"},"endsWithNewline":{"type":"boolean"}}},{"type":"null"}]},"candidates":{"type":"array","items":{"type":"object","properties":{"delimiter":{"type":"string"},"quote":{"type":"string"},"rows":{"type":"integer"},"fieldCount":{"type":"integer"},"consistentRows":{"type":"integer"},"consistency":{"type":"number"},"score":{"type":"number"}}}},"columns":{"anyOf":[{"type":"integer"},{"type":"null"}]},"preambleRows":{"anyOf":[{"type":"integer","description":"Rows above the header that do not have the modal field count (titles, notes)."},{"type":"null"}]},"headerRow":{"anyOf":[{"type":"integer","description":"0-based row index of the header among parsed rows."},{"type":"null"}]},"headerLine":{"anyOf":[{"type":"integer","description":"1-based physical line of the header."},{"type":"null"}]},"hasHeader":{"type":"string","enum":["yes","no","unknown"]},"header":{"anyOf":[{"type":"object","properties":{"names":{"type":"array","items":{"type":"string"}},"repaired":{"type":"array","items":{"type":"string"}},"repairs":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer"},"from":{"type":"string"},"to":{"type":"string"},"reason":{"type":"string"}}}}}},{"type":"null"}]},"raggedRows":{"type":"array","items":{"type":"object","properties":{"row":{"type":"integer"},"line":{"type":"integer"},"expected":{"type":"integer"},"actual":{"type":"integer"}}}},"ambiguity":{"anyOf":[{"type":"string"},{"type":"null"}]},"witnesses":{"type":"array","items":{"type":"object","properties":{"ruleId":{"type":"string"},"detail":{"type":"string"},"path":{"type":"string","description":"JSON pointer or dotted path into the input."},"offset":{"type":"integer"},"index":{"type":"integer"},"expected":{"description":"What the rule required."},"actual":{"description":"What the input had."}}}},"versions":{"type":"object","description":"Every semantic dependency of this answer (engine, tables and their as-of dates, tokenizer, calendar, rounding profile)."},"limits":{"type":"array","items":{"type":"string"}},"deterministic":{"type":"boolean","description":"Always true: pure code, no model."}}},"outputSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"status":{"type":"string","enum":["pass","fail","unknown","unsupported"],"description":"pass: every rule held. fail: a rule was violated (see witnesses). unknown: the input lacks the evidence to decide. unsupported: outside what this engine covers. Missing evidence is never a pass."},"dialect":{"anyOf":[{"type":"object","properties":{"delimiter":{"type":"string"},"quote":{"type":"string"},"escape":{"type":"string","description":"doubled-quote (RFC 4180)."},"lineTerminator":{"type":"string","enum":["CRLF","LF","CR","mixed","none"]},"bom":{"type":"boolean"},"endsWithNewline":{"type":"boolean"}}},{"type":"null"}]},"candidates":{"type":"array","items":{"type":"object","properties":{"delimiter":{"type":"string"},"quote":{"type":"string"},"rows":{"type":"integer"},"fieldCount":{"type":"integer"},"consistentRows":{"type":"integer"},"consistency":{"type":"number"},"score":{"type":"number"}}}},"columns":{"anyOf":[{"type":"integer"},{"type":"null"}]},"preambleRows":{"anyOf":[{"type":"integer","description":"Rows above the header that do not have the modal field count (titles, notes)."},{"type":"null"}]},"headerRow":{"anyOf":[{"type":"integer","description":"0-based row index of the header among parsed rows."},{"type":"null"}]},"headerLine":{"anyOf":[{"type":"integer","description":"1-based physical line of the header."},{"type":"null"}]},"hasHeader":{"type":"string","enum":["yes","no","unknown"]},"header":{"anyOf":[{"type":"object","properties":{"names":{"type":"array","items":{"type":"string"}},"repaired":{"type":"array","items":{"type":"string"}},"repairs":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer"},"from":{"type":"string"},"to":{"type":"string"},"reason":{"type":"string"}}}}}},{"type":"null"}]},"raggedRows":{"type":"array","items":{"type":"object","properties":{"row":{"type":"integer"},"line":{"type":"integer"},"expected":{"type":"integer"},"actual":{"type":"integer"}}}},"ambiguity":{"anyOf":[{"type":"string"},{"type":"null"}]},"witnesses":{"type":"array","items":{"type":"object","properties":{"ruleId":{"type":"string"},"detail":{"type":"string"},"path":{"type":"string","description":"JSON pointer or dotted path into the input."},"offset":{"type":"integer"},"index":{"type":"integer"},"expected":{"description":"What the rule required."},"actual":{"description":"What the input had."}}}},"versions":{"type":"object","description":"Every semantic dependency of this answer (engine, tables and their as-of dates, tokenizer, calendar, rounding profile)."},"limits":{"type":"array","items":{"type":"string"}},"deterministic":{"type":"boolean","description":"Always true: pure code, no model."}}},"_provenance":{"type":"object","description":"C2PA-aligned manifest and W3C VC 2.0 (eddsa-jcs-2022) issued by the hub DID; verify at POST /api/v1/verify-provenance"}},"required":["data","_provenance"]},"example":{"text":"Export 2026-11-04\n\nid;name;note\n007;Ann;\"a;b\"\n008;Bob;ok\n"},"openapiOperation":{"operationId":"csv_dialect","summary":"Detect a CSV file's delimiter, quote, header row and broken header names","description":"Detects the delimiter (comma, semicolon, tab, pipe), quote character, line terminator, BOM, header row offset (preamble lines above the header) and whether a header exists in CSV text, parsed per RFC 4180 so quoted delimiters and CRLF inside quoted fields are handled. Returns every candidate dialect with its score, each ragged row with its physical line, and header repairs (empty, duplicate or BOM-polluted names, with the deterministic replacement). Reports `unknown` when two dialects fit equally well or the file has a single column, instead of guessing. For agents about to parse an unfamiliar export. It does not coerce types or fix data rows; use csv-roundtrip for type and spreadsheet hazards.\n\nPrice: 0.005 USDC on Base (x402).","x-x402-price-usdc":"0.005","x-x402-amount":"5000","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"}},"x-audience":"developer","x-sample-url":"https://agents.writerslogic.com/api/v1/samples/csv-dialect","security":[{"x402":[]},{"apiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["text"],"properties":{"text":{"type":"string","maxLength":200000,"description":"CSV text, up to 200000 characters. Detection samples the first 50000; structure checks cover all of it."}}},"example":{"text":"Export 2026-11-04\n\nid;name;note\n007;Ann;\"a;b\"\n008;Bob;ok\n"}}}},"responses":{"200":{"description":"Paid result with provenance","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"status":{"type":"string","enum":["pass","fail","unknown","unsupported"],"description":"pass: every rule held. fail: a rule was violated (see witnesses). unknown: the input lacks the evidence to decide. unsupported: outside what this engine covers. Missing evidence is never a pass."},"dialect":{"anyOf":[{"type":"object","properties":{"delimiter":{"type":"string"},"quote":{"type":"string"},"escape":{"type":"string","description":"doubled-quote (RFC 4180)."},"lineTerminator":{"type":"string","enum":["CRLF","LF","CR","mixed","none"]},"bom":{"type":"boolean"},"endsWithNewline":{"type":"boolean"}}},{"type":"null"}]},"candidates":{"type":"array","items":{"type":"object","properties":{"delimiter":{"type":"string"},"quote":{"type":"string"},"rows":{"type":"integer"},"fieldCount":{"type":"integer"},"consistentRows":{"type":"integer"},"consistency":{"type":"number"},"score":{"type":"number"}}}},"columns":{"anyOf":[{"type":"integer"},{"type":"null"}]},"preambleRows":{"anyOf":[{"type":"integer","description":"Rows above the header that do not have the modal field count (titles, notes)."},{"type":"null"}]},"headerRow":{"anyOf":[{"type":"integer","description":"0-based row index of the header among parsed rows."},{"type":"null"}]},"headerLine":{"anyOf":[{"type":"integer","description":"1-based physical line of the header."},{"type":"null"}]},"hasHeader":{"type":"string","enum":["yes","no","unknown"]},"header":{"anyOf":[{"type":"object","properties":{"names":{"type":"array","items":{"type":"string"}},"repaired":{"type":"array","items":{"type":"string"}},"repairs":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer"},"from":{"type":"string"},"to":{"type":"string"},"reason":{"type":"string"}}}}}},{"type":"null"}]},"raggedRows":{"type":"array","items":{"type":"object","properties":{"row":{"type":"integer"},"line":{"type":"integer"},"expected":{"type":"integer"},"actual":{"type":"integer"}}}},"ambiguity":{"anyOf":[{"type":"string"},{"type":"null"}]},"witnesses":{"type":"array","items":{"type":"object","properties":{"ruleId":{"type":"string"},"detail":{"type":"string"},"path":{"type":"string","description":"JSON pointer or dotted path into the input."},"offset":{"type":"integer"},"index":{"type":"integer"},"expected":{"description":"What the rule required."},"actual":{"description":"What the input had."}}}},"versions":{"type":"object","description":"Every semantic dependency of this answer (engine, tables and their as-of dates, tokenizer, calendar, rounding profile)."},"limits":{"type":"array","items":{"type":"string"}},"deterministic":{"type":"boolean","description":"Always true: pure code, no model."}}},"_provenance":{"type":"object","description":"C2PA-aligned manifest and W3C VC 2.0 (eddsa-jcs-2022) issued by the hub DID; verify at POST /api/v1/verify-provenance"}},"required":["data","_provenance"]}}}},"400":{"description":"Invalid request (no payment consumed)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"401":{"description":"Invalid X-API-KEY","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"402":{"description":"Payment required or invalid","content":{"application/json":{"schema":{"type":"object","description":"x402 v2 PaymentRequired (also base64 in the PAYMENT-REQUIRED header)","properties":{"x402Version":{"type":"integer"},"error":{"type":"string"},"code":{"type":"string"},"resource":{"type":"object"},"accepts":{"type":"array","items":{"type":"object"}},"extensions":{"type":"object"}}}}}},"502":{"description":"Upstream failure; the payment is released or not settled","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}}}},"links":{"docs":"https://agents.writerslogic.com/docs/csv-dialect/","docsJson":"https://agents.writerslogic.com/docs/csv-dialect.json","sample":"https://agents.writerslogic.com/api/v1/samples/csv-dialect","openapi":"https://agents.writerslogic.com/openapi.json","catalog":"https://agents.writerslogic.com/api/v1/catalog","verifyProvenance":"https://agents.writerslogic.com/api/v1/verify-provenance","index":"https://agents.writerslogic.com/docs/index.json"}}