Skip to content

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

TypeScript

docs(hcc): document that the generic/remote OAuth carriles need no HCC type change (S3.3)

Diego Zacariasd1c5cb5e0fff
diff --git a/host-context-controller/package-lock.json b/host-context-controller/package-lock.json
index 8e2309e28..054ca389b 100644
--- a/host-context-controller/package-lock.json
+++ b/host-context-controller/package-lock.json
@@ -1,12 +1,12 @@
{
"name": "clerum-host-context-controller",
- "version": "0.1.341",
+ "version": "0.1.343",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "clerum-host-context-controller",
- "version": "0.1.341",
+ "version": "0.1.343",
"license": "SEE LICENSE IN LICENSE",
"dependencies": {
"@clerum/codex-catalog-projection": "file:../packages/codex-catalog-projection",
diff --git a/host-context-controller/package.json b/host-context-controller/package.json
index 1c1e7faec..9ea05aa9a 100644
--- a/host-context-controller/package.json
+++ b/host-context-controller/package.json
@@ -1,6 +1,6 @@
{
"name": "clerum-host-context-controller",
- "version": "0.1.342",
+ "version": "0.1.343",
"description": "Host Context Controller - provides McpServer CRDs to mcp-host via REST API",
"main": "dist/main.js",
"engines": {
diff --git a/host-context-controller/src/types.ts b/host-context-controller/src/types.ts
index f539d814f..6d3ed5940 100644
--- a/host-context-controller/src/types.ts
+++ b/host-context-controller/src/types.ts
@@ -30,9 +30,19 @@ export interface McpServerSecretRef {
*/
export interface McpServerOAuth {
id: string
- // Full control-api adapter set — must mirror the mcpserver.yaml `oauth.provider`
- // enum, control-api `providers.ts` `OAuthProvider`, and workflow-recipes
- // `OAuthProvider`. U2 (spec 06) added monday/clickup/vercel.
+ // Baked-carril only. Full control-api adapter set — must mirror the
+ // mcpserver.yaml `oauth.provider` enum, control-api `providers.ts`
+ // `OAuthProvider`, and workflow-recipes `OAuthProvider`. U2 (spec 06) added
+ // monday/clickup/vercel. The sourced carriles (`spec.oauth.source: 'remote'`
+ // — spec 02 — and `'generic'` — spec 01 S3) carry NO provider and instead
+ // pin their own endpoints/knobs; those fields are deliberately NOT modelled
+ // here because HCC reads only `grantScope` (deriveAuthKind) and `bearerInBody`
+ // from the oauth block (the CR is spread verbatim into the inventory in
+ // k8sClient, so unmodelled sourced fields pass through untyped and unread —
+ // the token carril is mcp-host's/control-api's, never HCC's). A generic/remote
+ // CR therefore flows through HCC with `provider` absent at runtime; no HCC
+ // read dereferences it. Do not "fix" this by adding 'generic'/'remote' to the
+ // provider union — they are carriles, not providers (Option A, spec 01 DEC-28).
provider:
| 'salesforce'
| 'slack'