Define an adaptive card within the plugin manifest

[thewahome]

Is your feature request related to a problem? Please describe the problem.

The problem we're trying to solve is the user bringing existing adaptive cards, and wanting to use them in the plugin.

Describe the solution you'd like

Kiota currently must define the adaptive card within the plugin manifest. There are plans to work with TTK to support an external file reference from within the manifest.

Requirements:

• TypeSpec will reference the external AC file.
• Kiota must either:

1. add the adaptive card JSON to plugin manifest
2. reference in the external AC file

Kiota does not support passing AC file on CLI yet. Kiota must handle the path to the AC on the CLI and TypeSpec must pass it.

Additional context

More details have been mentioned in https://github.com/microsoft/typespec-copilot-skills/issues/140

[baywet]

@thewahome since there can be one adaptive card per operation, if we request that information from the user in the CLI, we'll need some mapping syntax like /api/path#GET:/pathtoadaptivecard. We'd require also additional UI in the VSCode extension. While this is not an impossible task, this would require significant additional investments for a "sub-part" experience.
We should probably consider only using an OpenAPI extension at the time which TS would emit based of an annotation and kiota would read.
Thoughts?

[thewahome]

Would the conclusion made earlier still suffice?

• The generated OAD will have the adaptive card in an x-ai extension after Typespec generation
• Kiota should read the adaptive card OAD extension and write it the card in the static template property

[maisarissi]

Kiota should read the adaptive card OAD extension and write it the card in the static template property

I talked to @darrelmiller about that and we discussed that MVL will handle the external file and inline the adaptive card. Kiota should only add the path provided in the OAS extensions as part of the plugin manifest like below:

{
    "functions": [
        {
            "name": "getActiveTasks",
            "description": "Get Active Tasks",
            "capabilities": {
                "response_semantics": {
                    "data_path": "$",
                    "properties": {
                        "title": "$.content",
                        "subtitle": "$.id"
                    },
                    "static_template": {
                        "file": "path_to_the_file"
                    }
                }
            }
        }
    ]
}