Skip to content

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

TypeScript

docs(control-api): record the exact-match residual of nested per-server URIs

Jose Gabriel Ramirez Encinasfca09987a7db
diff --git a/control-api/package-lock.json b/control-api/package-lock.json
index c46e2a6f0..40ddc08ca 100644
--- a/control-api/package-lock.json
+++ b/control-api/package-lock.json
@@ -1,12 +1,12 @@
{
"name": "clerum-control-api",
- "version": "0.1.705",
+ "version": "0.1.706",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "clerum-control-api",
- "version": "0.1.705",
+ "version": "0.1.706",
"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 36f28b767..00167fa86 100644
--- a/control-api/package.json
+++ b/control-api/package.json
@@ -1,6 +1,6 @@
{
"name": "clerum-control-api",
- "version": "0.1.705",
+ "version": "0.1.706",
"description": "Internal Clerum control plane REST API + UI for managing CRDs and secrets",
"main": "dist/main.js",
"engines": {
diff --git a/control-api/src/oauth/remoteCallback.ts b/control-api/src/oauth/remoteCallback.ts
index ce7eb3f40..e0cddf09a 100644
--- a/control-api/src/oauth/remoteCallback.ts
+++ b/control-api/src/oauth/remoteCallback.ts
@@ -15,6 +15,15 @@ import { RFC1123_RE } from '../http/rfc1123.js'
* so an AS can only ever deliver a code to the server it was issued
* for.
*
+ * Accepted residual: per-server URIs extend the shared one (`/remote/<serverName>…`), so
+ * the separation relies on the AS comparing redirect URIs exactly (RFC 9700 §4.1.3). An
+ * AS that accepted the platform CIMD client (registered for `/remote` only), sent no
+ * `iss`, AND matched redirect URIs by prefix would deliver a code for that client to a
+ * per-server URI, where the callback cannot tell it apart. No AS meeting all three is
+ * known; moving the per-server root would not help against string-prefix matching unless
+ * it shared no prefix with `/oauth-callback/remote`, and the URI shape is fixed once
+ * operators register it.
+ *
* This module is the single place that derives the variant and builds the URI, so the
* value registered at the AS, sent on authorize and replayed on the token exchange
* cannot drift apart. It deliberately imports nothing from the OAuth modules: both