mcp-server-azure-devops 1.1.0

package/dist/features/repositories/list-repositories/feature.spec.unit.js

@@ -0,0 +1,57 @@
+import { listRepositories } from './feature';
+import { AzureDevOpsError } from '../../../shared/errors';
+// Unit tests should only focus on isolated logic
+describe('listRepositories unit', () => {
+    test('should return empty array when no repositories are found', async () => {
+        // Arrange
+        const mockConnection = {
+            getGitApi: jest.fn().mockImplementation(() => ({
+                getRepositories: jest.fn().mockResolvedValue([]), // No repositories found
+            })),
+        };
+        // Act
+        const result = await listRepositories(mockConnection, {
+            projectId: 'test-project',
+        });
+        // Assert
+        expect(result).toEqual([]);
+    });
+    test('should propagate custom errors when thrown internally', async () => {
+        // Arrange
+        const mockConnection = {
+            getGitApi: jest.fn().mockImplementation(() => {
+                throw new AzureDevOpsError('Custom error');
+            }),
+        };
+        // Act & Assert
+        await expect(listRepositories(mockConnection, { projectId: 'test-project' })).rejects.toThrow(AzureDevOpsError);
+        await expect(listRepositories(mockConnection, { projectId: 'test-project' })).rejects.toThrow('Custom error');
+    });
+    test('should wrap unexpected errors in a friendly error message', async () => {
+        // Arrange
+        const mockConnection = {
+            getGitApi: jest.fn().mockImplementation(() => {
+                throw new Error('Unexpected error');
+            }),
+        };
+        // Act & Assert
+        await expect(listRepositories(mockConnection, { projectId: 'test-project' })).rejects.toThrow('Failed to list repositories: Unexpected error');
+    });
+    test('should respect the includeLinks option', async () => {
+        // Arrange
+        const mockGetRepositories = jest.fn().mockResolvedValue([]);
+        const mockConnection = {
+            getGitApi: jest.fn().mockImplementation(() => ({
+                getRepositories: mockGetRepositories,
+            })),
+        };
+        // Act
+        await listRepositories(mockConnection, {
+            projectId: 'test-project',
+            includeLinks: true,
+        });
+        // Assert
+        expect(mockGetRepositories).toHaveBeenCalledWith('test-project', true);
+    });
+});
+//# sourceMappingURL=feature.spec.unit.js.map

package/dist/features/repositories/list-repositories/feature.spec.unit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature.spec.unit.js","sourceRoot":"","sources":["../../../../src/features/repositories/list-repositories/feature.spec.unit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,iDAAiD;AACjD,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;IACrC,IAAI,CAAC,0DAA0D,EAAE,KAAK,IAAI,EAAE;QAC1E,UAAU;QACV,MAAM,cAAc,GAAQ;YAC1B,SAAS,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,GAAG,EAAE,CAAC,CAAC;gBAC7C,eAAe,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,CAAC,EAAE,wBAAwB;aAC3E,CAAC,CAAC;SACJ,CAAC;QAEF,MAAM;QACN,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,cAAc,EAAE;YACpD,SAAS,EAAE,cAAc;SAC1B,CAAC,CAAC;QAEH,SAAS;QACT,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,uDAAuD,EAAE,KAAK,IAAI,EAAE;QACvE,UAAU;QACV,MAAM,cAAc,GAAQ;YAC1B,SAAS,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,GAAG,EAAE;gBAC3C,MAAM,IAAI,gBAAgB,CAAC,cAAc,CAAC,CAAC;YAC7C,CAAC,CAAC;SACH,CAAC;QAEF,eAAe;QACf,MAAM,MAAM,CACV,gBAAgB,CAAC,cAAc,EAAE,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC,CAChE,CAAC,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QAEpC,MAAM,MAAM,CACV,gBAAgB,CAAC,cAAc,EAAE,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC,CAChE,CAAC,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,2DAA2D,EAAE,KAAK,IAAI,EAAE;QAC3E,UAAU;QACV,MAAM,cAAc,GAAQ;YAC1B,SAAS,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,GAAG,EAAE;gBAC3C,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;YACtC,CAAC,CAAC;SACH,CAAC;QAEF,eAAe;QACf,MAAM,MAAM,CACV,gBAAgB,CAAC,cAAc,EAAE,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC,CAChE,CAAC,OAAO,CAAC,OAAO,CAAC,+CAA+C,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,wCAAwC,EAAE,KAAK,IAAI,EAAE;QACxD,UAAU;QACV,MAAM,mBAAmB,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC;QAC5D,MAAM,cAAc,GAAQ;YAC1B,SAAS,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,GAAG,EAAE,CAAC,CAAC;gBAC7C,eAAe,EAAE,mBAAmB;aACrC,CAAC,CAAC;SACJ,CAAC;QAEF,MAAM;QACN,MAAM,gBAAgB,CAAC,cAAc,EAAE;YACrC,SAAS,EAAE,cAAc;YACzB,YAAY,EAAE,IAAI;SACnB,CAAC,CAAC;QAEH,SAAS;QACT,MAAM,CAAC,mBAAmB,CAAC,CAAC,oBAAoB,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;IACzE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/features/repositories/list-repositories/index.d.ts

@@ -0,0 +1,2 @@
+export * from './schema';
+export * from './feature';

package/dist/features/repositories/list-repositories/index.js

@@ -0,0 +1,3 @@
+export * from './schema';
+export * from './feature';
+//# sourceMappingURL=index.js.map

package/dist/features/repositories/list-repositories/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/features/repositories/list-repositories/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC"}

package/dist/features/repositories/list-repositories/schema.d.ts

@@ -0,0 +1,2 @@
+import { ListRepositoriesSchema } from '../schemas';
+export { ListRepositoriesSchema };

package/dist/features/repositories/list-repositories/schema.js

@@ -0,0 +1,3 @@
+import { ListRepositoriesSchema } from '../schemas';
+export { ListRepositoriesSchema };
+//# sourceMappingURL=schema.js.map

package/dist/features/repositories/list-repositories/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../../src/features/repositories/list-repositories/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEpD,OAAO,EAAE,sBAAsB,EAAE,CAAC"}

package/dist/features/repositories/schemas.d.ts

@@ -0,0 +1,237 @@
+import { z } from 'zod';
+/**
+ * Schema for getting a repository
+ */
+export declare const GetRepositorySchema: z.ZodObject<{
+    projectId: z.ZodOptional<z.ZodString>;
+    organizationId: z.ZodOptional<z.ZodString>;
+    repositoryId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    repositoryId: string;
+    projectId?: string | undefined;
+    organizationId?: string | undefined;
+}, {
+    repositoryId: string;
+    projectId?: string | undefined;
+    organizationId?: string | undefined;
+}>;
+/**
+ * Schema for getting detailed repository information
+ */
+export declare const GetRepositoryDetailsSchema: z.ZodObject<{
+    projectId: z.ZodOptional<z.ZodString>;
+    organizationId: z.ZodOptional<z.ZodString>;
+    repositoryId: z.ZodString;
+    includeStatistics: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    includeRefs: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    refFilter: z.ZodOptional<z.ZodString>;
+    branchName: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    repositoryId: string;
+    includeStatistics: boolean;
+    includeRefs: boolean;
+    projectId?: string | undefined;
+    organizationId?: string | undefined;
+    refFilter?: string | undefined;
+    branchName?: string | undefined;
+}, {
+    repositoryId: string;
+    projectId?: string | undefined;
+    organizationId?: string | undefined;
+    includeStatistics?: boolean | undefined;
+    includeRefs?: boolean | undefined;
+    refFilter?: string | undefined;
+    branchName?: string | undefined;
+}>;
+/**
+ * Schema for listing repositories
+ */
+export declare const ListRepositoriesSchema: z.ZodObject<{
+    projectId: z.ZodOptional<z.ZodString>;
+    organizationId: z.ZodOptional<z.ZodString>;
+    includeLinks: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    projectId?: string | undefined;
+    organizationId?: string | undefined;
+    includeLinks?: boolean | undefined;
+}, {
+    projectId?: string | undefined;
+    organizationId?: string | undefined;
+    includeLinks?: boolean | undefined;
+}>;
+/**
+ * Schema for getting file content
+ */
+export declare const GetFileContentSchema: z.ZodObject<{
+    projectId: z.ZodOptional<z.ZodString>;
+    organizationId: z.ZodOptional<z.ZodString>;
+    repositoryId: z.ZodString;
+    path: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    version: z.ZodOptional<z.ZodString>;
+    versionType: z.ZodOptional<z.ZodEnum<["branch", "commit", "tag"]>>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    repositoryId: string;
+    projectId?: string | undefined;
+    organizationId?: string | undefined;
+    version?: string | undefined;
+    versionType?: "branch" | "commit" | "tag" | undefined;
+}, {
+    repositoryId: string;
+    path?: string | undefined;
+    projectId?: string | undefined;
+    organizationId?: string | undefined;
+    version?: string | undefined;
+    versionType?: "branch" | "commit" | "tag" | undefined;
+}>;
+/**
+ * Schema for getting all repositories tree structure
+ */
+export declare const GetAllRepositoriesTreeSchema: z.ZodObject<{
+    organizationId: z.ZodOptional<z.ZodString>;
+    projectId: z.ZodOptional<z.ZodString>;
+    repositoryPattern: z.ZodOptional<z.ZodString>;
+    depth: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    pattern: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    depth: number;
+    projectId?: string | undefined;
+    organizationId?: string | undefined;
+    repositoryPattern?: string | undefined;
+    pattern?: string | undefined;
+}, {
+    projectId?: string | undefined;
+    organizationId?: string | undefined;
+    repositoryPattern?: string | undefined;
+    depth?: number | undefined;
+    pattern?: string | undefined;
+}>;
+/**
+ * Schema for getting a tree for a single repository
+ */
+export declare const GetRepositoryTreeSchema: z.ZodObject<{
+    projectId: z.ZodOptional<z.ZodString>;
+    organizationId: z.ZodOptional<z.ZodString>;
+    repositoryId: z.ZodString;
+    path: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    depth: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    repositoryId: string;
+    depth: number;
+    projectId?: string | undefined;
+    organizationId?: string | undefined;
+}, {
+    repositoryId: string;
+    path?: string | undefined;
+    projectId?: string | undefined;
+    organizationId?: string | undefined;
+    depth?: number | undefined;
+}>;
+/**
+ * Schema for creating a new branch
+ */
+export declare const CreateBranchSchema: z.ZodObject<{
+    projectId: z.ZodOptional<z.ZodString>;
+    organizationId: z.ZodOptional<z.ZodString>;
+    repositoryId: z.ZodString;
+    sourceBranch: z.ZodString;
+    newBranch: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    repositoryId: string;
+    sourceBranch: string;
+    newBranch: string;
+    projectId?: string | undefined;
+    organizationId?: string | undefined;
+}, {
+    repositoryId: string;
+    sourceBranch: string;
+    newBranch: string;
+    projectId?: string | undefined;
+    organizationId?: string | undefined;
+}>;
+/**
+ * Schema for creating a commit with multiple file changes
+ */
+export declare const CreateCommitSchema: z.ZodObject<{
+    projectId: z.ZodOptional<z.ZodString>;
+    organizationId: z.ZodOptional<z.ZodString>;
+    repositoryId: z.ZodString;
+    branchName: z.ZodString;
+    commitMessage: z.ZodString;
+    changes: z.ZodArray<z.ZodEffects<z.ZodObject<{
+        path: z.ZodOptional<z.ZodString>;
+        patch: z.ZodOptional<z.ZodString>;
+        search: z.ZodOptional<z.ZodString>;
+        replace: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        patch?: string | undefined;
+        path?: string | undefined;
+        search?: string | undefined;
+        replace?: string | undefined;
+    }, {
+        patch?: string | undefined;
+        path?: string | undefined;
+        search?: string | undefined;
+        replace?: string | undefined;
+    }>, {
+        patch?: string | undefined;
+        path?: string | undefined;
+        search?: string | undefined;
+        replace?: string | undefined;
+    }, {
+        patch?: string | undefined;
+        path?: string | undefined;
+        search?: string | undefined;
+        replace?: string | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    repositoryId: string;
+    branchName: string;
+    commitMessage: string;
+    changes: {
+        patch?: string | undefined;
+        path?: string | undefined;
+        search?: string | undefined;
+        replace?: string | undefined;
+    }[];
+    projectId?: string | undefined;
+    organizationId?: string | undefined;
+}, {
+    repositoryId: string;
+    branchName: string;
+    commitMessage: string;
+    changes: {
+        patch?: string | undefined;
+        path?: string | undefined;
+        search?: string | undefined;
+        replace?: string | undefined;
+    }[];
+    projectId?: string | undefined;
+    organizationId?: string | undefined;
+}>;
+/**
+ * Schema for listing commits on a branch
+ */
+export declare const ListCommitsSchema: z.ZodObject<{
+    projectId: z.ZodOptional<z.ZodString>;
+    organizationId: z.ZodOptional<z.ZodString>;
+    repositoryId: z.ZodString;
+    branchName: z.ZodString;
+    top: z.ZodOptional<z.ZodNumber>;
+    skip: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    repositoryId: string;
+    branchName: string;
+    projectId?: string | undefined;
+    organizationId?: string | undefined;
+    top?: number | undefined;
+    skip?: number | undefined;
+}, {
+    repositoryId: string;
+    branchName: string;
+    projectId?: string | undefined;
+    organizationId?: string | undefined;
+    top?: number | undefined;
+    skip?: number | undefined;
+}>;

package/dist/features/repositories/schemas.js

@@ -0,0 +1,303 @@
+import { z } from 'zod';
+import { defaultProject, defaultOrg } from '../../utils/environment';
+/**
+ * Schema for getting a repository
+ */
+export const GetRepositorySchema = z.object({
+    projectId: z
+        .string()
+        .optional()
+        .describe(`The ID or name of the project (Default: ${defaultProject})`),
+    organizationId: z
+        .string()
+        .optional()
+        .describe(`The ID or name of the organization (Default: ${defaultOrg})`),
+    repositoryId: z.string().describe('The ID or name of the repository'),
+});
+/**
+ * Schema for getting detailed repository information
+ */
+export const GetRepositoryDetailsSchema = z.object({
+    projectId: z
+        .string()
+        .optional()
+        .describe(`The ID or name of the project (Default: ${defaultProject})`),
+    organizationId: z
+        .string()
+        .optional()
+        .describe(`The ID or name of the organization (Default: ${defaultOrg})`),
+    repositoryId: z.string().describe('The ID or name of the repository'),
+    includeStatistics: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe('Whether to include branch statistics'),
+    includeRefs: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe('Whether to include repository refs'),
+    refFilter: z
+        .string()
+        .optional()
+        .describe('Optional filter for refs (e.g., "heads/" or "tags/")'),
+    branchName: z
+        .string()
+        .optional()
+        .describe('Name of specific branch to get statistics for (if includeStatistics is true)'),
+});
+/**
+ * Schema for listing repositories
+ */
+export const ListRepositoriesSchema = z.object({
+    projectId: z
+        .string()
+        .optional()
+        .describe(`The ID or name of the project (Default: ${defaultProject})`),
+    organizationId: z
+        .string()
+        .optional()
+        .describe(`The ID or name of the organization (Default: ${defaultOrg})`),
+    includeLinks: z
+        .boolean()
+        .optional()
+        .describe('Whether to include reference links'),
+});
+/**
+ * Schema for getting file content
+ */
+export const GetFileContentSchema = z.object({
+    projectId: z
+        .string()
+        .optional()
+        .describe(`The ID or name of the project (Default: ${defaultProject})`),
+    organizationId: z
+        .string()
+        .optional()
+        .describe(`The ID or name of the organization (Default: ${defaultOrg})`),
+    repositoryId: z.string().describe('The ID or name of the repository'),
+    path: z
+        .string()
+        .optional()
+        .default('/')
+        .describe('Path to the file or folder'),
+    version: z
+        .string()
+        .optional()
+        .describe('The version (branch, tag, or commit) to get content from'),
+    versionType: z
+        .enum(['branch', 'commit', 'tag'])
+        .optional()
+        .describe('Type of version specified (branch, commit, or tag)'),
+});
+/**
+ * Schema for getting all repositories tree structure
+ */
+export const GetAllRepositoriesTreeSchema = z.object({
+    organizationId: z
+        .string()
+        .optional()
+        .describe(`The ID or name of the Azure DevOps organization (Default: ${defaultOrg})`),
+    projectId: z
+        .string()
+        .optional()
+        .describe(`The ID or name of the project (Default: ${defaultProject})`),
+    repositoryPattern: z
+        .string()
+        .optional()
+        .describe('Repository name pattern (wildcard characters allowed) to filter which repositories are included'),
+    depth: z
+        .number()
+        .int()
+        .min(0)
+        .max(10)
+        .optional()
+        .default(0)
+        .describe('Maximum depth to traverse within each repository (0 = unlimited)'),
+    pattern: z
+        .string()
+        .optional()
+        .describe('File pattern (wildcard characters allowed) to filter files by within each repository'),
+});
+/**
+ * Schema for getting a tree for a single repository
+ */
+export const GetRepositoryTreeSchema = z.object({
+    projectId: z
+        .string()
+        .optional()
+        .describe(`The ID or name of the project (Default: ${defaultProject})`),
+    organizationId: z
+        .string()
+        .optional()
+        .describe(`The ID or name of the organization (Default: ${defaultOrg})`),
+    repositoryId: z.string().describe('The ID or name of the repository'),
+    path: z
+        .string()
+        .optional()
+        .default('/')
+        .describe('Path within the repository to start from'),
+    depth: z
+        .number()
+        .int()
+        .min(0)
+        .max(10)
+        .optional()
+        .default(0)
+        .describe('Maximum depth to traverse (0 = unlimited)'),
+});
+/**
+ * Schema for creating a new branch
+ */
+export const CreateBranchSchema = z
+    .object({
+    projectId: z
+        .string()
+        .optional()
+        .describe(`The ID or name of the project (Default: ${defaultProject})`),
+    organizationId: z
+        .string()
+        .optional()
+        .describe(`The ID or name of the organization (Default: ${defaultOrg})`),
+    repositoryId: z.string().describe('The ID or name of the repository'),
+    sourceBranch: z
+        .string()
+        .describe('Name of the branch to copy from (without "refs/heads/", e.g., "master")'),
+    newBranch: z
+        .string()
+        .describe('Name of the new branch to create (without "refs/heads/", e.g., "feature/my-branch")'),
+})
+    .describe('Create a new branch from an existing branch.\n' +
+    '- Pass plain branch names (no "refs/heads/"). Example: sourceBranch="master", newBranch="codex/test1".\n' +
+    '- When creating pull requests later, use fully-qualified refs (e.g., "refs/heads/codex/test1").');
+/**
+ * Schema for creating a commit with multiple file changes
+ */
+export const CreateCommitSchema = z
+    .object({
+    projectId: z
+        .string()
+        .optional()
+        .describe(`The ID or name of the project (Default: ${defaultProject})`),
+    organizationId: z
+        .string()
+        .optional()
+        .describe(`The ID or name of the organization (Default: ${defaultOrg})`),
+    repositoryId: z.string().describe('The ID or name of the repository'),
+    branchName: z
+        .string()
+        .describe('The branch to commit to (without "refs/heads/", e.g., "codex/test2-delete-main-py")'),
+    commitMessage: z.string().describe('Commit message'),
+    changes: z
+        .array(z
+        .object({
+        path: z
+            .string()
+            .optional()
+            .describe('File path. Optional for patch format (uses diff header), REQUIRED for search/replace format'),
+        patch: z
+            .string()
+            .optional()
+            .describe([
+            'Unified git diff for a single file.',
+            'MUST include `diff --git`, `--- a/...`, `+++ b/...`, and complete hunk headers.',
+            'CRITICAL: Every hunk header must have line numbers in format: @@ -oldStart,oldLines +newStart,newLines @@',
+            'Do NOT use @@ without the line range numbers - this will cause parsing failures.',
+            'Include 3-5 context lines before and after changes for proper patch application.',
+            'Use `/dev/null` with `---` for new files, or with `+++` for deleted files.',
+            '',
+            'Example modify patch:',
+            '```diff',
+            'diff --git a/charts/bcs-mcp-server/templates/service-api.yaml b/charts/bcs-mcp-server/templates/service-api.yaml',
+            '--- a/charts/bcs-mcp-server/templates/service-api.yaml',
+            '+++ b/charts/bcs-mcp-server/templates/service-api.yaml',
+            '@@ -4,7 +4,7 @@ spec:',
+            ' spec:',
+            '   type: {{ .Values.service.type }}',
+            '   ports:',
+            '-    - port: 8080',
+            '+    - port: 9090',
+            '     targetPort: deployment-port',
+            '     protocol: TCP',
+            '     name: http',
+            '```',
+        ].join('\n')),
+        search: z
+            .string()
+            .optional()
+            .describe([
+            'Alternative to patch: Exact text to search for in the file.',
+            'Must be used with "replace" and "path" fields.',
+            'The server will fetch the file, perform the replacement, and generate the patch automatically.',
+            'This is MUCH EASIER than creating unified diffs manually - no line counting needed!',
+            '',
+            'Example:',
+            '"search": "return axios.post(apiUrl, payload, requestConfig);"',
+            '"replace": "return axios.post(apiUrl, payload, requestConfig).then(r => { /* process */ return r; });"',
+        ].join('\n')),
+        replace: z
+            .string()
+            .optional()
+            .describe('Alternative to patch: Exact text to replace the "search" string with. Must be used together with "search" and "path".'),
+    })
+        .refine((data) => {
+        const hasPatch = !!data.patch;
+        const hasSearchReplace = !!data.search && !!data.replace;
+        return hasPatch || hasSearchReplace;
+    }, {
+        message: 'Either "patch" or both "search" and "replace" must be provided',
+    }))
+        .describe('List of file changes as either unified git diffs OR search/replace pairs'),
+})
+    .describe([
+    'Create a commit on an existing branch using file changes.',
+    '- Provide plain branch names (no "refs/heads/").',
+    '',
+    '**RECOMMENDED: Use search/replace format (easier, no line counting needed!)**',
+    '',
+    'Option 1 - Search/Replace (Easiest):',
+    '```json',
+    '{',
+    '  "changes": [{',
+    '    "path": "src/file.ts",',
+    '    "search": "old code here",',
+    '    "replace": "new code here"',
+    '  }]',
+    '}',
+    '```',
+    '',
+    'Option 2 - Unified Diff (Advanced):',
+    '- Requires complete hunk headers: @@ -oldStart,oldLines +newStart,newLines @@',
+    '- Include 3-5 context lines before/after changes',
+    '- For deletions: --- a/file, +++ /dev/null',
+    '- For additions: --- /dev/null, +++ b/file',
+].join('\n'));
+/**
+ * Schema for listing commits on a branch
+ */
+export const ListCommitsSchema = z.object({
+    projectId: z
+        .string()
+        .optional()
+        .describe(`The ID or name of the project (Default: ${defaultProject})`),
+    organizationId: z
+        .string()
+        .optional()
+        .describe(`The ID or name of the organization (Default: ${defaultOrg})`),
+    repositoryId: z.string().describe('The ID or name of the repository'),
+    branchName: z.string().describe('Branch name to list commits from'),
+    top: z
+        .number()
+        .int()
+        .min(1)
+        .max(100)
+        .optional()
+        .describe('Maximum number of commits to return (Default: 10)'),
+    skip: z
+        .number()
+        .int()
+        .min(0)
+        .optional()
+        .describe('Number of commits to skip from the newest'),
+});
+//# sourceMappingURL=schemas.js.map

package/dist/features/repositories/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../src/features/repositories/schemas.ts"],"names":[],"mappings":"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"}

package/dist/features/repositories/tool-definitions.d.ts

@@ -0,0 +1,5 @@
+import { ToolDefinition } from '../../shared/types/tool-definition';
+/**
+ * List of repositories tools
+ */
+export declare const repositoriesTools: ToolDefinition[];