@divyacon/piece-trello 0.0.0-stage → 0.1.0

package/src/lib/actions/ai/search-members.ts

@@ -0,0 +1,75 @@
+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 { searchMembersActionOutputSchema } from '../../output-schemas';
+
+export const searchMembers = createAction({
+  auth: trelloAuth,
+  name: 'search_members',
+  displayName: 'Search Members (Agent)',
+  description: 'Find Trello members by name or username.',
+  audience: 'ai',
+  outputSchema: searchMembersActionOutputSchema,
+  aiMetadata: {
+    description:
+      'Searches Trello members by name or username and returns matches with their member ids. Use it to resolve a person to a member_id before assigning them with Add Member To Card. Optionally restrict to a board or to organization members. Read-only and idempotent.',
+    idempotent: true,
+  },
+  props: {
+    query: Property.ShortText({
+      displayName: 'Query',
+      description: 'Name or username to search for.',
+      required: true,
+    }),
+    board_id: Property.ShortText({
+      displayName: 'Board ID',
+      description: 'Restrict the search to members of this board (optional).',
+      required: false,
+    }),
+    only_org_members: Property.Checkbox({
+      displayName: 'Only Organization Members',
+      required: false,
+    }),
+    limit: Property.Number({
+      displayName: 'Limit',
+      description: 'Maximum number of members to return (1-20, default 8).',
+      required: false,
+    }),
+  },
+
+  async run(context) {
+    const params: QueryParams = { query: context.propsValue['query'] };
+    if (context.propsValue['board_id']) {
+      params['idBoard'] = context.propsValue['board_id'] as string;
+    }
+    if (context.propsValue['only_org_members']) {
+      params['onlyOrgMembers'] = 'true';
+    }
+    if (context.propsValue['limit']) {
+      params['limit'] = String(context.propsValue['limit']);
+    }
+
+    try {
+      const request: HttpRequest = {
+        method: HttpMethod.GET,
+        url: `${trelloCommon.baseUrl}search/members`,
+        headers: { Accept: 'application/json' },
+        queryParams: withAuthParams(context.auth, params),
+      };
+      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.');
+    }
+  },
+});

package/src/lib/actions/ai/set-checklist-item-state.ts

@@ -0,0 +1,73 @@
+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 { setChecklistItemStateActionOutputSchema } from '../../output-schemas';
+
+export const setChecklistItemState = createAction({
+  auth: trelloAuth,
+  name: 'set_checklist_item_state',
+  displayName: 'Set Checklist Item State (Agent)',
+  description: 'Check or uncheck a checklist item.',
+  audience: 'ai',
+  outputSchema: setChecklistItemStateActionOutputSchema,
+  aiMetadata: {
+    description:
+      'Marks a checklist item complete or incomplete. This needs three ids that all come from List Card Checklists for the card: card_id, checklist_id (idChecklist), and checkitem_id (idCheckItem). Setting the same state again converges, so it is idempotent.',
+    idempotent: true,
+  },
+  props: {
+    card_id: Property.ShortText({
+      displayName: 'Card ID',
+      description: 'The ID of the card. Obtain it from Search Cards.',
+      required: true,
+    }),
+    checklist_id: Property.ShortText({
+      displayName: 'Checklist ID',
+      description:
+        'The checklist id (idChecklist). Obtain it from List Card Checklists.',
+      required: true,
+    }),
+    checkitem_id: Property.ShortText({
+      displayName: 'Check Item ID',
+      description:
+        'The check item id (idCheckItem). Obtain it from List Card Checklists.',
+      required: true,
+    }),
+    state: Property.StaticDropdown({
+      displayName: 'State',
+      required: true,
+      options: {
+        options: [
+          { label: 'Complete', value: 'complete' },
+          { label: 'Incomplete', value: 'incomplete' },
+        ],
+      },
+    }),
+  },
+
+  async run(context) {
+    try {
+      const request: HttpRequest = {
+        method: HttpMethod.PUT,
+        url: `${trelloCommon.baseUrl}cards/${context.propsValue['card_id']}/checklist/${context.propsValue['checklist_id']}/checkItem/${context.propsValue['checkitem_id']}/state`,
+        headers: { Accept: 'application/json' },
+        queryParams: withAuthParams(context.auth, {
+          value: context.propsValue['state'],
+        }),
+      };
+      const response = await httpClient.sendRequest(request);
+      return response.body;
+    } catch (error: any) {
+      rethrowTrelloError(
+        error,
+        'Card, checklist, or check item not found. Verify all three ids via List Card Checklists.'
+      );
+    }
+  },
+});

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

@@ -0,0 +1,65 @@
+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 { updateBoardActionOutputSchema } from '../../output-schemas';
+
+export const updateBoard = createAction({
+  auth: trelloAuth,
+  name: 'update_board',
+  displayName: 'Update Board (Agent)',
+  description: 'Rename or redescribe a Trello board.',
+  audience: 'ai',
+  outputSchema: updateBoardActionOutputSchema,
+  aiMetadata: {
+    description:
+      'Updates the name and/or description of a Trello board identified by board_id. Obtain board_id from List Boards. Only provided fields change; setting the same values again converges to the same board, so it is idempotent.',
+    idempotent: true,
+  },
+  props: {
+    board_id: Property.ShortText({
+      displayName: 'Board ID',
+      description: 'The ID of the board. Obtain it from List Boards.',
+      required: true,
+    }),
+    name: Property.ShortText({
+      displayName: 'New Name',
+      required: false,
+    }),
+    description: Property.LongText({
+      displayName: 'New Description',
+      required: false,
+    }),
+  },
+
+  async run(context) {
+    const params: QueryParams = {};
+    if (context.propsValue['name']) {
+      params['name'] = context.propsValue['name'] as string;
+    }
+    if (context.propsValue['description']) {
+      params['desc'] = context.propsValue['description'] as string;
+    }
+    try {
+      const request: HttpRequest = {
+        method: HttpMethod.PUT,
+        url: `${trelloCommon.baseUrl}boards/${context.propsValue['board_id']}`,
+        headers: { Accept: 'application/json' },
+        queryParams: withAuthParams(context.auth, params),
+      };
+      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/update-card-ai.ts

@@ -0,0 +1,136 @@
+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 { updateCardAiActionOutputSchema } from '../../output-schemas';
+
+export const updateCardAi = createAction({
+  auth: trelloAuth,
+  name: 'update_card_ai',
+  displayName: 'Update Card (Agent)',
+  description: 'Update fields on an existing Trello card.',
+  audience: 'ai',
+  outputSchema: updateCardAiActionOutputSchema,
+  aiMetadata: {
+    description:
+      'Updates fields on an existing Trello card identified by card_id: name, description, due date, label ids, position, archived (closed) state, and target list_id (to move it). This is the broad editor; for a single high-intent change prefer Move Card or Archive Card. Obtain card_id from Search Cards and list_id from List Lists. Only provided fields change; repeating with the same inputs converges to the same card state.',
+    idempotent: true,
+  },
+  props: {
+    card_id: Property.ShortText({
+      displayName: 'Card ID',
+      description: 'The ID of the card to update. Obtain it from Search Cards.',
+      required: true,
+    }),
+    name: Property.ShortText({
+      displayName: 'Card Name',
+      description: 'The new name of the card.',
+      required: false,
+    }),
+    description: Property.LongText({
+      displayName: 'Card Description',
+      description: 'The new description of the card.',
+      required: false,
+    }),
+    list_id: Property.ShortText({
+      displayName: 'List ID',
+      description:
+        'Move the card to this list. Obtain the list id from List Lists.',
+      required: false,
+    }),
+    position: Property.StaticDropdown({
+      displayName: 'Position',
+      description: 'Move the card to a new position.',
+      required: false,
+      options: {
+        options: [
+          { label: 'Top', value: 'top' },
+          { label: 'Bottom', value: 'bottom' },
+        ],
+      },
+    }),
+    labels: Property.Array({
+      displayName: 'Label IDs',
+      description:
+        'Replace the card label set with these label ids. Obtain them from List Board Labels.',
+      required: false,
+    }),
+    closed: Property.Checkbox({
+      displayName: 'Archived',
+      description: 'Archive (true) or unarchive (false) the card.',
+      required: false,
+    }),
+    due: Property.DateTime({
+      displayName: 'Due Date',
+      description: 'Set a due date for the card.',
+      required: false,
+    }),
+  },
+
+  async run(context) {
+    const body: Record<string, unknown> = {};
+
+    if (context.propsValue['name']) {
+      body['name'] = context.propsValue['name'];
+    }
+    if (context.propsValue['description']) {
+      body['desc'] = context.propsValue['description'];
+    }
+    if (context.propsValue['list_id']) {
+      body['idList'] = context.propsValue['list_id'];
+    }
+    if (context.propsValue['position']) {
+      body['pos'] = context.propsValue['position'];
+    }
+    if (context.propsValue['labels']) {
+      body['idLabels'] = context.propsValue['labels'] as string[];
+    }
+    if (context.propsValue['closed'] !== undefined) {
+      body['closed'] = context.propsValue['closed'];
+    }
+    if (context.propsValue['due']) {
+      body['due'] = context.propsValue['due'];
+    }
+
+    try {
+      const request: HttpRequest = {
+        method: HttpMethod.PUT,
+        url:
+          `${trelloCommon.baseUrl}cards/${context.propsValue['card_id']}` +
+          `?key=` +
+          context.auth.username +
+          `&token=` +
+          context.auth.password,
+        headers: {
+          Accept: 'application/json',
+          'Content-Type': 'application/json',
+        },
+        body,
+        queryParams: {},
+      };
+      const response = await httpClient.sendRequest<TrelloCard>(request);
+      return response.body;
+    } catch (error: any) {
+      const status = error?.response?.status;
+      if (status === 401 || status === 403) {
+        throw new Error(
+          'Permission denied updating the card. Check the connection token and your write access.'
+        );
+      }
+      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/update-comment.ts

@@ -0,0 +1,61 @@
+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 { updateCommentActionOutputSchema } from '../../output-schemas';
+
+export const updateComment = createAction({
+  auth: trelloAuth,
+  name: 'update_comment',
+  displayName: 'Update Comment (Agent)',
+  description: 'Edit an existing comment on a Trello card.',
+  audience: 'ai',
+  outputSchema: updateCommentActionOutputSchema,
+  aiMetadata: {
+    description:
+      'Edits the text of an existing comment on a Trello card, identified by card_id and comment_id (the action id). Obtain card_id from Search Cards and comment_id from List Card Comments. Setting the same text again converges to the same comment, so it is idempotent.',
+    idempotent: true,
+  },
+  props: {
+    card_id: Property.ShortText({
+      displayName: 'Card ID',
+      description: 'The ID of the card. Obtain it from Search Cards.',
+      required: true,
+    }),
+    comment_id: Property.ShortText({
+      displayName: 'Comment ID',
+      description:
+        'The comment (action) id. Obtain it from List Card Comments.',
+      required: true,
+    }),
+    text: Property.LongText({
+      displayName: 'New Comment Text',
+      required: true,
+    }),
+  },
+
+  async run(context) {
+    try {
+      const request: HttpRequest = {
+        method: HttpMethod.PUT,
+        url: `${trelloCommon.baseUrl}cards/${context.propsValue['card_id']}/actions/${context.propsValue['comment_id']}/comments`,
+        headers: { Accept: 'application/json' },
+        queryParams: withAuthParams(context.auth, {
+          text: context.propsValue['text'],
+        }),
+      };
+      const response = await httpClient.sendRequest(request);
+      return response.body;
+    } catch (error: any) {
+      rethrowTrelloError(
+        error,
+        'Card or comment not found. Verify the card_id and comment_id (resolve via List Card Comments).'
+      );
+    }
+  },
+});

package/src/lib/actions/ai/update-label.ts

@@ -0,0 +1,67 @@
+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 { updateLabelActionOutputSchema } from '../../output-schemas';
+
+export const updateLabel = createAction({
+  auth: trelloAuth,
+  name: 'update_label',
+  displayName: 'Update Label (Agent)',
+  description: 'Rename or recolor a Trello label.',
+  audience: 'ai',
+  outputSchema: updateLabelActionOutputSchema,
+  aiMetadata: {
+    description:
+      'Renames or recolors an existing Trello label identified by label_id. Obtain label_id from List Board Labels. Only provided fields change; setting the same values again converges to the same label, so it is idempotent.',
+    idempotent: true,
+  },
+  props: {
+    label_id: Property.ShortText({
+      displayName: 'Label ID',
+      description: 'The ID of the label. Obtain it from List Board Labels.',
+      required: true,
+    }),
+    name: Property.ShortText({
+      displayName: 'New Name',
+      required: false,
+    }),
+    color: Property.ShortText({
+      displayName: 'New Color',
+      description:
+        'New label color (e.g. green, yellow, orange, red, purple, blue, sky, lime, pink, black).',
+      required: false,
+    }),
+  },
+
+  async run(context) {
+    const params: QueryParams = {};
+    if (context.propsValue['name']) {
+      params['name'] = context.propsValue['name'] as string;
+    }
+    if (context.propsValue['color']) {
+      params['color'] = context.propsValue['color'] as string;
+    }
+    try {
+      const request: HttpRequest = {
+        method: HttpMethod.PUT,
+        url: `${trelloCommon.baseUrl}labels/${context.propsValue['label_id']}`,
+        headers: { Accept: 'application/json' },
+        queryParams: withAuthParams(context.auth, params),
+      };
+      const response = await httpClient.sendRequest(request);
+      return response.body;
+    } catch (error: any) {
+      rethrowTrelloError(
+        error,
+        'Label not found. Verify the label_id (resolve it via List Board Labels).'
+      );
+    }
+  },
+});

package/src/lib/actions/card/create-card.ts

@@ -0,0 +1,73 @@
+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 { createCardActionOutputSchema } from '../../output-schemas';
+
+export const createCard = createAction({
+  auth: trelloAuth,
+  name: 'create_card',
+  displayName: 'Create Card',
+  description: 'Create a new card in Trello',
+  audience: 'human',
+  outputSchema: createCardActionOutputSchema,
+  aiMetadata: { description: 'Creates a new Trello card in a specific list, optionally with a description, position, and labels. Use to add a task or item to a board. Requires the target list_id (and the board_id it belongs to); each call creates a distinct card, so it is not idempotent.', idempotent: false },
+  props: {
+    board_id: trelloCommon.board_id,
+    list_id: trelloCommon.list_id,
+    name: Property.ShortText({
+      description: 'The name of the card to create',
+      displayName: 'Task Name',
+      required: true,
+    }),
+    description: Property.LongText({
+      description: 'The description of the card to create',
+      displayName: 'Task Description',
+      required: false,
+    }),
+    position: Property.StaticDropdown({
+      description: 'Place the card on top or bottom of the list',
+      displayName: 'Position',
+      required: false,
+      options: {
+        options: [
+          { label: 'Top', value: 'top' },
+          { label: 'Bottom', value: 'bottom' },
+        ],
+      },
+    }),
+    labels: trelloCommon.board_labels,
+  },
+
+  async run(context) {
+    const request: HttpRequest = {
+      method: HttpMethod.POST,
+      url:
+        `${trelloCommon.baseUrl}cards` +
+        `?idList=` +
+        context.propsValue['list_id'] +
+        `&key=` +
+        context.auth.username +
+        `&token=` +
+        context.auth.password,
+      headers: {
+        Accept: 'application/json',
+      },
+      body: {
+        name: context.propsValue['name'],
+        desc: context.propsValue['description'],
+        pos: context.propsValue['position'],
+        idLabels: context.propsValue['labels'],
+      },
+      queryParams: {},
+    };
+    const response = await httpClient.sendRequest<TrelloCard>(request);
+
+    return response.body;
+  },
+});

package/src/lib/actions/card/delete-card.ts

@@ -0,0 +1,44 @@
+import { createAction, Property } from '@agnocon/pieces-framework';
+import {
+  httpClient,
+  HttpRequest,
+  HttpMethod,
+} from '@agnocon/pieces-common';
+import { trelloCommon } from '../../common';
+import { trelloAuth } from '../../..';
+
+export const deleteCard = createAction({
+  auth: trelloAuth,
+  name: 'delete_card',
+  displayName: 'Delete Card',
+  description: 'Deletes an existing card.',
+  audience: 'human',
+  aiMetadata: { description: 'Permanently deletes a Trello card by its card_id. Use to remove a card entirely (this is irreversible, unlike archiving via Update Card with closed=true). Requires card_id; deleting the same id again returns an error once it no longer exists.', idempotent: false },
+  props: {
+    card_id: Property.ShortText({
+      description: 'The ID of the card to delete.',
+      displayName: 'Card ID',
+      required: true,
+    }),
+  },
+
+  async run(context) {
+    const request: HttpRequest = {
+      method: HttpMethod.DELETE,
+      url:
+        `${trelloCommon.baseUrl}cards/${context.propsValue['card_id']}` +
+        `?key=` +
+        context.auth.username +
+        `&token=` +
+        context.auth.password,
+      headers: {
+        Accept: 'application/json',
+      },
+      queryParams: {},
+    };
+    
+    const response = await httpClient.sendRequest(request);
+
+    return response.body;
+  },
+});

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

@@ -0,0 +1,44 @@
+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 { getCardActionOutputSchema } from '../../output-schemas';
+
+export const getCard = createAction({
+  auth: trelloAuth,
+  name: 'get_card',
+  displayName: 'Get Card',
+  description: 'Gets a card by ID.',
+  audience: 'human',
+  outputSchema: getCardActionOutputSchema,
+  aiMetadata: { description: 'Retrieves the full details of a single Trello card by its card ID. Use to look up the current name, description, due date, labels, list, and other fields of a card before acting on it. Read-only and idempotent.', idempotent: true },
+  props: {
+    cardId: Property.ShortText({
+      description: 'The card ID',
+      displayName: 'Card ID',
+      required: true,
+    }),
+  },
+
+  async run(context) {
+    const request: HttpRequest = {
+      method: HttpMethod.GET,
+      url:
+        `${trelloCommon.baseUrl}cards/` +
+        context.propsValue['cardId'] +
+        `?key=` +
+        context.auth.username +
+        `&token=` +
+        context.auth.password,
+      headers: {
+        Accept: 'application/json',
+      },
+    };
+    return (await httpClient.sendRequest<TrelloCard>(request)).body;
+  },
+});