trace_build

[solution]

Builds a solution or project with dotnet build (or Visual Studio MSBuild with runner 'msbuild'), captures a sensitive build.binlog artifact, and stores normalized buildError/buildWarning evidence in a GliderTrace build session.

Why this tool exists

Build failures need structured error and warning evidence with source positions, not a scrollback of MSBuild output.

How it helps the agent

The model reads normalized build diagnostics with file/line locations and can correlate them to symbols instead of re-parsing console logs.

Try it locally in the GliderTrace playground

Parameters

NameTypeRequiredDescription
targetPathstringNoOptional solution, project, or directory path under the workspace root. Defaults to the workspace root.
configurationstringNoBuild configuration. Defaults to Release.
frameworkstringNoTarget framework moniker passed as --framework. Requires runner 'dotnet'; use properties with runner 'msbuild'.
noRestorebooleanNoSkip restore (--no-restore for dotnet build; omits -restore for msbuild). Defaults to false.
runnerstringNoBuild runner: 'auto' (default, dotnet build) or 'msbuild' (Visual Studio MSBuild.exe located through vswhere; requires the server started with --allow-executable msbuild).
propertiesjsonNoMSBuild properties passed as -p:Key=Value, for example EnableSourceControlManagerQueries=false for git worktrees.
argumentsjsonNoAdditional MSBuild arguments appended verbatim, for example /nr:False or /m. Binary-logger arguments are managed by the tool and rejected.
environmentjsonNoOptional environment variables to set for the build process.
timeoutMsnumberNoOptional build timeout in milliseconds. When exceeded the session completes with status timeout.
summaryLimitnumberNoMaximum diagnostics returned in topFindings, errors first. Clamped to 1..100. Defaults to 20.

Examples

Build the workspace and capture binlog evidence

Request
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "trace_build",
    "arguments": {}
  }
}

Build a legacy solution with Visual Studio MSBuild

Request
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "trace_build",
    "arguments": {
      "runner": "msbuild",
      "properties": {
        "EnableSourceControlManagerQueries": "false"
      }
    }
  }
}

Response Notes

Returns a build session id, status, exit code, errorCount/warningCount/projectCount/buildSucceeded summary, errors-first topFindings, and a sensitive binlog artifact reference.

↑/↓ NavigateEnter OpenSpace Expand