feat: version ai result schemas

internal/transcription/client.go

@@ -60,15 +60,18 @@ type Segment struct {
 	Speaker string  `json:"speaker,omitempty"`
 }
 
+const ResultSchemaVersion = "ai.transcription_result.v1"
+
 type Result struct {
-	Provider     string    `json:"provider,omitempty"`
-	Model        string    `json:"model,omitempty"`
-	Attempts     []Attempt `json:"attempts,omitempty"`
-	Language     string    `json:"language"`
-	Segments     []Segment `json:"segments"`
-	DiarizeError *string   `json:"diarize_error,omitempty"`
-	AlignError   *string   `json:"align_error,omitempty"`
-	DurationMS   int64     `json:"duration_ms"`
+	SchemaVersion string    `json:"schema_version"`
+	Provider      string    `json:"provider,omitempty"`
+	Model         string    `json:"model,omitempty"`
+	Attempts      []Attempt `json:"attempts,omitempty"`
+	Language      string    `json:"language"`
+	Segments      []Segment `json:"segments"`
+	DiarizeError  *string   `json:"diarize_error,omitempty"`
+	AlignError    *string   `json:"align_error,omitempty"`
+	DurationMS    int64     `json:"duration_ms"`
 }
 
 type Attempt struct {
@@ -199,11 +202,12 @@ func (c *Client) transcribeWithProvider(ctx context.Context, provider ProviderCo
 	attempt.Text = text
 	attempt.Segments = segments
 	return &Result{
-		Provider:   provider.Name,
-		Model:      resp.Model,
-		Language:   firstNonEmpty(resp.Language, in.Language, "unknown"),
-		Segments:   segments,
-		DurationMS: duration.Milliseconds(),
+		SchemaVersion: ResultSchemaVersion,
+		Provider:      provider.Name,
+		Model:         resp.Model,
+		Language:      firstNonEmpty(resp.Language, in.Language, "unknown"),
+		Segments:      segments,
+		DurationMS:    duration.Milliseconds(),
 	}, attempt, nil
 }
 

internal/transcription/client_test.go

@@ -84,6 +84,9 @@ func TestWhisperUsesAudioTranscriptionsEndpoint(t *testing.T) {
 	if len(got.Segments) != 2 || got.Segments[0].Text != "Алло, тест." || got.Segments[1].Start != 1.2 {
 		t.Fatalf("segments = %#v", got.Segments)
 	}
+	if got.SchemaVersion != ResultSchemaVersion {
+		t.Fatalf("schema_version = %q, want %q", got.SchemaVersion, ResultSchemaVersion)
+	}
 }
 
 func TestWhisperFallsBackToJSONWhenVerboseJSONUnsupported(t *testing.T) {