{ "format": "roslyn-workbench-security-reference/v1", "trustBoundary": "The connected MCP client is authorised and belongs to the local trust boundary. These controls protect against mistakes, misfires, stale assumptions and unexpectedly broad operations; they do not defend against hostile code already exercising the same operating-system authority.", "entries": [ { "id": "authorised-client-responsibility", "title": "The client and user remain responsible for intent and review", "classification": "delegated", "actor": "Authorised MCP client and user", "outcome": "The client should use inspection before mutation, convey elicitation failures accurately, review previews or receipts and keep each transaction to a coherent change.", "boundary": "Roslyn Workbench supplies bounded tools, structured continuations and exact review data; it cannot determine the user\u0027s true intent.", "residualRisk": "A mistaken but authorised approval can persist an undesirable change that satisfies all mechanical safeguards.", "surface": [], "evidence": [] }, { "id": "coordinated-workspace-ownership", "title": "Workspace mutation requires coordinated local ownership", "classification": "delegated", "actor": "Authorised MCP client, user and other local workspace editors", "outcome": "Callers wait for recovery initialisation and avoid concurrent file edits or workspace-topology changes while non-cancellable commit application or recovery is in progress. A second Host instance sharing the same workspace remains advisory or query-only.", "boundary": "Roslyn Workbench detects many stale-input and external-change conditions, but it does not hold an operating-system lock over every workspace file or coordinate independent Host processes.", "residualRisk": "Uncoordinated local writers can invalidate assumptions during the narrow persistence boundary and can require recovery or manual reconciliation.", "surface": [], "evidence": [] }, { "id": "bounded-host-resources", "title": "Published operations expose bounded Host resource controls", "classification": "enforced", "actor": "Roslyn Workbench Host", "outcome": "Collection defaults, Code Action reference lifetime and concurrent query count are fixed by Host configuration and reported without exposing sensitive configuration.", "boundary": "These bounds apply to the corresponding Roslyn Workbench caches, references and query scheduling.", "residualRisk": "Trusted Roslyn providers and build inputs can still consume substantial resources while an allowed operation executes.", "surface": [ { "key": "status-field:codeActionReferenceLifetime", "category": "status-field", "facts": { "type": "string", "required": true, "nullable": false } }, { "key": "status-field:defaultMaxResults", "category": "status-field", "facts": { "type": "integer", "required": true, "nullable": false } }, { "key": "status-field:maxConcurrentQueries", "category": "status-field", "facts": { "type": "integer", "required": true, "nullable": false } } ], "evidence": [ { "level": "integration", "project": "test/Roslyn.Workbench.Mcp.IntegrationTest/Roslyn.Workbench.Mcp.IntegrationTest.csproj", "source": "test/Roslyn.Workbench.Mcp.IntegrationTest/HostCompositionIntegrationTests.cs", "test": "Roslyn.Workbench.Mcp.Test.HostCompositionIntegrationTests.GIVEN_CommandLineOptions_WHEN_ComposingHost_THEN_ShouldProjectDerivedOptionsIntoTheContainer" } ] }, { "id": "compiler-impact-validation", "title": "Optional compiler-impact validation fails closed", "classification": "enforced", "actor": "Roslyn Workbench transaction pipeline", "outcome": "When configured, commit is blocked by new compiler errors or incomplete compiler evaluation relative to the transaction baseline.", "boundary": "The validation covers the projects and compilations affected by the staged transaction at commit time.", "residualRisk": "It does not prove behavioural correctness, run all analysers or replace repository builds and tests.", "surface": [ { "key": "compiler-error-identity:compiler-error-identity-v1", "category": "compiler-error-identity", "facts": { "value": "compiler-error-identity-v1" } }, { "key": "error:CompilerValidationIncomplete", "category": "error", "facts": { "value": "CompilerValidationIncomplete" } }, { "key": "error:CompilerValidationUnavailable", "category": "error", "facts": { "value": "CompilerValidationUnavailable" } }, { "key": "error:NewCompilerErrors", "category": "error", "facts": { "value": "NewCompilerErrors" } } ], "evidence": [ { "level": "unit", "project": "test/Roslyn.Workbench.Mcp.Workspace.Test/Roslyn.Workbench.Mcp.Workspace.Test.csproj", "source": "test/Roslyn.Workbench.Mcp.Workspace.Test/Transactions/TransactionCommitServiceTests.cs", "test": "Roslyn.Workbench.Mcp.Workspace.Test.Transactions.TransactionCommitServiceTests.GIVEN_IncompleteCompilerValidation_WHEN_Committing_THEN_ShouldRejectBeforePersistenceWork" }, { "level": "unit", "project": "test/Roslyn.Workbench.Mcp.Workspace.Test/Roslyn.Workbench.Mcp.Workspace.Test.csproj", "source": "test/Roslyn.Workbench.Mcp.Workspace.Test/Transactions/TransactionServiceTests.cs", "test": "Roslyn.Workbench.Mcp.Workspace.Test.Transactions.TransactionServiceTests.GIVEN_NewCompilerErrors_WHEN_Reviewing_THEN_ShouldNotBuildReceipt" } ] }, { "id": "durable-recovery", "title": "Interrupted persistence retains versioned recovery evidence", "classification": "enforced", "actor": "Roslyn Workbench commit and recovery services", "outcome": "Commit persistence uses versioned durable evidence, reports unfinished states, and preserves unsupported versions rather than guessing how to recover them.", "boundary": "The guarantee covers recovery artifacts created and read by Roslyn Workbench in its configured state directory.", "residualRisk": "Operating-system or storage failure can still make evidence incomplete; status reports that condition for manual resolution.", "surface": [ { "key": "error:CommitRecoveryCapacityReached", "category": "error", "facts": { "value": "CommitRecoveryCapacityReached" } }, { "key": "recovery-format:1", "category": "recovery-format", "facts": { "value": 1 } }, { "key": "recovery-operation:create", "category": "recovery-operation", "facts": { "numericValue": 0 } }, { "key": "recovery-operation:delete", "category": "recovery-operation", "facts": { "numericValue": 2 } }, { "key": "recovery-operation:replace", "category": "recovery-operation", "facts": { "numericValue": 1 } }, { "key": "recovery-state:applying", "category": "recovery-state", "facts": { "numericValue": 1 } }, { "key": "recovery-state:committed", "category": "recovery-state", "facts": { "numericValue": 2 } }, { "key": "recovery-state:prepared", "category": "recovery-state", "facts": { "numericValue": 0 } }, { "key": "recovery-state:recovery-conflict", "category": "recovery-state", "facts": { "numericValue": 4 } }, { "key": "recovery-state:recovery-incomplete", "category": "recovery-state", "facts": { "numericValue": 5 } }, { "key": "recovery-state:restored", "category": "recovery-state", "facts": { "numericValue": 3 } }, { "key": "recovery-status:RecoveryVersionUnsupported", "category": "recovery-status", "facts": { "value": "RecoveryVersionUnsupported" } } ], "evidence": [ { "level": "unit", "project": "test/Roslyn.Workbench.Mcp.Workspace.Test/Roslyn.Workbench.Mcp.Workspace.Test.csproj", "source": "test/Roslyn.Workbench.Mcp.Workspace.Test/Recovery/CommitRecoveryStoreTests.cs", "test": "Roslyn.Workbench.Mcp.Workspace.Test.Recovery.CommitRecoveryStoreTests.GIVEN_UnsupportedManifestVersion_WHEN_ReadingStatuses_THEN_ShouldReturnActionableConflict" }, { "level": "unit", "project": "test/Roslyn.Workbench.Mcp.Workspace.Test/Roslyn.Workbench.Mcp.Workspace.Test.csproj", "source": "test/Roslyn.Workbench.Mcp.Workspace.Test/Recovery/WorkspaceCommitRecoveryServiceTests.cs", "test": "Roslyn.Workbench.Mcp.Workspace.Test.Recovery.WorkspaceCommitRecoveryServiceTests.GIVEN_ApplyingManifest_WHEN_RestorationSucceeds_THEN_ShouldPersistRestoredBeforeCleanup" }, { "level": "unit", "project": "test/Roslyn.Workbench.Mcp.Workspace.Test/Roslyn.Workbench.Mcp.Workspace.Test.csproj", "source": "test/Roslyn.Workbench.Mcp.Workspace.Test/Transactions/WorkspaceCommitWriterTests.cs", "test": "Roslyn.Workbench.Mcp.Workspace.Test.Transactions.WorkspaceCommitWriterTests.GIVEN_CreateReplaceAndDelete_WHEN_Applying_THEN_ShouldUseDurableArtifactsWithoutCancellation" } ] }, { "id": "error-reporting-consent-and-redaction", "title": "External error reporting is explicit, bounded and consent-controlled", "classification": "enforced", "actor": "Roslyn Workbench error-reporting pipeline", "outcome": "External reports use versioned bounded payloads, reviewed projection and redaction, and the configured consent policy before dispatch.", "boundary": "The guarantee covers data prepared and submitted through the built-in reporting tools and configured dispatcher.", "residualRisk": "An approved report intentionally leaves the local machine; the selected provider and operating environment govern it after dispatch.", "surface": [ { "key": "error-report-format:2", "category": "error-report-format", "facts": { "value": 2 } }, { "key": "error-report-schema:2", "category": "error-report-schema", "facts": { "value": 2 } }, { "key": "policy:error-report-consent:always", "category": "policy:error-report-consent", "facts": { "numericValue": 2 } }, { "key": "policy:error-report-consent:never", "category": "policy:error-report-consent", "facts": { "numericValue": 0 } }, { "key": "policy:error-report-consent:prompt", "category": "policy:error-report-consent", "facts": { "numericValue": 1 } }, { "key": "status-field:errorReporting", "category": "status-field", "facts": { "type": "object", "required": false, "nullable": true } } ], "evidence": [ { "level": "unit", "project": "test/Roslyn.Workbench.Mcp.Test/Roslyn.Workbench.Mcp.Test.csproj", "source": "test/Roslyn.Workbench.Mcp.Test/ErrorReporting/ExternalErrorReportProjectorTests.cs", "test": "Roslyn.Workbench.Mcp.Test.ErrorReporting.ExternalErrorReportProjectorTests.GIVEN_ExternalPluginFailureWithSensitiveLocalData_WHEN_Projecting_THEN_ShouldExcludeExternalImplementationDetails" }, { "level": "unit", "project": "test/Roslyn.Workbench.Mcp.Test/Roslyn.Workbench.Mcp.Test.csproj", "source": "test/Roslyn.Workbench.Mcp.Test/ErrorReporting/SubmitErrorReportToolTests.cs", "test": "Roslyn.Workbench.Mcp.Test.ErrorReporting.SubmitErrorReportToolTests.GIVEN_PromptRequiredWithoutElicitationCapability_WHEN_Submitting_THEN_ShouldFailClosedWithoutDispatch" } ] }, { "id": "generated-source-policy", "title": "Generated-looking source follows explicit mutation policy", "classification": "enforced", "actor": "Roslyn Workbench transaction pipeline", "outcome": "Generated-looking checked-in source produces a bounded warning or is denied according to startup policy and reviewed path exceptions.", "boundary": "Classification applies to source paths selected for supported transaction mutations.", "residualRisk": "Path and source heuristics cannot identify every generated file; maintainers remain responsible for repository-specific exceptions and review.", "surface": [ { "key": "error:GeneratedSourceMutationDenied", "category": "error", "facts": { "value": "GeneratedSourceMutationDenied" } }, { "key": "policy:generated-source:deny", "category": "policy:generated-source", "facts": { "numericValue": 1 } }, { "key": "policy:generated-source:warn", "category": "policy:generated-source", "facts": { "numericValue": 0 } }, { "key": "status-field:generatedSourceExceptionCount", "category": "status-field", "facts": { "type": "integer", "required": true, "nullable": false } }, { "key": "status-field:generatedSourcePolicy", "category": "status-field", "facts": { "type": "string", "required": true, "nullable": false } }, { "key": "warning:generated-source-mutation", "category": "warning", "facts": { "value": "GeneratedSourceMutation" } } ], "evidence": [ { "level": "unit", "project": "test/Roslyn.Workbench.Mcp.Workspace.Test/Roslyn.Workbench.Mcp.Workspace.Test.csproj", "source": "test/Roslyn.Workbench.Mcp.Workspace.Test/Transactions/TransactionServiceTests.cs", "test": "Roslyn.Workbench.Mcp.Workspace.Test.Transactions.TransactionServiceTests.GIVEN_GeneratedSourceAndDiffNotRequested_WHEN_PreviewingTransaction_THEN_ShouldReturnSummaryAndWarningWithoutResolvingDocument" }, { "level": "unit", "project": "test/Roslyn.Workbench.Mcp.Workspace.Test/Roslyn.Workbench.Mcp.Workspace.Test.csproj", "source": "test/Roslyn.Workbench.Mcp.Workspace.Test/Transactions/WorkspaceMutationCandidateProcessorTests.cs", "test": "Roslyn.Workbench.Mcp.Workspace.Test.Transactions.WorkspaceMutationCandidateProcessorTests.GIVEN_GeneratedSourceAndDenyPolicy_WHEN_Processing_THEN_ShouldRejectCandidate" } ] }, { "id": "plugin-loading-boundary", "title": "External plugin loading is explicit and mode-constrained", "classification": "enforced", "actor": "Roslyn Workbench Host", "outcome": "External plugin discovery is disabled by default and fixed at startup. Plugin mutation tools are published only when the resolved operational policy enables source mutation.", "boundary": "The Host controls discovery and publication. Once loaded, trusted plugins execute in process with Host authority.", "residualRisk": "Plugins, analysers and Code Action providers are trusted code rather than sandboxed tenants and can perform effects outside MCP tool contracts.", "surface": [ { "key": "plugin-api:1.0", "category": "plugin-api", "facts": { "value": "1.0" } }, { "key": "plugin-loading:default", "category": "plugin-loading", "facts": { "value": false } }, { "key": "plugin-publication:approval-required", "category": "plugin-publication", "facts": { "queryPublished": true, "mutationPublished": true } }, { "key": "plugin-publication:autonomous-trusted", "category": "plugin-publication", "facts": { "queryPublished": true, "mutationPublished": true } }, { "key": "plugin-publication:inspection-only", "category": "plugin-publication", "facts": { "queryPublished": true, "mutationPublished": false } }, { "key": "plugin-publication:transactional", "category": "plugin-publication", "facts": { "queryPublished": true, "mutationPublished": true } }, { "key": "status-field:externalPluginsEnabled", "category": "status-field", "facts": { "type": "boolean", "required": true, "nullable": false } } ], "evidence": [ { "level": "unit", "project": "test/Roslyn.Workbench.Mcp.Test/Roslyn.Workbench.Mcp.Test.csproj", "source": "test/Roslyn.Workbench.Mcp.Test/PluginLoading/PluginCatalogEntryMaterializerTests.cs", "test": "Roslyn.Workbench.Mcp.Test.PluginLoading.PluginCatalogEntryMaterializerTests.GIVEN_MixedToolKinds_WHEN_MaterializingEntry_THEN_ShouldCreateOnlyPermittedRuntimeTools" }, { "level": "unit", "project": "test/Roslyn.Workbench.Mcp.Test/Roslyn.Workbench.Mcp.Test.csproj", "source": "test/Roslyn.Workbench.Mcp.Test/PluginLoading/PluginCatalogLoaderTests.cs", "test": "Roslyn.Workbench.Mcp.Test.PluginLoading.PluginCatalogLoaderTests.GIVEN_ExternalPluginsDisabled_WHEN_Loading_THEN_ShouldNotDiscoverExternalPackages" } ] }, { "id": "stable-agent-facing-status-codes", "title": "Agent-facing failure, status and continuation contracts are baseline-locked", "classification": "enforced", "actor": "Roslyn Workbench Host and Workspace services", "outcome": "The generated compatibility baseline records the exact failure envelope, public error codes, status graph, enum values, required-action values and continuation mappings used by authorised clients.", "boundary": "The contract covers the shared structured failure envelope and error-code catalogue, the models reachable from server and workspace status, and the structured required-action and continuation values returned by supported operations.", "residualRisk": "The code describes the detected condition; clients must still present and follow the accompanying recovery guidance correctly.", "surface": [ { "key": "contract-enum:roslyn-workbench-mcp-contracts-server-tooloutputschemamode:full", "category": "contract-enum:roslyn-workbench-mcp-contracts-server-tooloutputschemamode", "facts": { "numericValue": 1 } }, { "key": "contract-enum:roslyn-workbench-mcp-contracts-server-tooloutputschemamode:omit", "category": "contract-enum:roslyn-workbench-mcp-contracts-server-tooloutputschemamode", "facts": { "numericValue": 0 } }, { "key": "contract-enum:roslyn-workbench-mcp-protocol-results-toolcontinuationkind:call-tool", "category": "contract-enum:roslyn-workbench-mcp-protocol-results-toolcontinuationkind", "facts": { "numericValue": 0 } }, { "key": "contract-enum:roslyn-workbench-mcp-protocol-results-toolcontinuationkind:choose-tool", "category": "contract-enum:roslyn-workbench-mcp-protocol-results-toolcontinuationkind", "facts": { "numericValue": 1 } }, { "key": "contract-enum:roslyn-workbench-mcp-protocol-results-toolcontinuationkind:resolve-externally", "category": "contract-enum:roslyn-workbench-mcp-protocol-results-toolcontinuationkind", "facts": { "numericValue": 4 } }, { "key": "contract-enum:roslyn-workbench-mcp-protocol-results-toolcontinuationkind:retry-request", "category": "contract-enum:roslyn-workbench-mcp-protocol-results-toolcontinuationkind", "facts": { "numericValue": 2 } }, { "key": "contract-enum:roslyn-workbench-mcp-protocol-results-toolcontinuationkind:revise-request", "category": "contract-enum:roslyn-workbench-mcp-protocol-results-toolcontinuationkind", "facts": { "numericValue": 3 } }, { "key": "contract-enum:roslyn-workbench-mcp-workspace-results-diagnosticseverity:error", "category": "contract-enum:roslyn-workbench-mcp-workspace-results-diagnosticseverity", "facts": { "numericValue": 3 } }, { "key": "contract-enum:roslyn-workbench-mcp-workspace-results-diagnosticseverity:hidden", "category": "contract-enum:roslyn-workbench-mcp-workspace-results-diagnosticseverity", "facts": { "numericValue": 0 } }, { "key": "contract-enum:roslyn-workbench-mcp-workspace-results-diagnosticseverity:info", "category": "contract-enum:roslyn-workbench-mcp-workspace-results-diagnosticseverity", "facts": { "numericValue": 1 } }, { "key": "contract-enum:roslyn-workbench-mcp-workspace-results-diagnosticseverity:warning", "category": "contract-enum:roslyn-workbench-mcp-workspace-results-diagnosticseverity", "facts": { "numericValue": 2 } }, { "key": "contract-enum:roslyn-workbench-mcp-workspace-results-recoverystate:applying", "category": "contract-enum:roslyn-workbench-mcp-workspace-results-recoverystate", "facts": { "numericValue": 1 } }, { "key": "contract-enum:roslyn-workbench-mcp-workspace-results-recoverystate:committed", "category": "contract-enum:roslyn-workbench-mcp-workspace-results-recoverystate", "facts": { "numericValue": 2 } }, { "key": "contract-enum:roslyn-workbench-mcp-workspace-results-recoverystate:prepared", "category": "contract-enum:roslyn-workbench-mcp-workspace-results-recoverystate", "facts": { "numericValue": 0 } }, { "key": "contract-enum:roslyn-workbench-mcp-workspace-results-recoverystate:recovery-conflict", "category": "contract-enum:roslyn-workbench-mcp-workspace-results-recoverystate", "facts": { "numericValue": 4 } }, { "key": "contract-enum:roslyn-workbench-mcp-workspace-results-recoverystate:recovery-incomplete", "category": "contract-enum:roslyn-workbench-mcp-workspace-results-recoverystate", "facts": { "numericValue": 5 } }, { "key": "contract-enum:roslyn-workbench-mcp-workspace-results-recoverystate:restored", "category": "contract-enum:roslyn-workbench-mcp-workspace-results-recoverystate", "facts": { "numericValue": 3 } }, { "key": "contract-enum:roslyn-workbench-mcp-workspace-results-workspacelifecyclestate:ready", "category": "contract-enum:roslyn-workbench-mcp-workspace-results-workspacelifecyclestate", "facts": { "numericValue": 0 } }, { "key": "contract-enum:roslyn-workbench-mcp-workspace-results-workspacelifecyclestate:transaction-active", "category": "contract-enum:roslyn-workbench-mcp-workspace-results-workspacelifecyclestate", "facts": { "numericValue": 1 } }, { "key": "contract-enum:roslyn-workbench-mcp-workspace-results-workspacelifecyclestate:transaction-conflicted", "category": "contract-enum:roslyn-workbench-mcp-workspace-results-workspacelifecyclestate", "facts": { "numericValue": 2 } }, { "key": "contract-enum:roslyn-workbench-mcp-workspace-results-workspacelifecyclestate:workspace-out-of-date", "category": "contract-enum:roslyn-workbench-mcp-workspace-results-workspacelifecyclestate", "facts": { "numericValue": 3 } }, { "key": "contract-shape:roslyn-workbench-mcp-contracts-server-componentstatus", "category": "contract-shape", "facts": { "properties": { "isAvailable": { "type": "System.Boolean", "required": true, "nullable": false, "omittedWhenNull": false }, "message": { "type": "System.String", "required": false, "nullable": true, "omittedWhenNull": false }, "version": { "type": "System.String", "required": false, "nullable": true, "omittedWhenNull": false } } } }, { "key": "contract-shape:roslyn-workbench-mcp-contracts-server-pluginstatus", "category": "contract-shape", "facts": { "properties": { "diagnostics": { "type": "array\u003CRoslyn.Workbench.Mcp.Workspace.Results.DiagnosticInfo\u003E", "required": false, "nullable": false, "omittedWhenNull": false }, "displayName": { "type": "System.String", "required": false, "nullable": true, "omittedWhenNull": false }, "enabled": { "type": "System.Boolean", "required": true, "nullable": false, "omittedWhenNull": false }, "pluginId": { "type": "System.String", "required": false, "nullable": true, "omittedWhenNull": false }, "supportedApiVersion": { "type": "System.String", "required": false, "nullable": true, "omittedWhenNull": false }, "version": { "type": "System.String", "required": false, "nullable": true, "omittedWhenNull": false } } } }, { "key": "contract-shape:roslyn-workbench-mcp-contracts-server-serverconfiguration", "category": "contract-shape", "facts": { "properties": { "allowedWorkspaceRootCount": { "type": "System.Int32", "required": true, "nullable": false, "omittedWhenNull": false }, "clientSupportsElicitation": { "type": "nullable\u003CSystem.Boolean\u003E", "required": false, "nullable": true, "omittedWhenNull": false }, "codeActionReferenceLifetime": { "type": "System.TimeSpan", "required": true, "nullable": false, "omittedWhenNull": false }, "commitConfirmationRequired": { "type": "System.Boolean", "required": true, "nullable": false, "omittedWhenNull": false }, "commitConfirmationState": { "type": "System.String", "required": true, "nullable": false, "omittedWhenNull": false }, "compilerValidationRequired": { "type": "System.Boolean", "required": true, "nullable": false, "omittedWhenNull": false }, "defaultMaxResults": { "type": "System.Int32", "required": true, "nullable": false, "omittedWhenNull": false }, "errorReporting": { "type": "Roslyn.Workbench.Mcp.ErrorReporting.Contracts.ErrorReportingStatusData", "required": false, "nullable": true, "omittedWhenNull": false }, "externalDocumentPolicy": { "type": "System.String", "required": true, "nullable": false, "omittedWhenNull": false }, "externalPluginsEnabled": { "type": "System.Boolean", "required": true, "nullable": false, "omittedWhenNull": false }, "generatedSourceExceptionCount": { "type": "System.Int32", "required": true, "nullable": false, "omittedWhenNull": false }, "generatedSourcePolicy": { "type": "System.String", "required": true, "nullable": false, "omittedWhenNull": false }, "maxConcurrentQueries": { "type": "System.Int32", "required": true, "nullable": false, "omittedWhenNull": false }, "maxTransactionRevisions": { "type": "System.Int32", "required": true, "nullable": false, "omittedWhenNull": false }, "operationalMode": { "type": "System.String", "required": true, "nullable": false, "omittedWhenNull": false }, "receiptApprovalRequired": { "type": "System.Boolean", "required": true, "nullable": false, "omittedWhenNull": false }, "sourceMutationEnabled": { "type": "System.Boolean", "required": true, "nullable": false, "omittedWhenNull": false }, "toolOutputSchemaMode": { "type": "Roslyn.Workbench.Mcp.Contracts.Server.ToolOutputSchemaMode", "required": true, "nullable": false, "omittedWhenNull": false }, "workspaceAdmission": { "type": "System.String", "required": true, "nullable": false, "omittedWhenNull": false } } } }, { "key": "contract-shape:roslyn-workbench-mcp-contracts-server-serverstatusdata", "category": "contract-shape", "facts": { "properties": { "codeActions": { "type": "Roslyn.Workbench.Mcp.Contracts.Server.ComponentStatus", "required": false, "nullable": true, "omittedWhenNull": false }, "configuration": { "type": "Roslyn.Workbench.Mcp.Contracts.Server.ServerConfiguration", "required": false, "nullable": true, "omittedWhenNull": true }, "msBuild": { "type": "Roslyn.Workbench.Mcp.Contracts.Server.ComponentStatus", "required": false, "nullable": true, "omittedWhenNull": false }, "plugins": { "type": "array\u003CRoslyn.Workbench.Mcp.Contracts.Server.PluginStatus\u003E", "required": false, "nullable": true, "omittedWhenNull": true }, "recovery": { "type": "array\u003CRoslyn.Workbench.Mcp.Workspace.Results.RecoveryStatus\u003E", "required": false, "nullable": true, "omittedWhenNull": true }, "roslynVersion": { "type": "System.String", "required": false, "nullable": true, "omittedWhenNull": false }, "serverVersion": { "type": "System.String", "required": false, "nullable": true, "omittedWhenNull": false }, "startupWarnings": { "type": "array\u003CRoslyn.Workbench.Mcp.Workspace.Results.WarningInfo\u003E", "required": false, "nullable": true, "omittedWhenNull": true }, "toolCount": { "type": "System.Int32", "required": true, "nullable": false, "omittedWhenNull": false } } } }, { "key": "contract-shape:roslyn-workbench-mcp-contracts-server-workspaceexternalchangedata", "category": "contract-shape", "facts": { "properties": { "detectionSource": { "type": "System.String", "required": true, "nullable": false, "omittedWhenNull": false }, "errorCode": { "type": "System.String", "required": false, "nullable": true, "omittedWhenNull": true }, "kind": { "type": "System.String", "required": true, "nullable": false, "omittedWhenNull": false }, "path": { "type": "System.String", "required": false, "nullable": true, "omittedWhenNull": true }, "previousPath": { "type": "System.String", "required": false, "nullable": true, "omittedWhenNull": true } } } }, { "key": "contract-shape:roslyn-workbench-mcp-contracts-server-workspacestatusdata", "category": "contract-shape", "facts": { "properties": { "documentCount": { "type": "nullable\u003CSystem.Int32\u003E", "required": false, "nullable": true, "omittedWhenNull": false }, "errorReportingConsent": { "type": "System.String", "required": false, "nullable": true, "omittedWhenNull": true }, "externalChange": { "type": "Roslyn.Workbench.Mcp.Contracts.Server.WorkspaceExternalChangeData", "required": false, "nullable": true, "omittedWhenNull": true }, "instances": { "type": "array\u003CRoslyn.Workbench.Mcp.Workspace.Results.WorkspaceInstanceInfo\u003E", "required": false, "nullable": false, "omittedWhenNull": false }, "loadDiagnostics": { "type": "array\u003CRoslyn.Workbench.Mcp.Workspace.Results.DiagnosticInfo\u003E", "required": false, "nullable": true, "omittedWhenNull": true }, "projectCount": { "type": "nullable\u003CSystem.Int32\u003E", "required": false, "nullable": true, "omittedWhenNull": false }, "reloadRequired": { "type": "System.Boolean", "required": true, "nullable": false, "omittedWhenNull": false }, "state": { "type": "Roslyn.Workbench.Mcp.Workspace.Results.WorkspaceLifecycleState", "required": true, "nullable": false, "omittedWhenNull": false }, "transaction": { "type": "Roslyn.Workbench.Mcp.Workspace.Results.TransactionInfo", "required": false, "nullable": true, "omittedWhenNull": false }, "workspace": { "type": "Roslyn.Workbench.Mcp.Workspace.Results.WorkspaceIdentity", "required": false, "nullable": true, "omittedWhenNull": false } } } }, { "key": "contract-shape:roslyn-workbench-mcp-errorreporting-contracts-errorreportingstatusdata", "category": "contract-shape", "facts": { "properties": { "consentMode": { "type": "System.String", "required": true, "nullable": false, "omittedWhenNull": false }, "consentState": { "type": "System.String", "required": true, "nullable": false, "omittedWhenNull": false }, "provider": { "type": "System.String", "required": true, "nullable": false, "omittedWhenNull": false } } } }, { "key": "contract-shape:roslyn-workbench-mcp-protocol-results-toolcontinuation", "category": "contract-shape", "facts": { "properties": { "instruction": { "type": "System.String", "required": false, "nullable": false, "omittedWhenNull": false }, "kind": { "type": "Roslyn.Workbench.Mcp.Protocol.Results.ToolContinuationKind", "required": true, "nullable": false, "omittedWhenNull": false }, "tool": { "type": "System.String", "required": false, "nullable": false, "omittedWhenNull": true }, "tools": { "type": "array\u003CSystem.String\u003E", "required": false, "nullable": false, "omittedWhenNull": true } } } }, { "key": "contract-shape:roslyn-workbench-mcp-protocol-results-toolerror", "category": "contract-shape", "facts": { "properties": { "code": { "type": "System.String", "required": true, "nullable": false, "omittedWhenNull": false }, "correlationId": { "type": "System.String", "required": false, "nullable": true, "omittedWhenNull": true }, "message": { "type": "System.String", "required": true, "nullable": false, "omittedWhenNull": false } } } }, { "key": "contract-shape:roslyn-workbench-mcp-workspace-results-diagnosticinfo", "category": "contract-shape", "facts": { "properties": { "id": { "type": "System.String", "required": true, "nullable": false, "omittedWhenNull": false }, "location": { "type": "Roslyn.Workbench.Mcp.Workspace.Selectors.ResolvedLocation", "required": false, "nullable": true, "omittedWhenNull": false }, "message": { "type": "System.String", "required": true, "nullable": false, "omittedWhenNull": false }, "severity": { "type": "Roslyn.Workbench.Mcp.Workspace.Results.DiagnosticSeverity", "required": true, "nullable": false, "omittedWhenNull": false } } } }, { "key": "contract-shape:roslyn-workbench-mcp-workspace-results-recoverystatus", "category": "contract-shape", "facts": { "properties": { "code": { "type": "System.String", "required": false, "nullable": true, "omittedWhenNull": false }, "commitId": { "type": "System.String", "required": true, "nullable": false, "omittedWhenNull": false }, "message": { "type": "System.String", "required": false, "nullable": true, "omittedWhenNull": false }, "solutionPath": { "type": "System.String", "required": false, "nullable": false, "omittedWhenNull": false }, "state": { "type": "Roslyn.Workbench.Mcp.Workspace.Results.RecoveryState", "required": true, "nullable": false, "omittedWhenNull": false } } } }, { "key": "contract-shape:roslyn-workbench-mcp-workspace-results-transactioninfo", "category": "contract-shape", "facts": { "properties": { "canCommit": { "type": "System.Boolean", "required": true, "nullable": false, "omittedWhenNull": false }, "canMutate": { "type": "System.Boolean", "required": true, "nullable": false, "omittedWhenNull": false }, "canRedo": { "type": "System.Boolean", "required": true, "nullable": false, "omittedWhenNull": false }, "canRollback": { "type": "System.Boolean", "required": true, "nullable": false, "omittedWhenNull": false }, "canUndo": { "type": "System.Boolean", "required": true, "nullable": false, "omittedWhenNull": false }, "maxRevisions": { "type": "System.Int32", "required": true, "nullable": false, "omittedWhenNull": false }, "remainingRevisions": { "type": "System.Int32", "required": true, "nullable": false, "omittedWhenNull": false }, "revision": { "type": "System.Int32", "required": true, "nullable": false, "omittedWhenNull": false }, "revisionCount": { "type": "System.Int32", "required": true, "nullable": false, "omittedWhenNull": false } } } }, { "key": "contract-shape:roslyn-workbench-mcp-workspace-results-warninginfo", "category": "contract-shape", "facts": { "properties": { "code": { "type": "System.String", "required": true, "nullable": false, "omittedWhenNull": false }, "message": { "type": "System.String", "required": true, "nullable": false, "omittedWhenNull": false } } } }, { "key": "contract-shape:roslyn-workbench-mcp-workspace-results-workspaceidentity", "category": "contract-shape", "facts": { "properties": { "alias": { "type": "System.String", "required": false, "nullable": true, "omittedWhenNull": false }, "loadedPath": { "type": "System.String", "required": true, "nullable": false, "omittedWhenNull": false }, "workspaceEpoch": { "type": "System.Int64", "required": true, "nullable": false, "omittedWhenNull": false }, "workspaceId": { "type": "System.Guid", "required": true, "nullable": false, "omittedWhenNull": false }, "workspaceRoot": { "type": "System.String", "required": true, "nullable": false, "omittedWhenNull": false } } } }, { "key": "contract-shape:roslyn-workbench-mcp-workspace-results-workspaceinstanceinfo", "category": "contract-shape", "facts": { "properties": { "commitId": { "type": "System.String", "required": false, "nullable": true, "omittedWhenNull": false }, "commitPhase": { "type": "System.String", "required": false, "nullable": true, "omittedWhenNull": false }, "instanceId": { "type": "System.String", "required": true, "nullable": false, "omittedWhenNull": false }, "loadedPath": { "type": "System.String", "required": true, "nullable": false, "omittedWhenNull": false }, "transactionRevision": { "type": "nullable\u003CSystem.Int64\u003E", "required": false, "nullable": true, "omittedWhenNull": false }, "workspaceRoot": { "type": "System.String", "required": true, "nullable": false, "omittedWhenNull": false }, "workspaceState": { "type": "Roslyn.Workbench.Mcp.Workspace.Results.WorkspaceLifecycleState", "required": true, "nullable": false, "omittedWhenNull": false } } } }, { "key": "contract-shape:roslyn-workbench-mcp-workspace-selectors-canonicallocationselector", "category": "contract-shape", "facts": { "properties": { "span": { "type": "Roslyn.Workbench.Mcp.Workspace.Selectors.TextSpanSelector", "required": true, "nullable": false, "omittedWhenNull": false } } } }, { "key": "contract-shape:roslyn-workbench-mcp-workspace-selectors-documentreference", "category": "contract-shape", "facts": { "properties": { "documentId": { "type": "System.String", "required": true, "nullable": false, "omittedWhenNull": false }, "path": { "type": "System.String", "required": true, "nullable": false, "omittedWhenNull": false }, "projectId": { "type": "System.String", "required": true, "nullable": false, "omittedWhenNull": false } } } }, { "key": "contract-shape:roslyn-workbench-mcp-workspace-selectors-documentselector", "category": "contract-shape", "facts": { "properties": { "documentId": { "type": "System.String", "required": false, "nullable": true, "omittedWhenNull": false }, "path": { "type": "System.String", "required": false, "nullable": true, "omittedWhenNull": false }, "project": { "type": "Roslyn.Workbench.Mcp.Workspace.Selectors.ProjectSelector", "required": false, "nullable": true, "omittedWhenNull": false } } } }, { "key": "contract-shape:roslyn-workbench-mcp-workspace-selectors-projectselector", "category": "contract-shape", "facts": { "properties": { "name": { "type": "System.String", "required": false, "nullable": true, "omittedWhenNull": false }, "path": { "type": "System.String", "required": false, "nullable": true, "omittedWhenNull": false }, "projectId": { "type": "System.String", "required": false, "nullable": true, "omittedWhenNull": false }, "targetFramework": { "type": "System.String", "required": false, "nullable": true, "omittedWhenNull": false } } } }, { "key": "contract-shape:roslyn-workbench-mcp-workspace-selectors-resolvedlocation", "category": "contract-shape", "facts": { "properties": { "column": { "type": "System.Int32", "required": true, "nullable": false, "omittedWhenNull": false }, "document": { "type": "Roslyn.Workbench.Mcp.Workspace.Selectors.DocumentReference", "required": false, "nullable": true, "omittedWhenNull": false }, "line": { "type": "System.Int32", "required": true, "nullable": false, "omittedWhenNull": false }, "selector": { "type": "Roslyn.Workbench.Mcp.Workspace.Selectors.CanonicalLocationSelector", "required": false, "nullable": true, "omittedWhenNull": false }, "snapshot": { "type": "Roslyn.Workbench.Mcp.Workspace.Selectors.SnapshotPrecondition", "required": true, "nullable": false, "omittedWhenNull": false }, "span": { "type": "Roslyn.Workbench.Mcp.Workspace.Selectors.TextSpanRange", "required": false, "nullable": true, "omittedWhenNull": false } } } }, { "key": "contract-shape:roslyn-workbench-mcp-workspace-selectors-snapshotprecondition", "category": "contract-shape", "facts": { "properties": { "snapshotId": { "type": "System.Guid", "required": true, "nullable": false, "omittedWhenNull": false }, "transactionRevision": { "type": "nullable\u003CSystem.Int32\u003E", "required": true, "nullable": true, "omittedWhenNull": false }, "workspaceEpoch": { "type": "System.Int64", "required": true, "nullable": false, "omittedWhenNull": false }, "workspaceId": { "type": "System.Guid", "required": true, "nullable": false, "omittedWhenNull": false } } } }, { "key": "contract-shape:roslyn-workbench-mcp-workspace-selectors-textspanrange", "category": "contract-shape", "facts": { "properties": { "length": { "type": "System.Int32", "required": true, "nullable": false, "omittedWhenNull": false }, "start": { "type": "System.Int32", "required": true, "nullable": false, "omittedWhenNull": false } } } }, { "key": "contract-shape:roslyn-workbench-mcp-workspace-selectors-textspanselector", "category": "contract-shape", "facts": { "properties": { "document": { "type": "Roslyn.Workbench.Mcp.Workspace.Selectors.DocumentSelector", "required": true, "nullable": false, "omittedWhenNull": false }, "range": { "type": "Roslyn.Workbench.Mcp.Workspace.Selectors.TextSpanRange", "required": true, "nullable": false, "omittedWhenNull": false } } } }, { "key": "error:ActionAmbiguous", "category": "error", "facts": { "value": "ActionAmbiguous" } }, { "key": "error:ActionExpired", "category": "error", "facts": { "value": "ActionExpired" } }, { "key": "error:ActionReferenceCapacityExceeded", "category": "error", "facts": { "value": "ActionReferenceCapacityExceeded" } }, { "key": "error:ActionUnavailable", "category": "error", "facts": { "value": "ActionUnavailable" } }, { "key": "error:AnalysisLimitExceeded", "category": "error", "facts": { "value": "AnalysisLimitExceeded" } }, { "key": "error:ApprovalUnavailable", "category": "error", "facts": { "value": "ApprovalUnavailable" } }, { "key": "error:CodeActionDocumentPathUnavailable", "category": "error", "facts": { "value": "CodeActionDocumentPathUnavailable" } }, { "key": "error:CodeActionLocationUnavailable", "category": "error", "facts": { "value": "CodeActionLocationUnavailable" } }, { "key": "error:CodeActionProjectionFailed", "category": "error", "facts": { "value": "CodeActionProjectionFailed" } }, { "key": "error:CodeActionsUnavailable", "category": "error", "facts": { "value": "CodeActionsUnavailable" } }, { "key": "error:CodeFixUnavailable", "category": "error", "facts": { "value": "CodeFixUnavailable" } }, { "key": "error:CommitFailed", "category": "error", "facts": { "value": "CommitFailed" } }, { "key": "error:CommitLockFailed", "category": "error", "facts": { "value": "CommitLockFailed" } }, { "key": "error:CommitPreparationFailed", "category": "error", "facts": { "value": "CommitPreparationFailed" } }, { "key": "error:DocumentSelectorInvalid", "category": "error", "facts": { "value": "DocumentSelectorInvalid" } }, { "key": "error:ErrorDetailsUnavailable", "category": "error", "facts": { "value": "ErrorDetailsUnavailable" } }, { "key": "error:ErrorReportCapacityReached", "category": "error", "facts": { "value": "ErrorReportCapacityReached" } }, { "key": "error:ErrorReportNotApproved", "category": "error", "facts": { "value": "ErrorReportNotApproved" } }, { "key": "error:ErrorReportPayloadTooLarge", "category": "error", "facts": { "value": "ErrorReportPayloadTooLarge" } }, { "key": "error:ErrorReportSubmissionInProgress", "category": "error", "facts": { "value": "ErrorReportSubmissionInProgress" } }, { "key": "error:ErrorReportingUnavailable", "category": "error", "facts": { "value": "ErrorReportingUnavailable" } }, { "key": "error:FixAllLimitExceeded", "category": "error", "facts": { "value": "FixAllLimitExceeded" } }, { "key": "error:FixAllUnavailable", "category": "error", "facts": { "value": "FixAllUnavailable" } }, { "key": "error:InvalidApprovalResponse", "category": "error", "facts": { "value": "InvalidApprovalResponse" } }, { "key": "error:InvalidExceptionMessageHandling", "category": "error", "facts": { "value": "InvalidExceptionMessageHandling" } }, { "key": "error:InvalidMutationProposal", "category": "error", "facts": { "value": "InvalidMutationProposal" } }, { "key": "error:InvalidPreparedErrorReport", "category": "error", "facts": { "value": "InvalidPreparedErrorReport" } }, { "key": "error:InvalidRange", "category": "error", "facts": { "value": "InvalidRange" } }, { "key": "error:LocationAmbiguous", "category": "error", "facts": { "value": "LocationAmbiguous" } }, { "key": "error:LocationNotFound", "category": "error", "facts": { "value": "LocationNotFound" } }, { "key": "error:LocationSelectorInvalid", "category": "error", "facts": { "value": "LocationSelectorInvalid" } }, { "key": "error:PreparedReportUnavailable", "category": "error", "facts": { "value": "PreparedReportUnavailable" } }, { "key": "error:ProjectAmbiguous", "category": "error", "facts": { "value": "ProjectAmbiguous" } }, { "key": "error:ProjectNotFound", "category": "error", "facts": { "value": "ProjectNotFound" } }, { "key": "error:ProjectSelectorInvalid", "category": "error", "facts": { "value": "ProjectSelectorInvalid" } }, { "key": "error:ProjectStructureUnavailable", "category": "error", "facts": { "value": "ProjectStructureUnavailable" } }, { "key": "error:RecoveryOutsideWorkspaceAuthority", "category": "error", "facts": { "value": "RecoveryOutsideWorkspaceAuthority" } }, { "key": "error:RecoveryPending", "category": "error", "facts": { "value": "RecoveryPending" } }, { "key": "error:SentryCaptureRejected", "category": "error", "facts": { "value": "SentryCaptureRejected" } }, { "key": "error:SymbolAmbiguous", "category": "error", "facts": { "value": "SymbolAmbiguous" } }, { "key": "error:SymbolNotFound", "category": "error", "facts": { "value": "SymbolNotFound" } }, { "key": "error:SymbolSelectorInvalid", "category": "error", "facts": { "value": "SymbolSelectorInvalid" } }, { "key": "error:TransactionCommitNotApproved", "category": "error", "facts": { "value": "TransactionCommitNotApproved" } }, { "key": "error:TransactionOpen", "category": "error", "facts": { "value": "TransactionOpen" } }, { "key": "error:TransactionOwnershipChanged", "category": "error", "facts": { "value": "TransactionOwnershipChanged" } }, { "key": "error:TransactionReceiptUnavailable", "category": "error", "facts": { "value": "TransactionReceiptUnavailable" } }, { "key": "error:UnhandledException", "category": "error", "facts": { "value": "UnhandledException" } }, { "key": "error:UnsupportedActionOperation", "category": "error", "facts": { "value": "UnsupportedActionOperation" } }, { "key": "error:UnsupportedChange", "category": "error", "facts": { "value": "UnsupportedChange" } }, { "key": "error:WorkspaceMsBuildPropertiesInvalid", "category": "error", "facts": { "value": "WorkspaceMsBuildPropertiesInvalid" } }, { "key": "error:WorkspacePathInvalid", "category": "error", "facts": { "value": "WorkspacePathInvalid" } }, { "key": "error:WorkspacePathNotAllowed", "category": "error", "facts": { "value": "WorkspacePathNotAllowed" } }, { "key": "error:WorkspaceReloadBlocked", "category": "error", "facts": { "value": "WorkspaceReloadBlocked" } }, { "key": "error:WorkspaceReloadNotRequired", "category": "error", "facts": { "value": "WorkspaceReloadNotRequired" } }, { "key": "error:WorkspaceRootInvalid", "category": "error", "facts": { "value": "WorkspaceRootInvalid" } }, { "key": "error:WorkspaceRootNotAllowed", "category": "error", "facts": { "value": "WorkspaceRootNotAllowed" } }, { "key": "error:WorkspaceSelectorInvalid", "category": "error", "facts": { "value": "WorkspaceSelectorInvalid" } }, { "key": "error:WorkspaceSelectorMismatch", "category": "error", "facts": { "value": "WorkspaceSelectorMismatch" } }, { "key": "error:WorkspaceSelectorNotFound", "category": "error", "facts": { "value": "WorkspaceSelectorNotFound" } }, { "key": "error:WorkspaceSelectorRequired", "category": "error", "facts": { "value": "WorkspaceSelectorRequired" } }, { "key": "failure-envelope:standard", "category": "failure-envelope", "facts": { "schema": { "variants": [ { "type": "object", "required": [ "ok", "error" ], "properties": { "ok": { "const": false, "description": "Whether the tool invocation succeeded." }, "error": { "type": "object", "properties": { "code": { "description": "Stable machine-readable error code.", "type": "string" }, "message": { "description": "Human-readable explanation of the failure.", "type": "string" }, "correlationId": { "description": "Correlation identifier for matching the failure to server-side diagnostics, when available.", "type": [ "string", "null" ] } }, "required": [ "code", "message" ], "description": "Structured error details when the invocation failed." }, "continuation": { "oneOf": [ { "type": "object", "additionalProperties": false, "required": [ "kind", "tool", "instruction" ], "properties": { "kind": { "const": "CallTool", "description": "Action required before the original request can continue." }, "instruction": { "type": "string", "description": "Agent-facing instruction explaining how to continue.", "minLength": 1 }, "tool": { "type": "string", "description": "Tool to call before continuing the original request.", "minLength": 1 } } }, { "type": "object", "additionalProperties": false, "required": [ "kind", "tools", "instruction" ], "properties": { "kind": { "const": "ChooseTool", "description": "Action required before the original request can continue." }, "instruction": { "type": "string", "description": "Agent-facing instruction explaining how to continue.", "minLength": 1 }, "tools": { "type": "array", "description": "Allowed tool choices from which the agent must select one.", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "description": "Name of a tool the agent may choose.", "minLength": 1 } } } }, { "type": "object", "additionalProperties": false, "required": [ "kind", "instruction" ], "properties": { "kind": { "const": "RetryRequest", "description": "Action required before the original request can continue." }, "instruction": { "type": "string", "description": "Agent-facing instruction explaining how to continue.", "minLength": 1 } } }, { "type": "object", "additionalProperties": false, "required": [ "kind", "instruction" ], "properties": { "kind": { "const": "ReviseRequest", "description": "Action required before the original request can continue." }, "instruction": { "type": "string", "description": "Agent-facing instruction explaining how to continue.", "minLength": 1 } } }, { "type": "object", "additionalProperties": false, "required": [ "kind", "instruction" ], "properties": { "kind": { "const": "ResolveExternally", "description": "Action required before the original request can continue." }, "instruction": { "type": "string", "description": "Agent-facing instruction explaining how to continue.", "minLength": 1 } } } ], "description": "Action the agent should take before retrying or continuing." }, "diagnostics": { "type": "array", "items": { "type": "object", "properties": { "id": { "description": "The diagnostic identifier.", "type": "string" }, "severity": { "description": "The diagnostic severity.", "type": "string", "enum": [ "Hidden", "Info", "Warning", "Error" ] }, "message": { "description": "The diagnostic message.", "type": "string" }, "location": { "description": "The optional source location of the diagnostic.", "type": [ "object", "null" ], "properties": { "document": { "description": "The resolved document.", "type": [ "object", "null" ], "properties": { "documentId": { "description": "The document identifier.", "type": "string" }, "path": { "description": "The normalized document path.", "type": "string" }, "projectId": { "description": "The owning project identifier.", "type": "string" } }, "required": [ "documentId", "path", "projectId" ] }, "span": { "description": "The resolved text span.", "type": [ "object", "null" ], "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } }, "line": { "description": "The one-based line number.", "type": "integer" }, "column": { "description": "The one-based column number.", "type": "integer" }, "snapshot": { "description": "The exact immutable workspace snapshot associated with this location.", "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ] }, "selector": { "description": "The canonical selector that can resolve this source location again.", "type": [ "object", "null" ], "properties": { "span": { "type": "object", "properties": { "document": { "description": "Provide exactly one of path or documentId.", "type": "object", "properties": { "project": { "description": "Disambiguates documents with matching paths or IDs.", "type": [ "object", "null" ], "properties": { "projectId": { "type": [ "string", "null" ] }, "name": { "type": [ "string", "null" ] }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "targetFramework": { "type": [ "string", "null" ] } } }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "documentId": { "description": "Workspace-local document ID.", "type": [ "string", "null" ] } } }, "range": { "description": "Zero-based UTF-16 range.", "type": "object", "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } } }, "required": [ "document", "range" ] } }, "required": [ "span" ] } }, "required": [ "snapshot" ] } }, "required": [ "id", "message" ] }, "description": "Diagnostics that explain the failed invocation." }, "warnings": { "type": "array", "description": "Non-fatal warnings the agent should consider.", "items": { "$ref": "#/$defs/warningInfo" } } } }, { "type": "object", "required": [ "ok", "error", "diagnostics" ], "properties": { "ok": { "const": false, "description": "Whether the tool invocation succeeded." }, "error": { "type": "object", "required": [ "code", "message", "correlationId" ], "properties": { "code": { "const": "UnhandledException" }, "message": { "const": "Tool execution failed." }, "correlationId": { "type": "string", "format": "uuid" } }, "description": "Structured error details when the invocation failed." }, "diagnostics": { "type": "object", "required": [ "detailsAvailable", "detailsTool" ], "properties": { "detailsAvailable": { "const": true }, "detailsTool": { "const": "get-error-details" } }, "description": "Diagnostics that explain the failed invocation." }, "reporting": { "type": "object", "properties": { "state": { "type": "string", "enum": [ "Available", "AlwaysApproved", "DisabledByConfiguration", "ApprovalUnavailable" ] }, "canPrepare": { "type": "boolean" }, "prepareTool": { "type": [ "string", "null" ] } }, "required": [ "state" ], "description": "Error-reporting workflow available for an unhandled failure." } } } ], "definitions": { "warningInfo": { "type": "object", "properties": { "code": { "description": "The stable machine-readable warning code.", "type": "string" }, "message": { "description": "The human-readable warning message.", "type": "string" } }, "required": [ "code", "message" ] } } }, "runtimeEnvelopes": { "handled": { "ok": false, "error": { "code": "InvalidRequest", "message": "Failure message", "correlationId": "00000000-0000-0000-0000-000000000001" }, "continuation": { "kind": "RetryRequest", "instruction": "Retry the same request." }, "diagnostics": [ { "id": "DiagnosticId", "severity": "Error", "message": "Diagnostic message", "location": null } ], "warnings": [ { "code": "WarningCode", "message": "Warning message" } ] }, "unhandled": { "ok": false, "error": { "code": "UnhandledException", "message": "Tool execution failed.", "correlationId": "00000000-0000-0000-0000-000000000002" }, "diagnostics": { "detailsAvailable": true, "detailsTool": "get-error-details" }, "reporting": { "state": "Available", "canPrepare": true, "prepareTool": "prepare-error-report" } } } } }, { "key": "required-action:commit-or-rollback", "category": "required-action", "facts": { "numericValue": 5, "continuationKind": "choose-tool", "tool": null, "tools": [ "transaction-commit", "transaction-rollback" ] } }, { "key": "required-action:narrow-request", "category": "required-action", "facts": { "numericValue": 9, "continuationKind": "revise-request", "tool": null, "tools": null } }, { "key": "required-action:open-workspace", "category": "required-action", "facts": { "numericValue": 0, "continuationKind": "call-tool", "tool": "workspace-open", "tools": null } }, { "key": "required-action:reduce-transaction-history", "category": "required-action", "facts": { "numericValue": 6, "continuationKind": "call-tool", "tool": "transaction-history", "tools": null } }, { "key": "required-action:reload-workspace", "category": "required-action", "facts": { "numericValue": 3, "continuationKind": "call-tool", "tool": "workspace-reload", "tools": null } }, { "key": "required-action:resolve-recovery", "category": "required-action", "facts": { "numericValue": 8, "continuationKind": "resolve-externally", "tool": null, "tools": null } }, { "key": "required-action:resolve-target-again", "category": "required-action", "facts": { "numericValue": 4, "continuationKind": "revise-request", "tool": null, "tools": null } }, { "key": "required-action:retry", "category": "required-action", "facts": { "numericValue": 7, "continuationKind": "retry-request", "tool": null, "tools": null } }, { "key": "required-action:review-transaction", "category": "required-action", "facts": { "numericValue": 10, "continuationKind": "call-tool", "tool": "transaction-review", "tools": null } }, { "key": "required-action:rollback-transaction", "category": "required-action", "facts": { "numericValue": 2, "continuationKind": "call-tool", "tool": "transaction-rollback", "tools": null } }, { "key": "required-action:start-transaction", "category": "required-action", "facts": { "numericValue": 1, "continuationKind": "call-tool", "tool": "transaction-start", "tools": null } }, { "key": "success-envelope:all-published-tools", "category": "success-envelope", "facts": { "tools": { "analyze-async": { "variant": { "type": "object", "required": [ "ok", "data", "snapshot" ], "properties": { "ok": { "const": true, "description": "Whether the tool invocation succeeded." }, "data": { "type": [ "object", "null" ], "properties": { "findings": { "description": "The returned findings.", "type": "object", "properties": { "items": { "description": "Items returned in this page.", "type": [ "array", "null" ], "items": { "type": "object", "properties": { "diagnostic": { "description": "The compiler diagnostic.", "type": [ "object", "null" ], "properties": { "id": { "description": "The diagnostic identifier.", "type": "string" }, "severity": { "description": "The diagnostic severity.", "type": "string", "enum": [ "Hidden", "Info", "Warning", "Error" ] }, "message": { "description": "The diagnostic message.", "type": "string" }, "location": { "description": "The optional source location of the diagnostic.", "type": [ "object", "null" ], "properties": { "document": { "description": "The resolved document.", "type": [ "object", "null" ], "properties": { "documentId": { "description": "The document identifier.", "type": "string" }, "path": { "description": "The normalized document path.", "type": "string" }, "projectId": { "description": "The owning project identifier.", "type": "string" } }, "required": [ "documentId", "path", "projectId" ] }, "span": { "description": "The resolved text span.", "type": [ "object", "null" ], "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } }, "line": { "description": "The one-based line number.", "type": "integer" }, "column": { "description": "The one-based column number.", "type": "integer" }, "snapshot": { "description": "The exact immutable workspace snapshot associated with this location.", "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ] }, "selector": { "description": "The canonical selector that can resolve this source location again.", "type": [ "object", "null" ], "properties": { "span": { "type": "object", "properties": { "document": { "description": "Provide exactly one of path or documentId.", "type": "object", "properties": { "project": { "description": "Disambiguates documents with matching paths or IDs.", "type": [ "object", "null" ], "properties": { "projectId": { "type": [ "string", "null" ] }, "name": { "type": [ "string", "null" ] }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "targetFramework": { "type": [ "string", "null" ] } } }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "documentId": { "description": "Workspace-local document ID.", "type": [ "string", "null" ] } } }, "range": { "description": "Zero-based UTF-16 range.", "type": "object", "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } } }, "required": [ "document", "range" ] } }, "required": [ "span" ] } }, "required": [ "snapshot" ] } }, "required": [ "id", "message" ] } } } }, "hasMore": { "description": "Whether additional items were available beyond this page.", "type": "boolean" }, "totalCount": { "description": "Complete result count, when available without additional expensive work.", "type": [ "integer", "null" ] } } } }, "description": "Tool-specific result payload." }, "snapshot": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ], "description": "Exact immutable workspace snapshot associated with the result, when available." }, "warnings": { "type": "array", "description": "Non-fatal warnings the agent should consider.", "items": { "$ref": "#/$defs/warningInfo" } } } }, "definitions": { "warningInfo": { "type": "object", "properties": { "code": { "description": "The stable machine-readable warning code.", "type": "string" }, "message": { "description": "The human-readable warning message.", "type": "string" } }, "required": [ "code", "message" ] } } }, "analyze-control-flow": { "variant": { "type": "object", "required": [ "ok", "data", "snapshot" ], "properties": { "ok": { "const": true, "description": "Whether the tool invocation succeeded." }, "data": { "type": [ "object", "null" ], "properties": { "region": { "description": "The analyzed region.", "type": [ "object", "null" ], "properties": { "document": { "description": "The resolved document.", "type": [ "object", "null" ], "properties": { "documentId": { "description": "The document identifier.", "type": "string" }, "path": { "description": "The normalized document path.", "type": "string" }, "projectId": { "description": "The owning project identifier.", "type": "string" } }, "required": [ "documentId", "path", "projectId" ] }, "span": { "description": "The resolved text span.", "type": [ "object", "null" ], "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } }, "line": { "description": "The one-based line number.", "type": "integer" }, "column": { "description": "The one-based column number.", "type": "integer" }, "snapshot": { "description": "The exact immutable workspace snapshot associated with this location.", "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ] }, "selector": { "description": "The canonical selector that can resolve this source location again.", "type": [ "object", "null" ], "properties": { "span": { "type": "object", "properties": { "document": { "description": "Provide exactly one of path or documentId.", "type": "object", "properties": { "project": { "description": "Disambiguates documents with matching paths or IDs.", "type": [ "object", "null" ], "properties": { "projectId": { "type": [ "string", "null" ] }, "name": { "type": [ "string", "null" ] }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "targetFramework": { "type": [ "string", "null" ] } } }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "documentId": { "description": "Workspace-local document ID.", "type": [ "string", "null" ] } } }, "range": { "description": "Zero-based UTF-16 range.", "type": "object", "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } } }, "required": [ "document", "range" ] } }, "required": [ "span" ] } }, "required": [ "snapshot" ] }, "entryReachable": { "description": "Whether the region entry is reachable.", "type": "boolean" }, "exitReachable": { "description": "Whether the region exit is reachable.", "type": "boolean" }, "exits": { "description": "The projected exit points.", "type": "object", "properties": { "items": { "description": "Items returned in this page.", "type": [ "array", "null" ], "items": { "type": "object", "properties": { "kind": { "description": "The exit kind.", "type": "string" }, "location": { "description": "The exit location, when available.", "type": [ "object", "null" ], "properties": { "document": { "description": "The resolved document.", "$ref": "#/properties/request/properties/value/properties/region/properties/document" }, "span": { "description": "The resolved text span.", "$ref": "#/properties/request/properties/value/properties/region/properties/span" }, "line": { "description": "The one-based line number.", "type": "integer" }, "column": { "description": "The one-based column number.", "type": "integer" }, "snapshot": { "description": "The exact immutable workspace snapshot associated with this location.", "$ref": "#/properties/request/properties/value/properties/region/properties/snapshot" }, "selector": { "description": "The canonical selector that can resolve this source location again.", "$ref": "#/properties/request/properties/value/properties/region/properties/selector" } }, "required": [ "snapshot" ] } }, "required": [ "kind" ] } }, "hasMore": { "description": "Whether additional items were available beyond this page.", "type": "boolean" }, "totalCount": { "description": "Complete result count, when available without additional expensive work.", "type": [ "integer", "null" ] } } }, "returns": { "description": "The projected return statements.", "type": "object", "properties": { "items": { "description": "Items returned in this page.", "type": [ "array", "null" ], "items": { "type": "object", "properties": { "document": { "description": "The resolved document.", "$ref": "#/properties/request/properties/value/properties/region/properties/document" }, "span": { "description": "The resolved text span.", "$ref": "#/properties/request/properties/value/properties/region/properties/span" }, "line": { "description": "The one-based line number.", "type": "integer" }, "column": { "description": "The one-based column number.", "type": "integer" }, "snapshot": { "description": "The exact immutable workspace snapshot associated with this location.", "$ref": "#/properties/request/properties/value/properties/region/properties/snapshot" }, "selector": { "description": "The canonical selector that can resolve this source location again.", "$ref": "#/properties/request/properties/value/properties/region/properties/selector" } }, "required": [ "snapshot" ] } }, "hasMore": { "description": "Whether additional items were available beyond this page.", "type": "boolean" }, "totalCount": { "description": "Complete result count, when available without additional expensive work.", "type": [ "integer", "null" ] } } } }, "description": "Tool-specific result payload." }, "snapshot": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ], "description": "Exact immutable workspace snapshot associated with the result, when available." }, "warnings": { "type": "array", "description": "Non-fatal warnings the agent should consider.", "items": { "$ref": "#/$defs/warningInfo" } } } }, "definitions": { "warningInfo": { "type": "object", "properties": { "code": { "description": "The stable machine-readable warning code.", "type": "string" }, "message": { "description": "The human-readable warning message.", "type": "string" } }, "required": [ "code", "message" ] } } }, "analyze-data-flow": { "variant": { "type": "object", "required": [ "ok", "data", "snapshot" ], "properties": { "ok": { "const": true, "description": "Whether the tool invocation succeeded." }, "data": { "type": [ "object", "null" ], "properties": { "region": { "description": "The analyzed region.", "type": [ "object", "null" ], "properties": { "document": { "description": "The resolved document.", "type": [ "object", "null" ], "properties": { "documentId": { "description": "The document identifier.", "type": "string" }, "path": { "description": "The normalized document path.", "type": "string" }, "projectId": { "description": "The owning project identifier.", "type": "string" } }, "required": [ "documentId", "path", "projectId" ] }, "span": { "description": "The resolved text span.", "type": [ "object", "null" ], "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } }, "line": { "description": "The one-based line number.", "type": "integer" }, "column": { "description": "The one-based column number.", "type": "integer" }, "snapshot": { "description": "The exact immutable workspace snapshot associated with this location.", "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ] }, "selector": { "description": "The canonical selector that can resolve this source location again.", "type": [ "object", "null" ], "properties": { "span": { "type": "object", "properties": { "document": { "description": "Provide exactly one of path or documentId.", "type": "object", "properties": { "project": { "description": "Disambiguates documents with matching paths or IDs.", "type": [ "object", "null" ], "properties": { "projectId": { "type": [ "string", "null" ] }, "name": { "type": [ "string", "null" ] }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "targetFramework": { "type": [ "string", "null" ] } } }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "documentId": { "description": "Workspace-local document ID.", "type": [ "string", "null" ] } } }, "range": { "description": "Zero-based UTF-16 range.", "type": "object", "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } } }, "required": [ "document", "range" ] } }, "required": [ "span" ] } }, "required": [ "snapshot" ] }, "variablesDeclared": { "description": "The variables declared within the region.", "type": "object", "properties": { "items": { "description": "Items returned in this page.", "type": [ "array", "null" ], "items": { "type": "object", "properties": { "displayName": { "description": "The display name of the symbol.", "type": "string" }, "kind": { "description": "The symbol kind.", "type": "string" }, "documentationCommentId": { "description": "The documentation comment identifier, when available.", "type": [ "string", "null" ] }, "location": { "description": "The optional source location of the symbol.", "type": [ "object", "null" ], "properties": { "document": { "description": "The resolved document.", "$ref": "#/properties/request/properties/value/properties/region/properties/document" }, "span": { "description": "The resolved text span.", "$ref": "#/properties/request/properties/value/properties/region/properties/span" }, "line": { "description": "The one-based line number.", "type": "integer" }, "column": { "description": "The one-based column number.", "type": "integer" }, "snapshot": { "description": "The exact immutable workspace snapshot associated with this location.", "$ref": "#/properties/request/properties/value/properties/region/properties/snapshot" }, "selector": { "description": "The canonical selector that can resolve this source location again.", "$ref": "#/properties/request/properties/value/properties/region/properties/selector" } }, "required": [ "snapshot" ] } }, "required": [ "displayName", "kind" ] } }, "hasMore": { "description": "Whether additional items were available beyond this page.", "type": "boolean" }, "totalCount": { "description": "Complete result count, when available without additional expensive work.", "type": [ "integer", "null" ] } } }, "readInside": { "description": "The symbols read within the region.", "type": "object", "properties": { "items": { "description": "Items returned in this page.", "$ref": "#/properties/request/properties/value/properties/variablesDeclared/properties/items", "items": {} }, "hasMore": { "description": "Whether additional items were available beyond this page.", "type": "boolean" }, "totalCount": { "description": "Complete result count, when available without additional expensive work.", "type": [ "integer", "null" ] } } }, "writtenInside": { "description": "The symbols written within the region.", "type": "object", "properties": { "items": { "description": "Items returned in this page.", "$ref": "#/properties/request/properties/value/properties/variablesDeclared/properties/items", "items": {} }, "hasMore": { "description": "Whether additional items were available beyond this page.", "type": "boolean" }, "totalCount": { "description": "Complete result count, when available without additional expensive work.", "type": [ "integer", "null" ] } } }, "dataFlowsIn": { "description": "The symbols flowing into the region.", "type": "object", "properties": { "items": { "description": "Items returned in this page.", "$ref": "#/properties/request/properties/value/properties/variablesDeclared/properties/items", "items": {} }, "hasMore": { "description": "Whether additional items were available beyond this page.", "type": "boolean" }, "totalCount": { "description": "Complete result count, when available without additional expensive work.", "type": [ "integer", "null" ] } } }, "dataFlowsOut": { "description": "The symbols flowing out of the region.", "type": "object", "properties": { "items": { "description": "Items returned in this page.", "$ref": "#/properties/request/properties/value/properties/variablesDeclared/properties/items", "items": {} }, "hasMore": { "description": "Whether additional items were available beyond this page.", "type": "boolean" }, "totalCount": { "description": "Complete result count, when available without additional expensive work.", "type": [ "integer", "null" ] } } }, "captured": { "description": "The captured symbols.", "type": "object", "properties": { "items": { "description": "Items returned in this page.", "$ref": "#/properties/request/properties/value/properties/variablesDeclared/properties/items", "items": {} }, "hasMore": { "description": "Whether additional items were available beyond this page.", "type": "boolean" }, "totalCount": { "description": "Complete result count, when available without additional expensive work.", "type": [ "integer", "null" ] } } } }, "description": "Tool-specific result payload." }, "snapshot": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ], "description": "Exact immutable workspace snapshot associated with the result, when available." }, "warnings": { "type": "array", "description": "Non-fatal warnings the agent should consider.", "items": { "$ref": "#/$defs/warningInfo" } } } }, "definitions": { "warningInfo": { "type": "object", "properties": { "code": { "description": "The stable machine-readable warning code.", "type": "string" }, "message": { "description": "The human-readable warning message.", "type": "string" } }, "required": [ "code", "message" ] } } }, "analyze-disposables": { "variant": { "type": "object", "required": [ "ok", "data", "snapshot" ], "properties": { "ok": { "const": true, "description": "Whether the tool invocation succeeded." }, "data": { "type": [ "object", "null" ], "properties": { "findings": { "description": "The returned findings.", "type": "object", "properties": { "items": { "description": "Items returned in this page.", "type": [ "array", "null" ], "items": { "type": "object", "properties": { "kind": { "description": "The finding kind.", "type": "string" }, "symbol": { "description": "The associated local symbol.", "type": [ "object", "null" ], "properties": { "displayName": { "description": "The display name of the symbol.", "type": "string" }, "kind": { "description": "The symbol kind.", "type": "string" }, "documentationCommentId": { "description": "The documentation comment identifier, when available.", "type": [ "string", "null" ] }, "location": { "description": "The optional source location of the symbol.", "type": [ "object", "null" ], "properties": { "document": { "description": "The resolved document.", "type": [ "object", "null" ], "properties": { "documentId": { "description": "The document identifier.", "type": "string" }, "path": { "description": "The normalized document path.", "type": "string" }, "projectId": { "description": "The owning project identifier.", "type": "string" } }, "required": [ "documentId", "path", "projectId" ] }, "span": { "description": "The resolved text span.", "type": [ "object", "null" ], "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } }, "line": { "description": "The one-based line number.", "type": "integer" }, "column": { "description": "The one-based column number.", "type": "integer" }, "snapshot": { "description": "The exact immutable workspace snapshot associated with this location.", "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ] }, "selector": { "description": "The canonical selector that can resolve this source location again.", "type": [ "object", "null" ], "properties": { "span": { "type": "object", "properties": { "document": { "description": "Provide exactly one of path or documentId.", "type": "object", "properties": { "project": { "description": "Disambiguates documents with matching paths or IDs.", "type": [ "object", "null" ], "properties": { "projectId": { "type": [ "string", "null" ] }, "name": { "type": [ "string", "null" ] }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "targetFramework": { "type": [ "string", "null" ] } } }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "documentId": { "description": "Workspace-local document ID.", "type": [ "string", "null" ] } } }, "range": { "description": "Zero-based UTF-16 range.", "type": "object", "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } } }, "required": [ "document", "range" ] } }, "required": [ "span" ] } }, "required": [ "snapshot" ] } }, "required": [ "displayName", "kind" ] }, "type": { "description": "The disposable type.", "type": [ "object", "null" ], "properties": { "displayName": { "description": "The display name.", "type": "string" }, "kind": { "description": "The Roslyn type kind.", "type": "string" }, "nullableAnnotation": { "description": "The nullable annotation.", "type": [ "string", "null" ] }, "documentationCommentId": { "description": "The documentation-comment identifier, when available.", "type": [ "string", "null" ] } }, "required": [ "displayName", "kind" ] }, "location": { "description": "The finding location.", "type": [ "object", "null" ], "properties": { "document": { "description": "The resolved document.", "$ref": "#/properties/request/properties/value/properties/findings/properties/items/items/properties/symbol/properties/location/properties/document" }, "span": { "description": "The resolved text span.", "$ref": "#/properties/request/properties/value/properties/findings/properties/items/items/properties/symbol/properties/location/properties/span" }, "line": { "description": "The one-based line number.", "type": "integer" }, "column": { "description": "The one-based column number.", "type": "integer" }, "snapshot": { "description": "The exact immutable workspace snapshot associated with this location.", "$ref": "#/properties/request/properties/value/properties/findings/properties/items/items/properties/symbol/properties/location/properties/snapshot" }, "selector": { "description": "The canonical selector that can resolve this source location again.", "$ref": "#/properties/request/properties/value/properties/findings/properties/items/items/properties/symbol/properties/location/properties/selector" } }, "required": [ "snapshot" ] }, "message": { "description": "The finding message.", "type": "string" } }, "required": [ "kind", "message" ] } }, "hasMore": { "description": "Whether additional items were available beyond this page.", "type": "boolean" }, "totalCount": { "description": "Complete result count, when available without additional expensive work.", "type": [ "integer", "null" ] } } } }, "description": "Tool-specific result payload." }, "snapshot": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ], "description": "Exact immutable workspace snapshot associated with the result, when available." }, "warnings": { "type": "array", "description": "Non-fatal warnings the agent should consider.", "items": { "$ref": "#/$defs/warningInfo" } } } }, "definitions": { "warningInfo": { "type": "object", "properties": { "code": { "description": "The stable machine-readable warning code.", "type": "string" }, "message": { "description": "The human-readable warning message.", "type": "string" } }, "required": [ "code", "message" ] } } }, "analyze-nullability": { "variant": { "type": "object", "required": [ "ok", "data", "snapshot" ], "properties": { "ok": { "const": true, "description": "Whether the tool invocation succeeded." }, "data": { "type": [ "object", "null" ], "properties": { "findings": { "description": "The returned findings.", "type": "object", "properties": { "items": { "description": "Items returned in this page.", "type": [ "array", "null" ], "items": { "type": "object", "properties": { "diagnostic": { "description": "The projected diagnostic.", "type": [ "object", "null" ], "properties": { "id": { "description": "The diagnostic identifier.", "type": "string" }, "severity": { "description": "The diagnostic severity.", "type": "string", "enum": [ "Hidden", "Info", "Warning", "Error" ] }, "message": { "description": "The diagnostic message.", "type": "string" }, "location": { "description": "The optional source location of the diagnostic.", "type": [ "object", "null" ], "properties": { "document": { "description": "The resolved document.", "type": [ "object", "null" ], "properties": { "documentId": { "description": "The document identifier.", "type": "string" }, "path": { "description": "The normalized document path.", "type": "string" }, "projectId": { "description": "The owning project identifier.", "type": "string" } }, "required": [ "documentId", "path", "projectId" ] }, "span": { "description": "The resolved text span.", "type": [ "object", "null" ], "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } }, "line": { "description": "The one-based line number.", "type": "integer" }, "column": { "description": "The one-based column number.", "type": "integer" }, "snapshot": { "description": "The exact immutable workspace snapshot associated with this location.", "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ] }, "selector": { "description": "The canonical selector that can resolve this source location again.", "type": [ "object", "null" ], "properties": { "span": { "type": "object", "properties": { "document": { "description": "Provide exactly one of path or documentId.", "type": "object", "properties": { "project": { "description": "Disambiguates documents with matching paths or IDs.", "type": [ "object", "null" ], "properties": { "projectId": { "type": [ "string", "null" ] }, "name": { "type": [ "string", "null" ] }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "targetFramework": { "type": [ "string", "null" ] } } }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "documentId": { "description": "Workspace-local document ID.", "type": [ "string", "null" ] } } }, "range": { "description": "Zero-based UTF-16 range.", "type": "object", "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } } }, "required": [ "document", "range" ] } }, "required": [ "span" ] } }, "required": [ "snapshot" ] } }, "required": [ "id", "message" ] } } } }, "hasMore": { "description": "Whether additional items were available beyond this page.", "type": "boolean" }, "totalCount": { "description": "Complete result count, when available without additional expensive work.", "type": [ "integer", "null" ] } } } }, "description": "Tool-specific result payload." }, "snapshot": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ], "description": "Exact immutable workspace snapshot associated with the result, when available." }, "warnings": { "type": "array", "description": "Non-fatal warnings the agent should consider.", "items": { "$ref": "#/$defs/warningInfo" } } } }, "definitions": { "warningInfo": { "type": "object", "properties": { "code": { "description": "The stable machine-readable warning code.", "type": "string" }, "message": { "description": "The human-readable warning message.", "type": "string" } }, "required": [ "code", "message" ] } } }, "find-callees": { "variant": { "type": "object", "required": [ "ok", "data", "snapshot" ], "properties": { "ok": { "const": true, "description": "Whether the tool invocation succeeded." }, "data": { "type": [ "object", "null" ], "properties": { "source": { "description": "The queried callable symbol.", "type": [ "object", "null" ], "properties": { "displayName": { "description": "The display name of the symbol.", "type": "string" }, "kind": { "description": "The symbol kind.", "type": "string" }, "documentationCommentId": { "description": "The documentation comment identifier, when available.", "type": [ "string", "null" ] }, "location": { "description": "The optional source location of the symbol.", "type": [ "object", "null" ], "properties": { "document": { "description": "The resolved document.", "type": [ "object", "null" ], "properties": { "documentId": { "description": "The document identifier.", "type": "string" }, "path": { "description": "The normalized document path.", "type": "string" }, "projectId": { "description": "The owning project identifier.", "type": "string" } }, "required": [ "documentId", "path", "projectId" ] }, "span": { "description": "The resolved text span.", "type": [ "object", "null" ], "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } }, "line": { "description": "The one-based line number.", "type": "integer" }, "column": { "description": "The one-based column number.", "type": "integer" }, "snapshot": { "description": "The exact immutable workspace snapshot associated with this location.", "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ] }, "selector": { "description": "The canonical selector that can resolve this source location again.", "type": [ "object", "null" ], "properties": { "span": { "type": "object", "properties": { "document": { "description": "Provide exactly one of path or documentId.", "type": "object", "properties": { "project": { "description": "Disambiguates documents with matching paths or IDs.", "type": [ "object", "null" ], "properties": { "projectId": { "type": [ "string", "null" ] }, "name": { "type": [ "string", "null" ] }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "targetFramework": { "type": [ "string", "null" ] } } }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "documentId": { "description": "Workspace-local document ID.", "type": [ "string", "null" ] } } }, "range": { "description": "Zero-based UTF-16 range.", "type": "object", "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } } }, "required": [ "document", "range" ] } }, "required": [ "span" ] } }, "required": [ "snapshot" ] } }, "required": [ "displayName", "kind" ] }, "callees": { "description": "The returned callees.", "type": "object", "properties": { "items": { "description": "Items returned in this page.", "type": [ "array", "null" ], "items": { "type": "object", "properties": { "displayName": { "description": "The display name of the symbol.", "type": "string" }, "kind": { "description": "The symbol kind.", "type": "string" }, "documentationCommentId": { "description": "The documentation comment identifier, when available.", "type": [ "string", "null" ] }, "location": { "description": "The optional source location of the symbol.", "$ref": "#/properties/request/properties/value/properties/source/properties/location" } }, "required": [ "displayName", "kind" ] } }, "hasMore": { "description": "Whether additional items were available beyond this page.", "type": "boolean" }, "totalCount": { "description": "Complete result count, when available without additional expensive work.", "type": [ "integer", "null" ] } } } }, "description": "Tool-specific result payload." }, "snapshot": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ], "description": "Exact immutable workspace snapshot associated with the result, when available." }, "warnings": { "type": "array", "description": "Non-fatal warnings the agent should consider.", "items": { "$ref": "#/$defs/warningInfo" } } } }, "definitions": { "warningInfo": { "type": "object", "properties": { "code": { "description": "The stable machine-readable warning code.", "type": "string" }, "message": { "description": "The human-readable warning message.", "type": "string" } }, "required": [ "code", "message" ] } } }, "find-callers": { "variant": { "type": "object", "required": [ "ok", "data", "snapshot" ], "properties": { "ok": { "const": true, "description": "Whether the tool invocation succeeded." }, "data": { "type": [ "object", "null" ], "properties": { "symbol": { "description": "The queried symbol.", "type": [ "object", "null" ], "properties": { "displayName": { "description": "The display name of the symbol.", "type": "string" }, "kind": { "description": "The symbol kind.", "type": "string" }, "documentationCommentId": { "description": "The documentation comment identifier, when available.", "type": [ "string", "null" ] }, "location": { "description": "The optional source location of the symbol.", "type": [ "object", "null" ], "properties": { "document": { "description": "The resolved document.", "type": [ "object", "null" ], "properties": { "documentId": { "description": "The document identifier.", "type": "string" }, "path": { "description": "The normalized document path.", "type": "string" }, "projectId": { "description": "The owning project identifier.", "type": "string" } }, "required": [ "documentId", "path", "projectId" ] }, "span": { "description": "The resolved text span.", "type": [ "object", "null" ], "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } }, "line": { "description": "The one-based line number.", "type": "integer" }, "column": { "description": "The one-based column number.", "type": "integer" }, "snapshot": { "description": "The exact immutable workspace snapshot associated with this location.", "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ] }, "selector": { "description": "The canonical selector that can resolve this source location again.", "type": [ "object", "null" ], "properties": { "span": { "type": "object", "properties": { "document": { "description": "Provide exactly one of path or documentId.", "type": "object", "properties": { "project": { "description": "Disambiguates documents with matching paths or IDs.", "type": [ "object", "null" ], "properties": { "projectId": { "type": [ "string", "null" ] }, "name": { "type": [ "string", "null" ] }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "targetFramework": { "type": [ "string", "null" ] } } }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "documentId": { "description": "Workspace-local document ID.", "type": [ "string", "null" ] } } }, "range": { "description": "Zero-based UTF-16 range.", "type": "object", "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } } }, "required": [ "document", "range" ] } }, "required": [ "span" ] } }, "required": [ "snapshot" ] } }, "required": [ "displayName", "kind" ] }, "callers": { "description": "The returned caller information.", "type": "object", "properties": { "items": { "description": "Items returned in this page.", "type": [ "array", "null" ], "items": { "type": "object", "properties": { "caller": { "description": "The calling symbol.", "type": [ "object", "null" ], "properties": { "displayName": { "description": "The display name of the symbol.", "type": "string" }, "kind": { "description": "The symbol kind.", "type": "string" }, "documentationCommentId": { "description": "The documentation comment identifier, when available.", "type": [ "string", "null" ] }, "location": { "description": "The optional source location of the symbol.", "$ref": "#/properties/request/properties/value/properties/symbol/properties/location" } }, "required": [ "displayName", "kind" ] }, "callSites": { "description": "The bounded call sites for the caller.", "type": "object", "properties": { "items": { "description": "Items returned in this page.", "type": [ "array", "null" ], "items": { "type": "object", "properties": { "location": { "description": "The exact call-site location.", "type": [ "object", "null" ], "properties": { "document": { "description": "The resolved document.", "$ref": "#/properties/request/properties/value/properties/symbol/properties/location/properties/document" }, "span": { "description": "The resolved text span.", "$ref": "#/properties/request/properties/value/properties/symbol/properties/location/properties/span" }, "line": { "description": "The one-based line number.", "type": "integer" }, "column": { "description": "The one-based column number.", "type": "integer" }, "snapshot": { "description": "The exact immutable workspace snapshot associated with this location.", "$ref": "#/properties/request/properties/value/properties/symbol/properties/location/properties/snapshot" }, "selector": { "description": "The canonical selector that can resolve this source location again.", "$ref": "#/properties/request/properties/value/properties/symbol/properties/location/properties/selector" } }, "required": [ "snapshot" ] }, "context": { "description": "The optional source context requested for the call site.", "type": [ "string", "null" ] } } } }, "hasMore": { "description": "Whether additional items were available beyond this page.", "type": "boolean" }, "totalCount": { "description": "Complete result count, when available without additional expensive work.", "type": [ "integer", "null" ] } } } } } }, "hasMore": { "description": "Whether additional items were available beyond this page.", "type": "boolean" }, "totalCount": { "description": "Complete result count, when available without additional expensive work.", "type": [ "integer", "null" ] } } } }, "description": "Tool-specific result payload." }, "snapshot": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ], "description": "Exact immutable workspace snapshot associated with the result, when available." }, "warnings": { "type": "array", "description": "Non-fatal warnings the agent should consider.", "items": { "$ref": "#/$defs/warningInfo" } } } }, "definitions": { "warningInfo": { "type": "object", "properties": { "code": { "description": "The stable machine-readable warning code.", "type": "string" }, "message": { "description": "The human-readable warning message.", "type": "string" } }, "required": [ "code", "message" ] } } }, "find-dependency-cycles": { "variant": { "type": "object", "required": [ "ok", "data", "snapshot" ], "properties": { "ok": { "const": true, "description": "Whether the tool invocation succeeded." }, "data": { "type": [ "object", "null" ], "properties": { "cycles": { "description": "The returned cycles.", "type": "object", "properties": { "items": { "description": "Items returned in this page.", "type": [ "array", "null" ], "items": { "type": "object", "properties": { "nodes": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "kind": { "type": "string" }, "displayName": { "type": "string" }, "symbol": { "type": [ "object", "null" ], "properties": { "displayName": { "description": "The display name of the symbol.", "type": "string" }, "kind": { "description": "The symbol kind.", "type": "string" }, "documentationCommentId": { "description": "The documentation comment identifier, when available.", "type": [ "string", "null" ] }, "location": { "description": "The optional source location of the symbol.", "type": [ "object", "null" ], "properties": { "document": { "description": "The resolved document.", "type": [ "object", "null" ], "properties": { "documentId": { "description": "The document identifier.", "type": "string" }, "path": { "description": "The normalized document path.", "type": "string" }, "projectId": { "description": "The owning project identifier.", "type": "string" } }, "required": [ "documentId", "path", "projectId" ] }, "span": { "description": "The resolved text span.", "type": [ "object", "null" ], "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } }, "line": { "description": "The one-based line number.", "type": "integer" }, "column": { "description": "The one-based column number.", "type": "integer" }, "snapshot": { "description": "The exact immutable workspace snapshot associated with this location.", "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ] }, "selector": { "description": "The canonical selector that can resolve this source location again.", "type": [ "object", "null" ], "properties": { "span": { "type": "object", "properties": { "document": { "description": "Provide exactly one of path or documentId.", "type": "object", "properties": { "project": { "description": "Disambiguates documents with matching paths or IDs.", "type": [ "object", "null" ], "properties": { "projectId": { "type": [ "string", "null" ] }, "name": { "type": [ "string", "null" ] }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "targetFramework": { "type": [ "string", "null" ] } } }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "documentId": { "description": "Workspace-local document ID.", "type": [ "string", "null" ] } } }, "range": { "description": "Zero-based UTF-16 range.", "type": "object", "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } } }, "required": [ "document", "range" ] } }, "required": [ "span" ] } }, "required": [ "snapshot" ] } }, "required": [ "displayName", "kind" ] } }, "required": [ "id", "kind", "displayName" ] } } } } }, "hasMore": { "description": "Whether additional items were available beyond this page.", "type": "boolean" }, "totalCount": { "description": "Complete result count, when available without additional expensive work.", "type": [ "integer", "null" ] } } } }, "description": "Tool-specific result payload." }, "snapshot": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ], "description": "Exact immutable workspace snapshot associated with the result, when available." }, "warnings": { "type": "array", "description": "Non-fatal warnings the agent should consider.", "items": { "$ref": "#/$defs/warningInfo" } } } }, "definitions": { "warningInfo": { "type": "object", "properties": { "code": { "description": "The stable machine-readable warning code.", "type": "string" }, "message": { "description": "The human-readable warning message.", "type": "string" } }, "required": [ "code", "message" ] } } }, "find-derived-types": { "variant": { "type": "object", "required": [ "ok", "data", "snapshot" ], "properties": { "ok": { "const": true, "description": "Whether the tool invocation succeeded." }, "data": { "type": [ "object", "null" ], "properties": { "baseType": { "description": "The queried base type.", "type": [ "object", "null" ], "properties": { "displayName": { "description": "The display name of the symbol.", "type": "string" }, "kind": { "description": "The symbol kind.", "type": "string" }, "documentationCommentId": { "description": "The documentation comment identifier, when available.", "type": [ "string", "null" ] }, "location": { "description": "The optional source location of the symbol.", "type": [ "object", "null" ], "properties": { "document": { "description": "The resolved document.", "type": [ "object", "null" ], "properties": { "documentId": { "description": "The document identifier.", "type": "string" }, "path": { "description": "The normalized document path.", "type": "string" }, "projectId": { "description": "The owning project identifier.", "type": "string" } }, "required": [ "documentId", "path", "projectId" ] }, "span": { "description": "The resolved text span.", "type": [ "object", "null" ], "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } }, "line": { "description": "The one-based line number.", "type": "integer" }, "column": { "description": "The one-based column number.", "type": "integer" }, "snapshot": { "description": "The exact immutable workspace snapshot associated with this location.", "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ] }, "selector": { "description": "The canonical selector that can resolve this source location again.", "type": [ "object", "null" ], "properties": { "span": { "type": "object", "properties": { "document": { "description": "Provide exactly one of path or documentId.", "type": "object", "properties": { "project": { "description": "Disambiguates documents with matching paths or IDs.", "type": [ "object", "null" ], "properties": { "projectId": { "type": [ "string", "null" ] }, "name": { "type": [ "string", "null" ] }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "targetFramework": { "type": [ "string", "null" ] } } }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "documentId": { "description": "Workspace-local document ID.", "type": [ "string", "null" ] } } }, "range": { "description": "Zero-based UTF-16 range.", "type": "object", "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } } }, "required": [ "document", "range" ] } }, "required": [ "span" ] } }, "required": [ "snapshot" ] } }, "required": [ "displayName", "kind" ] }, "derivedTypes": { "description": "The resolved derived types.", "type": "object", "properties": { "items": { "description": "Items returned in this page.", "type": [ "array", "null" ], "items": { "type": "object", "properties": { "type": { "description": "The resolved type symbol.", "type": [ "object", "null" ], "properties": { "displayName": { "description": "The display name of the symbol.", "type": "string" }, "kind": { "description": "The symbol kind.", "type": "string" }, "documentationCommentId": { "description": "The documentation comment identifier, when available.", "type": [ "string", "null" ] }, "location": { "description": "The optional source location of the symbol.", "$ref": "#/properties/request/properties/value/properties/baseType/properties/location" } }, "required": [ "displayName", "kind" ] }, "depth": { "description": "The zero-based depth from the queried root type.", "type": "integer" }, "derivedTypes": { "description": "The nested derived types for this node.", "type": "array", "items": { "$ref": "#/properties/request/properties/value/properties/derivedTypes/properties/items/items" } } } } }, "hasMore": { "description": "Whether additional items were available beyond this page.", "type": "boolean" }, "totalCount": { "description": "Complete result count, when available without additional expensive work.", "type": [ "integer", "null" ] } } } }, "description": "Tool-specific result payload." }, "snapshot": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ], "description": "Exact immutable workspace snapshot associated with the result, when available." }, "warnings": { "type": "array", "description": "Non-fatal warnings the agent should consider.", "items": { "$ref": "#/$defs/warningInfo" } } } }, "definitions": { "warningInfo": { "type": "object", "properties": { "code": { "description": "The stable machine-readable warning code.", "type": "string" }, "message": { "description": "The human-readable warning message.", "type": "string" } }, "required": [ "code", "message" ] } } }, "find-duplicate-code": { "variant": { "type": "object", "required": [ "ok", "data", "snapshot" ], "properties": { "ok": { "const": true, "description": "Whether the tool invocation succeeded." }, "data": { "type": [ "object", "null" ], "properties": { "groups": { "description": "The returned duplicate groups.", "type": "object", "properties": { "items": { "description": "Items returned in this page.", "type": [ "array", "null" ], "items": { "type": "object", "properties": { "statementCount": { "description": "The number of normalized statements in the group.", "type": "integer" }, "occurrences": { "description": "The group occurrences.", "type": "object", "properties": { "items": { "description": "Items returned in this page.", "type": [ "array", "null" ], "items": { "type": "object", "properties": { "symbol": { "description": "The enclosing symbol.", "type": [ "object", "null" ], "properties": { "displayName": { "description": "The display name of the symbol.", "type": "string" }, "kind": { "description": "The symbol kind.", "type": "string" }, "documentationCommentId": { "description": "The documentation comment identifier, when available.", "type": [ "string", "null" ] }, "location": { "description": "The optional source location of the symbol.", "type": [ "object", "null" ], "properties": { "document": { "description": "The resolved document.", "type": [ "object", "null" ], "properties": { "documentId": { "description": "The document identifier.", "type": "string" }, "path": { "description": "The normalized document path.", "type": "string" }, "projectId": { "description": "The owning project identifier.", "type": "string" } }, "required": [ "documentId", "path", "projectId" ] }, "span": { "description": "The resolved text span.", "type": [ "object", "null" ], "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } }, "line": { "description": "The one-based line number.", "type": "integer" }, "column": { "description": "The one-based column number.", "type": "integer" }, "snapshot": { "description": "The exact immutable workspace snapshot associated with this location.", "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ] }, "selector": { "description": "The canonical selector that can resolve this source location again.", "type": [ "object", "null" ], "properties": { "span": { "type": "object", "properties": { "document": { "description": "Provide exactly one of path or documentId.", "type": "object", "properties": { "project": { "description": "Disambiguates documents with matching paths or IDs.", "type": [ "object", "null" ], "properties": { "projectId": { "type": [ "string", "null" ] }, "name": { "type": [ "string", "null" ] }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "targetFramework": { "type": [ "string", "null" ] } } }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "documentId": { "description": "Workspace-local document ID.", "type": [ "string", "null" ] } } }, "range": { "description": "Zero-based UTF-16 range.", "type": "object", "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } } }, "required": [ "document", "range" ] } }, "required": [ "span" ] } }, "required": [ "snapshot" ] } }, "required": [ "displayName", "kind" ] }, "location": { "description": "The occurrence location.", "type": [ "object", "null" ], "properties": { "document": { "description": "The resolved document.", "$ref": "#/properties/request/properties/value/properties/groups/properties/items/items/properties/occurrences/properties/items/items/properties/symbol/properties/location/properties/document" }, "span": { "description": "The resolved text span.", "$ref": "#/properties/request/properties/value/properties/groups/properties/items/items/properties/occurrences/properties/items/items/properties/symbol/properties/location/properties/span" }, "line": { "description": "The one-based line number.", "type": "integer" }, "column": { "description": "The one-based column number.", "type": "integer" }, "snapshot": { "description": "The exact immutable workspace snapshot associated with this location.", "$ref": "#/properties/request/properties/value/properties/groups/properties/items/items/properties/occurrences/properties/items/items/properties/symbol/properties/location/properties/snapshot" }, "selector": { "description": "The canonical selector that can resolve this source location again.", "$ref": "#/properties/request/properties/value/properties/groups/properties/items/items/properties/occurrences/properties/items/items/properties/symbol/properties/location/properties/selector" } }, "required": [ "snapshot" ] } } } }, "hasMore": { "description": "Whether additional items were available beyond this page.", "type": "boolean" }, "totalCount": { "description": "Complete result count, when available without additional expensive work.", "type": [ "integer", "null" ] } } } } } }, "hasMore": { "description": "Whether additional items were available beyond this page.", "type": "boolean" }, "totalCount": { "description": "Complete result count, when available without additional expensive work.", "type": [ "integer", "null" ] } } } }, "description": "Tool-specific result payload." }, "snapshot": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ], "description": "Exact immutable workspace snapshot associated with the result, when available." }, "warnings": { "type": "array", "description": "Non-fatal warnings the agent should consider.", "items": { "$ref": "#/$defs/warningInfo" } } } }, "definitions": { "warningInfo": { "type": "object", "properties": { "code": { "description": "The stable machine-readable warning code.", "type": "string" }, "message": { "description": "The human-readable warning message.", "type": "string" } }, "required": [ "code", "message" ] } } }, "find-implementations": { "variant": { "type": "object", "required": [ "ok", "data", "snapshot" ], "properties": { "ok": { "const": true, "description": "Whether the tool invocation succeeded." }, "data": { "type": [ "object", "null" ], "properties": { "symbol": { "description": "The queried symbol.", "type": [ "object", "null" ], "properties": { "displayName": { "description": "The display name of the symbol.", "type": "string" }, "kind": { "description": "The symbol kind.", "type": "string" }, "documentationCommentId": { "description": "The documentation comment identifier, when available.", "type": [ "string", "null" ] }, "location": { "description": "The optional source location of the symbol.", "type": [ "object", "null" ], "properties": { "document": { "description": "The resolved document.", "type": [ "object", "null" ], "properties": { "documentId": { "description": "The document identifier.", "type": "string" }, "path": { "description": "The normalized document path.", "type": "string" }, "projectId": { "description": "The owning project identifier.", "type": "string" } }, "required": [ "documentId", "path", "projectId" ] }, "span": { "description": "The resolved text span.", "type": [ "object", "null" ], "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } }, "line": { "description": "The one-based line number.", "type": "integer" }, "column": { "description": "The one-based column number.", "type": "integer" }, "snapshot": { "description": "The exact immutable workspace snapshot associated with this location.", "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ] }, "selector": { "description": "The canonical selector that can resolve this source location again.", "type": [ "object", "null" ], "properties": { "span": { "type": "object", "properties": { "document": { "description": "Provide exactly one of path or documentId.", "type": "object", "properties": { "project": { "description": "Disambiguates documents with matching paths or IDs.", "type": [ "object", "null" ], "properties": { "projectId": { "type": [ "string", "null" ] }, "name": { "type": [ "string", "null" ] }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "targetFramework": { "type": [ "string", "null" ] } } }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "documentId": { "description": "Workspace-local document ID.", "type": [ "string", "null" ] } } }, "range": { "description": "Zero-based UTF-16 range.", "type": "object", "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } } }, "required": [ "document", "range" ] } }, "required": [ "span" ] } }, "required": [ "snapshot" ] } }, "required": [ "displayName", "kind" ] }, "implementations": { "description": "The resolved implementations.", "type": "object", "properties": { "items": { "description": "Items returned in this page.", "type": [ "array", "null" ], "items": { "type": "object", "properties": { "displayName": { "description": "The display name of the symbol.", "type": "string" }, "kind": { "description": "The symbol kind.", "type": "string" }, "documentationCommentId": { "description": "The documentation comment identifier, when available.", "type": [ "string", "null" ] }, "location": { "description": "The optional source location of the symbol.", "$ref": "#/properties/request/properties/value/properties/symbol/properties/location" } }, "required": [ "displayName", "kind" ] } }, "hasMore": { "description": "Whether additional items were available beyond this page.", "type": "boolean" }, "totalCount": { "description": "Complete result count, when available without additional expensive work.", "type": [ "integer", "null" ] } } } }, "description": "Tool-specific result payload." }, "snapshot": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ], "description": "Exact immutable workspace snapshot associated with the result, when available." }, "warnings": { "type": "array", "description": "Non-fatal warnings the agent should consider.", "items": { "$ref": "#/$defs/warningInfo" } } } }, "definitions": { "warningInfo": { "type": "object", "properties": { "code": { "description": "The stable machine-readable warning code.", "type": "string" }, "message": { "description": "The human-readable warning message.", "type": "string" } }, "required": [ "code", "message" ] } } }, "find-overloads": { "variant": { "type": "object", "required": [ "ok", "data", "snapshot" ], "properties": { "ok": { "const": true, "description": "Whether the tool invocation succeeded." }, "data": { "type": [ "object", "null" ], "properties": { "symbol": { "description": "The queried symbol.", "type": [ "object", "null" ], "properties": { "displayName": { "description": "The display name of the symbol.", "type": "string" }, "kind": { "description": "The symbol kind.", "type": "string" }, "documentationCommentId": { "description": "The documentation comment identifier, when available.", "type": [ "string", "null" ] }, "location": { "description": "The optional source location of the symbol.", "type": [ "object", "null" ], "properties": { "document": { "description": "The resolved document.", "type": [ "object", "null" ], "properties": { "documentId": { "description": "The document identifier.", "type": "string" }, "path": { "description": "The normalized document path.", "type": "string" }, "projectId": { "description": "The owning project identifier.", "type": "string" } }, "required": [ "documentId", "path", "projectId" ] }, "span": { "description": "The resolved text span.", "type": [ "object", "null" ], "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } }, "line": { "description": "The one-based line number.", "type": "integer" }, "column": { "description": "The one-based column number.", "type": "integer" }, "snapshot": { "description": "The exact immutable workspace snapshot associated with this location.", "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ] }, "selector": { "description": "The canonical selector that can resolve this source location again.", "type": [ "object", "null" ], "properties": { "span": { "type": "object", "properties": { "document": { "description": "Provide exactly one of path or documentId.", "type": "object", "properties": { "project": { "description": "Disambiguates documents with matching paths or IDs.", "type": [ "object", "null" ], "properties": { "projectId": { "type": [ "string", "null" ] }, "name": { "type": [ "string", "null" ] }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "targetFramework": { "type": [ "string", "null" ] } } }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "documentId": { "description": "Workspace-local document ID.", "type": [ "string", "null" ] } } }, "range": { "description": "Zero-based UTF-16 range.", "type": "object", "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } } }, "required": [ "document", "range" ] } }, "required": [ "span" ] } }, "required": [ "snapshot" ] } }, "required": [ "displayName", "kind" ] }, "overloads": { "description": "The resolved overload signatures.", "type": "object", "properties": { "items": { "description": "Items returned in this page.", "type": [ "array", "null" ], "items": { "type": "object", "properties": { "displayName": { "description": "The callable display name.", "type": "string" }, "kind": { "description": "The callable kind.", "type": "string" }, "parameters": { "description": "The ordered parameters for the callable.", "type": "array", "items": { "type": "object", "properties": { "name": { "description": "The parameter name.", "type": "string" }, "type": { "description": "The parameter type information.", "type": [ "object", "null" ], "properties": { "displayName": { "description": "The display name.", "type": "string" }, "kind": { "description": "The Roslyn type kind.", "type": "string" }, "nullableAnnotation": { "description": "The nullable annotation.", "type": [ "string", "null" ] }, "documentationCommentId": { "description": "The documentation-comment identifier, when available.", "type": [ "string", "null" ] } }, "required": [ "displayName", "kind" ] }, "refKind": { "description": "The parameter passing mode.", "type": "string" }, "isOptional": { "description": "Whether the parameter is optional.", "type": "boolean" }, "hasExplicitDefaultValue": { "description": "Whether the parameter has an explicit default value.", "type": "boolean" }, "defaultValue": { "description": "The formatted default value, when available.", "type": [ "string", "null" ] } }, "required": [ "name", "refKind" ] } }, "returnType": { "description": "The return type, when applicable.", "type": [ "object", "null" ], "properties": { "displayName": { "description": "The display name.", "type": "string" }, "kind": { "description": "The Roslyn type kind.", "type": "string" }, "nullableAnnotation": { "description": "The nullable annotation.", "type": [ "string", "null" ] }, "documentationCommentId": { "description": "The documentation-comment identifier, when available.", "type": [ "string", "null" ] } }, "required": [ "displayName", "kind" ] } }, "required": [ "displayName", "kind" ] } }, "hasMore": { "description": "Whether additional items were available beyond this page.", "type": "boolean" }, "totalCount": { "description": "Complete result count, when available without additional expensive work.", "type": [ "integer", "null" ] } } } }, "description": "Tool-specific result payload." }, "snapshot": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ], "description": "Exact immutable workspace snapshot associated with the result, when available." }, "warnings": { "type": "array", "description": "Non-fatal warnings the agent should consider.", "items": { "$ref": "#/$defs/warningInfo" } } } }, "definitions": { "warningInfo": { "type": "object", "properties": { "code": { "description": "The stable machine-readable warning code.", "type": "string" }, "message": { "description": "The human-readable warning message.", "type": "string" } }, "required": [ "code", "message" ] } } }, "find-overrides": { "variant": { "type": "object", "required": [ "ok", "data", "snapshot" ], "properties": { "ok": { "const": true, "description": "Whether the tool invocation succeeded." }, "data": { "type": [ "object", "null" ], "properties": { "symbol": { "description": "The queried base member.", "type": [ "object", "null" ], "properties": { "displayName": { "description": "The display name of the symbol.", "type": "string" }, "kind": { "description": "The symbol kind.", "type": "string" }, "documentationCommentId": { "description": "The documentation comment identifier, when available.", "type": [ "string", "null" ] }, "location": { "description": "The optional source location of the symbol.", "type": [ "object", "null" ], "properties": { "document": { "description": "The resolved document.", "type": [ "object", "null" ], "properties": { "documentId": { "description": "The document identifier.", "type": "string" }, "path": { "description": "The normalized document path.", "type": "string" }, "projectId": { "description": "The owning project identifier.", "type": "string" } }, "required": [ "documentId", "path", "projectId" ] }, "span": { "description": "The resolved text span.", "type": [ "object", "null" ], "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } }, "line": { "description": "The one-based line number.", "type": "integer" }, "column": { "description": "The one-based column number.", "type": "integer" }, "snapshot": { "description": "The exact immutable workspace snapshot associated with this location.", "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ] }, "selector": { "description": "The canonical selector that can resolve this source location again.", "type": [ "object", "null" ], "properties": { "span": { "type": "object", "properties": { "document": { "description": "Provide exactly one of path or documentId.", "type": "object", "properties": { "project": { "description": "Disambiguates documents with matching paths or IDs.", "type": [ "object", "null" ], "properties": { "projectId": { "type": [ "string", "null" ] }, "name": { "type": [ "string", "null" ] }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "targetFramework": { "type": [ "string", "null" ] } } }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "documentId": { "description": "Workspace-local document ID.", "type": [ "string", "null" ] } } }, "range": { "description": "Zero-based UTF-16 range.", "type": "object", "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } } }, "required": [ "document", "range" ] } }, "required": [ "span" ] } }, "required": [ "snapshot" ] } }, "required": [ "displayName", "kind" ] }, "overrides": { "description": "The returned overrides.", "type": "object", "properties": { "items": { "description": "Items returned in this page.", "type": [ "array", "null" ], "items": { "type": "object", "properties": { "displayName": { "description": "The display name of the symbol.", "type": "string" }, "kind": { "description": "The symbol kind.", "type": "string" }, "documentationCommentId": { "description": "The documentation comment identifier, when available.", "type": [ "string", "null" ] }, "location": { "description": "The optional source location of the symbol.", "$ref": "#/properties/request/properties/value/properties/symbol/properties/location" } }, "required": [ "displayName", "kind" ] } }, "hasMore": { "description": "Whether additional items were available beyond this page.", "type": "boolean" }, "totalCount": { "description": "Complete result count, when available without additional expensive work.", "type": [ "integer", "null" ] } } } }, "description": "Tool-specific result payload." }, "snapshot": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ], "description": "Exact immutable workspace snapshot associated with the result, when available." }, "warnings": { "type": "array", "description": "Non-fatal warnings the agent should consider.", "items": { "$ref": "#/$defs/warningInfo" } } } }, "definitions": { "warningInfo": { "type": "object", "properties": { "code": { "description": "The stable machine-readable warning code.", "type": "string" }, "message": { "description": "The human-readable warning message.", "type": "string" } }, "required": [ "code", "message" ] } } }, "find-references": { "variant": { "type": "object", "required": [ "ok", "data", "snapshot" ], "properties": { "ok": { "const": true, "description": "Whether the tool invocation succeeded." }, "data": { "type": [ "object", "null" ], "properties": { "symbol": { "description": "The queried symbol.", "type": [ "object", "null" ], "properties": { "displayName": { "description": "The display name of the symbol.", "type": "string" }, "kind": { "description": "The symbol kind.", "type": "string" }, "documentationCommentId": { "description": "The documentation comment identifier, when available.", "type": [ "string", "null" ] }, "location": { "description": "The optional source location of the symbol.", "type": [ "object", "null" ], "properties": { "document": { "description": "The resolved document.", "type": [ "object", "null" ], "properties": { "documentId": { "description": "The document identifier.", "type": "string" }, "path": { "description": "The normalized document path.", "type": "string" }, "projectId": { "description": "The owning project identifier.", "type": "string" } }, "required": [ "documentId", "path", "projectId" ] }, "span": { "description": "The resolved text span.", "type": [ "object", "null" ], "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } }, "line": { "description": "The one-based line number.", "type": "integer" }, "column": { "description": "The one-based column number.", "type": "integer" }, "snapshot": { "description": "The exact immutable workspace snapshot associated with this location.", "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ] }, "selector": { "description": "The canonical selector that can resolve this source location again.", "type": [ "object", "null" ], "properties": { "span": { "type": "object", "properties": { "document": { "description": "Provide exactly one of path or documentId.", "type": "object", "properties": { "project": { "description": "Disambiguates documents with matching paths or IDs.", "type": [ "object", "null" ], "properties": { "projectId": { "type": [ "string", "null" ] }, "name": { "type": [ "string", "null" ] }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "targetFramework": { "type": [ "string", "null" ] } } }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "documentId": { "description": "Workspace-local document ID.", "type": [ "string", "null" ] } } }, "range": { "description": "Zero-based UTF-16 range.", "type": "object", "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } } }, "required": [ "document", "range" ] } }, "required": [ "span" ] } }, "required": [ "snapshot" ] } }, "required": [ "displayName", "kind" ] }, "references": { "description": "The returned references.", "type": "object", "properties": { "items": { "description": "Items returned in this page.", "type": [ "array", "null" ], "items": { "type": "object", "properties": { "location": { "description": "The reference location.", "type": [ "object", "null" ], "properties": { "document": { "description": "The resolved document.", "$ref": "#/properties/request/properties/value/properties/symbol/properties/location/properties/document" }, "span": { "description": "The resolved text span.", "$ref": "#/properties/request/properties/value/properties/symbol/properties/location/properties/span" }, "line": { "description": "The one-based line number.", "type": "integer" }, "column": { "description": "The one-based column number.", "type": "integer" }, "snapshot": { "description": "The exact immutable workspace snapshot associated with this location.", "$ref": "#/properties/request/properties/value/properties/symbol/properties/location/properties/snapshot" }, "selector": { "description": "The canonical selector that can resolve this source location again.", "$ref": "#/properties/request/properties/value/properties/symbol/properties/location/properties/selector" } }, "required": [ "snapshot" ] }, "containingSymbol": { "description": "The containing symbol, when available.", "type": [ "object", "null" ], "properties": { "displayName": { "description": "The display name of the symbol.", "type": "string" }, "kind": { "description": "The symbol kind.", "type": "string" }, "documentationCommentId": { "description": "The documentation comment identifier, when available.", "type": [ "string", "null" ] }, "location": { "description": "The optional source location of the symbol.", "$ref": "#/properties/request/properties/value/properties/symbol/properties/location" } }, "required": [ "displayName", "kind" ] }, "isDefinition": { "description": "Whether the location is a definition.", "type": "boolean" }, "isWrite": { "description": "Whether the location represents a write access.", "type": "boolean" }, "context": { "description": "The optional source snippet.", "type": [ "string", "null" ] } } } }, "hasMore": { "description": "Whether additional items were available beyond this page.", "type": "boolean" }, "totalCount": { "description": "Complete result count, when available without additional expensive work.", "type": [ "integer", "null" ] } } } }, "description": "Tool-specific result payload." }, "snapshot": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ], "description": "Exact immutable workspace snapshot associated with the result, when available." }, "warnings": { "type": "array", "description": "Non-fatal warnings the agent should consider.", "items": { "$ref": "#/$defs/warningInfo" } } } }, "definitions": { "warningInfo": { "type": "object", "properties": { "code": { "description": "The stable machine-readable warning code.", "type": "string" }, "message": { "description": "The human-readable warning message.", "type": "string" } }, "required": [ "code", "message" ] } } }, "find-unused-symbols": { "variant": { "type": "object", "required": [ "ok", "data", "snapshot" ], "properties": { "ok": { "const": true, "description": "Whether the tool invocation succeeded." }, "data": { "type": [ "object", "null" ], "properties": { "candidates": { "description": "The returned unused symbol candidates.", "type": "object", "properties": { "items": { "description": "Items returned in this page.", "type": [ "array", "null" ], "items": { "type": "object", "properties": { "symbol": { "description": "The candidate symbol.", "type": [ "object", "null" ], "properties": { "displayName": { "description": "The display name of the symbol.", "type": "string" }, "kind": { "description": "The symbol kind.", "type": "string" }, "documentationCommentId": { "description": "The documentation comment identifier, when available.", "type": [ "string", "null" ] }, "location": { "description": "The optional source location of the symbol.", "type": [ "object", "null" ], "properties": { "document": { "description": "The resolved document.", "type": [ "object", "null" ], "properties": { "documentId": { "description": "The document identifier.", "type": "string" }, "path": { "description": "The normalized document path.", "type": "string" }, "projectId": { "description": "The owning project identifier.", "type": "string" } }, "required": [ "documentId", "path", "projectId" ] }, "span": { "description": "The resolved text span.", "type": [ "object", "null" ], "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } }, "line": { "description": "The one-based line number.", "type": "integer" }, "column": { "description": "The one-based column number.", "type": "integer" }, "snapshot": { "description": "The exact immutable workspace snapshot associated with this location.", "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ] }, "selector": { "description": "The canonical selector that can resolve this source location again.", "type": [ "object", "null" ], "properties": { "span": { "type": "object", "properties": { "document": { "description": "Provide exactly one of path or documentId.", "type": "object", "properties": { "project": { "description": "Disambiguates documents with matching paths or IDs.", "type": [ "object", "null" ], "properties": { "projectId": { "type": [ "string", "null" ] }, "name": { "type": [ "string", "null" ] }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "targetFramework": { "type": [ "string", "null" ] } } }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "documentId": { "description": "Workspace-local document ID.", "type": [ "string", "null" ] } } }, "range": { "description": "Zero-based UTF-16 range.", "type": "object", "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } } }, "required": [ "document", "range" ] } }, "required": [ "span" ] } }, "required": [ "snapshot" ] } }, "required": [ "displayName", "kind" ] }, "location": { "description": "The source location for the candidate.", "type": [ "object", "null" ], "properties": { "document": { "description": "The resolved document.", "$ref": "#/properties/request/properties/value/properties/candidates/properties/items/items/properties/symbol/properties/location/properties/document" }, "span": { "description": "The resolved text span.", "$ref": "#/properties/request/properties/value/properties/candidates/properties/items/items/properties/symbol/properties/location/properties/span" }, "line": { "description": "The one-based line number.", "type": "integer" }, "column": { "description": "The one-based column number.", "type": "integer" }, "snapshot": { "description": "The exact immutable workspace snapshot associated with this location.", "$ref": "#/properties/request/properties/value/properties/candidates/properties/items/items/properties/symbol/properties/location/properties/snapshot" }, "selector": { "description": "The canonical selector that can resolve this source location again.", "$ref": "#/properties/request/properties/value/properties/candidates/properties/items/items/properties/symbol/properties/location/properties/selector" } }, "required": [ "snapshot" ] }, "confidence": { "description": "The confidence label for the candidate.", "type": "string" }, "reasons": { "description": "The reasons the symbol was reported.", "type": "array", "items": { "type": "string" } } }, "required": [ "confidence" ] } }, "hasMore": { "description": "Whether additional items were available beyond this page.", "type": "boolean" }, "totalCount": { "description": "Complete result count, when available without additional expensive work.", "type": [ "integer", "null" ] } } } }, "description": "Tool-specific result payload." }, "snapshot": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ], "description": "Exact immutable workspace snapshot associated with the result, when available." }, "warnings": { "type": "array", "description": "Non-fatal warnings the agent should consider.", "items": { "$ref": "#/$defs/warningInfo" } } } }, "definitions": { "warningInfo": { "type": "object", "properties": { "code": { "description": "The stable machine-readable warning code.", "type": "string" }, "message": { "description": "The human-readable warning message.", "type": "string" } }, "required": [ "code", "message" ] } } }, "format-document": { "variant": { "type": "object", "required": [ "ok", "data", "snapshot" ], "properties": { "ok": { "const": true, "description": "Whether the tool invocation succeeded." }, "data": { "type": "object", "required": [ "staged" ], "properties": { "staged": { "type": "boolean", "description": "Whether the mutation was staged in the active transaction." }, "summary": { "type": [ "string", "null" ], "description": "Summary of the staged mutation, when available." }, "transaction": { "type": [ "object", "null" ], "description": "Transaction state after the mutation, when present.", "required": [ "revision" ], "properties": { "revision": { "type": "integer", "description": "Transaction revision after staging." } } } }, "description": "Tool-specific result payload." }, "snapshot": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ], "description": "Exact immutable workspace snapshot associated with the result, when available." }, "warnings": { "type": "array", "description": "Non-fatal warnings the agent should consider.", "items": { "$ref": "#/$defs/warningInfo" } } } }, "definitions": { "warningInfo": { "type": "object", "properties": { "code": { "description": "The stable machine-readable warning code.", "type": "string" }, "message": { "description": "The human-readable warning message.", "type": "string" } }, "required": [ "code", "message" ] } } }, "get-api-surface": { "variant": { "type": "object", "required": [ "ok", "data", "snapshot" ], "properties": { "ok": { "const": true, "description": "Whether the tool invocation succeeded." }, "data": { "type": [ "object", "null" ], "properties": { "symbols": { "description": "The returned exported API symbols.", "type": "object", "properties": { "items": { "description": "Items returned in this page.", "type": [ "array", "null" ], "items": { "type": "object", "properties": { "symbol": { "description": "The exported symbol.", "type": [ "object", "null" ], "properties": { "displayName": { "description": "The display name of the symbol.", "type": "string" }, "kind": { "description": "The symbol kind.", "type": "string" }, "documentationCommentId": { "description": "The documentation comment identifier, when available.", "type": [ "string", "null" ] }, "location": { "description": "The optional source location of the symbol.", "type": [ "object", "null" ], "properties": { "document": { "description": "The resolved document.", "type": [ "object", "null" ], "properties": { "documentId": { "description": "The document identifier.", "type": "string" }, "path": { "description": "The normalized document path.", "type": "string" }, "projectId": { "description": "The owning project identifier.", "type": "string" } }, "required": [ "documentId", "path", "projectId" ] }, "span": { "description": "The resolved text span.", "type": [ "object", "null" ], "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } }, "line": { "description": "The one-based line number.", "type": "integer" }, "column": { "description": "The one-based column number.", "type": "integer" }, "snapshot": { "description": "The exact immutable workspace snapshot associated with this location.", "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ] }, "selector": { "description": "The canonical selector that can resolve this source location again.", "type": [ "object", "null" ], "properties": { "span": { "type": "object", "properties": { "document": { "description": "Provide exactly one of path or documentId.", "type": "object", "properties": { "project": { "description": "Disambiguates documents with matching paths or IDs.", "type": [ "object", "null" ], "properties": { "projectId": { "type": [ "string", "null" ] }, "name": { "type": [ "string", "null" ] }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "targetFramework": { "type": [ "string", "null" ] } } }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "documentId": { "description": "Workspace-local document ID.", "type": [ "string", "null" ] } } }, "range": { "description": "Zero-based UTF-16 range.", "type": "object", "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } } }, "required": [ "document", "range" ] } }, "required": [ "span" ] } }, "required": [ "snapshot" ] } }, "required": [ "displayName", "kind" ] }, "accessibility": { "description": "The declared accessibility.", "type": "string" }, "isObsolete": { "description": "Whether the symbol is marked obsolete.", "type": "boolean" } }, "required": [ "accessibility" ] } }, "hasMore": { "description": "Whether additional items were available beyond this page.", "type": "boolean" }, "totalCount": { "description": "Complete result count, when available without additional expensive work.", "type": [ "integer", "null" ] } } } }, "description": "Tool-specific result payload." }, "snapshot": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ], "description": "Exact immutable workspace snapshot associated with the result, when available." }, "warnings": { "type": "array", "description": "Non-fatal warnings the agent should consider.", "items": { "$ref": "#/$defs/warningInfo" } } } }, "definitions": { "warningInfo": { "type": "object", "properties": { "code": { "description": "The stable machine-readable warning code.", "type": "string" }, "message": { "description": "The human-readable warning message.", "type": "string" } }, "required": [ "code", "message" ] } } }, "get-change-impact": { "variant": { "type": "object", "required": [ "ok", "data", "snapshot" ], "properties": { "ok": { "const": true, "description": "Whether the tool invocation succeeded." }, "data": { "type": [ "object", "null" ], "properties": { "symbol": { "description": "The queried symbol.", "type": [ "object", "null" ], "properties": { "displayName": { "description": "The display name of the symbol.", "type": "string" }, "kind": { "description": "The symbol kind.", "type": "string" }, "documentationCommentId": { "description": "The documentation comment identifier, when available.", "type": [ "string", "null" ] }, "location": { "description": "The optional source location of the symbol.", "type": [ "object", "null" ], "properties": { "document": { "description": "The resolved document.", "type": [ "object", "null" ], "properties": { "documentId": { "description": "The document identifier.", "type": "string" }, "path": { "description": "The normalized document path.", "type": "string" }, "projectId": { "description": "The owning project identifier.", "type": "string" } }, "required": [ "documentId", "path", "projectId" ] }, "span": { "description": "The resolved text span.", "type": [ "object", "null" ], "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } }, "line": { "description": "The one-based line number.", "type": "integer" }, "column": { "description": "The one-based column number.", "type": "integer" }, "snapshot": { "description": "The exact immutable workspace snapshot associated with this location.", "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ] }, "selector": { "description": "The canonical selector that can resolve this source location again.", "type": [ "object", "null" ], "properties": { "span": { "type": "object", "properties": { "document": { "description": "Provide exactly one of path or documentId.", "type": "object", "properties": { "project": { "description": "Disambiguates documents with matching paths or IDs.", "type": [ "object", "null" ], "properties": { "projectId": { "type": [ "string", "null" ] }, "name": { "type": [ "string", "null" ] }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "targetFramework": { "type": [ "string", "null" ] } } }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "documentId": { "description": "Workspace-local document ID.", "type": [ "string", "null" ] } } }, "range": { "description": "Zero-based UTF-16 range.", "type": "object", "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } } }, "required": [ "document", "range" ] } }, "required": [ "span" ] } }, "required": [ "snapshot" ] } }, "required": [ "displayName", "kind" ] }, "impact": { "description": "The bounded impact summary.", "type": [ "object", "null" ], "properties": { "referenceCount": { "description": "The number of direct source references found.", "type": "integer" }, "callerCount": { "description": "The number of direct callers found.", "type": "integer" }, "overrideCount": { "description": "The number of overrides found.", "type": "integer" }, "implementationCount": { "description": "The number of implementations found.", "type": "integer" }, "publicSurfaceCount": { "description": "The number of directly exposed API surface entries represented by the symbol.", "type": "integer" } } }, "locations": { "description": "The returned supporting source locations.", "type": "object", "properties": { "items": { "description": "Items returned in this page.", "type": [ "array", "null" ], "items": { "type": "object", "properties": { "location": { "description": "The reference location.", "type": [ "object", "null" ], "properties": { "document": { "description": "The resolved document.", "$ref": "#/properties/request/properties/value/properties/symbol/properties/location/properties/document" }, "span": { "description": "The resolved text span.", "$ref": "#/properties/request/properties/value/properties/symbol/properties/location/properties/span" }, "line": { "description": "The one-based line number.", "type": "integer" }, "column": { "description": "The one-based column number.", "type": "integer" }, "snapshot": { "description": "The exact immutable workspace snapshot associated with this location.", "$ref": "#/properties/request/properties/value/properties/symbol/properties/location/properties/snapshot" }, "selector": { "description": "The canonical selector that can resolve this source location again.", "$ref": "#/properties/request/properties/value/properties/symbol/properties/location/properties/selector" } }, "required": [ "snapshot" ] }, "containingSymbol": { "description": "The containing symbol, when available.", "type": [ "object", "null" ], "properties": { "displayName": { "description": "The display name of the symbol.", "type": "string" }, "kind": { "description": "The symbol kind.", "type": "string" }, "documentationCommentId": { "description": "The documentation comment identifier, when available.", "type": [ "string", "null" ] }, "location": { "description": "The optional source location of the symbol.", "$ref": "#/properties/request/properties/value/properties/symbol/properties/location" } }, "required": [ "displayName", "kind" ] }, "isDefinition": { "description": "Whether the location is a definition.", "type": "boolean" }, "isWrite": { "description": "Whether the location represents a write access.", "type": "boolean" }, "context": { "description": "The optional source snippet.", "type": [ "string", "null" ] } } } }, "hasMore": { "description": "Whether additional items were available beyond this page.", "type": "boolean" }, "totalCount": { "description": "Complete result count, when available without additional expensive work.", "type": [ "integer", "null" ] } } } }, "description": "Tool-specific result payload." }, "snapshot": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ], "description": "Exact immutable workspace snapshot associated with the result, when available." }, "warnings": { "type": "array", "description": "Non-fatal warnings the agent should consider.", "items": { "$ref": "#/$defs/warningInfo" } } } }, "definitions": { "warningInfo": { "type": "object", "properties": { "code": { "description": "The stable machine-readable warning code.", "type": "string" }, "message": { "description": "The human-readable warning message.", "type": "string" } }, "required": [ "code", "message" ] } } }, "get-code-context": { "variant": { "type": "object", "required": [ "ok", "data", "snapshot" ], "properties": { "ok": { "const": true, "description": "Whether the tool invocation succeeded." }, "data": { "type": [ "object", "null" ], "properties": { "location": { "description": "The resolved source location.", "type": [ "object", "null" ], "properties": { "document": { "description": "The resolved document.", "type": [ "object", "null" ], "properties": { "documentId": { "description": "The document identifier.", "type": "string" }, "path": { "description": "The normalized document path.", "type": "string" }, "projectId": { "description": "The owning project identifier.", "type": "string" } }, "required": [ "documentId", "path", "projectId" ] }, "span": { "description": "The resolved text span.", "type": [ "object", "null" ], "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } }, "line": { "description": "The one-based line number.", "type": "integer" }, "column": { "description": "The one-based column number.", "type": "integer" }, "snapshot": { "description": "The exact immutable workspace snapshot associated with this location.", "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ] }, "selector": { "description": "The canonical selector that can resolve this source location again.", "type": [ "object", "null" ], "properties": { "span": { "type": "object", "properties": { "document": { "description": "Provide exactly one of path or documentId.", "type": "object", "properties": { "project": { "description": "Disambiguates documents with matching paths or IDs.", "type": [ "object", "null" ], "properties": { "projectId": { "type": [ "string", "null" ] }, "name": { "type": [ "string", "null" ] }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "targetFramework": { "type": [ "string", "null" ] } } }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "documentId": { "description": "Workspace-local document ID.", "type": [ "string", "null" ] } } }, "range": { "description": "Zero-based UTF-16 range.", "type": "object", "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } } }, "required": [ "document", "range" ] } }, "required": [ "span" ] } }, "required": [ "snapshot" ] }, "text": { "description": "The bounded source text.", "type": "string" }, "enclosingSymbols": { "description": "The enclosing symbol chain from the innermost symbol outward.", "type": "object", "properties": { "items": { "description": "Items returned in this page.", "type": [ "array", "null" ], "items": { "type": "object", "properties": { "displayName": { "description": "The display name of the symbol.", "type": "string" }, "kind": { "description": "The symbol kind.", "type": "string" }, "documentationCommentId": { "description": "The documentation comment identifier, when available.", "type": [ "string", "null" ] }, "location": { "description": "The optional source location of the symbol.", "type": [ "object", "null" ], "properties": { "document": { "description": "The resolved document.", "$ref": "#/properties/request/properties/value/properties/location/properties/document" }, "span": { "description": "The resolved text span.", "$ref": "#/properties/request/properties/value/properties/location/properties/span" }, "line": { "description": "The one-based line number.", "type": "integer" }, "column": { "description": "The one-based column number.", "type": "integer" }, "snapshot": { "description": "The exact immutable workspace snapshot associated with this location.", "$ref": "#/properties/request/properties/value/properties/location/properties/snapshot" }, "selector": { "description": "The canonical selector that can resolve this source location again.", "$ref": "#/properties/request/properties/value/properties/location/properties/selector" } }, "required": [ "snapshot" ] } }, "required": [ "displayName", "kind" ] } }, "hasMore": { "description": "Whether additional items were available beyond this page.", "type": "boolean" }, "totalCount": { "description": "Complete result count, when available without additional expensive work.", "type": [ "integer", "null" ] } } }, "diagnostics": { "description": "The diagnostics projected for the selected location.", "type": "object", "properties": { "items": { "description": "Items returned in this page.", "type": [ "array", "null" ], "items": { "type": "object", "properties": { "id": { "description": "The diagnostic identifier.", "type": "string" }, "severity": { "description": "The diagnostic severity.", "type": "string", "enum": [ "Hidden", "Info", "Warning", "Error" ] }, "message": { "description": "The diagnostic message.", "type": "string" }, "location": { "description": "The optional source location of the diagnostic.", "type": [ "object", "null" ], "properties": { "document": { "description": "The resolved document.", "$ref": "#/properties/request/properties/value/properties/location/properties/document" }, "span": { "description": "The resolved text span.", "$ref": "#/properties/request/properties/value/properties/location/properties/span" }, "line": { "description": "The one-based line number.", "type": "integer" }, "column": { "description": "The one-based column number.", "type": "integer" }, "snapshot": { "description": "The exact immutable workspace snapshot associated with this location.", "$ref": "#/properties/request/properties/value/properties/location/properties/snapshot" }, "selector": { "description": "The canonical selector that can resolve this source location again.", "$ref": "#/properties/request/properties/value/properties/location/properties/selector" } }, "required": [ "snapshot" ] } }, "required": [ "id", "message" ] } }, "hasMore": { "description": "Whether additional items were available beyond this page.", "type": "boolean" }, "totalCount": { "description": "Complete result count, when available without additional expensive work.", "type": [ "integer", "null" ] } } } }, "description": "Tool-specific result payload." }, "snapshot": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ], "description": "Exact immutable workspace snapshot associated with the result, when available." }, "warnings": { "type": "array", "description": "Non-fatal warnings the agent should consider.", "items": { "$ref": "#/$defs/warningInfo" } } } }, "definitions": { "warningInfo": { "type": "object", "properties": { "code": { "description": "The stable machine-readable warning code.", "type": "string" }, "message": { "description": "The human-readable warning message.", "type": "string" } }, "required": [ "code", "message" ] } } }, "get-control-flow-graph": { "variant": { "type": "object", "required": [ "ok", "data", "snapshot" ], "properties": { "ok": { "const": true, "description": "Whether the tool invocation succeeded." }, "data": { "type": [ "object", "null" ], "properties": { "owner": { "description": "The owning callable symbol.", "type": [ "object", "null" ], "properties": { "displayName": { "description": "The display name of the symbol.", "type": "string" }, "kind": { "description": "The symbol kind.", "type": "string" }, "documentationCommentId": { "description": "The documentation comment identifier, when available.", "type": [ "string", "null" ] }, "location": { "description": "The optional source location of the symbol.", "type": [ "object", "null" ], "properties": { "document": { "description": "The resolved document.", "type": [ "object", "null" ], "properties": { "documentId": { "description": "The document identifier.", "type": "string" }, "path": { "description": "The normalized document path.", "type": "string" }, "projectId": { "description": "The owning project identifier.", "type": "string" } }, "required": [ "documentId", "path", "projectId" ] }, "span": { "description": "The resolved text span.", "type": [ "object", "null" ], "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } }, "line": { "description": "The one-based line number.", "type": "integer" }, "column": { "description": "The one-based column number.", "type": "integer" }, "snapshot": { "description": "The exact immutable workspace snapshot associated with this location.", "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ] }, "selector": { "description": "The canonical selector that can resolve this source location again.", "type": [ "object", "null" ], "properties": { "span": { "type": "object", "properties": { "document": { "description": "Provide exactly one of path or documentId.", "type": "object", "properties": { "project": { "description": "Disambiguates documents with matching paths or IDs.", "type": [ "object", "null" ], "properties": { "projectId": { "type": [ "string", "null" ] }, "name": { "type": [ "string", "null" ] }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "targetFramework": { "type": [ "string", "null" ] } } }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "documentId": { "description": "Workspace-local document ID.", "type": [ "string", "null" ] } } }, "range": { "description": "Zero-based UTF-16 range.", "type": "object", "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } } }, "required": [ "document", "range" ] } }, "required": [ "span" ] } }, "required": [ "snapshot" ] } }, "required": [ "displayName", "kind" ] }, "blocks": { "description": "The projected basic blocks.", "type": "object", "properties": { "items": { "description": "Items returned in this page.", "type": [ "array", "null" ], "items": { "type": "object", "properties": { "ordinal": { "description": "The block ordinal.", "type": "integer" }, "kind": { "description": "The Roslyn block kind.", "type": "string" }, "isReachable": { "description": "Whether the block is reachable.", "type": "boolean" }, "operations": { "description": "The projected operations in the block.", "type": "object", "properties": { "items": { "description": "Items returned in this page.", "type": [ "array", "null" ], "items": { "type": "object", "properties": { "kind": { "description": "The Roslyn operation kind.", "type": "string" }, "type": { "description": "The operation type display name, when available.", "type": [ "string", "null" ] }, "location": { "description": "The exact source location of the operation.", "type": [ "object", "null" ], "properties": { "document": { "description": "The resolved document.", "$ref": "#/properties/request/properties/value/properties/owner/properties/location/properties/document" }, "span": { "description": "The resolved text span.", "$ref": "#/properties/request/properties/value/properties/owner/properties/location/properties/span" }, "line": { "description": "The one-based line number.", "type": "integer" }, "column": { "description": "The one-based column number.", "type": "integer" }, "snapshot": { "description": "The exact immutable workspace snapshot associated with this location.", "$ref": "#/properties/request/properties/value/properties/owner/properties/location/properties/snapshot" }, "selector": { "description": "The canonical selector that can resolve this source location again.", "$ref": "#/properties/request/properties/value/properties/owner/properties/location/properties/selector" } }, "required": [ "snapshot" ] } }, "required": [ "kind" ] } }, "hasMore": { "description": "Whether additional items were available beyond this page.", "type": "boolean" }, "totalCount": { "description": "Complete result count, when available without additional expensive work.", "type": [ "integer", "null" ] } } }, "fallThroughSuccessor": { "description": "The fall-through successor ordinal, when available.", "type": [ "integer", "null" ] }, "conditionalSuccessor": { "description": "The conditional successor ordinal, when available.", "type": [ "integer", "null" ] } }, "required": [ "kind" ] } }, "hasMore": { "description": "Whether additional items were available beyond this page.", "type": "boolean" }, "totalCount": { "description": "Complete result count, when available without additional expensive work.", "type": [ "integer", "null" ] } } }, "regions": { "description": "The projected flow regions.", "type": "object", "properties": { "items": { "description": "Items returned in this page.", "type": [ "array", "null" ], "items": { "type": "object", "properties": { "id": { "description": "The region identifier.", "type": "integer" }, "kind": { "description": "The region kind.", "type": "string" }, "firstBlockOrdinal": { "description": "The first block ordinal in the region.", "type": "integer" }, "lastBlockOrdinal": { "description": "The last block ordinal in the region.", "type": "integer" } }, "required": [ "kind" ] } }, "hasMore": { "description": "Whether additional items were available beyond this page.", "type": "boolean" }, "totalCount": { "description": "Complete result count, when available without additional expensive work.", "type": [ "integer", "null" ] } } } }, "description": "Tool-specific result payload." }, "snapshot": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ], "description": "Exact immutable workspace snapshot associated with the result, when available." }, "warnings": { "type": "array", "description": "Non-fatal warnings the agent should consider.", "items": { "$ref": "#/$defs/warningInfo" } } } }, "definitions": { "warningInfo": { "type": "object", "properties": { "code": { "description": "The stable machine-readable warning code.", "type": "string" }, "message": { "description": "The human-readable warning message.", "type": "string" } }, "required": [ "code", "message" ] } } }, "get-dependency-graph": { "variant": { "type": "object", "required": [ "ok", "data", "snapshot" ], "properties": { "ok": { "const": true, "description": "Whether the tool invocation succeeded." }, "data": { "type": [ "object", "null" ], "properties": { "nodes": { "description": "The returned graph nodes.", "type": "object", "properties": { "items": { "description": "Items returned in this page.", "type": [ "array", "null" ], "items": { "type": "object", "properties": { "id": { "type": "string" }, "kind": { "type": "string" }, "displayName": { "type": "string" }, "symbol": { "type": [ "object", "null" ], "properties": { "displayName": { "description": "The display name of the symbol.", "type": "string" }, "kind": { "description": "The symbol kind.", "type": "string" }, "documentationCommentId": { "description": "The documentation comment identifier, when available.", "type": [ "string", "null" ] }, "location": { "description": "The optional source location of the symbol.", "type": [ "object", "null" ], "properties": { "document": { "description": "The resolved document.", "type": [ "object", "null" ], "properties": { "documentId": { "description": "The document identifier.", "type": "string" }, "path": { "description": "The normalized document path.", "type": "string" }, "projectId": { "description": "The owning project identifier.", "type": "string" } }, "required": [ "documentId", "path", "projectId" ] }, "span": { "description": "The resolved text span.", "type": [ "object", "null" ], "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } }, "line": { "description": "The one-based line number.", "type": "integer" }, "column": { "description": "The one-based column number.", "type": "integer" }, "snapshot": { "description": "The exact immutable workspace snapshot associated with this location.", "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ] }, "selector": { "description": "The canonical selector that can resolve this source location again.", "type": [ "object", "null" ], "properties": { "span": { "type": "object", "properties": { "document": { "description": "Provide exactly one of path or documentId.", "type": "object", "properties": { "project": { "description": "Disambiguates documents with matching paths or IDs.", "type": [ "object", "null" ], "properties": { "projectId": { "type": [ "string", "null" ] }, "name": { "type": [ "string", "null" ] }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "targetFramework": { "type": [ "string", "null" ] } } }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "documentId": { "description": "Workspace-local document ID.", "type": [ "string", "null" ] } } }, "range": { "description": "Zero-based UTF-16 range.", "type": "object", "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } } }, "required": [ "document", "range" ] } }, "required": [ "span" ] } }, "required": [ "snapshot" ] } }, "required": [ "displayName", "kind" ] } }, "required": [ "id", "kind", "displayName" ] } }, "hasMore": { "description": "Whether additional items were available beyond this page.", "type": "boolean" }, "totalCount": { "description": "Complete result count, when available without additional expensive work.", "type": [ "integer", "null" ] } } }, "edges": { "description": "The returned graph edges.", "type": "object", "properties": { "items": { "description": "Items returned in this page.", "type": [ "array", "null" ], "items": { "type": "object", "properties": { "fromId": { "type": "string" }, "fromDisplayName": { "type": "string" }, "toId": { "type": "string" }, "toDisplayName": { "type": "string" }, "kind": { "type": "string" } }, "required": [ "fromId", "fromDisplayName", "toId", "toDisplayName", "kind" ] } }, "hasMore": { "description": "Whether additional items were available beyond this page.", "type": "boolean" }, "totalCount": { "description": "Complete result count, when available without additional expensive work.", "type": [ "integer", "null" ] } } } }, "description": "Tool-specific result payload." }, "snapshot": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ], "description": "Exact immutable workspace snapshot associated with the result, when available." }, "warnings": { "type": "array", "description": "Non-fatal warnings the agent should consider.", "items": { "$ref": "#/$defs/warningInfo" } } } }, "definitions": { "warningInfo": { "type": "object", "properties": { "code": { "description": "The stable machine-readable warning code.", "type": "string" }, "message": { "description": "The human-readable warning message.", "type": "string" } }, "required": [ "code", "message" ] } } }, "get-diagnostics": { "variant": { "type": "object", "required": [ "ok", "data", "snapshot" ], "properties": { "ok": { "const": true, "description": "Whether the tool invocation succeeded." }, "data": { "type": [ "object", "null" ], "properties": { "diagnostics": { "description": "The returned diagnostics.", "type": "object", "properties": { "items": { "description": "Items returned in this page.", "type": [ "array", "null" ], "items": { "type": "object", "properties": { "id": { "description": "The diagnostic identifier.", "type": "string" }, "severity": { "description": "The diagnostic severity.", "type": "string", "enum": [ "Hidden", "Info", "Warning", "Error" ] }, "message": { "description": "The diagnostic message.", "type": "string" }, "location": { "description": "The optional source location of the diagnostic.", "type": [ "object", "null" ], "properties": { "document": { "description": "The resolved document.", "type": [ "object", "null" ], "properties": { "documentId": { "description": "The document identifier.", "type": "string" }, "path": { "description": "The normalized document path.", "type": "string" }, "projectId": { "description": "The owning project identifier.", "type": "string" } }, "required": [ "documentId", "path", "projectId" ] }, "span": { "description": "The resolved text span.", "type": [ "object", "null" ], "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } }, "line": { "description": "The one-based line number.", "type": "integer" }, "column": { "description": "The one-based column number.", "type": "integer" }, "snapshot": { "description": "The exact immutable workspace snapshot associated with this location.", "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ] }, "selector": { "description": "The canonical selector that can resolve this source location again.", "type": [ "object", "null" ], "properties": { "span": { "type": "object", "properties": { "document": { "description": "Provide exactly one of path or documentId.", "type": "object", "properties": { "project": { "description": "Disambiguates documents with matching paths or IDs.", "type": [ "object", "null" ], "properties": { "projectId": { "type": [ "string", "null" ] }, "name": { "type": [ "string", "null" ] }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "targetFramework": { "type": [ "string", "null" ] } } }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "documentId": { "description": "Workspace-local document ID.", "type": [ "string", "null" ] } } }, "range": { "description": "Zero-based UTF-16 range.", "type": "object", "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } } }, "required": [ "document", "range" ] } }, "required": [ "span" ] } }, "required": [ "snapshot" ] } }, "required": [ "id", "message" ] } }, "hasMore": { "description": "Whether additional items were available beyond this page.", "type": "boolean" }, "totalCount": { "description": "Complete result count, when available without additional expensive work.", "type": [ "integer", "null" ] } } } }, "description": "Tool-specific result payload." }, "snapshot": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ], "description": "Exact immutable workspace snapshot associated with the result, when available." }, "warnings": { "type": "array", "description": "Non-fatal warnings the agent should consider.", "items": { "$ref": "#/$defs/warningInfo" } } } }, "definitions": { "warningInfo": { "type": "object", "properties": { "code": { "description": "The stable machine-readable warning code.", "type": "string" }, "message": { "description": "The human-readable warning message.", "type": "string" } }, "required": [ "code", "message" ] } } }, "get-document-options": { "variant": { "type": "object", "required": [ "ok", "data", "snapshot" ], "properties": { "ok": { "const": true, "description": "Whether the tool invocation succeeded." }, "data": { "type": [ "object", "null" ], "properties": { "document": { "description": "The resolved document reference.", "type": [ "object", "null" ], "properties": { "documentId": { "description": "The document identifier.", "type": "string" }, "path": { "description": "The normalized document path.", "type": "string" }, "projectId": { "description": "The owning project identifier.", "type": "string" } }, "required": [ "documentId", "path", "projectId" ] }, "languageVersion": { "description": "The effective language version, when available for the document language.", "type": [ "string", "null" ] }, "nullableContext": { "description": "The effective nullable context, when available for the document language.", "type": [ "string", "null" ] }, "parseOptions": { "description": "The effective parse options.", "type": [ "object", "null" ], "properties": { "language": { "description": "The language name.", "type": "string" }, "languageVersion": { "description": "The language version, when available for the project language.", "type": [ "string", "null" ] }, "documentationMode": { "description": "The documentation mode.", "type": "string" }, "preprocessorSymbols": { "description": "The effective preprocessor symbols.", "type": "array", "items": { "type": "string" } } }, "required": [ "language", "documentationMode" ] }, "analyzerConfig": { "description": "The effective analyzer-config information.", "type": [ "object", "null" ], "properties": { "globalConfigPaths": { "description": "The global analyzer-config file paths applied to the document.", "type": "array", "items": { "type": "string" } }, "editorConfigPaths": { "description": "The editor-config file paths applied to the document.", "type": "array", "items": { "type": "string" } }, "options": { "description": "The effective analyzer-config options for the document.", "type": "object", "additionalProperties": { "type": "string" } } } } }, "description": "Tool-specific result payload." }, "snapshot": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ], "description": "Exact immutable workspace snapshot associated with the result, when available." }, "warnings": { "type": "array", "description": "Non-fatal warnings the agent should consider.", "items": { "$ref": "#/$defs/warningInfo" } } } }, "definitions": { "warningInfo": { "type": "object", "properties": { "code": { "description": "The stable machine-readable warning code.", "type": "string" }, "message": { "description": "The human-readable warning message.", "type": "string" } }, "required": [ "code", "message" ] } } }, "get-document-outline": { "variant": { "type": "object", "required": [ "ok", "data", "snapshot" ], "properties": { "ok": { "const": true, "description": "Whether the tool invocation succeeded." }, "data": { "type": [ "object", "null" ], "properties": { "document": { "description": "The resolved document reference.", "type": [ "object", "null" ], "properties": { "documentId": { "description": "The document identifier.", "type": "string" }, "path": { "description": "The normalized document path.", "type": "string" }, "projectId": { "description": "The owning project identifier.", "type": "string" } }, "required": [ "documentId", "path", "projectId" ] }, "root": { "description": "The outline root node.", "type": [ "object", "null" ], "properties": { "name": { "description": "The node display name.", "type": "string" }, "kind": { "description": "The Roslyn symbol or declaration kind.", "type": "string" }, "accessibility": { "description": "The optional accessibility.", "type": [ "string", "null" ] }, "modifiers": { "description": "The node modifiers.", "type": "array", "items": { "type": "string" } }, "location": { "description": "The node location, when available.", "type": [ "object", "null" ], "properties": { "document": { "description": "The resolved document.", "type": [ "object", "null" ], "properties": { "documentId": { "description": "The document identifier.", "type": "string" }, "path": { "description": "The normalized document path.", "type": "string" }, "projectId": { "description": "The owning project identifier.", "type": "string" } }, "required": [ "documentId", "path", "projectId" ] }, "span": { "description": "The resolved text span.", "type": [ "object", "null" ], "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } }, "line": { "description": "The one-based line number.", "type": "integer" }, "column": { "description": "The one-based column number.", "type": "integer" }, "snapshot": { "description": "The exact immutable workspace snapshot associated with this location.", "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ] }, "selector": { "description": "The canonical selector that can resolve this source location again.", "type": [ "object", "null" ], "properties": { "span": { "type": "object", "properties": { "document": { "description": "Provide exactly one of path or documentId.", "type": "object", "properties": { "project": { "description": "Disambiguates documents with matching paths or IDs.", "type": [ "object", "null" ], "properties": { "projectId": { "type": [ "string", "null" ] }, "name": { "type": [ "string", "null" ] }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "targetFramework": { "type": [ "string", "null" ] } } }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "documentId": { "description": "Workspace-local document ID.", "type": [ "string", "null" ] } } }, "range": { "description": "Zero-based UTF-16 range.", "type": "object", "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } } }, "required": [ "document", "range" ] } }, "required": [ "span" ] } }, "required": [ "snapshot" ] }, "children": { "description": "The child outline nodes.", "type": "array", "items": { "type": "object", "properties": { "name": { "description": "The node display name.", "type": "string" }, "kind": { "description": "The Roslyn symbol or declaration kind.", "type": "string" }, "accessibility": { "description": "The optional accessibility.", "type": [ "string", "null" ] }, "modifiers": { "description": "The node modifiers.", "$ref": "#/properties/request/properties/value/properties/root/properties/modifiers", "items": {} }, "location": { "description": "The node location, when available.", "$ref": "#/properties/request/properties/value/properties/root/properties/location" }, "children": { "description": "The child outline nodes.", "$ref": "#/properties/request/properties/value/properties/root/properties/children", "items": {} } }, "required": [ "name", "kind" ] } } }, "required": [ "name", "kind" ] }, "truncated": { "description": "Whether the hierarchy was truncated by its node or depth bound.", "type": "boolean" } }, "description": "Tool-specific result payload." }, "snapshot": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ], "description": "Exact immutable workspace snapshot associated with the result, when available." }, "warnings": { "type": "array", "description": "Non-fatal warnings the agent should consider.", "items": { "$ref": "#/$defs/warningInfo" } } } }, "definitions": { "warningInfo": { "type": "object", "properties": { "code": { "description": "The stable machine-readable warning code.", "type": "string" }, "message": { "description": "The human-readable warning message.", "type": "string" } }, "required": [ "code", "message" ] } } }, "get-error-details": { "variant": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "const": true, "description": "Whether the tool invocation succeeded." }, "data": { "type": [ "object", "null" ], "properties": { "sensitivity": { "description": "Sensitivity classification applied to the captured error details.", "type": "string" }, "safeForExternalSubmission": { "description": "Whether the captured details are safe to submit outside the local process.", "type": "boolean" }, "error": { "description": "Captured diagnostic record for the failed tool invocation.", "type": "object", "properties": { "correlationId": { "description": "Correlation identifier assigned to the captured failure.", "type": "string", "format": "uuid" }, "failureTime": { "description": "Time at which the tool invocation failed.", "type": "string", "format": "date-time" }, "expiresAt": { "description": "Time at which this locally retained error record expires.", "type": "string", "format": "date-time" }, "toolName": { "description": "MCP tool that failed.", "type": "string" }, "executionFamily": { "description": "Execution path used by the failed tool, such as server, plugin, or Code Action.", "type": "string" }, "pluginClassification": { "description": "Plugin ownership classification when the failed tool was plugin-backed.", "type": "string" }, "durationMilliseconds": { "description": "Tool execution duration in milliseconds before failure.", "type": "integer" }, "cancellationRequested": { "description": "Whether cancellation had been requested when the failure occurred.", "type": "boolean" }, "exceptions": { "description": "Captured exception chain for the failure.", "type": "array", "items": { "type": "object", "properties": { "component": { "description": "Roslyn Workbench component in which the exception originated.", "type": "string", "enum": [ "Unknown", "RoslynWorkbench", "Roslyn", "DotNet" ] }, "type": { "description": "Exception type name.", "type": "string" }, "message": { "description": "Exception message included with the user\u0027s consent.", "type": "string" }, "stackFrames": { "description": "Diagnostic stack frames retained from the exception and classified by owning component.", "type": "array", "items": { "type": "object", "properties": { "component": { "description": "Roslyn Workbench component that owns this frame.", "type": "string", "enum": [ "Unknown", "RoslynWorkbench", "Roslyn", "DotNet" ] }, "assembly": { "description": "Assembly name, when available.", "type": [ "string", "null" ] }, "type": { "description": "Declaring type name, when available.", "type": [ "string", "null" ] }, "method": { "description": "Method name, when available.", "type": [ "string", "null" ] }, "file": { "description": "First-party source file path recorded by symbols, when available.", "type": [ "string", "null" ] }, "line": { "description": "One-based source line number, when available.", "type": [ "integer", "null" ] } } } } }, "required": [ "type", "message" ] } }, "workspace": { "description": "Workspace context active during the failure, when available.", "type": [ "object", "null" ], "properties": { "workspaceId": { "description": "Server-generated identifier of the workspace active during the failure.", "type": "string", "format": "uuid" }, "workspaceEpoch": { "description": "Workspace epoch active during the failure.", "type": "integer" }, "lifecycleState": { "description": "Workspace lifecycle state at the time of failure.", "type": [ "string", "null" ] }, "projectCount": { "description": "Number of loaded projects at the time of failure.", "type": "integer" }, "documentCount": { "description": "Number of loaded documents at the time of failure.", "type": "integer" }, "transactionRevision": { "description": "Active transaction revision at the time of failure, when applicable.", "type": [ "integer", "null" ] } } }, "serverVersion": { "description": "Roslyn Workbench server version that captured the failure.", "type": "string" }, "roslynVersion": { "description": "Roslyn version used by the server.", "type": "string" }, "dotNetVersion": { "description": ".NET runtime version used by the server.", "type": "string" }, "operatingSystem": { "description": "Operating system on which the server was running.", "type": "string" }, "processorArchitecture": { "description": "Processor architecture of the server process.", "type": "string" } }, "required": [ "correlationId", "failureTime", "expiresAt", "toolName", "executionFamily", "pluginClassification", "durationMilliseconds", "serverVersion", "roslynVersion", "dotNetVersion", "operatingSystem", "processorArchitecture" ] } }, "required": [ "error" ], "description": "Tool-specific result payload." }, "snapshot": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ], "description": "Exact immutable workspace snapshot associated with the result, when available." }, "warnings": { "type": "array", "description": "Non-fatal warnings the agent should consider.", "items": { "$ref": "#/$defs/warningInfo" } } } }, "definitions": { "warningInfo": { "type": "object", "properties": { "code": { "description": "The stable machine-readable warning code.", "type": "string" }, "message": { "description": "The human-readable warning message.", "type": "string" } }, "required": [ "code", "message" ] } } }, "get-operation-tree": { "variant": { "type": "object", "required": [ "ok", "data", "snapshot" ], "properties": { "ok": { "const": true, "description": "Whether the tool invocation succeeded." }, "data": { "type": [ "object", "null" ], "properties": { "root": { "description": "The projected root operation.", "type": [ "object", "null" ], "properties": { "kind": { "description": "The Roslyn operation kind.", "type": "string" }, "type": { "description": "The associated type display name, when available.", "type": [ "string", "null" ] }, "hasConstantValue": { "description": "Whether the operation has a constant value.", "type": "boolean" }, "location": { "description": "The exact source location of the operation.", "type": [ "object", "null" ], "properties": { "document": { "description": "The resolved document.", "type": [ "object", "null" ], "properties": { "documentId": { "description": "The document identifier.", "type": "string" }, "path": { "description": "The normalized document path.", "type": "string" }, "projectId": { "description": "The owning project identifier.", "type": "string" } }, "required": [ "documentId", "path", "projectId" ] }, "span": { "description": "The resolved text span.", "type": [ "object", "null" ], "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } }, "line": { "description": "The one-based line number.", "type": "integer" }, "column": { "description": "The one-based column number.", "type": "integer" }, "snapshot": { "description": "The exact immutable workspace snapshot associated with this location.", "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ] }, "selector": { "description": "The canonical selector that can resolve this source location again.", "type": [ "object", "null" ], "properties": { "span": { "type": "object", "properties": { "document": { "description": "Provide exactly one of path or documentId.", "type": "object", "properties": { "project": { "description": "Disambiguates documents with matching paths or IDs.", "type": [ "object", "null" ], "properties": { "projectId": { "type": [ "string", "null" ] }, "name": { "type": [ "string", "null" ] }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "targetFramework": { "type": [ "string", "null" ] } } }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "documentId": { "description": "Workspace-local document ID.", "type": [ "string", "null" ] } } }, "range": { "description": "Zero-based UTF-16 range.", "type": "object", "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } } }, "required": [ "document", "range" ] } }, "required": [ "span" ] } }, "required": [ "snapshot" ] }, "truncated": { "description": "Whether child nodes were truncated.", "type": "boolean" }, "children": { "description": "The projected child operations.", "type": "array", "items": { "type": "object", "properties": { "kind": { "description": "The Roslyn operation kind.", "type": "string" }, "type": { "description": "The associated type display name, when available.", "type": [ "string", "null" ] }, "hasConstantValue": { "description": "Whether the operation has a constant value.", "type": "boolean" }, "location": { "description": "The exact source location of the operation.", "$ref": "#/properties/request/properties/value/properties/root/properties/location" }, "truncated": { "description": "Whether child nodes were truncated.", "type": "boolean" }, "children": { "description": "The projected child operations.", "$ref": "#/properties/request/properties/value/properties/root/properties/children", "items": {} } }, "required": [ "kind" ] } } }, "required": [ "kind" ] }, "truncated": { "description": "Whether the tree was truncated.", "type": "boolean" } }, "description": "Tool-specific result payload." }, "snapshot": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ], "description": "Exact immutable workspace snapshot associated with the result, when available." }, "warnings": { "type": "array", "description": "Non-fatal warnings the agent should consider.", "items": { "$ref": "#/$defs/warningInfo" } } } }, "definitions": { "warningInfo": { "type": "object", "properties": { "code": { "description": "The stable machine-readable warning code.", "type": "string" }, "message": { "description": "The human-readable warning message.", "type": "string" } }, "required": [ "code", "message" ] } } }, "get-partial-declarations": { "variant": { "type": "object", "required": [ "ok", "data", "snapshot" ], "properties": { "ok": { "const": true, "description": "Whether the tool invocation succeeded." }, "data": { "type": [ "object", "null" ], "properties": { "symbol": { "description": "The queried symbol.", "type": [ "object", "null" ], "properties": { "displayName": { "description": "The display name of the symbol.", "type": "string" }, "kind": { "description": "The symbol kind.", "type": "string" }, "documentationCommentId": { "description": "The documentation comment identifier, when available.", "type": [ "string", "null" ] }, "location": { "description": "The optional source location of the symbol.", "type": [ "object", "null" ], "properties": { "document": { "description": "The resolved document.", "type": [ "object", "null" ], "properties": { "documentId": { "description": "The document identifier.", "type": "string" }, "path": { "description": "The normalized document path.", "type": "string" }, "projectId": { "description": "The owning project identifier.", "type": "string" } }, "required": [ "documentId", "path", "projectId" ] }, "span": { "description": "The resolved text span.", "type": [ "object", "null" ], "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } }, "line": { "description": "The one-based line number.", "type": "integer" }, "column": { "description": "The one-based column number.", "type": "integer" }, "snapshot": { "description": "The exact immutable workspace snapshot associated with this location.", "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ] }, "selector": { "description": "The canonical selector that can resolve this source location again.", "type": [ "object", "null" ], "properties": { "span": { "type": "object", "properties": { "document": { "description": "Provide exactly one of path or documentId.", "type": "object", "properties": { "project": { "description": "Disambiguates documents with matching paths or IDs.", "type": [ "object", "null" ], "properties": { "projectId": { "type": [ "string", "null" ] }, "name": { "type": [ "string", "null" ] }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "targetFramework": { "type": [ "string", "null" ] } } }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "documentId": { "description": "Workspace-local document ID.", "type": [ "string", "null" ] } } }, "range": { "description": "Zero-based UTF-16 range.", "type": "object", "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } } }, "required": [ "document", "range" ] } }, "required": [ "span" ] } }, "required": [ "snapshot" ] } }, "required": [ "displayName", "kind" ] }, "declarations": { "description": "The resolved declarations.", "type": "object", "properties": { "items": { "description": "Items returned in this page.", "type": [ "array", "null" ], "items": { "type": "object", "properties": { "document": { "description": "The resolved document.", "$ref": "#/properties/request/properties/value/properties/symbol/properties/location/properties/document" }, "span": { "description": "The resolved text span.", "$ref": "#/properties/request/properties/value/properties/symbol/properties/location/properties/span" }, "line": { "description": "The one-based line number.", "type": "integer" }, "column": { "description": "The one-based column number.", "type": "integer" }, "snapshot": { "description": "The exact immutable workspace snapshot associated with this location.", "$ref": "#/properties/request/properties/value/properties/symbol/properties/location/properties/snapshot" }, "selector": { "description": "The canonical selector that can resolve this source location again.", "$ref": "#/properties/request/properties/value/properties/symbol/properties/location/properties/selector" } }, "required": [ "snapshot" ] } }, "hasMore": { "description": "Whether additional items were available beyond this page.", "type": "boolean" }, "totalCount": { "description": "Complete result count, when available without additional expensive work.", "type": [ "integer", "null" ] } } } }, "description": "Tool-specific result payload." }, "snapshot": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ], "description": "Exact immutable workspace snapshot associated with the result, when available." }, "warnings": { "type": "array", "description": "Non-fatal warnings the agent should consider.", "items": { "$ref": "#/$defs/warningInfo" } } } }, "definitions": { "warningInfo": { "type": "object", "properties": { "code": { "description": "The stable machine-readable warning code.", "type": "string" }, "message": { "description": "The human-readable warning message.", "type": "string" } }, "required": [ "code", "message" ] } } }, "get-project-details": { "variant": { "type": "object", "required": [ "ok", "data", "snapshot" ], "properties": { "ok": { "const": true, "description": "Whether the tool invocation succeeded." }, "data": { "type": [ "object", "null" ], "properties": { "project": { "description": "The selected project information.", "type": [ "object", "null" ], "properties": { "projectId": { "description": "The project identifier.", "type": "string" }, "name": { "description": "The project name.", "type": "string" }, "path": { "description": "The project path.", "type": "string" }, "assemblyName": { "description": "The assembly name, when available.", "type": [ "string", "null" ] }, "language": { "description": "The project language.", "type": "string" }, "targetFrameworks": { "description": "The target frameworks inferred for the project.", "type": "array", "items": { "type": "string" } } }, "required": [ "projectId", "name", "path", "language" ] }, "documents": { "description": "The project documents, when included.", "type": [ "object", "null" ], "properties": { "items": { "description": "Items returned in this page.", "type": [ "array", "null" ], "items": { "type": "object", "properties": { "documentId": { "description": "The document identifier.", "type": "string" }, "path": { "description": "The normalized document path.", "type": "string" }, "projectId": { "description": "The owning project identifier.", "type": "string" } }, "required": [ "documentId", "path", "projectId" ] } }, "hasMore": { "description": "Whether additional items were available beyond this page.", "type": "boolean" }, "totalCount": { "description": "Complete result count, when available without additional expensive work.", "type": [ "integer", "null" ] } } }, "projectReferences": { "description": "The direct project references.", "type": "object", "properties": { "items": { "description": "Items returned in this page.", "type": [ "array", "null" ], "items": { "type": "object", "properties": { "projectId": { "description": "The referenced project identifier.", "type": "string" }, "name": { "description": "The referenced project name.", "type": "string" }, "path": { "description": "The referenced project path.", "type": "string" } }, "required": [ "projectId", "name", "path" ] } }, "hasMore": { "description": "Whether additional items were available beyond this page.", "type": "boolean" }, "totalCount": { "description": "Complete result count, when available without additional expensive work.", "type": [ "integer", "null" ] } } }, "metadataReferences": { "description": "The metadata references.", "type": "object", "properties": { "items": { "description": "Items returned in this page.", "type": [ "array", "null" ], "items": { "type": "object", "properties": { "display": { "description": "The display string for the metadata reference.", "type": "string" }, "path": { "description": "The file path, when available.", "type": [ "string", "null" ] } }, "required": [ "display" ] } }, "hasMore": { "description": "Whether additional items were available beyond this page.", "type": "boolean" }, "totalCount": { "description": "Complete result count, when available without additional expensive work.", "type": [ "integer", "null" ] } } }, "analyzers": { "description": "The analyzer references.", "type": "object", "properties": { "items": { "description": "Items returned in this page.", "type": [ "array", "null" ], "items": { "type": "object", "properties": { "displayName": { "description": "The analyzer display name.", "type": "string" }, "path": { "description": "The analyzer assembly path, when available.", "type": [ "string", "null" ] } }, "required": [ "displayName" ] } }, "hasMore": { "description": "Whether additional items were available beyond this page.", "type": "boolean" }, "totalCount": { "description": "Complete result count, when available without additional expensive work.", "type": [ "integer", "null" ] } } }, "compilationOptions": { "description": "The compilation options, when available.", "type": [ "object", "null" ], "properties": { "outputKind": { "description": "The output kind.", "type": "string" }, "nullableContext": { "description": "The nullable context mode.", "type": [ "string", "null" ] }, "allowUnsafe": { "description": "Whether unsafe code is allowed.", "type": "boolean" }, "optimizationLevel": { "description": "The optimization level.", "type": "string" }, "warningLevel": { "description": "The warning level.", "type": "integer" }, "preprocessorSymbols": { "description": "The effective preprocessor symbols.", "type": "array", "items": { "type": "string" } } }, "required": [ "outputKind", "optimizationLevel" ] } }, "description": "Tool-specific result payload." }, "snapshot": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ], "description": "Exact immutable workspace snapshot associated with the result, when available." }, "warnings": { "type": "array", "description": "Non-fatal warnings the agent should consider.", "items": { "$ref": "#/$defs/warningInfo" } } } }, "definitions": { "warningInfo": { "type": "object", "properties": { "code": { "description": "The stable machine-readable warning code.", "type": "string" }, "message": { "description": "The human-readable warning message.", "type": "string" } }, "required": [ "code", "message" ] } } }, "get-solution-structure": { "variant": { "type": "object", "required": [ "ok", "data", "snapshot" ], "properties": { "ok": { "const": true, "description": "Whether the tool invocation succeeded." }, "data": { "type": [ "object", "null" ], "properties": { "solutionPath": { "description": "The loaded solution or project path.", "type": "string" }, "folders": { "description": "The solution folders.", "type": "object", "properties": { "items": { "description": "Items returned in this page.", "type": [ "array", "null" ], "items": { "type": "object", "properties": { "name": { "type": "string" }, "path": { "type": "string" }, "parentPath": { "type": [ "string", "null" ] } }, "required": [ "name", "path" ] } }, "hasMore": { "description": "Whether additional items were available beyond this page.", "type": "boolean" }, "totalCount": { "description": "Complete result count, when available without additional expensive work.", "type": [ "integer", "null" ] } } }, "projects": { "description": "The project structure projections.", "type": "object", "properties": { "items": { "description": "Items returned in this page.", "type": [ "array", "null" ], "items": { "type": "object", "properties": { "projectId": { "description": "The project identifier.", "type": "string" }, "name": { "description": "The project name.", "type": "string" }, "path": { "description": "The project path.", "type": "string" }, "solutionFolderPath": { "description": "The associated solution-folder path, when available.", "type": [ "string", "null" ] }, "targetFrameworks": { "description": "The target frameworks inferred for the project.", "type": "array", "items": { "type": "string" } }, "projectReferences": { "description": "The direct project references.", "type": "object", "properties": { "items": { "description": "Items returned in this page.", "type": [ "array", "null" ], "items": { "type": "object", "properties": { "projectId": { "description": "The referenced project identifier.", "type": "string" }, "name": { "description": "The referenced project name.", "type": "string" }, "path": { "description": "The referenced project path.", "type": "string" } }, "required": [ "projectId", "name", "path" ] } }, "hasMore": { "description": "Whether additional items were available beyond this page.", "type": "boolean" }, "totalCount": { "description": "Complete result count, when available without additional expensive work.", "type": [ "integer", "null" ] } } }, "documents": { "description": "The project documents, when included.", "type": [ "object", "null" ], "properties": { "items": { "description": "Items returned in this page.", "type": [ "array", "null" ], "items": { "type": "object", "properties": { "documentId": { "description": "The document identifier.", "type": "string" }, "path": { "description": "The normalized document path.", "type": "string" }, "projectId": { "description": "The owning project identifier.", "type": "string" } }, "required": [ "documentId", "path", "projectId" ] } }, "hasMore": { "description": "Whether additional items were available beyond this page.", "type": "boolean" }, "totalCount": { "description": "Complete result count, when available without additional expensive work.", "type": [ "integer", "null" ] } } } }, "required": [ "projectId", "name", "path" ] } }, "hasMore": { "description": "Whether additional items were available beyond this page.", "type": "boolean" }, "totalCount": { "description": "Complete result count, when available without additional expensive work.", "type": [ "integer", "null" ] } } } }, "required": [ "solutionPath" ], "description": "Tool-specific result payload." }, "snapshot": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ], "description": "Exact immutable workspace snapshot associated with the result, when available." }, "warnings": { "type": "array", "description": "Non-fatal warnings the agent should consider.", "items": { "$ref": "#/$defs/warningInfo" } } } }, "definitions": { "warningInfo": { "type": "object", "properties": { "code": { "description": "The stable machine-readable warning code.", "type": "string" }, "message": { "description": "The human-readable warning message.", "type": "string" } }, "required": [ "code", "message" ] } } }, "get-symbol-attributes": { "variant": { "type": "object", "required": [ "ok", "data", "snapshot" ], "properties": { "ok": { "const": true, "description": "Whether the tool invocation succeeded." }, "data": { "type": [ "object", "null" ], "properties": { "symbol": { "description": "The queried symbol.", "type": [ "object", "null" ], "properties": { "displayName": { "description": "The display name of the symbol.", "type": "string" }, "kind": { "description": "The symbol kind.", "type": "string" }, "documentationCommentId": { "description": "The documentation comment identifier, when available.", "type": [ "string", "null" ] }, "location": { "description": "The optional source location of the symbol.", "type": [ "object", "null" ], "properties": { "document": { "description": "The resolved document.", "type": [ "object", "null" ], "properties": { "documentId": { "description": "The document identifier.", "type": "string" }, "path": { "description": "The normalized document path.", "type": "string" }, "projectId": { "description": "The owning project identifier.", "type": "string" } }, "required": [ "documentId", "path", "projectId" ] }, "span": { "description": "The resolved text span.", "type": [ "object", "null" ], "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } }, "line": { "description": "The one-based line number.", "type": "integer" }, "column": { "description": "The one-based column number.", "type": "integer" }, "snapshot": { "description": "The exact immutable workspace snapshot associated with this location.", "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ] }, "selector": { "description": "The canonical selector that can resolve this source location again.", "type": [ "object", "null" ], "properties": { "span": { "type": "object", "properties": { "document": { "description": "Provide exactly one of path or documentId.", "type": "object", "properties": { "project": { "description": "Disambiguates documents with matching paths or IDs.", "type": [ "object", "null" ], "properties": { "projectId": { "type": [ "string", "null" ] }, "name": { "type": [ "string", "null" ] }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "targetFramework": { "type": [ "string", "null" ] } } }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "documentId": { "description": "Workspace-local document ID.", "type": [ "string", "null" ] } } }, "range": { "description": "Zero-based UTF-16 range.", "type": "object", "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } } }, "required": [ "document", "range" ] } }, "required": [ "span" ] } }, "required": [ "snapshot" ] } }, "required": [ "displayName", "kind" ] }, "attributes": { "description": "The resolved attributes.", "type": "object", "properties": { "items": { "description": "Items returned in this page.", "type": [ "array", "null" ], "items": { "type": "object", "properties": { "name": { "description": "The attribute display name.", "type": "string" }, "type": { "description": "The attribute type information.", "type": [ "object", "null" ], "properties": { "displayName": { "description": "The display name.", "type": "string" }, "kind": { "description": "The Roslyn type kind.", "type": "string" }, "nullableAnnotation": { "description": "The nullable annotation.", "type": [ "string", "null" ] }, "documentationCommentId": { "description": "The documentation-comment identifier, when available.", "type": [ "string", "null" ] } }, "required": [ "displayName", "kind" ] }, "inherited": { "description": "Whether the attribute was inherited from a base type.", "type": "boolean" }, "constructorArguments": { "description": "The positional constructor arguments.", "type": "array", "items": { "type": "object", "properties": { "name": { "description": "The argument name for named arguments.", "type": [ "string", "null" ] }, "type": { "description": "The argument type display name.", "type": [ "string", "null" ] }, "value": { "description": "The argument value.", "type": [ "string", "null" ] } } } }, "namedArguments": { "description": "The named arguments.", "type": "array", "items": { "$ref": "#/properties/request/properties/value/properties/attributes/properties/items/items/properties/constructorArguments/items" } } }, "required": [ "name" ] } }, "hasMore": { "description": "Whether additional items were available beyond this page.", "type": "boolean" }, "totalCount": { "description": "Complete result count, when available without additional expensive work.", "type": [ "integer", "null" ] } } } }, "description": "Tool-specific result payload." }, "snapshot": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ], "description": "Exact immutable workspace snapshot associated with the result, when available." }, "warnings": { "type": "array", "description": "Non-fatal warnings the agent should consider.", "items": { "$ref": "#/$defs/warningInfo" } } } }, "definitions": { "warningInfo": { "type": "object", "properties": { "code": { "description": "The stable machine-readable warning code.", "type": "string" }, "message": { "description": "The human-readable warning message.", "type": "string" } }, "required": [ "code", "message" ] } } }, "get-symbol-dependencies": { "variant": { "type": "object", "required": [ "ok", "data", "snapshot" ], "properties": { "ok": { "const": true, "description": "Whether the tool invocation succeeded." }, "data": { "type": [ "object", "null" ], "properties": { "symbol": { "description": "The queried symbol.", "type": [ "object", "null" ], "properties": { "displayName": { "description": "The display name of the symbol.", "type": "string" }, "kind": { "description": "The symbol kind.", "type": "string" }, "documentationCommentId": { "description": "The documentation comment identifier, when available.", "type": [ "string", "null" ] }, "location": { "description": "The optional source location of the symbol.", "type": [ "object", "null" ], "properties": { "document": { "description": "The resolved document.", "type": [ "object", "null" ], "properties": { "documentId": { "description": "The document identifier.", "type": "string" }, "path": { "description": "The normalized document path.", "type": "string" }, "projectId": { "description": "The owning project identifier.", "type": "string" } }, "required": [ "documentId", "path", "projectId" ] }, "span": { "description": "The resolved text span.", "type": [ "object", "null" ], "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } }, "line": { "description": "The one-based line number.", "type": "integer" }, "column": { "description": "The one-based column number.", "type": "integer" }, "snapshot": { "description": "The exact immutable workspace snapshot associated with this location.", "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ] }, "selector": { "description": "The canonical selector that can resolve this source location again.", "type": [ "object", "null" ], "properties": { "span": { "type": "object", "properties": { "document": { "description": "Provide exactly one of path or documentId.", "type": "object", "properties": { "project": { "description": "Disambiguates documents with matching paths or IDs.", "type": [ "object", "null" ], "properties": { "projectId": { "type": [ "string", "null" ] }, "name": { "type": [ "string", "null" ] }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "targetFramework": { "type": [ "string", "null" ] } } }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "documentId": { "description": "Workspace-local document ID.", "type": [ "string", "null" ] } } }, "range": { "description": "Zero-based UTF-16 range.", "type": "object", "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } } }, "required": [ "document", "range" ] } }, "required": [ "span" ] } }, "required": [ "snapshot" ] } }, "required": [ "displayName", "kind" ] }, "dependencies": { "description": "The returned direct dependencies.", "type": "object", "properties": { "items": { "description": "Items returned in this page.", "type": [ "array", "null" ], "items": { "type": "object", "properties": { "symbol": { "description": "The dependent symbol reference.", "type": [ "object", "null" ], "properties": { "displayName": { "description": "The display name of the symbol.", "type": "string" }, "kind": { "description": "The symbol kind.", "type": "string" }, "documentationCommentId": { "description": "The documentation comment identifier, when available.", "type": [ "string", "null" ] }, "location": { "description": "The optional source location of the symbol.", "$ref": "#/properties/request/properties/value/properties/symbol/properties/location" } }, "required": [ "displayName", "kind" ] }, "kind": { "description": "The symbol kind for the dependency.", "type": "string" }, "assemblyName": { "description": "The containing assembly name when requested.", "type": [ "string", "null" ] } }, "required": [ "kind" ] } }, "hasMore": { "description": "Whether additional items were available beyond this page.", "type": "boolean" }, "totalCount": { "description": "Complete result count, when available without additional expensive work.", "type": [ "integer", "null" ] } } } }, "description": "Tool-specific result payload." }, "snapshot": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ], "description": "Exact immutable workspace snapshot associated with the result, when available." }, "warnings": { "type": "array", "description": "Non-fatal warnings the agent should consider.", "items": { "$ref": "#/$defs/warningInfo" } } } }, "definitions": { "warningInfo": { "type": "object", "properties": { "code": { "description": "The stable machine-readable warning code.", "type": "string" }, "message": { "description": "The human-readable warning message.", "type": "string" } }, "required": [ "code", "message" ] } } }, "get-symbol-dependents": { "variant": { "type": "object", "required": [ "ok", "data", "snapshot" ], "properties": { "ok": { "const": true, "description": "Whether the tool invocation succeeded." }, "data": { "type": [ "object", "null" ], "properties": { "symbol": { "description": "The queried symbol.", "type": [ "object", "null" ], "properties": { "displayName": { "description": "The display name of the symbol.", "type": "string" }, "kind": { "description": "The symbol kind.", "type": "string" }, "documentationCommentId": { "description": "The documentation comment identifier, when available.", "type": [ "string", "null" ] }, "location": { "description": "The optional source location of the symbol.", "type": [ "object", "null" ], "properties": { "document": { "description": "The resolved document.", "type": [ "object", "null" ], "properties": { "documentId": { "description": "The document identifier.", "type": "string" }, "path": { "description": "The normalized document path.", "type": "string" }, "projectId": { "description": "The owning project identifier.", "type": "string" } }, "required": [ "documentId", "path", "projectId" ] }, "span": { "description": "The resolved text span.", "type": [ "object", "null" ], "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } }, "line": { "description": "The one-based line number.", "type": "integer" }, "column": { "description": "The one-based column number.", "type": "integer" }, "snapshot": { "description": "The exact immutable workspace snapshot associated with this location.", "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ] }, "selector": { "description": "The canonical selector that can resolve this source location again.", "type": [ "object", "null" ], "properties": { "span": { "type": "object", "properties": { "document": { "description": "Provide exactly one of path or documentId.", "type": "object", "properties": { "project": { "description": "Disambiguates documents with matching paths or IDs.", "type": [ "object", "null" ], "properties": { "projectId": { "type": [ "string", "null" ] }, "name": { "type": [ "string", "null" ] }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "targetFramework": { "type": [ "string", "null" ] } } }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "documentId": { "description": "Workspace-local document ID.", "type": [ "string", "null" ] } } }, "range": { "description": "Zero-based UTF-16 range.", "type": "object", "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } } }, "required": [ "document", "range" ] } }, "required": [ "span" ] } }, "required": [ "snapshot" ] } }, "required": [ "displayName", "kind" ] }, "dependents": { "description": "The returned direct dependents.", "type": "object", "properties": { "items": { "description": "Items returned in this page.", "type": [ "array", "null" ], "items": { "type": "object", "properties": { "displayName": { "description": "The display name of the symbol.", "type": "string" }, "kind": { "description": "The symbol kind.", "type": "string" }, "documentationCommentId": { "description": "The documentation comment identifier, when available.", "type": [ "string", "null" ] }, "location": { "description": "The optional source location of the symbol.", "$ref": "#/properties/request/properties/value/properties/symbol/properties/location" } }, "required": [ "displayName", "kind" ] } }, "hasMore": { "description": "Whether additional items were available beyond this page.", "type": "boolean" }, "totalCount": { "description": "Complete result count, when available without additional expensive work.", "type": [ "integer", "null" ] } } } }, "description": "Tool-specific result payload." }, "snapshot": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ], "description": "Exact immutable workspace snapshot associated with the result, when available." }, "warnings": { "type": "array", "description": "Non-fatal warnings the agent should consider.", "items": { "$ref": "#/$defs/warningInfo" } } } }, "definitions": { "warningInfo": { "type": "object", "properties": { "code": { "description": "The stable machine-readable warning code.", "type": "string" }, "message": { "description": "The human-readable warning message.", "type": "string" } }, "required": [ "code", "message" ] } } }, "get-symbol-info": { "variant": { "type": "object", "required": [ "ok", "data", "snapshot" ], "properties": { "ok": { "const": true, "description": "Whether the tool invocation succeeded." }, "data": { "type": [ "object", "null" ], "properties": { "symbol": { "description": "The resolved symbol.", "type": [ "object", "null" ], "properties": { "displayName": { "description": "The display name of the symbol.", "type": "string" }, "kind": { "description": "The symbol kind.", "type": "string" }, "documentationCommentId": { "description": "The documentation comment identifier, when available.", "type": [ "string", "null" ] }, "location": { "description": "The optional source location of the symbol.", "type": [ "object", "null" ], "properties": { "document": { "description": "The resolved document.", "type": [ "object", "null" ], "properties": { "documentId": { "description": "The document identifier.", "type": "string" }, "path": { "description": "The normalized document path.", "type": "string" }, "projectId": { "description": "The owning project identifier.", "type": "string" } }, "required": [ "documentId", "path", "projectId" ] }, "span": { "description": "The resolved text span.", "type": [ "object", "null" ], "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } }, "line": { "description": "The one-based line number.", "type": "integer" }, "column": { "description": "The one-based column number.", "type": "integer" }, "snapshot": { "description": "The exact immutable workspace snapshot associated with this location.", "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ] }, "selector": { "description": "The canonical selector that can resolve this source location again.", "type": [ "object", "null" ], "properties": { "span": { "type": "object", "properties": { "document": { "description": "Provide exactly one of path or documentId.", "type": "object", "properties": { "project": { "description": "Disambiguates documents with matching paths or IDs.", "type": [ "object", "null" ], "properties": { "projectId": { "type": [ "string", "null" ] }, "name": { "type": [ "string", "null" ] }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "targetFramework": { "type": [ "string", "null" ] } } }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "documentId": { "description": "Workspace-local document ID.", "type": [ "string", "null" ] } } }, "range": { "description": "Zero-based UTF-16 range.", "type": "object", "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } } }, "required": [ "document", "range" ] } }, "required": [ "span" ] } }, "required": [ "snapshot" ] } }, "required": [ "displayName", "kind" ] }, "accessibility": { "description": "The symbol accessibility.", "type": "string" }, "modifiers": { "description": "The symbol modifiers.", "type": "array", "items": { "type": "string" } }, "type": { "description": "The containing or declared type information, when applicable.", "type": [ "object", "null" ], "properties": { "displayName": { "description": "The display name.", "type": "string" }, "kind": { "description": "The Roslyn type kind.", "type": "string" }, "nullableAnnotation": { "description": "The nullable annotation.", "type": [ "string", "null" ] }, "documentationCommentId": { "description": "The documentation-comment identifier, when available.", "type": [ "string", "null" ] } }, "required": [ "displayName", "kind" ] }, "parameters": { "description": "The callable parameter information, when applicable.", "type": [ "object", "null" ], "properties": { "items": { "description": "Items returned in this page.", "type": [ "array", "null" ], "items": { "type": "object", "properties": { "name": { "description": "The parameter name.", "type": "string" }, "type": { "description": "The parameter type information.", "type": [ "object", "null" ], "properties": { "displayName": { "description": "The display name.", "type": "string" }, "kind": { "description": "The Roslyn type kind.", "type": "string" }, "nullableAnnotation": { "description": "The nullable annotation.", "type": [ "string", "null" ] }, "documentationCommentId": { "description": "The documentation-comment identifier, when available.", "type": [ "string", "null" ] } }, "required": [ "displayName", "kind" ] }, "refKind": { "description": "The parameter passing mode.", "type": "string" }, "isOptional": { "description": "Whether the parameter is optional.", "type": "boolean" }, "hasExplicitDefaultValue": { "description": "Whether the parameter has an explicit default value.", "type": "boolean" }, "defaultValue": { "description": "The formatted default value, when available.", "type": [ "string", "null" ] } }, "required": [ "name", "refKind" ] } }, "hasMore": { "description": "Whether additional items were available beyond this page.", "type": "boolean" }, "totalCount": { "description": "Complete result count, when available without additional expensive work.", "type": [ "integer", "null" ] } } }, "returnType": { "description": "The return type information, when applicable.", "type": [ "object", "null" ], "properties": { "displayName": { "description": "The display name.", "type": "string" }, "kind": { "description": "The Roslyn type kind.", "type": "string" }, "nullableAnnotation": { "description": "The nullable annotation.", "type": [ "string", "null" ] }, "documentationCommentId": { "description": "The documentation-comment identifier, when available.", "type": [ "string", "null" ] } }, "required": [ "displayName", "kind" ] }, "documentation": { "description": "The XML documentation text, when requested.", "type": [ "string", "null" ] }, "declarations": { "description": "The source declarations for the symbol.", "type": "object", "properties": { "items": { "description": "Items returned in this page.", "type": [ "array", "null" ], "items": { "type": "object", "properties": { "document": { "description": "The resolved document.", "$ref": "#/properties/request/properties/value/properties/symbol/properties/location/properties/document" }, "span": { "description": "The resolved text span.", "$ref": "#/properties/request/properties/value/properties/symbol/properties/location/properties/span" }, "line": { "description": "The one-based line number.", "type": "integer" }, "column": { "description": "The one-based column number.", "type": "integer" }, "snapshot": { "description": "The exact immutable workspace snapshot associated with this location.", "$ref": "#/properties/request/properties/value/properties/symbol/properties/location/properties/snapshot" }, "selector": { "description": "The canonical selector that can resolve this source location again.", "$ref": "#/properties/request/properties/value/properties/symbol/properties/location/properties/selector" } }, "required": [ "snapshot" ] } }, "hasMore": { "description": "Whether additional items were available beyond this page.", "type": "boolean" }, "totalCount": { "description": "Complete result count, when available without additional expensive work.", "type": [ "integer", "null" ] } } } }, "required": [ "accessibility" ], "description": "Tool-specific result payload." }, "snapshot": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ], "description": "Exact immutable workspace snapshot associated with the result, when available." }, "warnings": { "type": "array", "description": "Non-fatal warnings the agent should consider.", "items": { "$ref": "#/$defs/warningInfo" } } } }, "definitions": { "warningInfo": { "type": "object", "properties": { "code": { "description": "The stable machine-readable warning code.", "type": "string" }, "message": { "description": "The human-readable warning message.", "type": "string" } }, "required": [ "code", "message" ] } } }, "get-symbol-members": { "variant": { "type": "object", "required": [ "ok", "data", "snapshot" ], "properties": { "ok": { "const": true, "description": "Whether the tool invocation succeeded." }, "data": { "type": [ "object", "null" ], "properties": { "symbol": { "description": "The queried symbol.", "type": [ "object", "null" ], "properties": { "displayName": { "description": "The display name of the symbol.", "type": "string" }, "kind": { "description": "The symbol kind.", "type": "string" }, "documentationCommentId": { "description": "The documentation comment identifier, when available.", "type": [ "string", "null" ] }, "location": { "description": "The optional source location of the symbol.", "type": [ "object", "null" ], "properties": { "document": { "description": "The resolved document.", "type": [ "object", "null" ], "properties": { "documentId": { "description": "The document identifier.", "type": "string" }, "path": { "description": "The normalized document path.", "type": "string" }, "projectId": { "description": "The owning project identifier.", "type": "string" } }, "required": [ "documentId", "path", "projectId" ] }, "span": { "description": "The resolved text span.", "type": [ "object", "null" ], "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } }, "line": { "description": "The one-based line number.", "type": "integer" }, "column": { "description": "The one-based column number.", "type": "integer" }, "snapshot": { "description": "The exact immutable workspace snapshot associated with this location.", "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ] }, "selector": { "description": "The canonical selector that can resolve this source location again.", "type": [ "object", "null" ], "properties": { "span": { "type": "object", "properties": { "document": { "description": "Provide exactly one of path or documentId.", "type": "object", "properties": { "project": { "description": "Disambiguates documents with matching paths or IDs.", "type": [ "object", "null" ], "properties": { "projectId": { "type": [ "string", "null" ] }, "name": { "type": [ "string", "null" ] }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "targetFramework": { "type": [ "string", "null" ] } } }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "documentId": { "description": "Workspace-local document ID.", "type": [ "string", "null" ] } } }, "range": { "description": "Zero-based UTF-16 range.", "type": "object", "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } } }, "required": [ "document", "range" ] } }, "required": [ "span" ] } }, "required": [ "snapshot" ] } }, "required": [ "displayName", "kind" ] }, "members": { "description": "The resolved members.", "type": "object", "properties": { "items": { "description": "Items returned in this page.", "type": [ "array", "null" ], "items": { "type": "object", "properties": { "displayName": { "description": "The display name of the symbol.", "type": "string" }, "kind": { "description": "The symbol kind.", "type": "string" }, "documentationCommentId": { "description": "The documentation comment identifier, when available.", "type": [ "string", "null" ] }, "location": { "description": "The optional source location of the symbol.", "$ref": "#/properties/request/properties/value/properties/symbol/properties/location" } }, "required": [ "displayName", "kind" ] } }, "hasMore": { "description": "Whether additional items were available beyond this page.", "type": "boolean" }, "totalCount": { "description": "Complete result count, when available without additional expensive work.", "type": [ "integer", "null" ] } } } }, "description": "Tool-specific result payload." }, "snapshot": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ], "description": "Exact immutable workspace snapshot associated with the result, when available." }, "warnings": { "type": "array", "description": "Non-fatal warnings the agent should consider.", "items": { "$ref": "#/$defs/warningInfo" } } } }, "definitions": { "warningInfo": { "type": "object", "properties": { "code": { "description": "The stable machine-readable warning code.", "type": "string" }, "message": { "description": "The human-readable warning message.", "type": "string" } }, "required": [ "code", "message" ] } } }, "get-test-impact": { "variant": { "type": "object", "required": [ "ok", "data", "snapshot" ], "properties": { "ok": { "const": true, "description": "Whether the tool invocation succeeded." }, "data": { "type": [ "object", "null" ], "properties": { "symbol": { "description": "The queried symbol.", "type": [ "object", "null" ], "properties": { "displayName": { "description": "The display name of the symbol.", "type": "string" }, "kind": { "description": "The symbol kind.", "type": "string" }, "documentationCommentId": { "description": "The documentation comment identifier, when available.", "type": [ "string", "null" ] }, "location": { "description": "The optional source location of the symbol.", "type": [ "object", "null" ], "properties": { "document": { "description": "The resolved document.", "type": [ "object", "null" ], "properties": { "documentId": { "description": "The document identifier.", "type": "string" }, "path": { "description": "The normalized document path.", "type": "string" }, "projectId": { "description": "The owning project identifier.", "type": "string" } }, "required": [ "documentId", "path", "projectId" ] }, "span": { "description": "The resolved text span.", "type": [ "object", "null" ], "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } }, "line": { "description": "The one-based line number.", "type": "integer" }, "column": { "description": "The one-based column number.", "type": "integer" }, "snapshot": { "description": "The exact immutable workspace snapshot associated with this location.", "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ] }, "selector": { "description": "The canonical selector that can resolve this source location again.", "type": [ "object", "null" ], "properties": { "span": { "type": "object", "properties": { "document": { "description": "Provide exactly one of path or documentId.", "type": "object", "properties": { "project": { "description": "Disambiguates documents with matching paths or IDs.", "type": [ "object", "null" ], "properties": { "projectId": { "type": [ "string", "null" ] }, "name": { "type": [ "string", "null" ] }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "targetFramework": { "type": [ "string", "null" ] } } }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "documentId": { "description": "Workspace-local document ID.", "type": [ "string", "null" ] } } }, "range": { "description": "Zero-based UTF-16 range.", "type": "object", "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } } }, "required": [ "document", "range" ] } }, "required": [ "span" ] } }, "required": [ "snapshot" ] } }, "required": [ "displayName", "kind" ] }, "tests": { "description": "The returned impacted tests.", "type": "object", "properties": { "items": { "description": "Items returned in this page.", "type": [ "array", "null" ], "items": { "type": "object", "properties": { "test": { "type": [ "object", "null" ], "properties": { "displayName": { "description": "The display name of the symbol.", "type": "string" }, "kind": { "description": "The symbol kind.", "type": "string" }, "documentationCommentId": { "description": "The documentation comment identifier, when available.", "type": [ "string", "null" ] }, "location": { "description": "The optional source location of the symbol.", "$ref": "#/properties/request/properties/value/properties/symbol/properties/location" } }, "required": [ "displayName", "kind" ] }, "location": { "type": [ "object", "null" ], "properties": { "document": { "description": "The resolved document.", "$ref": "#/properties/request/properties/value/properties/symbol/properties/location/properties/document" }, "span": { "description": "The resolved text span.", "$ref": "#/properties/request/properties/value/properties/symbol/properties/location/properties/span" }, "line": { "description": "The one-based line number.", "type": "integer" }, "column": { "description": "The one-based column number.", "type": "integer" }, "snapshot": { "description": "The exact immutable workspace snapshot associated with this location.", "$ref": "#/properties/request/properties/value/properties/symbol/properties/location/properties/snapshot" }, "selector": { "description": "The canonical selector that can resolve this source location again.", "$ref": "#/properties/request/properties/value/properties/symbol/properties/location/properties/selector" } }, "required": [ "snapshot" ] }, "reasons": { "type": [ "array", "null" ], "items": { "type": "string" } } } } }, "hasMore": { "description": "Whether additional items were available beyond this page.", "type": "boolean" }, "totalCount": { "description": "Complete result count, when available without additional expensive work.", "type": [ "integer", "null" ] } } } }, "description": "Tool-specific result payload." }, "snapshot": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ], "description": "Exact immutable workspace snapshot associated with the result, when available." }, "warnings": { "type": "array", "description": "Non-fatal warnings the agent should consider.", "items": { "$ref": "#/$defs/warningInfo" } } } }, "definitions": { "warningInfo": { "type": "object", "properties": { "code": { "description": "The stable machine-readable warning code.", "type": "string" }, "message": { "description": "The human-readable warning message.", "type": "string" } }, "required": [ "code", "message" ] } } }, "get-type-hierarchy": { "variant": { "type": "object", "required": [ "ok", "data", "snapshot" ], "properties": { "ok": { "const": true, "description": "Whether the tool invocation succeeded." }, "data": { "type": [ "object", "null" ], "properties": { "type": { "description": "The queried type.", "type": [ "object", "null" ], "properties": { "displayName": { "description": "The display name of the symbol.", "type": "string" }, "kind": { "description": "The symbol kind.", "type": "string" }, "documentationCommentId": { "description": "The documentation comment identifier, when available.", "type": [ "string", "null" ] }, "location": { "description": "The optional source location of the symbol.", "type": [ "object", "null" ], "properties": { "document": { "description": "The resolved document.", "type": [ "object", "null" ], "properties": { "documentId": { "description": "The document identifier.", "type": "string" }, "path": { "description": "The normalized document path.", "type": "string" }, "projectId": { "description": "The owning project identifier.", "type": "string" } }, "required": [ "documentId", "path", "projectId" ] }, "span": { "description": "The resolved text span.", "type": [ "object", "null" ], "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } }, "line": { "description": "The one-based line number.", "type": "integer" }, "column": { "description": "The one-based column number.", "type": "integer" }, "snapshot": { "description": "The exact immutable workspace snapshot associated with this location.", "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ] }, "selector": { "description": "The canonical selector that can resolve this source location again.", "type": [ "object", "null" ], "properties": { "span": { "type": "object", "properties": { "document": { "description": "Provide exactly one of path or documentId.", "type": "object", "properties": { "project": { "description": "Disambiguates documents with matching paths or IDs.", "type": [ "object", "null" ], "properties": { "projectId": { "type": [ "string", "null" ] }, "name": { "type": [ "string", "null" ] }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "targetFramework": { "type": [ "string", "null" ] } } }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "documentId": { "description": "Workspace-local document ID.", "type": [ "string", "null" ] } } }, "range": { "description": "Zero-based UTF-16 range.", "type": "object", "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } } }, "required": [ "document", "range" ] } }, "required": [ "span" ] } }, "required": [ "snapshot" ] } }, "required": [ "displayName", "kind" ] }, "baseTypes": { "description": "The ordered base types.", "type": "object", "properties": { "items": { "description": "Items returned in this page.", "type": [ "array", "null" ], "items": { "type": "object", "properties": { "displayName": { "description": "The display name of the symbol.", "type": "string" }, "kind": { "description": "The symbol kind.", "type": "string" }, "documentationCommentId": { "description": "The documentation comment identifier, when available.", "type": [ "string", "null" ] }, "location": { "description": "The optional source location of the symbol.", "$ref": "#/properties/request/properties/value/properties/type/properties/location" } }, "required": [ "displayName", "kind" ] } }, "hasMore": { "description": "Whether additional items were available beyond this page.", "type": "boolean" }, "totalCount": { "description": "Complete result count, when available without additional expensive work.", "type": [ "integer", "null" ] } } }, "interfaces": { "description": "The implemented interfaces.", "type": "object", "properties": { "items": { "description": "Items returned in this page.", "$ref": "#/properties/request/properties/value/properties/baseTypes/properties/items", "items": {} }, "hasMore": { "description": "Whether additional items were available beyond this page.", "type": "boolean" }, "totalCount": { "description": "Complete result count, when available without additional expensive work.", "type": [ "integer", "null" ] } } }, "derivedTypes": { "description": "The optional derived types.", "type": [ "object", "null" ], "properties": { "items": { "description": "Items returned in this page.", "type": [ "array", "null" ], "items": { "type": "object", "properties": { "type": { "description": "The resolved type symbol.", "type": [ "object", "null" ], "properties": { "displayName": { "description": "The display name of the symbol.", "type": "string" }, "kind": { "description": "The symbol kind.", "type": "string" }, "documentationCommentId": { "description": "The documentation comment identifier, when available.", "type": [ "string", "null" ] }, "location": { "description": "The optional source location of the symbol.", "$ref": "#/properties/request/properties/value/properties/type/properties/location" } }, "required": [ "displayName", "kind" ] }, "depth": { "description": "The zero-based depth from the queried root type.", "type": "integer" }, "derivedTypes": { "description": "The nested derived types for this node.", "type": "array", "items": { "$ref": "#/properties/request/properties/value/properties/derivedTypes/properties/items/items" } } } } }, "hasMore": { "description": "Whether additional items were available beyond this page.", "type": "boolean" }, "totalCount": { "description": "Complete result count, when available without additional expensive work.", "type": [ "integer", "null" ] } } } }, "description": "Tool-specific result payload." }, "snapshot": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ], "description": "Exact immutable workspace snapshot associated with the result, when available." }, "warnings": { "type": "array", "description": "Non-fatal warnings the agent should consider.", "items": { "$ref": "#/$defs/warningInfo" } } } }, "definitions": { "warningInfo": { "type": "object", "properties": { "code": { "description": "The stable machine-readable warning code.", "type": "string" }, "message": { "description": "The human-readable warning message.", "type": "string" } }, "required": [ "code", "message" ] } } }, "go-to-definition": { "variant": { "type": "object", "required": [ "ok", "data", "snapshot" ], "properties": { "ok": { "const": true, "description": "Whether the tool invocation succeeded." }, "data": { "type": [ "object", "null" ], "properties": { "symbol": { "description": "The queried symbol.", "type": [ "object", "null" ], "properties": { "displayName": { "description": "The display name of the symbol.", "type": "string" }, "kind": { "description": "The symbol kind.", "type": "string" }, "documentationCommentId": { "description": "The documentation comment identifier, when available.", "type": [ "string", "null" ] }, "location": { "description": "The optional source location of the symbol.", "type": [ "object", "null" ], "properties": { "document": { "description": "The resolved document.", "type": [ "object", "null" ], "properties": { "documentId": { "description": "The document identifier.", "type": "string" }, "path": { "description": "The normalized document path.", "type": "string" }, "projectId": { "description": "The owning project identifier.", "type": "string" } }, "required": [ "documentId", "path", "projectId" ] }, "span": { "description": "The resolved text span.", "type": [ "object", "null" ], "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } }, "line": { "description": "The one-based line number.", "type": "integer" }, "column": { "description": "The one-based column number.", "type": "integer" }, "snapshot": { "description": "The exact immutable workspace snapshot associated with this location.", "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ] }, "selector": { "description": "The canonical selector that can resolve this source location again.", "type": [ "object", "null" ], "properties": { "span": { "type": "object", "properties": { "document": { "description": "Provide exactly one of path or documentId.", "type": "object", "properties": { "project": { "description": "Disambiguates documents with matching paths or IDs.", "type": [ "object", "null" ], "properties": { "projectId": { "type": [ "string", "null" ] }, "name": { "type": [ "string", "null" ] }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "targetFramework": { "type": [ "string", "null" ] } } }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "documentId": { "description": "Workspace-local document ID.", "type": [ "string", "null" ] } } }, "range": { "description": "Zero-based UTF-16 range.", "type": "object", "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } } }, "required": [ "document", "range" ] } }, "required": [ "span" ] } }, "required": [ "snapshot" ] } }, "required": [ "displayName", "kind" ] }, "definitions": { "description": "The resolved definitions.", "type": "object", "properties": { "items": { "description": "Items returned in this page.", "type": [ "array", "null" ], "items": { "type": "object", "properties": { "location": { "description": "The source location, when the definition is in source.", "type": [ "object", "null" ], "properties": { "document": { "description": "The resolved document.", "$ref": "#/properties/request/properties/value/properties/symbol/properties/location/properties/document" }, "span": { "description": "The resolved text span.", "$ref": "#/properties/request/properties/value/properties/symbol/properties/location/properties/span" }, "line": { "description": "The one-based line number.", "type": "integer" }, "column": { "description": "The one-based column number.", "type": "integer" }, "snapshot": { "description": "The exact immutable workspace snapshot associated with this location.", "$ref": "#/properties/request/properties/value/properties/symbol/properties/location/properties/snapshot" }, "selector": { "description": "The canonical selector that can resolve this source location again.", "$ref": "#/properties/request/properties/value/properties/symbol/properties/location/properties/selector" } }, "required": [ "snapshot" ] }, "isMetadata": { "description": "Whether the definition is metadata-only.", "type": "boolean" }, "metadataName": { "description": "The metadata symbol name, when the definition is metadata-only.", "type": [ "string", "null" ] }, "containingAssembly": { "description": "The containing assembly display name, when available.", "type": [ "string", "null" ] } } } }, "hasMore": { "description": "Whether additional items were available beyond this page.", "type": "boolean" }, "totalCount": { "description": "Complete result count, when available without additional expensive work.", "type": [ "integer", "null" ] } } } }, "description": "Tool-specific result payload." }, "snapshot": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ], "description": "Exact immutable workspace snapshot associated with the result, when available." }, "warnings": { "type": "array", "description": "Non-fatal warnings the agent should consider.", "items": { "$ref": "#/$defs/warningInfo" } } } }, "definitions": { "warningInfo": { "type": "object", "properties": { "code": { "description": "The stable machine-readable warning code.", "type": "string" }, "message": { "description": "The human-readable warning message.", "type": "string" } }, "required": [ "code", "message" ] } } }, "list-code-actions": { "variant": { "type": "object", "required": [ "ok", "data", "snapshot" ], "properties": { "ok": { "const": true, "description": "Whether the tool invocation succeeded." }, "data": { "type": [ "object", "null" ], "properties": { "actions": { "description": "The returned actions.", "type": "object", "properties": { "items": { "description": "Items returned in this page.", "type": [ "array", "null" ], "items": { "type": "object", "properties": { "actionId": { "description": "The opaque action reference.", "type": "string", "format": "uuid" }, "title": { "description": "The display title.", "type": "string" }, "kind": { "description": "The action kind.", "type": "string", "enum": [ "CodeFix", "Refactoring" ] }, "location": { "description": "The precise source location to which the action applies.", "type": "object", "properties": { "document": { "description": "The project-aware source document identity.", "type": "object", "properties": { "documentId": { "description": "The document identifier.", "type": "string" }, "path": { "description": "The normalized document path.", "type": "string" }, "projectId": { "description": "The owning project identifier.", "type": "string" } }, "required": [ "documentId", "path", "projectId" ] }, "span": { "description": "The zero-based UTF-16 source span.", "type": "object", "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } }, "line": { "description": "The zero-based source line.", "type": "integer" }, "column": { "description": "The zero-based source column.", "type": "integer" } }, "required": [ "document", "span" ] }, "diagnostics": { "description": "Concise diagnostic context for a code fix.", "type": [ "object", "null" ], "properties": { "items": { "description": "Items returned in this page.", "type": [ "array", "null" ], "items": { "type": "object", "properties": { "id": { "description": "The diagnostic identifier.", "type": "string" }, "message": { "description": "The diagnostic message.", "type": "string" } }, "required": [ "id", "message" ] } }, "hasMore": { "description": "Whether additional items were available beyond this page.", "type": "boolean" }, "totalCount": { "description": "Complete result count, when available without additional expensive work.", "type": [ "integer", "null" ] } } }, "fixAllScopes": { "description": "The supported Fix All scopes for a code fix.", "type": [ "array", "null" ], "items": { "type": "string", "enum": [ "Document", "Project", "Solution" ] } }, "providerId": { "description": "Response-local provider reference when includeProvenance was requested.", "type": [ "string", "null" ] } }, "required": [ "actionId", "title", "kind", "location" ] } }, "hasMore": { "description": "Whether additional items were available beyond this page.", "type": "boolean" }, "totalCount": { "description": "Complete result count, when available without additional expensive work.", "type": [ "integer", "null" ] } } }, "providers": { "description": "Provider identities keyed by response-local references used by the returned actions.", "type": [ "object", "null" ], "additionalProperties": { "type": "object", "properties": { "typeName": { "description": "Fully qualified runtime type of the provider that supplied the mutation.", "type": "string" }, "assemblyName": { "description": "Simple name of the assembly containing the provider.", "type": "string" }, "assemblyVersion": { "description": "Version of the assembly containing the provider.", "type": "string" } }, "required": [ "typeName", "assemblyName", "assemblyVersion" ] } } }, "description": "Tool-specific result payload." }, "snapshot": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ], "description": "Exact immutable workspace snapshot associated with the result, when available." }, "warnings": { "type": "array", "description": "Non-fatal warnings the agent should consider.", "items": { "$ref": "#/$defs/warningInfo" } } } }, "definitions": { "warningInfo": { "type": "object", "properties": { "code": { "description": "The stable machine-readable warning code.", "type": "string" }, "message": { "description": "The human-readable warning message.", "type": "string" } }, "required": [ "code", "message" ] } } }, "prepare-error-report": { "variant": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "const": true, "description": "Whether the tool invocation succeeded." }, "data": { "type": [ "object", "null" ], "properties": { "submissionHandle": { "description": "Opaque handle required to submit this reviewed payload.", "type": "string" }, "dispatcher": { "description": "Dispatcher that will send the report.", "type": "string" }, "destination": { "description": "External destination to which the report will be sent.", "type": "string" }, "payloadDigest": { "description": "Digest that identifies the exact immutable payload presented for review.", "type": "string" }, "expiresAt": { "description": "Time after which the submission handle can no longer be used.", "type": "string", "format": "date-time" }, "payloadJson": { "description": "Immutable JSON payload presented for user review.", "type": "string" }, "excludedCategories": { "description": "Data categories excluded from the prepared payload.", "type": "array", "items": { "type": "string" } }, "reviewWarnings": { "description": "Warnings the user should consider before approving submission.", "type": "array", "items": { "type": "string" } } }, "required": [ "submissionHandle", "dispatcher", "destination", "payloadDigest", "expiresAt", "payloadJson" ], "description": "Tool-specific result payload." }, "snapshot": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ], "description": "Exact immutable workspace snapshot associated with the result, when available." }, "warnings": { "type": "array", "description": "Non-fatal warnings the agent should consider.", "items": { "$ref": "#/$defs/warningInfo" } } } }, "definitions": { "warningInfo": { "type": "object", "properties": { "code": { "description": "The stable machine-readable warning code.", "type": "string" }, "message": { "description": "The human-readable warning message.", "type": "string" } }, "required": [ "code", "message" ] } } }, "prepare-fix-all": { "variant": { "type": "object", "required": [ "ok", "data", "snapshot" ], "properties": { "ok": { "const": true, "description": "Whether the tool invocation succeeded." }, "data": { "type": [ "object", "null" ], "properties": { "actionId": { "description": "The opaque prepared action reference.", "type": "string", "format": "uuid" }, "scope": { "description": "The accepted Fix All scope.", "type": "string", "enum": [ "Document", "Project", "Solution" ] }, "affectedDiagnosticCount": { "description": "The complete affected diagnostic count when it is authoritatively available.", "type": [ "integer", "null" ] }, "affectedDocuments": { "description": "The bounded affected source document identities and complete changed-document count.", "type": "object", "properties": { "items": { "description": "Items returned in this page.", "type": [ "array", "null" ], "items": { "type": "object", "properties": { "documentId": { "description": "The document identifier.", "type": "string" }, "path": { "description": "The normalized document path.", "type": "string" }, "projectId": { "description": "The owning project identifier.", "type": "string" } }, "required": [ "documentId", "path", "projectId" ] } }, "hasMore": { "description": "Whether additional items were available beyond this page.", "type": "boolean" }, "totalCount": { "description": "Complete result count, when available without additional expensive work.", "type": [ "integer", "null" ] } } } }, "required": [ "actionId", "scope" ], "description": "Tool-specific result payload." }, "snapshot": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ], "description": "Exact immutable workspace snapshot associated with the result, when available." }, "warnings": { "type": "array", "description": "Non-fatal warnings the agent should consider.", "items": { "$ref": "#/$defs/warningInfo" } } } }, "definitions": { "warningInfo": { "type": "object", "properties": { "code": { "description": "The stable machine-readable warning code.", "type": "string" }, "message": { "description": "The human-readable warning message.", "type": "string" } }, "required": [ "code", "message" ] } } }, "rename-symbol": { "variant": { "type": "object", "required": [ "ok", "data", "snapshot" ], "properties": { "ok": { "const": true, "description": "Whether the tool invocation succeeded." }, "data": { "type": "object", "required": [ "staged" ], "properties": { "staged": { "type": "boolean", "description": "Whether the mutation was staged in the active transaction." }, "summary": { "type": [ "string", "null" ], "description": "Summary of the staged mutation, when available." }, "transaction": { "type": [ "object", "null" ], "description": "Transaction state after the mutation, when present.", "required": [ "revision" ], "properties": { "revision": { "type": "integer", "description": "Transaction revision after staging." } } } }, "description": "Tool-specific result payload." }, "snapshot": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ], "description": "Exact immutable workspace snapshot associated with the result, when available." }, "warnings": { "type": "array", "description": "Non-fatal warnings the agent should consider.", "items": { "$ref": "#/$defs/warningInfo" } } } }, "definitions": { "warningInfo": { "type": "object", "properties": { "code": { "description": "The stable machine-readable warning code.", "type": "string" }, "message": { "description": "The human-readable warning message.", "type": "string" } }, "required": [ "code", "message" ] } } }, "resolve-symbol": { "variant": { "type": "object", "required": [ "ok", "data", "snapshot" ], "properties": { "ok": { "const": true, "description": "Whether the tool invocation succeeded." }, "data": { "type": [ "object", "null" ], "properties": { "symbol": { "description": "The resolved symbol.", "type": [ "object", "null" ], "properties": { "displayName": { "description": "The display name of the symbol.", "type": "string" }, "kind": { "description": "The symbol kind.", "type": "string" }, "documentationCommentId": { "description": "The documentation comment identifier, when available.", "type": [ "string", "null" ] }, "location": { "description": "The optional source location of the symbol.", "type": [ "object", "null" ], "properties": { "document": { "description": "The resolved document.", "type": [ "object", "null" ], "properties": { "documentId": { "description": "The document identifier.", "type": "string" }, "path": { "description": "The normalized document path.", "type": "string" }, "projectId": { "description": "The owning project identifier.", "type": "string" } }, "required": [ "documentId", "path", "projectId" ] }, "span": { "description": "The resolved text span.", "type": [ "object", "null" ], "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } }, "line": { "description": "The one-based line number.", "type": "integer" }, "column": { "description": "The one-based column number.", "type": "integer" }, "snapshot": { "description": "The exact immutable workspace snapshot associated with this location.", "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ] }, "selector": { "description": "The canonical selector that can resolve this source location again.", "type": [ "object", "null" ], "properties": { "span": { "type": "object", "properties": { "document": { "description": "Provide exactly one of path or documentId.", "type": "object", "properties": { "project": { "description": "Disambiguates documents with matching paths or IDs.", "type": [ "object", "null" ], "properties": { "projectId": { "type": [ "string", "null" ] }, "name": { "type": [ "string", "null" ] }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "targetFramework": { "type": [ "string", "null" ] } } }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "documentId": { "description": "Workspace-local document ID.", "type": [ "string", "null" ] } } }, "range": { "description": "Zero-based UTF-16 range.", "type": "object", "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } } }, "required": [ "document", "range" ] } }, "required": [ "span" ] } }, "required": [ "snapshot" ] } }, "required": [ "displayName", "kind" ] }, "selector": { "description": "The canonical selector for the resolved symbol.", "type": [ "object", "null" ], "properties": { "project": { "description": "Disambiguates symbols with matching identities.", "type": [ "object", "null" ], "properties": { "projectId": { "type": [ "string", "null" ] }, "name": { "type": [ "string", "null" ] }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "targetFramework": { "type": [ "string", "null" ] } } }, "location": { "description": "Provide exactly one of span or selection.", "type": [ "object", "null" ], "properties": { "span": { "type": [ "object", "null" ], "properties": { "document": { "description": "Provide exactly one of path or documentId.", "$ref": "#/properties/request/properties/value/properties/symbol/properties/location/properties/selector/properties/span/properties/document" }, "range": { "description": "Zero-based UTF-16 range.", "$ref": "#/properties/request/properties/value/properties/symbol/properties/location/properties/selector/properties/span/properties/range" } }, "required": [ "document", "range" ] }, "selection": { "type": [ "object", "null" ], "properties": { "document": { "description": "Provide exactly one of path or documentId.", "type": "object", "properties": { "project": { "description": "Disambiguates documents with matching paths or IDs.", "$ref": "#/properties/request/properties/value/properties/symbol/properties/location/properties/selector/properties/span/properties/document/properties/project" }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "documentId": { "description": "Workspace-local document ID.", "type": [ "string", "null" ] } } }, "selectedText": { "type": "string", "minLength": 1 }, "contextBefore": { "type": [ "string", "null" ] }, "contextAfter": { "type": [ "string", "null" ] } }, "required": [ "document", "selectedText" ] } } }, "documentationCommentId": { "type": [ "string", "null" ] } } }, "declarations": { "description": "The source declarations for the symbol.", "type": "object", "properties": { "items": { "description": "Items returned in this page.", "type": [ "array", "null" ], "items": { "type": "object", "properties": { "document": { "description": "The resolved document.", "$ref": "#/properties/request/properties/value/properties/symbol/properties/location/properties/document" }, "span": { "description": "The resolved text span.", "$ref": "#/properties/request/properties/value/properties/symbol/properties/location/properties/span" }, "line": { "description": "The one-based line number.", "type": "integer" }, "column": { "description": "The one-based column number.", "type": "integer" }, "snapshot": { "description": "The exact immutable workspace snapshot associated with this location.", "$ref": "#/properties/request/properties/value/properties/symbol/properties/location/properties/snapshot" }, "selector": { "description": "The canonical selector that can resolve this source location again.", "$ref": "#/properties/request/properties/value/properties/symbol/properties/location/properties/selector" } }, "required": [ "snapshot" ] } }, "hasMore": { "description": "Whether additional items were available beyond this page.", "type": "boolean" }, "totalCount": { "description": "Complete result count, when available without additional expensive work.", "type": [ "integer", "null" ] } } } }, "description": "Tool-specific result payload." }, "snapshot": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ], "description": "Exact immutable workspace snapshot associated with the result, when available." }, "warnings": { "type": "array", "description": "Non-fatal warnings the agent should consider.", "items": { "$ref": "#/$defs/warningInfo" } } } }, "definitions": { "warningInfo": { "type": "object", "properties": { "code": { "description": "The stable machine-readable warning code.", "type": "string" }, "message": { "description": "The human-readable warning message.", "type": "string" } }, "required": [ "code", "message" ] } } }, "search-symbols": { "variant": { "type": "object", "required": [ "ok", "data", "snapshot" ], "properties": { "ok": { "const": true, "description": "Whether the tool invocation succeeded." }, "data": { "type": [ "object", "null" ], "properties": { "symbols": { "description": "The returned symbols.", "type": "object", "properties": { "items": { "description": "Items returned in this page.", "type": [ "array", "null" ], "items": { "type": "object", "properties": { "displayName": { "description": "The display name of the symbol.", "type": "string" }, "kind": { "description": "The symbol kind.", "type": "string" }, "documentationCommentId": { "description": "The documentation comment identifier, when available.", "type": [ "string", "null" ] }, "location": { "description": "The optional source location of the symbol.", "type": [ "object", "null" ], "properties": { "document": { "description": "The resolved document.", "type": [ "object", "null" ], "properties": { "documentId": { "description": "The document identifier.", "type": "string" }, "path": { "description": "The normalized document path.", "type": "string" }, "projectId": { "description": "The owning project identifier.", "type": "string" } }, "required": [ "documentId", "path", "projectId" ] }, "span": { "description": "The resolved text span.", "type": [ "object", "null" ], "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } }, "line": { "description": "The one-based line number.", "type": "integer" }, "column": { "description": "The one-based column number.", "type": "integer" }, "snapshot": { "description": "The exact immutable workspace snapshot associated with this location.", "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ] }, "selector": { "description": "The canonical selector that can resolve this source location again.", "type": [ "object", "null" ], "properties": { "span": { "type": "object", "properties": { "document": { "description": "Provide exactly one of path or documentId.", "type": "object", "properties": { "project": { "description": "Disambiguates documents with matching paths or IDs.", "type": [ "object", "null" ], "properties": { "projectId": { "type": [ "string", "null" ] }, "name": { "type": [ "string", "null" ] }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "targetFramework": { "type": [ "string", "null" ] } } }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "documentId": { "description": "Workspace-local document ID.", "type": [ "string", "null" ] } } }, "range": { "description": "Zero-based UTF-16 range.", "type": "object", "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } } }, "required": [ "document", "range" ] } }, "required": [ "span" ] } }, "required": [ "snapshot" ] } }, "required": [ "displayName", "kind" ] } }, "hasMore": { "description": "Whether additional items were available beyond this page.", "type": "boolean" }, "totalCount": { "description": "Complete result count, when available without additional expensive work.", "type": [ "integer", "null" ] } } } }, "description": "Tool-specific result payload." }, "snapshot": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ], "description": "Exact immutable workspace snapshot associated with the result, when available." }, "warnings": { "type": "array", "description": "Non-fatal warnings the agent should consider.", "items": { "$ref": "#/$defs/warningInfo" } } } }, "definitions": { "warningInfo": { "type": "object", "properties": { "code": { "description": "The stable machine-readable warning code.", "type": "string" }, "message": { "description": "The human-readable warning message.", "type": "string" } }, "required": [ "code", "message" ] } } }, "server-status": { "variant": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "const": true, "description": "Whether the tool invocation succeeded." }, "data": { "type": [ "object", "null" ], "properties": { "serverVersion": { "description": "The server version, when available from assembly metadata.", "type": [ "string", "null" ] }, "roslynVersion": { "description": "The Roslyn version, when available from assembly metadata.", "type": [ "string", "null" ] }, "msBuild": { "description": "The MSBuild component status.", "type": [ "object", "null" ], "properties": { "isAvailable": { "description": "Whether the component is available.", "type": "boolean" }, "version": { "description": "The component version, when available.", "type": [ "string", "null" ] }, "message": { "description": "The optional status message.", "type": [ "string", "null" ] } } }, "codeActions": { "description": "The code-action component status.", "type": [ "object", "null" ], "properties": { "isAvailable": { "description": "Whether the component is available.", "type": "boolean" }, "version": { "description": "The component version, when available.", "type": [ "string", "null" ] }, "message": { "description": "The optional status message.", "type": [ "string", "null" ] } } }, "configuration": { "description": "The effective non-sensitive server configuration.", "type": [ "object", "null" ], "properties": { "operationalMode": { "description": "The selected operational mode.", "type": "string" }, "sourceMutationEnabled": { "description": "Whether source mutation is enabled.", "type": "boolean" }, "externalPluginsEnabled": { "description": "Whether loading external plugin packages was explicitly enabled at startup.", "type": "boolean" }, "commitConfirmationRequired": { "description": "Whether Host confirmation is required before transaction commit.", "type": "boolean" }, "receiptApprovalRequired": { "description": "Whether receipt-bound approval is required before transaction commit.", "type": "boolean" }, "compilerValidationRequired": { "description": "Whether compiler validation is required before transaction commit.", "type": "boolean" }, "clientSupportsElicitation": { "description": "Whether the connected client advertised MCP elicitation, when known.", "type": [ "boolean", "null" ] }, "commitConfirmationState": { "description": "The current process-local transaction commit-confirmation state.", "type": "string" }, "workspaceAdmission": { "description": "Indicates whether Workspace admission is unrestricted or restricted by Host configuration.", "type": "string" }, "allowedWorkspaceRootCount": { "description": "The number of effective configured Workspace authority roots.", "type": "integer" }, "externalDocumentPolicy": { "description": "The policy applied to evaluated documents outside the effective Workspace root.", "type": "string" }, "generatedSourcePolicy": { "description": "The policy applied to generated-looking checked-in source.", "type": "string" }, "generatedSourceExceptionCount": { "description": "The number of configured generated-source path exceptions.", "type": "integer" }, "defaultMaxResults": { "description": "The default maximum collection result count.", "type": "integer" }, "codeActionReferenceLifetime": { "description": "The configured code-action reference lifetime.", "$comment": "Represents a System.TimeSpan value.", "type": "string", "pattern": "^-?(\\d\u002B\\.)?\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,7})?$" }, "maxTransactionRevisions": { "description": "The configured transaction revision capacity.", "type": "integer" }, "maxConcurrentQueries": { "description": "The configured maximum concurrent query count.", "type": "integer" }, "toolOutputSchemaMode": { "description": "The configured output schema publication mode.", "type": "string", "enum": [ "Omit", "Full" ] }, "errorReporting": { "description": "The effective non-sensitive error-reporting configuration and session state.", "type": [ "object", "null" ], "properties": { "provider": { "description": "Configured error-reporting provider.", "type": "string" }, "consentMode": { "description": "Configured consent policy for submitting error reports.", "type": "string" }, "consentState": { "description": "Current availability of user consent for error submission.", "type": "string" } }, "required": [ "provider", "consentMode", "consentState" ] } }, "required": [ "operationalMode", "commitConfirmationState", "workspaceAdmission", "externalDocumentPolicy", "generatedSourcePolicy" ] }, "startupWarnings": { "description": "The startup configuration fallbacks, when expanded detail is requested.", "type": [ "array", "null" ], "items": { "type": "object", "properties": { "code": { "description": "The stable machine-readable warning code.", "type": "string" }, "message": { "description": "The human-readable warning message.", "type": "string" } }, "required": [ "code", "message" ] } }, "toolCount": { "description": "The loaded tool count.", "type": "integer" }, "plugins": { "description": "The plugin load results.", "type": [ "array", "null" ], "items": { "type": "object", "properties": { "pluginId": { "description": "The stable plugin identifier, when supplied by the plugin.", "type": [ "string", "null" ] }, "displayName": { "description": "The display name, when supplied by the plugin.", "type": [ "string", "null" ] }, "version": { "description": "The semantic version, when supplied by the plugin.", "type": [ "string", "null" ] }, "supportedApiVersion": { "description": "The supported plugin API version, when supplied by the plugin.", "type": [ "string", "null" ] }, "enabled": { "description": "Whether the plugin is enabled.", "type": "boolean" }, "diagnostics": { "description": "The plugin load diagnostics.", "type": "array", "items": { "type": "object", "properties": { "id": { "description": "The diagnostic identifier.", "type": "string" }, "severity": { "description": "The diagnostic severity.", "type": "string", "enum": [ "Hidden", "Info", "Warning", "Error" ] }, "message": { "description": "The diagnostic message.", "type": "string" }, "location": { "description": "The optional source location of the diagnostic.", "type": [ "object", "null" ], "properties": { "document": { "description": "The resolved document.", "type": [ "object", "null" ], "properties": { "documentId": { "description": "The document identifier.", "type": "string" }, "path": { "description": "The normalized document path.", "type": "string" }, "projectId": { "description": "The owning project identifier.", "type": "string" } }, "required": [ "documentId", "path", "projectId" ] }, "span": { "description": "The resolved text span.", "type": [ "object", "null" ], "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } }, "line": { "description": "The one-based line number.", "type": "integer" }, "column": { "description": "The one-based column number.", "type": "integer" }, "snapshot": { "description": "The exact immutable workspace snapshot associated with this location.", "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ] }, "selector": { "description": "The canonical selector that can resolve this source location again.", "type": [ "object", "null" ], "properties": { "span": { "type": "object", "properties": { "document": { "description": "Provide exactly one of path or documentId.", "type": "object", "properties": { "project": { "description": "Disambiguates documents with matching paths or IDs.", "type": [ "object", "null" ], "properties": { "projectId": { "type": [ "string", "null" ] }, "name": { "type": [ "string", "null" ] }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "targetFramework": { "type": [ "string", "null" ] } } }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "documentId": { "description": "Workspace-local document ID.", "type": [ "string", "null" ] } } }, "range": { "description": "Zero-based UTF-16 range.", "type": "object", "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } } }, "required": [ "document", "range" ] } }, "required": [ "span" ] } }, "required": [ "snapshot" ] } }, "required": [ "id", "message" ] } } } } }, "recovery": { "description": "The unfinished recovery state, when present.", "type": [ "array", "null" ], "items": { "type": "object", "properties": { "commitId": { "description": "Durable commit identifier associated with the recovery record.", "type": "string" }, "code": { "description": "Stable machine-readable recovery status code, when operator action is required.", "type": [ "string", "null" ] }, "solutionPath": { "description": "Absolute solution or project path associated with the recovery record, or empty when malformed recovery evidence does not provide a safe path.", "type": "string" }, "state": { "description": "Current durable commit recovery state.", "type": "string", "enum": [ "Prepared", "Applying", "Committed", "Restored", "RecoveryConflict", "RecoveryIncomplete" ] }, "message": { "description": "Human-readable recovery status or failure detail, when available.", "type": [ "string", "null" ] } }, "required": [ "commitId" ] } } }, "description": "Tool-specific result payload." }, "snapshot": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ], "description": "Exact immutable workspace snapshot associated with the result, when available." }, "warnings": { "type": "array", "description": "Non-fatal warnings the agent should consider.", "items": { "$ref": "#/$defs/warningInfo" } } } }, "definitions": { "warningInfo": { "type": "object", "properties": { "code": { "description": "The stable machine-readable warning code.", "type": "string" }, "message": { "description": "The human-readable warning message.", "type": "string" } }, "required": [ "code", "message" ] } } }, "stage-code-action": { "variant": { "type": "object", "required": [ "ok", "data", "snapshot" ], "properties": { "ok": { "const": true, "description": "Whether the tool invocation succeeded." }, "data": { "type": "object", "required": [ "staged" ], "properties": { "staged": { "type": "boolean", "description": "Whether the mutation was staged in the active transaction." }, "summary": { "type": [ "string", "null" ], "description": "Summary of the staged mutation, when available." }, "transaction": { "type": [ "object", "null" ], "description": "Transaction state after the mutation, when present.", "required": [ "revision" ], "properties": { "revision": { "type": "integer", "description": "Transaction revision after staging." } } } }, "description": "Tool-specific result payload." }, "snapshot": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ], "description": "Exact immutable workspace snapshot associated with the result, when available." }, "warnings": { "type": "array", "description": "Non-fatal warnings the agent should consider.", "items": { "$ref": "#/$defs/warningInfo" } } } }, "definitions": { "warningInfo": { "type": "object", "properties": { "code": { "description": "The stable machine-readable warning code.", "type": "string" }, "message": { "description": "The human-readable warning message.", "type": "string" } }, "required": [ "code", "message" ] } } }, "submit-error-report": { "variant": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "const": true, "description": "Whether the tool invocation succeeded." }, "data": { "type": [ "object", "null" ], "properties": { "dispatcher": { "description": "Dispatcher that sent the report.", "type": "string" }, "reportReference": { "description": "Provider reference for the submitted report.", "type": "string" }, "payloadDigest": { "description": "Digest of the payload that was submitted.", "type": "string" } }, "required": [ "dispatcher", "reportReference", "payloadDigest" ], "description": "Tool-specific result payload." }, "snapshot": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ], "description": "Exact immutable workspace snapshot associated with the result, when available." }, "warnings": { "type": "array", "description": "Non-fatal warnings the agent should consider.", "items": { "$ref": "#/$defs/warningInfo" } } } }, "definitions": { "warningInfo": { "type": "object", "properties": { "code": { "description": "The stable machine-readable warning code.", "type": "string" }, "message": { "description": "The human-readable warning message.", "type": "string" } }, "required": [ "code", "message" ] } } }, "transaction-commit": { "variant": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "const": true, "description": "Whether the tool invocation succeeded." }, "data": { "type": [ "object", "null" ], "properties": { "committed": { "description": "Whether the commit succeeded.", "type": "boolean" }, "transaction": { "description": "The final transaction info, when available.", "type": [ "object", "null" ], "properties": { "revision": { "description": "Current staged transaction revision.", "type": "integer" }, "revisionCount": { "description": "Number of revisions retained in transaction history.", "type": "integer" }, "maxRevisions": { "description": "Maximum number of revisions the transaction can retain.", "type": "integer" }, "remainingRevisions": { "description": "Number of additional revisions that can be staged.", "type": "integer" }, "canMutate": { "description": "Whether mutation tools may stage another change.", "type": "boolean" }, "canUndo": { "description": "Whether transaction history can move to the preceding revision.", "type": "boolean" }, "canRedo": { "description": "Whether transaction history can move to the following revision.", "type": "boolean" }, "canCommit": { "description": "Whether the staged transaction can be committed to disk.", "type": "boolean" }, "canRollback": { "description": "Whether the complete staged transaction can be discarded.", "type": "boolean" } } } }, "description": "Tool-specific result payload." }, "snapshot": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ], "description": "Exact immutable workspace snapshot associated with the result, when available." }, "warnings": { "type": "array", "description": "Non-fatal warnings the agent should consider.", "items": { "$ref": "#/$defs/warningInfo" } } } }, "definitions": { "warningInfo": { "type": "object", "properties": { "code": { "description": "The stable machine-readable warning code.", "type": "string" }, "message": { "description": "The human-readable warning message.", "type": "string" } }, "required": [ "code", "message" ] } } }, "transaction-history": { "variant": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "const": true, "description": "Whether the tool invocation succeeded." }, "data": { "type": [ "object", "null" ], "properties": { "transaction": { "description": "The active transaction info.", "type": [ "object", "null" ], "properties": { "revision": { "description": "Current staged transaction revision.", "type": "integer" }, "revisionCount": { "description": "Number of revisions retained in transaction history.", "type": "integer" }, "maxRevisions": { "description": "Maximum number of revisions the transaction can retain.", "type": "integer" }, "remainingRevisions": { "description": "Number of additional revisions that can be staged.", "type": "integer" }, "canMutate": { "description": "Whether mutation tools may stage another change.", "type": "boolean" }, "canUndo": { "description": "Whether transaction history can move to the preceding revision.", "type": "boolean" }, "canRedo": { "description": "Whether transaction history can move to the following revision.", "type": "boolean" }, "canCommit": { "description": "Whether the staged transaction can be committed to disk.", "type": "boolean" }, "canRollback": { "description": "Whether the complete staged transaction can be discarded.", "type": "boolean" } } } }, "description": "Tool-specific result payload." }, "snapshot": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ], "description": "Exact immutable workspace snapshot associated with the result, when available." }, "warnings": { "type": "array", "description": "Non-fatal warnings the agent should consider.", "items": { "$ref": "#/$defs/warningInfo" } } } }, "definitions": { "warningInfo": { "type": "object", "properties": { "code": { "description": "The stable machine-readable warning code.", "type": "string" }, "message": { "description": "The human-readable warning message.", "type": "string" } }, "required": [ "code", "message" ] } } }, "transaction-preview": { "variant": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "const": true, "description": "Whether the tool invocation succeeded." }, "data": { "type": [ "object", "null" ], "properties": { "transaction": { "description": "The active transaction info.", "type": [ "object", "null" ], "properties": { "revision": { "description": "Current staged transaction revision.", "type": "integer" }, "revisionCount": { "description": "Number of revisions retained in transaction history.", "type": "integer" }, "maxRevisions": { "description": "Maximum number of revisions the transaction can retain.", "type": "integer" }, "remainingRevisions": { "description": "Number of additional revisions that can be staged.", "type": "integer" }, "canMutate": { "description": "Whether mutation tools may stage another change.", "type": "boolean" }, "canUndo": { "description": "Whether transaction history can move to the preceding revision.", "type": "boolean" }, "canRedo": { "description": "Whether transaction history can move to the following revision.", "type": "boolean" }, "canCommit": { "description": "Whether the staged transaction can be committed to disk.", "type": "boolean" }, "canRollback": { "description": "Whether the complete staged transaction can be discarded.", "type": "boolean" } } }, "documents": { "description": "The changed documents in the preview.", "type": "array", "items": { "type": "object", "properties": { "document": { "description": "The document that changed.", "type": [ "object", "null" ], "properties": { "documentId": { "description": "The document identifier.", "type": "string" }, "path": { "description": "The normalized document path.", "type": "string" }, "projectId": { "description": "The owning project identifier.", "type": "string" } }, "required": [ "documentId", "path", "projectId" ] }, "changeKind": { "description": "The kind of change applied to the document.", "type": "string", "enum": [ "Added", "Modified", "Deleted" ] }, "preview": { "description": "The optional diff summary for the change.", "type": [ "object", "null" ], "properties": { "addedLines": { "description": "The number of added lines.", "type": "integer" }, "removedLines": { "description": "The number of removed lines.", "type": "integer" }, "changedLines": { "description": "The number of changed lines.", "type": "integer" } } } } } }, "provenance": { "description": "Mutation revisions contributing to the previewed transaction.", "type": "array", "items": { "type": "object", "properties": { "revision": { "description": "One-based transaction revision.", "type": "integer" }, "operation": { "description": "Mutation operation recorded for the revision.", "type": "string" }, "summary": { "description": "Concise mutation summary recorded for the revision.", "type": "string" }, "codeAction": { "description": "Code Action attribution when this revision was produced by a Code Action.", "type": [ "object", "null" ], "properties": { "kind": { "description": "Code Action family that produced the mutation.", "type": "string", "enum": [ "CodeFix", "Refactoring", "FixAll" ] }, "providerId": { "description": "Response-local reference to the provider that originated the Code Action.", "type": "string" }, "fixAllProviderId": { "description": "Response-local reference to the Fix All provider when one assembled the operation.", "type": [ "string", "null" ] } }, "required": [ "kind", "providerId" ] } }, "required": [ "revision", "operation", "summary" ] } }, "providers": { "description": "Provider identities keyed by response-local references used by provenance entries.", "type": [ "object", "null" ], "additionalProperties": { "type": "object", "properties": { "typeName": { "description": "Fully qualified runtime type of the provider that supplied the mutation.", "type": "string" }, "assemblyName": { "description": "Simple name of the assembly containing the provider.", "type": "string" }, "assemblyVersion": { "description": "Version of the assembly containing the provider.", "type": "string" } }, "required": [ "typeName", "assemblyName", "assemblyVersion" ] } }, "diff": { "description": "The optional detailed diff.", "type": [ "object", "null" ], "properties": { "document": { "description": "Document for which the detailed diff was produced.", "type": [ "object", "null" ], "properties": { "documentId": { "description": "The document identifier.", "type": "string" }, "path": { "description": "The normalized document path.", "type": "string" }, "projectId": { "description": "The owning project identifier.", "type": "string" } }, "required": [ "documentId", "path", "projectId" ] }, "hunks": { "description": "Changed regions in unified-diff form.", "type": "array", "items": { "type": "object", "properties": { "originalStartLine": { "description": "One-based starting line in the original document.", "type": "integer" }, "originalLineCount": { "description": "Number of original-document lines covered by the hunk.", "type": "integer" }, "updatedStartLine": { "description": "One-based starting line in the updated document.", "type": "integer" }, "updatedLineCount": { "description": "Number of updated-document lines covered by the hunk.", "type": "integer" }, "lines": { "description": "Unified-diff content lines prefixed with space, \u002B, or -.", "type": "array", "items": { "type": "string" } } } } }, "truncated": { "description": "Whether one or more diff hunks were omitted from the response.", "type": "boolean" } } } }, "description": "Tool-specific result payload." }, "snapshot": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ], "description": "Exact immutable workspace snapshot associated with the result, when available." }, "warnings": { "type": "array", "description": "Non-fatal warnings the agent should consider.", "items": { "$ref": "#/$defs/warningInfo" } } } }, "definitions": { "warningInfo": { "type": "object", "properties": { "code": { "description": "The stable machine-readable warning code.", "type": "string" }, "message": { "description": "The human-readable warning message.", "type": "string" } }, "required": [ "code", "message" ] } } }, "transaction-review": { "variant": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "const": true, "description": "Whether the tool invocation succeeded." }, "data": { "type": [ "object", "null" ], "properties": { "receiptId": { "description": "Opaque identifier required by transaction-commit in approval-required mode.", "type": "string" }, "expiresAt": { "description": "UTC instant after which this receipt cannot be approved.", "type": "string", "format": "date-time" }, "algorithm": { "description": "Versioned canonicalisation algorithm used for the change-set digest.", "type": "string" }, "changeSetDigest": { "description": "Lowercase SHA-256 digest of the exact validated persistence set.", "type": "string" }, "workspaceId": { "description": "Workspace identifier bound to this receipt.", "type": "string", "format": "uuid" }, "workspaceEpoch": { "description": "Workspace load epoch bound to this receipt.", "type": "integer" }, "snapshotId": { "description": "Solution snapshot identifier bound to this receipt.", "type": "string", "format": "uuid" }, "transactionRevision": { "description": "Transaction revision bound to this receipt.", "type": "integer" }, "addedDocumentCount": { "description": "Number of files created by the reviewed change.", "type": "integer" }, "modifiedDocumentCount": { "description": "Number of files replaced by the reviewed change.", "type": "integer" }, "deletedDocumentCount": { "description": "Number of files deleted by the reviewed change.", "type": "integer" }, "transaction": { "description": "The active transaction info.", "type": "object", "properties": { "revision": { "description": "Current staged transaction revision.", "type": "integer" }, "revisionCount": { "description": "Number of revisions retained in transaction history.", "type": "integer" }, "maxRevisions": { "description": "Maximum number of revisions the transaction can retain.", "type": "integer" }, "remainingRevisions": { "description": "Number of additional revisions that can be staged.", "type": "integer" }, "canMutate": { "description": "Whether mutation tools may stage another change.", "type": "boolean" }, "canUndo": { "description": "Whether transaction history can move to the preceding revision.", "type": "boolean" }, "canRedo": { "description": "Whether transaction history can move to the following revision.", "type": "boolean" }, "canCommit": { "description": "Whether the staged transaction can be committed to disk.", "type": "boolean" }, "canRollback": { "description": "Whether the complete staged transaction can be discarded.", "type": "boolean" } } }, "documents": { "description": "Validated file operations in canonical path order.", "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "operation": { "type": "string", "enum": [ "Create", "Replace", "Delete" ] }, "originalExists": { "type": "boolean" }, "originalHash": { "type": [ "string", "null" ] }, "intendedHash": { "type": [ "string", "null" ] }, "intendedUnixFileMode": { "type": [ "integer", "null" ] }, "projects": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "targetFramework": { "type": [ "string", "null" ] } }, "required": [ "path" ] } }, "classification": { "type": "string" }, "contained": { "type": "boolean" }, "lineSummary": { "type": [ "object", "null" ], "properties": { "addedLines": { "description": "The number of added lines.", "type": "integer" }, "removedLines": { "description": "The number of removed lines.", "type": "integer" }, "changedLines": { "description": "The number of changed lines.", "type": "integer" } } } }, "required": [ "path", "operation", "originalExists" ] } }, "provenance": { "description": "Mutation revisions contributing to the reviewed transaction.", "type": "array", "items": { "type": "object", "properties": { "revision": { "description": "One-based transaction revision.", "type": "integer" }, "operation": { "description": "Mutation operation recorded for the revision.", "type": "string" }, "summary": { "description": "Concise mutation summary recorded for the revision.", "type": "string" }, "codeAction": { "description": "Code Action attribution when this revision was produced by a Code Action.", "type": [ "object", "null" ], "properties": { "kind": { "description": "Code Action family that produced the mutation.", "type": "string", "enum": [ "CodeFix", "Refactoring", "FixAll" ] }, "providerId": { "description": "Response-local reference to the provider that originated the Code Action.", "type": "string" }, "fixAllProviderId": { "description": "Response-local reference to the Fix All provider when one assembled the operation.", "type": [ "string", "null" ] } }, "required": [ "kind", "providerId" ] } }, "required": [ "revision", "operation", "summary" ] } }, "providers": { "description": "Provider identities keyed by response-local references used by provenance entries.", "type": [ "object", "null" ], "additionalProperties": { "type": "object", "properties": { "typeName": { "description": "Fully qualified runtime type of the provider that supplied the mutation.", "type": "string" }, "assemblyName": { "description": "Simple name of the assembly containing the provider.", "type": "string" }, "assemblyVersion": { "description": "Version of the assembly containing the provider.", "type": "string" } }, "required": [ "typeName", "assemblyName", "assemblyVersion" ] } }, "validations": { "description": "Validations completed while producing this receipt.", "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "succeeded": { "type": "boolean" }, "message": { "type": "string" } }, "required": [ "name", "succeeded", "message" ] } }, "diff": { "description": "Optional detailed diff for the explicitly selected document.", "type": [ "object", "null" ], "properties": { "document": { "description": "Document for which the detailed diff was produced.", "type": [ "object", "null" ], "properties": { "documentId": { "description": "The document identifier.", "type": "string" }, "path": { "description": "The normalized document path.", "type": "string" }, "projectId": { "description": "The owning project identifier.", "type": "string" } }, "required": [ "documentId", "path", "projectId" ] }, "hunks": { "description": "Changed regions in unified-diff form.", "type": "array", "items": { "type": "object", "properties": { "originalStartLine": { "description": "One-based starting line in the original document.", "type": "integer" }, "originalLineCount": { "description": "Number of original-document lines covered by the hunk.", "type": "integer" }, "updatedStartLine": { "description": "One-based starting line in the updated document.", "type": "integer" }, "updatedLineCount": { "description": "Number of updated-document lines covered by the hunk.", "type": "integer" }, "lines": { "description": "Unified-diff content lines prefixed with space, \u002B, or -.", "type": "array", "items": { "type": "string" } } } } }, "truncated": { "description": "Whether one or more diff hunks were omitted from the response.", "type": "boolean" } } }, "continuation": { "description": "Structured next step for committing this exact reviewed transaction state.", "type": "object", "properties": { "kind": { "description": "Action required before the request can continue.", "type": "string", "enum": [ "CallTool", "ChooseTool", "RetryRequest", "ReviseRequest", "ResolveExternally" ] }, "tool": { "description": "Tool to call when kind is CallTool.", "type": [ "string", "null" ] }, "tools": { "description": "Allowed tool choices when kind is ChooseTool.", "type": [ "array", "null" ], "items": { "type": "string" } }, "instruction": { "description": "Agent-facing instruction explaining how to continue.", "type": [ "string", "null" ] } } } }, "required": [ "receiptId", "expiresAt", "algorithm", "changeSetDigest", "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision", "addedDocumentCount", "modifiedDocumentCount", "deletedDocumentCount", "transaction", "continuation" ], "description": "Tool-specific result payload." }, "snapshot": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ], "description": "Exact immutable workspace snapshot associated with the result, when available." }, "warnings": { "type": "array", "description": "Non-fatal warnings the agent should consider.", "items": { "$ref": "#/$defs/warningInfo" } } } }, "definitions": { "warningInfo": { "type": "object", "properties": { "code": { "description": "The stable machine-readable warning code.", "type": "string" }, "message": { "description": "The human-readable warning message.", "type": "string" } }, "required": [ "code", "message" ] } } }, "transaction-rollback": { "variant": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "const": true, "description": "Whether the tool invocation succeeded." }, "data": { "type": [ "object", "null" ], "properties": { "state": { "description": "The resulting workspace state after rollback.", "type": "string", "enum": [ "Ready", "WorkspaceOutOfDate" ] } }, "description": "Tool-specific result payload." }, "snapshot": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ], "description": "Exact immutable workspace snapshot associated with the result, when available." }, "warnings": { "type": "array", "description": "Non-fatal warnings the agent should consider.", "items": { "$ref": "#/$defs/warningInfo" } } } }, "definitions": { "warningInfo": { "type": "object", "properties": { "code": { "description": "The stable machine-readable warning code.", "type": "string" }, "message": { "description": "The human-readable warning message.", "type": "string" } }, "required": [ "code", "message" ] } } }, "transaction-start": { "variant": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "const": true, "description": "Whether the tool invocation succeeded." }, "data": { "type": [ "object", "null" ], "properties": { "transaction": { "description": "The active transaction info.", "type": [ "object", "null" ], "properties": { "revision": { "description": "Current staged transaction revision.", "type": "integer" }, "revisionCount": { "description": "Number of revisions retained in transaction history.", "type": "integer" }, "maxRevisions": { "description": "Maximum number of revisions the transaction can retain.", "type": "integer" }, "remainingRevisions": { "description": "Number of additional revisions that can be staged.", "type": "integer" }, "canMutate": { "description": "Whether mutation tools may stage another change.", "type": "boolean" }, "canUndo": { "description": "Whether transaction history can move to the preceding revision.", "type": "boolean" }, "canRedo": { "description": "Whether transaction history can move to the following revision.", "type": "boolean" }, "canCommit": { "description": "Whether the staged transaction can be committed to disk.", "type": "boolean" }, "canRollback": { "description": "Whether the complete staged transaction can be discarded.", "type": "boolean" } } } }, "description": "Tool-specific result payload." }, "snapshot": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ], "description": "Exact immutable workspace snapshot associated with the result, when available." }, "warnings": { "type": "array", "description": "Non-fatal warnings the agent should consider.", "items": { "$ref": "#/$defs/warningInfo" } } } }, "definitions": { "warningInfo": { "type": "object", "properties": { "code": { "description": "The stable machine-readable warning code.", "type": "string" }, "message": { "description": "The human-readable warning message.", "type": "string" } }, "required": [ "code", "message" ] } } }, "transaction-validate": { "variant": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "const": true, "description": "Whether the tool invocation succeeded." }, "data": { "type": [ "object", "null" ], "properties": { "algorithm": { "description": "Stable diagnostic identity algorithm used for baseline comparison.", "type": "string" }, "isComplete": { "description": "Whether every affected loaded project evaluation completed.", "type": "boolean" }, "succeeded": { "description": "Whether validation completed and found no newly introduced compiler errors.", "type": "boolean" }, "incompleteReasons": { "description": "Reasons why compiler-impact validation was incomplete.", "type": "array", "items": { "type": "string", "enum": [ "None", "ExternalWorkspaceInputsChanged", "WorkspaceLoadError", "ProjectUnavailable", "CompilationUnavailable" ] } }, "transaction": { "description": "Transaction state bound to this validation result.", "type": "object", "properties": { "revision": { "description": "Current staged transaction revision.", "type": "integer" }, "revisionCount": { "description": "Number of revisions retained in transaction history.", "type": "integer" }, "maxRevisions": { "description": "Maximum number of revisions the transaction can retain.", "type": "integer" }, "remainingRevisions": { "description": "Number of additional revisions that can be staged.", "type": "integer" }, "canMutate": { "description": "Whether mutation tools may stage another change.", "type": "boolean" }, "canUndo": { "description": "Whether transaction history can move to the preceding revision.", "type": "boolean" }, "canRedo": { "description": "Whether transaction history can move to the following revision.", "type": "boolean" }, "canCommit": { "description": "Whether the staged transaction can be committed to disk.", "type": "boolean" }, "canRollback": { "description": "Whether the complete staged transaction can be discarded.", "type": "boolean" } } }, "baselineErrorCount": { "description": "Total baseline compiler-error count in evaluated projects.", "type": "integer" }, "stagedErrorCount": { "description": "Total staged compiler-error count in evaluated projects.", "type": "integer" }, "introducedErrorCount": { "description": "Number of staged compiler errors not present in the baseline multiset.", "type": "integer" }, "durationMilliseconds": { "description": "Elapsed compiler validation time in milliseconds.", "type": "integer" }, "projects": { "description": "Affected loaded project evaluations and their compiler-error counts.", "type": "array", "items": { "type": "object", "properties": { "project": { "description": "Workspace-relative path for the evaluated project.", "type": "string" }, "targetFramework": { "description": "Loaded target-framework identity when available.", "type": [ "string", "null" ] }, "isComplete": { "description": "Whether baseline and staged compiler evaluations completed.", "type": "boolean" }, "baselineErrorCount": { "description": "Baseline compiler-error count for this project evaluation.", "type": "integer" }, "stagedErrorCount": { "description": "Staged compiler-error count for this project evaluation.", "type": "integer" }, "introducedErrorCount": { "description": "Newly introduced compiler-error count for this project evaluation.", "type": "integer" } }, "required": [ "project", "isComplete", "baselineErrorCount", "stagedErrorCount", "introducedErrorCount" ] } }, "introducedDiagnostics": { "description": "Bounded projection of newly introduced compiler errors.", "type": "array", "items": { "type": "object", "properties": { "id": { "description": "The diagnostic identifier.", "type": "string" }, "severity": { "description": "The diagnostic severity.", "type": "string", "enum": [ "Hidden", "Info", "Warning", "Error" ] }, "message": { "description": "The diagnostic message.", "type": "string" }, "location": { "description": "The optional source location of the diagnostic.", "type": [ "object", "null" ], "properties": { "document": { "description": "The resolved document.", "type": [ "object", "null" ], "properties": { "documentId": { "description": "The document identifier.", "type": "string" }, "path": { "description": "The normalized document path.", "type": "string" }, "projectId": { "description": "The owning project identifier.", "type": "string" } }, "required": [ "documentId", "path", "projectId" ] }, "span": { "description": "The resolved text span.", "type": [ "object", "null" ], "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } }, "line": { "description": "The one-based line number.", "type": "integer" }, "column": { "description": "The one-based column number.", "type": "integer" }, "snapshot": { "description": "The exact immutable workspace snapshot associated with this location.", "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ] }, "selector": { "description": "The canonical selector that can resolve this source location again.", "type": [ "object", "null" ], "properties": { "span": { "type": "object", "properties": { "document": { "description": "Provide exactly one of path or documentId.", "type": "object", "properties": { "project": { "description": "Disambiguates documents with matching paths or IDs.", "type": [ "object", "null" ], "properties": { "projectId": { "type": [ "string", "null" ] }, "name": { "type": [ "string", "null" ] }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "targetFramework": { "type": [ "string", "null" ] } } }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "documentId": { "description": "Workspace-local document ID.", "type": [ "string", "null" ] } } }, "range": { "description": "Zero-based UTF-16 range.", "type": "object", "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } } }, "required": [ "document", "range" ] } }, "required": [ "span" ] } }, "required": [ "snapshot" ] } }, "required": [ "id", "message" ] } }, "limitations": { "description": "Load, compilation and target-framework limitations relevant to the result.", "type": "array", "items": { "type": "string" } }, "continuation": { "description": "Structured next step after compiler-impact validation.", "type": "object", "properties": { "kind": { "description": "Action required before the request can continue.", "type": "string", "enum": [ "CallTool", "ChooseTool", "RetryRequest", "ReviseRequest", "ResolveExternally" ] }, "tool": { "description": "Tool to call when kind is CallTool.", "type": [ "string", "null" ] }, "tools": { "description": "Allowed tool choices when kind is ChooseTool.", "type": [ "array", "null" ], "items": { "type": "string" } }, "instruction": { "description": "Agent-facing instruction explaining how to continue.", "type": [ "string", "null" ] } } } }, "required": [ "algorithm", "isComplete", "succeeded", "transaction", "baselineErrorCount", "stagedErrorCount", "introducedErrorCount", "durationMilliseconds", "continuation" ], "description": "Tool-specific result payload." }, "snapshot": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ], "description": "Exact immutable workspace snapshot associated with the result, when available." }, "warnings": { "type": "array", "description": "Non-fatal warnings the agent should consider.", "items": { "$ref": "#/$defs/warningInfo" } } } }, "definitions": { "warningInfo": { "type": "object", "properties": { "code": { "description": "The stable machine-readable warning code.", "type": "string" }, "message": { "description": "The human-readable warning message.", "type": "string" } }, "required": [ "code", "message" ] } } }, "workspace-close": { "variant": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "const": true, "description": "Whether the tool invocation succeeded." }, "data": { "type": [ "object", "null" ], "properties": { "closedPath": { "description": "The path that was closed.", "type": "string" } }, "required": [ "closedPath" ], "description": "Tool-specific result payload." }, "snapshot": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ], "description": "Exact immutable workspace snapshot associated with the result, when available." }, "warnings": { "type": "array", "description": "Non-fatal warnings the agent should consider.", "items": { "$ref": "#/$defs/warningInfo" } } } }, "definitions": { "warningInfo": { "type": "object", "properties": { "code": { "description": "The stable machine-readable warning code.", "type": "string" }, "message": { "description": "The human-readable warning message.", "type": "string" } }, "required": [ "code", "message" ] } } }, "workspace-list": { "variant": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "const": true, "description": "Whether the tool invocation succeeded." }, "data": { "type": [ "object", "null" ], "properties": { "workspaces": { "description": "The loaded workspaces.", "type": "array", "items": { "type": "object", "properties": { "workspaceId": { "description": "The stable server-generated workspace identifier.", "type": "string", "format": "uuid" }, "alias": { "description": "The optional caller-friendly alias.", "type": [ "string", "null" ] }, "workspaceEpoch": { "description": "The workspace epoch for the loaded baseline.", "type": "integer" }, "loadedPath": { "description": "The absolute path of the loaded workspace.", "type": "string" }, "workspaceRoot": { "description": "The absolute repository or workspace root used for coordination and transaction boundaries.", "type": "string" } }, "required": [ "loadedPath", "workspaceRoot" ] } }, "transactionOwnerWorkspaceId": { "description": "The workspace identifier that currently owns the global transaction slot, when present.", "type": [ "string", "null" ], "format": "uuid" } }, "description": "Tool-specific result payload." }, "snapshot": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ], "description": "Exact immutable workspace snapshot associated with the result, when available." }, "warnings": { "type": "array", "description": "Non-fatal warnings the agent should consider.", "items": { "$ref": "#/$defs/warningInfo" } } } }, "definitions": { "warningInfo": { "type": "object", "properties": { "code": { "description": "The stable machine-readable warning code.", "type": "string" }, "message": { "description": "The human-readable warning message.", "type": "string" } }, "required": [ "code", "message" ] } } }, "workspace-open": { "variant": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "const": true, "description": "Whether the tool invocation succeeded." }, "data": { "type": [ "object", "null" ], "properties": { "workspace": { "description": "The loaded workspace identity.", "type": [ "object", "null" ], "properties": { "workspaceId": { "description": "The stable server-generated workspace identifier.", "type": "string", "format": "uuid" }, "alias": { "description": "The optional caller-friendly alias.", "type": [ "string", "null" ] }, "workspaceEpoch": { "description": "The workspace epoch for the loaded baseline.", "type": "integer" }, "loadedPath": { "description": "The absolute path of the loaded workspace.", "type": "string" }, "workspaceRoot": { "description": "The absolute repository or workspace root used for coordination and transaction boundaries.", "type": "string" } }, "required": [ "loadedPath", "workspaceRoot" ] }, "projectCount": { "description": "The loaded project count.", "type": "integer" }, "documentCount": { "description": "The loaded document count.", "type": "integer" }, "loadDiagnostics": { "description": "Workspace load and advisory status diagnostics.", "type": "array", "items": { "type": "object", "properties": { "id": { "description": "The diagnostic identifier.", "type": "string" }, "severity": { "description": "The diagnostic severity.", "type": "string", "enum": [ "Hidden", "Info", "Warning", "Error" ] }, "message": { "description": "The diagnostic message.", "type": "string" }, "location": { "description": "The optional source location of the diagnostic.", "type": [ "object", "null" ], "properties": { "document": { "description": "The resolved document.", "type": [ "object", "null" ], "properties": { "documentId": { "description": "The document identifier.", "type": "string" }, "path": { "description": "The normalized document path.", "type": "string" }, "projectId": { "description": "The owning project identifier.", "type": "string" } }, "required": [ "documentId", "path", "projectId" ] }, "span": { "description": "The resolved text span.", "type": [ "object", "null" ], "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } }, "line": { "description": "The one-based line number.", "type": "integer" }, "column": { "description": "The one-based column number.", "type": "integer" }, "snapshot": { "description": "The exact immutable workspace snapshot associated with this location.", "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ] }, "selector": { "description": "The canonical selector that can resolve this source location again.", "type": [ "object", "null" ], "properties": { "span": { "type": "object", "properties": { "document": { "description": "Provide exactly one of path or documentId.", "type": "object", "properties": { "project": { "description": "Disambiguates documents with matching paths or IDs.", "type": [ "object", "null" ], "properties": { "projectId": { "type": [ "string", "null" ] }, "name": { "type": [ "string", "null" ] }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "targetFramework": { "type": [ "string", "null" ] } } }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "documentId": { "description": "Workspace-local document ID.", "type": [ "string", "null" ] } } }, "range": { "description": "Zero-based UTF-16 range.", "type": "object", "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } } }, "required": [ "document", "range" ] } }, "required": [ "span" ] } }, "required": [ "snapshot" ] } }, "required": [ "id", "message" ] } } }, "description": "Tool-specific result payload." }, "snapshot": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ], "description": "Exact immutable workspace snapshot associated with the result, when available." }, "warnings": { "type": "array", "description": "Non-fatal warnings the agent should consider.", "items": { "$ref": "#/$defs/warningInfo" } } } }, "definitions": { "warningInfo": { "type": "object", "properties": { "code": { "description": "The stable machine-readable warning code.", "type": "string" }, "message": { "description": "The human-readable warning message.", "type": "string" } }, "required": [ "code", "message" ] } } }, "workspace-reload": { "variant": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "const": true, "description": "Whether the tool invocation succeeded." }, "data": { "type": [ "object", "null" ], "properties": { "workspace": { "description": "The reloaded workspace identity.", "type": [ "object", "null" ], "properties": { "workspaceId": { "description": "The stable server-generated workspace identifier.", "type": "string", "format": "uuid" }, "alias": { "description": "The optional caller-friendly alias.", "type": [ "string", "null" ] }, "workspaceEpoch": { "description": "The workspace epoch for the loaded baseline.", "type": "integer" }, "loadedPath": { "description": "The absolute path of the loaded workspace.", "type": "string" }, "workspaceRoot": { "description": "The absolute repository or workspace root used for coordination and transaction boundaries.", "type": "string" } }, "required": [ "loadedPath", "workspaceRoot" ] }, "projectCount": { "description": "The loaded project count.", "type": "integer" }, "documentCount": { "description": "The loaded document count.", "type": "integer" }, "loadDiagnostics": { "description": "The workspace load diagnostics.", "type": "array", "items": { "type": "object", "properties": { "id": { "description": "The diagnostic identifier.", "type": "string" }, "severity": { "description": "The diagnostic severity.", "type": "string", "enum": [ "Hidden", "Info", "Warning", "Error" ] }, "message": { "description": "The diagnostic message.", "type": "string" }, "location": { "description": "The optional source location of the diagnostic.", "type": [ "object", "null" ], "properties": { "document": { "description": "The resolved document.", "type": [ "object", "null" ], "properties": { "documentId": { "description": "The document identifier.", "type": "string" }, "path": { "description": "The normalized document path.", "type": "string" }, "projectId": { "description": "The owning project identifier.", "type": "string" } }, "required": [ "documentId", "path", "projectId" ] }, "span": { "description": "The resolved text span.", "type": [ "object", "null" ], "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } }, "line": { "description": "The one-based line number.", "type": "integer" }, "column": { "description": "The one-based column number.", "type": "integer" }, "snapshot": { "description": "The exact immutable workspace snapshot associated with this location.", "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ] }, "selector": { "description": "The canonical selector that can resolve this source location again.", "type": [ "object", "null" ], "properties": { "span": { "type": "object", "properties": { "document": { "description": "Provide exactly one of path or documentId.", "type": "object", "properties": { "project": { "description": "Disambiguates documents with matching paths or IDs.", "type": [ "object", "null" ], "properties": { "projectId": { "type": [ "string", "null" ] }, "name": { "type": [ "string", "null" ] }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "targetFramework": { "type": [ "string", "null" ] } } }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "documentId": { "description": "Workspace-local document ID.", "type": [ "string", "null" ] } } }, "range": { "description": "Zero-based UTF-16 range.", "type": "object", "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } } }, "required": [ "document", "range" ] } }, "required": [ "span" ] } }, "required": [ "snapshot" ] } }, "required": [ "id", "message" ] } } }, "description": "Tool-specific result payload." }, "snapshot": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ], "description": "Exact immutable workspace snapshot associated with the result, when available." }, "warnings": { "type": "array", "description": "Non-fatal warnings the agent should consider.", "items": { "$ref": "#/$defs/warningInfo" } } } }, "definitions": { "warningInfo": { "type": "object", "properties": { "code": { "description": "The stable machine-readable warning code.", "type": "string" }, "message": { "description": "The human-readable warning message.", "type": "string" } }, "required": [ "code", "message" ] } } }, "workspace-status": { "variant": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "const": true, "description": "Whether the tool invocation succeeded." }, "data": { "type": [ "object", "null" ], "properties": { "state": { "description": "The workspace lifecycle state.", "type": "string", "enum": [ "Ready", "TransactionActive", "TransactionConflicted", "WorkspaceOutOfDate" ] }, "workspace": { "description": "The loaded workspace identity, when present.", "type": [ "object", "null" ], "properties": { "workspaceId": { "description": "The stable server-generated workspace identifier.", "type": "string", "format": "uuid" }, "alias": { "description": "The optional caller-friendly alias.", "type": [ "string", "null" ] }, "workspaceEpoch": { "description": "The workspace epoch for the loaded baseline.", "type": "integer" }, "loadedPath": { "description": "The absolute path of the loaded workspace.", "type": "string" }, "workspaceRoot": { "description": "The absolute repository or workspace root used for coordination and transaction boundaries.", "type": "string" } }, "required": [ "loadedPath", "workspaceRoot" ] }, "projectCount": { "description": "The loaded project count, when present.", "type": [ "integer", "null" ] }, "documentCount": { "description": "The loaded document count, when present.", "type": [ "integer", "null" ] }, "loadDiagnostics": { "description": "Project load and advisory workspace-status diagnostics.", "type": [ "array", "null" ], "items": { "type": "object", "properties": { "id": { "description": "The diagnostic identifier.", "type": "string" }, "severity": { "description": "The diagnostic severity.", "type": "string", "enum": [ "Hidden", "Info", "Warning", "Error" ] }, "message": { "description": "The diagnostic message.", "type": "string" }, "location": { "description": "The optional source location of the diagnostic.", "type": [ "object", "null" ], "properties": { "document": { "description": "The resolved document.", "type": [ "object", "null" ], "properties": { "documentId": { "description": "The document identifier.", "type": "string" }, "path": { "description": "The normalized document path.", "type": "string" }, "projectId": { "description": "The owning project identifier.", "type": "string" } }, "required": [ "documentId", "path", "projectId" ] }, "span": { "description": "The resolved text span.", "type": [ "object", "null" ], "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } }, "line": { "description": "The one-based line number.", "type": "integer" }, "column": { "description": "The one-based column number.", "type": "integer" }, "snapshot": { "description": "The exact immutable workspace snapshot associated with this location.", "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ] }, "selector": { "description": "The canonical selector that can resolve this source location again.", "type": [ "object", "null" ], "properties": { "span": { "type": "object", "properties": { "document": { "description": "Provide exactly one of path or documentId.", "type": "object", "properties": { "project": { "description": "Disambiguates documents with matching paths or IDs.", "type": [ "object", "null" ], "properties": { "projectId": { "type": [ "string", "null" ] }, "name": { "type": [ "string", "null" ] }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "targetFramework": { "type": [ "string", "null" ] } } }, "path": { "description": "Workspace-relative path.", "type": [ "string", "null" ] }, "documentId": { "description": "Workspace-local document ID.", "type": [ "string", "null" ] } } }, "range": { "description": "Zero-based UTF-16 range.", "type": "object", "properties": { "start": { "description": "Zero-based UTF-16 offset.", "type": "integer", "minimum": 0, "maximum": 2147483647 }, "length": { "description": "UTF-16 code-unit length.", "type": "integer", "minimum": 0, "maximum": 2147483647 } } } }, "required": [ "document", "range" ] } }, "required": [ "span" ] } }, "required": [ "snapshot" ] } }, "required": [ "id", "message" ] } }, "transaction": { "description": "The active transaction info, when present.", "type": [ "object", "null" ], "properties": { "revision": { "description": "Current staged transaction revision.", "type": "integer" }, "revisionCount": { "description": "Number of revisions retained in transaction history.", "type": "integer" }, "maxRevisions": { "description": "Maximum number of revisions the transaction can retain.", "type": "integer" }, "remainingRevisions": { "description": "Number of additional revisions that can be staged.", "type": "integer" }, "canMutate": { "description": "Whether mutation tools may stage another change.", "type": "boolean" }, "canUndo": { "description": "Whether transaction history can move to the preceding revision.", "type": "boolean" }, "canRedo": { "description": "Whether transaction history can move to the following revision.", "type": "boolean" }, "canCommit": { "description": "Whether the staged transaction can be committed to disk.", "type": "boolean" }, "canRollback": { "description": "Whether the complete staged transaction can be discarded.", "type": "boolean" } } }, "reloadRequired": { "description": "Whether the workspace requires reload.", "type": "boolean" }, "externalChange": { "description": "The first detected external Workspace input change, when present.", "type": [ "object", "null" ], "properties": { "detectionSource": { "description": "The mechanism that detected the change.", "type": "string" }, "errorCode": { "description": "The stable error classification when change detection itself failed.", "type": [ "string", "null" ] }, "kind": { "description": "The detected change kind.", "type": "string" }, "path": { "description": "The affected path, when the detection mechanism identified one.", "type": [ "string", "null" ] }, "previousPath": { "description": "The previous path for a rename, when present.", "type": [ "string", "null" ] } }, "required": [ "detectionSource", "kind" ] }, "instances": { "description": "Other live Roslyn Workbench MCP instances using this workspace.", "type": "array", "items": { "type": "object", "properties": { "instanceId": { "description": "Identifier of the other Roslyn Workbench server instance.", "type": "string" }, "loadedPath": { "description": "Absolute solution or project path loaded by the other instance.", "type": "string" }, "workspaceRoot": { "description": "Absolute coordination and transaction root used by the other instance.", "type": "string" }, "workspaceState": { "description": "Workspace lifecycle state reported by the other instance.", "type": "string", "enum": [ "Ready", "TransactionActive", "TransactionConflicted", "WorkspaceOutOfDate" ] }, "transactionRevision": { "description": "Staged transaction revision in the other instance, when a transaction is active.", "type": [ "integer", "null" ] }, "commitId": { "description": "Durable commit identifier reported by the other instance, when a commit is active.", "type": [ "string", "null" ] }, "commitPhase": { "description": "Advisory durable commit phase reported by the other instance, when a commit is active.", "type": [ "string", "null" ] } }, "required": [ "instanceId", "loadedPath", "workspaceRoot" ] } }, "errorReportingConsent": { "description": "The process-local error-reporting approval applying to this Workspace and epoch.", "type": [ "string", "null" ] } }, "description": "Tool-specific result payload." }, "snapshot": { "type": "object", "properties": { "workspaceId": { "type": "string", "format": "uuid" }, "workspaceEpoch": { "type": "integer" }, "snapshotId": { "type": "string", "format": "uuid" }, "transactionRevision": { "type": [ "integer", "null" ] } }, "required": [ "workspaceId", "workspaceEpoch", "snapshotId", "transactionRevision" ], "description": "Exact immutable workspace snapshot associated with the result, when available." }, "warnings": { "type": "array", "description": "Non-fatal warnings the agent should consider.", "items": { "$ref": "#/$defs/warningInfo" } } } }, "definitions": { "warningInfo": { "type": "object", "properties": { "code": { "description": "The stable machine-readable warning code.", "type": "string" }, "message": { "description": "The human-readable warning message.", "type": "string" } }, "required": [ "code", "message" ] } } } } } } ], "evidence": [ { "level": "contract", "project": "test/Roslyn.Workbench.Mcp.IntegrationTest/Roslyn.Workbench.Mcp.IntegrationTest.csproj", "source": "test/Roslyn.Workbench.Mcp.IntegrationTest/Protocol/ToolSchemaFactoryIntegrationTests.cs", "test": "Roslyn.Workbench.Mcp.Test.Protocol.ToolSchemaFactoryIntegrationTests.GIVEN_RuntimeFailureVariants_WHEN_ValidatingPublishedOutputSchema_THEN_ShouldAcceptEveryEnvelope" }, { "level": "integration", "project": "test/Roslyn.Workbench.Mcp.IntegrationTest/Roslyn.Workbench.Mcp.IntegrationTest.csproj", "source": "test/Roslyn.Workbench.Mcp.IntegrationTest/Protocol/ToolSchemaFactoryIntegrationTests.cs", "test": "Roslyn.Workbench.Mcp.Test.Protocol.ToolSchemaFactoryIntegrationTests.GIVEN_StatusOutputSchemas_WHEN_ExportingRecursiveContracts_THEN_ShouldMatchCompleteStatusGraphs" }, { "level": "integration", "project": "test/Roslyn.Workbench.Mcp.IntegrationTest/Roslyn.Workbench.Mcp.IntegrationTest.csproj", "source": "test/Roslyn.Workbench.Mcp.IntegrationTest/ToolReference/PublishedErrorCodeSourceValidatorTests.cs", "test": "Roslyn.Workbench.Mcp.Test.ToolReference.PublishedErrorCodeSourceValidatorTests.GIVEN_RepositoryProductionSources_WHEN_ValidatingErrorEmitters_THEN_ShouldUseOwnedConstants" }, { "level": "integration", "project": "test/Roslyn.Workbench.Mcp.IntegrationTest/Roslyn.Workbench.Mcp.IntegrationTest.csproj", "source": "test/Roslyn.Workbench.Mcp.IntegrationTest/ToolReference/SecurityReferenceGeneratorIntegrationTests.cs", "test": "Roslyn.Workbench.Mcp.Test.ToolReference.SecurityReferenceGeneratorIntegrationTests.GIVEN_ProductionToolMatrix_WHEN_CollectingResponseContracts_THEN_ShouldLockEverySuccessAndRuntimeFailureShape" }, { "level": "integration", "project": "test/Roslyn.Workbench.Mcp.IntegrationTest/Roslyn.Workbench.Mcp.IntegrationTest.csproj", "source": "test/Roslyn.Workbench.Mcp.IntegrationTest/ToolReference/SecurityReferenceGeneratorIntegrationTests.cs", "test": "Roslyn.Workbench.Mcp.Test.ToolReference.SecurityReferenceGeneratorIntegrationTests.GIVEN_SecurityRelevantContracts_WHEN_CollectingSecuritySurface_THEN_ShouldIncludeDerivedCompatibilityFacts" } ] }, { "id": "startup-policy-and-tool-publication", "title": "Startup policy fixes the published capability surface", "classification": "enforced", "actor": "Roslyn Workbench Host", "outcome": "The startup-selected operational mode resolves to immutable policy primitives, and only tools permitted by that effective policy are published.", "boundary": "Enforcement begins during Host composition and applies to the built-in tools published by that process. MCP requests cannot widen the startup policy.", "residualRisk": "An authorised operator can restart the Host with different settings. External plugin code runs within the separately documented plugin boundary.", "surface": [ { "key": "configuration:inspection-only:no-new-compiler-errors", "category": "configuration", "facts": { "supported": false } }, { "key": "effective-policy:approval-required:no-new-compiler-errors", "category": "effective-policy", "facts": { "sourceMutation": "enabled", "commitAuthorisation": "receipt-approval", "commitValidation": "no-new-compiler-errors" } }, { "key": "effective-policy:approval-required:none", "category": "effective-policy", "facts": { "sourceMutation": "enabled", "commitAuthorisation": "receipt-approval", "commitValidation": "none" } }, { "key": "effective-policy:autonomous-trusted:no-new-compiler-errors", "category": "effective-policy", "facts": { "sourceMutation": "enabled", "commitAuthorisation": "none", "commitValidation": "no-new-compiler-errors" } }, { "key": "effective-policy:autonomous-trusted:none", "category": "effective-policy", "facts": { "sourceMutation": "enabled", "commitAuthorisation": "none", "commitValidation": "none" } }, { "key": "effective-policy:inspection-only:none", "category": "effective-policy", "facts": { "sourceMutation": "disabled", "commitAuthorisation": "none", "commitValidation": "none" } }, { "key": "effective-policy:transactional:no-new-compiler-errors", "category": "effective-policy", "facts": { "sourceMutation": "enabled", "commitAuthorisation": "confirmation", "commitValidation": "no-new-compiler-errors" } }, { "key": "effective-policy:transactional:none", "category": "effective-policy", "facts": { "sourceMutation": "enabled", "commitAuthorisation": "confirmation", "commitValidation": "none" } }, { "key": "operational-mode:approval-required", "category": "operational-mode", "facts": { "supportedCommitValidation": [ "none", "no-new-compiler-errors" ] } }, { "key": "operational-mode:autonomous-trusted", "category": "operational-mode", "facts": { "supportedCommitValidation": [ "none", "no-new-compiler-errors" ] } }, { "key": "operational-mode:inspection-only", "category": "operational-mode", "facts": { "supportedCommitValidation": [ "none" ] } }, { "key": "operational-mode:transactional", "category": "operational-mode", "facts": { "supportedCommitValidation": [ "none", "no-new-compiler-errors" ] } }, { "key": "policy:commit-authorisation:confirmation", "category": "policy:commit-authorisation", "facts": { "numericValue": 1 } }, { "key": "policy:commit-authorisation:none", "category": "policy:commit-authorisation", "facts": { "numericValue": 0 } }, { "key": "policy:commit-authorisation:receipt-approval", "category": "policy:commit-authorisation", "facts": { "numericValue": 2 } }, { "key": "policy:commit-validation:no-new-compiler-errors", "category": "policy:commit-validation", "facts": { "numericValue": 1 } }, { "key": "policy:commit-validation:none", "category": "policy:commit-validation", "facts": { "numericValue": 0 } }, { "key": "policy:source-mutation:disabled", "category": "policy:source-mutation", "facts": { "numericValue": 0 } }, { "key": "policy:source-mutation:enabled", "category": "policy:source-mutation", "facts": { "numericValue": 1 } }, { "key": "status-field:commitConfirmationRequired", "category": "status-field", "facts": { "type": "boolean", "required": true, "nullable": false } }, { "key": "status-field:compilerValidationRequired", "category": "status-field", "facts": { "type": "boolean", "required": true, "nullable": false } }, { "key": "status-field:operationalMode", "category": "status-field", "facts": { "type": "string", "required": true, "nullable": false } }, { "key": "status-field:receiptApprovalRequired", "category": "status-field", "facts": { "type": "boolean", "required": true, "nullable": false } }, { "key": "status-field:sourceMutationEnabled", "category": "status-field", "facts": { "type": "boolean", "required": true, "nullable": false } }, { "key": "status-field:toolOutputSchemaMode", "category": "status-field", "facts": { "type": "string", "required": true, "nullable": false } }, { "key": "tool:analyze-async", "category": "tool", "facts": { "availability": [ "approval-required;no-new-compiler-errors;reporting-disabled", "approval-required;no-new-compiler-errors;reporting-enabled", "approval-required;none;reporting-disabled", "approval-required;none;reporting-enabled", "autonomous-trusted;no-new-compiler-errors;reporting-disabled", "autonomous-trusted;no-new-compiler-errors;reporting-enabled", "autonomous-trusted;none;reporting-disabled", "autonomous-trusted;none;reporting-enabled", "inspection-only;none;reporting-disabled", "inspection-only;none;reporting-enabled", "transactional;no-new-compiler-errors;reporting-disabled", "transactional;no-new-compiler-errors;reporting-enabled", "transactional;none;reporting-disabled", "transactional;none;reporting-enabled" ] } }, { "key": "tool:analyze-control-flow", "category": "tool", "facts": { "availability": [ "approval-required;no-new-compiler-errors;reporting-disabled", "approval-required;no-new-compiler-errors;reporting-enabled", "approval-required;none;reporting-disabled", "approval-required;none;reporting-enabled", "autonomous-trusted;no-new-compiler-errors;reporting-disabled", "autonomous-trusted;no-new-compiler-errors;reporting-enabled", "autonomous-trusted;none;reporting-disabled", "autonomous-trusted;none;reporting-enabled", "inspection-only;none;reporting-disabled", "inspection-only;none;reporting-enabled", "transactional;no-new-compiler-errors;reporting-disabled", "transactional;no-new-compiler-errors;reporting-enabled", "transactional;none;reporting-disabled", "transactional;none;reporting-enabled" ] } }, { "key": "tool:analyze-data-flow", "category": "tool", "facts": { "availability": [ "approval-required;no-new-compiler-errors;reporting-disabled", "approval-required;no-new-compiler-errors;reporting-enabled", "approval-required;none;reporting-disabled", "approval-required;none;reporting-enabled", "autonomous-trusted;no-new-compiler-errors;reporting-disabled", "autonomous-trusted;no-new-compiler-errors;reporting-enabled", "autonomous-trusted;none;reporting-disabled", "autonomous-trusted;none;reporting-enabled", "inspection-only;none;reporting-disabled", "inspection-only;none;reporting-enabled", "transactional;no-new-compiler-errors;reporting-disabled", "transactional;no-new-compiler-errors;reporting-enabled", "transactional;none;reporting-disabled", "transactional;none;reporting-enabled" ] } }, { "key": "tool:analyze-disposables", "category": "tool", "facts": { "availability": [ "approval-required;no-new-compiler-errors;reporting-disabled", "approval-required;no-new-compiler-errors;reporting-enabled", "approval-required;none;reporting-disabled", "approval-required;none;reporting-enabled", "autonomous-trusted;no-new-compiler-errors;reporting-disabled", "autonomous-trusted;no-new-compiler-errors;reporting-enabled", "autonomous-trusted;none;reporting-disabled", "autonomous-trusted;none;reporting-enabled", "inspection-only;none;reporting-disabled", "inspection-only;none;reporting-enabled", "transactional;no-new-compiler-errors;reporting-disabled", "transactional;no-new-compiler-errors;reporting-enabled", "transactional;none;reporting-disabled", "transactional;none;reporting-enabled" ] } }, { "key": "tool:analyze-nullability", "category": "tool", "facts": { "availability": [ "approval-required;no-new-compiler-errors;reporting-disabled", "approval-required;no-new-compiler-errors;reporting-enabled", "approval-required;none;reporting-disabled", "approval-required;none;reporting-enabled", "autonomous-trusted;no-new-compiler-errors;reporting-disabled", "autonomous-trusted;no-new-compiler-errors;reporting-enabled", "autonomous-trusted;none;reporting-disabled", "autonomous-trusted;none;reporting-enabled", "inspection-only;none;reporting-disabled", "inspection-only;none;reporting-enabled", "transactional;no-new-compiler-errors;reporting-disabled", "transactional;no-new-compiler-errors;reporting-enabled", "transactional;none;reporting-disabled", "transactional;none;reporting-enabled" ] } }, { "key": "tool:find-callees", "category": "tool", "facts": { "availability": [ "approval-required;no-new-compiler-errors;reporting-disabled", "approval-required;no-new-compiler-errors;reporting-enabled", "approval-required;none;reporting-disabled", "approval-required;none;reporting-enabled", "autonomous-trusted;no-new-compiler-errors;reporting-disabled", "autonomous-trusted;no-new-compiler-errors;reporting-enabled", "autonomous-trusted;none;reporting-disabled", "autonomous-trusted;none;reporting-enabled", "inspection-only;none;reporting-disabled", "inspection-only;none;reporting-enabled", "transactional;no-new-compiler-errors;reporting-disabled", "transactional;no-new-compiler-errors;reporting-enabled", "transactional;none;reporting-disabled", "transactional;none;reporting-enabled" ] } }, { "key": "tool:find-callers", "category": "tool", "facts": { "availability": [ "approval-required;no-new-compiler-errors;reporting-disabled", "approval-required;no-new-compiler-errors;reporting-enabled", "approval-required;none;reporting-disabled", "approval-required;none;reporting-enabled", "autonomous-trusted;no-new-compiler-errors;reporting-disabled", "autonomous-trusted;no-new-compiler-errors;reporting-enabled", "autonomous-trusted;none;reporting-disabled", "autonomous-trusted;none;reporting-enabled", "inspection-only;none;reporting-disabled", "inspection-only;none;reporting-enabled", "transactional;no-new-compiler-errors;reporting-disabled", "transactional;no-new-compiler-errors;reporting-enabled", "transactional;none;reporting-disabled", "transactional;none;reporting-enabled" ] } }, { "key": "tool:find-dependency-cycles", "category": "tool", "facts": { "availability": [ "approval-required;no-new-compiler-errors;reporting-disabled", "approval-required;no-new-compiler-errors;reporting-enabled", "approval-required;none;reporting-disabled", "approval-required;none;reporting-enabled", "autonomous-trusted;no-new-compiler-errors;reporting-disabled", "autonomous-trusted;no-new-compiler-errors;reporting-enabled", "autonomous-trusted;none;reporting-disabled", "autonomous-trusted;none;reporting-enabled", "inspection-only;none;reporting-disabled", "inspection-only;none;reporting-enabled", "transactional;no-new-compiler-errors;reporting-disabled", "transactional;no-new-compiler-errors;reporting-enabled", "transactional;none;reporting-disabled", "transactional;none;reporting-enabled" ] } }, { "key": "tool:find-derived-types", "category": "tool", "facts": { "availability": [ "approval-required;no-new-compiler-errors;reporting-disabled", "approval-required;no-new-compiler-errors;reporting-enabled", "approval-required;none;reporting-disabled", "approval-required;none;reporting-enabled", "autonomous-trusted;no-new-compiler-errors;reporting-disabled", "autonomous-trusted;no-new-compiler-errors;reporting-enabled", "autonomous-trusted;none;reporting-disabled", "autonomous-trusted;none;reporting-enabled", "inspection-only;none;reporting-disabled", "inspection-only;none;reporting-enabled", "transactional;no-new-compiler-errors;reporting-disabled", "transactional;no-new-compiler-errors;reporting-enabled", "transactional;none;reporting-disabled", "transactional;none;reporting-enabled" ] } }, { "key": "tool:find-duplicate-code", "category": "tool", "facts": { "availability": [ "approval-required;no-new-compiler-errors;reporting-disabled", "approval-required;no-new-compiler-errors;reporting-enabled", "approval-required;none;reporting-disabled", "approval-required;none;reporting-enabled", "autonomous-trusted;no-new-compiler-errors;reporting-disabled", "autonomous-trusted;no-new-compiler-errors;reporting-enabled", "autonomous-trusted;none;reporting-disabled", "autonomous-trusted;none;reporting-enabled", "inspection-only;none;reporting-disabled", "inspection-only;none;reporting-enabled", "transactional;no-new-compiler-errors;reporting-disabled", "transactional;no-new-compiler-errors;reporting-enabled", "transactional;none;reporting-disabled", "transactional;none;reporting-enabled" ] } }, { "key": "tool:find-implementations", "category": "tool", "facts": { "availability": [ "approval-required;no-new-compiler-errors;reporting-disabled", "approval-required;no-new-compiler-errors;reporting-enabled", "approval-required;none;reporting-disabled", "approval-required;none;reporting-enabled", "autonomous-trusted;no-new-compiler-errors;reporting-disabled", "autonomous-trusted;no-new-compiler-errors;reporting-enabled", "autonomous-trusted;none;reporting-disabled", "autonomous-trusted;none;reporting-enabled", "inspection-only;none;reporting-disabled", "inspection-only;none;reporting-enabled", "transactional;no-new-compiler-errors;reporting-disabled", "transactional;no-new-compiler-errors;reporting-enabled", "transactional;none;reporting-disabled", "transactional;none;reporting-enabled" ] } }, { "key": "tool:find-overloads", "category": "tool", "facts": { "availability": [ "approval-required;no-new-compiler-errors;reporting-disabled", "approval-required;no-new-compiler-errors;reporting-enabled", "approval-required;none;reporting-disabled", "approval-required;none;reporting-enabled", "autonomous-trusted;no-new-compiler-errors;reporting-disabled", "autonomous-trusted;no-new-compiler-errors;reporting-enabled", "autonomous-trusted;none;reporting-disabled", "autonomous-trusted;none;reporting-enabled", "inspection-only;none;reporting-disabled", "inspection-only;none;reporting-enabled", "transactional;no-new-compiler-errors;reporting-disabled", "transactional;no-new-compiler-errors;reporting-enabled", "transactional;none;reporting-disabled", "transactional;none;reporting-enabled" ] } }, { "key": "tool:find-overrides", "category": "tool", "facts": { "availability": [ "approval-required;no-new-compiler-errors;reporting-disabled", "approval-required;no-new-compiler-errors;reporting-enabled", "approval-required;none;reporting-disabled", "approval-required;none;reporting-enabled", "autonomous-trusted;no-new-compiler-errors;reporting-disabled", "autonomous-trusted;no-new-compiler-errors;reporting-enabled", "autonomous-trusted;none;reporting-disabled", "autonomous-trusted;none;reporting-enabled", "inspection-only;none;reporting-disabled", "inspection-only;none;reporting-enabled", "transactional;no-new-compiler-errors;reporting-disabled", "transactional;no-new-compiler-errors;reporting-enabled", "transactional;none;reporting-disabled", "transactional;none;reporting-enabled" ] } }, { "key": "tool:find-references", "category": "tool", "facts": { "availability": [ "approval-required;no-new-compiler-errors;reporting-disabled", "approval-required;no-new-compiler-errors;reporting-enabled", "approval-required;none;reporting-disabled", "approval-required;none;reporting-enabled", "autonomous-trusted;no-new-compiler-errors;reporting-disabled", "autonomous-trusted;no-new-compiler-errors;reporting-enabled", "autonomous-trusted;none;reporting-disabled", "autonomous-trusted;none;reporting-enabled", "inspection-only;none;reporting-disabled", "inspection-only;none;reporting-enabled", "transactional;no-new-compiler-errors;reporting-disabled", "transactional;no-new-compiler-errors;reporting-enabled", "transactional;none;reporting-disabled", "transactional;none;reporting-enabled" ] } }, { "key": "tool:find-unused-symbols", "category": "tool", "facts": { "availability": [ "approval-required;no-new-compiler-errors;reporting-disabled", "approval-required;no-new-compiler-errors;reporting-enabled", "approval-required;none;reporting-disabled", "approval-required;none;reporting-enabled", "autonomous-trusted;no-new-compiler-errors;reporting-disabled", "autonomous-trusted;no-new-compiler-errors;reporting-enabled", "autonomous-trusted;none;reporting-disabled", "autonomous-trusted;none;reporting-enabled", "inspection-only;none;reporting-disabled", "inspection-only;none;reporting-enabled", "transactional;no-new-compiler-errors;reporting-disabled", "transactional;no-new-compiler-errors;reporting-enabled", "transactional;none;reporting-disabled", "transactional;none;reporting-enabled" ] } }, { "key": "tool:format-document", "category": "tool", "facts": { "availability": [ "approval-required;no-new-compiler-errors;reporting-disabled", "approval-required;no-new-compiler-errors;reporting-enabled", "approval-required;none;reporting-disabled", "approval-required;none;reporting-enabled", "autonomous-trusted;no-new-compiler-errors;reporting-disabled", "autonomous-trusted;no-new-compiler-errors;reporting-enabled", "autonomous-trusted;none;reporting-disabled", "autonomous-trusted;none;reporting-enabled", "transactional;no-new-compiler-errors;reporting-disabled", "transactional;no-new-compiler-errors;reporting-enabled", "transactional;none;reporting-disabled", "transactional;none;reporting-enabled" ] } }, { "key": "tool:get-api-surface", "category": "tool", "facts": { "availability": [ "approval-required;no-new-compiler-errors;reporting-disabled", "approval-required;no-new-compiler-errors;reporting-enabled", "approval-required;none;reporting-disabled", "approval-required;none;reporting-enabled", "autonomous-trusted;no-new-compiler-errors;reporting-disabled", "autonomous-trusted;no-new-compiler-errors;reporting-enabled", "autonomous-trusted;none;reporting-disabled", "autonomous-trusted;none;reporting-enabled", "inspection-only;none;reporting-disabled", "inspection-only;none;reporting-enabled", "transactional;no-new-compiler-errors;reporting-disabled", "transactional;no-new-compiler-errors;reporting-enabled", "transactional;none;reporting-disabled", "transactional;none;reporting-enabled" ] } }, { "key": "tool:get-change-impact", "category": "tool", "facts": { "availability": [ "approval-required;no-new-compiler-errors;reporting-disabled", "approval-required;no-new-compiler-errors;reporting-enabled", "approval-required;none;reporting-disabled", "approval-required;none;reporting-enabled", "autonomous-trusted;no-new-compiler-errors;reporting-disabled", "autonomous-trusted;no-new-compiler-errors;reporting-enabled", "autonomous-trusted;none;reporting-disabled", "autonomous-trusted;none;reporting-enabled", "inspection-only;none;reporting-disabled", "inspection-only;none;reporting-enabled", "transactional;no-new-compiler-errors;reporting-disabled", "transactional;no-new-compiler-errors;reporting-enabled", "transactional;none;reporting-disabled", "transactional;none;reporting-enabled" ] } }, { "key": "tool:get-code-context", "category": "tool", "facts": { "availability": [ "approval-required;no-new-compiler-errors;reporting-disabled", "approval-required;no-new-compiler-errors;reporting-enabled", "approval-required;none;reporting-disabled", "approval-required;none;reporting-enabled", "autonomous-trusted;no-new-compiler-errors;reporting-disabled", "autonomous-trusted;no-new-compiler-errors;reporting-enabled", "autonomous-trusted;none;reporting-disabled", "autonomous-trusted;none;reporting-enabled", "inspection-only;none;reporting-disabled", "inspection-only;none;reporting-enabled", "transactional;no-new-compiler-errors;reporting-disabled", "transactional;no-new-compiler-errors;reporting-enabled", "transactional;none;reporting-disabled", "transactional;none;reporting-enabled" ] } }, { "key": "tool:get-control-flow-graph", "category": "tool", "facts": { "availability": [ "approval-required;no-new-compiler-errors;reporting-disabled", "approval-required;no-new-compiler-errors;reporting-enabled", "approval-required;none;reporting-disabled", "approval-required;none;reporting-enabled", "autonomous-trusted;no-new-compiler-errors;reporting-disabled", "autonomous-trusted;no-new-compiler-errors;reporting-enabled", "autonomous-trusted;none;reporting-disabled", "autonomous-trusted;none;reporting-enabled", "inspection-only;none;reporting-disabled", "inspection-only;none;reporting-enabled", "transactional;no-new-compiler-errors;reporting-disabled", "transactional;no-new-compiler-errors;reporting-enabled", "transactional;none;reporting-disabled", "transactional;none;reporting-enabled" ] } }, { "key": "tool:get-dependency-graph", "category": "tool", "facts": { "availability": [ "approval-required;no-new-compiler-errors;reporting-disabled", "approval-required;no-new-compiler-errors;reporting-enabled", "approval-required;none;reporting-disabled", "approval-required;none;reporting-enabled", "autonomous-trusted;no-new-compiler-errors;reporting-disabled", "autonomous-trusted;no-new-compiler-errors;reporting-enabled", "autonomous-trusted;none;reporting-disabled", "autonomous-trusted;none;reporting-enabled", "inspection-only;none;reporting-disabled", "inspection-only;none;reporting-enabled", "transactional;no-new-compiler-errors;reporting-disabled", "transactional;no-new-compiler-errors;reporting-enabled", "transactional;none;reporting-disabled", "transactional;none;reporting-enabled" ] } }, { "key": "tool:get-diagnostics", "category": "tool", "facts": { "availability": [ "approval-required;no-new-compiler-errors;reporting-disabled", "approval-required;no-new-compiler-errors;reporting-enabled", "approval-required;none;reporting-disabled", "approval-required;none;reporting-enabled", "autonomous-trusted;no-new-compiler-errors;reporting-disabled", "autonomous-trusted;no-new-compiler-errors;reporting-enabled", "autonomous-trusted;none;reporting-disabled", "autonomous-trusted;none;reporting-enabled", "inspection-only;none;reporting-disabled", "inspection-only;none;reporting-enabled", "transactional;no-new-compiler-errors;reporting-disabled", "transactional;no-new-compiler-errors;reporting-enabled", "transactional;none;reporting-disabled", "transactional;none;reporting-enabled" ] } }, { "key": "tool:get-document-options", "category": "tool", "facts": { "availability": [ "approval-required;no-new-compiler-errors;reporting-disabled", "approval-required;no-new-compiler-errors;reporting-enabled", "approval-required;none;reporting-disabled", "approval-required;none;reporting-enabled", "autonomous-trusted;no-new-compiler-errors;reporting-disabled", "autonomous-trusted;no-new-compiler-errors;reporting-enabled", "autonomous-trusted;none;reporting-disabled", "autonomous-trusted;none;reporting-enabled", "inspection-only;none;reporting-disabled", "inspection-only;none;reporting-enabled", "transactional;no-new-compiler-errors;reporting-disabled", "transactional;no-new-compiler-errors;reporting-enabled", "transactional;none;reporting-disabled", "transactional;none;reporting-enabled" ] } }, { "key": "tool:get-document-outline", "category": "tool", "facts": { "availability": [ "approval-required;no-new-compiler-errors;reporting-disabled", "approval-required;no-new-compiler-errors;reporting-enabled", "approval-required;none;reporting-disabled", "approval-required;none;reporting-enabled", "autonomous-trusted;no-new-compiler-errors;reporting-disabled", "autonomous-trusted;no-new-compiler-errors;reporting-enabled", "autonomous-trusted;none;reporting-disabled", "autonomous-trusted;none;reporting-enabled", "inspection-only;none;reporting-disabled", "inspection-only;none;reporting-enabled", "transactional;no-new-compiler-errors;reporting-disabled", "transactional;no-new-compiler-errors;reporting-enabled", "transactional;none;reporting-disabled", "transactional;none;reporting-enabled" ] } }, { "key": "tool:get-error-details", "category": "tool", "facts": { "availability": [ "approval-required;no-new-compiler-errors;reporting-disabled", "approval-required;no-new-compiler-errors;reporting-enabled", "approval-required;none;reporting-disabled", "approval-required;none;reporting-enabled", "autonomous-trusted;no-new-compiler-errors;reporting-disabled", "autonomous-trusted;no-new-compiler-errors;reporting-enabled", "autonomous-trusted;none;reporting-disabled", "autonomous-trusted;none;reporting-enabled", "inspection-only;none;reporting-disabled", "inspection-only;none;reporting-enabled", "transactional;no-new-compiler-errors;reporting-disabled", "transactional;no-new-compiler-errors;reporting-enabled", "transactional;none;reporting-disabled", "transactional;none;reporting-enabled" ] } }, { "key": "tool:get-operation-tree", "category": "tool", "facts": { "availability": [ "approval-required;no-new-compiler-errors;reporting-disabled", "approval-required;no-new-compiler-errors;reporting-enabled", "approval-required;none;reporting-disabled", "approval-required;none;reporting-enabled", "autonomous-trusted;no-new-compiler-errors;reporting-disabled", "autonomous-trusted;no-new-compiler-errors;reporting-enabled", "autonomous-trusted;none;reporting-disabled", "autonomous-trusted;none;reporting-enabled", "inspection-only;none;reporting-disabled", "inspection-only;none;reporting-enabled", "transactional;no-new-compiler-errors;reporting-disabled", "transactional;no-new-compiler-errors;reporting-enabled", "transactional;none;reporting-disabled", "transactional;none;reporting-enabled" ] } }, { "key": "tool:get-partial-declarations", "category": "tool", "facts": { "availability": [ "approval-required;no-new-compiler-errors;reporting-disabled", "approval-required;no-new-compiler-errors;reporting-enabled", "approval-required;none;reporting-disabled", "approval-required;none;reporting-enabled", "autonomous-trusted;no-new-compiler-errors;reporting-disabled", "autonomous-trusted;no-new-compiler-errors;reporting-enabled", "autonomous-trusted;none;reporting-disabled", "autonomous-trusted;none;reporting-enabled", "inspection-only;none;reporting-disabled", "inspection-only;none;reporting-enabled", "transactional;no-new-compiler-errors;reporting-disabled", "transactional;no-new-compiler-errors;reporting-enabled", "transactional;none;reporting-disabled", "transactional;none;reporting-enabled" ] } }, { "key": "tool:get-project-details", "category": "tool", "facts": { "availability": [ "approval-required;no-new-compiler-errors;reporting-disabled", "approval-required;no-new-compiler-errors;reporting-enabled", "approval-required;none;reporting-disabled", "approval-required;none;reporting-enabled", "autonomous-trusted;no-new-compiler-errors;reporting-disabled", "autonomous-trusted;no-new-compiler-errors;reporting-enabled", "autonomous-trusted;none;reporting-disabled", "autonomous-trusted;none;reporting-enabled", "inspection-only;none;reporting-disabled", "inspection-only;none;reporting-enabled", "transactional;no-new-compiler-errors;reporting-disabled", "transactional;no-new-compiler-errors;reporting-enabled", "transactional;none;reporting-disabled", "transactional;none;reporting-enabled" ] } }, { "key": "tool:get-solution-structure", "category": "tool", "facts": { "availability": [ "approval-required;no-new-compiler-errors;reporting-disabled", "approval-required;no-new-compiler-errors;reporting-enabled", "approval-required;none;reporting-disabled", "approval-required;none;reporting-enabled", "autonomous-trusted;no-new-compiler-errors;reporting-disabled", "autonomous-trusted;no-new-compiler-errors;reporting-enabled", "autonomous-trusted;none;reporting-disabled", "autonomous-trusted;none;reporting-enabled", "inspection-only;none;reporting-disabled", "inspection-only;none;reporting-enabled", "transactional;no-new-compiler-errors;reporting-disabled", "transactional;no-new-compiler-errors;reporting-enabled", "transactional;none;reporting-disabled", "transactional;none;reporting-enabled" ] } }, { "key": "tool:get-symbol-attributes", "category": "tool", "facts": { "availability": [ "approval-required;no-new-compiler-errors;reporting-disabled", "approval-required;no-new-compiler-errors;reporting-enabled", "approval-required;none;reporting-disabled", "approval-required;none;reporting-enabled", "autonomous-trusted;no-new-compiler-errors;reporting-disabled", "autonomous-trusted;no-new-compiler-errors;reporting-enabled", "autonomous-trusted;none;reporting-disabled", "autonomous-trusted;none;reporting-enabled", "inspection-only;none;reporting-disabled", "inspection-only;none;reporting-enabled", "transactional;no-new-compiler-errors;reporting-disabled", "transactional;no-new-compiler-errors;reporting-enabled", "transactional;none;reporting-disabled", "transactional;none;reporting-enabled" ] } }, { "key": "tool:get-symbol-dependencies", "category": "tool", "facts": { "availability": [ "approval-required;no-new-compiler-errors;reporting-disabled", "approval-required;no-new-compiler-errors;reporting-enabled", "approval-required;none;reporting-disabled", "approval-required;none;reporting-enabled", "autonomous-trusted;no-new-compiler-errors;reporting-disabled", "autonomous-trusted;no-new-compiler-errors;reporting-enabled", "autonomous-trusted;none;reporting-disabled", "autonomous-trusted;none;reporting-enabled", "inspection-only;none;reporting-disabled", "inspection-only;none;reporting-enabled", "transactional;no-new-compiler-errors;reporting-disabled", "transactional;no-new-compiler-errors;reporting-enabled", "transactional;none;reporting-disabled", "transactional;none;reporting-enabled" ] } }, { "key": "tool:get-symbol-dependents", "category": "tool", "facts": { "availability": [ "approval-required;no-new-compiler-errors;reporting-disabled", "approval-required;no-new-compiler-errors;reporting-enabled", "approval-required;none;reporting-disabled", "approval-required;none;reporting-enabled", "autonomous-trusted;no-new-compiler-errors;reporting-disabled", "autonomous-trusted;no-new-compiler-errors;reporting-enabled", "autonomous-trusted;none;reporting-disabled", "autonomous-trusted;none;reporting-enabled", "inspection-only;none;reporting-disabled", "inspection-only;none;reporting-enabled", "transactional;no-new-compiler-errors;reporting-disabled", "transactional;no-new-compiler-errors;reporting-enabled", "transactional;none;reporting-disabled", "transactional;none;reporting-enabled" ] } }, { "key": "tool:get-symbol-info", "category": "tool", "facts": { "availability": [ "approval-required;no-new-compiler-errors;reporting-disabled", "approval-required;no-new-compiler-errors;reporting-enabled", "approval-required;none;reporting-disabled", "approval-required;none;reporting-enabled", "autonomous-trusted;no-new-compiler-errors;reporting-disabled", "autonomous-trusted;no-new-compiler-errors;reporting-enabled", "autonomous-trusted;none;reporting-disabled", "autonomous-trusted;none;reporting-enabled", "inspection-only;none;reporting-disabled", "inspection-only;none;reporting-enabled", "transactional;no-new-compiler-errors;reporting-disabled", "transactional;no-new-compiler-errors;reporting-enabled", "transactional;none;reporting-disabled", "transactional;none;reporting-enabled" ] } }, { "key": "tool:get-symbol-members", "category": "tool", "facts": { "availability": [ "approval-required;no-new-compiler-errors;reporting-disabled", "approval-required;no-new-compiler-errors;reporting-enabled", "approval-required;none;reporting-disabled", "approval-required;none;reporting-enabled", "autonomous-trusted;no-new-compiler-errors;reporting-disabled", "autonomous-trusted;no-new-compiler-errors;reporting-enabled", "autonomous-trusted;none;reporting-disabled", "autonomous-trusted;none;reporting-enabled", "inspection-only;none;reporting-disabled", "inspection-only;none;reporting-enabled", "transactional;no-new-compiler-errors;reporting-disabled", "transactional;no-new-compiler-errors;reporting-enabled", "transactional;none;reporting-disabled", "transactional;none;reporting-enabled" ] } }, { "key": "tool:get-test-impact", "category": "tool", "facts": { "availability": [ "approval-required;no-new-compiler-errors;reporting-disabled", "approval-required;no-new-compiler-errors;reporting-enabled", "approval-required;none;reporting-disabled", "approval-required;none;reporting-enabled", "autonomous-trusted;no-new-compiler-errors;reporting-disabled", "autonomous-trusted;no-new-compiler-errors;reporting-enabled", "autonomous-trusted;none;reporting-disabled", "autonomous-trusted;none;reporting-enabled", "inspection-only;none;reporting-disabled", "inspection-only;none;reporting-enabled", "transactional;no-new-compiler-errors;reporting-disabled", "transactional;no-new-compiler-errors;reporting-enabled", "transactional;none;reporting-disabled", "transactional;none;reporting-enabled" ] } }, { "key": "tool:get-type-hierarchy", "category": "tool", "facts": { "availability": [ "approval-required;no-new-compiler-errors;reporting-disabled", "approval-required;no-new-compiler-errors;reporting-enabled", "approval-required;none;reporting-disabled", "approval-required;none;reporting-enabled", "autonomous-trusted;no-new-compiler-errors;reporting-disabled", "autonomous-trusted;no-new-compiler-errors;reporting-enabled", "autonomous-trusted;none;reporting-disabled", "autonomous-trusted;none;reporting-enabled", "inspection-only;none;reporting-disabled", "inspection-only;none;reporting-enabled", "transactional;no-new-compiler-errors;reporting-disabled", "transactional;no-new-compiler-errors;reporting-enabled", "transactional;none;reporting-disabled", "transactional;none;reporting-enabled" ] } }, { "key": "tool:go-to-definition", "category": "tool", "facts": { "availability": [ "approval-required;no-new-compiler-errors;reporting-disabled", "approval-required;no-new-compiler-errors;reporting-enabled", "approval-required;none;reporting-disabled", "approval-required;none;reporting-enabled", "autonomous-trusted;no-new-compiler-errors;reporting-disabled", "autonomous-trusted;no-new-compiler-errors;reporting-enabled", "autonomous-trusted;none;reporting-disabled", "autonomous-trusted;none;reporting-enabled", "inspection-only;none;reporting-disabled", "inspection-only;none;reporting-enabled", "transactional;no-new-compiler-errors;reporting-disabled", "transactional;no-new-compiler-errors;reporting-enabled", "transactional;none;reporting-disabled", "transactional;none;reporting-enabled" ] } }, { "key": "tool:list-code-actions", "category": "tool", "facts": { "availability": [ "approval-required;no-new-compiler-errors;reporting-disabled", "approval-required;no-new-compiler-errors;reporting-enabled", "approval-required;none;reporting-disabled", "approval-required;none;reporting-enabled", "autonomous-trusted;no-new-compiler-errors;reporting-disabled", "autonomous-trusted;no-new-compiler-errors;reporting-enabled", "autonomous-trusted;none;reporting-disabled", "autonomous-trusted;none;reporting-enabled", "inspection-only;none;reporting-disabled", "inspection-only;none;reporting-enabled", "transactional;no-new-compiler-errors;reporting-disabled", "transactional;no-new-compiler-errors;reporting-enabled", "transactional;none;reporting-disabled", "transactional;none;reporting-enabled" ] } }, { "key": "tool:prepare-error-report", "category": "tool", "facts": { "availability": [ "approval-required;no-new-compiler-errors;reporting-enabled", "approval-required;none;reporting-enabled", "autonomous-trusted;no-new-compiler-errors;reporting-enabled", "autonomous-trusted;none;reporting-enabled", "inspection-only;none;reporting-enabled", "transactional;no-new-compiler-errors;reporting-enabled", "transactional;none;reporting-enabled" ] } }, { "key": "tool:prepare-fix-all", "category": "tool", "facts": { "availability": [ "approval-required;no-new-compiler-errors;reporting-disabled", "approval-required;no-new-compiler-errors;reporting-enabled", "approval-required;none;reporting-disabled", "approval-required;none;reporting-enabled", "autonomous-trusted;no-new-compiler-errors;reporting-disabled", "autonomous-trusted;no-new-compiler-errors;reporting-enabled", "autonomous-trusted;none;reporting-disabled", "autonomous-trusted;none;reporting-enabled", "inspection-only;none;reporting-disabled", "inspection-only;none;reporting-enabled", "transactional;no-new-compiler-errors;reporting-disabled", "transactional;no-new-compiler-errors;reporting-enabled", "transactional;none;reporting-disabled", "transactional;none;reporting-enabled" ] } }, { "key": "tool:rename-symbol", "category": "tool", "facts": { "availability": [ "approval-required;no-new-compiler-errors;reporting-disabled", "approval-required;no-new-compiler-errors;reporting-enabled", "approval-required;none;reporting-disabled", "approval-required;none;reporting-enabled", "autonomous-trusted;no-new-compiler-errors;reporting-disabled", "autonomous-trusted;no-new-compiler-errors;reporting-enabled", "autonomous-trusted;none;reporting-disabled", "autonomous-trusted;none;reporting-enabled", "transactional;no-new-compiler-errors;reporting-disabled", "transactional;no-new-compiler-errors;reporting-enabled", "transactional;none;reporting-disabled", "transactional;none;reporting-enabled" ] } }, { "key": "tool:resolve-symbol", "category": "tool", "facts": { "availability": [ "approval-required;no-new-compiler-errors;reporting-disabled", "approval-required;no-new-compiler-errors;reporting-enabled", "approval-required;none;reporting-disabled", "approval-required;none;reporting-enabled", "autonomous-trusted;no-new-compiler-errors;reporting-disabled", "autonomous-trusted;no-new-compiler-errors;reporting-enabled", "autonomous-trusted;none;reporting-disabled", "autonomous-trusted;none;reporting-enabled", "inspection-only;none;reporting-disabled", "inspection-only;none;reporting-enabled", "transactional;no-new-compiler-errors;reporting-disabled", "transactional;no-new-compiler-errors;reporting-enabled", "transactional;none;reporting-disabled", "transactional;none;reporting-enabled" ] } }, { "key": "tool:search-symbols", "category": "tool", "facts": { "availability": [ "approval-required;no-new-compiler-errors;reporting-disabled", "approval-required;no-new-compiler-errors;reporting-enabled", "approval-required;none;reporting-disabled", "approval-required;none;reporting-enabled", "autonomous-trusted;no-new-compiler-errors;reporting-disabled", "autonomous-trusted;no-new-compiler-errors;reporting-enabled", "autonomous-trusted;none;reporting-disabled", "autonomous-trusted;none;reporting-enabled", "inspection-only;none;reporting-disabled", "inspection-only;none;reporting-enabled", "transactional;no-new-compiler-errors;reporting-disabled", "transactional;no-new-compiler-errors;reporting-enabled", "transactional;none;reporting-disabled", "transactional;none;reporting-enabled" ] } }, { "key": "tool:server-status", "category": "tool", "facts": { "availability": [ "approval-required;no-new-compiler-errors;reporting-disabled", "approval-required;no-new-compiler-errors;reporting-enabled", "approval-required;none;reporting-disabled", "approval-required;none;reporting-enabled", "autonomous-trusted;no-new-compiler-errors;reporting-disabled", "autonomous-trusted;no-new-compiler-errors;reporting-enabled", "autonomous-trusted;none;reporting-disabled", "autonomous-trusted;none;reporting-enabled", "inspection-only;none;reporting-disabled", "inspection-only;none;reporting-enabled", "transactional;no-new-compiler-errors;reporting-disabled", "transactional;no-new-compiler-errors;reporting-enabled", "transactional;none;reporting-disabled", "transactional;none;reporting-enabled" ] } }, { "key": "tool:stage-code-action", "category": "tool", "facts": { "availability": [ "approval-required;no-new-compiler-errors;reporting-disabled", "approval-required;no-new-compiler-errors;reporting-enabled", "approval-required;none;reporting-disabled", "approval-required;none;reporting-enabled", "autonomous-trusted;no-new-compiler-errors;reporting-disabled", "autonomous-trusted;no-new-compiler-errors;reporting-enabled", "autonomous-trusted;none;reporting-disabled", "autonomous-trusted;none;reporting-enabled", "transactional;no-new-compiler-errors;reporting-disabled", "transactional;no-new-compiler-errors;reporting-enabled", "transactional;none;reporting-disabled", "transactional;none;reporting-enabled" ] } }, { "key": "tool:submit-error-report", "category": "tool", "facts": { "availability": [ "approval-required;no-new-compiler-errors;reporting-enabled", "approval-required;none;reporting-enabled", "autonomous-trusted;no-new-compiler-errors;reporting-enabled", "autonomous-trusted;none;reporting-enabled", "inspection-only;none;reporting-enabled", "transactional;no-new-compiler-errors;reporting-enabled", "transactional;none;reporting-enabled" ] } }, { "key": "tool:transaction-commit", "category": "tool", "facts": { "availability": [ "approval-required;no-new-compiler-errors;reporting-disabled", "approval-required;no-new-compiler-errors;reporting-enabled", "approval-required;none;reporting-disabled", "approval-required;none;reporting-enabled", "autonomous-trusted;no-new-compiler-errors;reporting-disabled", "autonomous-trusted;no-new-compiler-errors;reporting-enabled", "autonomous-trusted;none;reporting-disabled", "autonomous-trusted;none;reporting-enabled", "transactional;no-new-compiler-errors;reporting-disabled", "transactional;no-new-compiler-errors;reporting-enabled", "transactional;none;reporting-disabled", "transactional;none;reporting-enabled" ] } }, { "key": "tool:transaction-history", "category": "tool", "facts": { "availability": [ "approval-required;no-new-compiler-errors;reporting-disabled", "approval-required;no-new-compiler-errors;reporting-enabled", "approval-required;none;reporting-disabled", "approval-required;none;reporting-enabled", "autonomous-trusted;no-new-compiler-errors;reporting-disabled", "autonomous-trusted;no-new-compiler-errors;reporting-enabled", "autonomous-trusted;none;reporting-disabled", "autonomous-trusted;none;reporting-enabled", "transactional;no-new-compiler-errors;reporting-disabled", "transactional;no-new-compiler-errors;reporting-enabled", "transactional;none;reporting-disabled", "transactional;none;reporting-enabled" ] } }, { "key": "tool:transaction-preview", "category": "tool", "facts": { "availability": [ "autonomous-trusted;no-new-compiler-errors;reporting-disabled", "autonomous-trusted;no-new-compiler-errors;reporting-enabled", "autonomous-trusted;none;reporting-disabled", "autonomous-trusted;none;reporting-enabled", "transactional;no-new-compiler-errors;reporting-disabled", "transactional;no-new-compiler-errors;reporting-enabled", "transactional;none;reporting-disabled", "transactional;none;reporting-enabled" ] } }, { "key": "tool:transaction-review", "category": "tool", "facts": { "availability": [ "approval-required;no-new-compiler-errors;reporting-disabled", "approval-required;no-new-compiler-errors;reporting-enabled", "approval-required;none;reporting-disabled", "approval-required;none;reporting-enabled" ] } }, { "key": "tool:transaction-rollback", "category": "tool", "facts": { "availability": [ "approval-required;no-new-compiler-errors;reporting-disabled", "approval-required;no-new-compiler-errors;reporting-enabled", "approval-required;none;reporting-disabled", "approval-required;none;reporting-enabled", "autonomous-trusted;no-new-compiler-errors;reporting-disabled", "autonomous-trusted;no-new-compiler-errors;reporting-enabled", "autonomous-trusted;none;reporting-disabled", "autonomous-trusted;none;reporting-enabled", "transactional;no-new-compiler-errors;reporting-disabled", "transactional;no-new-compiler-errors;reporting-enabled", "transactional;none;reporting-disabled", "transactional;none;reporting-enabled" ] } }, { "key": "tool:transaction-start", "category": "tool", "facts": { "availability": [ "approval-required;no-new-compiler-errors;reporting-disabled", "approval-required;no-new-compiler-errors;reporting-enabled", "approval-required;none;reporting-disabled", "approval-required;none;reporting-enabled", "autonomous-trusted;no-new-compiler-errors;reporting-disabled", "autonomous-trusted;no-new-compiler-errors;reporting-enabled", "autonomous-trusted;none;reporting-disabled", "autonomous-trusted;none;reporting-enabled", "transactional;no-new-compiler-errors;reporting-disabled", "transactional;no-new-compiler-errors;reporting-enabled", "transactional;none;reporting-disabled", "transactional;none;reporting-enabled" ] } }, { "key": "tool:transaction-validate", "category": "tool", "facts": { "availability": [ "approval-required;no-new-compiler-errors;reporting-disabled", "approval-required;no-new-compiler-errors;reporting-enabled", "autonomous-trusted;no-new-compiler-errors;reporting-disabled", "autonomous-trusted;no-new-compiler-errors;reporting-enabled", "transactional;no-new-compiler-errors;reporting-disabled", "transactional;no-new-compiler-errors;reporting-enabled" ] } }, { "key": "tool:workspace-close", "category": "tool", "facts": { "availability": [ "approval-required;no-new-compiler-errors;reporting-disabled", "approval-required;no-new-compiler-errors;reporting-enabled", "approval-required;none;reporting-disabled", "approval-required;none;reporting-enabled", "autonomous-trusted;no-new-compiler-errors;reporting-disabled", "autonomous-trusted;no-new-compiler-errors;reporting-enabled", "autonomous-trusted;none;reporting-disabled", "autonomous-trusted;none;reporting-enabled", "inspection-only;none;reporting-disabled", "inspection-only;none;reporting-enabled", "transactional;no-new-compiler-errors;reporting-disabled", "transactional;no-new-compiler-errors;reporting-enabled", "transactional;none;reporting-disabled", "transactional;none;reporting-enabled" ] } }, { "key": "tool:workspace-list", "category": "tool", "facts": { "availability": [ "approval-required;no-new-compiler-errors;reporting-disabled", "approval-required;no-new-compiler-errors;reporting-enabled", "approval-required;none;reporting-disabled", "approval-required;none;reporting-enabled", "autonomous-trusted;no-new-compiler-errors;reporting-disabled", "autonomous-trusted;no-new-compiler-errors;reporting-enabled", "autonomous-trusted;none;reporting-disabled", "autonomous-trusted;none;reporting-enabled", "inspection-only;none;reporting-disabled", "inspection-only;none;reporting-enabled", "transactional;no-new-compiler-errors;reporting-disabled", "transactional;no-new-compiler-errors;reporting-enabled", "transactional;none;reporting-disabled", "transactional;none;reporting-enabled" ] } }, { "key": "tool:workspace-open", "category": "tool", "facts": { "availability": [ "approval-required;no-new-compiler-errors;reporting-disabled", "approval-required;no-new-compiler-errors;reporting-enabled", "approval-required;none;reporting-disabled", "approval-required;none;reporting-enabled", "autonomous-trusted;no-new-compiler-errors;reporting-disabled", "autonomous-trusted;no-new-compiler-errors;reporting-enabled", "autonomous-trusted;none;reporting-disabled", "autonomous-trusted;none;reporting-enabled", "inspection-only;none;reporting-disabled", "inspection-only;none;reporting-enabled", "transactional;no-new-compiler-errors;reporting-disabled", "transactional;no-new-compiler-errors;reporting-enabled", "transactional;none;reporting-disabled", "transactional;none;reporting-enabled" ] } }, { "key": "tool:workspace-reload", "category": "tool", "facts": { "availability": [ "approval-required;no-new-compiler-errors;reporting-disabled", "approval-required;no-new-compiler-errors;reporting-enabled", "approval-required;none;reporting-disabled", "approval-required;none;reporting-enabled", "autonomous-trusted;no-new-compiler-errors;reporting-disabled", "autonomous-trusted;no-new-compiler-errors;reporting-enabled", "autonomous-trusted;none;reporting-disabled", "autonomous-trusted;none;reporting-enabled", "inspection-only;none;reporting-disabled", "inspection-only;none;reporting-enabled", "transactional;no-new-compiler-errors;reporting-disabled", "transactional;no-new-compiler-errors;reporting-enabled", "transactional;none;reporting-disabled", "transactional;none;reporting-enabled" ] } }, { "key": "tool:workspace-status", "category": "tool", "facts": { "availability": [ "approval-required;no-new-compiler-errors;reporting-disabled", "approval-required;no-new-compiler-errors;reporting-enabled", "approval-required;none;reporting-disabled", "approval-required;none;reporting-enabled", "autonomous-trusted;no-new-compiler-errors;reporting-disabled", "autonomous-trusted;no-new-compiler-errors;reporting-enabled", "autonomous-trusted;none;reporting-disabled", "autonomous-trusted;none;reporting-enabled", "inspection-only;none;reporting-disabled", "inspection-only;none;reporting-enabled", "transactional;no-new-compiler-errors;reporting-disabled", "transactional;no-new-compiler-errors;reporting-enabled", "transactional;none;reporting-disabled", "transactional;none;reporting-enabled" ] } } ], "evidence": [ { "level": "integration", "project": "test/Roslyn.Workbench.Mcp.IntegrationTest/Roslyn.Workbench.Mcp.IntegrationTest.csproj", "source": "test/Roslyn.Workbench.Mcp.IntegrationTest/HostCompositionIntegrationTests.cs", "test": "Roslyn.Workbench.Mcp.Test.HostCompositionIntegrationTests.GIVEN_DefaultOperationalMode_WHEN_ComposingHost_THEN_ShouldPublishInspectionOnlySurface" }, { "level": "integration", "project": "test/Roslyn.Workbench.Mcp.IntegrationTest/Roslyn.Workbench.Mcp.IntegrationTest.csproj", "source": "test/Roslyn.Workbench.Mcp.IntegrationTest/ToolReference/SecurityReferenceGeneratorIntegrationTests.cs", "test": "Roslyn.Workbench.Mcp.Test.ToolReference.SecurityReferenceGeneratorIntegrationTests.GIVEN_ProductionHostMatrix_WHEN_CollectingSecuritySurface_THEN_ShouldMatchEveryToolAvailabilityFact" }, { "level": "unit", "project": "test/Roslyn.Workbench.Mcp.Test/Roslyn.Workbench.Mcp.Test.csproj", "source": "test/Roslyn.Workbench.Mcp.Test/ServerOwnedToolRegistrationTests.cs", "test": "Roslyn.Workbench.Mcp.Test.ServerOwnedToolRegistrationTests.GIVEN_ReceiptApprovalPolicy_WHEN_RegisteringServerOwnedTools_THEN_ShouldPublishOnlyReceiptReviewWorkflow" } ] }, { "id": "transaction-snapshot-and-receipt", "title": "Mutations remain transaction-, snapshot- and approval-bound", "classification": "enforced", "actor": "Roslyn Workbench transaction pipeline", "outcome": "Source mutations require an active transaction, stale snapshots are rejected, and approval-required commits use a one-use receipt bound to the exact reviewed persistence set.", "boundary": "The guarantee covers mutations and commits routed through the supported transaction tools and lower-level transaction service.", "residualRisk": "A user or authorised client can approve an undesirable but accurately represented change; repository review remains necessary.", "surface": [ { "key": "continuation:call-tool", "category": "continuation", "facts": { "numericValue": 0 } }, { "key": "continuation:choose-tool", "category": "continuation", "facts": { "numericValue": 1 } }, { "key": "continuation:resolve-externally", "category": "continuation", "facts": { "numericValue": 4 } }, { "key": "continuation:retry-request", "category": "continuation", "facts": { "numericValue": 2 } }, { "key": "continuation:revise-request", "category": "continuation", "facts": { "numericValue": 3 } }, { "key": "error:DocumentAmbiguous", "category": "error", "facts": { "value": "DocumentAmbiguous" } }, { "key": "error:DocumentNotFound", "category": "error", "facts": { "value": "DocumentNotFound" } }, { "key": "error:InvalidRequest", "category": "error", "facts": { "value": "InvalidRequest" } }, { "key": "error:LinkedDocumentConflict", "category": "error", "facts": { "value": "LinkedDocumentConflict" } }, { "key": "error:MutationCandidateChanged", "category": "error", "facts": { "value": "MutationCandidateChanged" } }, { "key": "error:NoActiveTransaction", "category": "error", "facts": { "value": "NoActiveTransaction" } }, { "key": "error:RevisionCapacityReached", "category": "error", "facts": { "value": "RevisionCapacityReached" } }, { "key": "error:SnapshotMismatch", "category": "error", "facts": { "value": "SnapshotMismatch" } }, { "key": "error:SourceMutationDisabled", "category": "error", "facts": { "value": "SourceMutationDisabled" } }, { "key": "error:TransactionAlreadyActive", "category": "error", "facts": { "value": "TransactionAlreadyActive" } }, { "key": "error:TransactionConflicted", "category": "error", "facts": { "value": "TransactionConflicted" } }, { "key": "error:TransactionHistoryUnavailable", "category": "error", "facts": { "value": "TransactionHistoryUnavailable" } }, { "key": "error:TransactionOwnedByWorkspace", "category": "error", "facts": { "value": "TransactionOwnedByWorkspace" } }, { "key": "error:TransactionReceiptMismatch", "category": "error", "facts": { "value": "TransactionReceiptMismatch" } }, { "key": "error:TransactionReceiptRequired", "category": "error", "facts": { "value": "TransactionReceiptRequired" } }, { "key": "error:TransactionReviewUnavailable", "category": "error", "facts": { "value": "TransactionReviewUnavailable" } }, { "key": "error:WorkspaceAlreadyOpen", "category": "error", "facts": { "value": "WorkspaceAlreadyOpen" } }, { "key": "error:WorkspaceBusy", "category": "error", "facts": { "value": "WorkspaceBusy" } }, { "key": "error:WorkspaceNotOpen", "category": "error", "facts": { "value": "WorkspaceNotOpen" } }, { "key": "receipt-digest:sha256-rwcs-v1", "category": "receipt-digest", "facts": { "value": "sha256-rwcs-v1" } }, { "key": "status-field:clientSupportsElicitation", "category": "status-field", "facts": { "type": "boolean", "required": false, "nullable": true } }, { "key": "status-field:commitConfirmationState", "category": "status-field", "facts": { "type": "string", "required": true, "nullable": false } }, { "key": "status-field:maxTransactionRevisions", "category": "status-field", "facts": { "type": "integer", "required": true, "nullable": false } } ], "evidence": [ { "level": "unit", "project": "test/Roslyn.Workbench.Mcp.Test/Roslyn.Workbench.Mcp.Test.csproj", "source": "test/Roslyn.Workbench.Mcp.Test/Transactions/TransactionReceiptStoreTests.cs", "test": "Roslyn.Workbench.Mcp.Test.Transactions.TransactionReceiptStoreTests.GIVEN_CurrentReceipt_WHEN_Consuming_THEN_ShouldReturnItOnce" }, { "level": "unit", "project": "test/Roslyn.Workbench.Mcp.Workspace.Test/Roslyn.Workbench.Mcp.Workspace.Test.csproj", "source": "test/Roslyn.Workbench.Mcp.Workspace.Test/Transactions/TransactionCommitServiceTests.cs", "test": "Roslyn.Workbench.Mcp.Workspace.Test.Transactions.TransactionCommitServiceTests.GIVEN_FinalPersistenceIdentityDiffersFromApprovedReceipt_WHEN_Committing_THEN_ShouldRejectBeforeRecoveryPersistence" }, { "level": "unit", "project": "test/Roslyn.Workbench.Mcp.Workspace.Test/Roslyn.Workbench.Mcp.Workspace.Test.csproj", "source": "test/Roslyn.Workbench.Mcp.Workspace.Test/Transactions/TransactionCommitServiceTests.cs", "test": "Roslyn.Workbench.Mcp.Workspace.Test.Transactions.TransactionCommitServiceTests.GIVEN_NoActiveTransaction_WHEN_Committing_THEN_ShouldRequireTransaction" }, { "level": "unit", "project": "test/Roslyn.Workbench.Mcp.Workspace.Test/Roslyn.Workbench.Mcp.Workspace.Test.csproj", "source": "test/Roslyn.Workbench.Mcp.Workspace.Test/Transactions/TransactionCommitServiceTests.cs", "test": "Roslyn.Workbench.Mcp.Workspace.Test.Transactions.TransactionCommitServiceTests.GIVEN_SnapshotMismatch_WHEN_Committing_THEN_ShouldReturnConflictWithoutWriting" }, { "level": "unit", "project": "test/Roslyn.Workbench.Mcp.Workspace.Test/Roslyn.Workbench.Mcp.Workspace.Test.csproj", "source": "test/Roslyn.Workbench.Mcp.Workspace.Test/Transactions/TransactionServiceTests.cs", "test": "Roslyn.Workbench.Mcp.Workspace.Test.Transactions.TransactionServiceTests.GIVEN_ReceiptBoundToEarlierRevision_WHEN_ValidatingBeforePrompt_THEN_ShouldRequestNewReview" } ] }, { "id": "workspace-authority-and-document-policy", "title": "Workspace authority constrains admitted and mutable files", "classification": "enforced", "actor": "Roslyn Workbench Host", "outcome": "Workspace admission, external-document handling and mutation containment are evaluated against Host-owned authority rather than client assertions.", "boundary": "The guarantee covers workspaces and transaction persistence performed through Roslyn Workbench.", "residualRisk": "Other local processes and trusted build inputs can change files outside this Host and can require a workspace reload.", "surface": [ { "key": "error:WorkspaceAuthorityChanged", "category": "error", "facts": { "value": "WorkspaceAuthorityChanged" } }, { "key": "error:WorkspaceCapacityReached", "category": "error", "facts": { "value": "WorkspaceCapacityReached" } }, { "key": "error:WorkspaceChangedDuringLoad", "category": "error", "facts": { "value": "WorkspaceChangedDuringLoad" } }, { "key": "error:WorkspaceExternalDocumentRejected", "category": "error", "facts": { "value": "WorkspaceExternalDocumentRejected" } }, { "key": "error:WorkspaceInputEvaluationFailed", "category": "error", "facts": { "value": "WorkspaceInputEvaluationFailed" } }, { "key": "error:WorkspaceLoadFailed", "category": "error", "facts": { "value": "WorkspaceLoadFailed" } }, { "key": "error:WorkspaceNotSupported", "category": "error", "facts": { "value": "WorkspaceNotSupported" } }, { "key": "error:WorkspaceOutOfDate", "category": "error", "facts": { "value": "WorkspaceOutOfDate" } }, { "key": "error:WorkspaceProjectOutsideRoot", "category": "error", "facts": { "value": "WorkspaceProjectOutsideRoot" } }, { "key": "policy:external-document:allow-read-only", "category": "policy:external-document", "facts": { "numericValue": 0 } }, { "key": "policy:external-document:reject-workspace", "category": "policy:external-document", "facts": { "numericValue": 1 } }, { "key": "status-field:allowedWorkspaceRootCount", "category": "status-field", "facts": { "type": "integer", "required": true, "nullable": false } }, { "key": "status-field:externalDocumentPolicy", "category": "status-field", "facts": { "type": "string", "required": true, "nullable": false } }, { "key": "status-field:workspaceAdmission", "category": "status-field", "facts": { "type": "string", "required": true, "nullable": false } } ], "evidence": [ { "level": "unit", "project": "test/Roslyn.Workbench.Mcp.Workspace.Test/Roslyn.Workbench.Mcp.Workspace.Test.csproj", "source": "test/Roslyn.Workbench.Mcp.Workspace.Test/Lifecycle/WorkspaceLifecycleServiceTests.cs", "test": "Roslyn.Workbench.Mcp.Workspace.Test.Lifecycle.WorkspaceLifecycleServiceTests.GIVEN_ExternalDocumentRejectedByPolicy_WHEN_OpeningWorkspace_THEN_ShouldRejectAndDispose" }, { "level": "unit", "project": "test/Roslyn.Workbench.Mcp.Workspace.Test/Roslyn.Workbench.Mcp.Workspace.Test.csproj", "source": "test/Roslyn.Workbench.Mcp.Workspace.Test/Lifecycle/WorkspaceLifecycleServiceTests.cs", "test": "Roslyn.Workbench.Mcp.Workspace.Test.Lifecycle.WorkspaceLifecycleServiceTests.GIVEN_PathOutsideHostAuthority_WHEN_OpeningWorkspace_THEN_ShouldRejectBeforeLoading" }, { "level": "unit", "project": "test/Roslyn.Workbench.Mcp.Workspace.Test/Roslyn.Workbench.Mcp.Workspace.Test.csproj", "source": "test/Roslyn.Workbench.Mcp.Workspace.Test/Transactions/WorkspaceMutationCandidateValidatorTests.cs", "test": "Roslyn.Workbench.Mcp.Workspace.Test.Transactions.WorkspaceMutationCandidateValidatorTests.GIVEN_ExistingDocumentOutsideWorkspaceRoot_WHEN_ChangingText_THEN_ShouldRejectIt" } ] }, { "id": "trusted-local-execution-boundary", "title": "Roslyn Workbench is not a hostile-code sandbox", "classification": "limitation", "actor": "Operating environment and repository owner", "outcome": "Workspaces, builds, analysers, generators, Code Action providers and enabled plugins must be trusted for local execution.", "boundary": "The server is local and stdio-based, but trusted extensions and build inputs execute with the Host process authority.", "residualRisk": "Hostile code with the same operating-system authority can bypass application-level controls and access local data directly.", "surface": [ { "key": "plugin-loading:execution-boundary", "category": "plugin-loading", "facts": { "processIsolation": false, "hostAuthority": true } } ], "evidence": [] } ] }