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.jsonindex 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.jsonindex 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.tsindex 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.mdindex 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 sourceIP. Hosts behind one NAT, egress gateway or proxy can exhaust it for oneanother, 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 multiplicitydiff --git a/docs/deploy/plugin-workload-sdk-upgrade.md b/docs/deploy/plugin-workload-sdk-upgrade.mdindex 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` andare registered in both `deploy/base/control-plane/configmaps.yaml` and the