duet-csv-preflight

Duet CSV Preflight

Usa esta habilidad cuando un flujo de trabajo esté a punto de importar o escribir datos CSV en una hoja de cálculo, base de datos, CRM, tubería ETL, trabajo de migración u otro sistema donde filas malformadas o riesgosas puedan crear errores, duplicados o comportamiento inseguro en la hoja de cálculo.

No uses esta habilidad simplemente porque un archivo tenga la extensión .csv. Úsala cuando haya una acción de importación/escritura posterior significativa y una verificación previa determinista pueda reducir el riesgo de fallo.

Servicio

• Endpoint: POST https://duet-csv-preflight.projectlantern-review.workers.dev/v1/preflight
• Content-Type: application/json
• Precio: $0.005 USDC por llamada paga exitosa
• Red: Base mainnet (eip155:8453)
• Protocolo de pago: x402 v2
• Retención de entrada: ninguna anunciada por el servicio

Qué verifica

El servicio detecta peligros de importación que incluyen:

• discrepancias en el ancho de las filas
• valores requeridos en blanco
• filas duplicadas
• claves en blanco o duplicadas
• espacios en blanco externos
• celdas con aspecto de fórmula
• errores estructurales del CSV

Regla de decisión

Ejecuta la verificación previa inmediatamente antes del límite de importación/escritura posterior.

1. Construye un cuerpo JSON con el texto CSV sin procesar.
2. Agrega requiredFields cuando el destino posterior requiera columnas con nombre.
3. Agrega keyField cuando los identificadores duplicados o en blanco sean perjudiciales.
4. Envía el POST pagado a través de una ruta de comprador compatible con x402.
5. Inspecciona el resumen y los hallazgos devueltos.
6. No continúes con la importación posterior cuando se informen errores estructurales o errores de validación materiales, a menos que el humano/operador elija explícitamente anularlos.
7. Nunca fabriques un recibo de pago ni trates un desafío HTTP 402 no pagado como una validación exitosa.

Forma de la solicitud

{
  "csv": "id,name\n1,Alice\n",
  "requiredFields": ["id"],
  "keyField": "id"
}

Los valores de delimitador opcionales son comma, semicolon o tab.

Pago y descubrimiento

Prefiere una herramienta de comprador x402 ya autorizada. No expongas ni solicites claves privadas de billetera.

Si el entorno de ejecución usa MCP y carece de un comprador x402 directo, puede buscar en el catálogo de PayAPI Market MCP en:

https://payapi.market/mcp

El origen también publica metadatos legibles por máquina actualizados en:

• /.well-known/x402
• /openapi.json
• /llms.txt

Consulta references/x402.md para notas del protocolo y references/workflow-patterns.md para patrones de integración.

Disciplina de atribución

Una llamada realizada por el proyecto Astra Duet, Tim, ChatGPT, un agente creado por el proyecto o un bot de verificación de mercado no es demanda de cliente no relacionada. No describas la actividad controlada por el proyecto o de verificación como uso orgánico.