StrataCortex

Provider Settings

Configure external runtimes in the orchestrator server `.env`, then restart it.

Tools & Capabilities
mockDeterministic mock execution

STRATACORTEX_RUNTIME_MODE=mock selected deterministic local provider execution.

Provider
mock
Mode Source
STRATACORTEX_RUNTIME_MODE=mock
Model
not active
Cost Tracking
enabled
Approvals
enforced
Key Label
unlabeled
Run Limit
unknown

Where To Configure

Provider settings are server-side only. Add runtime IDs to STRATACORTEX_EXTERNAL_PROVIDER_IDS, then configure each runtime with the matching prefix.

STRATACORTEX_EXTERNAL_PROVIDER_IDS=local_cli
STRATACORTEX_EXTERNAL_LOCAL_CLI_RUNTIME_NAME=Local CLI Runtime
STRATACORTEX_EXTERNAL_LOCAL_CLI_PROFILE=generic-cli
STRATACORTEX_EXTERNAL_LOCAL_CLI_COMMAND=/absolute/path/to/runtime
STRATACORTEX_EXTERNAL_LOCAL_CLI_ARGS_JSON=["--jsonl"]
STRATACORTEX_EXTERNAL_LOCAL_CLI_WORKING_DIRECTORY=/absolute/path/to/runtime-jail
STRATACORTEX_EXTERNAL_LOCAL_CLI_ENV_ALLOWLIST=PATH,HOME
STRATACORTEX_EXTERNAL_LOCAL_CLI_LOG_FILE_PATHS=logs/runtime.jsonl
STRATACORTEX_EXTERNAL_LOCAL_CLI_SESSION_DIRECTORY=sessions
STRATACORTEX_EXTERNAL_LOCAL_CLI_HEALTH_CHECK_COMMAND=/absolute/path/to/runtime
STRATACORTEX_EXTERNAL_LOCAL_CLI_HEALTH_CHECK_ARGS_JSON=["--version"]
STRATACORTEX_EXTERNAL_LOCAL_CLI_CAN_CANCEL=true
STRATACORTEX_EXTERNAL_LOCAL_CLI_CAN_STREAM=true
STRATACORTEX_EXTERNAL_LOCAL_CLI_REQUIRES_APPROVAL_FOR_START=true
STRATACORTEX_EXTERNAL_LOCAL_CLI_COMMAND_ALLOWLIST=/absolute/path/to/runtime
STRATACORTEX_EXTERNAL_LOCAL_CLI_ALLOWED_SESSION_EXTENSIONS=.json,.jsonl,.log,.md,.txt,.yaml,.yml
unconfiguredNo external providers configuredSTRATACORTEX_EXTERNAL_PROVIDER_IDS

Add Your First Runtime

Start with a single `generic-cli` runtime and keep STRATACORTEX_EXTERNAL_LOCAL_CLI_REQUIRES_APPROVAL_FOR_START=true until you trust the wrapper.

STRATACORTEX_EXTERNAL_LOCAL_CLI_RUNTIME_NAME *
Display name shown to Control Room operators.
STRATACORTEX_EXTERNAL_LOCAL_CLI_PROFILE *
One of generic-cli, generic-http, generic-webhook, or file-backed-session.
STRATACORTEX_EXTERNAL_LOCAL_CLI_COMMAND
Single executable token for generic-cli runtimes; shell fragments are rejected.
STRATACORTEX_EXTERNAL_LOCAL_CLI_ARGS_JSON
JSON array of command arguments. Prefer this over comma-separated args.
STRATACORTEX_EXTERNAL_LOCAL_CLI_WORKING_DIRECTORY *
Runtime jail root. Logs and sessions must resolve inside this directory.
STRATACORTEX_EXTERNAL_LOCAL_CLI_ENV_ALLOWLIST
Comma-separated env var names passed through to the process.
STRATACORTEX_EXTERNAL_LOCAL_CLI_LOG_FILE_PATHS
Comma-separated log files, relative to the working-directory jail.
STRATACORTEX_EXTERNAL_LOCAL_CLI_SESSION_DIRECTORY
Session artifact directory, relative to the working-directory jail.
STRATACORTEX_EXTERNAL_LOCAL_CLI_WEBHOOK_URL
HTTP or webhook endpoint for generic-http and generic-webhook profiles.
STRATACORTEX_EXTERNAL_LOCAL_CLI_HEALTH_CHECK_COMMAND
Single executable token used only for runtime health checks.
STRATACORTEX_EXTERNAL_LOCAL_CLI_HEALTH_CHECK_ARGS_JSON
JSON array of health-check arguments.
STRATACORTEX_EXTERNAL_LOCAL_CLI_CAN_CANCEL
Boolean controlling whether process cancellation is exposed.
STRATACORTEX_EXTERNAL_LOCAL_CLI_CAN_STREAM
Boolean controlling whether stdout/stderr streaming is exposed.
STRATACORTEX_EXTERNAL_LOCAL_CLI_REQUIRES_APPROVAL_FOR_START
Boolean forcing process starts into a human approval proposal.
STRATACORTEX_EXTERNAL_LOCAL_CLI_COMMAND_ALLOWLIST
Comma-separated executable allowlist for runtime and health commands.
STRATACORTEX_EXTERNAL_LOCAL_CLI_ALLOWED_SESSION_EXTENSIONS
Comma-separated readable session file extensions.