cursor-guard 4.7.4 → 4.7.9

package/references/vscode-extension/dist/skill/recovery.md

@@ -0,0 +1,391 @@
+# Recovery Command Templates
+
+Replace `<path>` / `<file>` with real paths. Run from repository root. **Review output before destructive commands.**
+
+---
+
+## Preserve current version before restore / 恢复前保留当前版本
+
+> **Default behavior**: Every restore operation must first preserve current state.
+>
+> **默认行为**：每次恢复操作前必须先保留当前版本。
+
+### Single file / 单文件
+
+```powershell
+$ts = Get-Date -Format 'yyyyMMdd_HHmmss'
+$guardIdx = Join-Path (git rev-parse --git-dir) "guard-pre-restore-index"
+$env:GIT_INDEX_FILE = $guardIdx
+git read-tree HEAD
+git add -- <file>
+$tree = git write-tree
+$env:GIT_INDEX_FILE = $null
+Remove-Item $guardIdx -Force -ErrorAction SilentlyContinue
+$commit = git commit-tree $tree -p HEAD -m "guard: preserve current before restore"
+git update-ref "refs/guard/pre-restore/$ts" $commit
+git update-ref refs/guard/pre-restore $commit   # alias to latest
+Write-Host "Pre-restore backup: refs/guard/pre-restore/$ts ($($commit.Substring(0,7)))"
+```
+
+### Entire project / 整个项目
+
+```powershell
+$ts = Get-Date -Format 'yyyyMMdd_HHmmss'
+$guardIdx = Join-Path (git rev-parse --git-dir) "guard-pre-restore-index"
+$env:GIT_INDEX_FILE = $guardIdx
+git read-tree HEAD
+git add -A
+$tree = git write-tree
+$env:GIT_INDEX_FILE = $null
+Remove-Item $guardIdx -Force -ErrorAction SilentlyContinue
+$commit = git commit-tree $tree -p HEAD -m "guard: preserve current before restore"
+git update-ref "refs/guard/pre-restore/$ts" $commit
+git update-ref refs/guard/pre-restore $commit   # alias to latest
+Write-Host "Pre-restore backup: refs/guard/pre-restore/$ts ($($commit.Substring(0,7)))"
+```
+
+### Non-Git fallback (shadow copy) / 非 Git 备选方案
+
+```powershell
+$ts = Get-Date -Format 'yyyyMMdd_HHmmss'
+$dir = ".cursor-guard-backup/pre-restore-$ts"
+New-Item -ItemType Directory -Force $dir | Out-Null
+Copy-Item "<file>" "$dir/<filename>"
+Write-Host "Pre-restore shadow copy: $dir"
+```
+
+### List all pre-restore snapshots / 列出所有恢复前快照
+
+```bash
+git for-each-ref refs/guard/pre-restore/ --sort=-creatordate \
+  --format="%(refname:short) %(creatordate:short) %(objectname:short)"
+```
+
+### Undo a restore (recover pre-restore state) / 撤销恢复（回到恢复前的状态）
+
+```bash
+# Undo using a specific timestamped snapshot
+# 使用特定时间戳快照撤销恢复
+git restore --source=refs/guard/pre-restore/<yyyyMMdd_HHmmss> -- <file>
+
+# Undo using the latest pre-restore snapshot (alias)
+# 使用最近一次的恢复前快照撤销
+git restore --source=refs/guard/pre-restore -- <file>
+
+# Restore entire project / 恢复整个项目
+git restore --source=refs/guard/pre-restore/<yyyyMMdd_HHmmss> -- .
+
+# From shadow copy / 从影子拷贝恢复
+Copy-Item ".cursor-guard-backup/pre-restore-<ts>/<file>" "<original-path>"
+```
+
+### Clean up old pre-restore refs / 清理旧的恢复前快照
+
+```bash
+# Delete all pre-restore refs (keep only the latest alias)
+# 删除所有时间戳快照（仅保留 latest alias）
+git for-each-ref refs/guard/pre-restore/ --format="%(refname)" |
+  xargs -n1 git update-ref -d
+```
+
+---
+
+## Inspect current state
+
+```bash
+git status
+git diff
+git log --oneline -10
+```
+
+## Recent commits (compact)
+
+```bash
+git log --oneline -20 --decorate
+```
+
+## Restore one file to last commit (discard working tree changes)
+
+```bash
+git restore --source=HEAD -- <path/to/file>
+```
+
+## Restore one file from a specific commit
+
+```bash
+git restore --source=<commit> -- <path/to/file>
+```
+
+> Avoid shell redirects (`git show <commit>:file > file`) on Windows — they can corrupt encoding. Prefer `git restore --source`.
+
+## Undo uncommitted changes (entire repo) — **destructive**
+
+**Always preview first / 务必先预览：**
+
+```bash
+# Step 1: Preview what will be reverted / 预览将要还原的内容
+git diff
+
+# Step 2: Preview what untracked files would be removed / 预览将被删除的未跟踪文件
+git clean -fdn   # dry-run: shows what WOULD be deleted
+
+# Step 3: Only after user confirms / 用户确认后再执行
+git restore .
+```
+
+Only suggest `git clean -fd` if the user explicitly wants untracked removal; warn about data loss:
+
+```bash
+# DANGEROUS: removes untracked files — only after explicit confirmation
+# 危险：删除未跟踪文件——仅在用户明确确认后执行
+git clean -fd
+```
+
+## Recover "lost" commits / after reset
+
+```bash
+# Step 1: Find the lost commit / 找到丢失的提交
+git reflog
+
+# Step 2: Create a recovery branch (safe, non-destructive) / 创建恢复分支（安全）
+git branch recover-branch <hash>
+
+# Step 3 (alternative): Hard reset — DESTRUCTIVE, preview first
+# 硬重置——破坏性操作，先预览
+git diff HEAD <hash> --stat   # preview what changes
+git reset --hard <hash>       # only after confirmation
+```
+
+## Restore deleted file from HEAD (if it was committed)
+
+```bash
+git restore --source=HEAD -- <path/to/deleted/file>
+```
+
+## Stash (quick shelter before experiments)
+
+```bash
+git stash push -m "wip before experiment"
+git stash list
+git stash pop
+```
+
+## Restore to N minutes/hours ago / 恢复到 N 分钟/小时前
+
+The goal is to find the **latest commit AT or BEFORE** the target time.
+
+目标是找到目标时间点**之前（含）最近的一次提交**。
+
+```bash
+# Find the most recent commit BEFORE N minutes ago
+# 查找 N 分钟前之前最近的提交
+git log --oneline --before="5 minutes ago" -5 -- <file>
+
+# Find the most recent commit BEFORE N hours ago
+# 查找 N 小时前之前最近的提交
+git log --oneline --before="2 hours ago" -5 -- <file>
+
+# Reflog as fallback (captures resets, amends, etc.)
+# Reflog 作为兜底（能捕获 reset、amend 等操作）
+git reflog --before="5 minutes ago" -5
+
+# Restore file to the first (closest) commit found above
+# 恢复到上面找到的第一个（最近的）提交
+git restore --source=<commit-hash> -- <file>
+```
+
+## Restore to a specific time / 恢复到指定时间点
+
+```bash
+# Find the closest commit before a specific time
+# 查找指定时间点之前最近的提交
+git log --oneline --before="2026-03-21 15:00" -5 -- <file>
+git log --oneline --before="today 15:00" -5 -- <file>
+
+# Yesterday / 昨天
+git log --oneline --after="yesterday 00:00" --before="yesterday 23:59" -- <file>
+
+# Restore
+git restore --source=<commit-hash> -- <file>
+```
+
+## Restore to N versions ago / 恢复到前 N 个版本
+
+```bash
+# Show recent N commits for a file
+# 查看某文件最近 N 个提交
+git log --oneline -10 -- <file>
+
+# Restore to previous version (1 version ago)
+# 恢复到上一个版本
+git restore --source=HEAD~1 -- <file>
+
+# Restore to 3 versions ago
+# 恢复到前 3 个版本
+git restore --source=HEAD~3 -- <file>
+
+# Preview what the file looked like N versions ago (without restoring)
+# 预览 N 个版本前的文件内容（不实际恢复）
+git show HEAD~3:<file>
+
+# Diff current vs N versions ago
+# 对比当前和 N 个版本前的差异
+git diff HEAD~3 -- <file>
+```
+
+> **Note / 注意**: `HEAD~N` counts commits on the current branch. If you want the Nth commit that *changed this specific file*, use:
+>
+> `HEAD~N` 是按分支提交计数。如果想找第 N 次**修改该文件**的提交，用：
+>
+> ```bash
+> # Find the 3rd most recent commit that touched this file
+> git log --oneline -3 -- <file>
+> # Then use the hash from the output
+> git restore --source=<hash> -- <file>
+> ```
+
+## Restore entire project to a point in time / 恢复整个项目到某个时间点
+
+```bash
+# CAUTION: This affects ALL files. Review carefully!
+# 注意：这会影响所有文件，请仔细检查！
+
+# Step 1: Find the target commit / 第一步：找到目标提交
+git log --oneline --before="10 minutes ago" -5
+
+# Step 2: Preview what will change / 第二步：预览变更
+git diff <commit-hash> -- .
+
+# Step 3: Restore (after confirmation) / 第三步：恢复（确认后）
+git restore --source=<commit-hash> -- .
+```
+
+---
+
+## Recover from auto-backup branch
+
+The `auto-backup.ps1` script stores periodic snapshots on a dedicated branch via plumbing commands:
+
+```bash
+# List recent auto-backup snapshots
+git log guard/auto-backup --oneline -20
+
+# Restore a file from the latest auto-backup
+git restore --source=guard/auto-backup -- <path/to/file>
+
+# Restore from a specific auto-backup snapshot
+git restore --source=<commit-hash> -- <path/to/file>
+
+# Diff your working copy against the auto-backup version
+git diff guard/auto-backup -- <path/to/file>
+
+# Time-based: find auto-backup snapshot from before N minutes ago
+# 按时间查找：N 分钟前之前最近的自动备份快照
+git log guard/auto-backup --oneline --before="5 minutes ago" -5 -- <path/to/file>
+
+# Version-based: list recent N auto-backup snapshots
+# 按版本查找：最近 N 个自动备份快照
+git log guard/auto-backup --oneline -10 -- <path/to/file>
+```
+
+## If not a Git repo yet
+
+```bash
+git init
+git add -A
+git commit -m "guard: initial snapshot" --no-verify
+```
+
+This does **not** recover past work from before `init`.
+
+---
+
+## Shadow Copy Recovery (Non-Git Fallback)
+
+If `.cursor-guard-backup/` exists, find snapshots:
+
+```powershell
+# List all backup timestamps / 列出所有备份时间戳
+Get-ChildItem .cursor-guard-backup/ -Directory | Sort-Object Name -Descending
+
+# Restore a specific file from a timestamp / 从某个时间戳恢复文件
+Copy-Item ".cursor-guard-backup/<timestamp>/<filename>" "<original-path>"
+
+# Find the closest shadow copy to N minutes ago / 查找 N 分钟前最近的影子拷贝
+$target = (Get-Date).AddMinutes(-5)
+Get-ChildItem .cursor-guard-backup/ -Directory |
+    Where-Object { $_.Name -match '^\d{8}_\d{6}$' } |
+    ForEach-Object {
+        $dt = [datetime]::ParseExact($_.Name, "yyyyMMdd_HHmmss", $null)
+        [PSCustomObject]@{ Name = $_.Name; Time = $dt; Diff = [math]::Abs(($dt - $target).TotalSeconds) }
+    } | Sort-Object Diff | Select-Object -First 3
+```
+
+---
+
+## Windows-Specific Notes
+
+- **Long paths**: If you get path errors, enable long path support:
+  ```powershell
+  git config --local core.longpaths true   # use --global for system-wide
+  ```
+- **Line endings**: Git may show spurious diffs due to CRLF/LF. Check with:
+  ```bash
+  git diff --check
+  ```
+  Fix with `git config --local core.autocrlf true` if desired (or `--global` for system-wide).
+- **PowerShell quoting**: Use single quotes for paths with spaces in PowerShell:
+  ```powershell
+  git restore --source=HEAD -- 'src/my file.py'
+  ```
+- **File locks**: If a file is locked by another process (e.g. Cursor still has it open), `git restore` may fail. Close the tab first or use:
+  ```powershell
+  # Force close file handle (admin required, use with caution)
+  # Prefer: just close the file tab in Cursor, then retry git restore.
+  ```
+
+---
+
+## Non-Git Auxiliary Recovery
+
+- **VS Code / Cursor Timeline (Local History)**: per-file; access via right-click file tab → "Open Timeline". May miss tool-only writes (Write/StrReplace via agent).
+- **Checkpoints**: inside Agent thread UI only. Not guaranteed for all edit paths. Not long-term storage.
+- **Conversation context**: if the agent used the Read tool on a file before overwriting it, the original content exists in the chat history. Ask the agent to re-write the original content back.
+- **Recycle Bin (Windows)**: only catches files deleted via Explorer, NOT via `rm` / `Remove-Item` / agent Delete tool.
+
+---
+
+## Backup Cleanup
+
+### Shadow copies
+
+```powershell
+# List all shadow copy snapshots (newest first)
+Get-ChildItem .cursor-guard-backup/ -Directory | Sort-Object Name -Descending
+
+# Delete snapshots older than 30 days
+$cutoff = (Get-Date).AddDays(-30)
+Get-ChildItem .cursor-guard-backup/ -Directory | Where-Object {
+    try { [datetime]::ParseExact($_.Name, "yyyyMMdd_HHmmss", $null) -lt $cutoff } catch { $false }
+} | Remove-Item -Recurse -Force
+```
+
+### Auto-backup branch
+
+```bash
+# View auto-backup history
+git log guard/auto-backup --oneline -30
+
+# Delete the branch entirely (script will recreate it on next run)
+git update-ref -d refs/guard/auto-backup
+
+# Reclaim disk space after removing old branches
+git gc --prune=now
+```
+
+### Log file
+
+```powershell
+# View recent backup log entries
+Get-Content .cursor-guard-backup/backup.log -Tail 30
+```

package/references/vscode-extension/dist/vendor/@modelcontextprotocol/sdk/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Anthropic, PBC
+
+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.

package/references/vscode-extension/dist/vendor/@modelcontextprotocol/sdk/README.md

@@ -0,0 +1,170 @@
+# MCP TypeScript SDK [![NPM Version](https://img.shields.io/npm/v/%40modelcontextprotocol%2Fsdk)](https://www.npmjs.com/package/@modelcontextprotocol/sdk) [![MIT licensed](https://img.shields.io/npm/l/%40modelcontextprotocol%2Fsdk)](https://github.com/modelcontextprotocol/typescript-sdk/blob/main/LICENSE)
+
+<details>
+<summary>Table of Contents</summary>
+
+- [Overview](#overview)
+- [Installation](#installation)
+- [Quick Start](#quick-start)
+- [Core Concepts](#core-concepts)
+- [Examples](#examples)
+- [Documentation](#documentation)
+- [Contributing](#contributing)
+- [License](#license)
+
+</details>
+
+## Overview
+
+The Model Context Protocol allows applications to provide context for LLMs in a standardized way, separating the concerns of providing context from the actual LLM interaction. This TypeScript SDK implements
+[the full MCP specification](https://modelcontextprotocol.io/specification/draft), making it easy to:
+
+- Create MCP servers that expose resources, prompts and tools
+- Build MCP clients that can connect to any MCP server
+- Use standard transports like stdio and Streamable HTTP
+
+## Installation
+
+```bash
+npm install @modelcontextprotocol/sdk zod
+```
+
+This SDK has a **required peer dependency** on `zod` for schema validation. The SDK internally imports from `zod/v4`, but maintains backwards compatibility with projects using Zod v3.25 or later. You can use either API in your code by importing from `zod/v3` or `zod/v4`:
+
+## Quick Start
+
+To see the SDK in action end-to-end, start from the runnable examples in `src/examples`:
+
+1. **Install dependencies** (from the SDK repo root):
+
+    ```bash
+    npm install
+    ```
+
+2. **Run the example Streamable HTTP server**:
+
+    ```bash
+    npx tsx src/examples/server/simpleStreamableHttp.ts
+    ```
+
+3. **Run the interactive client in another terminal**:
+
+    ```bash
+    npx tsx src/examples/client/simpleStreamableHttp.ts
+    ```
+
+This pair of examples demonstrates tools, resources, prompts, sampling, elicitation, tasks and logging. For a guided walkthrough and variations (stateless servers, JSON-only responses, SSE compatibility, OAuth, etc.), see [docs/server.md](docs/server.md) and
+[docs/client.md](docs/client.md).
+
+## Core Concepts
+
+### Servers and transports
+
+An MCP server is typically created with `McpServer` and connected to a transport such as Streamable HTTP or stdio. The SDK supports:
+
+- **Streamable HTTP** for remote servers (recommended).
+- **HTTP + SSE** for backwards compatibility only.
+- **stdio** for local, process-spawned integrations.
+
+Runnable server examples live under `src/examples/server` and are documented in [docs/server.md](docs/server.md).
+
+### Tools, resources, prompts
+
+- **Tools** let LLMs ask your server to take actions (computation, side effects, network calls).
+- **Resources** expose read-only data that clients can surface to users or models.
+- **Prompts** are reusable templates that help users talk to models in a consistent way.
+
+The detailed APIs, including `ResourceTemplate`, completions, and display-name metadata, are covered in [docs/server.md](docs/server.md#tools-resources-and-prompts), with runnable implementations in [`simpleStreamableHttp.ts`](src/examples/server/simpleStreamableHttp.ts).
+
+### Capabilities: sampling, elicitation, and tasks
+
+The SDK includes higher-level capabilities for richer workflows:
+
+- **Sampling**: server-side tools can ask connected clients to run LLM completions.
+- **Form elicitation**: tools can request non-sensitive input via structured forms.
+- **URL elicitation**: servers can ask users to complete secure flows in a browser (e.g., API key entry, payments, OAuth).
+- **Tasks (experimental)**: long-running tool calls can be turned into tasks that you poll or resume later.
+
+Conceptual overviews and links to runnable examples are in:
+
+- [docs/capabilities.md](docs/capabilities.md)
+
+Key example servers include:
+
+- [`toolWithSampleServer.ts`](src/examples/server/toolWithSampleServer.ts)
+- [`elicitationFormExample.ts`](src/examples/server/elicitationFormExample.ts)
+- [`elicitationUrlExample.ts`](src/examples/server/elicitationUrlExample.ts)
+
+### Clients
+
+The high-level `Client` class connects to MCP servers over different transports and exposes helpers like `listTools`, `callTool`, `listResources`, `readResource`, `listPrompts`, and `getPrompt`.
+
+Runnable clients live under `src/examples/client` and are described in [docs/client.md](docs/client.md), including:
+
+- Interactive Streamable HTTP client ([`simpleStreamableHttp.ts`](src/examples/client/simpleStreamableHttp.ts))
+- Streamable HTTP client with SSE fallback ([`streamableHttpWithSseFallbackClient.ts`](src/examples/client/streamableHttpWithSseFallbackClient.ts))
+- OAuth-enabled clients and polling/parallel examples
+
+### Node.js Web Crypto (globalThis.crypto) compatibility
+
+Some parts of the SDK (for example, JWT-based client authentication in `auth-extensions.ts` via `jose`) rely on the Web Crypto API exposed as `globalThis.crypto`.
+
+See [docs/faq.md](docs/faq.md) for details on supported Node.js versions and how to polyfill `globalThis.crypto` when running on older Node.js runtimes.
+
+## Examples
+
+The SDK ships runnable examples under `src/examples`. Use these tables to find the scenario you care about and jump straight to the corresponding code and docs.
+
+### Server examples
+
+| Scenario                                            | Description                                                                                       | Example file(s)                                                                                          | Related docs                                                             |
+| --------------------------------------------------- | ------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
+| Streamable HTTP server (stateful)                   | Feature-rich server with tools, resources, prompts, logging, tasks, sampling, and optional OAuth. | [`simpleStreamableHttp.ts`](src/examples/server/simpleStreamableHttp.ts)                                 | [`server.md`](docs/server.md), [`capabilities.md`](docs/capabilities.md) |
+| Streamable HTTP server (stateless)                  | No session tracking; good for simple API-style servers.                                           | [`simpleStatelessStreamableHttp.ts`](src/examples/server/simpleStatelessStreamableHttp.ts)               | [`server.md`](docs/server.md)                                            |
+| JSON response mode (no SSE)                         | Streamable HTTP with JSON responses only and limited notifications.                               | [`jsonResponseStreamableHttp.ts`](src/examples/server/jsonResponseStreamableHttp.ts)                     | [`server.md`](docs/server.md)                                            |
+| Server notifications over Streamable HTTP           | Demonstrates server-initiated notifications using SSE with Streamable HTTP.                       | [`standaloneSseWithGetStreamableHttp.ts`](src/examples/server/standaloneSseWithGetStreamableHttp.ts)     | [`server.md`](docs/server.md)                                            |
+| Deprecated HTTP+SSE server                          | Legacy HTTP+SSE transport for backwards-compatibility testing.                                    | [`simpleSseServer.ts`](src/examples/server/simpleSseServer.ts)                                           | [`server.md`](docs/server.md)                                            |
+| Backwards-compatible server (Streamable HTTP + SSE) | Single server that supports both Streamable HTTP and legacy SSE clients.                          | [`sseAndStreamableHttpCompatibleServer.ts`](src/examples/server/sseAndStreamableHttpCompatibleServer.ts) | [`server.md`](docs/server.md)                                            |
+| Form elicitation server                             | Uses form elicitation to collect non-sensitive user input.                                        | [`elicitationFormExample.ts`](src/examples/server/elicitationFormExample.ts)                             | [`capabilities.md`](docs/capabilities.md#elicitation)                    |
+| URL elicitation server                              | Demonstrates URL-mode elicitation in an OAuth-protected server.                                   | [`elicitationUrlExample.ts`](src/examples/server/elicitationUrlExample.ts)                               | [`capabilities.md`](docs/capabilities.md#elicitation)                    |
+| Sampling and tasks server                           | Combines tools, logging, sampling, and experimental task-based execution.                         | [`toolWithSampleServer.ts`](src/examples/server/toolWithSampleServer.ts)                                 | [`capabilities.md`](docs/capabilities.md)                                |
+| OAuth demo authorization server                     | In-memory OAuth provider used with the example servers.                                           | [`demoInMemoryOAuthProvider.ts`](src/examples/server/demoInMemoryOAuthProvider.ts)                       | [`server.md`](docs/server.md)                                            |
+
+### Client examples
+
+| Scenario                                            | Description                                                                        | Example file(s)                                                                                                                                                                                                                        | Related docs                                                 |
+| --------------------------------------------------- | ---------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------ |
+| Interactive Streamable HTTP client                  | CLI client that exercises tools, resources, prompts, elicitation, and tasks.       | [`simpleStreamableHttp.ts`](src/examples/client/simpleStreamableHttp.ts)                                                                                                                                                               | [`client.md`](docs/client.md)                                |
+| Backwards-compatible client (Streamable HTTP → SSE) | Tries Streamable HTTP first, then falls back to SSE on 4xx responses.              | [`streamableHttpWithSseFallbackClient.ts`](src/examples/client/streamableHttpWithSseFallbackClient.ts)                                                                                                                                 | [`client.md`](docs/client.md), [`server.md`](docs/server.md) |
+| SSE polling client                                  | Polls a legacy SSE server and demonstrates notification handling.                  | [`ssePollingClient.ts`](src/examples/client/ssePollingClient.ts)                                                                                                                                                                       | [`client.md`](docs/client.md)                                |
+| Parallel tool calls client                          | Shows how to run multiple tool calls in parallel.                                  | [`parallelToolCallsClient.ts`](src/examples/client/parallelToolCallsClient.ts)                                                                                                                                                         | [`client.md`](docs/client.md)                                |
+| Multiple clients in parallel                        | Demonstrates connecting multiple clients concurrently to the same server.          | [`multipleClientsParallel.ts`](src/examples/client/multipleClientsParallel.ts)                                                                                                                                                         | [`client.md`](docs/client.md)                                |
+| OAuth clients                                       | Examples of client_credentials (basic and private_key_jwt) and reusable providers. | [`simpleOAuthClient.ts`](src/examples/client/simpleOAuthClient.ts), [`simpleOAuthClientProvider.ts`](src/examples/client/simpleOAuthClientProvider.ts), [`simpleClientCredentials.ts`](src/examples/client/simpleClientCredentials.ts) | [`client.md`](docs/client.md)                                |
+| URL elicitation client                              | Works with the URL elicitation server to drive secure browser flows.               | [`elicitationUrlExample.ts`](src/examples/client/elicitationUrlExample.ts)                                                                                                                                                             | [`capabilities.md`](docs/capabilities.md#elicitation)        |
+
+Shared utilities:
+
+- In-memory event store for resumability: [`inMemoryEventStore.ts`](src/examples/shared/inMemoryEventStore.ts) (see [`server.md`](docs/server.md)).
+
+For more details on how to run these examples (including recommended commands and deployment diagrams), see `src/examples/README.md`.
+
+## Documentation
+
+- Local SDK docs:
+    - [docs/server.md](docs/server.md) – building and running MCP servers, transports, tools/resources/prompts, CORS, DNS rebinding, and multi-node deployment.
+    - [docs/client.md](docs/client.md) – using the high-level client, transports, backwards compatibility, and OAuth helpers.
+    - [docs/capabilities.md](docs/capabilities.md) – sampling, elicitation (form and URL), and experimental task-based execution.
+    - [docs/protocol.md](docs/protocol.md) – protocol features: ping, progress, cancellation, pagination, capability negotiation, and JSON Schema.
+    - [docs/faq.md](docs/faq.md) – environment and troubleshooting FAQs (including Node.js Web Crypto support).
+- External references:
+    - [Model Context Protocol documentation](https://modelcontextprotocol.io)
+    - [MCP Specification](https://spec.modelcontextprotocol.io)
+    - [Example Servers](https://github.com/modelcontextprotocol/servers)
+
+## Contributing
+
+Issues and pull requests are welcome on GitHub at <https://github.com/modelcontextprotocol/typescript-sdk>.
+
+## License
+
+This project is licensed under the MIT License—see the [LICENSE](LICENSE) file for details.