Imported from voxgig-sdk/trello-sdk (ts/AGENTS.md). Install upstream with npx skills add voxgig-sdk/trello-sdk --skill ts. Copyright stays with the author.

Trello TypeScript — Agent Guide

The TypeScript client for the Trello API. This directory is generated — do not edit it by hand; change the model/template/component in .sdk/ and regenerate. See the project guide for the full workflow and the aontu model language.

Paths below (.sdk/…) are relative to the project root — one level up from this ts/ directory.

Regenerate this target

cd ../.sdk
npm run build        # only if you changed a component
npm run generate     # refreshes this ts/ directory

Then build and test the generated output:

# in this target directory (ts/):
npm install
make build
make test

What generates this target

Decision rule: same for every API → template; depends on the API → component. After editing a component run npm run build before npm run generate; template-only edits just need npm run generate.

Features in this target

• debug — Request/response capture ring buffer for debugging
• idempotency — Idempotency keys for safe retries of mutating operations
• metrics — Statistics capture: per-operation counters and latency
• paging — Pagination signals for list operations
• ratelimit — Client-side rate limiting via a token bucket
• retry — Automatic retry of transient failures with exponential backoff
• test — In-memory mock transport for testing without a live server
• timeout — Per-request timeout with transport abort

Each feature's runtime and its own guide live in src/feature/<name>/.

Generated by @voxgig/sdkgen. See the project guide.