Skip to content

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

TypeScript

docs(plugin-sdk): clarify why the grant per-minute override is not clamped

Alfredo Lopez42f46af59e6d
diff --git a/control-api/package-lock.json b/control-api/package-lock.json
index 26f9ceee1..6e79b6515 100644
--- a/control-api/package-lock.json
+++ b/control-api/package-lock.json
@@ -1,12 +1,12 @@
{
"name": "clerum-control-api",
- "version": "0.1.458",
+ "version": "0.1.459",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "clerum-control-api",
- "version": "0.1.458",
+ "version": "0.1.459",
"dependencies": {
"@clerum/display-field": "file:../packages/display-field",
"@clerum/image-policy": "file:../packages/image-policy",
diff --git a/control-api/package.json b/control-api/package.json
index bc83558c6..0afc4d0f2 100644
--- a/control-api/package.json
+++ b/control-api/package.json
@@ -1,6 +1,6 @@
{
"name": "clerum-control-api",
- "version": "0.1.458",
+ "version": "0.1.459",
"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 75ae81e0c..711880989 100644
--- a/control-api/src/services/pluginWorkloadSdkQuotaTracker.ts
+++ b/control-api/src/services/pluginWorkloadSdkQuotaTracker.ts
@@ -10,7 +10,11 @@ import {
// (recipe + method, narrowed to eventType for clientNotifications), derived
// from the invocation audit trail. Defaults come from ENV-backed config
// (platform protection against control-plane DoS); a grant-level per-minute
-// override still wins (decision §3.1).
+// 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 600/min request
+// bucket + pre-auth limits (pluginWorkloadSdkRateLimits.ts /
+// plugin-workload-sdk.routes.ts), which are the actual anti-DoS backstop.
//
// The former per-period leg (`consumeQuota`, backed by
// plugin_workload_sdk_quota_counters) was DELETED (issue #348): the deprecated