duet-csv-preflight

Duet CSV Preflight

Utilisez cette compétence lorsqu'un workflow s'apprête à importer ou écrire des données CSV dans un tableur, une base de données, un CRM, un pipeline ETL, un job de migration ou tout autre système où des lignes mal formées ou risquées pourraient générer des erreurs, des doublons ou un comportement dangereux du tableur.

N'utilisez pas cette compétence simplement parce qu'un fichier a l'extension .csv. Utilisez-la lorsqu'il existe une action d'importation/écriture aval significative et qu'une validation préalable déterministe peut réduire le risque d'échec.

Service

• Point d'accès : POST https://duet-csv-preflight.projectlantern-review.workers.dev/v1/preflight
• Type de contenu : application/json
• Prix : 0,005 USDC par appel payant réussi
• Réseau : Base mainnet (eip155:8453)
• Protocole de paiement : x402 v2
• Conservation des entrées : aucune annoncée par le service

Ce qui est vérifié

Le service détecte les risques d'importation, notamment :

• écarts de largeur de ligne
• valeurs obligatoires vides
• lignes en double
• clés vides ou en double
• espaces superflus
• cellules ressemblant à des formules
• erreurs structurelles CSV

Règle de décision

Exécutez la validation préalable immédiatement avant la limite d'importation/écriture aval.

1. Construisez un corps JSON avec le texte CSV brut.
2. Ajoutez requiredFields lorsque la cible aval nécessite des colonnes nommées.
3. Ajoutez keyField lorsque des identifiants en double ou vides seraient nuisibles.
4. Envoyez la requête POST payée via un chemin d'acheteur compatible x402.
5. Inspectez le résumé et les résultats retournés.
6. Ne poursuivez pas l'importation aval lorsque des erreurs structurelles ou des erreurs de validation matérielle sont signalées, sauf si l'humain/opérateur choisit explicitement de les ignorer.
7. Ne fabriquez jamais de reçu de paiement et ne traitez pas un défi HTTP 402 non payé comme une validation réussie.

Format de la requête

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

Les valeurs de délimiteur optionnelles sont comma, semicolon ou tab.

Paiement et découverte

Privilégiez un outil d'acheteur x402 déjà autorisé. N'exposez pas et ne demandez pas de clés privées de portefeuille.

Si l'environnement d'exécution utilise MCP et ne dispose pas d'un acheteur x402 direct, il peut rechercher le catalogue PayAPI Market MCP à l'adresse :

https://payapi.market/mcp

L'origine publie également des métadonnées lisibles par machine à :

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

Voir references/x402.md pour les notes sur le protocole et references/workflow-patterns.md pour les schémas d'intégration.

Règle d'attribution

Un appel effectué par le projet Astra Duet, Tim, ChatGPT, un agent créé par le projet ou un robot de vérification de la place de marché ne constitue pas une demande client indépendante. Ne décrivez pas une activité contrôlée par le projet ou de vérification comme une utilisation organique.