@divyacon/piece-trello 0.0.0-stage → 0.1.0

package/src/lib/actions/ai/get-board.ts

@@ -0,0 +1,49 @@
+import { createAction, Property } from '@agnocon/pieces-framework';
+import {
+  httpClient,
+  HttpRequest,
+  HttpMethod,
+} from '@agnocon/pieces-common';
+import { trelloCommon } from '../../common';
+import { trelloAuth } from '../../..';
+import { withAuthParams, rethrowTrelloError } from './ai-common';
+import { getBoardActionOutputSchema } from '../../output-schemas';
+
+export const getBoard = createAction({
+  auth: trelloAuth,
+  name: 'get_board',
+  displayName: 'Get Board (Agent)',
+  description: 'Get the details of a Trello board by ID.',
+  audience: 'ai',
+  outputSchema: getBoardActionOutputSchema,
+  aiMetadata: {
+    description:
+      'Retrieves the details of a single Trello board by its board_id (name, description, url, prefs). Obtain board_id from List Boards. Read-only and idempotent.',
+    idempotent: true,
+  },
+  props: {
+    board_id: Property.ShortText({
+      displayName: 'Board ID',
+      description: 'The ID of the board. Obtain it from List Boards.',
+      required: true,
+    }),
+  },
+
+  async run(context) {
+    try {
+      const request: HttpRequest = {
+        method: HttpMethod.GET,
+        url: `${trelloCommon.baseUrl}boards/${context.propsValue['board_id']}`,
+        headers: { Accept: 'application/json' },
+        queryParams: withAuthParams(context.auth),
+      };
+      const response = await httpClient.sendRequest(request);
+      return response.body;
+    } catch (error: any) {
+      rethrowTrelloError(
+        error,
+        'Board not found. Verify the board_id (resolve it via List Boards).'
+      );
+    }
+  },
+});

package/src/lib/actions/ai/get-card-ai.ts

@@ -0,0 +1,67 @@
+import { createAction, Property } from '@agnocon/pieces-framework';
+import {
+  httpClient,
+  HttpRequest,
+  HttpMethod,
+} from '@agnocon/pieces-common';
+import { trelloCommon } from '../../common';
+import { TrelloCard } from '../../common/props/card';
+import { trelloAuth } from '../../..';
+import { getCardAiActionOutputSchema } from '../../output-schemas';
+
+export const getCardAi = createAction({
+  auth: trelloAuth,
+  name: 'get_card_ai',
+  displayName: 'Get Card (Agent)',
+  description: 'Get the full details of a Trello card by ID.',
+  audience: 'ai',
+  outputSchema: getCardAiActionOutputSchema,
+  aiMetadata: {
+    description:
+      'Retrieves the full details of a single Trello card by its card_id (name, description, due date, labels, list, members, and more). Obtain the card_id from Search Cards, List Cards In List, or List Cards In Board. Read-only and idempotent.',
+    idempotent: true,
+  },
+  props: {
+    card_id: Property.ShortText({
+      displayName: 'Card ID',
+      description:
+        'The ID of the card. Obtain it from Search Cards, List Cards In List, or List Cards In Board.',
+      required: true,
+    }),
+  },
+
+  async run(context) {
+    try {
+      const request: HttpRequest = {
+        method: HttpMethod.GET,
+        url:
+          `${trelloCommon.baseUrl}cards/` +
+          context.propsValue['card_id'] +
+          `?key=` +
+          context.auth.username +
+          `&token=` +
+          context.auth.password,
+        headers: {
+          Accept: 'application/json',
+        },
+      };
+      return (await httpClient.sendRequest<TrelloCard>(request)).body;
+    } catch (error: any) {
+      const status = error?.response?.status;
+      if (status === 401 || status === 403) {
+        throw new Error(
+          'Permission denied reading the card. Check the connection token and your access to the board.'
+        );
+      }
+      if (status === 404) {
+        throw new Error(
+          'Card not found. Verify the card_id (resolve it via Search Cards).'
+        );
+      }
+      if (status === 429) {
+        throw new Error('Trello rate limit exceeded. Retry after a short delay.');
+      }
+      throw error;
+    }
+  },
+});

package/src/lib/actions/ai/get-list.ts

@@ -0,0 +1,49 @@
+import { createAction, Property } from '@agnocon/pieces-framework';
+import {
+  httpClient,
+  HttpRequest,
+  HttpMethod,
+} from '@agnocon/pieces-common';
+import { trelloCommon } from '../../common';
+import { trelloAuth } from '../../..';
+import { withAuthParams, rethrowTrelloError } from './ai-common';
+import { getListActionOutputSchema } from '../../output-schemas';
+
+export const getList = createAction({
+  auth: trelloAuth,
+  name: 'get_list',
+  displayName: 'Get List (Agent)',
+  description: 'Get the details of a Trello list by ID.',
+  audience: 'ai',
+  outputSchema: getListActionOutputSchema,
+  aiMetadata: {
+    description:
+      'Retrieves the details of a single Trello list by its list_id (name, board, open/closed state). Obtain list_id from List Lists. Read-only and idempotent.',
+    idempotent: true,
+  },
+  props: {
+    list_id: Property.ShortText({
+      displayName: 'List ID',
+      description: 'The ID of the list. Obtain it from List Lists.',
+      required: true,
+    }),
+  },
+
+  async run(context) {
+    try {
+      const request: HttpRequest = {
+        method: HttpMethod.GET,
+        url: `${trelloCommon.baseUrl}lists/${context.propsValue['list_id']}`,
+        headers: { Accept: 'application/json' },
+        queryParams: withAuthParams(context.auth),
+      };
+      const response = await httpClient.sendRequest(request);
+      return response.body;
+    } catch (error: any) {
+      rethrowTrelloError(
+        error,
+        'List not found. Verify the list_id (resolve it via List Lists).'
+      );
+    }
+  },
+});

package/src/lib/actions/ai/get-member.ts

@@ -0,0 +1,50 @@
+import { createAction, Property } from '@agnocon/pieces-framework';
+import {
+  httpClient,
+  HttpRequest,
+  HttpMethod,
+} from '@agnocon/pieces-common';
+import { trelloCommon } from '../../common';
+import { trelloAuth } from '../../..';
+import { withAuthParams, rethrowTrelloError } from './ai-common';
+import { getMemberActionOutputSchema } from '../../output-schemas';
+
+export const getMember = createAction({
+  auth: trelloAuth,
+  name: 'get_member',
+  displayName: 'Get Member (Agent)',
+  description: 'Get a Trello member by id or username.',
+  audience: 'ai',
+  outputSchema: getMemberActionOutputSchema,
+  aiMetadata: {
+    description:
+      'Retrieves a Trello member profile by member id or username. Obtain a member id from Search Members or List Board Members. Read-only and idempotent.',
+    idempotent: true,
+  },
+  props: {
+    member_id: Property.ShortText({
+      displayName: 'Member ID or Username',
+      description:
+        'The member id or username. Obtain it from Search Members or List Board Members.',
+      required: true,
+    }),
+  },
+
+  async run(context) {
+    try {
+      const request: HttpRequest = {
+        method: HttpMethod.GET,
+        url: `${trelloCommon.baseUrl}members/${context.propsValue['member_id']}`,
+        headers: { Accept: 'application/json' },
+        queryParams: withAuthParams(context.auth),
+      };
+      const response = await httpClient.sendRequest(request);
+      return response.body;
+    } catch (error: any) {
+      rethrowTrelloError(
+        error,
+        'Member not found. Verify the member id or username (resolve it via Search Members).'
+      );
+    }
+  },
+});

package/src/lib/actions/ai/get-my-member.ts

@@ -0,0 +1,43 @@
+import { createAction } from '@agnocon/pieces-framework';
+import {
+  httpClient,
+  HttpRequest,
+  HttpMethod,
+} from '@agnocon/pieces-common';
+import { trelloCommon } from '../../common';
+import { trelloAuth } from '../../..';
+import { withAuthParams, rethrowTrelloError } from './ai-common';
+import { getMyMemberActionOutputSchema } from '../../output-schemas';
+
+export const getMyMember = createAction({
+  auth: trelloAuth,
+  name: 'get_my_member',
+  displayName: 'Get My Member (Agent)',
+  description: 'Get the connected Trello user.',
+  audience: 'ai',
+  outputSchema: getMyMemberActionOutputSchema,
+  aiMetadata: {
+    description:
+      'Returns the connected Trello user (id, username, full name). Use it to resolve "me" — your own member id — for assigning yourself to cards or as the member filter in List Boards. Takes no inputs. Read-only and idempotent.',
+    idempotent: true,
+  },
+  props: {},
+
+  async run(context) {
+    try {
+      const request: HttpRequest = {
+        method: HttpMethod.GET,
+        url: `${trelloCommon.baseUrl}members/me`,
+        headers: { Accept: 'application/json' },
+        queryParams: withAuthParams(context.auth),
+      };
+      const response = await httpClient.sendRequest(request);
+      return response.body;
+    } catch (error: any) {
+      rethrowTrelloError(
+        error,
+        'Could not resolve the connected user. Check the connection token.'
+      );
+    }
+  },
+});

package/src/lib/actions/ai/list-board-labels.ts

@@ -0,0 +1,62 @@
+import { createAction, Property } from '@agnocon/pieces-framework';
+import {
+  httpClient,
+  HttpRequest,
+  HttpMethod,
+  QueryParams,
+} from '@agnocon/pieces-common';
+import { trelloCommon } from '../../common';
+import { trelloAuth } from '../../..';
+import { withAuthParams, rethrowTrelloError } from './ai-common';
+import { listBoardLabelsActionOutputSchema } from '../../output-schemas';
+
+export const listBoardLabels = createAction({
+  auth: trelloAuth,
+  name: 'list_board_labels',
+  displayName: 'List Board Labels (Agent)',
+  description: "List a board's labels.",
+  audience: 'ai',
+  outputSchema: listBoardLabelsActionOutputSchema,
+  aiMetadata: {
+    description:
+      "Lists the labels defined on a Trello board, returning each label id, name, and color. Use it to resolve a label_id for Add Label To Card / Remove Label From Card. Obtain board_id from List Boards. Read-only and idempotent.",
+    idempotent: true,
+  },
+  props: {
+    board_id: Property.ShortText({
+      displayName: 'Board ID',
+      description: 'The ID of the board. Obtain it from List Boards.',
+      required: true,
+    }),
+    limit: Property.Number({
+      displayName: 'Limit',
+      description: 'Maximum number of labels to return (1-1000, default 50).',
+      required: false,
+    }),
+  },
+
+  async run(context) {
+    const params: QueryParams = {};
+    if (context.propsValue['limit']) {
+      params['limit'] = String(context.propsValue['limit']);
+    }
+    try {
+      const request: HttpRequest = {
+        method: HttpMethod.GET,
+        url: `${trelloCommon.baseUrl}boards/${context.propsValue['board_id']}/labels`,
+        headers: { Accept: 'application/json' },
+        queryParams: withAuthParams(context.auth, params),
+      };
+      const response = await httpClient.sendRequest<
+        Array<Record<string, unknown>>
+      >(request);
+      const labels = response.body ?? [];
+      return { labels, count: labels.length };
+    } catch (error: any) {
+      rethrowTrelloError(
+        error,
+        'Board not found. Verify the board_id (resolve it via List Boards).'
+      );
+    }
+  },
+});

package/src/lib/actions/ai/list-board-members.ts

@@ -0,0 +1,52 @@
+import { createAction, Property } from '@agnocon/pieces-framework';
+import {
+  httpClient,
+  HttpRequest,
+  HttpMethod,
+} from '@agnocon/pieces-common';
+import { trelloCommon } from '../../common';
+import { trelloAuth } from '../../..';
+import { withAuthParams, rethrowTrelloError } from './ai-common';
+import { listBoardMembersActionOutputSchema } from '../../output-schemas';
+
+export const listBoardMembers = createAction({
+  auth: trelloAuth,
+  name: 'list_board_members',
+  displayName: 'List Board Members (Agent)',
+  description: 'List the members of a Trello board.',
+  audience: 'ai',
+  outputSchema: listBoardMembersActionOutputSchema,
+  aiMetadata: {
+    description:
+      'Lists the members of a Trello board, returning each member id, username, and full name. Use it to resolve a member_id for card assignment (Add Member To Card) or board removal. Obtain board_id from List Boards. Read-only and idempotent.',
+    idempotent: true,
+  },
+  props: {
+    board_id: Property.ShortText({
+      displayName: 'Board ID',
+      description: 'The ID of the board. Obtain it from List Boards.',
+      required: true,
+    }),
+  },
+
+  async run(context) {
+    try {
+      const request: HttpRequest = {
+        method: HttpMethod.GET,
+        url: `${trelloCommon.baseUrl}boards/${context.propsValue['board_id']}/members`,
+        headers: { Accept: 'application/json' },
+        queryParams: withAuthParams(context.auth),
+      };
+      const response = await httpClient.sendRequest<
+        Array<Record<string, unknown>>
+      >(request);
+      const members = response.body ?? [];
+      return { members, count: members.length };
+    } catch (error: any) {
+      rethrowTrelloError(
+        error,
+        'Board not found. Verify the board_id (resolve it via List Boards).'
+      );
+    }
+  },
+});

package/src/lib/actions/ai/list-boards.ts

@@ -0,0 +1,71 @@
+import { createAction, Property } from '@agnocon/pieces-framework';
+import {
+  httpClient,
+  HttpRequest,
+  HttpMethod,
+  QueryParams,
+} from '@agnocon/pieces-common';
+import { trelloCommon } from '../../common';
+import { trelloAuth } from '../../..';
+import { withAuthParams, rethrowTrelloError } from './ai-common';
+import { listBoardsActionOutputSchema } from '../../output-schemas';
+
+export const listBoards = createAction({
+  auth: trelloAuth,
+  name: 'list_boards',
+  displayName: 'List Boards (Agent)',
+  description: 'List the Trello boards you can access.',
+  audience: 'ai',
+  outputSchema: listBoardsActionOutputSchema,
+  aiMetadata: {
+    description:
+      'Lists the Trello boards the connected user can access, returning each board id and name. This is the top-level resolver: start here to get a board_id, then use List Lists / List Board Labels / List Board Members to drill down. Defaults to the connected user (member "me"). Read-only and idempotent.',
+    idempotent: true,
+  },
+  props: {
+    member_id: Property.ShortText({
+      displayName: 'Member ID',
+      description:
+        'Whose boards to list. Defaults to the connected user ("me"). Obtain another member id from Search Members.',
+      required: false,
+    }),
+    filter: Property.StaticDropdown({
+      displayName: 'Filter',
+      description: 'Which boards to include.',
+      required: false,
+      options: {
+        options: [
+          { label: 'Open', value: 'open' },
+          { label: 'Closed', value: 'closed' },
+          { label: 'All', value: 'all' },
+        ],
+      },
+    }),
+  },
+
+  async run(context) {
+    const memberId = (context.propsValue['member_id'] as string) || 'me';
+    const params: QueryParams = {};
+    if (context.propsValue['filter']) {
+      params['filter'] = context.propsValue['filter'] as string;
+    }
+    try {
+      const request: HttpRequest = {
+        method: HttpMethod.GET,
+        url: `${trelloCommon.baseUrl}members/${memberId}/boards`,
+        headers: { Accept: 'application/json' },
+        queryParams: withAuthParams(context.auth, params),
+      };
+      const response = await httpClient.sendRequest<
+        Array<Record<string, unknown>>
+      >(request);
+      const boards = response.body ?? [];
+      return { boards, count: boards.length };
+    } catch (error: any) {
+      rethrowTrelloError(
+        error,
+        'Member not found. Verify the member_id, or omit it to list your own boards.'
+      );
+    }
+  },
+});

package/src/lib/actions/ai/list-card-attachments-ai.ts

@@ -0,0 +1,66 @@
+import { createAction, Property } from '@agnocon/pieces-framework';
+import {
+  httpClient,
+  HttpRequest,
+  HttpMethod,
+} from '@agnocon/pieces-common';
+import { trelloCommon } from '../../common';
+import { trelloAuth } from '../../..';
+import { listCardAttachmentsAiActionOutputSchema } from '../../output-schemas';
+
+export const listCardAttachmentsAi = createAction({
+  auth: trelloAuth,
+  name: 'list_card_attachments_ai',
+  displayName: 'List Card Attachments (Agent)',
+  description: 'List all attachments on a Trello card.',
+  audience: 'ai',
+  outputSchema: listCardAttachmentsAiActionOutputSchema,
+  aiMetadata: {
+    description:
+      'Lists all attachments on a Trello card identified by card_id, returning each attachment id, name, and url. Use it to find an attachment id before fetching or deleting it. Obtain card_id from Search Cards. Read-only and idempotent.',
+    idempotent: true,
+  },
+  props: {
+    card_id: Property.ShortText({
+      displayName: 'Card ID',
+      description:
+        'The ID of the card to list attachments for. Obtain it from Search Cards.',
+      required: true,
+    }),
+  },
+
+  async run(context) {
+    try {
+      const request: HttpRequest = {
+        method: HttpMethod.GET,
+        url:
+          `${trelloCommon.baseUrl}cards/${context.propsValue['card_id']}/attachments` +
+          `?key=` +
+          context.auth.username +
+          `&token=` +
+          context.auth.password,
+        headers: {
+          Accept: 'application/json',
+        },
+      };
+      const response = await httpClient.sendRequest(request);
+      return response.body;
+    } catch (error: any) {
+      const status = error?.response?.status;
+      if (status === 401 || status === 403) {
+        throw new Error(
+          'Permission denied reading attachments. Check the connection token and your access to the board.'
+        );
+      }
+      if (status === 404) {
+        throw new Error(
+          'Card not found. Verify the card_id (resolve it via Search Cards).'
+        );
+      }
+      if (status === 429) {
+        throw new Error('Trello rate limit exceeded. Retry after a short delay.');
+      }
+      throw error;
+    }
+  },
+});

package/src/lib/actions/ai/list-card-checklists.ts

@@ -0,0 +1,52 @@
+import { createAction, Property } from '@agnocon/pieces-framework';
+import {
+  httpClient,
+  HttpRequest,
+  HttpMethod,
+} from '@agnocon/pieces-common';
+import { trelloCommon } from '../../common';
+import { trelloAuth } from '../../..';
+import { withAuthParams, rethrowTrelloError } from './ai-common';
+import { listCardChecklistsActionOutputSchema } from '../../output-schemas';
+
+export const listCardChecklists = createAction({
+  auth: trelloAuth,
+  name: 'list_card_checklists',
+  displayName: 'List Card Checklists (Agent)',
+  description: "List a card's checklists and their items.",
+  audience: 'ai',
+  outputSchema: listCardChecklistsActionOutputSchema,
+  aiMetadata: {
+    description:
+      "Lists the checklists on a Trello card, each with its idChecklist and its check items (idCheckItem, name, state). This is the source for the ids needed by Set Checklist Item State, Add Checklist Item, Delete Checklist, and Delete Checklist Item. Obtain card_id from Search Cards. Read-only and idempotent.",
+    idempotent: true,
+  },
+  props: {
+    card_id: Property.ShortText({
+      displayName: 'Card ID',
+      description: 'The ID of the card. Obtain it from Search Cards.',
+      required: true,
+    }),
+  },
+
+  async run(context) {
+    try {
+      const request: HttpRequest = {
+        method: HttpMethod.GET,
+        url: `${trelloCommon.baseUrl}cards/${context.propsValue['card_id']}/checklists`,
+        headers: { Accept: 'application/json' },
+        queryParams: withAuthParams(context.auth, { checkItems: 'all' }),
+      };
+      const response = await httpClient.sendRequest<
+        Array<Record<string, unknown>>
+      >(request);
+      const checklists = response.body ?? [];
+      return { checklists, count: checklists.length };
+    } catch (error: any) {
+      rethrowTrelloError(
+        error,
+        'Card not found. Verify the card_id (resolve it via Search Cards).'
+      );
+    }
+  },
+});

package/src/lib/actions/ai/list-card-comments.ts

@@ -0,0 +1,62 @@
+import { createAction, Property } from '@agnocon/pieces-framework';
+import {
+  httpClient,
+  HttpRequest,
+  HttpMethod,
+  QueryParams,
+} from '@agnocon/pieces-common';
+import { trelloCommon } from '../../common';
+import { trelloAuth } from '../../..';
+import { withAuthParams, rethrowTrelloError } from './ai-common';
+import { listCardCommentsActionOutputSchema } from '../../output-schemas';
+
+export const listCardComments = createAction({
+  auth: trelloAuth,
+  name: 'list_card_comments',
+  displayName: 'List Card Comments (Agent)',
+  description: "Read a card's comment history.",
+  audience: 'ai',
+  outputSchema: listCardCommentsActionOutputSchema,
+  aiMetadata: {
+    description:
+      "Lists the comments on a Trello card identified by card_id, returning each comment's id (idAction), text, author, and date. Use the returned comment id with Update Comment / Delete Comment. Obtain card_id from Search Cards. Read-only and idempotent.",
+    idempotent: true,
+  },
+  props: {
+    card_id: Property.ShortText({
+      displayName: 'Card ID',
+      description: 'The ID of the card. Obtain it from Search Cards.',
+      required: true,
+    }),
+    limit: Property.Number({
+      displayName: 'Limit',
+      description: 'Maximum number of comments to return (1-1000, default 50).',
+      required: false,
+    }),
+  },
+
+  async run(context) {
+    const params: QueryParams = { filter: 'commentCard' };
+    if (context.propsValue['limit']) {
+      params['limit'] = String(context.propsValue['limit']);
+    }
+    try {
+      const request: HttpRequest = {
+        method: HttpMethod.GET,
+        url: `${trelloCommon.baseUrl}cards/${context.propsValue['card_id']}/actions`,
+        headers: { Accept: 'application/json' },
+        queryParams: withAuthParams(context.auth, params),
+      };
+      const response = await httpClient.sendRequest<
+        Array<Record<string, unknown>>
+      >(request);
+      const comments = response.body ?? [];
+      return { comments, count: comments.length };
+    } catch (error: any) {
+      rethrowTrelloError(
+        error,
+        'Card not found. Verify the card_id (resolve it via Search Cards).'
+      );
+    }
+  },
+});

package/src/lib/actions/ai/list-card-members.ts

@@ -0,0 +1,52 @@
+import { createAction, Property } from '@agnocon/pieces-framework';
+import {
+  httpClient,
+  HttpRequest,
+  HttpMethod,
+} from '@agnocon/pieces-common';
+import { trelloCommon } from '../../common';
+import { trelloAuth } from '../../..';
+import { withAuthParams, rethrowTrelloError } from './ai-common';
+import { listCardMembersActionOutputSchema } from '../../output-schemas';
+
+export const listCardMembers = createAction({
+  auth: trelloAuth,
+  name: 'list_card_members',
+  displayName: 'List Card Members (Agent)',
+  description: 'List the members assigned to a Trello card.',
+  audience: 'ai',
+  outputSchema: listCardMembersActionOutputSchema,
+  aiMetadata: {
+    description:
+      'Lists the members currently assigned to a Trello card, returning each member id and username. Use it to see who is on a card or to get a member_id for Remove Member From Card. Obtain card_id from Search Cards. Read-only and idempotent.',
+    idempotent: true,
+  },
+  props: {
+    card_id: Property.ShortText({
+      displayName: 'Card ID',
+      description: 'The ID of the card. Obtain it from Search Cards.',
+      required: true,
+    }),
+  },
+
+  async run(context) {
+    try {
+      const request: HttpRequest = {
+        method: HttpMethod.GET,
+        url: `${trelloCommon.baseUrl}cards/${context.propsValue['card_id']}/members`,
+        headers: { Accept: 'application/json' },
+        queryParams: withAuthParams(context.auth),
+      };
+      const response = await httpClient.sendRequest<
+        Array<Record<string, unknown>>
+      >(request);
+      const members = response.body ?? [];
+      return { members, count: members.length };
+    } catch (error: any) {
+      rethrowTrelloError(
+        error,
+        'Card not found. Verify the card_id (resolve it via Search Cards).'
+      );
+    }
+  },
+});