I want to be able to call an app intent for another app from within my app, within the Swift code, not from the Shortcuts app.

To call an app intent for another app from within your app using Swift, you can leverage the App Intents framework. This framework allows you to define intents that can be used across various system experiences, including Siri, Spotlight, and the Shortcuts app.

Here are the steps to achieve this:

1. Define the Intent: Create an intent that conforms to the AppIntent protocol. This intent will encapsulate the action you want to perform.

2. Implement the Intent: Implement the logic for the intent in your app. This includes defining any parameters and the action to be performed.

3. Expose the Intent: Make the intent available to the system by registering it. This allows it to be used by Siri, Spotlight, and other system features.

Here is an example of how you might define and implement an intent in Swift:

import AppIntents

struct OpenPinnedTrailIntent: AppIntent {
    static var title: LocalizedStringResource = "Open Pinned Trail"
    
    @Parameter(title: "Trail ID")
    var trailID: String
    
    func perform() async throws -> some IntentResult {
        // Logic to open the pinned trail in your app
        // For example, navigate to the trail details screen
        return .result()
    }
}

4. Use the Intent in Your App: You can call this intent from within your app using the AppIntent framework. Here is an example of how to invoke the intent:

let intent = OpenPinnedTrailIntent(trailID: "12345")
Task {
    do {
        let result = try await intent.perform()
        // Handle the result
    } catch {
        // Handle any errors
    }
}

For more detailed guidance, you can refer to the session "Bring your app’s core features to users with App Intents" which covers how to build and use app intents in your app.

Relevant Sessions

1. Bring your app’s core features to users with App Intents
2. Design App Intents for system experiences
3. Bring your app to Siri

These sessions provide comprehensive information on how to define, implement, and use app intents within your app and across the system.