[helpcodeai]

Summary

Etsy rejects a listing title longer than 140 characters (/title/0 : cannot be more than 140 characters). Our etsy_create_listing_draft and etsy_edit_listing tools did not mention the limit, so models sent longer titles. In the last 24 h on Cloud, Etsy refused titles as too long 27 times on etsy_edit_listing (1 workspace) and 2 times on etsy_create_listing_draft (1 workspace).

Changes

• The title parameter of both tools now says "at most 140 characters" and declares maxLength: 140.
• A static spec checks both.

The description reaches the model in the tool list. String maxLength is not enforced by our schema code yet; that is proposed separately. This is a parameter description change, so the catalog reconciler applies it to installed Etsy connectors at boot ("safe" class). Customers don't need to click "Apply update".

Type

• Bug fix

Testing

• Added/updated unit tests
• packages/backend: npx jest src/adapters/intl/etsy: 21 passed. npx jest src/adapters/catalog: 14,881 passed.
• From the root: node scripts/validate-adapters.mjs --warn adds no new warnings (only the existing nina-warnung prefix warnings). regenerate-catalog.mjs produces no diff. adapter-count.mjs --check OK (695).

Checklist

• My code follows the existing code style
• I have tested my changes locally
• I have updated documentation (if applicable): not needed
• All existing tests pass
• This PR has a descriptive title

Related Issues

Found in the 2026-11-05 daily check (Cloud tool errors).

Deployment: Cloud and self-hosted behave the same. Installed Etsy connectors get the new description at the next boot.