@hejielijob/dsh-wren-data-agent-contract

Harness configuration

The workspace builds the bundle package as @hejielijob/dsh-wren-data-agent. It is not currently published to npm. Its Host package stages the query sidecar, Semantic Console server, and production SPA into the local package artifact, so the artifact can be installed into Harness after it is built from source.

Configure the Host with an absolute Wren project directory and the Python interpreter that contains the packaged runtime dependencies:

- id: wren-data-agent-host
  config:
    pythonExecutable: C:\Python311\python.exe
    projectDir: D:\data\wren-project
    databaseDsnEnv: WREN_DATABASE_URL
    # semanticConsoleEnabled: false
    # workingDirectory: D:\managed\sidecar

Provide the read-only PostgreSQL DSN through the operating system or a secret manager, using the environment-variable name configured by databaseDsnEnv. Never put the DSN itself in Bundle configuration.

For a packaged Host install, install the Python runtimes into the Host's selected environment:

$sidecarDir = "C:\path\to\node_modules\@hejielijob\dsh-wren-data-agent-host\python\sidecar"
$consoleDir = "C:\path\to\node_modules\@hejielijob\dsh-wren-data-agent-host\python\semantic-console"
$python = "C:\Python311\python.exe"

Push-Location $sidecarDir
& $python -m pip install ".[wren]"
Pop-Location
& $python -m pip install $consoleDir

The public Harness Client context does not currently expose a stable Host-to-Client Console URL. The Client therefore uses http://127.0.0.1:48763 by default. An embedding can pass semanticConsoleUrl to the exported view/link props or set localStorage['dsh-wren-data-agent.semantic-console-url']; only credential-free absolute HTTP(S) URLs are accepted.