Add WordPressIntelligence module and enable locale support

Author: kean

Modules/Sources/WordPressIntelligence/IntelligenceService.swift

@@ -1,11 +1,7 @@
 import Foundation
 import FoundationModels
 
-/// Service for AI-powered content generation and analysis features.
-///
-/// This service provides tag suggestions, post summaries, excerpt generation,
-/// and other intelligence features using Foundation Models (iOS 26+).
-public actor IntelligenceService {
+public enum IntelligenceService {
     /// Maximum context size for language model sessions (in tokens).
     ///
     /// A single token corresponds to three or four characters in languages like
@@ -36,33 +32,21 @@ public actor IntelligenceService {
         }
     }
 
-    public init() {}
-
-    // MARK: - Public API
-
-    /// Suggests tags for a WordPress post.
-    @available(iOS 26, *)
-    public func suggestTags(post: String, siteTags: [String] = [], postTags: [String] = []) async throws -> [String] {
-        try await TagSuggestion().generate(post: post, siteTags: siteTags, postTags: postTags)
-    }
-
-    /// Summarizes a support ticket to a short title.
-    @available(iOS 26, *)
-    public func summarizeSupportTicket(content: String) async throws -> String {
-        try await SupportTicketSummary.execute(content: content)
-    }
-
-    /// Extracts relevant text from post content (removes HTML, limits size).
-    public nonisolated func extractRelevantText(from post: String, ratio: CGFloat = 0.6) -> String {
-        Self.extractRelevantText(from: post, ratio: ratio)
-    }
-
-    // MARK: - Shared Utilities
-
     /// Extracts relevant text from post content, removing HTML and limiting size.
-    public nonisolated static func extractRelevantText(from post: String, ratio: CGFloat = 0.6) -> String {
+    static func extractRelevantText(from post: String, ratio: CGFloat = 0.6) -> String {
         let extract = try? ContentExtractor.extractRelevantText(from: post)
         let postSizeLimit = Double(IntelligenceService.contextSizeLimit) * ratio
         return String((extract ?? post).prefix(Int(postSizeLimit)))
     }
+
+    // As documented in https://developer.apple.com/documentation/foundationmodels/supporting-languages-and-locales-with-foundation-models?changes=_10_5#Use-Instructions-to-set-the-locale-and-language
+    static func makeLocaleInstructions(for locale: Locale = Locale.current) -> String {
+        if Locale.Language(identifier: "en_US").isEquivalent(to: locale.language) {
+            // Skip the locale phrase for U.S. English.
+            return ""
+        } else {
+            // Specify the person's locale with the exact phrase format.
+            return "The person's locale is \(locale.identifier)."
+        }
+    }
 }

…ligence/UseCases/ExcerptGeneration.swift …ence/UseCases/PostExcerptGenerator.swiftModules/Sources/WordPressIntelligence/UseCases/ExcerptGeneration.swift renamed to Modules/Sources/WordPressIntelligence/UseCases/PostExcerptGenerator.swift Modules/Sources/WordPressIntelligence/UseCases/ExcerptGeneration.swift renamed to Modules/Sources/WordPressIntelligence/UseCases/PostExcerptGenerator.swift

@@ -7,7 +7,7 @@ import FoundationModels
 /// length and writing style. Supports session-based usage (for UI with continuity)
 /// and one-shot generation (for tests and background tasks).
 @available(iOS 26, *)
-public struct ExcerptGeneration {
+public struct PostExcerptGenerator {
     public var length: ContentLength
     public var style: WritingStyle
     public var options: GenerationOptions
@@ -51,7 +51,7 @@ public struct ExcerptGeneration {
         - TARGET_LENGTH: MANDATORY sentence count (primary) and word count (secondary) for each excerpt
         - GENERATION_STYLE: the writing style to follow
 
-        \(PromptHelper.makeLocaleInstructions())
+        \(IntelligenceService.makeLocaleInstructions())
 
         **CRITICAL Requirements (MUST be followed exactly)**
         1. ⚠️ LANGUAGE: Generate excerpts in the SAME language as POST_CONTENT. NO translation. NO defaulting to English. Match input language EXACTLY.

…sIntelligence/UseCases/PostSummary.swift …ence/UseCases/PostSummaryGenerator.swiftModules/Sources/WordPressIntelligence/UseCases/PostSummary.swift renamed to Modules/Sources/WordPressIntelligence/UseCases/PostSummaryGenerator.swift Modules/Sources/WordPressIntelligence/UseCases/PostSummary.swift renamed to Modules/Sources/WordPressIntelligence/UseCases/PostSummaryGenerator.swift

@@ -12,7 +12,7 @@ import FoundationModels
 /// let result = try await summary.generate(content: postContent)
 /// ```
 @available(iOS 26, *)
-public struct PostSummary {
+public struct PostSummaryGenerator {
     public var options: GenerationOptions
 
     public init(options: GenerationOptions = GenerationOptions(temperature: 0.3)) {
@@ -47,7 +47,7 @@ public struct PostSummary {
         Generate a concise summary that captures the main points and key information.
         The summary should be clear, informative, and written in a neutral tone.
 
-        \(PromptHelper.makeLocaleInstructions())
+        \(IntelligenceService.makeLocaleInstructions())
 
         Do not include anything other than the summary in the response.
         """
@@ -76,6 +76,6 @@ extension IntelligenceService {
     /// - Returns: A concise summary
     /// - Throws: If summarization fails
     public func summarize(content: String) async throws -> String {
-        try await PostSummary().generate(content: content)
+        try await PostSummaryGenerator().generate(content: content)
     }
 }

Modules/Sources/WordPressIntelligence/UseCases/SupportTicketSummary.swift

@@ -0,0 +1,44 @@
+import Foundation
+import FoundationModels
+
+/// Support ticket summarization.
+///
+/// Generates short, concise titles (fewer than 10 words) for support
+/// conversations based on the opening message.
+@available(iOS 26, *)
+public enum SupportTicketSummaryGenerator {
+    static func execute(content: String) async throws -> String {
+        let instructions = """
+            You are helping a user by summarizing their support request down to a single sentence
+            with fewer than 10 words.
+            
+            The summary should be clear, informative, and written in a neutral tone.
+            You MUST generate the summary in the same language as the support request.
+            
+            Do not include anything other than the summary in the response.
+            """
+
+        let session = LanguageModelSession(
+            model: .init(guardrails: .permissiveContentTransformations),
+            instructions: instructions
+        )
+
+        let prompt = """
+            Give me an appropriate conversation title for the following opening message of the conversation:
+            
+            \(content)
+            """
+
+        return try await session.respond(
+            to: prompt,
+            generating: Result.self,
+            options: GenerationOptions(temperature: 1.0)
+        ).content.title
+    }
+
+    @Generable
+    struct Result {
+        @Guide(description: "The conversation title")
+        var title: String
+    }
+}

Modules/Sources/WordPressIntelligence/UseCases/SupportTicketSummaryGenerator.swift

@@ -7,7 +7,7 @@ import WordPressShared
 /// Generates relevant tags based on post content and existing site tags,
 /// matching the language and formatting pattern of existing tags.
 @available(iOS 26, *)
-public struct TagSuggestion {
+public struct TagSuggestionGenerator {
     public var options: GenerationOptions
 
     public init(options: GenerationOptions = GenerationOptions(temperature: 0.2)) {
@@ -50,7 +50,7 @@ public struct TagSuggestion {
         - SITE_TAGS: case-sensitive comma-separated list of the existing tags used elsewhere on the site (not always relevant to the post)
         - EXISTING_POST_TAGS: tags already added to the post
 
-        \(PromptHelper.makeLocaleInstructions())
+        \(IntelligenceService.makeLocaleInstructions())
 
         **Steps**
         - 1. Identify the specific formatting pattern used (e.g., lowercase with underscores, capitalized words with spaces, etc)

…ntelligence/UseCases/TagSuggestion.swift …ce/UseCases/TagSuggestionGenerator.swiftModules/Sources/WordPressIntelligence/UseCases/TagSuggestion.swift renamed to Modules/Sources/WordPressIntelligence/UseCases/TagSuggestionGenerator.swift Modules/Sources/WordPressIntelligence/UseCases/TagSuggestion.swift renamed to Modules/Sources/WordPressIntelligence/UseCases/TagSuggestionGenerator.swift

@@ -111,7 +111,7 @@ enum TestHelpers {
     static func printExcerptResults(
         _ title: String,
         excerpts: [String],
-        generator: ExcerptGeneration,
+        generator: PostExcerptGenerator,
         expectedLanguage: NLLanguage,
         duration: Duration
     ) {