init relay

Author: jsbroks

.github/workflows/test.yml

@@ -0,0 +1,25 @@
+name: Test
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Go
+        uses: actions/setup-go@v5
+        with:
+          go-version: "1.25"
+
+      - name: Download dependencies
+        run: go mod download
+
+      - name: Run tests
+        run: go test -v ./...

.gitignore

@@ -0,0 +1,24 @@
+# Binaries
+bin/
+*.exe
+*.exe~
+*.dll
+*.so
+*.dylib
+
+# Test binary, built with `go test -c`
+*.test
+
+# Output of the go coverage tool
+*.out
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+

README.md

@@ -0,0 +1,37 @@
+package relay
+
+import (
+	"slices"
+	"time"
+)
+
+// -----------------------------------------------------------------------------
+// Agent Domain Types
+// -----------------------------------------------------------------------------
+
+// AgentInfo contains metadata about a connected agent.
+// This is used for agent discovery, selection, and monitoring.
+type AgentInfo struct {
+	// ID is the unique identifier for this agent.
+	ID AgentID `json:"id"`
+
+	// Capabilities lists what this agent can do (pty, tunnels, k8s, etc.).
+	Capabilities []Capability `json:"capabilities"`
+
+	// ConnectedAt is when this agent established its connection.
+	ConnectedAt time.Time `json:"connected_at"`
+
+	// LastHeartbeat is the timestamp of the most recent heartbeat.
+	LastHeartbeat time.Time `json:"last_heartbeat"`
+
+	// Version is the agent software version (for compatibility checks).
+	Version string `json:"version,omitempty"`
+
+	// Hostname is the agent's hostname (informational).
+	Hostname string `json:"hostname,omitempty"`
+}
+
+// HasCapability checks if the agent has a specific capability.
+func (a *AgentInfo) HasCapability(cap Capability) bool {
+	return slices.Contains(a.Capabilities, cap)
+}