veryfront 0.0.49 → 0.0.51

package/dist/integrations/gitlab/files/ai/tools/get-issue.ts

@@ -0,0 +1,56 @@
+import { tool } from "veryfront/ai";
+import { z } from "zod";
+import { getIssue } from "../../lib/gitlab-client.ts";
+
+export default tool({
+  id: "get-issue",
+  description:
+    "Get detailed information about a specific GitLab issue including full description, comments, time tracking, and metadata.",
+  inputSchema: z.object({
+    projectId: z.union([z.number(), z.string()]).describe(
+      'Project ID or path (e.g., "gitlab-org/gitlab" or 278964)',
+    ),
+    issueIid: z.number().describe(
+      "Issue IID (internal ID, the number shown in the issue URL like #123)",
+    ),
+  }),
+  async execute({ projectId, issueIid }) {
+    const issue = await getIssue(projectId, issueIid);
+
+    return {
+      id: issue.id,
+      iid: issue.iid,
+      projectId: issue.project_id,
+      title: issue.title,
+      description: issue.description || "No description provided",
+      state: issue.state,
+      labels: issue.labels,
+      milestone: issue.milestone
+        ? {
+          id: issue.milestone.id,
+          title: issue.milestone.title,
+        }
+        : null,
+      assignees: issue.assignees.map((a) => ({
+        id: a.id,
+        username: a.username,
+        name: a.name,
+        avatarUrl: a.avatar_url,
+      })),
+      author: {
+        id: issue.author.id,
+        username: issue.author.username,
+        name: issue.author.name,
+        avatarUrl: issue.author.avatar_url,
+      },
+      timeStats: {
+        timeEstimate: issue.time_stats.time_estimate,
+        totalTimeSpent: issue.time_stats.total_time_spent,
+      },
+      createdAt: issue.created_at,
+      updatedAt: issue.updated_at,
+      closedAt: issue.closed_at,
+      webUrl: issue.web_url,
+    };
+  },
+});

package/dist/integrations/gitlab/files/ai/tools/list-merge-requests.ts

@@ -0,0 +1,75 @@
+import { tool } from "veryfront/ai";
+import { z } from "zod";
+import { formatMergeRequestForDisplay, listMergeRequests } from "../../lib/gitlab-client.ts";
+
+export default tool({
+  id: "list-merge-requests",
+  description:
+    "List merge requests in GitLab. Can filter by scope, state, labels, and specific project. Returns MR titles, states, branches, assignees, and reviewers.",
+  inputSchema: z.object({
+    scope: z.enum(["created_by_me", "assigned_to_me", "all"]).default("all").describe(
+      "Scope of merge requests to list",
+    ),
+    state: z.enum(["opened", "closed", "merged", "all"]).default("opened").describe(
+      "State of merge requests to list",
+    ),
+    labels: z.array(z.string()).optional().describe(
+      'Filter by labels (e.g., ["feature", "review-needed"])',
+    ),
+    projectId: z.union([z.number(), z.string()]).optional().describe(
+      'Project ID or path (e.g., "gitlab-org/gitlab" or 278964)',
+    ),
+    limit: z.number().min(1).max(100).default(20).describe("Maximum number of results to return"),
+  }),
+  async execute({ scope, state, labels, projectId, limit }) {
+    const mergeRequests = await listMergeRequests({
+      scope,
+      state,
+      labels,
+      projectId,
+      perPage: limit,
+    });
+
+    if (mergeRequests.length === 0) {
+      return {
+        message: "No merge requests found matching the criteria.",
+        count: 0,
+        mergeRequests: [],
+      };
+    }
+
+    return {
+      count: mergeRequests.length,
+      mergeRequests: mergeRequests.map((mr) => ({
+        id: mr.id,
+        iid: mr.iid,
+        projectId: mr.project_id,
+        title: mr.title,
+        state: mr.state,
+        draft: mr.draft,
+        sourceBranch: mr.source_branch,
+        targetBranch: mr.target_branch,
+        labels: mr.labels,
+        author: {
+          username: mr.author.username,
+          name: mr.author.name,
+        },
+        assignees: mr.assignees.map((a) => ({
+          username: a.username,
+          name: a.name,
+        })),
+        reviewers: mr.reviewers.map((r) => ({
+          username: r.username,
+          name: r.name,
+        })),
+        createdAt: mr.created_at,
+        updatedAt: mr.updated_at,
+        mergedAt: mr.merged_at,
+        webUrl: mr.web_url,
+        description: mr.description?.substring(0, 200) +
+          (mr.description && mr.description.length > 200 ? "..." : ""),
+      })),
+      summary: mergeRequests.map((mr) => formatMergeRequestForDisplay(mr)).join("\n\n"),
+    };
+  },
+});

package/dist/integrations/gitlab/files/ai/tools/list-projects.ts

@@ -0,0 +1,51 @@
+import { tool } from "veryfront/ai";
+import { z } from "zod";
+import { listProjects } from "../../lib/gitlab-client.ts";
+
+export default tool({
+  id: "list-projects",
+  description:
+    "List GitLab projects accessible to the authenticated user. Can search, filter by membership, and sort results.",
+  inputSchema: z.object({
+    search: z.string().optional().describe("Search query to filter projects by name or path"),
+    membership: z.boolean().default(true).describe("Only show projects where user is a member"),
+    orderBy: z.enum(["id", "name", "created_at", "updated_at", "last_activity_at"]).default(
+      "last_activity_at",
+    ).describe("Field to order results by"),
+    sort: z.enum(["asc", "desc"]).default("desc").describe("Sort direction"),
+    limit: z.number().min(1).max(100).default(20).describe("Maximum number of results to return"),
+  }),
+  async execute({ search, membership, orderBy, sort, limit }) {
+    const projects = await listProjects({
+      search,
+      membership,
+      orderBy,
+      sort,
+      perPage: limit,
+    });
+
+    if (projects.length === 0) {
+      return {
+        message: "No projects found matching the criteria.",
+        count: 0,
+        projects: [],
+      };
+    }
+
+    return {
+      count: projects.length,
+      projects: projects.map((project) => ({
+        id: project.id,
+        name: project.name,
+        nameWithNamespace: project.name_with_namespace,
+        path: project.path_with_namespace,
+        description: project.description || "No description",
+        visibility: project.visibility,
+        defaultBranch: project.default_branch,
+        webUrl: project.web_url,
+        createdAt: project.created_at,
+        lastActivityAt: project.last_activity_at,
+      })),
+    };
+  },
+});

package/dist/integrations/gitlab/files/ai/tools/search-issues.ts

@@ -0,0 +1,67 @@
+import { tool } from "veryfront/ai";
+import { z } from "zod";
+import { formatIssueForDisplay, searchIssues } from "../../lib/gitlab-client.ts";
+
+export default tool({
+  id: "search-issues",
+  description:
+    "Search for issues in GitLab projects. Can search across all accessible projects or within a specific project. Returns issue titles, states, assignees, and labels.",
+  inputSchema: z.object({
+    scope: z.enum(["created_by_me", "assigned_to_me", "all"]).default("all").describe(
+      "Scope of issues to search",
+    ),
+    state: z.enum(["opened", "closed", "all"]).default("opened").describe(
+      "State of issues to search for",
+    ),
+    search: z.string().optional().describe("Search query to filter issues by title or description"),
+    labels: z.array(z.string()).optional().describe('Filter by labels (e.g., ["bug", "urgent"])'),
+    projectId: z.union([z.number(), z.string()]).optional().describe(
+      'Project ID or path (e.g., "gitlab-org/gitlab" or 278964)',
+    ),
+    limit: z.number().min(1).max(100).default(20).describe("Maximum number of results to return"),
+  }),
+  async execute({ scope, state, search, labels, projectId, limit }) {
+    const issues = await searchIssues({
+      scope,
+      state,
+      search,
+      labels,
+      projectId,
+      perPage: limit,
+    });
+
+    if (issues.length === 0) {
+      return {
+        message: "No issues found matching the criteria.",
+        count: 0,
+        issues: [],
+      };
+    }
+
+    return {
+      count: issues.length,
+      issues: issues.map((issue) => ({
+        id: issue.id,
+        iid: issue.iid,
+        projectId: issue.project_id,
+        title: issue.title,
+        state: issue.state,
+        labels: issue.labels,
+        assignees: issue.assignees.map((a) => ({
+          username: a.username,
+          name: a.name,
+        })),
+        author: {
+          username: issue.author.username,
+          name: issue.author.name,
+        },
+        createdAt: issue.created_at,
+        updatedAt: issue.updated_at,
+        webUrl: issue.web_url,
+        description: issue.description?.substring(0, 200) +
+          (issue.description && issue.description.length > 200 ? "..." : ""),
+      })),
+      summary: issues.map((issue) => formatIssueForDisplay(issue)).join("\n\n"),
+    };
+  },
+});

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

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

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

@@ -0,0 +1,9 @@
+/**
+ * GitLab OAuth Initiation
+ */
+
+import { createOAuthInitHandler, gitlabConfig, memoryTokenStore } from "veryfront/oauth";
+
+export const GET = createOAuthInitHandler(gitlabConfig, {
+  tokenStore: memoryTokenStore,
+});

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

@@ -0,0 +1,366 @@
+import { getAccessToken } from "./token-store.ts";
+
+const GITLAB_BASE_URL = "https://gitlab.com/api/v4";
+
+interface GitLabResponse<T> {
+  data?: T;
+  headers?: Record<string, string>;
+}
+
+export interface GitLabProject {
+  id: number;
+  name: string;
+  name_with_namespace: string;
+  description: string | null;
+  web_url: string;
+  path_with_namespace: string;
+  default_branch: string;
+  visibility: "private" | "internal" | "public";
+  created_at: string;
+  last_activity_at: string;
+}
+
+export interface GitLabIssue {
+  id: number;
+  iid: number;
+  project_id: number;
+  title: string;
+  description: string | null;
+  state: "opened" | "closed";
+  created_at: string;
+  updated_at: string;
+  closed_at: string | null;
+  labels: string[];
+  milestone: {
+    id: number;
+    title: string;
+  } | null;
+  assignees: Array<{
+    id: number;
+    username: string;
+    name: string;
+    avatar_url: string;
+  }>;
+  author: {
+    id: number;
+    username: string;
+    name: string;
+    avatar_url: string;
+  };
+  web_url: string;
+  time_stats: {
+    time_estimate: number;
+    total_time_spent: number;
+  };
+}
+
+export interface GitLabMergeRequest {
+  id: number;
+  iid: number;
+  project_id: number;
+  title: string;
+  description: string | null;
+  state: "opened" | "closed" | "merged";
+  created_at: string;
+  updated_at: string;
+  merged_at: string | null;
+  closed_at: string | null;
+  target_branch: string;
+  source_branch: string;
+  author: {
+    id: number;
+    username: string;
+    name: string;
+    avatar_url: string;
+  };
+  assignees: Array<{
+    id: number;
+    username: string;
+    name: string;
+    avatar_url: string;
+  }>;
+  reviewers: Array<{
+    id: number;
+    username: string;
+    name: string;
+    avatar_url: string;
+  }>;
+  labels: string[];
+  draft: boolean;
+  web_url: string;
+  changes_count: string;
+  diff_refs: {
+    base_sha: string;
+    head_sha: string;
+    start_sha: string;
+  };
+}
+
+export interface GitLabUser {
+  id: number;
+  username: string;
+  name: string;
+  email: string;
+  avatar_url: string;
+  web_url: string;
+}
+
+async function gitlabFetch<T>(
+  endpoint: string,
+  options: RequestInit = {},
+): Promise<T> {
+  const token = await getAccessToken();
+  if (!token) {
+    throw new Error("Not authenticated with GitLab. Please connect your account.");
+  }
+
+  const response = await fetch(`${GITLAB_BASE_URL}${endpoint}`, {
+    ...options,
+    headers: {
+      "Authorization": `Bearer ${token}`,
+      "Content-Type": "application/json",
+      ...options.headers,
+    },
+  });
+
+  if (!response.ok) {
+    const error = await response.json().catch(() => ({}));
+    throw new Error(
+      `GitLab API error: ${response.status} ${error.message || error.error || response.statusText}`,
+    );
+  }
+
+  return response.json();
+}
+
+export function getCurrentUser(): Promise<GitLabUser> {
+  return gitlabFetch<GitLabUser>("/user");
+}
+
+export function listProjects(options?: {
+  membership?: boolean;
+  search?: string;
+  orderBy?: "id" | "name" | "created_at" | "updated_at" | "last_activity_at";
+  sort?: "asc" | "desc";
+  perPage?: number;
+}): Promise<GitLabProject[]> {
+  const params = new URLSearchParams();
+
+  if (options?.membership !== false) {
+    params.set("membership", "true");
+  }
+  if (options?.search) {
+    params.set("search", options.search);
+  }
+  if (options?.orderBy) {
+    params.set("order_by", options.orderBy);
+  }
+  if (options?.sort) {
+    params.set("sort", options.sort);
+  }
+  if (options?.perPage) {
+    params.set("per_page", options.perPage.toString());
+  }
+
+  const query = params.toString();
+  return gitlabFetch<GitLabProject[]>(`/projects${query ? `?${query}` : ""}`);
+}
+
+export function getProject(projectId: number | string): Promise<GitLabProject> {
+  const encodedId = typeof projectId === "string" ? encodeURIComponent(projectId) : projectId;
+  return gitlabFetch<GitLabProject>(`/projects/${encodedId}`);
+}
+
+export function searchIssues(options: {
+  scope?: "created_by_me" | "assigned_to_me" | "all";
+  state?: "opened" | "closed" | "all";
+  labels?: string[];
+  search?: string;
+  projectId?: number | string;
+  perPage?: number;
+}): Promise<GitLabIssue[]> {
+  const params = new URLSearchParams();
+
+  if (options.scope) {
+    params.set("scope", options.scope);
+  }
+  if (options.state) {
+    params.set("state", options.state);
+  }
+  if (options.labels && options.labels.length > 0) {
+    params.set("labels", options.labels.join(","));
+  }
+  if (options.search) {
+    params.set("search", options.search);
+  }
+  if (options.perPage) {
+    params.set("per_page", options.perPage.toString());
+  }
+
+  const query = params.toString();
+
+  if (options.projectId) {
+    const encodedId = typeof options.projectId === "string"
+      ? encodeURIComponent(options.projectId)
+      : options.projectId;
+    return gitlabFetch<GitLabIssue[]>(`/projects/${encodedId}/issues${query ? `?${query}` : ""}`);
+  }
+
+  return gitlabFetch<GitLabIssue[]>(`/issues${query ? `?${query}` : ""}`);
+}
+
+export function getIssue(
+  projectId: number | string,
+  issueIid: number,
+): Promise<GitLabIssue> {
+  const encodedId = typeof projectId === "string" ? encodeURIComponent(projectId) : projectId;
+  return gitlabFetch<GitLabIssue>(`/projects/${encodedId}/issues/${issueIid}`);
+}
+
+export function createIssue(
+  projectId: number | string,
+  options: {
+    title: string;
+    description?: string;
+    labels?: string[];
+    assigneeIds?: number[];
+    milestoneId?: number;
+    dueDate?: string;
+  },
+): Promise<GitLabIssue> {
+  const encodedId = typeof projectId === "string" ? encodeURIComponent(projectId) : projectId;
+
+  const body: Record<string, unknown> = {
+    title: options.title,
+  };
+
+  if (options.description) {
+    body.description = options.description;
+  }
+  if (options.labels && options.labels.length > 0) {
+    body.labels = options.labels.join(",");
+  }
+  if (options.assigneeIds && options.assigneeIds.length > 0) {
+    body.assignee_ids = options.assigneeIds;
+  }
+  if (options.milestoneId) {
+    body.milestone_id = options.milestoneId;
+  }
+  if (options.dueDate) {
+    body.due_date = options.dueDate;
+  }
+
+  return gitlabFetch<GitLabIssue>(`/projects/${encodedId}/issues`, {
+    method: "POST",
+    body: JSON.stringify(body),
+  });
+}
+
+export function updateIssue(
+  projectId: number | string,
+  issueIid: number,
+  options: {
+    title?: string;
+    description?: string;
+    state?: "opened" | "closed";
+    labels?: string[];
+    assigneeIds?: number[];
+  },
+): Promise<GitLabIssue> {
+  const encodedId = typeof projectId === "string" ? encodeURIComponent(projectId) : projectId;
+
+  const body: Record<string, unknown> = {};
+
+  if (options.title) {
+    body.title = options.title;
+  }
+  if (options.description !== undefined) {
+    body.description = options.description;
+  }
+  if (options.state) {
+    body.state_event = options.state === "closed" ? "close" : "reopen";
+  }
+  if (options.labels) {
+    body.labels = options.labels.join(",");
+  }
+  if (options.assigneeIds) {
+    body.assignee_ids = options.assigneeIds;
+  }
+
+  return gitlabFetch<GitLabIssue>(`/projects/${encodedId}/issues/${issueIid}`, {
+    method: "PUT",
+    body: JSON.stringify(body),
+  });
+}
+
+export function listMergeRequests(options?: {
+  scope?: "created_by_me" | "assigned_to_me" | "all";
+  state?: "opened" | "closed" | "merged" | "all";
+  labels?: string[];
+  projectId?: number | string;
+  perPage?: number;
+}): Promise<GitLabMergeRequest[]> {
+  const params = new URLSearchParams();
+
+  if (options?.scope) {
+    params.set("scope", options.scope);
+  }
+  if (options?.state) {
+    params.set("state", options.state);
+  }
+  if (options?.labels && options.labels.length > 0) {
+    params.set("labels", options.labels.join(","));
+  }
+  if (options?.perPage) {
+    params.set("per_page", options.perPage.toString());
+  }
+
+  const query = params.toString();
+
+  if (options?.projectId) {
+    const encodedId = typeof options.projectId === "string"
+      ? encodeURIComponent(options.projectId)
+      : options.projectId;
+    return gitlabFetch<GitLabMergeRequest[]>(
+      `/projects/${encodedId}/merge_requests${query ? `?${query}` : ""}`,
+    );
+  }
+
+  return gitlabFetch<GitLabMergeRequest[]>(`/merge_requests${query ? `?${query}` : ""}`);
+}
+
+export function getMergeRequest(
+  projectId: number | string,
+  mrIid: number,
+): Promise<GitLabMergeRequest> {
+  const encodedId = typeof projectId === "string" ? encodeURIComponent(projectId) : projectId;
+  return gitlabFetch<GitLabMergeRequest>(`/projects/${encodedId}/merge_requests/${mrIid}`);
+}
+
+// Helper function to format issue for display
+export function formatIssueForDisplay(issue: GitLabIssue): string {
+  const assignees = issue.assignees.map((a) => `@${a.username}`).join(", ");
+  const labels = issue.labels.length > 0 ? `[${issue.labels.join(", ")}]` : "";
+
+  return `#${issue.iid}: ${issue.title} ${labels}
+State: ${issue.state}
+Assignees: ${assignees || "None"}
+Created: ${new Date(issue.created_at).toLocaleDateString()}
+URL: ${issue.web_url}`;
+}
+
+// Helper function to format merge request for display
+export function formatMergeRequestForDisplay(mr: GitLabMergeRequest): string {
+  const assignees = mr.assignees.map((a) => `@${a.username}`).join(", ");
+  const reviewers = mr.reviewers.map((r) => `@${r.username}`).join(", ");
+  const labels = mr.labels.length > 0 ? `[${mr.labels.join(", ")}]` : "";
+
+  return `!${mr.iid}: ${mr.title} ${labels}
+State: ${mr.state}${mr.draft ? " (Draft)" : ""}
+Source: ${mr.source_branch} → Target: ${mr.target_branch}
+Author: @${mr.author.username}
+Assignees: ${assignees || "None"}
+Reviewers: ${reviewers || "None"}
+Created: ${new Date(mr.created_at).toLocaleDateString()}
+URL: ${mr.web_url}`;
+}