veryfront 0.0.48 → 0.0.50

package/dist/integrations/gitlab/connector.json

@@ -0,0 +1,100 @@
+{
+  "name": "gitlab",
+  "displayName": "GitLab",
+  "icon": "gitlab.svg",
+  "description": "Search and manage GitLab issues, merge requests, and projects",
+  "auth": {
+    "type": "oauth2",
+    "provider": "gitlab",
+    "authorizationUrl": "https://gitlab.com/oauth/authorize",
+    "tokenUrl": "https://gitlab.com/oauth/token",
+    "scopes": ["api", "read_user", "read_repository"],
+    "callbackPath": "/api/auth/gitlab/callback",
+    "tokenAuthMethod": "body",
+    "requiredApis": [
+      {
+        "name": "GitLab Application",
+        "enableUrl": "https://gitlab.com/-/profile/applications"
+      }
+    ]
+  },
+  "envVars": [
+    {
+      "name": "GITLAB_CLIENT_ID",
+      "description": "GitLab OAuth Application ID",
+      "required": true,
+      "sensitive": false,
+      "docsUrl": "https://docs.gitlab.com/ee/api/oauth2.html"
+    },
+    {
+      "name": "GITLAB_CLIENT_SECRET",
+      "description": "GitLab OAuth Application Secret",
+      "required": true,
+      "sensitive": true,
+      "docsUrl": "https://docs.gitlab.com/ee/api/oauth2.html"
+    }
+  ],
+  "tools": [
+    {
+      "id": "search-issues",
+      "name": "Search Issues",
+      "description": "Search for issues across projects",
+      "requiresWrite": false
+    },
+    {
+      "id": "get-issue",
+      "name": "Get Issue",
+      "description": "Get detailed information about a specific issue",
+      "requiresWrite": false
+    },
+    {
+      "id": "create-issue",
+      "name": "Create Issue",
+      "description": "Create a new issue in a project",
+      "requiresWrite": true
+    },
+    {
+      "id": "list-merge-requests",
+      "name": "List Merge Requests",
+      "description": "List merge requests for a project or across projects",
+      "requiresWrite": false
+    },
+    {
+      "id": "list-projects",
+      "name": "List Projects",
+      "description": "List accessible GitLab projects",
+      "requiresWrite": false
+    }
+  ],
+  "prompts": [
+    {
+      "id": "find-issues",
+      "title": "Find my issues",
+      "prompt": "Search for issues assigned to me that are open. Show me the most important ones.",
+      "category": "development",
+      "icon": "bug"
+    },
+    {
+      "id": "review-mrs",
+      "title": "Review merge requests",
+      "prompt": "Show me all open merge requests that need my review. Summarize what each one does.",
+      "category": "development",
+      "icon": "git-merge"
+    },
+    {
+      "id": "create-bug-report",
+      "title": "Create bug report",
+      "prompt": "Help me create a detailed bug report issue with steps to reproduce, expected vs actual behavior.",
+      "category": "development",
+      "icon": "plus"
+    },
+    {
+      "id": "project-status",
+      "title": "Project status",
+      "prompt": "Give me a summary of my projects: open issues, merge requests, and recent activity.",
+      "category": "development",
+      "icon": "list"
+    }
+  ],
+  "suggestedWith": ["github", "jira", "slack"]
+}

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

@@ -0,0 +1,7 @@
+# GitLab OAuth Configuration
+# Create a new application at: https://gitlab.com/-/profile/applications
+# Set the redirect URI to: http://localhost:3000/api/auth/gitlab/callback
+# (Update the URL for production)
+
+GITLAB_CLIENT_ID=your_gitlab_application_id
+GITLAB_CLIENT_SECRET=your_gitlab_application_secret

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

@@ -0,0 +1,49 @@
+import { tool } from "veryfront/ai";
+import { z } from "zod";
+import { createIssue } from "../../lib/gitlab-client.ts";
+
+export default tool({
+  id: "create-issue",
+  description:
+    "Create a new issue in a GitLab project. Can set title, description, labels, assignees, milestone, and due date.",
+  inputSchema: z.object({
+    projectId: z.union([z.number(), z.string()]).describe(
+      'Project ID or path (e.g., "gitlab-org/gitlab" or 278964)',
+    ),
+    title: z.string().min(1).describe("Issue title"),
+    description: z.string().optional().describe("Issue description in Markdown format"),
+    labels: z.array(z.string()).optional().describe('Labels to apply (e.g., ["bug", "urgent"])'),
+    assigneeIds: z.array(z.number()).optional().describe("User IDs to assign the issue to"),
+    milestoneId: z.number().optional().describe("Milestone ID to associate with the issue"),
+    dueDate: z.string().optional().describe("Due date in YYYY-MM-DD format"),
+  }),
+  async execute({ projectId, title, description, labels, assigneeIds, milestoneId, dueDate }) {
+    const issue = await createIssue(projectId, {
+      title,
+      description,
+      labels,
+      assigneeIds,
+      milestoneId,
+      dueDate,
+    });
+
+    return {
+      success: true,
+      message: `Issue created successfully: #${issue.iid}`,
+      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,
+        })),
+        webUrl: issue.web_url,
+        createdAt: issue.created_at,
+      },
+    };
+  },
+});

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,
+});