@codingame/monaco-vscode-chat-service-override 34.1.2 → 35.0.0

package/vscode/src/vs/platform/agentHost/common/agentHostStarter.config.contribution.js

@@ -1,31 +1,107 @@
 
 import { localize } from '@codingame/monaco-vscode-api/vscode/vs/nls';
-import { Extensions } from '@codingame/monaco-vscode-api/vscode/vs/platform/configuration/common/configurationRegistry';
+import { PolicyCategory } from '@codingame/monaco-vscode-api/vscode/vs/base/common/policy';
+import { Extensions, ConfigurationScope } from '@codingame/monaco-vscode-api/vscode/vs/platform/configuration/common/configurationRegistry';
+import { COPILOT_OTEL_PROTOCOL_KEY, COPILOT_OTEL_CAPTURE_CONTENT_KEY, COPILOT_OTEL_LOCK_CAPTURE_CONTENT_KEY, COPILOT_OTEL_ENDPOINT_KEY, COPILOT_OTEL_HEADERS_KEY, managedSettingValue, COPILOT_OTEL_RESOURCE_ATTRIBUTES_KEY, COPILOT_OTEL_SERVICE_NAME_KEY, COPILOT_OTEL_ENABLED_KEY } from '@codingame/monaco-vscode-api/vscode/vs/platform/policy/common/copilotManagedSettings';
 import product from '@codingame/monaco-vscode-api/vscode/vs/platform/product/common/product';
 import { Registry } from '@codingame/monaco-vscode-api/vscode/vs/platform/registry/common/platform';
-import { AgentHostOTelDbSpanExporterEnabledSettingId, AgentHostOTelOutfileSettingId, AgentHostOTelCaptureContentSettingId, AgentHostOTelOtlpEndpointSettingId, AgentHostOTelExporterTypeSettingId, AgentHostOTelEnabledSettingId, AgentHostCodexAgentBinaryArgsSettingId, AgentHostCodexAgentCodexHomeSettingId, AgentHostCodexAgentBinaryPathSettingId, AgentHostClaudeAgentSdkPathSettingId } from './agentService.js';
+import { AgentHostOTelResourceAttributesSettingId, AgentHostOTelServiceNameSettingId, AgentHostOTelDbSpanExporterEnabledSettingId, AgentHostOTelOutfileSettingId, AgentHostOTelCaptureContentSettingId, AgentHostOTelOtlpEndpointSettingId, AgentHostOTelOtlpProtocolSettingId, AgentHostOTelExporterTypeSettingId, AgentHostOTelEnabledSettingId, AgentHostCodexAgentBinaryArgsSettingId, AgentHostCodexAgentCodexHomeSettingId, AgentHostCodexAgentSdkRootSettingId, AgentHostCodexAgentEnabledSettingId, AgentHostByokModelsEnabledSettingId, AgentHostClaudeAgentEnabledSettingId } from './agentService.js';
 
 const configurationRegistry = ( Registry.as(Extensions.Configuration));
+function managedOTelProtocolValue(policyData) {
+    const protocol = policyData.managedSettings?.[COPILOT_OTEL_PROTOCOL_KEY];
+    if (protocol === "grpc") {
+        return "otlp-grpc";
+    }
+    if (protocol === "http/protobuf" || protocol === "http/json") {
+        return "otlp-http";
+    }
+    return undefined;
+}
+function managedOTelCaptureContentValue(policyData) {
+    const captureContent = policyData.managedSettings?.[COPILOT_OTEL_CAPTURE_CONTENT_KEY];
+    if (typeof captureContent === "boolean") {
+        return captureContent;
+    }
+    return policyData.managedSettings?.[COPILOT_OTEL_LOCK_CAPTURE_CONTENT_KEY] === true ? false : undefined;
+}
+function managedOTelOutfileValue(policyData) {
+    const managedSettings = policyData.managedSettings;
+    if (managedSettings?.[COPILOT_OTEL_ENDPOINT_KEY] !== undefined || managedSettings?.[COPILOT_OTEL_PROTOCOL_KEY] !== undefined) {
+        return "";
+    }
+    return undefined;
+}
 configurationRegistry.registerConfiguration({
     id: "chatAgentHostStarter",
-    title: ( localize(1847, "Chat Agent Host Starter")),
+    title: ( localize(1888, "Chat Agent Host Starter")),
     type: "object",
     properties: {
-        [AgentHostClaudeAgentSdkPathSettingId]: {
-            type: "string",
+        [AgentHostClaudeAgentEnabledSettingId]: {
+            type: "boolean",
             description: ( localize(
-                1848,
-                "Experimental, for local testing only. Absolute path to a locally-installed `@anthropic-ai/claude-agent-sdk` package. When set, the Claude agent provider is registered inside the agent host and the SDK is loaded from this path. Requires `#chat.agentHost.enabled#`. The agent host process must be restarted for changes to take effect. This setting will be removed once the SDK is delivered through the Extension Marketplace."
+                1889,
+                "When enabled, the agent host registers the Claude provider (subject to the Claude SDK being reachable). Independent of `#chat.agents.claude.preferAgentHost#` and `#chat.editor.claude.preferAgentHost#`, which choose which integration surfaces Claude. Requires `#chat.agentHost.enabled#`. The agent host process must be restarted for changes to take effect."
             )),
-            default: "",
+            default: true,
             tags: ["experimental", "advanced"],
-            included: product.quality !== "stable"
+            policy: {
+                name: "Claude3PIntegration",
+                category: PolicyCategory.InteractiveSession,
+                minimumVersion: "1.113",
+                value: policyData => policyData.chat_preview_features_enabled === false ? false : undefined,
+                localization: {
+                    description: {
+                        key: "chat.agentHost.claudeAgent.enabled.policy",
+                        value: ( localize(
+                            1890,
+                            "Enable Claude Agent sessions in VS Code. Start and resume agentic coding sessions powered by Anthropic Claude Agent SDK directly in the editor. Uses your existing Copilot subscription."
+                        ))
+                    }
+                }
+            }
+        },
+        [AgentHostByokModelsEnabledSettingId]: {
+            type: "boolean",
+            description: ( localize(
+                1891,
+                "When enabled, the agent host wires up the BYOK ('bring your own key') language-model bridge so extension-provided BYOK models can run in agent-host sessions. Requires `#chat.agentHost.enabled#`. The agent host process must be restarted for changes to take effect."
+            )),
+            default: false,
+            tags: ["experimental", "advanced"]
         },
-        [AgentHostCodexAgentBinaryPathSettingId]: {
+        [AgentHostCodexAgentEnabledSettingId]: {
+            type: "boolean",
+            description: ( localize(
+                1892,
+                "When enabled, the agent host registers the Codex provider (subject to the Codex SDK being reachable). Requires `#chat.agentHost.enabled#`. The agent host process must be restarted for changes to take effect."
+            )),
+            default: false,
+            tags: ["experimental", "advanced"],
+            experiment: {
+                mode: "startup"
+            },
+            policy: {
+                name: "Codex3PIntegration",
+                category: PolicyCategory.InteractiveSession,
+                minimumVersion: "1.126",
+                value: policyData => policyData.chat_preview_features_enabled === false ? false : undefined,
+                localization: {
+                    description: {
+                        key: "chat.agentHost.codexAgent.enabled.policy",
+                        value: ( localize(
+                            1893,
+                            "Enable Codex Agent sessions in VS Code. Start and resume agentic coding sessions powered by OpenAI Codex SDK. Uses your existing Copilot subscription."
+                        ))
+                    }
+                }
+            }
+        },
+        [AgentHostCodexAgentSdkRootSettingId]: {
             type: "string",
             description: ( localize(
-                1849,
-                "Experimental, for local testing only. Absolute path to a locally-installed `codex` binary. When set, the Codex agent provider is registered inside the agent host and `codex app-server` is spawned from this path. Requires `#chat.agentHost.enabled#`. The agent host process must be restarted for changes to take effect."
+                1894,
+                "Experimental, for local SDK development only. Absolute path to a directory containing `node_modules/@openai/codex`. When set, the agent host spawns the Codex binary from this tree instead of downloading the SDK. Empty (the default) falls through to the SDK distribution shipped with this build. Requires `#chat.agentHost.enabled#`. The agent host process must be restarted for changes to take effect."
             )),
             default: "",
             tags: ["experimental", "advanced"],
@@ -34,7 +110,7 @@ configurationRegistry.registerConfiguration({
         [AgentHostCodexAgentCodexHomeSettingId]: {
             type: "string",
             description: ( localize(
-                1850,
+                1895,
                 "Optional override for `$CODEX_HOME`. Controls where the codex binary reads config and writes rollouts. When empty, codex uses its default (`~/.codex`)."
             )),
             default: "",
@@ -47,7 +123,7 @@ configurationRegistry.registerConfiguration({
                 type: "string"
             },
             description: ( localize(
-                1851,
+                1896,
                 "Additional command-line arguments passed to `codex app-server`. Primarily useful for debugging (for example, `--log-level=debug`)."
             )),
             default: [],
@@ -57,63 +133,312 @@ configurationRegistry.registerConfiguration({
         [AgentHostOTelEnabledSettingId]: {
             type: "boolean",
             markdownDescription: ( localize(
-                1852,
-                "When enabled, the agent host emits OpenTelemetry traces from the Copilot SDK. Requires `#chat.agentHost.enabled#`. Either configure `#chat.agentHost.otel.otlpEndpoint#` to ship traces to an external collector or enable `#chat.agentHost.otel.dbSpanExporter.enabled#` to capture them locally."
+                1897,
+                "When enabled, the agent host emits OpenTelemetry traces from the Copilot SDK. Configurable in user settings only. Requires `#chat.agentHost.enabled#`. Either configure `#chat.agentHost.otel.otlpEndpoint#` to ship traces to an external collector or enable `#chat.agentHost.otel.dbSpanExporter.enabled#` to capture them locally."
             )),
             default: false,
-            restricted: true,
-            tags: ["experimental", "advanced"]
+            scope: ConfigurationScope.APPLICATION,
+            tags: ["experimental", "advanced"],
+            policy: {
+                name: "CopilotOtelEnabled",
+                category: PolicyCategory.InteractiveSession,
+                minimumVersion: "1.127",
+                value: managedSettingValue(COPILOT_OTEL_ENABLED_KEY),
+                managedSettings: {
+                    [COPILOT_OTEL_ENABLED_KEY]: {
+                        type: "boolean"
+                    }
+                },
+                localization: {
+                    description: {
+                        key: "chat.agentHost.otel.enabled.policy",
+                        value: ( localize(
+                            1898,
+                            "Controls whether Copilot OpenTelemetry export is enabled. When managed, users cannot override the enterprise value."
+                        ))
+                    }
+                }
+            }
         },
         [AgentHostOTelExporterTypeSettingId]: {
             type: "string",
             enum: ["otlp-http", "otlp-grpc", "console", "file"],
             markdownDescription: ( localize(
-                1853,
-                "Exporter backend used by the Copilot SDK when `#chat.agentHost.otel.enabled#` is on. `otlp-grpc` is downgraded to `otlp-http` transparently in the CLI runtime."
+                1899,
+                "Exporter backend used by the Copilot SDK when `#chat.agentHost.otel.enabled#` is on. Configurable in user settings only. `otlp-grpc` is downgraded to `otlp-http` transparently in the CLI runtime."
             )),
             default: "otlp-http",
-            restricted: true,
-            tags: ["experimental", "advanced"]
+            scope: ConfigurationScope.APPLICATION,
+            tags: ["experimental", "advanced"],
+            policy: {
+                name: "CopilotOtelProtocol",
+                category: PolicyCategory.InteractiveSession,
+                minimumVersion: "1.127",
+                value: managedOTelProtocolValue,
+                managedSettings: {
+                    [COPILOT_OTEL_PROTOCOL_KEY]: {
+                        type: "string"
+                    }
+                },
+                localization: {
+                    description: {
+                        key: "chat.agentHost.otel.protocol.policy",
+                        value: ( localize(
+                            1900,
+                            "Controls the enterprise-managed OTLP protocol for Copilot OpenTelemetry export."
+                        ))
+                    },
+                    enumDescriptions: [{
+                        key: "chat.agentHost.otel.protocol.policy.otlpHttp",
+                        value: ( localize(1901, "Use OTLP over HTTP."))
+                    }, {
+                        key: "chat.agentHost.otel.protocol.policy.otlpGrpc",
+                        value: ( localize(1902, "Use OTLP over gRPC."))
+                    }, {
+                        key: "chat.agentHost.otel.protocol.policy.console",
+                        value: ( localize(1903, "Console exporter is not selected by enterprise managed settings."))
+                    }, {
+                        key: "chat.agentHost.otel.protocol.policy.file",
+                        value: ( localize(1904, "File exporter is not selected by enterprise managed settings."))
+                    }]
+                }
+            }
+        },
+        [AgentHostOTelOtlpProtocolSettingId]: {
+            type: "string",
+            markdownDescription: ( localize(
+                1905,
+                "Enterprise-managed OTLP wire protocol (`http/json`, `http/protobuf`, or `grpc`) for Copilot OpenTelemetry export. Policy-only: there is no user-facing setting; it carries the managed `telemetry.protocol` so the agent host's `OTEL_EXPORTER_OTLP_PROTOCOL` distinguishes protobuf from json."
+            )),
+            default: "",
+            scope: ConfigurationScope.APPLICATION,
+            included: false,
+            tags: ["experimental", "advanced"],
+            policy: {
+                name: "CopilotOtelOtlpProtocol",
+                category: PolicyCategory.InteractiveSession,
+                minimumVersion: "1.127",
+                value: managedSettingValue(COPILOT_OTEL_PROTOCOL_KEY),
+                managedSettings: {
+                    [COPILOT_OTEL_PROTOCOL_KEY]: {
+                        type: "string"
+                    }
+                },
+                localization: {
+                    description: {
+                        key: "chat.agentHost.otel.otlpProtocol.policy",
+                        value: ( localize(
+                            1906,
+                            "Controls the enterprise-managed OTLP wire protocol (protobuf vs JSON) for Copilot OpenTelemetry export."
+                        ))
+                    }
+                }
+            }
         },
         [AgentHostOTelOtlpEndpointSettingId]: {
             type: "string",
             markdownDescription: ( localize(
-                1854,
-                "OTLP endpoint URL when exporter type is `otlp-http` or `otlp-grpc`. Sets `OTEL_EXPORTER_OTLP_ENDPOINT` inside the agent host process."
+                1907,
+                "OTLP endpoint URL when exporter type is `otlp-http` or `otlp-grpc`. Configurable in user settings only. Sets `OTEL_EXPORTER_OTLP_ENDPOINT` inside the agent host process."
             )),
             default: "",
-            restricted: true,
-            tags: ["experimental", "advanced"]
+            scope: ConfigurationScope.APPLICATION,
+            tags: ["experimental", "advanced"],
+            policy: {
+                name: "CopilotOtelEndpoint",
+                category: PolicyCategory.InteractiveSession,
+                minimumVersion: "1.127",
+                value: managedSettingValue(COPILOT_OTEL_ENDPOINT_KEY),
+                managedSettings: {
+                    [COPILOT_OTEL_ENDPOINT_KEY]: {
+                        type: "string"
+                    }
+                },
+                localization: {
+                    description: {
+                        key: "chat.agentHost.otel.otlpEndpoint.policy",
+                        value: ( localize(
+                            1908,
+                            "Controls the enterprise-managed OTLP collector endpoint for Copilot OpenTelemetry export."
+                        ))
+                    }
+                }
+            }
         },
         [AgentHostOTelCaptureContentSettingId]: {
             type: "boolean",
             markdownDescription: ( localize(
-                1855,
-                "When enabled, includes prompt and response content in OTel span attributes. Sets `OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT`. Privacy-sensitive: do not enable in environments that ship spans to shared sinks."
+                1909,
+                "When enabled, includes prompt and response content in OTel span attributes. Configurable in user settings only. Sets `OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT`. Privacy-sensitive: do not enable in environments that ship spans to shared sinks."
             )),
             default: false,
-            restricted: true,
-            tags: ["experimental", "advanced"]
+            scope: ConfigurationScope.APPLICATION,
+            tags: ["experimental", "advanced"],
+            policy: {
+                name: "CopilotOtelCaptureContent",
+                category: PolicyCategory.InteractiveSession,
+                minimumVersion: "1.127",
+                value: managedOTelCaptureContentValue,
+                managedSettings: {
+                    [COPILOT_OTEL_CAPTURE_CONTENT_KEY]: {
+                        type: "boolean"
+                    },
+                    [COPILOT_OTEL_LOCK_CAPTURE_CONTENT_KEY]: {
+                        type: "boolean"
+                    }
+                },
+                localization: {
+                    description: {
+                        key: "chat.agentHost.otel.captureContent.policy",
+                        value: ( localize(
+                            1910,
+                            "Controls whether Copilot OpenTelemetry export captures prompt, response, and tool content."
+                        ))
+                    }
+                }
+            }
         },
         [AgentHostOTelOutfileSettingId]: {
             type: "string",
             markdownDescription: ( localize(
-                1856,
-                "Output path for span JSON lines when exporter type is `file`. Sets `COPILOT_OTEL_FILE_EXPORTER_PATH`."
+                1911,
+                "Output path for span JSON lines when exporter type is `file`. Configurable in user settings only. Sets `COPILOT_OTEL_FILE_EXPORTER_PATH`."
             )),
             default: "",
-            restricted: true,
-            tags: ["experimental", "advanced"]
+            scope: ConfigurationScope.APPLICATION,
+            tags: ["experimental", "advanced"],
+            policy: {
+                name: "CopilotOtelOutfile",
+                category: PolicyCategory.InteractiveSession,
+                minimumVersion: "1.127",
+                value: managedOTelOutfileValue,
+                managedSettings: {
+                    [COPILOT_OTEL_ENDPOINT_KEY]: {
+                        type: "string"
+                    },
+                    [COPILOT_OTEL_PROTOCOL_KEY]: {
+                        type: "string"
+                    }
+                },
+                localization: {
+                    description: {
+                        key: "chat.agentHost.otel.outfile.policy",
+                        value: ( localize(
+                            1912,
+                            "Prevents local file export when enterprise-managed Copilot OpenTelemetry export is configured."
+                        ))
+                    }
+                }
+            }
         },
         [AgentHostOTelDbSpanExporterEnabledSettingId]: {
             type: "boolean",
             markdownDescription: ( localize(
-                1857,
-                "When enabled, the agent host persists every emitted OTel span to a local SQLite database. Spans can be inspected via the `Export Agent Host Traces Database` command. Compatible with external exporters: spans are written to SQLite *and* forwarded to the user-configured sink."
+                1913,
+                "When enabled, the agent host persists every emitted OTel span to a local SQLite database. Configurable in user settings only. Spans can be inspected via the `Export Agent Host Traces Database` command. Compatible with external exporters: spans are written to SQLite *and* forwarded to the user-configured sink."
             )),
             default: false,
-            restricted: true,
+            scope: ConfigurationScope.APPLICATION,
             tags: ["experimental", "advanced"]
+        },
+        [AgentHostOTelServiceNameSettingId]: {
+            type: "string",
+            markdownDescription: ( localize(
+                1914,
+                "Enterprise-managed OTel `service.name` resource attribute for Copilot OpenTelemetry export. Policy-only: there is no user-facing setting; it carries the managed `telemetry.serviceName` so the agent host's `OTEL_SERVICE_NAME` identifies spans from this deployment."
+            )),
+            default: "",
+            scope: ConfigurationScope.APPLICATION,
+            included: false,
+            tags: ["experimental", "advanced"],
+            policy: {
+                name: "CopilotOtelServiceName",
+                category: PolicyCategory.InteractiveSession,
+                minimumVersion: "1.127",
+                value: managedSettingValue(COPILOT_OTEL_SERVICE_NAME_KEY),
+                managedSettings: {
+                    [COPILOT_OTEL_SERVICE_NAME_KEY]: {
+                        type: "string"
+                    }
+                },
+                localization: {
+                    description: {
+                        key: "chat.agentHost.otel.serviceName.policy",
+                        value: ( localize(
+                            1915,
+                            "Controls the enterprise-managed OTel `service.name` resource attribute for Copilot OpenTelemetry export."
+                        ))
+                    }
+                }
+            }
+        },
+        [AgentHostOTelResourceAttributesSettingId]: {
+            type: "object",
+            additionalProperties: {
+                type: ["string"]
+            },
+            default: {},
+            scope: ConfigurationScope.APPLICATION,
+            included: false,
+            tags: ["experimental", "advanced"],
+            markdownDescription: ( localize(
+                1916,
+                "Enterprise-managed OTel resource attributes for Copilot OpenTelemetry export. Policy-only: there is no user-facing setting; it carries the managed `telemetry.resourceAttributes` map so the agent host's `OTEL_RESOURCE_ATTRIBUTES` includes the deployment's attributes."
+            )),
+            policy: {
+                name: "CopilotOtelResourceAttributes",
+                category: PolicyCategory.InteractiveSession,
+                minimumVersion: "1.127",
+                value: managedSettingValue(COPILOT_OTEL_RESOURCE_ATTRIBUTES_KEY),
+                managedSettings: {
+                    [COPILOT_OTEL_RESOURCE_ATTRIBUTES_KEY]: {
+                        type: "string"
+                    }
+                },
+                localization: {
+                    description: {
+                        key: "chat.agentHost.otel.resourceAttributes.policy",
+                        value: ( localize(
+                            1917,
+                            "Controls the enterprise-managed OTel resource attributes for Copilot OpenTelemetry export."
+                        ))
+                    }
+                }
+            }
+        },
+        ["chat.agentHost.otel.headers"]: {
+            type: "object",
+            additionalProperties: {
+                type: ["string"]
+            },
+            default: {},
+            scope: ConfigurationScope.APPLICATION,
+            included: false,
+            tags: ["experimental", "advanced"],
+            markdownDescription: ( localize(
+                1918,
+                "Enterprise-managed OTLP exporter headers (e.g. auth tokens) for Copilot OpenTelemetry export. Policy-only and extension-only: applied directly to the Copilot Chat extension's OTLP exporter, never delivered to the agent host process."
+            )),
+            policy: {
+                name: "CopilotOtelHeaders",
+                category: PolicyCategory.InteractiveSession,
+                minimumVersion: "1.127",
+                value: managedSettingValue(COPILOT_OTEL_HEADERS_KEY),
+                managedSettings: {
+                    [COPILOT_OTEL_HEADERS_KEY]: {
+                        type: "string"
+                    }
+                },
+                localization: {
+                    description: {
+                        key: "chat.agentHost.otel.headers.policy",
+                        value: ( localize(
+                            1919,
+                            "Controls the enterprise-managed OTLP exporter headers for Copilot OpenTelemetry export."
+                        ))
+                    }
+                }
+            }
         }
     }
 });