Skip to content

Example Echo (Go)

Responsibility

Demo capability provider written in Go. Shows how to expose custom Go logic to workflows via the capability registry — no orchestrator code changes.

Capability:

  • example.echo.go — echo a message string back as JSON

Architecture

This is a capability provider (see Deploy integration contract):

  • Registers with capability-registry at startup
  • Heartbeats on the lease
  • Orchestrator discovers endpoints dynamically
  • No EGRESS_*_URL env var on orchestrator

Connection Model

None. This demo has no credentials and does not register a workflow_connection capability. Demo workflows call it with service_call without a connection: field. Do not ship a flows/connections/ stub — empty documents would show up in the Connections screen.

Example Workflow

  • Workflow: flows/workflows/example_echo_go_demo.yaml
  • HTTP trigger: POST /v1/api/examples/echo-go
  • Step fields (first-class): message

Starter pattern: Add a Capability Provider.

Deploy

  • Image: meshflows/example-echo-go
  • Deployment: example-echo-go
  • Service path: engine/services/example-echo-go/

Health

  • GET /healthz
  • GET /readyz
  • GET /internal/capabilities