Experimental Agent V4 support

[TheUnderScorer]

This pull request introduces support for the new Fingerprint Agent v4. It registers new v4-specific routes in the proxy and updates related tests and configuration.

Proxy integration and routing:

• Registered new routes in the proxy for v4 agent endpoints (V4.CDN_PATH, V4.INGRESS_PATH) and added corresponding handler logic for CDN and ingress requests. [1] [2]
• It should maintain full backward compatibility with V3

[github-actions]

Coverage report

St.❔	Category	Percentage	Covered / Total
🟢	Statements	92.56% (-0.02% 🔻)	697/753
🟢	Branches	85.11% (-1.68% 🔻)	160/188
🟢	Functions	91.67% (-0.12% 🔻)	132/144
🟢	Lines	92.71% (-0.05% 🔻)	661/713

Show new covered files 🐣

St.❔	File	Statements	Branches	Functions	Lines
🟢	... / handlers.ts	86.96%	71.43%	75%	86.36%
🟢	... / downloadAgent.ts	96.15%	57.14%	100%	96%
🟢	proxy/v4/paths.ts	100%	100%	100%	100%

Test suite run success

197 tests passing in 21 suites.

Report generated by 🧪jest coverage report action from b36ebb3

Show full coverage report

St	File	% Stmts	% Branch	% Funcs	% Lines	Uncovered Line #s
🟢	All files	92.56	85.1	91.66	92.7
🟢	mgmt-lambda	98.93	93.33	100	98.93
🟢	DefaultSettings.ts	100	100	100	100
🟢	app.ts	97.91	95	100	97.91	26
🟢	auth.ts	100	100	100	100
🟢	exceptions.ts	100	66.66	100	100	20
🟢	routing.ts	100	100	100	100
🟢	mgmt-lambda/handlers	87.22	72.5	93.33	87.15
🟢	errorHandlers.ts	100	71.42	100	100	22,41
🟡	statusHandler.ts	80	50	100	80	76-80,84-89
🟢	updateHandler.ts	87.21	75.86	87.5	87.12	50-51,67-68,139-142,214,219-228,290-291,319
🟢	mgmt-lambda/utils	81.25	88.88	66.66	100
🟢	cloudfrontUtils.ts	100	88.88	100	100	6
🔴	delay.ts	40	100	0	100
🟢	proxy/handlers	87.91	86.95	90.32	88.63
🟢	handleAgentDowloading.ts	96.29	66.66	100	96.15	31
🟡	handleResult.ts	76.74	100	76.92	78.04	90-105
🟢	handleStatus.ts	100	100	100	100
🟡	proxy/test	77.77	100	50	71.42
🟡	aws.ts	77.77	100	50	71.42	4-5
🟢	proxy/test/utils/customer-variables	100	100	100	100
🟢	in-memory-customer-variables.ts	100	100	100	100
🟢	proxy/utils	94.57	85.71	94.28	94.11
🟢	buffer.ts	100	100	100	100
🟢	cache-control.ts	100	100	100	100
🟢	cookie.ts	100	100	100	100
🟢	headers.ts	100	100	100	100
🔴	is-blob.ts	0	0	0	0	6-7
🟢	log.ts	85.71	33.33	100	83.33	11
🟢	request.ts	100	100	100	100
🟢	routing.ts	100	100	100	100
🔴	string.ts	14.28	100	0	14.28	2-8
🟢	traffic.ts	100	100	100	100
🟢	proxy/utils/customer-variables	100	100	100	100
🟢	customer-variables.ts	100	100	100	100
🟢	defaults.ts	100	100	100	100
🟢	header-customer-variables.ts	100	100	100	100
🟢	maybe-obfuscate-variable.ts	100	100	100	100
🟢	selectors.ts	100	100	100	100
🟢	types.ts	100	100	100	100
🟢	proxy/utils/customer-variables/secrets-manager	95.58	100	100	95.52
🟢	normalize-secret.ts	100	100	100	100
🟢	retrieve-secret.ts	100	100	100	100
🟢	secrets-manager-variables.ts	86.95	100	100	86.95	28,50-55
🟢	validate-secret.ts	100	100	100	100
🟢	proxy/v4	92.3	64.28	90	92
🟢	downloadAgent.ts	96.15	57.14	100	96	39
🟢	handlers.ts	86.95	71.42	75	86.36	29,55-56
🟢	paths.ts	100	100	100	100

[github-actions]

This PR will create a minor release 🚀

2.2.0 (2026-01-07)

Features

• add support for Agent V4 (61f8c67)
• set default GetResultPath variable to an empty string (28d0bad)