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.jsonindex 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.jsonindex 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.tsindex 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.tsindex 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.tsindex 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+}