veryfront 0.0.49 → 0.0.51

package/dist/integrations/trello/connector.json

@@ -0,0 +1,85 @@
+{
+  "name": "trello",
+  "displayName": "Trello",
+  "icon": "trello.svg",
+  "description": "Manage boards, lists, and cards in Trello",
+  "auth": {
+    "type": "oauth2",
+    "provider": "trello",
+    "authorizationUrl": "https://trello.com/1/authorize",
+    "tokenUrl": "https://trello.com/1/OAuthGetAccessToken",
+    "scopes": ["read", "write"],
+    "callbackPath": "/api/auth/trello/callback",
+    "requiredApis": [
+      {
+        "name": "Trello Developer Portal",
+        "enableUrl": "https://trello.com/app-key"
+      }
+    ]
+  },
+  "envVars": [
+    {
+      "name": "TRELLO_CLIENT_ID",
+      "description": "Trello API Key",
+      "required": true,
+      "sensitive": false,
+      "docsUrl": "https://developer.atlassian.com/cloud/trello/guides/rest-api/authorization/"
+    },
+    {
+      "name": "TRELLO_CLIENT_SECRET",
+      "description": "Trello OAuth Secret",
+      "required": true,
+      "sensitive": true,
+      "docsUrl": "https://developer.atlassian.com/cloud/trello/guides/rest-api/authorization/"
+    }
+  ],
+  "tools": [
+    {
+      "id": "list-boards",
+      "name": "List Boards",
+      "description": "List all boards accessible to the user",
+      "requiresWrite": false
+    },
+    {
+      "id": "list-cards",
+      "name": "List Cards",
+      "description": "List cards in a board or list",
+      "requiresWrite": false
+    },
+    {
+      "id": "get-card",
+      "name": "Get Card",
+      "description": "Get details of a specific card",
+      "requiresWrite": false
+    },
+    {
+      "id": "create-card",
+      "name": "Create Card",
+      "description": "Create a new card in a list",
+      "requiresWrite": true
+    },
+    {
+      "id": "update-card",
+      "name": "Update Card",
+      "description": "Update an existing card",
+      "requiresWrite": true
+    }
+  ],
+  "prompts": [
+    {
+      "id": "my-boards",
+      "title": "Show my boards",
+      "prompt": "List all my Trello boards with their lists and card counts.",
+      "category": "productivity",
+      "icon": "grid"
+    },
+    {
+      "id": "create-card",
+      "title": "Create a card",
+      "prompt": "Create a new card with a title, description, and due date.",
+      "category": "productivity",
+      "icon": "plus"
+    }
+  ],
+  "suggestedWith": ["slack", "asana", "notion"]
+}

package/dist/integrations/trello/files/_env.example

@@ -0,0 +1,4 @@
+# Trello OAuth Configuration
+# Get your credentials from https://trello.com/app-key
+TRELLO_CLIENT_ID=your-api-key
+TRELLO_CLIENT_SECRET=your-oauth-secret

package/dist/integrations/trello/files/ai/tools/create-card.ts

@@ -0,0 +1,54 @@
+import { tool } from "veryfront/ai";
+import { z } from "zod";
+import { createCard } from "../../lib/trello-client.ts";
+
+export default tool({
+  id: "create-card",
+  description: "Create a new card in a Trello list.",
+  inputSchema: z.object({
+    listId: z.string().describe("The ID of the list to create the card in"),
+    name: z.string().describe("The name/title of the card"),
+    desc: z.string().optional().describe("Description or details for the card"),
+    due: z.string().optional().describe("Due date in ISO 8601 format (e.g., 2024-12-31T23:59:59.000Z)"),
+    pos: z
+      .union([z.string(), z.number()])
+      .optional()
+      .describe('Position of the card: "top", "bottom", or a positive number'),
+    idMembers: z
+      .array(z.string())
+      .optional()
+      .describe("Array of member IDs to assign to the card"),
+    idLabels: z
+      .array(z.string())
+      .optional()
+      .describe("Array of label IDs to add to the card"),
+  }),
+  async execute({ listId, name, desc, due, pos, idMembers, idLabels }) {
+    const card = await createCard({
+      listId,
+      name,
+      desc,
+      due,
+      pos,
+      idMembers,
+      idLabels,
+    });
+
+    return {
+      success: true,
+      card: {
+        id: card.id,
+        name: card.name,
+        desc: card.desc,
+        url: card.url,
+        idList: card.idList,
+        due: card.due,
+        labels: card.labels.map((label) => ({
+          id: label.id,
+          name: label.name,
+          color: label.color,
+        })),
+      },
+    };
+  },
+});

package/dist/integrations/trello/files/ai/tools/get-card.ts

@@ -0,0 +1,33 @@
+import { tool } from "veryfront/ai";
+import { z } from "zod";
+import { getCard } from "../../lib/trello-client.ts";
+
+export default tool({
+  id: "get-card",
+  description: "Get details of a specific Trello card by its ID.",
+  inputSchema: z.object({
+    cardId: z.string().describe("The ID of the card to retrieve"),
+  }),
+  async execute({ cardId }) {
+    const card = await getCard(cardId);
+
+    return {
+      id: card.id,
+      name: card.name,
+      desc: card.desc,
+      url: card.url,
+      closed: card.closed,
+      idList: card.idList,
+      idBoard: card.idBoard,
+      due: card.due,
+      dueComplete: card.dueComplete,
+      labels: card.labels.map((label) => ({
+        id: label.id,
+        name: label.name,
+        color: label.color,
+      })),
+      memberIds: card.idMembers,
+      lastActivity: card.dateLastActivity,
+    };
+  },
+});

package/dist/integrations/trello/files/ai/tools/list-boards.ts

@@ -0,0 +1,29 @@
+import { tool } from "veryfront/ai";
+import { z } from "zod";
+import { listBoards } from "../../lib/trello-client.ts";
+
+export default tool({
+  id: "list-boards",
+  description: "List all Trello boards accessible to the current user.",
+  inputSchema: z.object({
+    includeArchived: z.boolean().default(false).describe("Include archived/closed boards"),
+    limit: z.number().min(1).max(100).default(20).describe("Maximum number of boards to return"),
+  }),
+  async execute({ includeArchived, limit }) {
+    const boards = await listBoards();
+
+    const filteredBoards = includeArchived
+      ? boards
+      : boards.filter((board) => !board.closed);
+
+    return filteredBoards.slice(0, limit).map((board) => ({
+      id: board.id,
+      name: board.name,
+      desc: board.desc,
+      url: board.url,
+      closed: board.closed,
+      backgroundColor: board.prefs?.backgroundColor,
+      lastActivity: board.dateLastActivity,
+    }));
+  },
+});

package/dist/integrations/trello/files/ai/tools/list-cards.ts

@@ -0,0 +1,52 @@
+import { tool } from "veryfront/ai";
+import { z } from "zod";
+import { listCards } from "../../lib/trello-client.ts";
+
+export default tool({
+  id: "list-cards",
+  description:
+    "List cards from Trello. Can filter by board or list. Provide either boardId or listId.",
+  inputSchema: z.object({
+    boardId: z.string().optional().describe("Board ID to list cards from"),
+    listId: z.string().optional().describe("List ID to list cards from"),
+    includeArchived: z.boolean().default(false).describe("Include archived/closed cards"),
+    limit: z.number().min(1).max(100).default(50).describe("Maximum number of cards to return"),
+  }),
+  async execute({ boardId, listId, includeArchived, limit }) {
+    if (!boardId && !listId) {
+      return {
+        cards: [],
+        message: "Please specify either a boardId or listId",
+      };
+    }
+
+    const cards = await listCards({
+      boardId,
+      listId,
+      limit,
+    });
+
+    const filteredCards = includeArchived
+      ? cards
+      : cards.filter((card) => !card.closed);
+
+    return filteredCards.map((card) => ({
+      id: card.id,
+      name: card.name,
+      desc: card.desc,
+      url: card.url,
+      closed: card.closed,
+      idList: card.idList,
+      idBoard: card.idBoard,
+      due: card.due,
+      dueComplete: card.dueComplete,
+      labels: card.labels.map((label) => ({
+        id: label.id,
+        name: label.name,
+        color: label.color,
+      })),
+      memberIds: card.idMembers,
+      lastActivity: card.dateLastActivity,
+    }));
+  },
+});

package/dist/integrations/trello/files/ai/tools/update-card.ts

@@ -0,0 +1,65 @@
+import { tool } from "veryfront/ai";
+import { z } from "zod";
+import { updateCard } from "../../lib/trello-client.ts";
+
+export default tool({
+  id: "update-card",
+  description: "Update an existing Trello card.",
+  inputSchema: z.object({
+    cardId: z.string().describe("The ID of the card to update"),
+    name: z.string().optional().describe("New name/title for the card"),
+    desc: z.string().optional().describe("New description or details"),
+    closed: z.boolean().optional().describe("Archive or unarchive the card"),
+    idList: z.string().optional().describe("Move the card to a different list by list ID"),
+    due: z
+      .string()
+      .nullable()
+      .optional()
+      .describe("New due date in ISO 8601 format, or null to remove due date"),
+    dueComplete: z.boolean().optional().describe("Mark the due date as complete or incomplete"),
+    pos: z
+      .union([z.string(), z.number()])
+      .optional()
+      .describe('New position: "top", "bottom", or a positive number'),
+    idMembers: z
+      .array(z.string())
+      .optional()
+      .describe("Array of member IDs to assign to the card (replaces existing)"),
+    idLabels: z
+      .array(z.string())
+      .optional()
+      .describe("Array of label IDs for the card (replaces existing)"),
+  }),
+  async execute({ cardId, name, desc, closed, idList, due, dueComplete, pos, idMembers, idLabels }) {
+    const card = await updateCard(cardId, {
+      name,
+      desc,
+      closed,
+      idList,
+      due,
+      dueComplete,
+      pos,
+      idMembers,
+      idLabels,
+    });
+
+    return {
+      success: true,
+      card: {
+        id: card.id,
+        name: card.name,
+        desc: card.desc,
+        url: card.url,
+        closed: card.closed,
+        idList: card.idList,
+        due: card.due,
+        dueComplete: card.dueComplete,
+        labels: card.labels.map((label) => ({
+          id: label.id,
+          name: label.name,
+          color: label.color,
+        })),
+      },
+    };
+  },
+});

package/dist/integrations/trello/files/app/api/auth/trello/callback/route.ts

@@ -0,0 +1,11 @@
+/**
+ * Trello OAuth Callback
+ */
+
+import { trelloConfig, createOAuthCallbackHandler, memoryTokenStore } from "veryfront/oauth";
+
+export const GET = createOAuthCallbackHandler(trelloConfig, {
+  tokenStore: memoryTokenStore,
+  onSuccess: () => "/",
+  onError: () => "/",
+});

package/dist/integrations/trello/files/app/api/auth/trello/route.ts

@@ -0,0 +1,7 @@
+/**
+ * Trello OAuth Init
+ */
+
+import { trelloConfig, createOAuthInitHandler } from "veryfront/oauth";
+
+export const GET = createOAuthInitHandler(trelloConfig);

package/dist/integrations/trello/files/lib/trello-client.ts

@@ -0,0 +1,202 @@
+import { getAccessToken } from "./token-store.ts";
+
+const TRELLO_BASE_URL = "https://api.trello.com/1";
+
+interface TrelloBoard {
+  id: string;
+  name: string;
+  desc: string;
+  closed: boolean;
+  url: string;
+  prefs: {
+    background: string;
+    backgroundColor: string;
+  };
+  dateLastActivity: string;
+}
+
+interface TrelloList {
+  id: string;
+  name: string;
+  closed: boolean;
+  idBoard: string;
+  pos: number;
+}
+
+interface TrelloCard {
+  id: string;
+  name: string;
+  desc: string;
+  closed: boolean;
+  idBoard: string;
+  idList: string;
+  idMembers: string[];
+  labels: Array<{
+    id: string;
+    name: string;
+    color: string;
+  }>;
+  due: string | null;
+  dueComplete: boolean;
+  url: string;
+  dateLastActivity: string;
+}
+
+interface TrelloMember {
+  id: string;
+  fullName: string;
+  username: string;
+  avatarUrl: string;
+}
+
+async function trelloFetch<T>(
+  endpoint: string,
+  options: RequestInit = {},
+): Promise<T> {
+  const token = await getAccessToken();
+  if (!token) {
+    throw new Error("Not authenticated with Trello. Please connect your account.");
+  }
+
+  const clientId = process.env.TRELLO_CLIENT_ID;
+  if (!clientId) {
+    throw new Error("TRELLO_CLIENT_ID environment variable is not set.");
+  }
+
+  const url = new URL(`${TRELLO_BASE_URL}${endpoint}`);
+  url.searchParams.set("key", clientId);
+  url.searchParams.set("token", token);
+
+  const response = await fetch(url.toString(), {
+    ...options,
+    headers: {
+      "Accept": "application/json",
+      "Content-Type": "application/json",
+      ...options.headers,
+    },
+  });
+
+  if (!response.ok) {
+    const error = await response.text().catch(() => "");
+    throw new Error(
+      `Trello API error: ${response.status} ${error || response.statusText}`,
+    );
+  }
+
+  return response.json();
+}
+
+export async function listBoards(): Promise<TrelloBoard[]> {
+  const boards = await trelloFetch<TrelloBoard[]>(
+    "/members/me/boards?fields=name,desc,closed,url,prefs,dateLastActivity",
+  );
+  return boards;
+}
+
+export async function getBoard(boardId: string): Promise<TrelloBoard> {
+  const board = await trelloFetch<TrelloBoard>(
+    `/boards/${boardId}?fields=name,desc,closed,url,prefs,dateLastActivity`,
+  );
+  return board;
+}
+
+export async function listLists(boardId: string): Promise<TrelloList[]> {
+  const lists = await trelloFetch<TrelloList[]>(
+    `/boards/${boardId}/lists?fields=name,closed,idBoard,pos`,
+  );
+  return lists;
+}
+
+export async function listCards(options: {
+  boardId?: string;
+  listId?: string;
+  limit?: number;
+}): Promise<TrelloCard[]> {
+  const { boardId, listId, limit = 50 } = options;
+
+  let endpoint: string;
+  if (listId) {
+    endpoint = `/lists/${listId}/cards`;
+  } else if (boardId) {
+    endpoint = `/boards/${boardId}/cards`;
+  } else {
+    throw new Error("Either boardId or listId must be provided");
+  }
+
+  const cards = await trelloFetch<TrelloCard[]>(
+    `${endpoint}?fields=name,desc,closed,idBoard,idList,idMembers,labels,due,dueComplete,url,dateLastActivity&limit=${limit}`,
+  );
+  return cards;
+}
+
+export async function getCard(cardId: string): Promise<TrelloCard> {
+  const card = await trelloFetch<TrelloCard>(
+    `/cards/${cardId}?fields=name,desc,closed,idBoard,idList,idMembers,labels,due,dueComplete,url,dateLastActivity`,
+  );
+  return card;
+}
+
+export async function createCard(options: {
+  listId: string;
+  name: string;
+  desc?: string;
+  due?: string;
+  pos?: string | number;
+  idMembers?: string[];
+  idLabels?: string[];
+}): Promise<TrelloCard> {
+  const params = new URLSearchParams({
+    idList: options.listId,
+    name: options.name,
+  });
+
+  if (options.desc) params.set("desc", options.desc);
+  if (options.due) params.set("due", options.due);
+  if (options.pos !== undefined) params.set("pos", String(options.pos));
+  if (options.idMembers) params.set("idMembers", options.idMembers.join(","));
+  if (options.idLabels) params.set("idLabels", options.idLabels.join(","));
+
+  const card = await trelloFetch<TrelloCard>(`/cards?${params}`, {
+    method: "POST",
+  });
+  return card;
+}
+
+export async function updateCard(
+  cardId: string,
+  updates: {
+    name?: string;
+    desc?: string;
+    closed?: boolean;
+    idList?: string;
+    due?: string | null;
+    dueComplete?: boolean;
+    idMembers?: string[];
+    idLabels?: string[];
+    pos?: string | number;
+  },
+): Promise<TrelloCard> {
+  const params = new URLSearchParams();
+
+  if (updates.name !== undefined) params.set("name", updates.name);
+  if (updates.desc !== undefined) params.set("desc", updates.desc);
+  if (updates.closed !== undefined) params.set("closed", String(updates.closed));
+  if (updates.idList !== undefined) params.set("idList", updates.idList);
+  if (updates.due !== undefined) params.set("due", updates.due === null ? "" : updates.due);
+  if (updates.dueComplete !== undefined) params.set("dueComplete", String(updates.dueComplete));
+  if (updates.idMembers !== undefined) params.set("idMembers", updates.idMembers.join(","));
+  if (updates.idLabels !== undefined) params.set("idLabels", updates.idLabels.join(","));
+  if (updates.pos !== undefined) params.set("pos", String(updates.pos));
+
+  const card = await trelloFetch<TrelloCard>(`/cards/${cardId}?${params}`, {
+    method: "PUT",
+  });
+  return card;
+}
+
+export async function getMe(): Promise<TrelloMember> {
+  const member = await trelloFetch<TrelloMember>(
+    "/members/me?fields=fullName,username,avatarUrl",
+  );
+  return member;
+}