Browse documentation

sync

[solution]

Refresh the current build model and source snapshot.

Unreleased read-only preview. Technical reference for agents and client integrators.

This tool requires no parameters.

Examples

Technical examples for agents and client integrators. Replace paths and opaque keys with returned workspace values.

Illustrative arguments

Arguments
{}
Full MCP request
Full MCP request
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "sync",
    "arguments": {}
  }
}

Response notes

This call refreshes the build model and source snapshot. Trusted workspaces can execute builds; network access needs a separate startup grant. A failed replacement preserves the previous generation. Inspect the failed load, reload, or sync result for its reason. Use server_status to confirm the retained generation and load state. A successful refresh invalidates earlier keys and cursors. Discard them, repeat declaration discovery, and retry the original read.