@microsoft/app-manifest 1.0.6 → 1.0.7-alpha.1673f8d0ac.0

package/build/generated-types/teams/TeamsManifestVDevPreview.d.ts

@@ -3,7 +3,7 @@ export interface TeamsManifestVDevPreview {
     /**
      * The version of the schema this manifest is using.
      */
-    manifestVersion: ManifestVersion;
+    manifestVersion: "devPreview";
     /**
      * The version of the app. Changes to your manifest should cause a version change. This
      * version string must follow the semver standard (http://semver.org).
@@ -132,7 +132,6 @@ export interface TeamsManifestVDevPreview {
      */
     authorization?: TeamsManifestVDevPreviewAuthorization;
     extensions?: ElementExtension[];
-    actions?: ElementAction[];
     /**
      * Defines the list of cards which could be pinned to dashboards that can provide summarized
      * view of information relevant to user.
@@ -161,165 +160,12 @@ export interface TeamsManifestVDevPreview {
      * A list of agent connector objects to included in the Unified App Manifest.
      */
     agentConnectors?: AgentConnector[];
-}
-/**
- * Actions node contains an array of actions object.
- */
-export interface ElementAction {
-    /**
-     * A unique identifier string in the default locale that is used to catalog actions.
-     */
-    id: string;
-    /**
-     * An enum string that describes the intent of the action.
-     */
-    intent: Intent;
-    /**
-     * A display name for the action.
-     */
-    displayName: string;
-    /**
-     * A display string in the default locale to represent the action.
-     */
-    description: string;
-    /**
-     * Object containing URLs to icon images for this action intent.
-     */
-    icons?: Icon[];
-    /**
-     * Defining how actions can be handled. If an app has more than 1 handler, only one
-     * experience will show up at one entry point. The hub will decide which action to show up
-     * based on which experience is supported.
-     */
-    handlers: Handler[];
-}
-export interface Handler {
-    /**
-     * Required both for File Handlers and Content Actions.
-     */
-    type: HandlerType;
-    supportedObjects?: SupportedObjects;
-    /**
-     * If true, multiple files can be selected and the action will still be displayed. If false
-     * or missing, the action is only displayed when a single item is selected.
-     */
-    supportsMultiSelect?: boolean;
-    pageInfo?: PageInfo;
-    dialogInfo?: DialogInfo;
-    /**
-     * Url for handler type openURL, invokeAPI, openTaskpane, and others.
-     */
-    url?: string;
-    botInfo?: BotInfo;
-    [property: string]: any;
-}
-export interface BotInfo {
-    /**
-     * Bot ID.
-     */
-    botId: string;
-    /**
-     * Fetch task from bot.
-     */
-    fetchTask?: boolean;
-    [property: string]: any;
-}
-export interface DialogInfo {
-    /**
-     * Dialog type, defines how the developer build the dialog.
-     */
-    dialogType: DialogType;
-    /**
-     * Required for html based dialog.
-     */
-    url?: string;
-    /**
-     * Dialog width - either a number in pixels or default layout such as 'large', 'medium', or
-     * 'small'.
-     */
-    width: string;
-    /**
-     * Dialog height - either a number in pixels or default layout such as 'large', 'medium', or
-     * 'small'.
-     */
-    height: string;
-    /**
-     * Array of parameter object, each contains: name, title, description, inputType.
-     */
-    parameters?: ParameterObject[];
-    /**
-     * Dialog title.
-     */
-    title?: string;
-    [property: string]: any;
-}
-/**
- * Dialog type, defines how the developer build the dialog.
- */
-export type DialogType = "url" | "adaptiveCard";
-export interface ParameterObject {
-    /**
-     * Parameter name.
-     */
-    name: string;
-    /**
-     * Parameter title.
-     */
-    title: string;
-    /**
-     * Parameter description.
-     */
-    description: string;
-    /**
-     * Parameter input type.
-     */
-    inputType: string;
-    [property: string]: any;
-}
-export interface PageInfo {
-    /**
-     * Used to navigate to the page in MetaOS app.
-     */
-    pageId: string;
-    /**
-     * Used to navigate to the subpage in MetaOS app.
-     */
-    subpageId?: string;
-    [property: string]: any;
-}
-export interface SupportedObjects {
-    file?: File;
-    /**
-     * A null value indicates that the file handler is not available when a folder is selected.
-     * An object with no parameters indicates that the file handler is available when a folder
-     * is selected or when no files are selected.
-     */
-    folder?: {
-        [key: string]: any;
-    } | null;
-    [property: string]: any;
-}
-export interface File {
-    extensions?: string[];
-}
-/**
- * Required both for File Handlers and Content Actions.
- */
-export type HandlerType = "openURL" | "openPage" | "openDialog" | "openTaskpane" | "invokeAPI" | "invokeBot";
-export interface Icon {
-    /**
-     * Icon size in pixels.
-     */
-    size: number;
     /**
-     * URL for the icon.
+     * Agent skill declarations following the Agent Skills open standard (agentskills.io). Each
+     * entry references a SKILL.md folder.
      */
-    url: string;
+    agentSkills?: AgentSkill[];
 }
-/**
- * An enum string that describes the intent of the action.
- */
-export type Intent = "create" | "addTo" | "open" | "preview" | "share" | "sign" | "custom";
 export interface Activities {
     /**
      * Specify the types of activites that your app can post to a users activity feed
@@ -389,14 +235,22 @@ export interface AgentConnector {
  */
 export interface ToolSource {
     /**
-     * Configuration details for connectors that leverage a Plugin Manifest. Either both id and
-     * file properties must be provided (for external plugin reference), or only the description
-     * property must be provided (for inline plugin manifest).
+     * Configuration details for connectors that leverage a Plugin Manifest. Both the id and
+     * file properties must be provided.
      */
     plugin?: Plugin;
+    /**
+     * Adds support for connectors that leverage a Remote MCP Server as the source of data.
+     */
     remoteMcpServer?: RemoteMCPServer;
+    /**
+     * Adds support for connectors that leverage a local MCP Server as the source of data.
+     */
     localMcpServer?: LocalMCPServer;
 }
+/**
+ * Adds support for connectors that leverage a local MCP Server as the source of data.
+ */
 export interface LocalMCPServer {
     /**
      * The unique identifier of the local MCP Server deployed via some secure mechanism to the
@@ -404,9 +258,8 @@ export interface LocalMCPServer {
      */
     mcpServerIdentifier: string;
     /**
-     * Configuration for MCP tool descriptions, either by file reference or inline content (but
-     * not both). When this property is present it indicates that dynamic discovery will not be
-     * used.
+     * Configuration for MCP tool descriptions by file reference. When this property is present
+     * it indicates that dynamic discovery will not be used.
      */
     mcpToolDescription?: LocalMCPServerMCPToolDescription;
     /**
@@ -426,14 +279,15 @@ export interface LocalMCPServerAuthorization {
      * The type of authorization required to invoke the MCP server. Supported values are: 'None'
      * (anonymous access), 'OAuthPluginVault' (OAuth flow with referenceId), 'ApiKeyPluginVault'
      * (API Key with referenceId), 'DynamicClientRegistration' (dynamic client registration with
-     * referenceId).
+     * referenceId), 'AzureKeyVault' (Azure Key Vault integration).
      */
     type: AuthorizationType;
     /**
      * (maxLength: 128)    A reference identifier used when type is OAuthPluginVault,
-     * ApiKeyPluginVault, or DynamicClientRegistration. The referenceId value is acquired
-     * independently when providing the necessary authorization configuration values. This
-     * mechanism exists to prevent the need for storing secret values in the plugin manifest.
+     * ApiKeyPluginVault, DynamicClientRegistration, or AzureKeyVault. The referenceId value is
+     * acquired independently when providing the necessary authorization configuration values.
+     * This mechanism exists to prevent the need for storing secret values in the plugin
+     * manifest.
      */
     referenceId?: string;
 }
@@ -441,70 +295,55 @@ export interface LocalMCPServerAuthorization {
  * The type of authorization required to invoke the MCP server. Supported values are: 'None'
  * (anonymous access), 'OAuthPluginVault' (OAuth flow with referenceId), 'ApiKeyPluginVault'
  * (API Key with referenceId), 'DynamicClientRegistration' (dynamic client registration with
- * referenceId).
+ * referenceId), 'AzureKeyVault' (Azure Key Vault integration).
  */
-export type AuthorizationType = "None" | "OAuthPluginVault" | "ApiKeyPluginVault" | "DynamicClientRegistration";
+export type AuthorizationType = "None" | "OAuthPluginVault" | "ApiKeyPluginVault" | "DynamicClientRegistration" | "AzureKeyVault";
 /**
- * Configuration for MCP tool descriptions, either by file reference or inline content (but
- * not both). When this property is present it indicates that dynamic discovery will not be
- * used.
+ * Configuration for MCP tool descriptions by file reference. When this property is present
+ * it indicates that dynamic discovery will not be used.
  */
 export interface LocalMCPServerMCPToolDescription {
     /**
      * The relative path to the MCP tool description file within the app package.
      */
     file?: string;
-    /**
-     * An inline JSON object containing the tool descriptions directly. The contents match the
-     * results of calling the 'tools/list' method on the MCP Server.
-     */
-    description?: {
-        [key: string]: any;
-    };
 }
 /**
- * Configuration details for connectors that leverage a Plugin Manifest. Either both id and
- * file properties must be provided (for external plugin reference), or only the description
- * property must be provided (for inline plugin manifest).
+ * Configuration details for connectors that leverage a Plugin Manifest. Both the id and
+ * file properties must be provided.
  */
 export interface Plugin {
     /**
      * The unique identifier of the plugin that provides the tools.
      */
-    id?: string;
+    id: string;
     /**
      * The relative path to the plugin manifest file within the app package.
      */
-    file?: string;
-    /**
-     * An inlined Plugin Manifest object for simple plugins that do not require a separate file.
-     * It should conform to the Plugin Manifest schema
-     * https://learn.microsoft.com/microsoft-365-copilot/extensibility/api-plugin-manifest-2.3.
-     */
-    description?: {
-        [key: string]: any;
-    };
+    file: string;
 }
+/**
+ * Adds support for connectors that leverage a Remote MCP Server as the source of data.
+ */
 export interface RemoteMCPServer {
     /**
      * The URL of the remote MCP Server.
      */
     mcpServerUrl: string;
     /**
-     * Configuration for MCP tool descriptions, either by file reference or inline content (but
-     * not both). When this property is present it indicates that dynamic discovery will not be
-     * used.
+     * Configuration for MCP tool descriptions by file reference. When this property is present
+     * it indicates that dynamic discovery will not be used.
      */
     mcpToolDescription?: RemoteMCPServerMCPToolDescription;
     /**
-     * Authorization configuration for connecting to the local MCP server. The design mirrors
+     * Authorization configuration for connecting to the remote MCP server. The design mirrors
      * that of Plugin Manifests
      * https://learn.microsoft.com/microsoft-365-copilot/extensibility/api-plugin-manifest-2.3
      */
     authorization?: RemoteMCPServerAuthorization;
 }
 /**
- * Authorization configuration for connecting to the local MCP server. The design mirrors
+ * Authorization configuration for connecting to the remote MCP server. The design mirrors
  * that of Plugin Manifests
  * https://learn.microsoft.com/microsoft-365-copilot/extensibility/api-plugin-manifest-2.3
  */
@@ -513,34 +352,35 @@ export interface RemoteMCPServerAuthorization {
      * The type of authorization required to invoke the MCP server. Supported values are: 'None'
      * (anonymous access), 'OAuthPluginVault' (OAuth flow with referenceId), 'ApiKeyPluginVault'
      * (API Key with referenceId), 'DynamicClientRegistration' (dynamic client registration with
-     * referenceId).
+     * referenceId), 'AzureKeyVault' (Azure Key Vault integration).
      */
     type: AuthorizationType;
     /**
-     * A reference identifier used when type is OAuthPluginVault, ApiKeyPluginVault, or
-     * DynamicClientRegistration. The referenceId value is acquired independently when providing
-     * the necessary authorization configuration values. This mechanism exists to prevent the
-     * need for storing secret values in the plugin manifest.
+     * A reference identifier used when type is OAuthPluginVault, ApiKeyPluginVault,
+     * DynamicClientRegistration, or AzureKeyVault. The referenceId value is acquired
+     * independently when providing the necessary authorization configuration values. This
+     * mechanism exists to prevent the need for storing secret values in the plugin manifest.
      */
     referenceId?: string;
 }
 /**
- * Configuration for MCP tool descriptions, either by file reference or inline content (but
- * not both). When this property is present it indicates that dynamic discovery will not be
- * used.
+ * Configuration for MCP tool descriptions by file reference. When this property is present
+ * it indicates that dynamic discovery will not be used.
  */
 export interface RemoteMCPServerMCPToolDescription {
     /**
      * The relative path to the MCP tool description file within the app package.
      */
     file?: string;
+}
+/**
+ * An agent skill declaration. References a folder containing a SKILL.md file.
+ */
+export interface AgentSkill {
     /**
-     * An inline JSON object containing the tool descriptions directly. The contents match the
-     * results of calling the 'tools/list' method on the MCP Server.
+     * Path to the folder within the app package that contains the SKILL.md file.
      */
-    description?: {
-        [key: string]: any;
-    };
+    folder: string;
 }
 export interface AgenticUserTemplateRef {
     /**
@@ -656,6 +496,12 @@ export interface Bot {
      * within Copilot surfaces. These options are non-exclusive.
      */
     scopes: CommandListScope[];
+    /**
+     * When true, the bot is enabled to receive targeted messages and appears in the / slash
+     * commands list. Required for slash command support. Developers can optionally add
+     * triggers: ["slash"] on commandLists entries to surface specific commands.
+     */
+    supportsTargetedMessages?: boolean;
     /**
      * The list of commands that the bot supplies, including their usage, description, and the
      * scope for which the commands are valid. A separate command list should be used for each
@@ -673,6 +519,11 @@ export interface Bot {
     registrationInfo?: RegistrationInfo;
 }
 export interface CommandList {
+    /**
+     * Controls where the commands in this commandLists entry are surfaced. "mention" = @mention
+     * trigger (current behavior). "slash" = slash commands list (targeted messages).
+     */
+    triggers?: CommandListTrigger[];
     /**
      * Specifies the scopes for which the command list is valid
      */
@@ -687,9 +538,23 @@ export interface CommandListCommand {
     /**
      * A simple text description or an example of the command syntax and its arguments.
      */
-    description: string;
+    description?: string;
+    /**
+     * Type of the command. Default is basic
+     */
+    type?: PurpleType;
+    /**
+     * The prompt text to be used by Teams when user initiates the command from one of the entry
+     * points
+     */
+    prompt?: string;
 }
+/**
+ * Type of the command. Default is basic
+ */
+export type PurpleType = "basic" | "prompt";
 export type CommandListScope = "team" | "personal" | "groupChat" | "copilot";
+export type CommandListTrigger = "mention" | "slash";
 export interface Configuration {
     team?: ConfigurationTeam;
     groupChat?: ConfigurationGroupChat;
@@ -900,7 +765,13 @@ export interface ComposeExtensionCommand {
     /**
      * Type of the command
      */
-    type?: CommandType;
+    type?: FluffyType;
+    /**
+     * Adding "slash" to the array makes the command appear in the / slash commands list in
+     * group chat or channel. Note: "mention" is not a valid value for composeExtension command
+     * triggers — it applies only to bots[].commandLists[].
+     */
+    triggers?: "slash"[];
     samplePrompts?: SamplePrompt[];
     /**
      * A relative file path for api response rendering template file. The schema of the file can
@@ -929,7 +800,7 @@ export interface ComposeExtensionCommand {
      * A boolean value that indicates if it should fetch task module dynamically
      */
     fetchTask?: boolean;
-    parameters?: ParameterClass[];
+    parameters?: Parameter[];
     /**
      * Task module to be launched when fetch task set to false.
      */
@@ -941,7 +812,7 @@ export interface ComposeExtensionCommand {
     semanticDescription?: string;
 }
 export type CommandContext = "compose" | "commandBox" | "message";
-export interface ParameterClass {
+export interface Parameter {
     /**
      * Name of the parameter.
      */
@@ -999,7 +870,7 @@ export interface SamplePrompt {
 /**
  * Type of the command
  */
-export type CommandType = "query" | "action";
+export type FluffyType = "query" | "action";
 /**
  * Type of the compose extension.
  */
@@ -1123,11 +994,9 @@ export interface CustomEngineAgent {
     type: "bot";
     disclaimer?: Disclaimer;
     /**
-     * Possible values: 'agenticUserOnly', 'agentOnly', or 'agentOrAgenticUser'.
-     * 'agenticUserOnly' means the customEngineAgent must be hired and cannot be installed as a
-     * regular agent. 'agentOrAgenticUser' means the customEngineAgent supports both being
-     * installed as a regular agent and being hired. 'agentOnly' means it supports being
-     * installed as a regular agent only (default).
+     * Possible values: 'agenticUserOnly', 'agentOnly'. 'agenticUserOnly' means the
+     * customEngineAgent must be hired and cannot be installed as a regular agent. 'agentOnly'
+     * means it supports being installed as a regular agent only (default).
      */
     functionsAs?: FunctionsAs;
     /**
@@ -1144,13 +1013,11 @@ export interface Disclaimer {
     [property: string]: any;
 }
 /**
- * Possible values: 'agenticUserOnly', 'agentOnly', or 'agentOrAgenticUser'.
- * 'agenticUserOnly' means the customEngineAgent must be hired and cannot be installed as a
- * regular agent. 'agentOrAgenticUser' means the customEngineAgent supports both being
- * installed as a regular agent and being hired. 'agentOnly' means it supports being
- * installed as a regular agent only (default).
+ * Possible values: 'agenticUserOnly', 'agentOnly'. 'agenticUserOnly' means the
+ * customEngineAgent must be hired and cannot be installed as a regular agent. 'agentOnly'
+ * means it supports being installed as a regular agent only (default).
  */
-export type FunctionsAs = "agentOnly" | "agenticUserOnly" | "agentOrAgenticUser";
+export type FunctionsAs = "agentOnly" | "agenticUserOnly";
 /**
  * The type of the Custom Engine Agent. Currently only type bot is supported.
  *
@@ -1725,7 +1592,7 @@ export interface ExtensionCommonCustomGroupControlsItem {
     /**
      * Defines the type of control whether button or menu.
      */
-    type: PurpleType;
+    type: TentacledType;
     /**
      * Id of an existing office control. Maximum length is 64 characters.
      */
@@ -1754,6 +1621,10 @@ export interface ExtensionCommonCustomGroupControlsItem {
      * Whether the control is initially enabled.
      */
     enabled?: boolean;
+    /**
+     * Controls whether the control is visible.
+     */
+    visible?: boolean;
     /**
      * Configures the items for a menu control.
      */
@@ -1808,7 +1679,7 @@ export interface ExtensionCommonSuperToolTip {
 /**
  * Defines the type of control whether button or menu.
  */
-export type PurpleType = "button" | "menu";
+export type TentacledType = "button" | "menu";
 /**
  * Use 'text' or 'cell' here for Office context menu. Use text if the context menu should
  * open when a user right-clicks (selects and holds) on the selected text. Use cell if the
@@ -2061,6 +1932,10 @@ export interface ExtensionRibbonsArrayTabsItem {
      * Defines mobile group item.
      */
     customMobileRibbonGroups?: ExtensionRibbonsCustomMobileGroupItem[];
+    /**
+     * Controls whether the control is visible.
+     */
+    visible?: boolean;
     /**
      * KeyTip shortcut for keyboard navigation (1-3 uppercase alphanumeric characters)
      */
@@ -2131,6 +2006,10 @@ export interface ExtensionRibbonsCustomTabGroupsItem {
      * tabs on the ribbon. Default is false.
      */
     overriddenByRibbonApi?: boolean;
+    /**
+     * Controls whether the control is visible.
+     */
+    visible?: boolean;
 }
 export interface Position {
     /**
@@ -2230,7 +2109,9 @@ export interface ExtensionCustomFunctions {
      */
     allowCustomDataForDataTypeAny?: boolean;
     /**
-     * The full URL of a metadata json file with default locale.
+     * The full URL of a metadata json file. If `functions` is not empty, the Office client will
+     * install CustomFunctions based on `functions`. Any definitions in `metadataUrl` will be
+     * ignored.
      */
     metadataUrl?: string;
     /**
@@ -2509,7 +2390,6 @@ export interface AdditionalLanguage {
 /**
  * The version of the schema this manifest is using.
  */
-export type ManifestVersion = "devPreview" | "m365DevPreview";
 /**
  * Specify meeting extension definition.
  */