Skip to content

Evenfire is an intelligence layer platform for running LLM agents that take real actions, on your infrastructure

TypeScript

docs: correct SDK budget attribution and authenticated defaults

Alfredo Lopez11be57edd9b6
diff --git a/control-api/package-lock.json b/control-api/package-lock.json
index 844a7a064..6792f55e7 100644
--- a/control-api/package-lock.json
+++ b/control-api/package-lock.json
@@ -1,12 +1,12 @@
{
"name": "clerum-control-api",
- "version": "0.1.715",
+ "version": "0.1.716",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "clerum-control-api",
- "version": "0.1.715",
+ "version": "0.1.716",
"dependencies": {
"@clerum/display-field": "file:../packages/display-field",
"@clerum/grok-provider-attempt-contract": "file:../packages/grok-provider-attempt-contract",
diff --git a/control-api/package.json b/control-api/package.json
index 5d49e9968..8ee1b9f0e 100644
--- a/control-api/package.json
+++ b/control-api/package.json
@@ -1,6 +1,6 @@
{
"name": "clerum-control-api",
- "version": "0.1.715",
+ "version": "0.1.716",
"description": "Internal Clerum control plane REST API + UI for managing CRDs and secrets",
"main": "dist/main.js",
"engines": {
diff --git a/control-api/src/services/pluginWorkloadSdkQuotaTracker.ts b/control-api/src/services/pluginWorkloadSdkQuotaTracker.ts
index adc3c5df8..4a99dbc21 100644
--- a/control-api/src/services/pluginWorkloadSdkQuotaTracker.ts
+++ b/control-api/src/services/pluginWorkloadSdkQuotaTracker.ts
@@ -13,7 +13,7 @@ import {
// override still wins (decision §3.1) — it is a per-recipe fairness knob, NOT
// the platform DoS ceiling, so it is intentionally NOT clamped to the default.
// A raised override stays bounded by the grant-independent request bucket
-// (CONTROL_API_PLUGIN_SDK_REQUEST_BUCKET_PER_MIN, default 3000/min) + pre-auth
+// (CONTROL_API_PLUGIN_SDK_REQUEST_BUCKET_PER_MIN, default 6000/min) + pre-auth
// limits (pluginWorkloadSdkRateLimits.ts / plugin-workload-sdk.routes.ts),
// which are the actual anti-DoS backstop.
//
diff --git a/docs/architecture/administrative-rate-limits.md b/docs/architecture/administrative-rate-limits.md
index 11b136bba..8f8b7466d 100644
--- a/docs/architecture/administrative-rate-limits.md
+++ b/docs/architecture/administrative-rate-limits.md
@@ -77,9 +77,12 @@ cannot exceed it from one IP.
Known limitation: the budget does not isolate callers that share a source
IP. Hosts behind one NAT, egress gateway or proxy can exhaust it for one
another, and a flood of invalid tokens from the WRC source IP can deny WRC
-revocation calls until the window resets. With `trust proxy` set to 1, an
-in-cluster caller is identified by its pod IP, so this requires sharing that
-address with the affected caller.
+revocation calls until the window resets. `trust proxy` is set to 1, so the
+source IP is the rightmost `X-Forwarded-For` entry when that header is present
+and the socket address otherwise. A caller that reaches Control API directly,
+such as another in-cluster pod, can set that header itself and be charged to
+any address it names, so exhausting another caller's budget does not require
+sharing its address.
## SDK operation multiplicity
diff --git a/docs/deploy/plugin-workload-sdk-upgrade.md b/docs/deploy/plugin-workload-sdk-upgrade.md
index 15fe1564c..851ab1c84 100644
--- a/docs/deploy/plugin-workload-sdk-upgrade.md
+++ b/docs/deploy/plugin-workload-sdk-upgrade.md
@@ -65,9 +65,9 @@ permanently trapped.
|---|---|---|
| `CONTROL_API_PLUGIN_SDK_NOTIFICATIONS_PER_MIN` | `750` | clientNotifications invocations per minute |
| `CONTROL_API_PLUGIN_SDK_PROMPTBRIDGE_PER_MIN` | `600` | promptBridge invocations per minute |
-| `CONTROL_API_PLUGIN_SDK_REQUEST_BUCKET_PER_MIN` | `3000` | authenticated shared SDK request bucket per minute |
+| `CONTROL_API_PLUGIN_SDK_REQUEST_BUCKET_PER_MIN` | `6000` | authenticated shared SDK request bucket per minute |
| `CONTROL_API_PLUGIN_SDK_PREAUTH_PER_MIN` | `600` | anonymous or invalid-credential source-IP pre-auth checks per minute |
-| `CONTROL_API_PLUGIN_SDK_AUTHENTICATED_PREAUTH_PER_MIN` | `3000` | verified Host principal pre-auth checks per minute |
+| `CONTROL_API_PLUGIN_SDK_AUTHENTICATED_PREAUTH_PER_MIN` | `6000` | verified Host principal pre-auth checks per minute |
The defaults above equal the code defaults in `control-api/src/config.ts` and
are registered in both `deploy/base/control-plane/configmaps.yaml` and the