chore: sync SDK generation and public API spec

Merge the latest mainline SDK surface into the integration branch, preserve nullable object semantics across the newer absence-preserving generator rules, refresh the vendored public specification, and keep unstructured intermediary response bodies out of errors and logs.

Author: ysyneu

.github/workflows/ci.yml

@@ -25,7 +25,7 @@ jobs:
         uses: actions/checkout@v7
 
       - name: Set up Go
-        uses: actions/setup-go@v6
+        uses: actions/setup-go@v7
         with:
           go-version: ${{ matrix.go-version }}
           cache: true
@@ -47,7 +47,7 @@ jobs:
         uses: actions/checkout@v7
 
       - name: Set up Go
-        uses: actions/setup-go@v6
+        uses: actions/setup-go@v7
         with:
           go-version: 'stable'
 
@@ -68,7 +68,7 @@ jobs:
         uses: actions/checkout@v7
 
       - name: Set up Go
-        uses: actions/setup-go@v6
+        uses: actions/setup-go@v7
         with:
           go-version: 'stable'
           cache: true

.github/workflows/sync-spec.yml

@@ -23,7 +23,7 @@ jobs:
         uses: actions/checkout@v7
 
       - name: Set up Go
-        uses: actions/setup-go@v6
+        uses: actions/setup-go@v7
         with:
           go-version: 'stable'
           cache: true

README.md

@@ -4,7 +4,7 @@ The official Go client for the [Flashduty](https://flashcat.cloud) Open API —
 
 📖 **API reference:** <https://docs.flashcat.cloud/en/openapi/introduction>
 
-> **Status:** All 253 Open API endpoints across 27 services are generated from the Flashduty OpenAPI specification, covered by unit tests, and validated end-to-end against the live API.
+> **Status:** All 288 Open API operations across 32 services are generated from the Flashduty OpenAPI specification, covered by unit tests, and validated end-to-end against the live API.
 
 ## Install
 

alerts.go

@@ -8,6 +8,24 @@ import (
 	"strings"
 )
 
+// AutomationFireAPITriggerRequest is the payload accepted by an Automation
+// HTTP POST trigger.
+type AutomationFireAPITriggerRequest struct {
+	// Context text passed to this Automation run.
+	Text string `json:"text,omitempty" toon:"text,omitempty"`
+}
+
+// AutomationFireAPITriggerResponse is the result returned by an Automation
+// HTTP POST trigger.
+type AutomationFireAPITriggerResponse struct {
+	// Result type. The API-trigger success path returns routine_fire.
+	Type string `json:"type" toon:"type"`
+	// Started session ID returned by the API-trigger success path.
+	SessionID string `json:"session_id" toon:"session_id"`
+	// Console URL for the started session.
+	SessionURL string `json:"session_url" toon:"session_url"`
+}
+
 // TriggerWriteFire triggers an Automation run through its HTTP POST trigger URL.
 //
 // This endpoint authenticates with the trigger's one-time bearer token rather

analytics.go

@@ -2,49 +2,40 @@ package flashduty
 
 import (
 	"context"
-	"encoding/json"
 	"io"
 	"net/http"
 	"strings"
 	"testing"
 )
 
-func TestAutomationTriggerWriteFireUsesBearerTokenAndDecodesAccepted(t *testing.T) {
+func TestAutomationTriggerWriteFireUsesBearerToken(t *testing.T) {
 	c := newTestClient(t, func(w http.ResponseWriter, r *http.Request) {
 		if r.URL.Path != "/safari/automation/triggers/trig_abc/fire" {
 			t.Errorf("path = %s", r.URL.Path)
 		}
 		if got := r.URL.Query().Get("app_key"); got != "" {
-			t.Errorf("app_key must not be sent for trigger fire, got %q", got)
+			t.Errorf("app_key must not be sent, got %q", got)
 		}
 		if got := r.Header.Get("Authorization"); got != "Bearer tok_secret" {
 			t.Errorf("Authorization = %q", got)
 		}
-		if got := r.Header.Get("Content-Type"); got != "application/json" {
-			t.Errorf("Content-Type = %q", got)
-		}
 		body, _ := io.ReadAll(r.Body)
-		if !strings.Contains(string(body), `"text":"deployment finished"`) ||
-			!strings.Contains(string(body), `"dedup_key":"deploy-1"`) {
+		if !strings.Contains(string(body), `"text":"deployment finished"`) {
 			t.Errorf("body = %s", body)
 		}
-
 		w.Header().Set("Flashcat-Request-Id", "RIDF")
-		w.WriteHeader(http.StatusAccepted)
-		_, _ = io.WriteString(w, `{"request_id":"RIDF","data":{"run_id":"taskrun_1","rule_id":"auto_1","trigger_kind":"http_post","status":"running"}}`)
+		w.WriteHeader(http.StatusOK)
+		_, _ = io.WriteString(w, `{"request_id":"RIDF","data":{"type":"routine_fire","session_id":"sess_1","session_url":"/safari/session/sess_1"}}`)
 	})
 
-	out, resp, err := c.Automations.TriggerWriteFire(context.Background(), "trig_abc", "tok_secret", &AutomationFireAPITriggerRequest{
-		Text:     "deployment finished",
-		DedupKey: "deploy-1",
-	})
+	out, resp, err := c.Automations.TriggerWriteFire(context.Background(), "trig_abc", "tok_secret", &AutomationFireAPITriggerRequest{Text: "deployment finished"})
 	if err != nil {
 		t.Fatalf("TriggerWriteFire error: %v", err)
 	}
-	if resp == nil || resp.StatusCode != http.StatusAccepted || resp.RequestID != "RIDF" {
+	if resp == nil || resp.StatusCode != http.StatusOK || resp.RequestID != "RIDF" {
 		t.Fatalf("response meta = %+v", resp)
 	}
-	if out == nil || out.RunID != "taskrun_1" || out.RuleID != "auto_1" || out.TriggerKind != "http_post" || out.Status != "running" {
+	if out == nil || out.Type != "routine_fire" || out.SessionID != "sess_1" || out.SessionURL != "/safari/session/sess_1" {
 		t.Fatalf("decoded response = %+v", out)
 	}
 }
@@ -61,34 +52,3 @@ func TestAutomationTriggerWriteFireValidatesInputs(t *testing.T) {
 		t.Fatal("expected empty token error")
 	}
 }
-
-func TestAutomationRuleUpdateRequestCanSendFalseValues(t *testing.T) {
-	payload, err := json.Marshal(&AutomationRuleUpdateRequest{
-		RuleID:                     "auto_1",
-		Enabled:                    Bool(false),
-		ScheduleTriggerEnabled:     Bool(false),
-		HTTPPostTriggerEnabled:     Bool(false),
-		RotateHTTPPostTriggerToken: false,
-		TeamID:                     Int64(0),
-		EnvironmentID:              String(""),
-	})
-	if err != nil {
-		t.Fatal(err)
-	}
-	got := string(payload)
-	for _, want := range []string{
-		`"rule_id":"auto_1"`,
-		`"enabled":false`,
-		`"schedule_trigger_enabled":false`,
-		`"http_post_trigger_enabled":false`,
-		`"team_id":0`,
-		`"environment_id":""`,
-	} {
-		if !strings.Contains(got, want) {
-			t.Fatalf("payload %s missing %s", got, want)
-		}
-	}
-	if strings.Contains(got, "rotate_http_post_trigger_token") {
-		t.Fatalf("zero rotate flag should stay omitted: %s", got)
-	}
-}

automations.go

@@ -26,4 +26,10 @@ type AutomationRuleUpdateRequest struct {
 	HTTPPostTriggerEnabled *bool `json:"http_post_trigger_enabled,omitempty" toon:"http_post_trigger_enabled,omitempty"`
 	// Whether to rotate the HTTP POST trigger token. The new token is returned only in this response.
 	RotateHTTPPostTriggerToken bool `json:"rotate_http_post_trigger_token,omitempty" toon:"rotate_http_post_trigger_token,omitempty"`
+	// Whether the on-call incident trigger is enabled. Sending true creates it when missing and channel/severity filters are provided.
+	OncallIncidentTriggerEnabled *bool `json:"oncall_incident_trigger_enabled,omitempty" toon:"oncall_incident_trigger_enabled,omitempty"`
+	// On-call channel IDs whose new incidents can trigger this rule.
+	OncallIncidentChannelIDs *[]int64 `json:"oncall_incident_channel_ids,omitempty" toon:"oncall_incident_channel_ids,omitempty"`
+	// Incident severities that can trigger this rule.
+	OncallIncidentSeverities *[]string `json:"oncall_incident_severities,omitempty" toon:"oncall_incident_severities,omitempty"`
 }