Tools & MCP Platform — events¶

Generated from the architecture model

This page is rendered from model/**/*.yaml by tools/docs_model during mkdocs build. Edit the YAML, not this page; hand-written design lives on the linked service, platform and plane pages.

Topics follow context.area.vN.event-name (ADR-0012 port, ADR-0014 envelope). The context segment is the producing bounded context's slug.

Event	Producer	Topic	Scope	Consumers
McpServerRegistered	McpServerRegistryService	`tool-execution.mcp-servers.v1.mcp-server-registered`	integration	2
McpServerStateChanged	McpServerRegistryService	`tool-execution.mcp-servers.v1.mcp-server-state-changed`	integration	4
McpCapabilitiesDiscovered	McpServerRegistryService	`tool-execution.mcp-servers.v1.mcp-capabilities-discovered`	integration	2
ToolDescriptorActivated	ToolAdapterService	`tool-execution.descriptors.v1.tool-descriptor-activated`	integration	3
ToolDescriptorRetired	ToolAdapterService	`tool-execution.descriptors.v1.tool-descriptor-retired`	integration	2
ToolInvoked	ToolAdapterService	`tool-execution.invocations.v1.tool-invoked`	integration	5
ToolInvocationDenied	ToolAdapterService	`tool-execution.invocations.v1.tool-invocation-denied`	integration	3
ToolEffectUncertain	ToolAdapterService	`tool-execution.invocations.v1.tool-effect-uncertain`	integration	6
SandboxLeased	ToolAdapterService	`tool-execution.sandboxes.v1.sandbox-leased`	integration	1
SandboxReleased	ToolAdapterService	`tool-execution.sandboxes.v1.sandbox-released`	integration	3

McpServerRegistered¶

A server was registered.


Producer	McpServerRegistryService (BC-08 Tool Execution)
Scope / version	integration / v1
Topic	`tool-execution.mcp-servers.v1.mcp-server-registered`
Aggregate	McpServer
Consumers	`StudioBff`, `AuditService`

Field	Type	Required
`serverId`	`string`	yes
`tenantId`	`string`	yes
`direction`	`enum:McpDirection`	yes
`transport`	`enum:McpTransport`	yes
`authentication`	`enum:McpAuthentication`	yes

McpServerStateChanged¶

Verified, active, degraded or retired.


Producer	McpServerRegistryService (BC-08 Tool Execution)
Scope / version	integration / v1
Topic	`tool-execution.mcp-servers.v1.mcp-server-state-changed`
Aggregate	McpServer
Consumers	`ToolAdapterService`, `StudioBff`, `DashboardService`, `AuditService`

Field	Type	Required
`serverId`	`string`	yes
`tenantId`	`string`	yes
`fromState`	`enum:McpServerState`	yes
`toState`	`enum:McpServerState`	yes

McpCapabilitiesDiscovered¶

Tools, resources and prompts were discovered and bindings refreshed.


Producer	McpServerRegistryService (BC-08 Tool Execution)
Scope / version	integration / v1
Topic	`tool-execution.mcp-servers.v1.mcp-capabilities-discovered`
Aggregate	McpServer
Consumers	`StudioBff`, `DashboardService`

Field	Type	Required
`serverId`	`string`	yes
`tenantId`	`string`	yes
`tools`	`int`	yes
`resources`	`int`	yes
`prompts`	`int`	yes
`unbound`	`int`	yes

ToolDescriptorActivated¶

A Published tool version is callable.


Producer	ToolAdapterService (BC-08 Tool Execution)
Scope / version	integration / v1
Topic	`tool-execution.descriptors.v1.tool-descriptor-activated`
Aggregate	ToolDescriptor
Consumers	`StudioBff`, `DashboardService`, `AuditService`

Field	Type	Required
`toolId`	`string`	yes
`version`	`string`	yes
`tenantId`	`string`	yes
`sideEffectClass`	`string`	yes
`kind`	`enum:ToolKind`	yes

ToolDescriptorRetired¶

A tool version is no longer callable.


Producer	ToolAdapterService (BC-08 Tool Execution)
Scope / version	integration / v1
Topic	`tool-execution.descriptors.v1.tool-descriptor-retired`
Aggregate	ToolDescriptor
Consumers	`StudioBff`, `AuditService`

Field	Type	Required
`toolId`	`string`	yes
`version`	`string`	yes
`tenantId`	`string`	yes
`reason`	`string`	yes

ToolInvoked¶

A receipt was written (observed, failed or cancelled).


Producer	ToolAdapterService (BC-08 Tool Execution)
Scope / version	integration / v1
Topic	`tool-execution.invocations.v1.tool-invoked`
Aggregate	ToolInvocation
Consumers	`CostUsageService`, `AuditService`, `DashboardService`, `QualityScoreService`, `AgentTelemetryService`

Field	Type	Required
`invocationId`	`guid`	yes
`tenantId`	`string`	yes
`projectId`	`string`	yes
`runId`	`guid`	no
`attemptId`	`guid`	no
`toolId`	`string`	yes
`toolVersion`	`string`	yes
`effectiveClass`	`string`	yes
`state`	`enum:InvocationState`	yes
`policyDecisionId`	`guid`	no
`approvalId`	`guid`	no
`requestHash`	`hash`	yes
`resultHash`	`hash`	no

ToolInvocationDenied¶

Denied by schema, permission, policy, block-list or approval outcome.


Producer	ToolAdapterService (BC-08 Tool Execution)
Scope / version	integration / v1
Topic	`tool-execution.invocations.v1.tool-invocation-denied`
Aggregate	ToolInvocation
Consumers	`AuditService`, `DashboardService`, `StudioBff`

Field	Type	Required
`invocationId`	`guid`	yes
`tenantId`	`string`	yes
`toolId`	`string`	yes
`reason`	`string`	yes
`stage`	`string`	yes

ToolEffectUncertain¶

An effect may have happened and could not be confirmed; an operator must confirm before any retry.


Producer	ToolAdapterService (BC-08 Tool Execution)
Scope / version	integration / v1
Topic	`tool-execution.invocations.v1.tool-effect-uncertain`
Aggregate	ToolInvocation
Consumers	`AlertRuleService`, `AgentRuntimeService`, `StudioBff`, `StudioNotificationService`, `AuditService`, `DashboardService`

Field	Type	Required
`invocationId`	`guid`	yes
`tenantId`	`string`	yes
`runId`	`guid`	no
`attemptId`	`guid`	no
`toolId`	`string`	yes
`effectiveClass`	`string`	yes

SandboxLeased¶

A sandbox and workspace were leased for an invocation.


Producer	ToolAdapterService (BC-08 Tool Execution)
Scope / version	integration / v1
Topic	`tool-execution.sandboxes.v1.sandbox-leased`
Aggregate	ToolInvocation
Consumers	`DashboardService`

Field	Type	Required
`leaseId`	`guid`	yes
`invocationId`	`guid`	yes
`tenantId`	`string`	yes
`kind`	`enum:SandboxKind`	yes
`poolId`	`string`	yes

SandboxReleased¶

A sandbox was released or reaped.


Producer	ToolAdapterService (BC-08 Tool Execution)
Scope / version	integration / v1
Topic	`tool-execution.sandboxes.v1.sandbox-released`
Aggregate	ToolInvocation
Consumers	`ExecutionCapacityService`, `SecretBrokerService`, `DashboardService`

Field	Type	Required
`leaseId`	`guid`	yes
`tenantId`	`string`	yes
`reason`	`string`	yes

Commands¶

Command	Service	Handled by	Result events
`RegisterMcpServer`	McpServerRegistryService	McpServer	McpServerRegistered
`DiscoverMcpCapabilities`	McpServerRegistryService	McpServer	McpCapabilitiesDiscovered, McpServerStateChanged
`ActivateMcpServer`	McpServerRegistryService	McpServer	McpServerStateChanged
`Invoke`	ToolAdapterService	ToolInvocation	ToolInvoked, ToolInvocationDenied, ToolEffectUncertain
`Interrupt`	ToolAdapterService	ToolInvocation	ToolInvoked, ToolEffectUncertain
`ConfirmToolEffect`	ToolAdapterService	ToolInvocation	ToolInvoked

Consumed from other services¶

Consumer	Event	Producer	Handler	Purpose
McpServerRegistryService	AssetReleasePublished	AgentRegistryService	`RegisterPublishedServer`	Register and verify MCP servers published as Factory assets.
McpServerRegistryService	AssetReleaseRevoked	AgentRegistryService	`RetirePublishedServer`	Retire revoked server assets.
ToolAdapterService	AssetReleasePublished	AgentRegistryService	`ActivateDescriptors`	Project Published tool assets into active descriptors.
ToolAdapterService	AssetReleaseDeprecated	AgentRegistryService	`RetireDescriptors`	Retire descriptors per in-flight policy.
ToolAdapterService	AssetReleaseRevoked	AgentRegistryService	`RetireDescriptors`	Retire revoked descriptors immediately.
ToolAdapterService	EnvironmentStateChanged	EnvironmentService	`ApplyFreeze`	Refuse shared-write and production calls targeting a Frozen environment.
ToolAdapterService	McpServerStateChanged	McpServerRegistryService	`UpdateServerHealth`	Mark descriptors of a degraded or retired server unhealthy.