flowstate-dojo-community-epicdm-flowstate-tunnel-worker

Use this skill when a task touches packages/flowstate-tunnel-worker, imports @epicdm/flowstate-tunnel-worker, or needs to teach humans/agents how this package works.

Package identity:

• Package: @epicdm/flowstate-tunnel-worker
• Repository: epic-flowstate-community
• Version authority: package.json (0.1.0)
• Dojo course: flowstate-dojo-community-epicdm-flowstate-tunnel-worker

How to use the package:

• Purpose: Cloudflare Worker control plane for FlowState Tunnel Service
• Start with package-local docs when present.
• Verify details against source and tests before changing behavior.
• Use the Dojo course lessons as the teaching path: setup, mental model, core workflow, integration, feature labs, maintenance.

Public surfaces discovered:

• handleHeartbeat
• handleProvision
• handleRegister
• handleStatus
• handleTeardown
• validateApiKey
• validateProvisionSecret
• createTunnel
• configureTunnelIngress
• getTunnelStatus
• deleteTunnel
• createDnsRecord
• deleteDnsRecord
• getOrgRecord
• setOrgRecord
• deleteOrgRecord
• getSlugOwner
• setSlugOwner
• deleteSlugOwner
• updateLastSeen
• handleScheduled

Composable feature skilllets:

• Configure Tunnel Ingress: use feature labs for workflow, source anchor, and regression risk.
• Create Dns Record: use feature labs for workflow, source anchor, and regression risk.
• Create Tunnel: use feature labs for workflow, source anchor, and regression risk.
• Delete Dns Record: use feature labs for workflow, source anchor, and regression risk.
• Delete Org Record: use feature labs for workflow, source anchor, and regression risk.
• Delete Slug Owner: use feature labs for workflow, source anchor, and regression risk.
• Delete Tunnel: use feature labs for workflow, source anchor, and regression risk.
• GET /health: use feature labs for workflow, source anchor, and regression risk.
• GET /tunnel/status: use feature labs for workflow, source anchor, and regression risk.
• Get Org Record: use feature labs for workflow, source anchor, and regression risk.
• Get Slug Owner: use feature labs for workflow, source anchor, and regression risk.
• Get Tunnel Status: use feature labs for workflow, source anchor, and regression risk.
• Handle Heartbeat: use feature labs for workflow, source anchor, and regression risk.
• Handle Provision: use feature labs for workflow, source anchor, and regression risk.
• Handle Register: use feature labs for workflow, source anchor, and regression risk.
• Handle Scheduled: use feature labs for workflow, source anchor, and regression risk.
• Handle Status: use feature labs for workflow, source anchor, and regression risk.
• Handle Teardown: use feature labs for workflow, source anchor, and regression risk.
• POST /tunnel/heartbeat: use feature labs for workflow, source anchor, and regression risk.
• POST /tunnel/provision: use feature labs for workflow, source anchor, and regression risk.
• POST /tunnel/register: use feature labs for workflow, source anchor, and regression risk.
• POST /tunnel/teardown: use feature labs for workflow, source anchor, and regression risk.
• Set Org Record: use feature labs for workflow, source anchor, and regression risk.
• Set Slug Owner: use feature labs for workflow, source anchor, and regression risk.
• Update Last Seen: use feature labs for workflow, source anchor, and regression risk.
• Validate Api Key: use feature labs for workflow, source anchor, and regression risk.
• Validate Provision Secret: use feature labs for workflow, source anchor, and regression risk.
• wrangler.toml manifest: use feature labs for workflow, source anchor, and regression risk.

Agent operating rules:

• Treat package.json as the Dojo version authority.
• Do not turn feature inventory into user-facing lessons without workflow context.
• Update this Dojo package when package behavior, docs, examples, or feature inventory changes.
• Verify downstream packages when package use and connection metadata shows inbound dependencies or references.
• Never mark publish status passed without successful cloud publish and catalog lookup.

Use this Dojo skill with package human docs, package-local feature inventory, agent-skillset.md, and the generated course.json in this folder. Keep this manifest version aligned with package.json.