Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 3 additions & 9 deletions .env.example
Original file line number Diff line number Diff line change
@@ -1,21 +1,15 @@
# Server-side Vite development proxy target. This value is never exposed to
# browser JavaScript.
# Retired AGENTS_API_PROXY_* and AGENTS_CORE_WEB_* settings are rejected; use
# OAC_WEB_DEV_PROXY_* and OAC_WEB_* below, including in existing .env files.
OAC_WEB_DEV_PROXY_TARGET=http://127.0.0.1:8091

# Legacy development proxy only. The console never calls /v1; the Vite server
# still forwards /v1 with this Project API key for older tooling such as
# scripts/core-doctor.mjs (see docs/web/roadmap.md). Plaintext bearer file read
# only by the local Vite server; if unset, it checks this conventional path.
OAC_WEB_DEV_PROXY_TOKEN_FILE=~/.oac/dev/web-token
# Optional server-only OTLP/HTTP Runtime history exporter configuration.
# When unset, current observations and the Dashboard require no telemetry backend.
# Runtime history uses the Core PostgreSQL database with 30-second periodic sampling.
# Optional sampling/OTLP export overrides: services/agents-api/runtime-history/README.md
# OAC_HISTORY_SETTINGS_FILE=/absolute/path/runtime-history.json
# Set sample_interval_seconds (5..300) in that server-only file to change the
# sampling interval; omitted or zero keeps 30 seconds.

# Core reads its own environment, not this file. Core settings, including
# Runtime history sampling and export, are in docs/configuration.md.

# Alternative server-side value for the legacy /v1 development proxy. Never use a
# VITE_ prefix, and do not set this together with OAC_WEB_DEV_PROXY_TOKEN_FILE.
Expand Down
2 changes: 1 addition & 1 deletion AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,7 @@ Most boundaries still span several files; the listed file or directory is the en
- Each setting and each piece of data is written in one place and read from that place, with no second copy, no environment-variable or file fallback and no alias.
- Configuration files are grouped by category, never scattered. A new setting joins its category and lives beside its peers.

The categories are [process settings](docs/configuration.md#process-settings-configjson), [derived files](docs/configuration.md#how-oac-apply-works), [secrets](docs/configuration.md#secrets-and-identity), and Core's database for [runtime settings](docs/configuration.md#runtime-settings-web) and execution data. [Configuration](docs/configuration.md) owns the installation layout and the settings themselves.
The categories are [process settings](docs/configuration.md#process-settings-configjson), [derived files](docs/configuration.md#how-oac-apply-works), [secrets](docs/configuration.md#installation-directory), and Core's database for [runtime settings](docs/configuration.md#runtime-settings-web) and execution data. [Configuration](docs/configuration.md) owns the installation layout and the settings themselves.

### Pre-release: no compatibility layers

Expand Down
4 changes: 2 additions & 2 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ This guide owns how to work in the repository: documentation ownership, the repo
| Harness qualification and acceptance | [Harness integration](contracts/agents-api/harnesses.md) |
| Harness selection and Agent defaults | [Harness selection](contracts/agents-api/harness-selection.md) |
| Provider selection, sandbox deployment and E2B setup | [Sandbox deployment](contracts/agents-api/sandbox-deployment.md) |
| Hosted sandbox nodes | [Hosted sandbox manager](services/agents-api/HOSTED-SANDBOX-MANAGER.md) |
| Hosted sandbox nodes | [Nodes guide](docs/getting-started/nodes.md) and [sandbox deployment contract](contracts/agents-api/sandbox-deployment.md) |
| Claude private bridge and Runtime artifact | [Claude SDK adapter](packages/claude-sdk-adapter/README.md) |
| MiniMax Code and Claude Runtime adapter rules | [MiniMax Code Runtime](services/agents-api/deploy/mcode/README.md), [Claude Runtime](services/agents-api/deploy/claude/README.md) |
| CI, distribution builds, installer lifecycle and managed HTTPS, release publication | [Maintainer guide](docs/maintainers.md) |
Expand Down Expand Up @@ -150,7 +150,7 @@ Native adapter changes require their build/check targets and live provider accep

Provider bootstrap, Runtime images and Harness adapters must agree on these names. Daemon startup rejects renamed settings before any subcommand and reports replacements without values; the separate Parsar product integration settings remain unchanged. No old label is accepted as a fallback.

Historical Runtime and project-version upgrades are not supported. Do not ship retired installer conversion implementations; preserve rejection guards under the [installer lifecycle contract](deploy/install/README.md#versions-and-the-lock). Preserve older installations, Runtime files, provider resources and Session history; install the current release separately. Startup never verifies and rebinds historical allocations or accepts node deployments without a valid specification. Keep the original Core responsible for unresolved resources; see the [operator boundary](services/agents-api/HOSTED-SANDBOX-MANAGER.md#historical-installations). Use this release's template builder for new E2B templates. Ordinary current-version database initialization uses the migration runner.
Historical Runtime and project-version upgrades are not supported. Do not ship retired installer conversion implementations; preserve rejection guards under the [installer lifecycle contract](deploy/install/README.md#versions-and-the-lock). Preserve older installations, Runtime files, provider resources and Session history; install the current release separately. Startup never verifies and rebinds historical allocations or accepts node deployments without a valid specification. Keep the original Core responsible for unresolved resources; see the [installation version policy](docs/getting-started/operations.md#installation-version-policy). Use this release's template builder for new E2B templates. Ordinary current-version database initialization uses the migration runner.

The dormant Pi adapter keeps its `parsar` provider slug because the separate Parsar product pins model selections to that identity. This is a product boundary exception for the name guard, like the skill-upload integration.

Expand Down
2 changes: 1 addition & 1 deletion apps/docs/content/docs/admin-api.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -102,7 +102,7 @@ it is operational attribution, not per-key billing.
## Sandbox administration

The [deployment configuration contract](https://github.com/MiniMax-AI/parsar-core/blob/f6d258735fc601c521dd990e6f9e1ed261f4ef2d/contracts/agents-api/sandbox-deployment.md),
[nodes and sandbox backends reference](https://github.com/MiniMax-AI/parsar-core/blob/f6d258735fc601c521dd990e6f9e1ed261f4ef2d/services/agents-api/HOSTED-SANDBOX-MANAGER.md)
[nodes guide](/hosted-providers)
and [generated OpenAPI](https://github.com/MiniMax-AI/parsar-core/blob/f6d258735fc601c521dd990e6f9e1ed261f4ef2d/contracts/agents-api/core.openapi.yaml)
define deployment and node operations:

Expand Down
Loading
Loading