Skip to content

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

TypeScript

fix: always verify sdk-only Codex binding hashes on bootstrap

Alfredo Lopez209d97221f5b
diff --git a/mcp-host/package-lock.json b/mcp-host/package-lock.json
index 39de989fe..47b9639eb 100644
--- a/mcp-host/package-lock.json
+++ b/mcp-host/package-lock.json
@@ -1,12 +1,12 @@
{
"name": "clerum-mcp-host",
- "version": "0.1.304",
+ "version": "0.1.305",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "clerum-mcp-host",
- "version": "0.1.304",
+ "version": "0.1.305",
"license": "SEE LICENSE IN LICENSE",
"dependencies": {
"@anthropic-ai/sdk": "^0.32.0",
diff --git a/mcp-host/package.json b/mcp-host/package.json
index 84c36a4dd..7b6e6ca12 100644
--- a/mcp-host/package.json
+++ b/mcp-host/package.json
@@ -1,6 +1,6 @@
{
"name": "clerum-mcp-host",
- "version": "0.1.304",
+ "version": "0.1.305",
"description": "MCP Host - reads Host CRD and provides LLM access via OpenAI/Claude",
"main": "dist/main.js",
"engines": {
diff --git a/mcp-host/src/pluginWorkloadSdk/bootstrapIdentity.test.ts b/mcp-host/src/pluginWorkloadSdk/bootstrapIdentity.test.ts
index 02f4b34ae..bf90b157b 100644
--- a/mcp-host/src/pluginWorkloadSdk/bootstrapIdentity.test.ts
+++ b/mcp-host/src/pluginWorkloadSdk/bootstrapIdentity.test.ts
@@ -4,7 +4,37 @@ import {
configurePluginWorkloadSdkBootstrapIdentity,
resolvePluginWorkloadSdkBootstrapCapabilityFamily,
} from './bootstrapIdentity'
-import { readSdkOnlyCodexBinding, replaceSdkOnlyCodexBinding } from './sdkOnlyCodexBinding'
+import * as sdkOnlyCodexBinding from './sdkOnlyCodexBinding'
+import {
+ readSdkOnlyCodexBinding,
+ readVerifiedSdkOnlyCodexBinding,
+ replaceSdkOnlyCodexBinding,
+} from './sdkOnlyCodexBinding'
+
+describe('readVerifiedSdkOnlyCodexBinding', () => {
+ const model = 'gpt-5.6-luna'
+ const binding = {
+ connectionKey: 'team-plus',
+ catalogRevision: 4,
+ credentialRevision: 1,
+ model,
+ bindingHash: computeCodexPolicyHash({
+ model,
+ catalogRevision: 4,
+ credentialRevision: 1,
+ connectionKey: 'team-plus',
+ }),
+ }
+
+ it('accepts only a hash that matches the bound fields and expected model', () => {
+ expect(readVerifiedSdkOnlyCodexBinding(binding, model)).toEqual(binding)
+ expect(
+ readVerifiedSdkOnlyCodexBinding({ ...binding, bindingHash: 'a'.repeat(64) }, model)
+ ).toBeNull()
+ expect(readVerifiedSdkOnlyCodexBinding(binding, 'gpt-5.4-mini')).toBeNull()
+ expect(readVerifiedSdkOnlyCodexBinding(undefined, model)).toBeNull()
+ })
+})
describe('Plugin Workload SDK bootstrap identity', () => {
it('uses the host capability projection instead of a request-selected family', async () => {
@@ -159,4 +189,121 @@ describe('Plugin Workload SDK bootstrap identity', () => {
expect(readSdkOnlyCodexBinding()).toEqual(binding)
replaceSdkOnlyCodexBinding(null)
})
+
+ it('integrity-checks a supplied Codex binding even when the request provider is not Codex', async () => {
+ replaceSdkOnlyCodexBinding(null)
+ const verifyBinding = vi.spyOn(sdkOnlyCodexBinding, 'readVerifiedSdkOnlyCodexBinding')
+ const binding = {
+ connectionKey: 'team-plus',
+ catalogRevision: 4,
+ credentialRevision: 1,
+ model: 'gpt-5.4-mini',
+ bindingHash: computeCodexPolicyHash({
+ model: 'gpt-5.4-mini',
+ catalogRevision: 4,
+ credentialRevision: 1,
+ connectionKey: 'team-plus',
+ }),
+ }
+ const verify = vi.fn().mockResolvedValue({
+ ready: true,
+ contractVersion: 2,
+ provider: 'openai',
+ model: 'gpt-5.4-mini',
+ policyReady: true,
+ policyState: 'active',
+ })
+ const result = await configurePluginWorkloadSdkBootstrapIdentity(
+ {
+ capabilityFamily: 'promptBridge',
+ provider: 'openai',
+ model: 'gpt-5.4-mini',
+ contractVersion: 2,
+ codexBinding: binding,
+ },
+ { capabilityFamily: 'promptBridge', verify }
+ )
+ expect(result).toMatchObject({
+ configured: true,
+ ready: true,
+ provider: 'openai',
+ contractVersion: 2,
+ })
+ expect(result).not.toHaveProperty('codexBinding')
+ expect(verifyBinding).toHaveBeenCalledWith(binding, 'gpt-5.4-mini')
+ expect(readSdkOnlyCodexBinding()).toBeNull()
+ verifyBinding.mockRestore()
+ })
+
+ it('rejects a Codex binding whose hash does not match the bound fields', async () => {
+ replaceSdkOnlyCodexBinding(null)
+ const verify = vi.fn()
+ const result = await configurePluginWorkloadSdkBootstrapIdentity(
+ {
+ capabilityFamily: 'promptBridge',
+ provider: 'codex-subscription',
+ model: 'gpt-5.6-luna',
+ contractVersion: 3,
+ codexBinding: {
+ connectionKey: 'team-plus',
+ catalogRevision: 4,
+ credentialRevision: 1,
+ model: 'gpt-5.6-luna',
+ bindingHash: 'a'.repeat(64),
+ },
+ },
+ { capabilityFamily: 'promptBridge', verify }
+ )
+ expect(result).toMatchObject({
+ configured: true,
+ ready: true,
+ contractVersion: 3,
+ policyReady: false,
+ policyReason: 'codex_execution_binding_missing',
+ })
+ expect(verify).not.toHaveBeenCalled()
+ expect(readSdkOnlyCodexBinding()).toBeNull()
+ })
+
+ it('accepts a hash-valid Codex binding even if the request echoes contract v2', async () => {
+ const binding = {
+ connectionKey: 'team-plus',
+ catalogRevision: 4,
+ credentialRevision: 1,
+ model: 'gpt-5.6-luna',
+ bindingHash: computeCodexPolicyHash({
+ model: 'gpt-5.6-luna',
+ catalogRevision: 4,
+ credentialRevision: 1,
+ connectionKey: 'team-plus',
+ }),
+ }
+ const verify = vi.fn().mockResolvedValue({
+ ready: true,
+ contractVersion: 3,
+ provider: 'codex-subscription',
+ model: 'gpt-5.6-luna',
+ policyReady: true,
+ policyState: 'active',
+ codexBindingReady: true,
+ })
+ const result = await configurePluginWorkloadSdkBootstrapIdentity(
+ {
+ capabilityFamily: 'promptBridge',
+ provider: 'codex-subscription',
+ model: 'gpt-5.6-luna',
+ contractVersion: 2,
+ codexBinding: binding,
+ },
+ { capabilityFamily: 'promptBridge', verify }
+ )
+ expect(result).toMatchObject({
+ configured: true,
+ ready: true,
+ contractVersion: 3,
+ codexBinding: binding,
+ })
+ expect(readSdkOnlyCodexBinding()).toEqual(binding)
+ replaceSdkOnlyCodexBinding(null)
+ })
})
diff --git a/mcp-host/src/pluginWorkloadSdk/bootstrapIdentity.ts b/mcp-host/src/pluginWorkloadSdk/bootstrapIdentity.ts
index 498c545a4..1f5574a66 100644
--- a/mcp-host/src/pluginWorkloadSdk/bootstrapIdentity.ts
+++ b/mcp-host/src/pluginWorkloadSdk/bootstrapIdentity.ts
@@ -7,11 +7,7 @@ import type {
PluginWorkloadSdkBootstrapProof,
PluginWorkloadSdkClientNotificationsBootstrapProof,
} from './promptBridge/controlApiClient'
-import {
- isPluginWorkloadSdkCodexBindingProof,
- replaceSdkOnlyCodexBinding,
- verifySdkOnlyCodexBindingHash,
-} from './sdkOnlyCodexBinding'
+import { readVerifiedSdkOnlyCodexBinding, replaceSdkOnlyCodexBinding } from './sdkOnlyCodexBinding'
export interface PluginWorkloadSdkBootstrapIdentityDeps {
/**
@@ -91,14 +87,11 @@ export async function configurePluginWorkloadSdkBootstrapIdentity(
if (!isRunnableLlmModelId(model)) {
return { configured: false, message: 'model is required and has an invalid format' }
}
+ // Always integrity-check a supplied binding before the provider protocol
+ // branch. Request-controlled provider/version must not skip this check.
+ const verifiedBinding = readVerifiedSdkOnlyCodexBinding(req.codexBinding, model)
if (req.provider === 'codex-subscription') {
- const binding = req.codexBinding
- const bindingValid =
- req.contractVersion === 3 &&
- isPluginWorkloadSdkCodexBindingProof(binding) &&
- binding.model === model &&
- verifySdkOnlyCodexBindingHash(binding)
- if (!bindingValid) {
+ if (!verifiedBinding) {
replaceSdkOnlyCodexBinding(null)
return {
configured: true,
@@ -113,7 +106,7 @@ export async function configurePluginWorkloadSdkBootstrapIdentity(
message: 'SDK-only Codex bootstrap requires a live v3 execution binding',
}
}
- replaceSdkOnlyCodexBinding(binding)
+ replaceSdkOnlyCodexBinding(verifiedBinding)
} else {
replaceSdkOnlyCodexBinding(null)
}
diff --git a/mcp-host/src/pluginWorkloadSdk/sdkOnlyCodexBinding.ts b/mcp-host/src/pluginWorkloadSdk/sdkOnlyCodexBinding.ts
index 2ad58ada1..c30042a3b 100644
--- a/mcp-host/src/pluginWorkloadSdk/sdkOnlyCodexBinding.ts
+++ b/mcp-host/src/pluginWorkloadSdk/sdkOnlyCodexBinding.ts
@@ -71,3 +71,17 @@ export function verifySdkOnlyCodexBindingHash(
})
)
}
+
+/**
+ * Integrity-check a caller-supplied Codex binding against the expected model.
+ * This must run for every bootstrap request that carries a binding object;
+ * the request provider/version must not decide whether the hash is verified.
+ */
+export function readVerifiedSdkOnlyCodexBinding(
+ value: unknown,
+ model: string
+): PluginWorkloadSdkCodexBindingProof | null {
+ if (!isPluginWorkloadSdkCodexBindingProof(value)) return null
+ if (value.model !== model) return null
+ return verifySdkOnlyCodexBindingHash(value) ? value : null
+}