Upload folder using huggingface_hub

.base-sample/.gitignore

@@ -0,0 +1,4 @@
+out
+node_modules
+.vscode-test/
+*.vsix

.base-sample/.vscode/extensions.json

@@ -0,0 +1,9 @@
+{
+	// See https://go.microsoft.com/fwlink/?LinkId=827846 to learn about workspace recommendations.
+	// Extension identifier format: ${publisher}.${name}. Example: vscode.csharp
+
+	// List of extensions which should be recommended for users of this workspace.
+	"recommendations": [
+		"dbaeumer.vscode-eslint"
+	]
+}

.base-sample/.vscode/launch.json

@@ -0,0 +1,35 @@
+// A launch configuration that compiles the extension and then opens it inside a new window
+// Use IntelliSense to learn about possible attributes.
+// Hover to view descriptions of existing attributes.
+// For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+{
+	"version": "0.2.0",
+	"configurations": [{
+			"name": "Run Extension",
+			"type": "extensionHost",
+			"request": "launch",
+			"runtimeExecutable": "${execPath}",
+			"args": [
+				"--extensionDevelopmentPath=${workspaceFolder}"
+			],
+			"outFiles": [
+				"${workspaceFolder}/out/**/*.js"
+			],
+			"preLaunchTask": "npm: watch"
+		},
+		{
+			"name": "Run Extension Tests",
+			"type": "extensionHost",
+			"request": "launch",
+			"runtimeExecutable": "${execPath}",
+			"args": [
+				"--extensionDevelopmentPath=${workspaceFolder}",
+				"--extensionTestsPath=${workspaceFolder}/out/test"
+			],
+			"outFiles": [
+				"${workspaceFolder}/out/test/**/*.js"
+			],
+			"preLaunchTask": "npm: watch"
+		}
+	]
+}

.base-sample/.vscode/settings.json

@@ -0,0 +1,3 @@
+{
+	"editor.insertSpaces": false
+}

.base-sample/.vscode/tasks.json

@@ -0,0 +1,20 @@
+// See https://go.microsoft.com/fwlink/?LinkId=733558
+// for the documentation about the tasks.json format
+{
+	"version": "2.0.0",
+	"tasks": [
+		{
+			"type": "npm",
+			"script": "watch",
+			"problemMatcher": "$tsc-watch",
+			"isBackground": true,
+			"presentation": {
+				"reveal": "never"
+			},
+			"group": {
+				"kind": "build",
+				"isDefault": true
+			}
+		}
+	]
+}

.base-sample/.vscodeignore

@@ -0,0 +1,8 @@
+.vscode/**
+.vscode-test/**
+out/test/**
+out/**/*.map
+src/**
+.gitignore
+tsconfig.json
+vsc-extension-quickstart.md

.base-sample/README.md

@@ -0,0 +1,5 @@
+# Base Sample
+
+This sample is similar to the [helloworld-sample](../helloworld-sample), but it follows the [Sample Guideline](https://github.com/Microsoft/vscode-extension-samples/blob/main/.github/SAMPLE_GUIDELINE.md).
+
+You can easily write a new sample following the guideline by `cp -r .base-sample my-sample`.

.base-sample/eslint.config.mjs

@@ -0,0 +1,44 @@
+/**
+ * ESLint configuration for the project.
+ * 
+ * See https://eslint.style and https://typescript-eslint.io for additional linting options.
+ */
+// @ts-check
+import js from '@eslint/js';
+import tseslint from 'typescript-eslint';
+import stylistic from '@stylistic/eslint-plugin';
+
+export default tseslint.config(
+	{
+		ignores: [
+			'.vscode-test',
+			'out',
+		]
+	},
+	js.configs.recommended,
+	...tseslint.configs.recommended,
+	...tseslint.configs.stylistic,
+	{
+		plugins: {
+			'@stylistic': stylistic
+		},
+		rules: {
+			'curly': 'warn',
+			'@stylistic/semi': ['warn', 'always'],
+			'@typescript-eslint/no-empty-function': 'off',
+			'@typescript-eslint/naming-convention': [
+				'warn',
+				{
+					'selector': 'import',
+					'format': ['camelCase', 'PascalCase']
+				}
+			],
+			'@typescript-eslint/no-unused-vars': [
+				'error',
+				{
+					'argsIgnorePattern': '^_'
+				}
+			]
+		}
+	}
+);

.base-sample/package.json

@@ -0,0 +1,44 @@
+{
+	"name": "base-sample",
+	"displayName": "base-sample",
+	"description": "Base sample for other samples at Microsoft/vscode-extension-samples",
+	"version": "0.0.1",
+	"publisher": "vscode-samples",
+	"private": true,
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/Microsoft/vscode-extension-samples"
+	},
+	"engines": {
+		"vscode": "^1.100.0"
+	},
+	"categories": [
+		"Other"
+	],
+	"activationEvents": [],
+	"main": "./out/extension.js",
+	"contributes": {
+		"commands": [
+			{
+				"command": "extension.helloWorld",
+				"title": "Hello World"
+			}
+		]
+	},
+	"scripts": {
+		"vscode:prepublish": "npm run compile",
+		"compile": "tsc -p ./",
+		"lint": "eslint",
+		"watch": "tsc -watch -p ./"
+	},
+	"devDependencies": {
+		"@eslint/js": "^9.13.0",
+		"@stylistic/eslint-plugin": "^2.9.0",
+		"@types/node": "^22",
+		"@types/vscode": "^1.100.0",
+		"eslint": "^9.13.0",
+		"typescript": "^5.8.2",
+		"typescript-eslint": "^8.26.0"
+	}
+}

.base-sample/src/extension.ts

@@ -0,0 +1,23 @@
+// The module 'vscode' contains the VS Code extensibility API
+// Import the module and reference it with the alias vscode in your code below
+import * as vscode from 'vscode';
+
+// this method is called when your extension is activated
+// your extension is activated the very first time the command is executed
+export function activate(context: vscode.ExtensionContext) {
+	// Use the console to output diagnostic information (console.log) and errors (console.error)
+	// This line of code will only be executed once when your extension is activated
+	console.log('Congratulations, your extension "helloworld-sample" is now active!');
+
+	// The command has been defined in the package.json file
+	// Now provide the implementation of the command with registerCommand
+	// The commandId parameter must match the command field in package.json
+	const disposable = vscode.commands.registerCommand('extension.helloWorld', () => {
+		// The code you place here will be executed every time your command is executed
+
+		// Display a message box to the user
+		vscode.window.showInformationMessage('Hello World!');
+	});
+
+	context.subscriptions.push(disposable);
+}

.base-sample/tsconfig.json

@@ -0,0 +1,17 @@
+{
+	"compilerOptions": {
+		"module": "commonjs",
+		"target": "ES2024",
+		"lib": [
+			"ES2024"
+		],
+		"outDir": "out",
+		"sourceMap": true,
+		"rootDir": "src",
+		"strict": true
+	},
+	"exclude": [
+		"node_modules",
+		".vscode-test"
+	]
+}

.editorconfig

@@ -0,0 +1,3 @@
+[*.{ts,tsx,js,jsx,json}]
+indent_style = tab
+tab_width = 4

.gitattributes

@@ -33,3 +33,40 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
 *.zip filter=lfs diff=lfs merge=lfs -text
 *.zst filter=lfs diff=lfs merge=lfs -text
 *tfevents* filter=lfs diff=lfs merge=lfs -text
+.base-sample/demo.gif filter=lfs diff=lfs merge=lfs -text
+basic-multi-root-sample/preview.gif filter=lfs diff=lfs merge=lfs -text
+call-hierarchy-sample/demo.gif filter=lfs diff=lfs merge=lfs -text
+chat-sample/demo.png filter=lfs diff=lfs merge=lfs -text
+code-actions-sample/example.gif filter=lfs diff=lfs merge=lfs -text
+code-actions-sample/example_diagnostic.gif filter=lfs diff=lfs merge=lfs -text
+codelens-sample/demo.gif filter=lfs diff=lfs merge=lfs -text
+comment-sample/wiki-demo.gif filter=lfs diff=lfs merge=lfs -text
+completions-sample/demo.gif filter=lfs diff=lfs merge=lfs -text
+contentprovider-sample/preview.gif filter=lfs diff=lfs merge=lfs -text
+custom-data-sample/demo.gif filter=lfs diff=lfs merge=lfs -text
+custom-editor-sample/documentation/example.png filter=lfs diff=lfs merge=lfs -text
+diagnostic-related-information-sample/resources/diagnostic-related-info.png filter=lfs diff=lfs merge=lfs -text
+document-editing-sample/demo.gif filter=lfs diff=lfs merge=lfs -text
+fsprovider-sample/sample.png filter=lfs diff=lfs merge=lfs -text
+getting-started-sample/media/preview.png filter=lfs diff=lfs merge=lfs -text
+getting-started-sample/media/sample.png filter=lfs diff=lfs merge=lfs -text
+github-authentication-sample/demo.gif filter=lfs diff=lfs merge=lfs -text
+helloworld-sample/demo.gif filter=lfs diff=lfs merge=lfs -text
+helloworld-test-sample/demo.gif filter=lfs diff=lfs merge=lfs -text
+inline-completions/demo.gif filter=lfs diff=lfs merge=lfs -text
+jupyter-server-provider-sample/demo.gif filter=lfs diff=lfs merge=lfs -text
+lsp-log-streaming-sample/demo.gif filter=lfs diff=lfs merge=lfs -text
+notebook-renderer-sample/notebook-renderer-sample.gif filter=lfs diff=lfs merge=lfs -text
+notifications-sample/demo.gif filter=lfs diff=lfs merge=lfs -text
+quickinput-sample/preview.gif filter=lfs diff=lfs merge=lfs -text
+source-control-sample/resources/images/demo.gif filter=lfs diff=lfs merge=lfs -text
+source-control-sample/resources/images/multi-workspace-folder.gif filter=lfs diff=lfs merge=lfs -text
+statusbar-sample/preview.gif filter=lfs diff=lfs merge=lfs -text
+theme-sample/demo-dark.png filter=lfs diff=lfs merge=lfs -text
+theme-sample/demo-light.png filter=lfs diff=lfs merge=lfs -text
+tree-view-sample/resources/package-explorer.png filter=lfs diff=lfs merge=lfs -text
+vim-sample/example.gif filter=lfs diff=lfs merge=lfs -text
+virtual-document-sample/cowsay.gif filter=lfs diff=lfs merge=lfs -text
+webview-codicons-sample/demo.gif filter=lfs diff=lfs merge=lfs -text
+webview-sample/demo.gif filter=lfs diff=lfs merge=lfs -text
+webview-sample/media/cat.gif filter=lfs diff=lfs merge=lfs -text

.github/CONTRIBUTING.md

@@ -0,0 +1,3 @@
+# Contributing to vscode-extension-samples
+
+If you want to contribute a new sample, see [Sample Guideline](./SAMPLE_GUIDELINE.md)

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,8 @@
+blank_issues_enabled: false
+contact_links:
+  - name: 🙋 Ask Question
+    about: Ask questions about developing VS Code extensions on Stack Overflow.
+    url: 'https://stackoverflow.com/questions/tagged/vscode-extensions'
+  - name: 💬 Discuss
+    url: https://github.com/microsoft/vscode-discussions/discussions
+    about: Discuss extension development questions and ideas with the VS Code developer community.

.github/ISSUE_TEMPLATE/report-issue.yml

@@ -0,0 +1,35 @@
+name: 🐛 Report Extension Sample Issue
+description: Report an issue with one of the extension samples.
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thank you for taking the time to fill out this bug report! Please make sure to fill in the following sections:
+  - type: input
+    id: sample-name
+    attributes:
+      label: Extension sample
+      description: Name of the extension sample that you are reporting with issue in
+      placeholder: extension-sample-name
+    validations:
+      required: true
+  - type: input
+    id: vscode-version
+    attributes:
+      label: VS Code version
+      description: The version of VS Code that the issue reproduces in
+      placeholder: 1.xx.x
+    validations:
+      required: true
+  - type: textarea
+    id: what-happened
+    attributes:
+      label: What went wrong?
+      description: |
+        Tell us what what went wrong. Be sure to include:
+
+        - What were you trying to do?
+        - What went wrong?
+        - What was the expected behavior?
+    validations:
+      required: true

.github/SAMPLE_GUIDELINE.md

@@ -0,0 +1,40 @@
+# Sample Guideline
+
+Each sample should have the following components and structure, so that users could have a smooth experience when playing with different samples.
+The quickest way is to start your project by copying [.base-sample](https://github.com/microsoft/vscode-extension-samples/tree/main/.base-sample).
+
+## 1: Sample Listing
+
+- 1.1: Each sample should add itself to the sample listing at `.scripts/samples.js`. This file will be used for generating tables in the README and on the [Extension Guides / Overview](https://code.visualstudio.com/api/extension-guides/overview) topic of the website.
+- 1.2: Each sample should list the API / Contribution that it means to illustrate.
+
+## 2: README
+
+- 2.1: Each README should start with a short sentence / paragraph that describes what the extensions is and what it is meant to illustrate.
+- 2.2: If the sample has a corresponding guide, it should link to the guide.
+- 2.3: If the illustrated functionality is visual, a gif/image should follow the explanation. (File should be demo.png/gif/jpg. Use default Dark+/Light+ theme)
+- 2.4: A `VS Code API` section listing the illustrated API, Contribution Points and Activation Events.
+- 2.5: A `Running the Sample` section should describe the actions to run the sample.
+
+## 3: .vscode
+
+- 3.1: `launch.json`: use 0.2.0 version.
+- 3.2: `settings.json`: use `"editor.insertSpaces": false`. This ensures when user opens the subfolder, tab indentation is enforced.
+
+## 4: Dependencies
+
+- 4.1: Use `npm`'s `package-lock.json` instead of `yarn.lock`.
+- 4.2: `devDependencies` should include `@types/node`, `@types/vscode`, `@typescript-eslint/eslint-plugin`, `@typescript-eslint/parser`, `eslint`, and `typescript`.
+
+## 5: Formatter and Linter
+
+Only deviate from the standard setting if your sample needs to.
+
+- 5.1: Include a `.eslintrc.js` following <https://github.com/microsoft/vscode-extension-samples/blob/main/helloworld-sample/.eslintrc.js>.
+- 5.2: Include a `tsconfig.json` following <https://github.com/microsoft/vscode-extension-samples/blob/main/helloworld-sample/tsconfig.json>.
+- 5.3: Your source code should be formatted either using [tsfmt](https://github.com/vvakame/typescript-formatter) or the editor's TS formatter and contain no ESLint/TS errors.
+
+## 6: Tests
+
+- 6.1: If your extension does not have meaningful tests, remove the `src/test` folder.
+- 6.2: If your extension can be meaningfully tested, include a sample test. If you have an associated guide, explain the test in the guide.

.github/commands.json

@@ -0,0 +1,400 @@
+[
+	{
+		"type": "comment",
+		"name": "question",
+		"allowUsers": [
+			"cleidigh",
+			"usernamehw",
+			"gjsjohnmurray",
+			"IllusionMH"
+		],
+		"action": "updateLabels",
+		"addLabel": "*question"
+	},
+	{
+		"type": "comment",
+		"name": "needsPerfInfo",
+		"allowUsers": [
+			"cleidigh",
+			"usernamehw",
+			"gjsjohnmurray",
+			"IllusionMH"
+		],
+		"addLabel": "info-needed",
+		"comment": "Thanks for creating this issue regarding performance! Please follow this guide to help us diagnose performance issues: https://github.com/microsoft/vscode/wiki/Performance-Issues \n\nHappy Coding!"
+	},
+	{
+		"type": "label",
+		"name": "*question",
+		"action": "close",
+		"comment": "Please ask your question on [StackOverflow](https://aka.ms/vscodestackoverflow). We have a great community over [there](https://aka.ms/vscodestackoverflow). They have already answered thousands of questions and are happy to answer yours as well. See also our [issue reporting](https://aka.ms/vscodeissuereporting) guidelines.\n\nHappy Coding!"
+	},
+	{
+		"type": "label",
+		"name": "*dev-question",
+		"action": "close",
+		"comment": "We have a great developer community [over on slack](https://aka.ms/vscode-dev-community) where extension authors help each other. This is a great place for you to ask questions and find support.\n\nHappy Coding!"
+	},
+	{
+		"type": "label",
+		"name": "*extension-candidate",
+		"action": "close",
+		"comment": "We try to keep VS Code lean and we think the functionality you're asking for is great for a VS Code extension. Maybe you can already find one that suits you in the [VS Code Marketplace](https://aka.ms/vscodemarketplace). Just in case, in a few simple steps you can get started [writing your own extension](https://aka.ms/vscodewritingextensions). See also our [issue reporting](https://aka.ms/vscodeissuereporting) guidelines.\n\nHappy Coding!"
+	},
+	{
+		"type": "label",
+		"name": "*not-reproducible",
+		"action": "close",
+		"comment": "We closed this issue because we are unable to reproduce the problem with the steps you describe. Chances are we've already fixed your problem in a recent version of VS Code. If not, please ask us to reopen the issue and provide us with more detail. Our [issue reporting](https://aka.ms/vscodeissuereporting) guidelines might help you with that.\n\nHappy Coding!"
+	},
+	{
+		"type": "label",
+		"name": "*out-of-scope",
+		"action": "close",
+		"comment": "We closed this issue because we don't plan to address it in the foreseeable future. You can find more detailed information about our decision-making process [here](https://aka.ms/vscode-out-of-scope). If you disagree and feel that this issue is crucial: We are happy to listen and to reconsider.\n\nIf you wonder what we are up to, please see our [roadmap](https://aka.ms/vscoderoadmap) and [issue reporting](https://aka.ms/vscodeissuereporting) guidelines.\n\nThanks for your understanding and happy coding!"
+	},
+	{
+		"type": "comment",
+		"name": "causedByExtension",
+		"allowUsers": [
+			"cleidigh",
+			"usernamehw",
+			"gjsjohnmurray",
+			"IllusionMH"
+		],
+		"action": "updateLabels",
+		"addLabel": "*caused-by-extension"
+	},
+	{
+		"type": "label",
+		"name": "*caused-by-extension",
+		"action": "close",
+		"comment": "This issue is caused by an extension, please file it with the repository (or contact) the extension has linked in its overview in VS Code or the [marketplace](https://aka.ms/vscodemarketplace) for VS Code. See also our [issue reporting](https://aka.ms/vscodeissuereporting) guidelines.\n\nHappy Coding!"
+	},
+	{
+		"type": "label",
+		"name": "*as-designed",
+		"action": "close",
+		"comment": "The described behavior is how it is expected to work. If you disagree, please explain what is expected and what is not in more detail. See also our [issue reporting](https://aka.ms/vscodeissuereporting) guidelines.\n\nHappy Coding!"
+	},
+	{
+		"type": "comment",
+		"name": "duplicate",
+		"allowUsers": [
+			"cleidigh",
+			"usernamehw",
+			"gjsjohnmurray",
+			"IllusionMH"
+		],
+		"action": "updateLabels",
+		"addLabel": "*duplicate"
+	},
+	{
+		"type": "label",
+		"name": "*duplicate",
+		"action": "close",
+		"comment": "Thanks for creating this issue! We figured it's covering the same as another one we already have. Thus, we closed this one as a duplicate. You can search for existing issues [here](https://aka.ms/vscodeissuesearch). See also our [issue reporting](https://aka.ms/vscodeissuereporting) guidelines.\n\nHappy Coding!"
+	},
+	{
+		"type": "comment",
+		"name": "verified",
+		"allowUsers": [
+			"@author"
+		],
+		"action": "updateLabels",
+		"addLabel": "z-author-verified",
+		"removeLabel": "author-verification-requested",
+		"requireLabel": "author-verification-requested",
+		"disallowLabel": "awaiting-insiders-release"
+	},
+	{
+		"type": "comment",
+		"name": "confirm",
+		"allowUsers": [
+			"cleidigh",
+			"usernamehw",
+			"gjsjohnmurray",
+			"IllusionMH"
+		],
+		"action": "updateLabels",
+		"addLabel": "confirmed",
+		"removeLabel": "confirmation-pending"
+	},
+	{
+		"type": "comment",
+		"name": "confirmationPending",
+		"allowUsers": [
+			"cleidigh",
+			"usernamehw",
+			"gjsjohnmurray",
+			"IllusionMH"
+		],
+		"action": "updateLabels",
+		"addLabel": "confirmation-pending",
+		"removeLabel": "confirmed"
+	},
+	{
+		"type": "comment",
+		"name": "needsMoreInfo",
+		"allowUsers": [
+			"cleidigh",
+			"usernamehw",
+			"gjsjohnmurray",
+			"IllusionMH"
+		],
+		"action": "updateLabels",
+		"addLabel": "~info-needed"
+	},
+	{
+		"type": "comment",
+		"name": "jsDebugLogs",
+		"action": "updateLabels",
+		"addLabel": "info-needed",
+		"comment": "Please collect trace logs using the following instructions:\n\n> If you're able to, add `\"trace\": true` to your `launch.json` and reproduce the issue. The location of the log file on your disk will be written to the Debug Console. Share that with us.\n>\n> ⚠️ This log file will not contain source code, but will contain file paths. You can drop it into https://microsoft.github.io/vscode-pwa-analyzer/index.html to see what it contains. If you'd rather not share the log publicly, you can email it to connor@xbox.com"
+	},
+	{
+		"type": "comment",
+		"name": "closedWith",
+		"allowUsers": [
+			"cleidigh",
+			"usernamehw",
+			"gjsjohnmurray",
+			"IllusionMH"
+		],
+		"action": "close",
+		"addLabel": "unreleased"
+	},
+	{
+		"type": "label",
+		"name": "~info-needed",
+		"action": "updateLabels",
+		"addLabel": "info-needed",
+		"removeLabel": "~info-needed",
+		"comment": "Thanks for creating this issue! We figured it's missing some basic information or in some other way doesn't follow our [issue reporting](https://aka.ms/vscodeissuereporting) guidelines. Please take the time to review these and update the issue.\n\nHappy Coding!"
+	},
+	{
+		"type": "label",
+		"name": "~version-info-needed",
+		"action": "updateLabels",
+		"addLabel": "info-needed",
+		"removeLabel": "~version-info-needed",
+		"comment": "Thanks for creating this issue! We figured it's missing some basic information, such as a version number, or in some other way doesn't follow our [issue reporting guidelines](https://aka.ms/vscodeissuereporting). Please take the time to review these and update the issue.\n\nHappy Coding!"
+	},
+	{
+		"type": "comment",
+		"name": "a11ymas",
+		"allowUsers": [
+			"AccessibilityTestingTeam-TCS",
+			"dixitsonali95",
+			"Mohini78",
+			"ChitrarupaSharma",
+			"mspatil110",
+			"umasarath52",
+			"v-umnaik"
+		],
+		"action": "updateLabels",
+		"addLabel": "a11ymas"
+	},
+	{
+		"type": "label",
+		"name": "*off-topic",
+		"action": "close",
+		"comment": "Thanks for creating this issue. We think this issue is unactionable or unrelated to the goals of this project. Please follow our [issue reporting](https://aka.ms/vscodeissuereporting) guidelines.\n\nHappy Coding!"
+	},
+	{
+		"type": "comment",
+		"name": "extPython",
+		"allowUsers": [
+			"cleidigh",
+			"usernamehw",
+			"gjsjohnmurray",
+			"IllusionMH"
+		],
+		"action": "close",
+		"addLabel": "*caused-by-extension",
+		"comment": "It looks like this is caused by the Python extension. Please file it with the repository [here](https://github.com/microsoft/vscode-python). Make sure to check their issue reporting template and provide them relevant information such as the extension version you're using. See also our [issue reporting](https://aka.ms/vscodeissuereporting) guidelines for more information.\n\nHappy Coding!"
+	},
+	{
+		"type": "comment",
+		"name": "extC",
+		"allowUsers": [
+			"cleidigh",
+			"usernamehw",
+			"gjsjohnmurray",
+			"IllusionMH"
+		],
+		"action": "close",
+		"addLabel": "*caused-by-extension",
+		"comment": "It looks like this is caused by the C extension. Please file it with the repository [here](https://github.com/microsoft/vscode-cpptools). Make sure to check their issue reporting template and provide them relevant information such as the extension version you're using. See also our [issue reporting](https://aka.ms/vscodeissuereporting) guidelines for more information.\n\nHappy Coding!"
+	},
+	{
+		"type": "comment",
+		"name": "extC++",
+		"allowUsers": [
+			"cleidigh",
+			"usernamehw",
+			"gjsjohnmurray",
+			"IllusionMH"
+		],
+		"action": "close",
+		"addLabel": "*caused-by-extension",
+		"comment": "It looks like this is caused by the C++ extension. Please file it with the repository [here](https://github.com/microsoft/vscode-cpptools). Make sure to check their issue reporting template and provide them relevant information such as the extension version you're using. See also our [issue reporting](https://aka.ms/vscodeissuereporting) guidelines for more information.\n\nHappy Coding!"
+	},
+	{
+		"type": "comment",
+		"name": "extCpp",
+		"allowUsers": [
+			"cleidigh",
+			"usernamehw",
+			"gjsjohnmurray",
+			"IllusionMH"
+		],
+		"action": "close",
+		"addLabel": "*caused-by-extension",
+		"comment": "It looks like this is caused by the C++ extension. Please file it with the repository [here](https://github.com/microsoft/vscode-cpptools). Make sure to check their issue reporting template and provide them relevant information such as the extension version you're using. See also our [issue reporting](https://aka.ms/vscodeissuereporting) guidelines for more information.\n\nHappy Coding!"
+	},
+	{
+		"type": "comment",
+		"name": "extTS",
+		"allowUsers": [
+			"cleidigh",
+			"usernamehw",
+			"gjsjohnmurray",
+			"IllusionMH"
+		],
+		"action": "close",
+		"addLabel": "*caused-by-extension",
+		"comment": "It looks like this is caused by the TypeScript language service. Please file it with the repository [here](https://github.com/microsoft/TypeScript/). Make sure to check their [contributing guidelines](https://github.com/microsoft/TypeScript/blob/master/CONTRIBUTING.md) and provide relevant information such as the extension version you're using. See also our [issue reporting](https://aka.ms/vscodeissuereporting) guidelines for more information.\n\nHappy Coding!"
+	},
+	{
+		"type": "comment",
+		"name": "extJS",
+		"allowUsers": [
+			"cleidigh",
+			"usernamehw",
+			"gjsjohnmurray",
+			"IllusionMH"
+		],
+		"action": "close",
+		"addLabel": "*caused-by-extension",
+		"comment": "It looks like this is caused by the TypeScript/JavaScript language service. Please file it with the repository [here](https://github.com/microsoft/TypeScript/). Make sure to check their [contributing guidelines](https://github.com/microsoft/TypeScript/blob/master/CONTRIBUTING.md) and provide relevant information such as the extension version you're using. See also our [issue reporting](https://aka.ms/vscodeissuereporting) guidelines for more information.\n\nHappy Coding!"
+	},
+	{
+		"type": "comment",
+		"name": "extC#",
+		"allowUsers": [
+			"cleidigh",
+			"usernamehw",
+			"gjsjohnmurray",
+			"IllusionMH"
+		],
+		"action": "close",
+		"addLabel": "*caused-by-extension",
+		"comment": "It looks like this is caused by the C# extension. Please file it with the repository [here](https://github.com/OmniSharp/omnisharp-vscode.git). Make sure to check their issue reporting template and provide them relevant information such as the extension version you're using. See also our [issue reporting](https://aka.ms/vscodeissuereporting) guidelines for more information.\n\nHappy Coding!"
+	},
+	{
+		"type": "comment",
+		"name": "extGo",
+		"allowUsers": [
+			"cleidigh",
+			"usernamehw",
+			"gjsjohnmurray",
+			"IllusionMH"
+		],
+		"action": "close",
+		"addLabel": "*caused-by-extension",
+		"comment": "It looks like this is caused by the Go extension. Please file it with the repository [here](https://github.com/golang/vscode-go). Make sure to check their issue reporting template and provide them relevant information such as the extension version you're using. See also our [issue reporting](https://aka.ms/vscodeissuereporting) guidelines for more information.\n\nHappy Coding!"
+	},
+	{
+		"type": "comment",
+		"name": "extPowershell",
+		"allowUsers": [
+			"cleidigh",
+			"usernamehw",
+			"gjsjohnmurray",
+			"IllusionMH"
+		],
+		"action": "close",
+		"addLabel": "*caused-by-extension",
+		"comment": "It looks like this is caused by the PowerShell extension. Please file it with the repository [here](https://github.com/PowerShell/vscode-powershell). Make sure to check their issue reporting template and provide them relevant information such as the extension version you're using. See also our [issue reporting](https://aka.ms/vscodeissuereporting) guidelines for more information.\n\nHappy Coding!"
+	},
+	{
+		"type": "comment",
+		"name": "extLiveShare",
+		"allowUsers": [
+			"cleidigh",
+			"usernamehw",
+			"gjsjohnmurray",
+			"IllusionMH"
+		],
+		"action": "close",
+		"addLabel": "*caused-by-extension",
+		"comment": "It looks like this is caused by the LiveShare extension. Please file it with the repository [here](https://github.com/MicrosoftDocs/live-share). Make sure to check their [contributing guidelines](https://github.com/MicrosoftDocs/live-share/blob/master/CONTRIBUTING.md) and provide relevant information such as the extension version you're using. See also our [issue reporting](https://aka.ms/vscodeissuereporting) guidelines for more information.\n\nHappy Coding!"
+	},
+	{
+		"type": "comment",
+		"name": "extDocker",
+		"allowUsers": [
+			"cleidigh",
+			"usernamehw",
+			"gjsjohnmurray",
+			"IllusionMH"
+		],
+		"action": "close",
+		"addLabel": "*caused-by-extension",
+		"comment": "It looks like this is caused by the Docker extension. Please file it with the repository [here](https://github.com/microsoft/vscode-docker). Make sure to check their issue reporting template and provide them relevant information such as the extension version you're using. See also our [issue reporting](https://aka.ms/vscodeissuereporting) guidelines for more information.\n\nHappy Coding!"
+	},
+	{
+		"type": "comment",
+		"name": "extJava",
+		"allowUsers": [
+			"cleidigh",
+			"usernamehw",
+			"gjsjohnmurray",
+			"IllusionMH"
+		],
+		"action": "close",
+		"addLabel": "*caused-by-extension",
+		"comment": "It looks like this is caused by the Java extension. Please file it with the repository [here](https://github.com/redhat-developer/vscode-java). Make sure to check their [troubleshooting instructions](https://github.com/redhat-developer/vscode-java/wiki/Troubleshooting) and provide relevant information such as the extension version you're using. See also our [issue reporting](https://aka.ms/vscodeissuereporting) guidelines for more information.\n\nHappy Coding!"
+	},
+	{
+		"type": "comment",
+		"name": "extJavaDebug",
+		"allowUsers": [
+			"cleidigh",
+			"usernamehw",
+			"gjsjohnmurray",
+			"IllusionMH"
+		],
+		"action": "close",
+		"addLabel": "*caused-by-extension",
+		"comment": "It looks like this is caused by the Java Debugger extension. Please file it with the repository [here](https://github.com/microsoft/vscode-java-debug). Make sure to check their issue reporting template and provide them relevant information such as the extension version you're using. See also our [issue reporting](https://aka.ms/vscodeissuereporting) guidelines for more information.\n\nHappy Coding!"
+	},
+	{
+		"type": "comment",
+		"name": "gifPlease",
+		"allowUsers": [
+			"cleidigh",
+			"usernamehw",
+			"gjsjohnmurray",
+			"IllusionMH"
+		],
+		"action": "comment",
+		"comment": "Thanks for reporting this issue! Unfortunately, it's hard for us to understand what issue you're seeing. Please help us out by providing a screen recording showing exactly what isn't working as expected. While we can work with most standard formats, `.gif` files are preferred as they are displayed inline on GitHub. You may find https://gifcap.dev helpful as a browser-based gif recording tool.\n\nIf the issue depends on keyboard input, you can help us by enabling screencast mode for the recording (`Developer: Toggle Screencast Mode` in the command palette).\n\nHappy coding!"
+	},
+	{
+		"type": "comment",
+		"name": "label",
+		"allowUsers": []
+	},
+	{
+		"type": "comment",
+		"name": "assign",
+		"allowUsers": [
+			"cleidigh",
+			"usernamehw",
+			"gjsjohnmurray",
+			"IllusionMH"
+		]
+	}
+]

.github/workflows/ci.yml

@@ -0,0 +1,16 @@
+name: CI
+
+on:
+  pull_request:
+    branches:
+      - main
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+      - run: npm ci --workspaces=false
+      - run: npm run validate

.github/workflows/npm-publish.yml

@@ -0,0 +1,33 @@
+# This workflow will run tests using node and then publish a package to GitHub Packages when a release is created
+# For more information see: https://docs.github.com/en/actions/publishing-packages/publishing-nodejs-packages
+
+name: Node.js Package
+
+on:
+  release:
+    types: [created]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+      - run: npm ci
+      - run: npm test
+
+  publish-npm:
+    needs: build
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          registry-url: https://registry.npmjs.org/
+      - run: npm ci
+      - run: npm publish
+        env:
+          NODE_AUTH_TOKEN: ${{secrets.npm_token}}

.github/workflows/triage.yml

@@ -0,0 +1,50 @@
+name: Triage Opened Issues
+on:
+  issues:
+    types: [opened]
+
+permissions:
+  issues: write
+
+jobs:
+  assign_triage_label:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Assign Triage Label
+        if: ${{ join(github.event.issue.labels) == '' && join(github.event.issue.assignees) == '' }}
+        uses: actions-ecosystem/action-add-labels@v1
+        with:
+          labels: triage-needed
+          number: ${{ github.event.issue.number }}
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+
+  assign_random_user:
+    needs: assign_triage_label
+    runs-on: ubuntu-latest
+    steps:
+      - name: Assign Random User
+        run: |
+          echo "Waiting a few seconds before assigning..."
+          sleep 30
+          assignees=$(gh issue view ${{ github.event.issue.number }} --repo ${{ github.repository }} --json assignees)
+          if echo "$assignees" | grep -q '"login"'; then
+            echo "The issue has assignees. "
+            exit 0
+          else
+            echo "The issue has no assignee(s)."
+            if ! gh issue view ${{ github.event.issue.number }} --repo ${{ github.event.repository.full_name }} --json labels | grep "triage-needed"; then
+              echo "Skipping triage assignment since triage-needed label is not present"
+            exit 0
+            fi
+            users=("isidorn" "jrieken" "roblourens" "aeschli" "mjbvz" "connor4312" "Tyriar" "Yoyokrazy" "andreamah" "joyceerhl" "alexr00" "bpasero" "rebornix" "chrmarti" "lramos15" "hediet" "alexdima" "rzhao271" "bhavyaus")
+            if [[ " ${users[@]} " =~ " ${{ github.event.issue.user.login }} " ]]; then
+              echo "Issue author is in the users list, skipping random assignment."
+              exit 0
+            else
+              random_user=${users[$RANDOM % ${#users[@]}]}
+              echo "Assigning issue to $random_user"
+              gh issue edit ${{ github.event.issue.number }} --add-assignee $random_user --repo ${{ github.repository }}
+            fi
+          fi
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.gitignore

@@ -0,0 +1,13 @@
+.DS_Store
+npm-debug.log
+Thumbs.db
+**/node_modules/
+*/out/
+*/.vs/
+tsconfig.lsif.json
+*.lsif
+*.db
+*.tsbuildinfo
+
+# Don't check in API files. These should be pulled in during install
+vscode*.d.ts

.lsifrc.json

@@ -0,0 +1,4 @@
+{
+	"project": "tsconfig.lsif.json",
+	"out": "vscode-extension-samples.lsif"
+}

.prettierrc.json

@@ -0,0 +1,5 @@
+{
+	"useTabs": true,
+	"singleQuote": true,
+	"printWidth": 92
+}

.scripts/copy-into.ts

@@ -0,0 +1,23 @@
+/**
+ * Copies a file into every sample, overwriting the existing file if it exists.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { lspSamples, samples } from './samples';
+
+if (require.main === module) {
+	const filePath = process.argv[2];
+	if (!filePath) {
+		console.error('Please provide a file path as the argument.');
+		process.exit(1);
+	}
+
+	const fileName = path.basename(filePath);
+	const fileContent = fs.readFileSync(filePath);
+
+	for (const sample of [...samples, ...lspSamples]) {
+		const destinationPath = path.join(sample.path, fileName);
+		fs.writeFileSync(destinationPath, fileContent);
+		console.log(`Copied ${fileName} to ${sample.path}`);
+	}
+}

.scripts/format.ts

@@ -0,0 +1,82 @@
+import * as fs from 'fs';
+import * as glob from 'glob';
+import * as ts from 'typescript';
+
+class LanguageServiceHost implements ts.LanguageServiceHost {
+	files: ts.MapLike<ts.IScriptSnapshot> = {};
+	addFile(fileName: string, text: string) {
+		this.files[fileName] = ts.ScriptSnapshot.fromString(text);
+	}
+
+	fileExists(path: string): boolean {
+		return !!this.files[path];
+	}
+
+	readFile(path: string): string | undefined {
+		return this.files[path]?.getText(0, this.files[path]!.getLength());
+	}
+
+	// for ts.LanguageServiceHost
+
+	getCompilationSettings = () => ts.getDefaultCompilerOptions();
+	getScriptFileNames = () => Object.keys(this.files);
+	getScriptVersion = (_fileName: string) => '0';
+	getScriptSnapshot = (fileName: string) => this.files[fileName];
+	getCurrentDirectory = () => process.cwd();
+	getDefaultLibFileName = (options: ts.CompilerOptions) => ts.getDefaultLibFilePath(options);
+}
+
+const defaults: ts.FormatCodeSettings = {
+	baseIndentSize: 0,
+	indentSize: 4,
+	tabSize: 4,
+	indentStyle: ts.IndentStyle.Smart,
+	newLineCharacter: '\r\n',
+	convertTabsToSpaces: false,
+	insertSpaceAfterCommaDelimiter: true,
+	insertSpaceAfterSemicolonInForStatements: true,
+	insertSpaceBeforeAndAfterBinaryOperators: true,
+	insertSpaceAfterConstructor: false,
+	insertSpaceAfterKeywordsInControlFlowStatements: true,
+	insertSpaceAfterFunctionKeywordForAnonymousFunctions: false,
+	insertSpaceAfterOpeningAndBeforeClosingNonemptyParenthesis: false,
+	insertSpaceAfterOpeningAndBeforeClosingNonemptyBrackets: false,
+	insertSpaceAfterOpeningAndBeforeClosingNonemptyBraces: true,
+	insertSpaceAfterOpeningAndBeforeClosingTemplateStringBraces: false,
+	insertSpaceAfterOpeningAndBeforeClosingJsxExpressionBraces: false,
+	insertSpaceAfterTypeAssertion: false,
+	insertSpaceBeforeFunctionParenthesis: false,
+	placeOpenBraceOnNewLineForFunctions: false,
+	placeOpenBraceOnNewLineForControlBlocks: false,
+	insertSpaceBeforeTypeAnnotation: false,
+};
+
+function format(fileName: string, text: string) {
+
+	const host = new LanguageServiceHost();
+	host.addFile(fileName, text);
+
+	const languageService = ts.createLanguageService(host);
+	const edits = languageService.getFormattingEditsForDocument(fileName, { ...defaults });
+	edits
+		.sort((a, b) => a.span.start - b.span.start)
+		.reverse()
+		.forEach(edit => {
+			const head = text.slice(0, edit.span.start);
+			const tail = text.slice(edit.span.start + edit.span.length);
+			text = `${head}${edit.newText}${tail}`;
+		});
+
+	return text;
+}
+
+if (require.main === module) {
+	glob.sync(`${__dirname}/../**/*.ts`).forEach((file) => {
+		if (file.endsWith('.d.ts') || file.includes('node_modules')) {
+			return;
+		}
+
+		const out = format(file, fs.readFileSync(file, 'utf8'));
+		fs.writeFileSync(file, out);
+	});
+}

.scripts/run-command.ts

@@ -0,0 +1,33 @@
+// @ts-check
+/**
+ * Try running install for all the samples
+ */
+import * as child_process from 'child_process';
+import * as fs from 'fs';
+import * as path from 'path';
+import { lspSamples, Sample, samples } from './samples';
+
+async function tryRunCommand(command: string, sample: Sample) {
+	const packageJsonPath = path.join(sample.path, 'package.json');
+	if (fs.existsSync(packageJsonPath)) {
+		try {
+			const packageJson = JSON.parse(fs.readFileSync(packageJsonPath).toString());
+			if (packageJson['devDependencies'] || packageJson['dependencies']) {
+				console.log(`=== Running ${command} on ${path.basename(sample.path)} ===`);
+				child_process.execSync(command, {
+					cwd: sample.path,
+					stdio: 'inherit'
+				});
+			}
+		} catch (e) {
+			console.error(e);
+		}
+	}
+}
+
+if (require.main === module) {
+	const command = process.argv.slice(2).join(' ');
+	for (const sample of [...samples, ...lspSamples]) {
+		tryRunCommand(command, sample);
+	}
+}

.scripts/run-script.ts

@@ -0,0 +1,26 @@
+/**
+ * Try running an npm script for each of the samples.
+ */
+import * as child_process from 'child_process';
+import * as fs from 'fs';
+import * as path from 'path';
+import { lspSamples, Sample, samples } from './samples';
+
+function tryRun(scriptName: string, sample: Sample) {
+	const packageJsonPath = path.join(sample.path, 'package.json');
+	const packageJson = JSON.parse(fs.readFileSync(packageJsonPath).toString());
+	if (Object.keys(packageJson['scripts'] || {}).includes(scriptName)) {
+		console.log(`=== Running ${scriptName} on ${path.basename(sample.path)} ===`)
+		child_process.execSync(`npm run ${scriptName}`, {
+			cwd: sample.path,
+			stdio: 'inherit'
+		});
+	}
+}
+
+if (require.main === module) {
+	const scriptName = process.argv[2];
+	for (const sample of [...samples, ...lspSamples]) {
+		tryRun(scriptName, sample);
+	}
+}

.scripts/samples.ts

@@ -0,0 +1,407 @@
+export interface Sample {
+	readonly description: string;
+	readonly path: string;
+	readonly guide: string | null;
+	readonly apis: readonly string[];
+	readonly contributions: readonly string[];
+	readonly excludeFromReadme?: boolean;
+}
+
+export const samples: Sample[] = [
+	{
+		description: 'Webview Sample',
+		path: 'webview-sample',
+		guide: '/api/extension-guides/webview',
+		apis: ['window.createWebviewPanel', 'window.registerWebviewPanelSerializer'],
+		contributions: []
+	},
+	{
+		description: 'Webview View Sample',
+		path: 'webview-view-sample',
+		guide: null,
+		apis: ['window.registerWebviewViewProvider'],
+		contributions: []
+	},
+	{
+		description: 'Webview Codicons Sample',
+		path: 'webview-codicons-sample',
+		guide: null,
+		apis: [],
+		contributions: []
+	},
+	{
+		description: 'Status Bar Sample',
+		path: 'statusbar-sample',
+		guide: null,
+		apis: ['window.createStatusBarItem', 'StatusBarItem'],
+		contributions: []
+	},
+	{
+		description: 'Tree View Sample',
+		path: 'tree-view-sample',
+		guide: '/api/extension-guides/tree-view',
+		apis: ['window.createTreeView', 'window.registerTreeDataProvider', 'TreeView', 'TreeDataProvider'],
+		contributions: ['views', 'viewsContainers']
+	},
+	{
+		description: 'Task Provider Sample',
+		path: 'task-provider-sample',
+		guide: '/api/extension-guides/task-provider',
+		apis: ['tasks.registerTaskProvider', 'Task', 'ShellExecution'],
+		contributions: ['taskDefinitions']
+	},
+	{
+		description: 'Multi Root Sample',
+		path: 'basic-multi-root-sample',
+		guide: null,
+		apis: ['workspace.getWorkspaceFolder', 'workspace.onDidChangeWorkspaceFolders'],
+		contributions: []
+	},
+	{
+		description: 'Completion Provider Sample',
+		path: 'completions-sample',
+		guide: null,
+		apis: ['languages.registerCompletionItemProvider', 'CompletionItem', 'SnippetString'],
+		contributions: []
+	},
+	{
+		description: 'Code Actions Sample',
+		path: 'code-actions-sample',
+		guide: null,
+		apis: ['languages.registerCodeActionsProvider', 'CodeActionProvider'],
+		contributions: []
+	},
+	{
+		description: 'File System Provider Sample',
+		path: 'fsprovider-sample',
+		guide: null,
+		apis: ['workspace.registerFileSystemProvider'],
+		contributions: []
+	},
+	{
+		description: 'Editor Decorator Sample',
+		path: 'decorator-sample',
+		guide: null,
+		apis: [
+			'TextEditor.setDecorations',
+			'DecorationOptions',
+			'DecorationInstanceRenderOptions',
+			'ThemableDecorationInstanceRenderOptions',
+			'window.createTextEditorDecorationType',
+			'TextEditorDecorationType'
+		],
+		contributions: ['colors']
+	},
+	{
+		description: 'L10n Sample',
+		path: 'l10n-sample',
+		guide: null,
+		apis: [],
+		contributions: []
+	},
+	{
+		description: 'Terminal Sample',
+		path: 'terminal-sample',
+		guide: null,
+		apis: [
+			'window.createTerminal',
+			'window.onDidChangeActiveTerminal',
+			'window.onDidCloseTerminal',
+			'window.onDidOpenTerminal',
+			'window.Terminal',
+			'window.terminals'
+		],
+		contributions: []
+	},
+	{
+		description: 'Extension Terminal Sample',
+		path: 'extension-terminal-sample',
+		guide: null,
+		apis: [
+			'window.createTerminal',
+			'window.Pseudoterminal',
+			'window.ExtensionTerminalOptions'
+		],
+		contributions: []
+	},
+	{
+		description: 'Color Theme Sample',
+		path: 'theme-sample',
+		guide: '/api/extension-guides/color-theme',
+		apis: [],
+		contributions: ['themes']
+	},
+	{
+		description: 'Product Icon Theme Sample',
+		path: 'product-icon-theme-sample',
+		guide: '/api/extension-guides/product-icon-theme',
+		apis: [],
+		contributions: ['productIconThemes']
+	},
+	{
+		description: 'Vim Sample',
+		path: 'vim-sample',
+		guide: null,
+		apis: [
+			`commands`,
+			`StatusBarItem`,
+			`window.createStatusBarItem`,
+			`TextEditorCursorStyle`,
+			`window.activeTextEditor`,
+			`Position`,
+			`Range`,
+			`Selection`,
+			`TextEditor`,
+			`TextEditorRevealType`,
+			`TextDocument`
+		],
+		contributions: []
+	},
+	{
+		description: 'webpack-sample',
+		path: 'webpack-sample',
+		guide: '/api/working-with-extensions/bundling-extension',
+		apis: [],
+		contributions: []
+	},
+	{
+		description: 'esbuild-sample',
+		path: 'esbuild-sample',
+		guide: '/api/working-with-extensions/bundling-extension',
+		apis: [],
+		contributions: []
+	},
+	{
+		description: 'Source Control Sample',
+		path: 'source-control-sample',
+		guide: '/api/extension-guides/scm-provider',
+		apis: [
+			'workspace.workspaceFolders',
+			'SourceControl',
+			'SourceControlResourceGroup',
+			'scm.createSourceControl',
+			'TextDocumentContentProvider'
+		],
+		contributions: ["menus"]
+	},
+	{
+		description: 'Commenting API Sample',
+		path: 'comment-sample',
+		guide: null,
+		apis: [],
+		contributions: []
+	},
+	{
+		description: 'Document Editing Sample',
+		path: 'document-editing-sample',
+		guide: null,
+		apis: [
+			`commands`
+		],
+		contributions: []
+	},
+	{
+		description: 'Custom Data Sample',
+		path: 'custom-data-sample',
+		guide: '/api/extension-guides/custom-data-extension',
+		apis: [],
+		contributions: []
+	},
+	{
+		description: 'CodeLens Provider Sample',
+		path: 'codelens-sample',
+		guide: null,
+		apis: [`languages.registerCodeLensProvider`, `CodeLensProvider`, `CodeLens`],
+		contributions: []
+	},
+	{
+		description: 'Call Hierarchy Sample',
+		path: 'call-hierarchy-sample',
+		guide: null,
+		apis: [`languages.registerCallHierarchyProvider`, `CallHierarchyProvider`, `CallHierarchyItem`, `CallHierarchyOutgoingCall`, `CallHierarchyIncomingCall`],
+		contributions: []
+	},
+	{
+		description: 'Custom Editors Sample',
+		path: 'custom-editor-sample',
+		guide: '/api/extension-guides/custom-editors',
+		apis: ['window.registerCustomEditorProvider', 'CustomTextEditorProvider'],
+		contributions: ["customEditors"]
+	},
+	{
+		description: 'Semantic tokens',
+		path: 'semantic-tokens-sample',
+		guide: '/api/language-extensions/semantic-highlight-guide',
+		apis: ['languages.registerDocumentSemanticTokensProvider', 'vscode.DocumentSemanticTokensProvider'],
+		contributions: []
+	},
+	{
+		description: 'Test Provider Sample',
+		path: 'test-provider-sample',
+		guide: null,
+		apis: [],
+		contributions: []
+	},
+	{
+		description: 'Getting Started Sample',
+		path: 'getting-started-sample',
+		guide: null,
+		apis: [],
+		contributions: []
+	},
+	{
+		description: 'notebook-renderer-sample',
+		path: 'notebook-renderer-sample',
+		guide: "/api/extension-guides/notebook#notebook-renderer",
+		apis: [],
+		contributions: ["notebookRenderer"]
+	},
+	{
+		description: 'notebook-extend-markdown-renderer-sample',
+		path: 'notebook-extend-markdown-renderer-sample',
+		guide: "/api/extension-guides/notebook#notebook-renderer",
+		apis: [],
+		contributions: ["notebookRenderer"]
+	},
+	{
+		description: 'jupyter-server-provider-sample',
+		path: 'jupyter-server-provider-sample',
+		guide: null,
+		apis: [],
+		contributions: []
+	},
+	{
+		description: 'Chat Sample',
+		path: 'chat-sample',
+		guide: null,
+		apis: [],
+		contributions: []
+	},
+	{
+		description: 'Chat Tutorial',
+		path: 'chat-tutorial',
+		guide: null,
+		apis: [],
+		contributions: []
+	},
+	{
+		description: 'Notifications Sample',
+		path: 'notifications-sample',
+		guide: null,
+		apis: [],
+		contributions: []
+	},
+	{ description: 'authenticationprovider-sample', excludeFromReadme: true, path: 'authenticationprovider-sample', guide: null, apis: [], contributions: [] },
+	{ description: 'configuration-sample', excludeFromReadme: true, path: 'configuration-sample', guide: null, apis: [], contributions: [] },
+	{ description: 'chat-model-provider-sample', excludeFromReadme: true, path: 'chat-model-provider-sample', guide: null, apis: [], contributions: [] },
+	{ description: 'chat-output-renderer-sample', excludeFromReadme: true, path: 'chat-output-renderer-sample', guide: null, apis: [], contributions: [] },
+	{ description: 'contentprovider-sample', excludeFromReadme: true, path: 'contentprovider-sample', guide: null, apis: [], contributions: [] },
+	{ description: 'diagnostic-related-information-sample', excludeFromReadme: true, path: 'diagnostic-related-information-sample', guide: null, apis: [], contributions: [] },
+	{ description: 'document-paste', excludeFromReadme: true, path: 'document-paste', guide: null, apis: [], contributions: [] },
+	{ description: 'drop-on-document', excludeFromReadme: true, path: 'drop-on-document', guide: null, apis: [], contributions: [] },
+	{ description: 'fsconsumer-sample', excludeFromReadme: true, path: 'fsconsumer-sample', guide: null, apis: [], contributions: [] },
+	{ description: 'github-authentication-sample', excludeFromReadme: true, path: 'github-authentication-sample', guide: null, apis: [], contributions: [] },
+	{ description: 'helloworld-minimal-sample', excludeFromReadme: true, path: 'helloworld-minimal-sample', guide: null, apis: [], contributions: [] },
+	{ description: 'helloworld-sample', excludeFromReadme: true, path: 'helloworld-sample', guide: null, apis: [], contributions: [] },
+	{ description: 'helloworld-test-cli-sample', excludeFromReadme: true, path: 'helloworld-test-cli-sample', guide: null, apis: [], contributions: [] },
+	{ description: 'helloworld-test-sample', excludeFromReadme: true, path: 'helloworld-test-sample', guide: null, apis: [], contributions: [] },
+	{ description: 'helloworld-web-sample', excludeFromReadme: true, path: 'helloworld-web-sample', guide: null, apis: [], contributions: [] },
+	{ description: 'inline-completions', excludeFromReadme: true, path: 'inline-completions', guide: null, apis: [], contributions: [] },
+	{ description: 'jupyter-kernel-execution-sample', excludeFromReadme: true, path: 'jupyter-kernel-execution-sample', guide: null, apis: [], contributions: [] },
+	{ description: 'lm-api-tutorial', excludeFromReadme: true, path: 'lm-api-tutorial', guide: null, apis: [], contributions: [] },
+	{ description: 'mcp-extension-sample', excludeFromReadme: true, path: 'mcp-extension-sample', guide: null, apis: [], contributions: [] },
+	{ description: 'nodefs-provider-sample', excludeFromReadme: true, path: 'nodefs-provider-sample', guide: null, apis: [], contributions: [] },
+	{ description: 'notebook-format-code-action-sample', excludeFromReadme: true, path: 'notebook-format-code-action-sample', guide: null, apis: [], contributions: [] },
+	{ description: 'notebook-renderer-react-sample', excludeFromReadme: true, path: 'notebook-renderer-react-sample', guide: null, apis: [], contributions: [] },
+	{ description: 'notebook-serializer-sample', excludeFromReadme: true, path: 'notebook-serializer-sample', guide: null, apis: [], contributions: [] },
+	{ description: 'progress-sample', excludeFromReadme: true, path: 'progress-sample', guide: null, apis: [], contributions: [] },
+	{ description: 'proposed-api-sample', excludeFromReadme: true, path: 'proposed-api-sample', guide: null, apis: [], contributions: [] },
+	{ description: 'quickinput-sample', excludeFromReadme: true, path: 'quickinput-sample', guide: null, apis: [], contributions: [] },
+	{ description: 'shell-integration-sample', excludeFromReadme: true, path: 'shell-integration-sample', guide: null, apis: [], contributions: [] },
+	{ description: 'tabs-api-sample', excludeFromReadme: true, path: 'tabs-api-sample', guide: null, apis: [], contributions: [] },
+	{ description: 'telemetry-sample', excludeFromReadme: true, path: 'telemetry-sample', guide: null, apis: [], contributions: [] },
+	{ description: 'uri-handler-sample', excludeFromReadme: true, path: 'uri-handler-sample', guide: null, apis: [], contributions: [] },
+	{ description: 'virtual-document-sample', excludeFromReadme: true, path: 'virtual-document-sample', guide: null, apis: [], contributions: [] },
+	{ description: 'wasm-component-model-async', excludeFromReadme: true, path: 'wasm-component-model-async', guide: null, apis: [], contributions: [] },
+	{ description: 'wasm-component-model-resource', excludeFromReadme: true, path: 'wasm-component-model-resource', guide: null, apis: [], contributions: [] },
+	{ description: 'wasm-component-model', excludeFromReadme: true, path: 'wasm-component-model', guide: null, apis: [], contributions: [] },
+	{ description: 'welcome-view-content-sample', excludeFromReadme: true, path: 'welcome-view-content-sample', guide: null, apis: [], contributions: [] },
+]
+
+/**
+ * LSP specific samples
+ * DO NOT add non-LSP items here. Add it to {@link samples} list.
+ */
+export const lspSamples: Sample[] = [
+	{
+		description: 'Snippet Sample',
+		path: 'snippet-sample',
+		guide: '/api/language-extensions/snippet-guide',
+		apis: [],
+		contributions: ['snippets']
+	},
+	{
+		description: 'Language Configuration Sample',
+		path: 'language-configuration-sample',
+		guide: '/api/language-extensions/language-configuration-guide',
+		apis: [],
+		contributions: ['languages']
+	},
+	{
+		description: 'LSP Sample',
+		path: 'lsp-sample',
+		guide: '/api/language-extensions/language-server-extension-guide',
+		apis: [],
+		contributions: []
+	},
+	{
+		description: 'LSP Log Streaming Sample',
+		path: 'lsp-log-streaming-sample',
+		guide: null,
+		apis: [],
+		contributions: []
+	},
+	{
+		description: 'LSP Multi Root Server Sample',
+		path: 'lsp-multi-server-sample',
+		guide:
+			'https://github.com/Microsoft/vscode/wiki/Extension-Authoring:-Adopting-Multi-Root-Workspace-APIs#language-client--language-server',
+		apis: [],
+		contributions: []
+	},
+	{
+		description: 'LSP Web Extension Sample',
+		path: 'lsp-web-extension-sample',
+		guide: '/api/language-extensions/language-server-extension-guide',
+		apis: [],
+		contributions: []
+	},
+	{
+		description: 'LSP User Input Sample',
+		path: 'lsp-user-input-sample',
+		guide: null,
+		apis: [],
+		contributions: []
+	},
+	{
+		description: 'LSP Embedded Language Service',
+		path: 'lsp-embedded-language-service',
+		guide: null,
+		apis: [],
+		contributions: []
+	},
+	{
+		description: 'LSP Embedded Request Forwarding',
+		path: 'lsp-embedded-request-forwarding',
+		guide: null,
+		apis: [],
+		contributions: []
+	},
+	{
+		description: 'Wasm language server',
+		path: 'wasm-language-server',
+		guide: null,
+		apis: [],
+		contributions: []
+	},
+];

.scripts/tsconfig.json

@@ -0,0 +1,15 @@
+{
+	"compilerOptions": {
+		"module": "ESNext",
+		"moduleResolution": "Node",
+		"target": "ES2024",
+		"lib": [
+			"ES2024"
+		],
+		"noEmit": true,
+		"strict": true
+	},
+	"ts-node": {
+		"esm": true
+	}
+}

.scripts/update-dependency.ts

@@ -0,0 +1,51 @@
+/**
+ * Update a dependency to a version in all relevant samples
+ */
+import * as child_process from 'child_process';
+import * as fs from 'fs';
+import * as path from 'path';
+import { Sample, samples } from './samples';
+
+function setVersion(
+	dependencyName: string,
+	version: string,
+	sample: Sample
+) {
+	const packageJsonPath = path.join(sample.path, 'package.json');
+	const packageJsonContents = fs.readFileSync(packageJsonPath).toString();
+	const packageJson = JSON.parse(packageJsonContents);
+
+	let changed = false;
+	if (packageJson.dependencies?.[dependencyName]) {
+		packageJson.dependencies[dependencyName] = version;
+		changed = true;
+	}
+	if (packageJson.devDependencies?.[dependencyName]) {
+		packageJson.devDependencies[dependencyName] = version;
+		changed = true;
+	}
+
+	if (!changed) {
+		return;
+	}
+
+	console.log(`Updated ${dependencyName} in ${packageJson.name}`);
+	const space = packageJsonContents.includes('\t') ? '\t' : '  ';
+	fs.writeFileSync(packageJsonPath, JSON.stringify(packageJson, undefined, space) + '\n');
+
+	if (fs.existsSync(path.join(sample.path, 'package-lock.json'))) {
+		console.log(`  npm install in ${packageJson.name}`);
+		child_process.execSync(`npm install`, {
+			cwd: sample.path,
+			stdio: 'inherit'
+		});
+	}
+}
+
+const [, , dependency, version] = process.argv;
+if (!dependency || !version) {
+	console.log(`Usage: ${process.argv[0]} ${process.argv[1]} <depndency> <version>`);
+}
+for (const sample of samples) {
+	setVersion(dependency, version, sample);
+}

.scripts/update-lsif.ts

@@ -0,0 +1,31 @@
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { samples } from './samples';
+
+const root = path.join(__dirname, '..');
+
+async function main() {
+	const references = [];
+	for (const sample of samples) {
+		try {
+			const stat = await fs.stat(path.join(root, sample.path, 'tsconfig.json'));
+			if (stat.isFile()) {
+				references.push(`./${sample.path}/tsconfig.json`);
+			}
+		} catch (error) {
+			// Ignore error of stat call.
+		}
+	}
+	const tsconfig = {
+		compilerOptions: {
+		},
+		files: [
+		],
+		references: references.map(reference => { return { path: reference } })
+	}
+	await fs.writeFile(path.join(root, 'tsconfig.lsif.json'), JSON.stringify(tsconfig, undefined, '\t'), { encoding: 'utf8' });
+}
+
+if (require.main === module) {
+	main().catch(console.error);
+}

.scripts/update-readme.ts

@@ -0,0 +1,74 @@
+import * as fs from 'fs';
+import { lspSamples, Sample, samples } from './samples';
+
+const TABLE_HEAD = `<!-- SAMPLES_BEGIN -->
+| Sample | Guide on VS Code Website | API & Contribution |
+| ------ | ----- | --- |`
+const TABLE_END = `<!-- SAMPLES_END -->`
+const LSP_TABLE_HEAD = `<!-- LSP_SAMPLES_BEGIN -->
+| Sample | Guide on VS Code Website | API & Contribution |
+| ------ | ----- | --- |`
+const LSP_TABLE_END = `<!-- LSP_SAMPLES_END -->`
+
+const getTableRow = (sample: Sample) => {
+	const descriptionCell = `[${sample.description}](https://github.com/Microsoft/vscode-extension-samples/tree/main/${sample.path})`
+	let guideCell
+	if (!sample.guide) {
+		guideCell = 'N/A'
+	} else if (sample.guide && sample.guide.startsWith('http')) {
+		guideCell = sample.guide
+	} else {
+		guideCell = `[${sample.guide}](https://code.visualstudio.com${sample.guide})`
+	}
+
+	const apis = sample.apis.map(api => {
+		return `[${api}](https://code.visualstudio.com/api/references/vscode-api#${api})`
+	})
+	const contributions = sample.contributions.map(c => {
+		return `[contributes.${c}](https://code.visualstudio.com/api/references/contribution-points#contributes.${c})`
+	})
+	const apiAndContributionCell = apis.concat(contributions).join('<br>')
+
+	return `| ${descriptionCell} | ${guideCell} | ${apiAndContributionCell} |`
+}
+
+const getSamplesTable = (samples: readonly Sample[]) => {
+	const samplesMd = samples.map(s => getTableRow(s)).join('\n')
+
+	return `${TABLE_HEAD.trim()}
+${samplesMd}
+${TABLE_END.trim()}`
+}
+
+const getLSPSamplesTable = (samples: readonly Sample[]) => {
+	const samplesMd = samples.map(s => getTableRow(s)).join('\n')
+
+	return `${LSP_TABLE_HEAD.trim()}
+${samplesMd}
+${LSP_TABLE_END.trim()}`
+}
+
+/**
+ * Update the README with the latest samples.
+ * 
+ * @returns true if the README was updated, false otherwise.
+ */
+export function updateReadme(dryRun = false): boolean {
+	const readme = fs.readFileSync('README.md', 'utf-8')
+	const newReadme = readme
+		.replace(/<!-- SAMPLES_BEGIN -->(.|\n)*<!-- SAMPLES_END -->/gm, getSamplesTable(samples.filter(x => !x.excludeFromReadme)))
+		.replace(/<!-- LSP_SAMPLES_BEGIN -->(.|\n)*<!-- LSP_SAMPLES_END -->/gm, getLSPSamplesTable(lspSamples))
+
+	if (readme !== newReadme) {
+		if (!dryRun) {
+			fs.writeFileSync('README.md', newReadme)
+		}
+		return true;
+	} else {
+		return false;
+	}
+}
+
+if (require.main === module) {
+	updateReadme();
+}

.scripts/validate.ts

@@ -0,0 +1,56 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { lspSamples, samples } from './samples';
+
+const root = path.join(__dirname, '..');
+console.log(root);
+
+/**
+ * Validates that all samples are correctly listed in `.scripts/samples.js`.
+ */
+function validateSamplesAreListed() {
+	const allSamples = samples.concat(lspSamples);
+
+	const samplesByPath = new Map();
+	for (const sample of allSamples) {
+		samplesByPath.set(sample.path, sample);
+	}
+
+
+	const errors: Error[] = [];
+
+	for (const fileName of fs.readdirSync(root)) {
+		if (fileName === 'node_modules'
+			|| fileName.startsWith('.')
+			|| !fs.lstatSync(path.join(root, fileName)).isDirectory()
+		) {
+			continue;
+		}
+
+		const sampleEntry = samplesByPath.get(fileName);
+		if (!sampleEntry) {
+			errors.push(new Error(`Sample '${fileName}' is not listed in samples.js`));
+		}
+	}
+
+	if (errors.length > 0) {
+		if (errors.length === 1) {
+			throw errors[0];
+		} else {
+			throw new AggregateError(errors, 'Multiple samples are not listed in samples.js');
+		}
+	}
+}
+
+/**
+ * Validates that all samples are correctly listed in `.scripts/samples.js`.
+ */
+function validateReadmeUpdated() {
+	const { updateReadme } = require('./update-readme');
+	if (updateReadme(true)) {
+		throw new Error(`Readme not updated. Run 'node .scripts/update-readme.js' to update the readme.`);
+	}
+}
+
+validateSamplesAreListed();
+validateReadmeUpdated();

.vscode/settings.json

@@ -0,0 +1,14 @@
+{
+	"editor.insertSpaces": false,
+	"prettier.semi": true,
+	"prettier.printWidth": 92,
+	"prettier.singleQuote": true,
+	"prettier.useTabs": true,
+	"git.branchProtection": [
+        "main"
+    ],
+    "git.branchProtectionPrompt": "alwaysCommitToNewBranch",
+    "git.branchRandomName.enable": true,
+    "githubPullRequests.assignCreated": "${user}",
+    "githubPullRequests.defaultMergeMethod": "squash"
+}

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2015 - present Microsoft Corporation
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,95 @@
+<h1 align="center">
+VS Code Extension Samples
+</h1>
+
+This repository contains sample code illustrating the VS Code extension API. Each sample is a self-contained extension that explains one topic in [VS Code API](https://code.visualstudio.com/api/references/vscode-api) or VS Code's [Contribution Points](https://code.visualstudio.com/api/references/contribution-points). You can read, play with or adapt from these samples to create your own extensions.
+
+You can expect from each sample:
+- An explanation of its functionality
+- A gif or screenshot demonstrating its usage
+- Link to a guide on VS Code website, if it has one
+- Listing of used VS Code API and Contribution Points
+- Code of the same style, enforced using ESLint
+
+## Prerequisites
+
+You need to have [node](https://nodejs.org/en/) and [npm](https://nodejs.org/en/) installed on your system to run the examples. It is recommended to use the node version used for VS Code development itself which is documented [here](https://github.com/Microsoft/vscode/wiki/How-to-Contribute#prerequisites)
+
+## Usage
+
+- `git clone https://github.com/Microsoft/vscode-extension-samples`
+- `code <any-sample-folder>`
+- `npm install` in the terminal, then `F5` to run the sample
+- Alternatively, follow the instructions in each sample's README for setting up and running the sample
+
+## Getting Started
+
+- [Hello World Sample](helloworld-sample): The Hello World sample for VS Code. See [Extension Anatomy](https://code.visualstudio.com/api/get-started/extension-anatomy) documentation.
+- [Hello World Minimal Sample](helloworld-minimal-sample): A minimal version of Hello World Sample written in JavaScript.
+- [Hello World Test Sample](helloworld-test-sample): Hello World sample with extension integration test. See [Testing Extensions](https://code.visualstudio.com/api/working-with-extensions/testing-extension) documentation.
+- [Hello World Web Sample](helloworld-web-sample): The Hello World sample for VS Code Web. See the [Web Extensions](https://code.visualstudio.com/api/extension-guides/web-extensions) guide.
+
+## Samples
+
+<!-- SAMPLES_BEGIN -->
+| Sample | Guide on VS Code Website | API & Contribution |
+| ------ | ----- | --- |
+| [Webview Sample](https://github.com/Microsoft/vscode-extension-samples/tree/main/webview-sample) | [/api/extension-guides/webview](https://code.visualstudio.com/api/extension-guides/webview) | [window.createWebviewPanel](https://code.visualstudio.com/api/references/vscode-api#window.createWebviewPanel)<br>[window.registerWebviewPanelSerializer](https://code.visualstudio.com/api/references/vscode-api#window.registerWebviewPanelSerializer) |
+| [Webview View Sample](https://github.com/Microsoft/vscode-extension-samples/tree/main/webview-view-sample) | N/A | [window.registerWebviewViewProvider](https://code.visualstudio.com/api/references/vscode-api#window.registerWebviewViewProvider) |
+| [Webview Codicons Sample](https://github.com/Microsoft/vscode-extension-samples/tree/main/webview-codicons-sample) | N/A |  |
+| [Status Bar Sample](https://github.com/Microsoft/vscode-extension-samples/tree/main/statusbar-sample) | N/A | [window.createStatusBarItem](https://code.visualstudio.com/api/references/vscode-api#window.createStatusBarItem)<br>[StatusBarItem](https://code.visualstudio.com/api/references/vscode-api#StatusBarItem) |
+| [Tree View Sample](https://github.com/Microsoft/vscode-extension-samples/tree/main/tree-view-sample) | [/api/extension-guides/tree-view](https://code.visualstudio.com/api/extension-guides/tree-view) | [window.createTreeView](https://code.visualstudio.com/api/references/vscode-api#window.createTreeView)<br>[window.registerTreeDataProvider](https://code.visualstudio.com/api/references/vscode-api#window.registerTreeDataProvider)<br>[TreeView](https://code.visualstudio.com/api/references/vscode-api#TreeView)<br>[TreeDataProvider](https://code.visualstudio.com/api/references/vscode-api#TreeDataProvider)<br>[contributes.views](https://code.visualstudio.com/api/references/contribution-points#contributes.views)<br>[contributes.viewsContainers](https://code.visualstudio.com/api/references/contribution-points#contributes.viewsContainers) |
+| [Task Provider Sample](https://github.com/Microsoft/vscode-extension-samples/tree/main/task-provider-sample) | [/api/extension-guides/task-provider](https://code.visualstudio.com/api/extension-guides/task-provider) | [tasks.registerTaskProvider](https://code.visualstudio.com/api/references/vscode-api#tasks.registerTaskProvider)<br>[Task](https://code.visualstudio.com/api/references/vscode-api#Task)<br>[ShellExecution](https://code.visualstudio.com/api/references/vscode-api#ShellExecution)<br>[contributes.taskDefinitions](https://code.visualstudio.com/api/references/contribution-points#contributes.taskDefinitions) |
+| [Multi Root Sample](https://github.com/Microsoft/vscode-extension-samples/tree/main/basic-multi-root-sample) | N/A | [workspace.getWorkspaceFolder](https://code.visualstudio.com/api/references/vscode-api#workspace.getWorkspaceFolder)<br>[workspace.onDidChangeWorkspaceFolders](https://code.visualstudio.com/api/references/vscode-api#workspace.onDidChangeWorkspaceFolders) |
+| [Completion Provider Sample](https://github.com/Microsoft/vscode-extension-samples/tree/main/completions-sample) | N/A | [languages.registerCompletionItemProvider](https://code.visualstudio.com/api/references/vscode-api#languages.registerCompletionItemProvider)<br>[CompletionItem](https://code.visualstudio.com/api/references/vscode-api#CompletionItem)<br>[SnippetString](https://code.visualstudio.com/api/references/vscode-api#SnippetString) |
+| [Code Actions Sample](https://github.com/Microsoft/vscode-extension-samples/tree/main/code-actions-sample) | N/A | [languages.registerCodeActionsProvider](https://code.visualstudio.com/api/references/vscode-api#languages.registerCodeActionsProvider)<br>[CodeActionProvider](https://code.visualstudio.com/api/references/vscode-api#CodeActionProvider) |
+| [File System Provider Sample](https://github.com/Microsoft/vscode-extension-samples/tree/main/fsprovider-sample) | N/A | [workspace.registerFileSystemProvider](https://code.visualstudio.com/api/references/vscode-api#workspace.registerFileSystemProvider) |
+| [Editor Decorator Sample](https://github.com/Microsoft/vscode-extension-samples/tree/main/decorator-sample) | N/A | [TextEditor.setDecorations](https://code.visualstudio.com/api/references/vscode-api#TextEditor.setDecorations)<br>[DecorationOptions](https://code.visualstudio.com/api/references/vscode-api#DecorationOptions)<br>[DecorationInstanceRenderOptions](https://code.visualstudio.com/api/references/vscode-api#DecorationInstanceRenderOptions)<br>[ThemableDecorationInstanceRenderOptions](https://code.visualstudio.com/api/references/vscode-api#ThemableDecorationInstanceRenderOptions)<br>[window.createTextEditorDecorationType](https://code.visualstudio.com/api/references/vscode-api#window.createTextEditorDecorationType)<br>[TextEditorDecorationType](https://code.visualstudio.com/api/references/vscode-api#TextEditorDecorationType)<br>[contributes.colors](https://code.visualstudio.com/api/references/contribution-points#contributes.colors) |
+| [L10n Sample](https://github.com/Microsoft/vscode-extension-samples/tree/main/l10n-sample) | N/A |  |
+| [Terminal Sample](https://github.com/Microsoft/vscode-extension-samples/tree/main/terminal-sample) | N/A | [window.createTerminal](https://code.visualstudio.com/api/references/vscode-api#window.createTerminal)<br>[window.onDidChangeActiveTerminal](https://code.visualstudio.com/api/references/vscode-api#window.onDidChangeActiveTerminal)<br>[window.onDidCloseTerminal](https://code.visualstudio.com/api/references/vscode-api#window.onDidCloseTerminal)<br>[window.onDidOpenTerminal](https://code.visualstudio.com/api/references/vscode-api#window.onDidOpenTerminal)<br>[window.Terminal](https://code.visualstudio.com/api/references/vscode-api#window.Terminal)<br>[window.terminals](https://code.visualstudio.com/api/references/vscode-api#window.terminals) |
+| [Extension Terminal Sample](https://github.com/Microsoft/vscode-extension-samples/tree/main/extension-terminal-sample) | N/A | [window.createTerminal](https://code.visualstudio.com/api/references/vscode-api#window.createTerminal)<br>[window.Pseudoterminal](https://code.visualstudio.com/api/references/vscode-api#window.Pseudoterminal)<br>[window.ExtensionTerminalOptions](https://code.visualstudio.com/api/references/vscode-api#window.ExtensionTerminalOptions) |
+| [Color Theme Sample](https://github.com/Microsoft/vscode-extension-samples/tree/main/theme-sample) | [/api/extension-guides/color-theme](https://code.visualstudio.com/api/extension-guides/color-theme) | [contributes.themes](https://code.visualstudio.com/api/references/contribution-points#contributes.themes) |
+| [Product Icon Theme Sample](https://github.com/Microsoft/vscode-extension-samples/tree/main/product-icon-theme-sample) | [/api/extension-guides/product-icon-theme](https://code.visualstudio.com/api/extension-guides/product-icon-theme) | [contributes.productIconThemes](https://code.visualstudio.com/api/references/contribution-points#contributes.productIconThemes) |
+| [Vim Sample](https://github.com/Microsoft/vscode-extension-samples/tree/main/vim-sample) | N/A | [commands](https://code.visualstudio.com/api/references/vscode-api#commands)<br>[StatusBarItem](https://code.visualstudio.com/api/references/vscode-api#StatusBarItem)<br>[window.createStatusBarItem](https://code.visualstudio.com/api/references/vscode-api#window.createStatusBarItem)<br>[TextEditorCursorStyle](https://code.visualstudio.com/api/references/vscode-api#TextEditorCursorStyle)<br>[window.activeTextEditor](https://code.visualstudio.com/api/references/vscode-api#window.activeTextEditor)<br>[Position](https://code.visualstudio.com/api/references/vscode-api#Position)<br>[Range](https://code.visualstudio.com/api/references/vscode-api#Range)<br>[Selection](https://code.visualstudio.com/api/references/vscode-api#Selection)<br>[TextEditor](https://code.visualstudio.com/api/references/vscode-api#TextEditor)<br>[TextEditorRevealType](https://code.visualstudio.com/api/references/vscode-api#TextEditorRevealType)<br>[TextDocument](https://code.visualstudio.com/api/references/vscode-api#TextDocument) |
+| [webpack-sample](https://github.com/Microsoft/vscode-extension-samples/tree/main/webpack-sample) | [/api/working-with-extensions/bundling-extension](https://code.visualstudio.com/api/working-with-extensions/bundling-extension) |  |
+| [esbuild-sample](https://github.com/Microsoft/vscode-extension-samples/tree/main/esbuild-sample) | [/api/working-with-extensions/bundling-extension](https://code.visualstudio.com/api/working-with-extensions/bundling-extension) |  |
+| [Source Control Sample](https://github.com/Microsoft/vscode-extension-samples/tree/main/source-control-sample) | [/api/extension-guides/scm-provider](https://code.visualstudio.com/api/extension-guides/scm-provider) | [workspace.workspaceFolders](https://code.visualstudio.com/api/references/vscode-api#workspace.workspaceFolders)<br>[SourceControl](https://code.visualstudio.com/api/references/vscode-api#SourceControl)<br>[SourceControlResourceGroup](https://code.visualstudio.com/api/references/vscode-api#SourceControlResourceGroup)<br>[scm.createSourceControl](https://code.visualstudio.com/api/references/vscode-api#scm.createSourceControl)<br>[TextDocumentContentProvider](https://code.visualstudio.com/api/references/vscode-api#TextDocumentContentProvider)<br>[contributes.menus](https://code.visualstudio.com/api/references/contribution-points#contributes.menus) |
+| [Commenting API Sample](https://github.com/Microsoft/vscode-extension-samples/tree/main/comment-sample) | N/A |  |
+| [Document Editing Sample](https://github.com/Microsoft/vscode-extension-samples/tree/main/document-editing-sample) | N/A | [commands](https://code.visualstudio.com/api/references/vscode-api#commands) |
+| [Custom Data Sample](https://github.com/Microsoft/vscode-extension-samples/tree/main/custom-data-sample) | [/api/extension-guides/custom-data-extension](https://code.visualstudio.com/api/extension-guides/custom-data-extension) |  |
+| [CodeLens Provider Sample](https://github.com/Microsoft/vscode-extension-samples/tree/main/codelens-sample) | N/A | [languages.registerCodeLensProvider](https://code.visualstudio.com/api/references/vscode-api#languages.registerCodeLensProvider)<br>[CodeLensProvider](https://code.visualstudio.com/api/references/vscode-api#CodeLensProvider)<br>[CodeLens](https://code.visualstudio.com/api/references/vscode-api#CodeLens) |
+| [Call Hierarchy Sample](https://github.com/Microsoft/vscode-extension-samples/tree/main/call-hierarchy-sample) | N/A | [languages.registerCallHierarchyProvider](https://code.visualstudio.com/api/references/vscode-api#languages.registerCallHierarchyProvider)<br>[CallHierarchyProvider](https://code.visualstudio.com/api/references/vscode-api#CallHierarchyProvider)<br>[CallHierarchyItem](https://code.visualstudio.com/api/references/vscode-api#CallHierarchyItem)<br>[CallHierarchyOutgoingCall](https://code.visualstudio.com/api/references/vscode-api#CallHierarchyOutgoingCall)<br>[CallHierarchyIncomingCall](https://code.visualstudio.com/api/references/vscode-api#CallHierarchyIncomingCall) |
+| [Custom Editors Sample](https://github.com/Microsoft/vscode-extension-samples/tree/main/custom-editor-sample) | [/api/extension-guides/custom-editors](https://code.visualstudio.com/api/extension-guides/custom-editors) | [window.registerCustomEditorProvider](https://code.visualstudio.com/api/references/vscode-api#window.registerCustomEditorProvider)<br>[CustomTextEditorProvider](https://code.visualstudio.com/api/references/vscode-api#CustomTextEditorProvider)<br>[contributes.customEditors](https://code.visualstudio.com/api/references/contribution-points#contributes.customEditors) |
+| [Semantic tokens](https://github.com/Microsoft/vscode-extension-samples/tree/main/semantic-tokens-sample) | [/api/language-extensions/semantic-highlight-guide](https://code.visualstudio.com/api/language-extensions/semantic-highlight-guide) | [languages.registerDocumentSemanticTokensProvider](https://code.visualstudio.com/api/references/vscode-api#languages.registerDocumentSemanticTokensProvider)<br>[vscode.DocumentSemanticTokensProvider](https://code.visualstudio.com/api/references/vscode-api#vscode.DocumentSemanticTokensProvider) |
+| [Test Provider Sample](https://github.com/Microsoft/vscode-extension-samples/tree/main/test-provider-sample) | N/A |  |
+| [Getting Started Sample](https://github.com/Microsoft/vscode-extension-samples/tree/main/getting-started-sample) | N/A |  |
+| [notebook-renderer-sample](https://github.com/Microsoft/vscode-extension-samples/tree/main/notebook-renderer-sample) | [/api/extension-guides/notebook#notebook-renderer](https://code.visualstudio.com/api/extension-guides/notebook#notebook-renderer) | [contributes.notebookRenderer](https://code.visualstudio.com/api/references/contribution-points#contributes.notebookRenderer) |
+| [notebook-extend-markdown-renderer-sample](https://github.com/Microsoft/vscode-extension-samples/tree/main/notebook-extend-markdown-renderer-sample) | [/api/extension-guides/notebook#notebook-renderer](https://code.visualstudio.com/api/extension-guides/notebook#notebook-renderer) | [contributes.notebookRenderer](https://code.visualstudio.com/api/references/contribution-points#contributes.notebookRenderer) |
+| [jupyter-server-provider-sample](https://github.com/Microsoft/vscode-extension-samples/tree/main/jupyter-server-provider-sample) | N/A |  |
+| [Chat Sample](https://github.com/Microsoft/vscode-extension-samples/tree/main/chat-sample) | N/A |  |
+| [Chat Tutorial](https://github.com/Microsoft/vscode-extension-samples/tree/main/chat-tutorial) | N/A |  |
+| [Notifications Sample](https://github.com/Microsoft/vscode-extension-samples/tree/main/notifications-sample) | N/A |  |
+<!-- SAMPLES_END -->
+
+### Language Server Protocol Samples
+
+<!-- LSP_SAMPLES_BEGIN -->
+| Sample | Guide on VS Code Website | API & Contribution |
+| ------ | ----- | --- |
+| [Snippet Sample](https://github.com/Microsoft/vscode-extension-samples/tree/main/snippet-sample) | [/api/language-extensions/snippet-guide](https://code.visualstudio.com/api/language-extensions/snippet-guide) | [contributes.snippets](https://code.visualstudio.com/api/references/contribution-points#contributes.snippets) |
+| [Language Configuration Sample](https://github.com/Microsoft/vscode-extension-samples/tree/main/language-configuration-sample) | [/api/language-extensions/language-configuration-guide](https://code.visualstudio.com/api/language-extensions/language-configuration-guide) | [contributes.languages](https://code.visualstudio.com/api/references/contribution-points#contributes.languages) |
+| [LSP Sample](https://github.com/Microsoft/vscode-extension-samples/tree/main/lsp-sample) | [/api/language-extensions/language-server-extension-guide](https://code.visualstudio.com/api/language-extensions/language-server-extension-guide) |  |
+| [LSP Log Streaming Sample](https://github.com/Microsoft/vscode-extension-samples/tree/main/lsp-log-streaming-sample) | N/A |  |
+| [LSP Multi Root Server Sample](https://github.com/Microsoft/vscode-extension-samples/tree/main/lsp-multi-server-sample) | https://github.com/Microsoft/vscode/wiki/Extension-Authoring:-Adopting-Multi-Root-Workspace-APIs#language-client--language-server |  |
+| [LSP Web Extension Sample](https://github.com/Microsoft/vscode-extension-samples/tree/main/lsp-web-extension-sample) | [/api/language-extensions/language-server-extension-guide](https://code.visualstudio.com/api/language-extensions/language-server-extension-guide) |  |
+| [LSP User Input Sample](https://github.com/Microsoft/vscode-extension-samples/tree/main/lsp-user-input-sample) | N/A |  |
+| [LSP Embedded Language Service](https://github.com/Microsoft/vscode-extension-samples/tree/main/lsp-embedded-language-service) | N/A |  |
+| [LSP Embedded Request Forwarding](https://github.com/Microsoft/vscode-extension-samples/tree/main/lsp-embedded-request-forwarding) | N/A |  |
+| [Wasm language server](https://github.com/Microsoft/vscode-extension-samples/tree/main/wasm-language-server) | N/A |  |
+<!-- LSP_SAMPLES_END -->
+
+## License
+
+Copyright (c) Microsoft Corporation. All rights reserved.
+
+Licensed under the [MIT](https://github.com/microsoft/vscode-extension-samples/blob/main/LICENSE) License.

SECURITY.md

@@ -0,0 +1,41 @@
+<!-- BEGIN MICROSOFT SECURITY.MD V0.0.5 BLOCK -->
+
+## Security
+
+Microsoft takes the security of our software products and services seriously, which includes all source code repositories managed through our GitHub organizations, which include [Microsoft](https://github.com/Microsoft), [Azure](https://github.com/Azure), [DotNet](https://github.com/dotnet), [AspNet](https://github.com/aspnet), [Xamarin](https://github.com/xamarin), and [our GitHub organizations](https://opensource.microsoft.com/).
+
+If you believe you have found a security vulnerability in any Microsoft-owned repository that meets [Microsoft's definition of a security vulnerability](https://docs.microsoft.com/en-us/previous-versions/tn-archive/cc751383(v=technet.10)), please report it to us as described below.
+
+## Reporting Security Issues
+
+**Please do not report security vulnerabilities through public GitHub issues.**
+
+Instead, please report them to the Microsoft Security Response Center (MSRC) at [https://msrc.microsoft.com/create-report](https://msrc.microsoft.com/create-report).
+
+If you prefer to submit without logging in, send email to [secure@microsoft.com](mailto:secure@microsoft.com).  If possible, encrypt your message with our PGP key; please download it from the [Microsoft Security Response Center PGP Key page](https://www.microsoft.com/en-us/msrc/pgp-key-msrc).
+
+You should receive a response within 24 hours. If for some reason you do not, please follow up via email to ensure we received your original message. Additional information can be found at [microsoft.com/msrc](https://www.microsoft.com/msrc). 
+
+Please include the requested information listed below (as much as you can provide) to help us better understand the nature and scope of the possible issue:
+
+  * Type of issue (e.g. buffer overflow, SQL injection, cross-site scripting, etc.)
+  * Full paths of source file(s) related to the manifestation of the issue
+  * The location of the affected source code (tag/branch/commit or direct URL)
+  * Any special configuration required to reproduce the issue
+  * Step-by-step instructions to reproduce the issue
+  * Proof-of-concept or exploit code (if possible)
+  * Impact of the issue, including how an attacker might exploit the issue
+
+This information will help us triage your report more quickly.
+
+If you are reporting for a bug bounty, more complete reports can contribute to a higher bounty award. Please visit our [Microsoft Bug Bounty Program](https://microsoft.com/msrc/bounty) page for more details about our active programs.
+
+## Preferred Languages
+
+We prefer all communications to be in English.
+
+## Policy
+
+Microsoft follows the principle of [Coordinated Vulnerability Disclosure](https://www.microsoft.com/en-us/msrc/cvd).
+
+<!-- END MICROSOFT SECURITY.MD BLOCK -->

authenticationprovider-sample/.vscode/extensions.json

@@ -0,0 +1,7 @@
+{
+	// See http://go.microsoft.com/fwlink/?LinkId=827846
+	// for the documentation about the extensions.json format
+	"recommendations": [
+		"dbaeumer.vscode-eslint"
+	]
+}

authenticationprovider-sample/.vscode/launch.json

@@ -0,0 +1,34 @@
+// A launch configuration that compiles the extension and then opens it inside a new window
+// Use IntelliSense to learn about possible attributes.
+// Hover to view descriptions of existing attributes.
+// For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+{
+	"version": "0.2.0",
+	"configurations": [
+		{
+			"name": "Run Extension",
+			"type": "extensionHost",
+			"request": "launch",
+			"args": [
+				"--extensionDevelopmentPath=${workspaceFolder}"
+			],
+			"outFiles": [
+				"${workspaceFolder}/out/**/*.js"
+			],
+			"preLaunchTask": "${defaultBuildTask}"
+		},
+		{
+			"name": "Extension Tests",
+			"type": "extensionHost",
+			"request": "launch",
+			"args": [
+				"--extensionDevelopmentPath=${workspaceFolder}",
+				"--extensionTestsPath=${workspaceFolder}/out/test/suite/index"
+			],
+			"outFiles": [
+				"${workspaceFolder}/out/test/**/*.js"
+			],
+			"preLaunchTask": "${defaultBuildTask}"
+		}
+	]
+}

authenticationprovider-sample/.vscode/settings.json

@@ -0,0 +1,11 @@
+// Place your settings in this file to overwrite default and user settings.
+{
+    "files.exclude": {
+        "out": false // set this to true to hide the "out" folder with the compiled JS files
+    },
+    "search.exclude": {
+        "out": true // set this to false to include "out" folder in search results
+    },
+    // Turn off tsc task auto detection since we have the necessary tasks as npm scripts
+    "typescript.tsc.autoDetect": "off"
+}

authenticationprovider-sample/.vscode/tasks.json

@@ -0,0 +1,20 @@
+// See https://go.microsoft.com/fwlink/?LinkId=733558
+// for the documentation about the tasks.json format
+{
+	"version": "2.0.0",
+	"tasks": [
+		{
+			"type": "npm",
+			"script": "watch",
+			"problemMatcher": "$tsc-watch",
+			"isBackground": true,
+			"presentation": {
+				"reveal": "never"
+			},
+			"group": {
+				"kind": "build",
+				"isDefault": true
+			}
+		}
+	]
+}

authenticationprovider-sample/.vscodeignore

@@ -0,0 +1,12 @@
+.vscode/**
+.vscode-test/**
+out/test/**
+
+src/**
+.gitignore
+.yarnrc
+vsc-extension-quickstart.md
+**/tsconfig.json
+**/.eslintrc.json
+**/*.map
+**/*.ts

authenticationprovider-sample/CHANGELOG.md

@@ -0,0 +1,9 @@
+# Change Log
+
+All notable changes to the "vscode-authenticationprovider-sample" extension will be documented in this file.
+
+Check [Keep a Changelog](http://keepachangelog.com/) for recommendations on how to structure this file.
+
+## [Unreleased]
+
+- Initial release

authenticationprovider-sample/README.md

@@ -0,0 +1,20 @@
+# Azure DevOps Auth Provider - Authentication Provider API Sample
+
+Demonstrates VS Code's authentication provider API by registering and using an Azure DevOps Personal Access Token authentication provider.
+
+## VS Code API
+
+### `vscode` module
+
+- [`authentication.registerAuthenticationProvider`](https://code.visualstudio.com/api/references/vscode-api#authentication.registerAuthenticationProvider)
+- [`authentication.getSession`](https://code.visualstudio.com/api/references/vscode-api#authentication.getSession)
+
+## Running the example
+
+- Open this example in VS Code 1.60+
+- `npm install`
+- `cmd/ctrl+shift+b` or `npm run watch` or `npm run compile`
+- `F5` to start debugging
+
+Run the `Login with Azure DevOps` command to log in.
+ 

authenticationprovider-sample/eslint.config.mjs

@@ -0,0 +1,44 @@
+/**
+ * ESLint configuration for the project.
+ * 
+ * See https://eslint.style and https://typescript-eslint.io for additional linting options.
+ */
+// @ts-check
+import js from '@eslint/js';
+import tseslint from 'typescript-eslint';
+import stylistic from '@stylistic/eslint-plugin';
+
+export default tseslint.config(
+	{
+		ignores: [
+			'.vscode-test',
+			'out',
+		]
+	},
+	js.configs.recommended,
+	...tseslint.configs.recommended,
+	...tseslint.configs.stylistic,
+	{
+		plugins: {
+			'@stylistic': stylistic
+		},
+		rules: {
+			'curly': 'warn',
+			'@stylistic/semi': ['warn', 'always'],
+			'@typescript-eslint/no-empty-function': 'off',
+			'@typescript-eslint/naming-convention': [
+				'warn',
+				{
+					'selector': 'import',
+					'format': ['camelCase', 'PascalCase']
+				}
+			],
+			'@typescript-eslint/no-unused-vars': [
+				'error',
+				{
+					'argsIgnorePattern': '^_'
+				}
+			]
+		}
+	}
+);

authenticationprovider-sample/package.json

@@ -0,0 +1,49 @@
+{
+	"name": "vscode-authenticationprovider-sample",
+	"displayName": "AuthenticationProvider API Sample",
+	"description": "AuthenticationProvider API Sample",
+	"version": "0.0.1",
+	"engines": {
+		"vscode": "^1.100.0"
+	},
+	"categories": [
+		"Other"
+	],
+	"activationEvents": [],
+	"main": "./out/extension.js",
+	"contributes": {
+		"commands": [
+			{
+				"command": "vscode-authenticationprovider-sample.login",
+				"title": "Login with Azure DevOps"
+			}
+		],
+		"authentication": [
+			{
+				"id": "azuredevopspat",
+				"label": "Azure DevOps PAT"
+			}
+		]
+	},
+	"scripts": {
+		"vscode:prepublish": "npm run compile",
+		"compile": "tsc -p ./",
+		"watch": "tsc -watch -p ./",
+		"pretest": "npm run compile && npm run lint",
+		"lint": "eslint",
+		"test": "node ./out/test/runTest.js"
+	},
+	"devDependencies": {
+		"@eslint/js": "^9.13.0",
+		"@stylistic/eslint-plugin": "^2.9.0",
+		"@types/isomorphic-fetch": "^0.0.35",
+		"@types/node": "^22",
+		"@types/vscode": "^1.100.0",
+		"eslint": "^9.13.0",
+		"typescript": "^5.9.2",
+		"typescript-eslint": "^8.39.0"
+	},
+	"dependencies": {
+		"isomorphic-fetch": "^3.0.0"
+	}
+}

authenticationprovider-sample/src/authProvider.ts

@@ -0,0 +1,147 @@
+import {
+	authentication,
+	AuthenticationGetSessionOptions,
+	AuthenticationProvider,
+	AuthenticationProviderAuthenticationSessionsChangeEvent,
+	AuthenticationSession,
+	Disposable,
+	Event,
+	EventEmitter,
+	SecretStorage,
+	window,
+} from 'vscode';
+
+class AzureDevOpsPatSession implements AuthenticationSession {
+	// We don't know the user's account name, so we'll just use a constant
+	readonly account = { id: AzureDevOpsAuthenticationProvider.id, label: 'Personal Access Token' };
+	// This id isn't used for anything in this example, so we set it to a constant
+	readonly id = AzureDevOpsAuthenticationProvider.id;
+	// We don't know what scopes the PAT has, so we have an empty array here.
+	readonly scopes = [];
+
+	/**
+	 * 
+	 * @param accessToken The personal access token to use for authentication
+	 */
+	constructor(public readonly accessToken: string) { }
+}
+
+export class AzureDevOpsAuthenticationProvider implements AuthenticationProvider, Disposable {
+	static id = 'azuredevopspat';
+	private static secretKey = 'AzureDevOpsPAT';
+
+	// this property is used to determine if the token has been changed in another window of VS Code.
+	// It is used in the checkForUpdates function.
+	private currentToken: Promise<string | undefined> | undefined;
+	private initializedDisposable: Disposable | undefined;
+
+	private _onDidChangeSessions = new EventEmitter<AuthenticationProviderAuthenticationSessionsChangeEvent>();
+	get onDidChangeSessions(): Event<AuthenticationProviderAuthenticationSessionsChangeEvent> {
+		return this._onDidChangeSessions.event;
+	}
+
+	constructor(private readonly secretStorage: SecretStorage) { }
+
+	dispose(): void {
+		this.initializedDisposable?.dispose();
+	}
+
+	private ensureInitialized(): void {
+		if (this.initializedDisposable === undefined) {
+			void this.cacheTokenFromStorage();
+
+			this.initializedDisposable = Disposable.from(
+				// This onDidChange event happens when the secret storage changes in _any window_ since
+				// secrets are shared across all open windows.
+				this.secretStorage.onDidChange(e => {
+					if (e.key === AzureDevOpsAuthenticationProvider.secretKey) {
+						void this.checkForUpdates();
+					}
+				}),
+				// This fires when the user initiates a "silent" auth flow via the Accounts menu.
+				authentication.onDidChangeSessions(e => {
+					if (e.provider.id === AzureDevOpsAuthenticationProvider.id) {
+						void this.checkForUpdates();
+					}
+				}),
+			);
+		}
+	}
+
+	// This is a crucial function that handles whether or not the token has changed in
+	// a different window of VS Code and sends the necessary event if it has.
+	private async checkForUpdates(): Promise<void> {
+		const added: AuthenticationSession[] = [];
+		const removed: AuthenticationSession[] = [];
+		const changed: AuthenticationSession[] = [];
+
+		const previousToken = await this.currentToken;
+		const session = (await this.getSessions(undefined))[0];
+
+		if (session?.accessToken && !previousToken) {
+			added.push(session);
+		} else if (!session?.accessToken && previousToken) {
+			removed.push(session);
+		} else if (session?.accessToken !== previousToken) {
+			changed.push(session);
+		} else {
+			return;
+		}
+
+		void this.cacheTokenFromStorage();
+		this._onDidChangeSessions.fire({ added: added, removed: removed, changed: changed });
+	}
+
+	private cacheTokenFromStorage() {
+		this.currentToken = this.secretStorage.get(AzureDevOpsAuthenticationProvider.secretKey) as Promise<string | undefined>;
+		return this.currentToken;
+	}
+
+	// This function is called first when `vscode.authentication.getSessions` is called.
+	async getSessions(_scopes: string[] | undefined, _options?: AuthenticationGetSessionOptions): Promise<AuthenticationSession[]> {
+		this.ensureInitialized();
+		const token = await this.cacheTokenFromStorage();
+		return token ? [new AzureDevOpsPatSession(token)] : [];
+	}
+
+	// This function is called after `this.getSessions` is called and only when:
+	// - `this.getSessions` returns nothing but `createIfNone` was set to `true` in `vscode.authentication.getSessions`
+	// - `vscode.authentication.getSessions` was called with `forceNewSession: true`
+	// - The end user initiates the "silent" auth flow via the Accounts menu
+	async createSession(_scopes: string[]): Promise<AuthenticationSession> {
+		this.ensureInitialized();
+
+		// Prompt for the PAT.
+		const token = await window.showInputBox({
+			ignoreFocusOut: true,
+			placeHolder: 'Personal access token',
+			prompt: 'Enter an Azure DevOps Personal Access Token (PAT).',
+			password: true,
+		});
+
+		// Note: this example doesn't do any validation of the token beyond making sure it's not empty.
+		if (!token) {
+			throw new Error('PAT is required');
+		}
+
+		// Don't set `currentToken` here, since we want to fire the proper events in the `checkForUpdates` call
+		await this.secretStorage.store(AzureDevOpsAuthenticationProvider.secretKey, token);
+		console.log('Successfully logged in to Azure DevOps');
+
+		return new AzureDevOpsPatSession(token);
+	}
+
+	// This function is called when the end user signs out of the account.
+	async removeSession(_sessionId: string): Promise<void> {
+		const token = await this.currentToken;
+		if (!token) {
+			return;
+		}
+		await this.secretStorage.delete(AzureDevOpsAuthenticationProvider.secretKey);
+		this._onDidChangeSessions.fire({
+			removed: [new AzureDevOpsPatSession(token)],
+			added: [],
+			changed: [],
+		});
+	}
+}