Skip to content

Unify model configuration across Core and harness execution #222

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
SaladDay merged 14 commits into from
Sep 29, 2026
Merged

Unify model configuration across Core and harness execution #222

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
14 commits
Select commit Hold shift + click to select a range
5e352b7
docs: define harness model configuration preparation contract
SaladDay Sep 29, 2026
75f0341
Unify model configuration client types and projections
SaladDay Sep 29, 2026
b965f26
docs: define harness and model transport capability coordination
SaladDay Sep 29, 2026
226adbf
feat(client): expose harness model configuration support
SaladDay Sep 29, 2026
9fefb05
feat(web): configure default models through shared harness contract
SaladDay Sep 29, 2026
696f3d7
feat: unify model configuration and harness transport admission
SaladDay Sep 29, 2026
29e349a
docs: regenerate unified model configuration references
SaladDay Sep 29, 2026
a987ad1
fix(web): clear native settings when model identity changes
SaladDay Sep 29, 2026
7d27cbe
fix(build): include shared model route qualification in standalone Core
SaladDay Sep 29, 2026
a224b55
fix(model-config): preserve disabled capabilities and empty adapter o…
SaladDay Sep 29, 2026
9d0ed1e
fix(codex): preserve configured reasoning effort on every turn
SaladDay Sep 29, 2026
2116422
docs: refresh native configuration guide
SaladDay Sep 29, 2026
f45a419
Merge main and retain both native installation and model configuratio…
SaladDay Sep 29, 2026
264df8c
docs: link guides to the integrated configuration contract
SaladDay Sep 29, 2026
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: 12 additions & 0 deletions CONTRIBUTING.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3594,6 +3594,18 @@ The [package artifact contract](packages/claude-sdk-adapter/README.md#runtime-ar
owns build isolation, dependency export, readiness and relocation checks.
Keep the adapter artifact independent of the Core binary and product sources.

### Harness model configuration

The configuration preparation contract in `apps/parsar-daemon/internal/agent/harness.go`
is mandatory for every Executor factory. Shared wire types live in
`internal/agentdaemon/proto`; native model fields and their application are documented
in [Harness onboarding](contracts/agents-api/harness-onboarding.md#native-model-configuration).
The standalone Core build includes the shared `internal/modeltransport` route
qualification code alongside the adapter declarations; Runtime still owns proxy
startup and request forwarding.
Public configuration sources and inheritance belong to
[model execution](contracts/agents-api/model-execution.md).

### Harness selection and Agent defaults

Core accepts the optional `agent.x_agents_core.harness` extension through the
Expand Down
24 changes: 12 additions & 12 deletions apps/docs/content/docs/admin-api.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ resource inspection, Project and key management, credential issuance, audit, usa
and sandbox operations. It never calls `/v1` or `/api/v1`, and has no Agent
execution, copy or arbitrary asset editing operation.

Core request failures use the [Core administration error envelope](https://github.com/MiniMax-AI/parsar-core/blob/e4d5a1d30520a967b3a44a257ed1b6c21e388388/contracts/agents-api/core-errors.md),
Core request failures use the [Core administration error envelope](https://github.com/MiniMax-AI/parsar-core/blob/f45a4198aca79bf252412c55cad3647f5d704515/contracts/agents-api/core-errors.md),
including optional typed safe details. Console sign-in endpoints retain their
separate error shape described below.

Expand Down Expand Up @@ -49,9 +49,9 @@ label, but could set any value. Never use it for authorization or as proof of
origin.

Web calls Core only through the typed Core clients in `packages/agents-client`:
[AdminClient](https://github.com/MiniMax-AI/parsar-core/blob/e4d5a1d30520a967b3a44a257ed1b6c21e388388/packages/agents-client/src/admin-client.ts) (`/core/v1`),
[AdminClient](https://github.com/MiniMax-AI/parsar-core/blob/f45a4198aca79bf252412c55cad3647f5d704515/packages/agents-client/src/admin-client.ts) (`/core/v1`),
`SandboxAdminClient` (`/core/v1/sandbox`) and `CoreMetricsClient`
(`/core/v1/metrics`). See [the complete administrator reference](https://github.com/MiniMax-AI/parsar-core/blob/e4d5a1d30520a967b3a44a257ed1b6c21e388388/contracts/agents-api/admin-api.md)
(`/core/v1/metrics`). See [the complete administrator reference](https://github.com/MiniMax-AI/parsar-core/blob/f45a4198aca79bf252412c55cad3647f5d704515/contracts/agents-api/admin-api.md)
for methods, fields, filters, pagination and response shapes.
Routes below are relative to `/core/v1`:

Expand All @@ -62,8 +62,8 @@ Routes below are relative to `/core/v1`:
| Resource lists/details/deletion | `/projects/{id}/agents`, `/sessions`, `/environment-templates`, `/skills`, `/files`, `/vaults`, including the documented nested reads |
| Asset ownership | `GET /projects/{id}/resource-owners` with batched resource IDs |
| Key operation history | `GET /projects/{id}/write-operations` with key/resource/time filters |
| Executor credentials | `GET/POST /projects/{id}/environments/{environment_id}/executor-credentials`, `DELETE …/executor-credentials/{key_id}` ([contract](https://github.com/MiniMax-AI/parsar-core/blob/e4d5a1d30520a967b3a44a257ed1b6c21e388388/contracts/agents-api/environment-executor-credentials.md)) |
| Deployment model providers | `GET /harnesses`, `GET/PUT/DELETE /harnesses/{harness}/model-provider`; the key is write-only ([contract](https://github.com/MiniMax-AI/parsar-core/blob/e4d5a1d30520a967b3a44a257ed1b6c21e388388/contracts/agents-api/model-execution.md#deployment-defaults)) |
| Executor credentials | `GET/POST /projects/{id}/environments/{environment_id}/executor-credentials`, `DELETE …/executor-credentials/{key_id}` ([contract](https://github.com/MiniMax-AI/parsar-core/blob/f45a4198aca79bf252412c55cad3647f5d704515/contracts/agents-api/environment-executor-credentials.md)) |
| Deployment model configuration | `GET /harnesses`, `GET/PUT/DELETE /harnesses/{harness}/model-configuration`; the key is write-only ([contract](https://github.com/MiniMax-AI/parsar-core/blob/f45a4198aca79bf252412c55cad3647f5d704515/contracts/agents-api/model-execution.md#deployment-defaults)) |
| Usage and health | `GET /summary`, `/sandbox/runtime-observations`, `/metrics` |
| Administrator audit | `GET /audit-log`; deployment-wide entries have `project_id: null` |

Expand All @@ -76,9 +76,9 @@ it is operational attribution, not per-key billing.

## Sandbox administration

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

- `GET/POST/PUT /core/v1/sandbox/deployment` and
Expand Down Expand Up @@ -115,7 +115,7 @@ is a durable serving pin, not proof of current connectivity. Target unknown, fai
or update-required state does not by itself invalidate confirmed old-generation
service; consume Core's connection/provider facts separately.

Administrators may [archive an individual hosted Session](https://github.com/MiniMax-AI/parsar-core/blob/e4d5a1d30520a967b3a44a257ed1b6c21e388388/contracts/agents-api/admin-api.md#administrative-session-archive)
Administrators may [archive an individual hosted Session](https://github.com/MiniMax-AI/parsar-core/blob/f45a4198aca79bf252412c55cad3647f5d704515/contracts/agents-api/admin-api.md#administrative-session-archive)
at the current generation without reset. History and persisted Files/Artifacts
survive; unpersisted workspace is lost and the original Session cannot resume.
Cancel reset stops further archives, not cleanup already requested. After zero
Expand Down Expand Up @@ -156,7 +156,7 @@ generated schema; do not interpret every empty or failed read as an absent resou
`GET /core/v1/metrics?range=1h|6h|24h|7d` returns Core process, execution
queue/slots, PostgreSQL and background-job measurements. It requires the Core key,
rejects arbitrary query filters and never grants
Agent execution access. See the [exact measurement contract](https://github.com/MiniMax-AI/parsar-core/blob/e4d5a1d30520a967b3a44a257ed1b6c21e388388/contracts/agents-api/core-metrics.md)
Agent execution access. See the [exact measurement contract](https://github.com/MiniMax-AI/parsar-core/blob/f45a4198aca79bf252412c55cad3647f5d704515/contracts/agents-api/core-metrics.md)
for complete buckets, null values, units and process-local retention. Frontend
implementation is maintained separately; this backend change does not modify
Agent metrics or the public Agent API.
Expand All @@ -165,7 +165,7 @@ Agent metrics or the public Agent API.

The Core key reads a node and its host history through
`GET /core/v1/sandbox/nodes/{node_id}?range=1h|6h|24h`. See the
[node host history contract](https://github.com/MiniMax-AI/parsar-core/blob/e4d5a1d30520a967b3a44a257ed1b6c21e388388/contracts/agents-api/node-host-history.md)
[node host history contract](https://github.com/MiniMax-AI/parsar-core/blob/f45a4198aca79bf252412c55cad3647f5d704515/contracts/agents-api/node-host-history.md)
for nullable observations, freshness and aggregation. The node list is unchanged.

[Repository source](https://github.com/MiniMax-AI/parsar-core/blob/e4d5a1d30520a967b3a44a257ed1b6c21e388388/docs/api/web-management.md)
[Repository source](https://github.com/MiniMax-AI/parsar-core/blob/f45a4198aca79bf252412c55cad3647f5d704515/docs/api/web-management.md)
Loading
Loading