docs: update copilot-cli content from source docs (#62433)

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
Co-authored-by: hubwriter <hubwriter@github.com>

Author: 3 people

content/copilot/reference/copilot-cli-reference/cli-command-reference.md

@@ -471,6 +471,7 @@ Use `--model=MODEL` or the `COPILOT_MODEL` environment variable to select the AI
 | `gpt-5.3-codex` | Code-focused tasks |
 | `gemini-3.1-pro-preview` | Google Gemini reasoning |
 | `gemini-3.5-flash` | Fast Google Gemini responses |
+| `gemini-3.6-flash` | Fast Google Gemini responses |
 | `mai-code-1-flash` | Fast, adaptive coding tasks |
 
 You can also switch models during an interactive session using the `/model` slash command.
@@ -675,7 +676,7 @@ Use `copilot mcp` to manage MCP server configurations from the command line with
 | Type | Description | Required fields |
 |------|-------------|----------------|
 | `local` / `stdio` | Local process communicating via stdin/stdout. | `command`, `args` |
-| `http` | Remote server using streamable HTTP transport. | `url` |
+| `http` | Remote server using streamable HTTP transport. `"streamable-http"` is also accepted as an alias and is normalized to `"http"`. | `url` |
 | `sse` | Remote server using Server-Sent Events transport. | `url` |
 
 ### Local server configuration fields
@@ -716,7 +717,7 @@ The `--registry` flag and other npm configuration flags (`--userconfig`, `--glob
 
 | Field | Required | Description |
 |-------|----------|-------------|
-| `type` | Yes | `"http"` or `"sse"`. |
+| `type` | Yes | `"http"` or `"sse"` (`"streamable-http"` is also accepted as an alias for `"http"`). |
 | `url` | Yes | Server URL. |
 | `tools` | Yes | Tools to enable. |
 | `headers` | No | HTTP headers. Supports variable expansion. |
@@ -1130,7 +1131,14 @@ Use `/permissions reset` to clear in-memory approvals for the current session.
 
 ### Plan mode
 
-`/plan` starts a read-only analysis session that prevents write operations and shell command execution while allowing full codebase exploration. Mutating tool calls—editor writes, `apply_patch` to non-plan files, mutating shell commands, and pull request creation—are hard-blocked at the tool layer, not just discouraged by the system prompt. Subagents spawned from a plan-mode session inherit the same restriction. Reads and writes to the plan file itself are still allowed.
+`/plan` starts a planning session where {% data variables.copilot.copilot_cli_short %} can explore and analyze your codebase but is blocked from editing your project files. Specifically:
+
+- **Your project files are protected.** Any attempt to edit, patch, or run a shell command that would change a file in your workspace is blocked automatically—this isn't just a suggestion to the model, it's enforced directly, so it doesn't depend on the model choosing to behave.
+- **The plan itself can still be written.** {% data variables.product.prodname_copilot_short %} needs somewhere to keep notes and draft the plan, so it's allowed to create and edit files in its own private planning workspace (including the plan file you'll review and approve).
+- **Delegated sub-tasks are protected too.** If {% data variables.product.prodname_copilot_short %} spins up a helper session to research part of your question, that helper inherits the same restrictions and can't edit your project either.
+- **It's a safety net, not a guarantee.** This protection is designed to catch clear, direct attempts to change your files—it's not an airtight lockdown. Some things are intentionally allowed through so research isn't overly restricted: for example, shell commands whose effect can't be clearly determined in advance, and calls to external/MCP tools you've connected. In practice this is rarely an issue, but plan mode should be thought of as "changes require your review before applying," not an absolute guarantee that nothing on disk can change.
+
+Once you're happy with the plan, approve it to exit plan mode and let {% data variables.product.prodname_copilot_short %} make the actual changes.
 
 ### Command safety analysis
 

content/copilot/reference/copilot-cli-reference/cli-plugin-reference.md

@@ -89,12 +89,13 @@ All plugins consist of a plugin directory containing, at minimum, a manifest fil
 
 | Field   | Type   | Description |
 |---------|--------|-------------|
-| `name`  | string | Kebab-case plugin name (letters, numbers, hyphens only). Max 64 chars. |
+| `name`  | string | Kebab-case plugin name (letters, numbers, hyphens only). Max 64 chars. Plugins that opt into [Open Plugin Spec support](#open-plugin-spec-support) may also use dots (for example, `acme.tools`). |
 
 ### Optional metadata fields
 
 | Field        | Type      | Description |
 |--------------|-----------|-------------|
+| `$schema`    | string    | Set to the canonical Agent Plugins (Open Plugin Spec) v1.0.0 schema URL to opt into spec semantics. See [Open Plugin Spec support](#open-plugin-spec-support). |
 | `description`| string    | Brief description. Max 1024 chars. |
 | `version`    | string    | Semantic version (e.g., `1.0.0`). |
 | `author`     | object    | `name` (required), `email` (optional), `url` (optional). |
@@ -115,14 +116,19 @@ These tell the CLI where to find your plugin's components. All are optional. The
 | `skills`    | string \| string[] | `skills/`  | Path(s) to skill directories (`SKILL.md` files). |
 | `commands`  | string \| string[] | —          | Path(s) to command directories. |
 | `hooks`     | string \| object   | —          | Path to a hooks configuration file, or an inline hooks object. |
-| `extensions`| string \| string[] \| object | —          | Path(s) to extension directories. Use `{ paths: [...], exclusive: true }` to suppress built-in extensions. |
+| `extensions`| string \| string[] \| object | —          | Path(s) to extension directories. Use `{ paths: [...], exclusive: true }` to suppress built-in extensions. In [Open Plugin Spec mode](#open-plugin-spec-support), this field has a different meaning. |
 | `mcpServers`| string \| object   | —          | Path to an MCP configuration file (e.g., `.mcp.json`), or inline server definitions. |
 | `lspServers`| string \| object   | —          | Path to an LSP configuration file, or inline server definitions. |
 
 ### Example `plugin.json` file
 
 {% data reusables.copilot.copilot-cli.cli-example-plugin-file %}
 
+## Open Plugin Spec support
+
+Declaring the canonical `$schema` in `plugin.json` opts a plugin into the [Agent Plugins (Open Plugin Spec)](https://agent-plugins.org) v1.0.0 format, additively on top of standard plugin loading:
+
+
 ### LSP server configuration
 
 To include LSP (Language Server Protocol) servers in a plugin, create a `lsp-config/servers.json` file in the plugin directory, or specify a path or inline object using the `lspServers` field in `plugin.json`.
@@ -196,7 +202,7 @@ For more information, see [AUTOTITLE](/copilot/how-tos/copilot-cli/customize-cop
 
 | Field      | Type     | Required | Description |
 |------------|----------|----------|-------------|
-| `name`     | string   | Yes      | Kebab-case marketplace name. Max 64 chars. |
+| `name`     | string   | Yes      | Kebab-case marketplace name. Max 64 chars. Dots are also accepted (for example, `acme.tools`) for [Open Plugin Spec](#open-plugin-spec-support) plugins. |
 | `owner`    | object   | Yes      | `{ name, email? }` — marketplace owner info. |
 | `plugins`  | array    | Yes      | List of plugin entries (see the table below). |
 | `metadata` | object   | No       | `{ description?, version?, pluginRoot? }` |
@@ -205,7 +211,7 @@ For more information, see [AUTOTITLE](/copilot/how-tos/copilot-cli/customize-cop
 
 | Field         | Type               | Required | Description |
 |---------------|--------------------|----------|-------------|
-| `name`        | string             | Yes      | Kebab-case plugin name. Max 64 chars. |
+| `name`        | string             | Yes      | Kebab-case plugin name. Max 64 chars. Dots are also accepted for [Open Plugin Spec](#open-plugin-spec-support) plugins. |
 | `source`      | string \| object   | Yes      | Where to fetch the plugin (relative path, {% data variables.product.github %}, or URL). |
 | `description` | string             | No       | Plugin description. Max 1024 chars. |
 | `version`     | string             | No       | Plugin version. |

src/content-pipelines/state/copilot-cli.sha

@@ -1 +1 @@
-99bdacdd87aebaa6496754421e70b45485235cc8
+00598e76021b5e4f4ba2903053c69c6010fa7190