Expose createDevice on MCP, CLI, and n8n

Device create was left off the ITAM surfaces because enrollment
returns a one-shot token. Add createDevice so automations can issue
PENDING devices with the enrollment payload.

Signed-off-by: Ludovic Vielle <ludovic@probo.com>

pkg/itam/enrollment_url.go

@@ -0,0 +1,66 @@
+// Copyright (c) 2026 Probo Inc <hello@probo.com>.
+//
+// Permission is hereby granted, free of charge, to any person obtaining a copy
+// of this software and associated documentation files (the "Software"), to deal
+// in the Software without restriction, including without limitation the rights
+// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+// copies of the Software, and to permit persons to whom the Software is
+// furnished to do so, subject to the following conditions:
+//
+// The above copyright notice and this permission notice shall be included in
+// all copies or substantial portions of the Software.
+//
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+// SOFTWARE.
+
+package itam
+
+import (
+	"fmt"
+	"net/url"
+
+	"go.probo.inc/probo/pkg/baseurl"
+)
+
+// EnrollmentURLs holds the public API origin and probo:// deep link issued
+// when a device enrollment token is created.
+type EnrollmentURLs struct {
+	ServerURL     string
+	EnrollmentURL string
+}
+
+// BuildEnrollmentURLs derives the agent server origin and deep link from the
+// deployment base URL and a one-shot enrollment token.
+func BuildEnrollmentURLs(baseURL *baseurl.BaseURL, enrollmentToken string) (EnrollmentURLs, error) {
+	if baseURL == nil {
+		return EnrollmentURLs{}, fmt.Errorf("base URL is required")
+	}
+
+	if enrollmentToken == "" {
+		return EnrollmentURLs{}, fmt.Errorf("enrollment token is required")
+	}
+
+	serverURL := (&url.URL{
+		Scheme: baseURL.Scheme(),
+		Host:   baseURL.Host(),
+	}).String()
+
+	enrollURL := &url.URL{
+		Scheme: "probo",
+		Host:   "enroll",
+	}
+	query := enrollURL.Query()
+	query.Set("server", serverURL)
+	query.Set("token", enrollmentToken)
+	enrollURL.RawQuery = query.Encode()
+
+	return EnrollmentURLs{
+		ServerURL:     serverURL,
+		EnrollmentURL: enrollURL.String(),
+	}, nil
+}

pkg/itam/enrollment_url_test.go

@@ -0,0 +1,99 @@
+// Copyright (c) 2026 Probo Inc <hello@probo.com>.
+//
+// Permission is hereby granted, free of charge, to any person obtaining a copy
+// of this software and associated documentation files (the "Software"), to deal
+// in the Software without restriction, including without limitation the rights
+// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+// copies of the Software, and to permit persons to whom the Software is
+// furnished to do so, subject to the following conditions:
+//
+// The above copyright notice and this permission notice shall be included in
+// all copies or substantial portions of the Software.
+//
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+// SOFTWARE.
+
+package itam_test
+
+import (
+	"net/url"
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
+	"go.probo.inc/probo/pkg/baseurl"
+	"go.probo.inc/probo/pkg/itam"
+)
+
+func TestBuildEnrollmentURLs(t *testing.T) {
+	t.Parallel()
+
+	tests := []struct {
+		name            string
+		baseURL         string
+		token           string
+		wantServerURL   string
+		wantErrContains string
+	}{
+		{
+			name:          "strips path from base URL",
+			baseURL:       "https://us.probo.com/console",
+			token:         "secret-token",
+			wantServerURL: "https://us.probo.com",
+		},
+		{
+			name:          "keeps non-default port",
+			baseURL:       "http://127.0.0.1:8080/api",
+			token:         "tok",
+			wantServerURL: "http://127.0.0.1:8080",
+		},
+		{
+			name:            "nil base URL",
+			token:           "tok",
+			wantErrContains: "base URL is required",
+		},
+		{
+			name:            "empty token",
+			baseURL:         "https://us.probo.com",
+			wantErrContains: "enrollment token is required",
+		},
+	}
+
+	for _, tt := range tests {
+		t.Run(tt.name, func(t *testing.T) {
+			t.Parallel()
+
+			var base *baseurl.BaseURL
+
+			if tt.baseURL != "" {
+				parsed, err := baseurl.Parse(tt.baseURL)
+				require.NoError(t, err)
+
+				base = parsed
+			}
+
+			got, err := itam.BuildEnrollmentURLs(base, tt.token)
+			if tt.wantErrContains != "" {
+				require.Error(t, err)
+				assert.ErrorContains(t, err, tt.wantErrContains)
+
+				return
+			}
+
+			require.NoError(t, err)
+			assert.Equal(t, tt.wantServerURL, got.ServerURL)
+
+			parsed, err := url.Parse(got.EnrollmentURL)
+			require.NoError(t, err)
+			assert.Equal(t, "probo", parsed.Scheme)
+			assert.Equal(t, "enroll", parsed.Host)
+			assert.Equal(t, tt.wantServerURL, parsed.Query().Get("server"))
+			assert.Equal(t, tt.token, parsed.Query().Get("token"))
+		})
+	}
+}