Skip to main content
Version: Next

Host Functions

FScript provides the language and standard library documented in the FScript manual. Terrabuild additionally controls which host functions an extension may call.

Terrabuild exposes the default FScript host registry except for concurrency and interactive-input functions that do not fit deterministic build-graph evaluation:

  • Task.spawn
  • Task.await
  • Console.readLine

Functions Available to Extensions​

Filesystem​

  • Fs.readText
  • Fs.exists
  • Fs.kind
  • Fs.createDirectory
  • Fs.writeText
  • Fs.combinePath
  • Fs.parentDirectory
  • Fs.extension
  • Fs.fileNameWithoutExtension
  • Fs.glob
  • Fs.enumerateFiles

Filesystem access is confined to the workspace root. Paths matching workspace.deny are unavailable; the default deny list is [ ".git" ].

Data and utilities​

  • Regex.matchGroups
  • Hash.md5
  • Guid.new
  • Json.deserialize
  • Json.serialize
  • Xml.queryValues

Output​

  • Console.writeLine

Use returned ShellOperation values to request build commands. Host functions run while Terrabuild evaluates the extension; shell operations run later under normal graph scheduling, container, caching, and failure rules.

For the language's built-in modules and functions, use the FScript standard-library reference.