CRE: Add support for user emitted wf metrics

[karen-stepanyan]

https://smartcontract-it.atlassian.net/browse/DF-23780

[github-actions]

⚠️ API Diff Results - github.com/smartcontractkit/chainlink-common

⚠️ Breaking Changes (1)

pkg/workflows/wasm/host.ExecutionHelper (1)

• EmitUserMetric — ➕ Added

✅ Compatible Changes (14)

pkg/settings/cresettings.Workflows (5)

• UserMetricEnabled — ➕ Added

• UserMetricLabelsPerMetric — ➕ Added

• UserMetricLabelValueLength — ➕ Added

• UserMetricNameLengthLimit — ➕ Added

• UserMetricPayloadLimit — ➕ Added

pkg/workflows/wasm/host.ModuleConfig (9)

• EnableUserMetrics — ➕ Added

• MaxUserMetricLabelsPerMetric — ➕ Added

• MaxUserMetricLabelsPerMetricLimiter — ➕ Added

• MaxUserMetricLabelValueLength — ➕ Added

• MaxUserMetricLabelValueLengthLimiter — ➕ Added

• MaxUserMetricNameLength — ➕ Added

• MaxUserMetricNameLengthLimiter — ➕ Added

• MaxUserMetricPayloadBytes — ➕ Added

• MaxUserMetricPayloadLimiter — ➕ Added

---

📄 View full apidiff report

[bolekk]

Shouldn't we return a better error code? cc @nolag

[Copilot]

Pull request overview

Adds initial support for user-emitted workflow metrics from WASM (NoDAG) modules, including host-side validation/limits, test coverage, and CRE settings schema/default updates.

Changes:

• Link a new WASM host import (env.emit_metric) and implement host-side decoding + limit enforcement for user metrics.
• Extend host execution plumbing (config + ExecutionHelper) and add NoDAG tests plus a new WASM test module for metrics.
• Add new CRE settings fields and defaults for metric enablement and metric limits (payload/name/labels).

Reviewed changes

Copilot reviewed 11 out of 12 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
pkg/workflows/wasm/host/wasm_nodag_test.go	Adds NoDAG tests for metric emission limits and the disabled behavior.
pkg/workflows/wasm/host/test/metric_limits/cmd/main_wasip1.go	Adds a WASI test module that emits several user metrics for limit testing.
pkg/workflows/wasm/host/module.go	Adds metric-related config/limiters, extends ExecutionHelper, and links the new emit_metric import.
pkg/workflows/wasm/host/mock_execution_helper_test.go	Updates generated mock to include EmitUserMetric.
pkg/workflows/wasm/host/internal/rawsdk/helpers_wasip1.go	Adds the raw WASM import declaration for emit_metric.
pkg/workflows/wasm/host/execution.go	Implements emitMetric handler (proto decode + limit checks + forwarding).
pkg/settings/cresettings/settings.go	Adds metric settings to the schema/types.
pkg/settings/cresettings/defaults.toml	Adds default values for metric settings.
pkg/settings/cresettings/defaults.json	Adds default values for metric settings.
pkg/settings/cresettings/README.md	Documents metric settings in the limits diagram.
go.mod	Bumps workflows protos dependency to a version that includes metric protos.
go.sum	Updates checksums for the bumped workflows protos dependency.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

ExecutionHelper is an exported interface in a public module (chainlink-common). Adding EmitUserMetric makes this a breaking API change for any downstream implementers. Consider introducing a separate optional interface (e.g., type UserMetricEmitter interface { EmitUserMetric(*wfpb.WorkflowUserMetric) error }) and using a type assertion at call sites, or providing a new wrapper type, to keep backward compatibility.

Suggested change

	EmitUserLog(log string) error
	EmitUserLog(log string) error
	}
	// UserMetricEmitter can be implemented optionally to support emitting user metrics.
	type UserMetricEmitter interface {

[jmank88]

Is there a core PR that uses these?

[karen-stepanyan]

@jmank88 here is the change in core repo
smartcontractkit/chainlink#21817
I used replace reference to this PR. If it looks ok, I can merge this first and rebase the core PR. We have breaking change in this PR so I want to avoid delaying core changes merge