feat!: add agent context provider

[TimoGlastra]

• Dependant on refactor!: add agent context #881 (until that one is merged this is kinda hard to review)
• Design: https://hackmd.io/vGLVlxLvQR6jsEEjzNcL8g#Agent-Context-Provider

Adds an AgentContextProvider with default DefaultAgentContextProvider implementation that always returns the same agent context (for a single tenant agent).

This allows the tenant module (will be added as a separate module) to implement its own TenantAgentContextProvider that will find provide the agent context for a specific tenant. This allows to keep the core lean, while providing more advanced usages of providing the agent context.

I added a contextCorrelationId to the AgentContext interface. For now this is not really needed, but this will become really useful when we add tenants. The contextCorrelationId allows to correlate the context with an identifier to make it easier to provide the context for an incoming message. By default we find the tenant based on the recipient public keys of a message, but there's numerous cases where we are processing plaintext messages. By providing the contextCorrelationId we can use this in the AgentContextProvider to correlate the message to a specific context. In the case of the TenantContextProvider the contextCorrelationId will be the tenantId.

BREAKING CHANGE: the agent.receiveMessage method should only be used if you want to process the message in the context of the current agent. This means it fine to use for e.g. processing plaintext connection-less messages, but it shouldn't be used anymore by outbound and inbound transports to process messages. Instead, inject the MessageReceiver class and call receiveMessage on that class instead.

[codecov-commenter]

Codecov Report

Merging #898 (49c4d55) into main (6d88aa4) will increase coverage by 0.15%.
The diff coverage is 87.93%.

@@            Coverage Diff             @@
##             main     #898      +/-   ##
==========================================
+ Coverage   87.70%   87.86%   +0.15%     
==========================================
  Files         475      480       +5     
  Lines       11339    11436      +97     
  Branches     1874     1909      +35     
==========================================
+ Hits         9945    10048     +103     
+ Misses       1327     1322       -5     
+ Partials       67       66       -1     

Impacted Files	Coverage Δ
packages/core/src/agent/AgentConfig.ts	90.16% <ø> (-0.47%)	⬇️
packages/core/src/agent/Events.ts	100.00% <ø> (ø)
packages/core/src/constants.ts	100.00% <ø> (ø)
...les/credentials/formats/CredentialFormatService.ts	100.00% <ø> (ø)
...cation/handlers/V1RevocationNotificationHandler.ts	71.42% <ø> (ø)
...cation/handlers/V2RevocationNotificationHandler.ts	71.42% <ø> (ø)
...ges/core/src/modules/credentials/services/index.ts	100.00% <ø> (ø)
...ore/src/modules/dids/methods/web/WebDidResolver.ts	60.00% <ø> (ø)
...c/modules/routing/handlers/MediationDenyHandler.ts	62.50% <0.00%> (+6.94%)	⬆️
packages/core/src/transport/WsOutboundTransport.ts	9.23% <0.00%> (-2.37%)	⬇️
... and 99 more

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 6d88aa4...49c4d55. Read the comment docs.

[TimoGlastra]

Superseded by #921