Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
63 commits
Select commit Hold shift + click to select a range
3e2e903
docs(plan): define optional tools, embeddings, and retrieval architec…
dbowm91 Nov 3, 2026
1d59ccf
docs(plan): define optional tools, embeddings, and retrieval architec…
dbowm91 Nov 3, 2026
8cfe22b
docs(plan): define optional tools, embeddings, and retrieval architec…
dbowm91 Nov 3, 2026
9c0b859
docs(plan): define optional tools, embeddings, and retrieval architec…
dbowm91 Nov 3, 2026
ec675b5
docs(plan): define optional tools, embeddings, and retrieval architec…
dbowm91 Nov 3, 2026
0f3e228
docs(plan): add bounded tool integration milestone handoffs
dbowm91 Nov 3, 2026
c12c893
docs(plan): add bounded tool integration milestone handoffs
dbowm91 Nov 3, 2026
70e0a5c
docs(plan): add bounded tool integration milestone handoffs
dbowm91 Nov 3, 2026
6949380
docs(plan): add hosted execution, embeddings, and RAG handoffs
dbowm91 Nov 3, 2026
c4270fb
docs(plan): add hosted execution, embeddings, and RAG handoffs
dbowm91 Nov 3, 2026
b056615
docs(plan): add hosted execution, embeddings, and RAG handoffs
dbowm91 Nov 3, 2026
dfbe7fc
docs(plan): register optional tools, embedding, and retrieval milestones
dbowm91 Nov 3, 2026
58b5a62
docs(plan): correct section references in optional interop plans
dbowm91 Nov 3, 2026
66aa29b
docs(plan): correct section references in optional interop plans
dbowm91 Nov 3, 2026
ac282b4
docs(plan): correct section references in optional interop plans
dbowm91 Nov 3, 2026
895480f
docs(plan): correct section references in optional interop plans
dbowm91 Nov 3, 2026
3c4c7d1
docs(plan): correct section references in optional interop plans
dbowm91 Nov 3, 2026
862e928
docs(plan): correct section references in optional interop plans
dbowm91 Nov 3, 2026
e0af5dd
docs(plan): correct section references in optional interop plans
dbowm91 Nov 3, 2026
a52b3f8
docs(plan): correct section references in optional interop plans
dbowm91 Nov 3, 2026
0cb6202
docs(plan): correct section references in optional interop plans
dbowm91 Nov 3, 2026
6df9a2a
docs(plan): correct section references in optional interop plans
dbowm91 Nov 3, 2026
e31654f
docs(plan): correct section references in retrieval handoff
dbowm91 Nov 3, 2026
19a0282
Activate tool integration M001
Nov 3, 2026
86d2568
Add optional Eggsearch readiness diagnostics
Nov 3, 2026
3ee6b94
Refresh runtime configuration template hashes
Nov 3, 2026
b3396e1
Close tool integration M001
Nov 3, 2026
553958c
Accept optional tool authority ADR
Nov 3, 2026
31f8284
Promote tool integration M002 to ready
Nov 3, 2026
cf385e4
Activate tool integration M002
Nov 3, 2026
b224da2
Accept embedding inference surface ADR
Nov 3, 2026
df2f6bb
Add default-deny Eggsearch tool grants
Nov 3, 2026
cff31bd
Verify tool grant backup recovery
Nov 3, 2026
da0450b
Test tool policy administrator denial
Nov 3, 2026
3fcbd71
Close tool integration M002
Nov 3, 2026
62175d5
Register tool catalog identity correction
Nov 3, 2026
9886f7e
Activate tool catalog identity correction
Nov 3, 2026
c115fdb
Fix tool grants to use Eggsearch catalog
Nov 3, 2026
8bed0ac
Close tool identity correction and ready MCP gateway
Nov 3, 2026
27f72ce
Activate authenticated MCP gateway plan
Nov 3, 2026
c61a31a
Add authenticated Eggsearch MCP gateway
Nov 3, 2026
1bf79e9
Qualify local embedding provider contract
Nov 3, 2026
34d7f3d
Activate embeddings endpoint implementation
Nov 3, 2026
6458e2f
Move MCP gateway to closure review
Nov 3, 2026
5a24eeb
Bound MCP projections and failure handling
Nov 3, 2026
a3563c1
Close authenticated MCP gateway conditionally
Nov 3, 2026
69284b1
Qualify hosted orchestration handoff
Nov 3, 2026
83b05ef
Activate hosted orchestration implementation
Nov 3, 2026
5451be6
Add bounded hosted Eggsearch orchestration
Nov 3, 2026
088a137
Add qualified OpenAI-compatible embeddings route
Nov 3, 2026
13e8b70
Record conditional hosted orchestration closure
Nov 3, 2026
e92e766
Reconcile M003 gateway closure status
Nov 3, 2026
c03d49b
Record conditional embedding route closure
Nov 3, 2026
92e0117
Record blocked retrieval interoperability qualification
Nov 3, 2026
c9f583c
Reconcile hosted orchestration registry status
Nov 3, 2026
8d44106
Reconcile embedding roadmap with E001 result
Nov 3, 2026
cf5dd24
Reconcile interoperability planning registry notes
Nov 3, 2026
87e5d75
Correct architecture census after feature implementation
Nov 6, 2026
73eac4c
Add PrivateGPT base64 embedding support
Nov 6, 2026
32f5c66
Resolve Rust dependency advisories
Nov 6, 2026
43d3dce
Close_embedding_and_dependency_plans
Nov 6, 2026
cc864f1
Correct_interoperability_registry_status
Nov 6, 2026
931014c
Update_retrieval_and_release_docs
Nov 6, 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
7 changes: 4 additions & 3 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,13 +29,14 @@ providers/transport → `deep-dive-providers.md`; reload/restart →
package version, `server/` thin HTTP adapters, `coordinator/` +
`coordinator/streaming/` (`coordinator.rs`, `execution.rs`, `terminal.rs`,
`timeout.rs`, `types.rs`, `diagnostics.rs` behind `mod.rs`) request lifecycle,
`request/` admission, `wire/` protocol codecs, `routing/` + `accounts/` +
`agent_orchestration.rs` finite hosted tool execution, `request/` admission,
`wire/` protocol codecs, `routing/` + `accounts/` +
`catalog/` + `quota/` + `health/` selection, `model_router.rs` affinity,
`identity.rs` + `web_session.rs` + `user_budget.rs` + `instance_budget.rs` +
`model_policy.rs` on-prem user access, `providers/` transport,
`model_policy.rs` + `tool_policy.rs` on-prem user access, `providers/` transport,
`runtime_lifecycle/` generations + `reload.rs` +
`task_supervisor.rs`, `operations/` local lifecycle, `db/` +
`rust/assets/db/migrations/` v1–v64 immutable.
`rust/assets/db/migrations/` v1–v65 immutable.
- Reusable policy crates: `rust/crates/eggpool-model-routing/` (neutral validation/compilation only; selector execution and affinity cache stay in `rust/src/`), `rust/crates/eggpool-client-config/` (portable Codex/OpenCode projection, profiles, `epc1` tokens, V1/V2 renderers, TOML/JSONC-preserving mutation; EggPool `Config`/catalog/DB/key/endpoint/CLI/file IO stays in `rust/src/operations/integrations.rs`), `rust/crates/eggpool-provider-profile/` (secret-free sans-I/O provider-profile contract plus the canonical bundled asset at `assets/_provider_profiles.toml`; `rust/src/provider_profile.rs` is the only EggPool reader), `rust/crates/eggpool-wire/` (neutral sans-I/O wire kernel; execution stays in `rust/src/`), `rust/crates/eggpool-connect/` (narrow `eggpool-connect` binary: plan/install/verify/backups/restore/remove with byte-exact backups, atomic writes, automatic rollback; no Axum/SQLite/Eggress, no proxy/agent/daemon).
- Tooling only (never a runtime fallback): repo-root `pyproject.toml`, `scripts/`, `tests/tooling/`. `scripts/qualification_sbc.py` is the sole physical-SBC runner (loopback-only, aggregate-only, non-CI). Native tests live in `rust/tests/` (serial; there is no `coordinator_c012`; streaming files are `coordinator.rs`, `execution.rs`, `terminal.rs`, `timeout.rs`, `types.rs`, `diagnostics.rs`).
- Config resolution: `--config` > `$EGGPOOL_CONFIG` > `~/.config/eggpool/config.toml` > `./config.toml`. Provider/upstream keys come from environment/`.env`, never committed; the server key lives under `[server]` (`api_key` via `eggpool newkey`, or `api_key_env`). Examples: `rust/config.example.toml`, `rust/config.sbc.example.toml`.
Expand Down
10 changes: 7 additions & 3 deletions architecture/deep-dive-on-prem-user-access.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,13 +13,16 @@ history.

## Ownership boundary

The subsystem is five flat runtime modules plus two HTTP adapter surfaces:
The subsystem is six flat runtime modules plus two HTTP adapter surfaces:

| Path | Owns |
|---|---|
| `rust/src/identity.rs` | Local user records, password hashes, personal API credentials, the administrative audit trail, and the request-attribution types |
| `rust/src/web_session.rs` | Opaque browser sessions, the CSRF digest, and bounded local login throttling |
| `rust/src/model_policy.rs` | Versioned, user-specific model authorization (profiles, exact rules, per-user overrides, instance denials) |
| `rust/src/tool_policy.rs` | Default-deny Eggsearch discovery/invocation authorization, explicit credential scopes, exact profile/user rules, instance denials, and content-free audit mutations |
| `rust/src/server/tools.rs` | Disabled-by-default authenticated MCP JSON POST gateway; bounded backend operations, per-request grant rechecks, and user-bound downstream sessions |
| `rust/src/server/hosted.rs` | Disabled-by-default finite hosted operation; bounded model/tool sequencing, content-free parent attribution, and grant/catalog rechecks |
| `rust/src/user_budget.rs` | Durable per-user budget rules, admission holds, attempt usage, and settled usage windows |
| `rust/src/instance_budget.rs` | The instance-global budget scope intersected with the per-user rules |
| `rust/src/server/auth.rs` | Browser login, session cookies, CSRF forms, and forwarded-HTTPS validation |
Expand All @@ -31,8 +34,9 @@ The boundary is deliberately narrow:
the embedded migration chain. The subsystem owns no schema of its own and
opens no second writer; every read and write goes through `Database`.
- `rust/src/coordinator/` owns request admission, durable publication, and
terminal settlement. The subsystem supplies the *facts* (an authenticated
principal, a policy snapshot, budget limits) and never dispatches upstream.
terminal settlement. Hosted model turns enter through its ordinary
attributed endpoint. The hosted controller does not add retry, provider
selection, or finalization ownership.
- `rust/src/routing/`, `rust/src/quota/`, and `rust/src/health/` keep owning
upstream provider accounts, provider quota, and provider health. Downstream
user budgets are independent of provider quota and never share a counter.
Expand Down
10 changes: 10 additions & 0 deletions architecture/deep-dive-transcoder.md
Original file line number Diff line number Diff line change
Expand Up @@ -190,6 +190,16 @@ rejected as `StatefulResponsesFeature`), media/document caps, token and reservat
envelope. It never encodes provider payloads, never plans translations, and never stores credentials, prompts,
raw bodies, or cache keys.

Embeddings are a deliberately separate finite surface. `request::embeddings`
bounds text input and validates indexed finite vectors without constructing a
dialogue canonical request. `coordinator/endpoints.rs` applies the ordinary
principal and model-policy resolution, and `coordinator/finite.rs` carries the
operation through selection, publication, provider submission, and
finalization. Only an exact provider model allowlist plus fixed
`embeddings_path` qualifies; chat-wire support cannot imply embeddings. The
operation label is `openai_embeddings`, while usage records input tokens only
when the provider reports valid usage.

## Invariants

- Canonical IR before adaptation: every encode builds a fresh target payload from canonical intent; translated payloads are never chained.
Expand Down
25 changes: 18 additions & 7 deletions architecture/overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -75,9 +75,9 @@ fail closed on validation, commit, or ownership ambiguity.
`AppError` to `ExitCode` (`Command` code, `Interrupted` → 130, else 1).
`rust/src/lib.rs` declares the module tree (with `forbid(unsafe_code)`) and
re-exports the CLI/config/error boundary. `rust/src/cli.rs` owns the Clap
command tree (35 commands: `serve`, `connect`, `logout`, `check-config`, `edit`, `getkey`,
command tree (36 commands: `serve`, `connect`, `logout`, `check-config`, `edit`, `getkey`,
`newkey`, `configsetup`, `configremote`, `deploy`, `accounts`, `dashboard`, `db`, `models`,
`modelinfo`, `stats`, `users`, `onboard`, `croncheck`, `ensure-running`, `migrate`,
`modelinfo`, `stats`, `tools`, `users`, `onboard`, `croncheck`, `ensure-running`, `migrate`,
`stop`, `restart`, `init-config`, `help`, `recover`, `uninstall`, `update`,
`install-provenance`, `set`, `rehash`, `runtime-status`, `status`, `backup`, `version`).
`rust/src/runtime.rs` adapts each command to `operations/*`, `config`, and
Expand All @@ -98,7 +98,7 @@ Deep dive: [Core](deep-dive-core.md).
`rust/src/config.rs` is the typed TOML contract (`Config`, `ServerConfig`,
`UpstreamConfig`, `DatabaseConfig`, `RoutingConfig`, `ModelsConfig`,
`ProviderConfig`, `DashboardConfig`, `SecurityConfig`, `MetricsConfig`,
`BackupConfig`, `ModelRouterConfig`, `IntegrationsConfig` (`[integrations].advertise_base_url`),
`BackupConfig`, `ModelRouterConfig`, `IntegrationsConfig` (`[integrations].advertise_base_url`), `ToolBackendConfig` (`[tools]`, explicit diagnostics, optional gateway, and disabled-by-default hosted execution),
transcoder/model-info policies) with
`from_toml`/`validate` and proxy/model-router compilation. Resolution order is
explicit `--config` > `$EGGPOOL_CONFIG` > `$XDG_CONFIG_HOME`-aware
Expand Down Expand Up @@ -145,7 +145,7 @@ compact via finite-only `execute_compact_finite`), `dashboard/`
(thin route facade plus bounded read projections, static/theme delivery,
shared formatting, and page-family renderers).
Route topology (every route registered by `rust/src/server/mod.rs`):
inference at `/v1/chat/completions`, `/v1/messages`,
inference at `/v1/chat/completions`, `/v1/embeddings`, `/v1/messages`,
`/v1/responses`, `/v1/responses/compact` (bounded distinct compaction
operation, not a Responses alias); discovery and health at `/v1/models`,
`/v1/healthz`, `/v1/readyz`; observability at `/api/status`,
Expand Down Expand Up @@ -184,6 +184,11 @@ token estimates + routing facts). `body.rs` owns deterministic compact JSON
encoding; `limits.rs` owns overflow-safe media/token/reservation estimators
and surface-aware output-token resolution; `resource_budget.rs` owns the
effective body ceiling (`max(64 MiB, live limit)`, capped at 256 MiB).
The finite `/v1/embeddings` operation uses `request/embeddings.rs` for a
separate text/vector contract and never enters the dialogue IR. Its endpoint
reuses principal/model-policy admission, while provider selection requires an
exact operator-qualified model and fixed embeddings path. Text/vector content
is not logged or persisted; missing upstream usage remains unknown.

Deep dives: [Request lifecycle](deep-dive-request-lifecycle.md),
[Transcoding](deep-dive-transcoder.md).
Expand Down Expand Up @@ -347,7 +352,7 @@ is the only persistence boundary. `db/` owns only the `backup_to` snapshot
primitive; backup orchestration lives in `operations/backup.rs` and crash
repair in `runtime_lifecycle/recovery.rs` plus coordinator reconciliation.
Migrations (`rust/assets/db/migrations/`,
currently v1–v64 with `checksums.json`) are embedded and immutable; commit or
currently v1–v65 with `checksums.json`) are embedded and immutable; commit or
ownership ambiguity fails closed; startup reconciliation repairs only covered
states. Repositories accept no unbounded diagnostic content and never store
credentials, prompts, raw bodies, or cache keys.
Expand Down Expand Up @@ -501,8 +506,14 @@ observability JSON (`/api/stats/transcoding`, `/api/stats/cache-observability`,
observational only.
- On-prem user access: local downstream identities with Argon2id passwords and
revocable per-user agent tokens (`eggpool users …`), browser login behind a
session/CSRF boundary, versioned per-user model policy, and per-user plus
instance-global daily/monthly budgets; the admin and member surfaces are the
session/CSRF boundary, versioned per-user model policy, default-deny Eggsearch
tool grants and explicit per-token tool scopes, a disabled-by-default
authenticated Eggsearch MCP gateway at `POST /api/tools/v1/mcp`, and a separate
finite hosted operation at `POST /api/agent/v1/run`; per-user and instance-global
daily/monthly budgets remain owned by their current authorities. Hosted model
turns remain coordinator calls, while tool calls reauthorize through the
gateway's internal bounded invocation service.
The admin and member surfaces are the
`/admin/*`, `/users`, `/profiles`, `/account*`, `/my-account*`, and `/usage`
routes; see [On-prem user access](deep-dive-on-prem-user-access.md).
- CLI: full command tree in §1 (`status` is the concise provider health
Expand Down
36 changes: 36 additions & 0 deletions docs/agent-configuration.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,30 @@ Codex and OpenCode additionally support a managed lifecycle that installs a gene

`eggpool configremote` is the headless companion: on the EggPool host it exports a small secret-free `epc1` connection profile for Codex/OpenCode running on other machines. Local `configsetup` writes the local filesystem; `configremote` never touches a desktop filesystem and never mutates EggPool config to manufacture a setup.

## Optional EggPool MCP tools

The tools gateway is a separate, disabled-by-default MCP endpoint. Configure
the agent's Streamable HTTP MCP client to use
`http://<eggpool-host>:11300/api/tools/v1/mcp` (or the HTTPS URL of the
operator-managed reverse proxy) and provide a personal EggPool token through
the agent's secret/environment mechanism. The token needs the
`tools:discover:eggsearch` scope for listing and `tools:invoke:eggsearch` for
calling, and an administrator must grant the specific tools. The route
supports MCP `2025-03-26` initialize, list, and call over JSON POST; clients
that require downstream GET/SSE streams, resources, prompts, or resumable
sessions are not supported. Ordinary inference tool declarations remain
client-executed. See the [gateway security and protocol guide](tool-gateway.md).

## Optional finite hosted execution

`POST /api/agent/v1/run` is a distinct EggPool-specific finite operation, not
part of the generated Codex/OpenCode provider profile. It runs only when the
operator enables hosted execution and lists an exact qualified model ID. The
request chooses an explicit subset of Eggsearch tools, and the managed token
needs inference plus current per-user tool scopes and grants. It has no
conversation persistence or streaming/resume support. See the
[hosted orchestration guide](hosted-tool-orchestration.md).

## Supported Targets

For hard token budgets, clients must send an explicit output cap supported by
Expand Down Expand Up @@ -255,3 +279,15 @@ they explicitly migrate away from the legacy shared server key.
Managed OpenCode installation touches only the owned `eggpool` entry (plus its narrowly scoped parent key when EggPool creates it), preserving JSONC comments, trailing commas, indentation, ordering, unrelated providers, and nested settings byte-for-byte. A pre-existing `eggpool` entry is captured on first apply and restored exactly on `--remove`; an emptied parent key is removed only when it holds no comments. Global config lives at `~/.config/opencode/opencode.json` (`OPENCODE_CONFIG` overrides; Windows uses `%APPDATA%\opencode\opencode.json`). Ambiguous documents (both `provider` and `providers` present) and invalid JSONC fail closed with a bounded line/column location instead of a lossy rewrite.

Provider-scoped model IDs are used when `models.collapse_models = false` (the default), so OpenCode can disambiguate providers serving the same upstream model.
# Embeddings API

Agent clients can use `POST /v1/embeddings` with an authorized exact concrete
model ID and either one non-empty text string or an array of text strings.
The endpoint is finite and accepts optional `dimensions` and
`encoding_format: "float"`. Virtual model aliases are not supported on this
operation. Managed-user model policy applies to the submitted model exactly as
it does to other inference routes; a permitted chat model is not necessarily
embedding-enabled. The operator must explicitly qualify that model/provider
pair as described in [providers](providers.md).
For the PrivateGPT-style deployment pattern and its user-isolation limits, see
[external retrieval interoperability](retrieval-interoperability.md).
47 changes: 47 additions & 0 deletions docs/api-reference.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,7 @@ EggPool exposes OpenAI Chat Completions- and Anthropic Messages-compatible paths
| `GET` | `/v1/models` | List models visible to the authenticated principal; managed users see only models allowed by their effective policy |
| `GET` | `/api/user-budget` | Authenticated user rules and bounded usage; admins may add `?user_id=<id>` to inspect one user |
| `POST` | `/v1/chat/completions` | OpenAI Chat Completions-compatible requests |
| `POST` | `/v1/embeddings` | Bounded OpenAI-compatible text embeddings for explicitly qualified provider/model pairs |
| `POST` | `/v1/responses` | Stateless OpenAI Responses-compatible requests; canonical adaptation is allowed to eligible upstream surfaces |
| `POST` | `/v1/responses/compact` | Bounded remote-compaction operation returning replacement history/checkpoint material; native compact-capable upstreams only, otherwise rejected before submission with `501` and the code `remote_compaction_unsupported` |
| `POST` | `/v1/messages` | Anthropic Messages-compatible requests |
Expand All @@ -23,6 +24,26 @@ target the request fails before upstream submission. There is no translated
compaction fallback. Current Codex custom providers default to local
compaction, so remote compaction is not required for normal Codex operation.

`POST /v1/embeddings` accepts a non-empty `input` string or array of strings,
an exact concrete `model`, optional positive `dimensions` (maximum 8192), and
optional `encoding_format: "float"` or `"base64"` (default `"float"`). Base64
responses encode each finite float32 vector as little-endian bytes. Requests
are capped at 64 KiB, 32 inputs, 16 KiB per item, and 64 KiB total UTF-8 input.
The response is finite JSON with one vector per input, contiguous zero-based
indices, and a consistent vector size. EggPool sorts rows by index and returns
the requested client model ID. Token-ID inputs, extra request fields, virtual
model aliases, image inputs, streaming, and guessed provider routes are
unsupported.

An operator must configure both `embedding_models` (an exact model-ID
allowlist) and `embeddings_path` on a provider. Chat support alone never
qualifies a model. Without an eligible configured pair, the request fails with
`501 embeddings_unsupported` before any provider attempt. Normal authentication,
model policy, hard budgets, health, quota, and request finalization still apply.
Input and vector content are not persisted or logged. Upstream usage is passed
through when valid; if absent, it stays absent and usage counters remain
unknown. See [providers](providers.md) for the operator configuration example.

**Capability requirement.** Remote compaction is an operator-configured
provider wire surface fact, not a bundled one. A provider qualifies only when
its `wire_surfaces` entry for `openai_responses` sets
Expand Down Expand Up @@ -147,6 +168,32 @@ enforces the same rules even when a client submits a hidden model manually.
The integration profile's ETag includes the policy revision so client caches
refresh after an administrator changes model access.

Personal credentials may be issued with separate `tools:discover:eggsearch`
and `tools:invoke:eggsearch` scopes. Existing credentials keep their original
scopes. Tool grants are independently default-deny and do not affect model
authorization. With `[tools].enabled = true` and
`[tools].gateway_enabled = true`, the managed-user-only
`POST /api/tools/v1/mcp` route exposes authorized Eggsearch tools using MCP
`2025-03-26`. It supports JSON POST requests for `initialize`,
`notifications/initialized`, `tools/list`, and `tools/call`; it rejects
JSON-RPC batches and other methods, does not implement downstream GET/SSE
streams, resources, prompts, or session resumption, and does not change
Chat/Responses/Messages tool execution semantics. Request bodies are capped at
128 KiB, tool arguments at 32 KiB, backend responses at 1 MiB, concurrent
backend operations at 16, and sessions at 1,024 with a 30-minute idle expiry.
Only the configured loopback Eggsearch 0.4.3 service is contacted. Credentials
are never forwarded; trust labels and structured tool results are preserved.
See the [MCP gateway guide](tool-gateway.md) for the security model and setup.

With `[tools].enabled = true` and `[tools].hosted_execution_enabled = true`,
managed agent tokens may use the finite EggPool-specific
`POST /api/agent/v1/run` operation. It requires an operator-qualified exact
model ID and current per-user Eggsearch invocation grants. The endpoint is
stateless, non-streaming, and bounded; it does not alter client-executed tool
calls on the standard inference APIs. See the
[hosted orchestration guide](hosted-tool-orchestration.md) for its DTO,
resource caps, and configuration.

`GET /api/user-budget` is available to personal tokens and browser sessions.
Members can read only their own rules and rollups; an active admin may select a
target with `user_id`. The response identifies UTC calendar windows and reports
Expand Down
Loading
Loading