SimpleFlow Templates

Starter templates for remote runtimes that integrate with the SimpleFlow control plane.

Environment samples

Each template includes a checked-in .env.example file:

• frontend-vue-shell/.env.example
• remote-runtime/go/.env.example
• remote-runtime/python/.env.example

Use these as a starting point and copy to .env before running locally.

Contents

• remote-runtime/go: Go runtime template.
• remote-runtime/python: Python runtime template.
• frontend-vue-shell: Chat-first Vue shell that requires control-plane auth and active registration.

Template Contract

Runtime templates should expose:

• GET /health
• GET /meta
• POST /invoke

Optional capability endpoints may include queue and webhook handlers.

Frontend mode

frontend-vue-shell is control-plane required through the template backend gateway:

• sign-in via POST /api/control-plane/sign-in
• agent catalog via GET /api/agents/available
• onboarding orchestration via POST /api/onboarding/start, GET /api/onboarding/status, POST /api/onboarding/retry
• invoke path fixed to POST /api/control-plane/chat/invoke
• chat session history load/save via GET/POST /api/control-plane/chat/messages

The chat composer remains disabled when:

• user session is missing/unauthorized
• onboarding is not active for selected catalog agent

Docker/network note

In containerized setups, set runtime endpoint_url values to a routable hostname from the control-plane network namespace (for example service DNS in Compose/Kubernetes) rather than localhost.