@zapier/trello-connector 0.0.0 → 0.1.0

package/LICENSE

@@ -0,0 +1,93 @@
+Elastic License 2.0
+
+URL: https://www.elastic.co/licensing/elastic-license
+
+## Acceptance
+
+By using the software, you agree to all of the terms and conditions below.
+
+## Copyright License
+
+The licensor grants you a non-exclusive, royalty-free, worldwide,
+non-sublicensable, non-transferable license to use, copy, distribute, make
+available, and prepare derivative works of the software, in each case subject to
+the limitations and conditions below.
+
+## Limitations
+
+You may not provide the software to third parties as a hosted or managed
+service, where the service provides users with access to any substantial set of
+the features or functionality of the software.
+
+You may not move, change, disable, or circumvent the license key functionality
+in the software, and you may not remove or obscure any functionality in the
+software that is protected by the license key.
+
+You may not alter, remove, or obscure any licensing, copyright, or other notices
+of the licensor in the software. Any use of the licensor's trademarks is subject
+to applicable law.
+
+## Patents
+
+The licensor grants you a license, under any patent claims the licensor can
+license, or becomes able to license, to make, have made, use, sell, offer for
+sale, import and have imported the software, in each case subject to the
+limitations and conditions in this license. This license does not cover any
+patent claims that you cause to be infringed by modifications or additions to
+the software. If you or your company make any written claim that the software
+infringes or contributes to infringement of any patent, your patent license for
+the software granted under these terms ends immediately. If your company makes
+such a claim, your patent license ends immediately for work on behalf of your
+company.
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of the software from you
+also gets a copy of these terms.
+
+If you modify the software, you must include in any modified copies of the
+software prominent notices stating that you have modified the software.
+
+## No Other Rights
+
+These terms do not imply any licenses other than those expressly granted in
+these terms.
+
+## Termination
+
+If you use the software in violation of these terms, such use is not licensed,
+and your licenses will automatically terminate. If the licensor provides you
+with a notice of your violation, and you cease all violation of this license no
+later than 30 days after you receive that notice, your licenses will be
+reinstated retroactively. However, if you violate these terms after such
+reinstatement, any additional violation of these terms will cause your licenses
+to terminate automatically and permanently.
+
+## No Liability
+
+*As far as the law allows, the software comes as is, without any warranty or
+condition, and the licensor will not be liable to you for any damages arising
+out of these terms or the use or nature of the software, under any kind of
+legal claim.*
+
+## Definitions
+
+The **licensor** is the entity offering these terms, and the **software** is the
+software the licensor makes available under these terms, including any portion
+of it.
+
+**you** refers to the individual or entity agreeing to these terms.
+
+**your company** is any legal entity, sole proprietorship, or other kind of
+organization that you work for, plus all organizations that have control over,
+are under the control of, or are under common control with that
+organization. **control** means ownership of substantially all the assets of an
+entity, or the power to direct its management and policies by vote, contract, or
+otherwise. Control can be direct or indirect.
+
+**your licenses** are all the licenses granted to you for the software under
+these terms.
+
+**use** means anything you do with the software requiring one of your licenses.
+
+**trademark** means trademarks, service marks, and similar rights.

package/NOTICE

@@ -0,0 +1,8 @@
+Independent, unofficial connector for Trello.
+
+Zapier licenses only the connector code in this package, under the Elastic
+License 2.0. Zapier grants no rights in Trello's API, services, data,
+schemas, documentation, or other materials, which remain the property of
+Trello. Trello and its logos are trademarks of their owner, used only to
+identify the service this connector works with. Not affiliated with, endorsed
+by, or sponsored by Trello.

package/README.md

@@ -1,4 +1,137 @@
 # @zapier/trello-connector
 
-> **Placeholder** — published to bootstrap OIDC Trusted Publisher configuration.
-> The real package is published via GitLab CI once trust is established.
+_Independent, unofficial connector for Trello. Not affiliated with, endorsed by, or sponsored by Trello. "Trello" is a trademark of its owner, used only to identify the service this connector works with._
+
+Agent-callable tools for the [Trello REST API](https://developer.atlassian.com/cloud/trello/rest/): create and move cards, manage boards and lists, labels and checklists, comments and attachments, and search — 44 tools total. Auth is OAuth 1.0a via a Zapier-managed connection (recommended) or direct `TRELLO_API_KEY` + `TRELLO_TOKEN` env vars.
+
+This connector is the same artifact across four shapes: MCP server, CLI bin, importable Node module, and an [Agent Skill](https://agentskills.io/) anchored by [`SKILL.md`](SKILL.md). Pick the shape that matches how your agent runs.
+
+## Install
+
+```bash
+# Run a tool with zero install — npx fetches the package on first use
+TRELLO_API_KEY=xxx TRELLO_TOKEN=yyy npx @zapier/trello-connector run listBoards '{}' --connection env:TRELLO
+
+# Install as a dependency to import the tools in your own code
+npm install @zapier/trello-connector
+
+# Or install as an Agent Skill (https://agentskills.io)
+npx skills zapier/connectors --skill trello
+```
+
+Auth is one `[<resolver>:]<value>` connection string passed with `--connection`. The value is a _selector_, not the secret: `--connection zapier:<connection-id>` routes through Zapier-managed auth (recommended; no third-party secret enters the agent's environment — store the id in `TRELLO_ZAPIER_CONNECTION_ID` and pass `--connection "zapier:$TRELLO_ZAPIER_CONNECTION_ID"` if you like), and `--connection env:TRELLO` reads `TRELLO_API_KEY` + `TRELLO_TOKEN` from the environment (both required; secrets stay in `env`, never on argv). The `<resolver>:` prefix is optional — a bare value is claimed by the first matching resolver. See [`SKILL.md`](SKILL.md#auth) for tradeoffs and how to find a connection ID.
+
+## Tools
+
+| Tool                     | Description                                                            |
+| ------------------------ | ---------------------------------------------------------------------- |
+| **Boards**               |                                                                        |
+| `createBoard`            | Create a new board in a workspace                                      |
+| `copyBoard`              | Copy a board, optionally keeping cards                                 |
+| `closeBoard`             | Archive (close) a board                                                |
+| `getBoard`               | Get a board by id                                                      |
+| `listBoards`             | List boards the authenticated member can access                        |
+| `findBoard`              | Find boards by name                                                    |
+| `listBoardMembers`       | List members of a board                                                |
+| `addMemberToBoard`       | Add a member to a board by id or email                                 |
+| **Lists**                |                                                                        |
+| `createList`             | Create a list on a board                                               |
+| `getList`                | Get a list by id                                                       |
+| `listLists`              | List all lists on a board                                              |
+| `findList`               | Find lists on a board by name                                          |
+| **Cards**                |                                                                        |
+| `createCard`             | Create a card on a list with optional members, labels, and attachments |
+| `updateCard`             | Update card fields (name, description, due, cover, list)               |
+| `archiveCard`            | Archive (close) a card                                                 |
+| `moveCard`               | Move a card to another list or board                                   |
+| `getCard`                | Get a card by id                                                       |
+| `listCards`              | List cards on a board with optional filters                            |
+| `searchCards`            | Search cards using Trello query DSL or structured filters              |
+| `createComment`          | Add a comment to a card                                                |
+| `getAction`              | Get an action (activity) by id                                         |
+| `listCardAttachments`    | List attachments on a card                                             |
+| `addCardAttachment`      | Add a URL attachment or link a remote file to a card                   |
+| **Labels**               |                                                                        |
+| `createLabel`            | Create a label on a board                                              |
+| `getLabel`               | Get a label by id                                                      |
+| `listLabels`             | List labels on a board                                                 |
+| `findLabel`              | Find labels on a board by name                                         |
+| `addCardLabel`           | Add an existing label to a card                                        |
+| `removeCardLabel`        | Remove a label from a card                                             |
+| **Checklists**           |                                                                        |
+| `createChecklist`        | Create a checklist on a card                                           |
+| `getChecklist`           | Get a checklist by id                                                  |
+| `deleteChecklist`        | Delete a checklist                                                     |
+| `findChecklist`          | Find checklists on a card by name                                      |
+| `addChecklistItem`       | Add an item to a checklist                                             |
+| `getChecklistItem`       | Get a checklist item by id                                             |
+| `findChecklistItem`      | Find checklist items by name                                           |
+| `completeChecklistItem`  | Mark a checklist item complete or incomplete                           |
+| **Members & workspaces** |                                                                        |
+| `getCurrentMember`       | Get the authenticated member                                           |
+| `getMember`              | Get a member by id                                                     |
+| `findOrganizationMember` | Find members in a workspace                                            |
+| `getOrganization`        | Get a workspace by id                                                  |
+| `listOrganizations`      | List workspaces the member belongs to                                  |
+| `addCardMember`          | Add a member to a card                                                 |
+| `listCustomFields`       | List custom field definitions on a board                               |
+
+Run `npx @zapier/trello-connector run <toolName> --help` to see any tool's exact input contract + the available resolvers.
+
+## Usage
+
+```ts
+import { listBoards } from "@zapier/trello-connector";
+
+const { data } = await listBoards({}, { connection: "env:TRELLO" });
+// data.items — array of boards
+```
+
+## MCP Server
+
+Add one stanza to any MCP-aware client (Claude Desktop, Cursor, Claude Code, …) to auto-discover the tools over stdio:
+
+<!-- prettier-ignore -->
+```jsonc
+// e.g. claude_desktop_config.json or .cursor/mcp.json
+{
+  "mcpServers": {
+    "trello": {
+      "command": "npx",
+      "args": ["@zapier/trello-connector", "mcp", "--connection", "zapier:<connection-id>"],
+    }
+  }
+}
+```
+
+No Zapier account? Use the `env:` resolver — point `--connection` at `env:TRELLO` and keep credentials in `env`: `"args": ["@zapier/trello-connector", "mcp", "--connection", "env:TRELLO"]` with `"env": { "TRELLO_API_KEY": "xxx", "TRELLO_TOKEN": "yyy" }`.
+
+## When to use this
+
+Use this connector when an agent needs to create or update Trello cards, organize boards and lists, manage labels and checklists, or search and read Trello data. It covers the common CRUD and lookup flows agents need for task boards and project tracking.
+
+## When NOT to use this
+
+- **Webhooks, automations, or Power-Ups** — not supported; use Trello's native Butler or Zapier Zaps instead.
+- **Local file uploads** — only URL-based attachments; use Trello's UI or a file-hosting step first.
+- **Enterprise admin or billing** — workspace policy and billing are outside this API surface.
+
+## Links
+
+- [`SKILL.md`](SKILL.md) — runtime guidance for agents
+- [Trello REST API docs](https://developer.atlassian.com/cloud/trello/rest/)
+- [Source](https://github.com/zapier/connectors/tree/main/apps/trello)
+
+## Legal
+
+**Scope of license.** Zapier licenses only the connector code in this package. Zapier grants no rights in Trello's API, services, data, schemas, documentation, or other materials, which remain the property of Trello. Your use of Trello's API is governed by your own agreement with Trello.
+
+**Trademarks and affiliation.** Trello and its logos are trademarks of their owner, used here only to identify the service this connector works with. This connector is not affiliated with, endorsed by, or sponsored by Trello.
+
+**Your responsibility.** This connector calls Trello's API using credentials you supply. You are responsible for holding a valid Trello account, for complying with Trello's API terms, developer policies, and acceptable use rules, and for the data you send and receive through it.
+
+**No warranty.** This connector is provided "as is," without warranty of any kind, and is not an official Trello product. Zapier is not responsible for changes Trello makes to its API or for any consequence of your use of Trello's API. See the repository LICENSE for the full disclaimer.
+
+**Forks.** You may fork and modify this connector under the Elastic License 2.0. You may state that your fork is "based on" Zapier's connector, but you may not use the "Zapier" name or logo as the name or branding of your fork, or in any way that suggests Zapier produces, endorses, or supports it.
+
+Licensed under the Elastic License 2.0. See the repository LICENSE and NOTICE.

package/SKILL.md

@@ -0,0 +1,139 @@
+---
+name: trello
+description: Agent-callable Trello tools — create and update cards, manage boards, lists, labels, checklists, and search. Use when the user mentions Trello or wants to create cards, move tasks, or manage boards, even if they do not name Trello explicitly.
+license: Elastic-2.0
+compatibility: Requires Node.js 22.18+ or Bun 1.x; run `npm install` in this directory first.
+metadata:
+  title: Trello
+  source: https://github.com/zapier/connectors/blob/main/apps/trello/SKILL.md
+  api-docs: https://developer.atlassian.com/cloud/trello/rest/
+  zapier-app-key: TrelloAPI
+---
+
+# Trello
+
+_Independent, unofficial connector for Trello. Not affiliated with, endorsed by, or sponsored by Trello. "Trello" is a trademark of its owner, used only to identify the service this connector works with._
+
+Tools for working with Trello against the [Trello REST API](https://developer.atlassian.com/cloud/trello/rest/) (`https://api.trello.com/1`): create and move cards, manage boards and lists, labels and checklists, comments and attachments, member lookups, and search. 44 tools across boards, lists, cards, labels, checklists, members, and search.
+
+## When to use this connector
+
+- An agent needs to **create or update cards** — add tasks, set due dates, assign members, add labels, or archive/reopen cards.
+- An agent needs to **organize boards** — create boards and lists, move cards between lists, copy boards, or close (archive) boards.
+- An agent needs to **look up Trello resources by name** — find boards, lists, labels, or checklists before writing.
+- An agent needs to **search cards** or read board/list/card detail for planning or reporting.
+
+## Step 0 — pre-flight and auth
+
+Run the bundled pre-flight check **once** at the start of a session to learn how to run the scripts in the current harness, then run scripts directly — reuse the result for the rest of the session. It detects a usable runtime (Node 22.18+ or Bun) and that dependencies are installed; it does **not** probe the network or auth (the scripts own that). Read `PREFLIGHT_STATUS` first — the single verdict token; `PREFLIGHT_RUNNER` names the runtime.
+
+```bash
+./preflight.sh
+```
+
+Exit `0` **READY**: follow `PREFLIGHT_RECOMMENDATION` — it gives the exact `--help` command to run next (e.g. `node /path/scripts/<name>.ts --help`). The `--help` output lists the connection flag(s) the script reads and every resolver each accepts — value shape and auto-claim behavior. Use the runner from `PREFLIGHT_RUNNER` against the local script path — never `npx` (a sandbox that blocked the dep install may also block registry fetches). If a script call later fails with a network error, egress is blocked — recommend the user set up Zapier's remote MCP at `https://mcp.zapier.com`.
+
+Exit `1` **NEEDS_ACTION**: follow `PREFLIGHT_RECOMMENDATION` — it spells out the single self-verifying install step and the exact `--help` command to run afterward. Re-running the pre-flight to reconfirm is optional.
+
+## Auth
+
+Trello uses **OAuth 1.0a** — every request carries an `Authorization: OAuth oauth_consumer_key="…", oauth_token="…"` header built from an API key plus access token. One connection slot (`trello`) holds both values. Pass auth as one connection string with `--connection [<resolver>:]<value>` (CLI / MCP) or `{ connection: "[<resolver>:]<value>" }` (imported). The value is a _selector_, not the secret; the `<resolver>:` prefix is optional (a bare value goes to the first resolver that claims it). Two resolvers, Zapier-first:
+
+- **`zapier:<connection-id>`** _(recommended)_ — route through a Zapier Trello connection. **Prerequisite: a Zapier account** (free signup at <https://zapier.com>, ~1 minute). The user authorizes Trello once via Zapier's OAuth flow; token refresh is handled for you. A bare UUID auto-claims this resolver. Find the ID with the Zapier SDK CLI: `npx @zapier/zapier-sdk-cli list-connections TrelloAPI` (run `login` first if unauthenticated; add `--json` for machine output).
+- **`env:TRELLO`** _(fallback)_ — read credentials from **`TRELLO_API_KEY`** and **`TRELLO_TOKEN`** environment variables (both required; the prefix `TRELLO` maps to those two keys). Export both before calling — the secrets stay in `env`, never on argv.
+
+If no connection is passed the script fails with an actionable error telling you to `Pass --connection [<resolver>:]<value>` and lists the resolvers in match order.
+
+## Scripts
+
+One file per tool in [`scripts/`](scripts/); each tool's `inputSchema` / `outputSchema` (Zod) in the script file is the source of truth for its contract. Shared helpers live in [`lib/trello.ts`](lib/trello.ts). All tools use the single connection `trello`.
+
+**Boards:** `createBoard`, `copyBoard`, `closeBoard`, `getBoard`, `listBoards`, `findBoard`, `listBoardMembers`, `addMemberToBoard`.
+**Lists:** `createList`, `getList`, `listLists`, `findList`.
+**Cards:** `createCard`, `updateCard`, `archiveCard`, `moveCard`, `getCard`, `listCards`, `searchCards`, `createComment`, `getAction`, `listCardAttachments`, `addCardAttachment`.
+**Labels:** `createLabel`, `getLabel`, `listLabels`, `findLabel`, `addCardLabel`, `removeCardLabel`.
+**Checklists:** `createChecklist`, `getChecklist`, `deleteChecklist`, `findChecklist`, `addChecklistItem`, `getChecklistItem`, `findChecklistItem`, `completeChecklistItem`.
+**Members & workspaces:** `getCurrentMember`, `getMember`, `findOrganizationMember`, `getOrganization`, `listOrganizations`, `addCardMember`, `listCustomFields`.
+
+**Resolve ids before writes.** Trello ids are 24-character hex strings. When the user names a board, list, or label, call the matching `find*` or `list*` tool first and pass the returned id into create/update/move tools — never guess ids.
+
+**Always learn a script's input contract before calling it — never guess field names, casing, or types.** Run `--help` on either entrypoint — `./scripts/<script>.ts --help` or `npx @zapier/trello-connector run <script> --help` — which renders `inputSchema` as JSON Schema and lists the connection flag(s) and available resolvers. Guessing the payload just produces a `ZodError` and wastes a round-trip.
+
+## Output format
+
+Every script returns a `{ data, meta }` envelope (same shape across the CLI's JSON output, the imported SDK return value, and the MCP tool's `structuredContent`):
+
+- **`data`** — the script's result (the shape declared by its `outputSchema`).
+- **`meta.outputDataValidation`** — what validating `data` did:
+  - `{ skipped: false, droppedPaths: null }` — validated, nothing removed.
+  - `{ skipped: false, droppedPaths: [...], instruction }` — validated, but those paths (fields the API returned that the `outputSchema` doesn't declare) were stripped from `data`. If you need them, re-run with output validation skipped.
+  - `{ skipped: true }` — validation was bypassed; `data` is the raw, unchecked API output.
+
+**Reading dropped fields / `skipOutputDataValidation`.** To receive the raw, unvalidated result, set the single token `skipOutputDataValidation` — CLI: append `--skipOutputDataValidation`; MCP: pass `meta: { skipOutputDataValidation: true }` as a tool argument; SDK: pass `{ skipOutputDataValidation: true }` in the run options. Input validation is never skipped.
+
+**Trimming the result / `filterOutputData`.** To shrink a large result down to the fields you need, pass a jq expression that post-processes `data` — CLI: append `--filterOutputData '<jq>'`; MCP: pass `meta: { filterOutputData: "<jq>" }` as a tool argument. The jq runs against `data` only, NOT the `{ data, meta }` envelope, so write it rooted at `data` (see this script's output schema). The transformed value replaces `data`, `meta` is preserved, and the result is NOT re-validated against the output schema. The imported SDK has no `filterOutputData` option — reshape the returned `data` in code instead.
+
+## Disambiguation & refusals
+
+**Disambiguation before a write.** Before writing to a board, list, card, label, or checklist you looked up by name (e.g. create a card on a list found via `findList`, or add a label found via `findLabel`), count the **exact case-insensitive name matches**:
+
+- **Exactly one match** — act on it. Don't over-ask; a single unambiguous match is the answer.
+- **Two or more that tie** — stop. List the tied candidates with a distinguishing field (id + name + board/list context) and ask the user which one they mean. Don't pick arbitrarily and don't write to all of them.
+
+**Unsupported operations — say so and stop; don't fake it with another tool.** This catalog deliberately does not:
+
+- **Manage webhooks, automations, or Power-Ups.** There are no trigger or Butler-rule tools.
+- **Upload local binary files.** `addCardAttachment` accepts a URL or remote file URL only — not a local path or base64 payload.
+- **Permanently delete boards or cards.** `closeBoard` and `archiveCard` archive (soft-close) resources; there is no hard-delete tool.
+- **Manage workspace billing, admin settings, or enterprise policies.**
+
+If asked for any of these, tell the user it's unsupported and stop — don't reach for an unrelated tool to approximate it.
+
+## Using this skill
+
+The three invocation paths below all assume the pre-flight (Step 0) reported `READY`.
+
+### 1. Execute scripts directly
+
+When the agent has shell access to the installed directory, run a script file straight from `scripts/`. Each script is `chmod +x` with a Node-targeted shebang. **Run `--help` first** to read the input contract and confirm an auth option is `[READY — use this]`:
+
+```bash
+# Inspect the contract + resolvers first
+./scripts/createCard.ts --help
+
+# Then invoke (Zapier connection — recommended)
+./scripts/createCard.ts '{"idList":"604a45a4087d070014a2b5f5","name":"Review PR"}' --connection zapier:conn_xxx
+
+# Direct OAuth 1.0a credentials (both env vars required)
+TRELLO_API_KEY=xxx TRELLO_TOKEN=yyy ./scripts/listBoards.ts '{}' --connection env:TRELLO
+```
+
+Prerequisites: Node.js 22.18+ (or Bun 1.x) on `PATH`, plus `npm install` once in this directory. Pin the runtime explicitly with `node scripts/<name>.ts …` or `bun scripts/<name>.ts …` when needed — all forms run the same script body.
+
+### 2. Use the package's CLI
+
+```bash
+TRELLO_API_KEY=xxx TRELLO_TOKEN=yyy npx @zapier/trello-connector run listBoards '{}' --connection env:TRELLO
+npx @zapier/trello-connector --help                      # all scripts
+npx @zapier/trello-connector run createCard --help       # per-script schema + resolvers
+```
+
+Same scripts, different entry point. Use `bunx` when `PREFLIGHT_RUNNER` is `bun`. Some harnesses block `npx`/`bunx` — fall back to (1).
+
+### 3. Use as a recipe
+
+When no shipped script matches, read this `SKILL.md`, the [`references/`](references/) files, and the `scripts/` files as a recipe to generate custom code. Each script is one `export default defineTool({...})` referencing the connection key `"trello"`; imitate that shape (Zod input/output schemas, `(input, ctx) => …` run body, error handling from [`lib/trello.ts`](lib/trello.ts)). If you persist generated code, add a comment pointing back to this skill's source.
+
+## API quirks worth knowing
+
+See [references/trello-api-gotchas.md](references/trello-api-gotchas.md).
+
+## Reference files
+
+| File                                                                 | When to load                                                                                                          |
+| -------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
+| [references/trello-api-gotchas.md](references/trello-api-gotchas.md) | Before search-heavy flows, rate-limit-sensitive loops, or any write that needs id resolution (lists, boards, labels). |
+
+## Eval cases
+
+See [`evals/evals.json`](evals/evals.json) — 16 intent-anchored scenarios (arrange-act, act-only, disambiguation, graceful refusals).

package/cli.js

@@ -0,0 +1,71 @@
+#!/usr/bin/env node
+/**
+ * Connector CLI entry point.
+ *
+ * When dist/cli.js is present (npm install route, or after a local build):
+ *   → delegates to the compiled CLI, works on any Node version.
+ *
+ * When dist/ is absent (git-clone route, no build step):
+ *   → handles the `build` subcommand directly (any Node version, no TS needed),
+ *     then falls through to cli.ts for all other subcommands (requires Node 22.18+
+ *     or Bun for TypeScript stripping outside node_modules).
+ *
+ * `build` subcommand: compiles the connector so that
+ *   `import { search } from "@zapier/notion-connector"` works on any Node version
+ *   even when the connector was installed from a git/file source. Invoked
+ *   automatically by the `prepare` lifecycle hook on git-clone installs.
+ *   Tries `npx tsup`, falls back to `bunx tsup`, exits 0 regardless so that
+ *   `npm install` / `pnpm install` never fails in restricted environments.
+ *
+ * Managed by @zapier/connectors-dev — do not edit; synced byte-for-byte
+ * across every connector.
+ */
+import { spawnSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const dir = dirname(fileURLToPath(import.meta.url));
+
+if (process.argv[2] === "build") {
+  if (!existsSync(join(dir, "dist", "cli.js"))) {
+    // Try the locally-installed tsup binary first so module resolution for
+    // typescript (a required tsup peer) works from the connector's own
+    // node_modules. Fall back to npx/bunx for environments without a local
+    // install (e.g. fresh git-clone before npm install).
+    const localTsup = join(dir, "node_modules", ".bin", "tsup");
+    const candidates = existsSync(localTsup)
+      ? [
+          [process.execPath, [localTsup]],
+          ["npx", ["tsup"]],
+          ["bunx", ["tsup"]],
+        ]
+      : [
+          ["npx", ["tsup"]],
+          ["bunx", ["tsup"]],
+        ];
+    for (const [cmd, args] of candidates) {
+      const { status } = spawnSync(cmd, args, {
+        stdio: "inherit",
+        shell: true,
+        cwd: dir,
+      });
+      if (status === 0) break;
+    }
+  }
+  process.exit(0);
+}
+
+// Spawn the target as a subprocess so it runs as the entry point.
+// Dynamic import() would set import.meta.main = false, causing
+// runDispatchCli to return early without executing anything.
+const target = existsSync(join(dir, "dist", "cli.js"))
+  ? join(dir, "dist", "cli.js")
+  : join(dir, "cli.ts");
+
+const { status } = spawnSync(
+  process.execPath,
+  [target, ...process.argv.slice(2)],
+  { stdio: "inherit" },
+);
+process.exit(status ?? 1);

package/cli.ts

@@ -0,0 +1,5 @@
+import { runDispatchCli } from "@zapier/connectors-sdk";
+
+import connector from "./index.ts";
+
+await runDispatchCli(import.meta, connector);

package/connections.ts

@@ -0,0 +1,26 @@
+import {
+  defineEnvPrefixResolver,
+  zapierConnectionResolver,
+} from "@zapier/connectors-sdk";
+
+const TRELLO_OAUTH_HEADER = (apiKey: string, token: string) =>
+  `OAuth oauth_consumer_key="${apiKey}", oauth_token="${token}"`;
+
+const directTrelloResolver = defineEnvPrefixResolver({
+  name: "env",
+  keys: ["API_KEY", "TOKEN"] as const,
+  build: ({ API_KEY, TOKEN }) => {
+    const authorization = TRELLO_OAUTH_HEADER(API_KEY, TOKEN);
+    return (url, init = {}) => {
+      const headers = new Headers(init.headers);
+      headers.set("Authorization", authorization);
+      return globalThis.fetch(url, { ...init, headers });
+    };
+  },
+});
+
+// Trello OAuth 1.0a — one connection slot. Managed auth via Zapier; direct mode uses
+// TRELLO_API_KEY + TRELLO_TOKEN (pass --connection env:TRELLO when both are set).
+export const connectionResolvers = {
+  trello: [zapierConnectionResolver, directTrelloResolver],
+} as const;

package/dist/cli.js

@@ -0,0 +1,4 @@
+// cli.ts
+import { runDispatchCli } from "@zapier/connectors-sdk";
+import connector from "./index.js";
+await runDispatchCli(import.meta, connector);